UNPKG

mlly

Version:

Missing ECMAScript module utils for Node.js

1,916 lines (1,685 loc) 74.9 kB
import { tokenizer } from 'acorn'; import { builtinModules, createRequire } from 'node:module'; import fs, { realpathSync, statSync, promises } from 'node:fs'; import { joinURL } from 'ufo'; import { normalize, isAbsolute, extname as extname$1 } from 'pathe'; import { readPackageJSON } from 'pkg-types'; import { fileURLToPath as fileURLToPath$1, pathToFileURL as pathToFileURL$1 } from 'node:url'; import assert from 'node:assert'; import process$1 from 'node:process'; import path, { dirname } from 'node:path'; import v8 from 'node:v8'; import { format, inspect } from 'node:util'; const BUILTIN_MODULES = new Set(builtinModules); function normalizeSlash(path) { return path.replace(/\\/g, "/"); } function isObject(value) { return value !== null && typeof value === "object"; } function matchAll(regex, string, addition) { const matches = []; for (const match of string.matchAll(regex)) { matches.push({ ...addition, ...match.groups, code: match[0], start: match.index, end: (match.index || 0) + match[0].length }); } return matches; } function clearImports(imports) { return (imports || "").replace(/\/\/[^\n]*\n|\/\*.*\*\//g, "").replace(/\s+/g, " "); } function getImportNames(cleanedImports) { const topLevelImports = cleanedImports.replace(/{[^}]*}/, ""); const namespacedImport = topLevelImports.match(/\* as \s*(\S*)/)?.[1]; const defaultImport = topLevelImports.split(",").find((index) => !/[*{}]/.test(index))?.trim() || void 0; return { namespacedImport, defaultImport }; } /** * @typedef ErrnoExceptionFields * @property {number | undefined} [errnode] * @property {string | undefined} [code] * @property {string | undefined} [path] * @property {string | undefined} [syscall] * @property {string | undefined} [url] * * @typedef {Error & ErrnoExceptionFields} ErrnoException */ const own$1 = {}.hasOwnProperty; const classRegExp = /^([A-Z][a-z\d]*)+$/; // Sorted by a rough estimate on most frequently used entries. const kTypes = new Set([ 'string', 'function', 'number', 'object', // Accept 'Function' and 'Object' as alternative to the lower cased version. 'Function', 'Object', 'boolean', 'bigint', 'symbol' ]); const codes = {}; /** * Create a list string in the form like 'A and B' or 'A, B, ..., and Z'. * We cannot use Intl.ListFormat because it's not available in * --without-intl builds. * * @param {Array<string>} array * An array of strings. * @param {string} [type] * The list type to be inserted before the last element. * @returns {string} */ function formatList(array, type = 'and') { return array.length < 3 ? array.join(` ${type} `) : `${array.slice(0, -1).join(', ')}, ${type} ${array[array.length - 1]}` } /** @type {Map<string, MessageFunction | string>} */ const messages = new Map(); const nodeInternalPrefix = '__node_internal_'; /** @type {number} */ let userStackTraceLimit; codes.ERR_INVALID_ARG_TYPE = createError( 'ERR_INVALID_ARG_TYPE', /** * @param {string} name * @param {Array<string> | string} expected * @param {unknown} actual */ (name, expected, actual) => { assert.ok(typeof name === 'string', "'name' must be a string"); if (!Array.isArray(expected)) { expected = [expected]; } let message = 'The '; if (name.endsWith(' argument')) { // For cases like 'first argument' message += `${name} `; } else { const type = name.includes('.') ? 'property' : 'argument'; message += `"${name}" ${type} `; } message += 'must be '; /** @type {Array<string>} */ const types = []; /** @type {Array<string>} */ const instances = []; /** @type {Array<string>} */ const other = []; for (const value of expected) { assert.ok( typeof value === 'string', 'All expected entries have to be of type string' ); if (kTypes.has(value)) { types.push(value.toLowerCase()); } else if (classRegExp.exec(value) === null) { assert.ok( value !== 'object', 'The value "object" should be written as "Object"' ); other.push(value); } else { instances.push(value); } } // Special handle `object` in case other instances are allowed to outline // the differences between each other. if (instances.length > 0) { const pos = types.indexOf('object'); if (pos !== -1) { types.slice(pos, 1); instances.push('Object'); } } if (types.length > 0) { message += `${types.length > 1 ? 'one of type' : 'of type'} ${formatList( types, 'or' )}`; if (instances.length > 0 || other.length > 0) message += ' or '; } if (instances.length > 0) { message += `an instance of ${formatList(instances, 'or')}`; if (other.length > 0) message += ' or '; } if (other.length > 0) { if (other.length > 1) { message += `one of ${formatList(other, 'or')}`; } else { if (other[0].toLowerCase() !== other[0]) message += 'an '; message += `${other[0]}`; } } message += `. Received ${determineSpecificType(actual)}`; return message }, TypeError ); codes.ERR_INVALID_MODULE_SPECIFIER = createError( 'ERR_INVALID_MODULE_SPECIFIER', /** * @param {string} request * @param {string} reason * @param {string} [base] */ (request, reason, base = undefined) => { return `Invalid module "${request}" ${reason}${ base ? ` imported from ${base}` : '' }` }, TypeError ); codes.ERR_INVALID_PACKAGE_CONFIG = createError( 'ERR_INVALID_PACKAGE_CONFIG', /** * @param {string} path * @param {string} [base] * @param {string} [message] */ (path, base, message) => { return `Invalid package config ${path}${ base ? ` while importing ${base}` : '' }${message ? `. ${message}` : ''}` }, Error ); codes.ERR_INVALID_PACKAGE_TARGET = createError( 'ERR_INVALID_PACKAGE_TARGET', /** * @param {string} packagePath * @param {string} key * @param {unknown} target * @param {boolean} [isImport=false] * @param {string} [base] */ (packagePath, key, target, isImport = false, base = undefined) => { const relatedError = typeof target === 'string' && !isImport && target.length > 0 && !target.startsWith('./'); if (key === '.') { assert.ok(isImport === false); return ( `Invalid "exports" main target ${JSON.stringify(target)} defined ` + `in the package config ${packagePath}package.json${ base ? ` imported from ${base}` : '' }${relatedError ? '; targets must start with "./"' : ''}` ) } return `Invalid "${ isImport ? 'imports' : 'exports' }" target ${JSON.stringify( target )} defined for '${key}' in the package config ${packagePath}package.json${ base ? ` imported from ${base}` : '' }${relatedError ? '; targets must start with "./"' : ''}` }, Error ); codes.ERR_MODULE_NOT_FOUND = createError( 'ERR_MODULE_NOT_FOUND', /** * @param {string} path * @param {string} base * @param {boolean} [exactUrl] */ (path, base, exactUrl = false) => { return `Cannot find ${ exactUrl ? 'module' : 'package' } '${path}' imported from ${base}` }, Error ); codes.ERR_NETWORK_IMPORT_DISALLOWED = createError( 'ERR_NETWORK_IMPORT_DISALLOWED', "import of '%s' by %s is not supported: %s", Error ); codes.ERR_PACKAGE_IMPORT_NOT_DEFINED = createError( 'ERR_PACKAGE_IMPORT_NOT_DEFINED', /** * @param {string} specifier * @param {string} packagePath * @param {string} base */ (specifier, packagePath, base) => { return `Package import specifier "${specifier}" is not defined${ packagePath ? ` in package ${packagePath}package.json` : '' } imported from ${base}` }, TypeError ); codes.ERR_PACKAGE_PATH_NOT_EXPORTED = createError( 'ERR_PACKAGE_PATH_NOT_EXPORTED', /** * @param {string} packagePath * @param {string} subpath * @param {string} [base] */ (packagePath, subpath, base = undefined) => { if (subpath === '.') return `No "exports" main defined in ${packagePath}package.json${ base ? ` imported from ${base}` : '' }` return `Package subpath '${subpath}' is not defined by "exports" in ${packagePath}package.json${ base ? ` imported from ${base}` : '' }` }, Error ); codes.ERR_UNSUPPORTED_DIR_IMPORT = createError( 'ERR_UNSUPPORTED_DIR_IMPORT', "Directory import '%s' is not supported " + 'resolving ES modules imported from %s', Error ); codes.ERR_UNSUPPORTED_RESOLVE_REQUEST = createError( 'ERR_UNSUPPORTED_RESOLVE_REQUEST', 'Failed to resolve module specifier "%s" from "%s": Invalid relative URL or base scheme is not hierarchical.', TypeError ); codes.ERR_UNKNOWN_FILE_EXTENSION = createError( 'ERR_UNKNOWN_FILE_EXTENSION', /** * @param {string} extension * @param {string} path */ (extension, path) => { return `Unknown file extension "${extension}" for ${path}` }, TypeError ); codes.ERR_INVALID_ARG_VALUE = createError( 'ERR_INVALID_ARG_VALUE', /** * @param {string} name * @param {unknown} value * @param {string} [reason='is invalid'] */ (name, value, reason = 'is invalid') => { let inspected = inspect(value); if (inspected.length > 128) { inspected = `${inspected.slice(0, 128)}...`; } const type = name.includes('.') ? 'property' : 'argument'; return `The ${type} '${name}' ${reason}. Received ${inspected}` }, TypeError // Note: extra classes have been shaken out. // , RangeError ); /** * Utility function for registering the error codes. Only used here. Exported * *only* to allow for testing. * @param {string} sym * @param {MessageFunction | string} value * @param {ErrorConstructor} constructor * @returns {new (...parameters: Array<any>) => Error} */ function createError(sym, value, constructor) { // Special case for SystemError that formats the error message differently // The SystemErrors only have SystemError as their base classes. messages.set(sym, value); return makeNodeErrorWithCode(constructor, sym) } /** * @param {ErrorConstructor} Base * @param {string} key * @returns {ErrorConstructor} */ function makeNodeErrorWithCode(Base, key) { // @ts-expect-error It’s a Node error. return NodeError /** * @param {Array<unknown>} parameters */ function NodeError(...parameters) { const limit = Error.stackTraceLimit; if (isErrorStackTraceLimitWritable()) Error.stackTraceLimit = 0; const error = new Base(); // Reset the limit and setting the name property. if (isErrorStackTraceLimitWritable()) Error.stackTraceLimit = limit; const message = getMessage(key, parameters, error); Object.defineProperties(error, { // Note: no need to implement `kIsNodeError` symbol, would be hard, // probably. message: { value: message, enumerable: false, writable: true, configurable: true }, toString: { /** @this {Error} */ value() { return `${this.name} [${key}]: ${this.message}` }, enumerable: false, writable: true, configurable: true } }); captureLargerStackTrace(error); // @ts-expect-error It’s a Node error. error.code = key; return error } } /** * @returns {boolean} */ function isErrorStackTraceLimitWritable() { // Do no touch Error.stackTraceLimit as V8 would attempt to install // it again during deserialization. try { if (v8.startupSnapshot.isBuildingSnapshot()) { return false } } catch {} const desc = Object.getOwnPropertyDescriptor(Error, 'stackTraceLimit'); if (desc === undefined) { return Object.isExtensible(Error) } return own$1.call(desc, 'writable') && desc.writable !== undefined ? desc.writable : desc.set !== undefined } /** * This function removes unnecessary frames from Node.js core errors. * @template {(...parameters: unknown[]) => unknown} T * @param {T} wrappedFunction * @returns {T} */ function hideStackFrames(wrappedFunction) { // We rename the functions that will be hidden to cut off the stacktrace // at the outermost one const hidden = nodeInternalPrefix + wrappedFunction.name; Object.defineProperty(wrappedFunction, 'name', {value: hidden}); return wrappedFunction } const captureLargerStackTrace = hideStackFrames( /** * @param {Error} error * @returns {Error} */ // @ts-expect-error: fine function (error) { const stackTraceLimitIsWritable = isErrorStackTraceLimitWritable(); if (stackTraceLimitIsWritable) { userStackTraceLimit = Error.stackTraceLimit; Error.stackTraceLimit = Number.POSITIVE_INFINITY; } Error.captureStackTrace(error); // Reset the limit if (stackTraceLimitIsWritable) Error.stackTraceLimit = userStackTraceLimit; return error } ); /** * @param {string} key * @param {Array<unknown>} parameters * @param {Error} self * @returns {string} */ function getMessage(key, parameters, self) { const message = messages.get(key); assert.ok(message !== undefined, 'expected `message` to be found'); if (typeof message === 'function') { assert.ok( message.length <= parameters.length, // Default options do not count. `Code: ${key}; The provided arguments length (${parameters.length}) does not ` + `match the required ones (${message.length}).` ); return Reflect.apply(message, self, parameters) } const regex = /%[dfijoOs]/g; let expectedLength = 0; while (regex.exec(message) !== null) expectedLength++; assert.ok( expectedLength === parameters.length, `Code: ${key}; The provided arguments length (${parameters.length}) does not ` + `match the required ones (${expectedLength}).` ); if (parameters.length === 0) return message parameters.unshift(message); return Reflect.apply(format, null, parameters) } /** * Determine the specific type of a value for type-mismatch errors. * @param {unknown} value * @returns {string} */ function determineSpecificType(value) { if (value === null || value === undefined) { return String(value) } if (typeof value === 'function' && value.name) { return `function ${value.name}` } if (typeof value === 'object') { if (value.constructor && value.constructor.name) { return `an instance of ${value.constructor.name}` } return `${inspect(value, {depth: -1})}` } let inspected = inspect(value, {colors: false}); if (inspected.length > 28) { inspected = `${inspected.slice(0, 25)}...`; } return `type ${typeof value} (${inspected})` } // Manually “tree shaken” from: // <https://github.com/nodejs/node/blob/7c3dce0/lib/internal/modules/package_json_reader.js> // Last checked on: Apr 29, 2024. // Removed the native dependency. // Also: no need to cache, we do that in resolve already. const hasOwnProperty$1 = {}.hasOwnProperty; const {ERR_INVALID_PACKAGE_CONFIG: ERR_INVALID_PACKAGE_CONFIG$1} = codes; /** @type {Map<string, PackageConfig>} */ const cache = new Map(); /** * @param {string} jsonPath * @param {{specifier: URL | string, base?: URL}} options * @returns {PackageConfig} */ function read(jsonPath, {base, specifier}) { const existing = cache.get(jsonPath); if (existing) { return existing } /** @type {string | undefined} */ let string; try { string = fs.readFileSync(path.toNamespacedPath(jsonPath), 'utf8'); } catch (error) { const exception = /** @type {ErrnoException} */ (error); if (exception.code !== 'ENOENT') { throw exception } } /** @type {PackageConfig} */ const result = { exists: false, pjsonPath: jsonPath, main: undefined, name: undefined, type: 'none', // Ignore unknown types for forwards compatibility exports: undefined, imports: undefined }; if (string !== undefined) { /** @type {Record<string, unknown>} */ let parsed; try { parsed = JSON.parse(string); } catch (error_) { const cause = /** @type {ErrnoException} */ (error_); const error = new ERR_INVALID_PACKAGE_CONFIG$1( jsonPath, (base ? `"${specifier}" from ` : '') + fileURLToPath$1(base || specifier), cause.message ); error.cause = cause; throw error } result.exists = true; if ( hasOwnProperty$1.call(parsed, 'name') && typeof parsed.name === 'string' ) { result.name = parsed.name; } if ( hasOwnProperty$1.call(parsed, 'main') && typeof parsed.main === 'string' ) { result.main = parsed.main; } if (hasOwnProperty$1.call(parsed, 'exports')) { // @ts-expect-error: assume valid. result.exports = parsed.exports; } if (hasOwnProperty$1.call(parsed, 'imports')) { // @ts-expect-error: assume valid. result.imports = parsed.imports; } // Ignore unknown types for forwards compatibility if ( hasOwnProperty$1.call(parsed, 'type') && (parsed.type === 'commonjs' || parsed.type === 'module') ) { result.type = parsed.type; } } cache.set(jsonPath, result); return result } /** * @param {URL | string} resolved * @returns {PackageConfig} */ function getPackageScopeConfig(resolved) { // Note: in Node, this is now a native module. let packageJSONUrl = new URL('package.json', resolved); while (true) { const packageJSONPath = packageJSONUrl.pathname; if (packageJSONPath.endsWith('node_modules/package.json')) { break } const packageConfig = read(fileURLToPath$1(packageJSONUrl), { specifier: resolved }); if (packageConfig.exists) { return packageConfig } const lastPackageJSONUrl = packageJSONUrl; packageJSONUrl = new URL('../package.json', packageJSONUrl); // Terminates at root where ../package.json equals ../../package.json // (can't just check "/package.json" for Windows support). if (packageJSONUrl.pathname === lastPackageJSONUrl.pathname) { break } } const packageJSONPath = fileURLToPath$1(packageJSONUrl); // ^^ Note: in Node, this is now a native module. return { pjsonPath: packageJSONPath, exists: false, type: 'none' } } /** * Returns the package type for a given URL. * @param {URL} url - The URL to get the package type for. * @returns {PackageType} */ function getPackageType(url) { // To do @anonrig: Write a C++ function that returns only "type". return getPackageScopeConfig(url).type } // Manually “tree shaken” from: // <https://github.com/nodejs/node/blob/7c3dce0/lib/internal/modules/esm/get_format.js> // Last checked on: Apr 29, 2024. const {ERR_UNKNOWN_FILE_EXTENSION} = codes; const hasOwnProperty = {}.hasOwnProperty; /** @type {Record<string, string>} */ const extensionFormatMap = { // @ts-expect-error: hush. __proto__: null, '.cjs': 'commonjs', '.js': 'module', '.json': 'json', '.mjs': 'module' }; /** * @param {string | null} mime * @returns {string | null} */ function mimeToFormat(mime) { if ( mime && /\s*(text|application)\/javascript\s*(;\s*charset=utf-?8\s*)?/i.test(mime) ) return 'module' if (mime === 'application/json') return 'json' return null } /** * @callback ProtocolHandler * @param {URL} parsed * @param {{parentURL: string, source?: Buffer}} context * @param {boolean} ignoreErrors * @returns {string | null | void} */ /** * @type {Record<string, ProtocolHandler>} */ const protocolHandlers = { // @ts-expect-error: hush. __proto__: null, 'data:': getDataProtocolModuleFormat, 'file:': getFileProtocolModuleFormat, 'http:': getHttpProtocolModuleFormat, 'https:': getHttpProtocolModuleFormat, 'node:'() { return 'builtin' } }; /** * @param {URL} parsed */ function getDataProtocolModuleFormat(parsed) { const {1: mime} = /^([^/]+\/[^;,]+)[^,]*?(;base64)?,/.exec( parsed.pathname ) || [null, null, null]; return mimeToFormat(mime) } /** * Returns the file extension from a URL. * * Should give similar result to * `require('node:path').extname(require('node:url').fileURLToPath(url))` * when used with a `file:` URL. * * @param {URL} url * @returns {string} */ function extname(url) { const pathname = url.pathname; let index = pathname.length; while (index--) { const code = pathname.codePointAt(index); if (code === 47 /* `/` */) { return '' } if (code === 46 /* `.` */) { return pathname.codePointAt(index - 1) === 47 /* `/` */ ? '' : pathname.slice(index) } } return '' } /** * @type {ProtocolHandler} */ function getFileProtocolModuleFormat(url, _context, ignoreErrors) { const value = extname(url); if (value === '.js') { const packageType = getPackageType(url); if (packageType !== 'none') { return packageType } return 'commonjs' } if (value === '') { const packageType = getPackageType(url); // Legacy behavior if (packageType === 'none' || packageType === 'commonjs') { return 'commonjs' } // Note: we don’t implement WASM, so we don’t need // `getFormatOfExtensionlessFile` from `formats`. return 'module' } const format = extensionFormatMap[value]; if (format) return format // Explicit undefined return indicates load hook should rerun format check if (ignoreErrors) { return undefined } const filepath = fileURLToPath$1(url); throw new ERR_UNKNOWN_FILE_EXTENSION(value, filepath) } function getHttpProtocolModuleFormat() { // To do: HTTPS imports. } /** * @param {URL} url * @param {{parentURL: string}} context * @returns {string | null} */ function defaultGetFormatWithoutErrors(url, context) { const protocol = url.protocol; if (!hasOwnProperty.call(protocolHandlers, protocol)) { return null } return protocolHandlers[protocol](url, context, true) || null } // Manually “tree shaken” from: // <https://github.com/nodejs/node/blob/81a9a97/lib/internal/modules/esm/utils.js> // Last checked on: Apr 29, 2024. // In Node itself these values are populated from CLI arguments, before any // user code runs. // Here we just define the defaults. const DEFAULT_CONDITIONS = Object.freeze(['node', 'import']); const DEFAULT_CONDITIONS_SET$1 = new Set(DEFAULT_CONDITIONS); /** * Returns the default conditions for ES module loading, as a Set. */ function getDefaultConditionsSet() { return DEFAULT_CONDITIONS_SET$1 } /** * @param {Array<string>} [conditions] * @returns {Set<string>} */ function getConditionsSet(conditions) { return getDefaultConditionsSet() } // Manually “tree shaken” from: // <https://github.com/nodejs/node/blob/81a9a97/lib/internal/modules/esm/resolve.js> // Last checked on: Apr 29, 2024. const RegExpPrototypeSymbolReplace = RegExp.prototype[Symbol.replace]; const { ERR_INVALID_MODULE_SPECIFIER, ERR_INVALID_PACKAGE_CONFIG, ERR_INVALID_PACKAGE_TARGET, ERR_MODULE_NOT_FOUND, ERR_PACKAGE_IMPORT_NOT_DEFINED, ERR_PACKAGE_PATH_NOT_EXPORTED, ERR_UNSUPPORTED_DIR_IMPORT, ERR_UNSUPPORTED_RESOLVE_REQUEST } = codes; const own = {}.hasOwnProperty; const invalidSegmentRegEx = /(^|\\|\/)((\.|%2e)(\.|%2e)?|(n|%6e|%4e)(o|%6f|%4f)(d|%64|%44)(e|%65|%45)(_|%5f)(m|%6d|%4d)(o|%6f|%4f)(d|%64|%44)(u|%75|%55)(l|%6c|%4c)(e|%65|%45)(s|%73|%53))?(\\|\/|$)/i; const deprecatedInvalidSegmentRegEx = /(^|\\|\/)((\.|%2e)(\.|%2e)?|(n|%6e|%4e)(o|%6f|%4f)(d|%64|%44)(e|%65|%45)(_|%5f)(m|%6d|%4d)(o|%6f|%4f)(d|%64|%44)(u|%75|%55)(l|%6c|%4c)(e|%65|%45)(s|%73|%53))(\\|\/|$)/i; const invalidPackageNameRegEx = /^\.|%|\\/; const patternRegEx = /\*/g; const encodedSeparatorRegEx = /%2f|%5c/i; /** @type {Set<string>} */ const emittedPackageWarnings = new Set(); const doubleSlashRegEx = /[/\\]{2}/; /** * * @param {string} target * @param {string} request * @param {string} match * @param {URL} packageJsonUrl * @param {boolean} internal * @param {URL} base * @param {boolean} isTarget */ function emitInvalidSegmentDeprecation( target, request, match, packageJsonUrl, internal, base, isTarget ) { // @ts-expect-error: apparently it does exist, TS. if (process$1.noDeprecation) { return } const pjsonPath = fileURLToPath$1(packageJsonUrl); const double = doubleSlashRegEx.exec(isTarget ? target : request) !== null; process$1.emitWarning( `Use of deprecated ${ double ? 'double slash' : 'leading or trailing slash matching' } resolving "${target}" for module ` + `request "${request}" ${ request === match ? '' : `matched to "${match}" ` }in the "${ internal ? 'imports' : 'exports' }" field module resolution of the package at ${pjsonPath}${ base ? ` imported from ${fileURLToPath$1(base)}` : '' }.`, 'DeprecationWarning', 'DEP0166' ); } /** * @param {URL} url * @param {URL} packageJsonUrl * @param {URL} base * @param {string} [main] * @returns {void} */ function emitLegacyIndexDeprecation(url, packageJsonUrl, base, main) { // @ts-expect-error: apparently it does exist, TS. if (process$1.noDeprecation) { return } const format = defaultGetFormatWithoutErrors(url, {parentURL: base.href}); if (format !== 'module') return const urlPath = fileURLToPath$1(url.href); const packagePath = fileURLToPath$1(new URL('.', packageJsonUrl)); const basePath = fileURLToPath$1(base); if (!main) { process$1.emitWarning( `No "main" or "exports" field defined in the package.json for ${packagePath} resolving the main entry point "${urlPath.slice( packagePath.length )}", imported from ${basePath}.\nDefault "index" lookups for the main are deprecated for ES modules.`, 'DeprecationWarning', 'DEP0151' ); } else if (path.resolve(packagePath, main) !== urlPath) { process$1.emitWarning( `Package ${packagePath} has a "main" field set to "${main}", ` + `excluding the full filename and extension to the resolved file at "${urlPath.slice( packagePath.length )}", imported from ${basePath}.\n Automatic extension resolution of the "main" field is ` + 'deprecated for ES modules.', 'DeprecationWarning', 'DEP0151' ); } } /** * @param {string} path * @returns {Stats | undefined} */ function tryStatSync(path) { // Note: from Node 15 onwards we can use `throwIfNoEntry: false` instead. try { return statSync(path) } catch { // Note: in Node code this returns `new Stats`, // but in Node 22 that’s marked as a deprecated internal API. // Which, well, we kinda are, but still to prevent that warning, // just yield `undefined`. } } /** * Legacy CommonJS main resolution: * 1. let M = pkg_url + (json main field) * 2. TRY(M, M.js, M.json, M.node) * 3. TRY(M/index.js, M/index.json, M/index.node) * 4. TRY(pkg_url/index.js, pkg_url/index.json, pkg_url/index.node) * 5. NOT_FOUND * * @param {URL} url * @returns {boolean} */ function fileExists(url) { const stats = statSync(url, {throwIfNoEntry: false}); const isFile = stats ? stats.isFile() : undefined; return isFile === null || isFile === undefined ? false : isFile } /** * @param {URL} packageJsonUrl * @param {PackageConfig} packageConfig * @param {URL} base * @returns {URL} */ function legacyMainResolve(packageJsonUrl, packageConfig, base) { /** @type {URL | undefined} */ let guess; if (packageConfig.main !== undefined) { guess = new URL(packageConfig.main, packageJsonUrl); // Note: fs check redundances will be handled by Descriptor cache here. if (fileExists(guess)) return guess const tries = [ `./${packageConfig.main}.js`, `./${packageConfig.main}.json`, `./${packageConfig.main}.node`, `./${packageConfig.main}/index.js`, `./${packageConfig.main}/index.json`, `./${packageConfig.main}/index.node` ]; let i = -1; while (++i < tries.length) { guess = new URL(tries[i], packageJsonUrl); if (fileExists(guess)) break guess = undefined; } if (guess) { emitLegacyIndexDeprecation( guess, packageJsonUrl, base, packageConfig.main ); return guess } // Fallthrough. } const tries = ['./index.js', './index.json', './index.node']; let i = -1; while (++i < tries.length) { guess = new URL(tries[i], packageJsonUrl); if (fileExists(guess)) break guess = undefined; } if (guess) { emitLegacyIndexDeprecation(guess, packageJsonUrl, base, packageConfig.main); return guess } // Not found. throw new ERR_MODULE_NOT_FOUND( fileURLToPath$1(new URL('.', packageJsonUrl)), fileURLToPath$1(base) ) } /** * @param {URL} resolved * @param {URL} base * @param {boolean} [preserveSymlinks] * @returns {URL} */ function finalizeResolution(resolved, base, preserveSymlinks) { if (encodedSeparatorRegEx.exec(resolved.pathname) !== null) { throw new ERR_INVALID_MODULE_SPECIFIER( resolved.pathname, 'must not include encoded "/" or "\\" characters', fileURLToPath$1(base) ) } /** @type {string} */ let filePath; try { filePath = fileURLToPath$1(resolved); } catch (error) { const cause = /** @type {ErrnoException} */ (error); Object.defineProperty(cause, 'input', {value: String(resolved)}); Object.defineProperty(cause, 'module', {value: String(base)}); throw cause } const stats = tryStatSync( filePath.endsWith('/') ? filePath.slice(-1) : filePath ); if (stats && stats.isDirectory()) { const error = new ERR_UNSUPPORTED_DIR_IMPORT(filePath, fileURLToPath$1(base)); // @ts-expect-error Add this for `import.meta.resolve`. error.url = String(resolved); throw error } if (!stats || !stats.isFile()) { const error = new ERR_MODULE_NOT_FOUND( filePath || resolved.pathname, base && fileURLToPath$1(base), true ); // @ts-expect-error Add this for `import.meta.resolve`. error.url = String(resolved); throw error } { const real = realpathSync(filePath); const {search, hash} = resolved; resolved = pathToFileURL$1(real + (filePath.endsWith(path.sep) ? '/' : '')); resolved.search = search; resolved.hash = hash; } return resolved } /** * @param {string} specifier * @param {URL | undefined} packageJsonUrl * @param {URL} base * @returns {Error} */ function importNotDefined(specifier, packageJsonUrl, base) { return new ERR_PACKAGE_IMPORT_NOT_DEFINED( specifier, packageJsonUrl && fileURLToPath$1(new URL('.', packageJsonUrl)), fileURLToPath$1(base) ) } /** * @param {string} subpath * @param {URL} packageJsonUrl * @param {URL} base * @returns {Error} */ function exportsNotFound(subpath, packageJsonUrl, base) { return new ERR_PACKAGE_PATH_NOT_EXPORTED( fileURLToPath$1(new URL('.', packageJsonUrl)), subpath, base && fileURLToPath$1(base) ) } /** * @param {string} request * @param {string} match * @param {URL} packageJsonUrl * @param {boolean} internal * @param {URL} [base] * @returns {never} */ function throwInvalidSubpath(request, match, packageJsonUrl, internal, base) { const reason = `request is not a valid match in pattern "${match}" for the "${ internal ? 'imports' : 'exports' }" resolution of ${fileURLToPath$1(packageJsonUrl)}`; throw new ERR_INVALID_MODULE_SPECIFIER( request, reason, base && fileURLToPath$1(base) ) } /** * @param {string} subpath * @param {unknown} target * @param {URL} packageJsonUrl * @param {boolean} internal * @param {URL} [base] * @returns {Error} */ function invalidPackageTarget(subpath, target, packageJsonUrl, internal, base) { target = typeof target === 'object' && target !== null ? JSON.stringify(target, null, '') : `${target}`; return new ERR_INVALID_PACKAGE_TARGET( fileURLToPath$1(new URL('.', packageJsonUrl)), subpath, target, internal, base && fileURLToPath$1(base) ) } /** * @param {string} target * @param {string} subpath * @param {string} match * @param {URL} packageJsonUrl * @param {URL} base * @param {boolean} pattern * @param {boolean} internal * @param {boolean} isPathMap * @param {Set<string> | undefined} conditions * @returns {URL} */ function resolvePackageTargetString( target, subpath, match, packageJsonUrl, base, pattern, internal, isPathMap, conditions ) { if (subpath !== '' && !pattern && target[target.length - 1] !== '/') throw invalidPackageTarget(match, target, packageJsonUrl, internal, base) if (!target.startsWith('./')) { if (internal && !target.startsWith('../') && !target.startsWith('/')) { let isURL = false; try { new URL(target); isURL = true; } catch { // Continue regardless of error. } if (!isURL) { const exportTarget = pattern ? RegExpPrototypeSymbolReplace.call( patternRegEx, target, () => subpath ) : target + subpath; return packageResolve(exportTarget, packageJsonUrl, conditions) } } throw invalidPackageTarget(match, target, packageJsonUrl, internal, base) } if (invalidSegmentRegEx.exec(target.slice(2)) !== null) { if (deprecatedInvalidSegmentRegEx.exec(target.slice(2)) === null) { if (!isPathMap) { const request = pattern ? match.replace('*', () => subpath) : match + subpath; const resolvedTarget = pattern ? RegExpPrototypeSymbolReplace.call( patternRegEx, target, () => subpath ) : target; emitInvalidSegmentDeprecation( resolvedTarget, request, match, packageJsonUrl, internal, base, true ); } } else { throw invalidPackageTarget(match, target, packageJsonUrl, internal, base) } } const resolved = new URL(target, packageJsonUrl); const resolvedPath = resolved.pathname; const packagePath = new URL('.', packageJsonUrl).pathname; if (!resolvedPath.startsWith(packagePath)) throw invalidPackageTarget(match, target, packageJsonUrl, internal, base) if (subpath === '') return resolved if (invalidSegmentRegEx.exec(subpath) !== null) { const request = pattern ? match.replace('*', () => subpath) : match + subpath; if (deprecatedInvalidSegmentRegEx.exec(subpath) === null) { if (!isPathMap) { const resolvedTarget = pattern ? RegExpPrototypeSymbolReplace.call( patternRegEx, target, () => subpath ) : target; emitInvalidSegmentDeprecation( resolvedTarget, request, match, packageJsonUrl, internal, base, false ); } } else { throwInvalidSubpath(request, match, packageJsonUrl, internal, base); } } if (pattern) { return new URL( RegExpPrototypeSymbolReplace.call( patternRegEx, resolved.href, () => subpath ) ) } return new URL(subpath, resolved) } /** * @param {string} key * @returns {boolean} */ function isArrayIndex(key) { const keyNumber = Number(key); if (`${keyNumber}` !== key) return false return keyNumber >= 0 && keyNumber < 0xff_ff_ff_ff } /** * @param {URL} packageJsonUrl * @param {unknown} target * @param {string} subpath * @param {string} packageSubpath * @param {URL} base * @param {boolean} pattern * @param {boolean} internal * @param {boolean} isPathMap * @param {Set<string> | undefined} conditions * @returns {URL | null} */ function resolvePackageTarget( packageJsonUrl, target, subpath, packageSubpath, base, pattern, internal, isPathMap, conditions ) { if (typeof target === 'string') { return resolvePackageTargetString( target, subpath, packageSubpath, packageJsonUrl, base, pattern, internal, isPathMap, conditions ) } if (Array.isArray(target)) { /** @type {Array<unknown>} */ const targetList = target; if (targetList.length === 0) return null /** @type {ErrnoException | null | undefined} */ let lastException; let i = -1; while (++i < targetList.length) { const targetItem = targetList[i]; /** @type {URL | null} */ let resolveResult; try { resolveResult = resolvePackageTarget( packageJsonUrl, targetItem, subpath, packageSubpath, base, pattern, internal, isPathMap, conditions ); } catch (error) { const exception = /** @type {ErrnoException} */ (error); lastException = exception; if (exception.code === 'ERR_INVALID_PACKAGE_TARGET') continue throw error } if (resolveResult === undefined) continue if (resolveResult === null) { lastException = null; continue } return resolveResult } if (lastException === undefined || lastException === null) { return null } throw lastException } if (typeof target === 'object' && target !== null) { const keys = Object.getOwnPropertyNames(target); let i = -1; while (++i < keys.length) { const key = keys[i]; if (isArrayIndex(key)) { throw new ERR_INVALID_PACKAGE_CONFIG( fileURLToPath$1(packageJsonUrl), base, '"exports" cannot contain numeric property keys.' ) } } i = -1; while (++i < keys.length) { const key = keys[i]; if (key === 'default' || (conditions && conditions.has(key))) { // @ts-expect-error: indexable. const conditionalTarget = /** @type {unknown} */ (target[key]); const resolveResult = resolvePackageTarget( packageJsonUrl, conditionalTarget, subpath, packageSubpath, base, pattern, internal, isPathMap, conditions ); if (resolveResult === undefined) continue return resolveResult } } return null } if (target === null) { return null } throw invalidPackageTarget( packageSubpath, target, packageJsonUrl, internal, base ) } /** * @param {unknown} exports * @param {URL} packageJsonUrl * @param {URL} base * @returns {boolean} */ function isConditionalExportsMainSugar(exports$1, packageJsonUrl, base) { if (typeof exports$1 === 'string' || Array.isArray(exports$1)) return true if (typeof exports$1 !== 'object' || exports$1 === null) return false const keys = Object.getOwnPropertyNames(exports$1); let isConditionalSugar = false; let i = 0; let keyIndex = -1; while (++keyIndex < keys.length) { const key = keys[keyIndex]; const currentIsConditionalSugar = key === '' || key[0] !== '.'; if (i++ === 0) { isConditionalSugar = currentIsConditionalSugar; } else if (isConditionalSugar !== currentIsConditionalSugar) { throw new ERR_INVALID_PACKAGE_CONFIG( fileURLToPath$1(packageJsonUrl), base, '"exports" cannot contain some keys starting with \'.\' and some not.' + ' The exports object must either be an object of package subpath keys' + ' or an object of main entry condition name keys only.' ) } } return isConditionalSugar } /** * @param {string} match * @param {URL} pjsonUrl * @param {URL} base */ function emitTrailingSlashPatternDeprecation(match, pjsonUrl, base) { // @ts-expect-error: apparently it does exist, TS. if (process$1.noDeprecation) { return } const pjsonPath = fileURLToPath$1(pjsonUrl); if (emittedPackageWarnings.has(pjsonPath + '|' + match)) return emittedPackageWarnings.add(pjsonPath + '|' + match); process$1.emitWarning( `Use of deprecated trailing slash pattern mapping "${match}" in the ` + `"exports" field module resolution of the package at ${pjsonPath}${ base ? ` imported from ${fileURLToPath$1(base)}` : '' }. Mapping specifiers ending in "/" is no longer supported.`, 'DeprecationWarning', 'DEP0155' ); } /** * @param {URL} packageJsonUrl * @param {string} packageSubpath * @param {Record<string, unknown>} packageConfig * @param {URL} base * @param {Set<string> | undefined} conditions * @returns {URL} */ function packageExportsResolve( packageJsonUrl, packageSubpath, packageConfig, base, conditions ) { let exports$1 = packageConfig.exports; if (isConditionalExportsMainSugar(exports$1, packageJsonUrl, base)) { exports$1 = {'.': exports$1}; } if ( own.call(exports$1, packageSubpath) && !packageSubpath.includes('*') && !packageSubpath.endsWith('/') ) { // @ts-expect-error: indexable. const target = exports$1[packageSubpath]; const resolveResult = resolvePackageTarget( packageJsonUrl, target, '', packageSubpath, base, false, false, false, conditions ); if (resolveResult === null || resolveResult === undefined) { throw exportsNotFound(packageSubpath, packageJsonUrl, base) } return resolveResult } let bestMatch = ''; let bestMatchSubpath = ''; const keys = Object.getOwnPropertyNames(exports$1); let i = -1; while (++i < keys.length) { const key = keys[i]; const patternIndex = key.indexOf('*'); if ( patternIndex !== -1 && packageSubpath.startsWith(key.slice(0, patternIndex)) ) { // When this reaches EOL, this can throw at the top of the whole function: // // if (StringPrototypeEndsWith(packageSubpath, '/')) // throwInvalidSubpath(packageSubpath) // // To match "imports" and the spec. if (packageSubpath.endsWith('/')) { emitTrailingSlashPatternDeprecation( packageSubpath, packageJsonUrl, base ); } const patternTrailer = key.slice(patternIndex + 1); if ( packageSubpath.length >= key.length && packageSubpath.endsWith(patternTrailer) && patternKeyCompare(bestMatch, key) === 1 && key.lastIndexOf('*') === patternIndex ) { bestMatch = key; bestMatchSubpath = packageSubpath.slice( patternIndex, packageSubpath.length - patternTrailer.length ); } } } if (bestMatch) { // @ts-expect-error: indexable. const target = /** @type {unknown} */ (exports$1[bestMatch]); const resolveResult = resolvePackageTarget( packageJsonUrl, target, bestMatchSubpath, bestMatch, base, true, false, packageSubpath.endsWith('/'), conditions ); if (resolveResult === null || resolveResult === undefined) { throw exportsNotFound(packageSubpath, packageJsonUrl, base) } return resolveResult } throw exportsNotFound(packageSubpath, packageJsonUrl, base) } /** * @param {string} a * @param {string} b */ function patternKeyCompare(a, b) { const aPatternIndex = a.indexOf('*'); const bPatternIndex = b.indexOf('*'); const baseLengthA = aPatternIndex === -1 ? a.length : aPatternIndex + 1; const baseLengthB = bPatternIndex === -1 ? b.length : bPatternIndex + 1; if (baseLengthA > baseLengthB) return -1 if (baseLengthB > baseLengthA) return 1 if (aPatternIndex === -1) return 1 if (bPatternIndex === -1) return -1 if (a.length > b.length) return -1 if (b.length > a.length) return 1 return 0 } /** * @param {string} name * @param {URL} base * @param {Set<string>} [conditions] * @returns {URL} */ function packageImportsResolve(name, base, conditions) { if (name === '#' || name.startsWith('#/') || name.endsWith('/')) { const reason = 'is not a valid internal imports specifier name'; throw new ERR_INVALID_MODULE_SPECIFIER(name, reason, fileURLToPath$1(base)) } /** @type {URL | undefined} */ let packageJsonUrl; const packageConfig = getPackageScopeConfig(base); if (packageConfig.exists) { packageJsonUrl = pathToFileURL$1(packageConfig.pjsonPath); const imports = packageConfig.imports; if (imports) { if (own.call(imports, name) && !name.includes('*')) { const resolveResult = resolvePackageTarget( packageJsonUrl, imports[name], '', name, base, false, true, false, conditions ); if (resolveResult !== null && resolveResult !== undefined) { return resolveResult } } else { let bestMatch = ''; let bestMatchSubpath = ''; const keys = Object.getOwnPropertyNames(imports); let i = -1; while (++i < keys.length) { const key = keys[i]; const patternIndex = key.indexOf('*'); if (patternIndex !== -1 && name.startsWith(key.slice(0, -1))) { const patternTrailer = key.slice(patternIndex + 1); if ( name.length >= key.length && name.endsWith(patternTrailer) && patternKeyCompare(bestMatch, key) === 1 && key.lastIndexOf('*') === patternIndex ) { bestMatch = key; bestMatchSubpath = name.slice( patternIndex, name.length - patternTrailer.length ); } } } if (bestMatch) { const target = imports[bestMatch]; const resolveResult = resolvePackageTarget( packageJsonUrl, target, bestMatchSubpath, bestMatch, base, true, true, false, conditions ); if (resolveResult !== null && resolveResult !== undefined) { return resolveResult } } } } } throw importNotDefined(name, packageJsonUrl, base) } /** * @param {string} specifier * @param {URL} base */ function parsePackageName(specifier, base) { let separatorIndex = specifier.indexOf('/'); let validPackageName = true; let isScoped = false; if (specifier[0] === '@') { isScoped = true; if (separatorIndex === -1 || specifier.length === 0) { validPackageName = false; } else { separatorIndex = specifier.indexOf('/', separatorIndex + 1); } } const packageName = separatorIndex === -1 ? specifier : specifier.slice(0, separatorIndex); // Package name cannot have leading . and cannot have percent-encoding or // \\ separators. if (invalidPackageNameRegEx.exec(packageName) !== null) { validPackageName = false; } if (!validPackageName) { throw new ERR_INVALID_MODULE_SPECIFIER( specifier, 'is not a valid package name', fileURLToPath$1(base) ) } const packageSubpath = '.' + (separatorIndex === -1 ? '' : specifier.slice(separatorIndex)); return {packageName, packageSubpath, isScoped} } /** * @param {string} specifier * @param {URL} base * @param {Set<string> | undefined} conditions * @returns {URL} */ function packageResolve(specifier, base, conditions) { if (builtinModules.includes(specifier)) { return new URL('node:' + specifier) } const {packageName, packageSubpath, isScoped} = parsePackageName( specifier, base ); // ResolveSelf const packageConfig = getPackageScopeConfig(base); // Can’t test. /* c8 ignore next 16 */ if (packageConfig.exists) { const packageJsonUrl = pathToFileURL$1(packageConfig.pjsonPath); if ( packageConfig.name === packageName && packageConfig.exports !== undefined && packageConfig.exports !== null ) { return packageExportsResolve( packageJsonUrl, packageSubpath, packageConfig, base, conditions ) } } let packageJsonUrl = new URL( './node_modules/' + packageName + '/package.json', base ); let packageJsonPath = fileURLToPath$1(packageJsonUrl); /** @type {string} */ let lastPath; do { const stat = tryStatSync(packageJsonPath.slice(0, -13)); if (!stat || !stat.isDirectory()) { lastPath = packageJsonPath; packageJsonUrl = new URL( (isScoped ? '../../../../node_modules/' : '../../../node_modules/') + packageName + '/package.json', packageJsonUrl ); packageJsonPath = fileURLToPath$1(packageJsonUrl); continue } // Package match. const packageConfig = read(packageJsonPath, {base, specifier}); if (packageConfig.exports !== undefined && packageConfig.exports !== null) { return packageExportsResolve( packageJsonUrl, packageSubpath, packageConfig, base, conditions ) } if (packageSubpath === '.') { return legacyMainResolve(packageJsonUrl, packageConfig, base) } return new URL(packageSubpath, packageJsonUrl) // Cross-platform root check. } while (packageJsonPath.length !== lastPath.length) throw new ERR_MODULE_NOT_FOUND(packageName, fileURLToPath$1(base), false) } /** * @param {string} specifier * @returns {boolean} */ function isRelativeSpecifier(specifier) { if (specifier[0] === '.') { if (specifier.length === 1 || specifier[1] === '/') return true if ( specifier[1] === '.' && (specifier.length === 2 || specifier[2] === '/') ) {