/* MIT License http://www.opensource.org/licenses/mit-license.php Author Ivan Kopeykin @vankop */ "use strict"; const DescriptionFileUtils = require("./DescriptionFileUtils"); const forEachBail = require("./forEachBail"); const { processExportsField } = require("./util/entrypoints"); const { parseIdentifier } = require("./util/identifier"); const { invalidSegmentRegEx, deprecatedInvalidSegmentRegEx } = require("./util/path"); /** @typedef {import("./Resolver")} Resolver */ /** @typedef {import("./Resolver").JsonObject} JsonObject */ /** @typedef {import("./Resolver").ResolveRequest} ResolveRequest */ /** @typedef {import("./Resolver").ResolveStepHook} ResolveStepHook */ /** @typedef {import("./util/entrypoints").ExportsField} ExportsField */ /** @typedef {import("./util/entrypoints").FieldProcessor} FieldProcessor */ module.exports = class ExportsFieldPlugin { /** * @param {string | ResolveStepHook} source source * @param {Set} conditionNames condition names * @param {string | string[]} fieldNamePath name path * @param {string | ResolveStepHook} target target */ constructor(source, conditionNames, fieldNamePath, target) { this.source = source; this.target = target; this.conditionNames = conditionNames; this.fieldName = fieldNamePath; /** @type {WeakMap} */ this.fieldProcessorCache = new WeakMap(); } /** * @param {Resolver} resolver the resolver * @returns {void} */ apply(resolver) { const target = resolver.ensureHook(this.target); resolver .getHook(this.source) .tapAsync("ExportsFieldPlugin", (request, resolveContext, callback) => { // When there is no description file, abort if (!request.descriptionFilePath) return callback(); if ( // When the description file is inherited from parent, abort // (There is no description file inside of this package) request.relativePath !== "." || request.request === undefined ) return callback(); const remainingRequest = request.query || request.fragment ? (request.request === "." ? "./" : request.request) + request.query + request.fragment : request.request; const exportsField = /** @type {ExportsField|null|undefined} */ ( DescriptionFileUtils.getField( /** @type {JsonObject} */ (request.descriptionFileData), this.fieldName ) ); if (!exportsField) return callback(); if (request.directory) { return callback( new Error( `Resolving to directories is not possible with the exports field (request was ${remainingRequest}/)` ) ); } /** @type {string[]} */ let paths; /** @type {string | null} */ let usedField; try { // We attach the cache to the description file instead of the exportsField value // because we use a WeakMap and the exportsField could be a string too. // Description file is always an object when exports field can be accessed. let fieldProcessor = this.fieldProcessorCache.get( /** @type {JsonObject} */ (request.descriptionFileData) ); if (fieldProcessor === undefined) { fieldProcessor = processExportsField(exportsField); this.fieldProcessorCache.set( /** @type {JsonObject} */ (request.descriptionFileData), fieldProcessor ); } [paths, usedField] = fieldProcessor( remainingRequest, this.conditionNames ); } catch (/** @type {unknown} */ err) { if (resolveContext.log) { resolveContext.log( `Exports field in ${request.descriptionFilePath} can't be processed: ${err}` ); } return callback(/** @type {Error} */ (err)); } if (paths.length === 0) { return callback( new Error( `Package path ${remainingRequest} is not exported from package ${request.descriptionFileRoot} (see exports field in ${request.descriptionFilePath})` ) ); } forEachBail( paths, /** * @param {string} p path * @param {(err?: null|Error, result?: null|ResolveRequest) => void} callback callback * @param {number} i index * @returns {void} */ (p, callback, i) => { const parsedIdentifier = parseIdentifier(p); if (!parsedIdentifier) return callback(); const [relativePath, query, fragment] = parsedIdentifier; if (relativePath.length === 0 || !relativePath.startsWith("./")) { if (paths.length === i) { return callback( new Error( `Invalid "exports" target "${p}" defined for "${usedField}" in the package config ${request.descriptionFilePath}, targets must start with "./"` ) ); } return callback(); } if ( invalidSegmentRegEx.exec(relativePath.slice(2)) !== null && deprecatedInvalidSegmentRegEx.test(relativePath.slice(2)) !== null ) { if (paths.length === i) { return callback( new Error( `Invalid "exports" target "${p}" defined for "${usedField}" in the package config ${request.descriptionFilePath}, targets must start with "./"` ) ); } return callback(); } /** @type {ResolveRequest} */ const obj = { ...request, request: undefined, path: resolver.join( /** @type {string} */ (request.descriptionFileRoot), relativePath ), relativePath, query, fragment }; resolver.doResolve( target, obj, "using exports field: " + p, resolveContext, (err, result) => { if (err) return callback(err); // Don't allow to continue - https://github.com/webpack/enhanced-resolve/issues/400 if (result === undefined) return callback(null, null); callback(null, result); } ); }, /** * @param {null|Error} [err] error * @param {null|ResolveRequest} [result] result * @returns {void} */ (err, result) => callback(err, result || null) ); }); } };