@strapi/strapi 5.47.1 → 5.48.0

package/dist/src/node/core/dependencies.js

@@ -32,149 +32,114 @@ const writeCachedHash = async (cwd, hash)=>{
 };
 /**
  * From V5 this will be imported from the package.json of `@strapi/strapi`.
- */ const PEER_DEPS = {
+ */ const ADMIN_PEER_DEPS = {
     react: '^18.0.0',
     'react-dom': '^18.0.0',
     'react-router-dom': '^6.0.0',
     'styled-components': '^6.0.0'
 };
-/**
- * Checks the user's project that it has declared and installed the required dependencies
- * needed by the Strapi admin project. Whilst generally speaking most modules will be
- * declared by the actual packages there are some packages where you only really want one of
- * and thus they are declared as peer dependencies – react / styled-components / etc.
- *
- * If these deps are not installed or declared, then we prompt the user to correct this. In
- * V4 this is not a hard requirement, but in V5 it will be. Might as well get people started now.
- */ const checkRequiredDependencies = async ({ cwd, logger })=>{
-    /**
-   * This enables us to use experimental deps for libraries like
-   * react or styled-components. This is useful for testing against.
-   */ if (process.env.USE_EXPERIMENTAL_DEPENDENCIES === 'true') {
-        logger.warn('You are using experimental dependencies that may not be compatible with Strapi.');
-        return {
-            didInstall: false
-        };
-    }
-    // Hash-cache: skip the full check when package.json hasn't changed since
-    // the last successful pass. The cache lives under node_modules so it's
-    // already gitignored and disposable (a `yarn install` wipe re-runs it).
-    const currentHash = await hashPackageJson(cwd);
-    if (currentHash) {
-        const cachedHash = await readCachedHash(cwd);
-        if (cachedHash === currentHash) {
-            return {
-                didInstall: false
-            };
-        }
+class MissingAdminPeerDepsError extends Error {
+    constructor(missing){
+        super('Missing required dependencies. Please install them and re-run this command.');
+        this.name = 'MissingAdminPeerDepsError';
+        this.missing = missing;
     }
+}
+const loadProjectPackageJson = async (cwd)=>{
     const pkg = await readPkgUp({
         cwd
     });
     if (!pkg) {
         throw new Error(`Could not find package.json at path: ${cwd}`);
     }
-    logger.debug('Loaded package.json:', os.EOL, pkg.packageJson);
-    /**
-   * Run through each of the peer deps and figure out if they need to be
-   * installed or they need their version checked against.
-   */ const { install, review } = Object.entries(PEER_DEPS).reduce((acc, [name, version])=>{
-        if (!pkg.packageJson.dependencies) {
-            throw new Error(`Could not find dependencies in package.json at path: ${cwd}`);
-        }
-        const declaredVersion = pkg.packageJson.dependencies[name] ?? pkg.packageJson.devDependencies?.[name];
+    if (!pkg.packageJson.dependencies) {
+        throw new Error(`Could not find dependencies in package.json at path: ${cwd}`);
+    }
+    return pkg;
+};
+/**
+ * Returns admin peer dependencies that are not declared in the project's package.json.
+ */ const findUndeclaredAdminPeerDeps = async (cwd)=>{
+    const pkg = await loadProjectPackageJson(cwd);
+    return Object.entries(ADMIN_PEER_DEPS).reduce((missing, [name, version])=>{
+        const declaredVersion = pkg.packageJson.dependencies?.[name] ?? pkg.packageJson.devDependencies?.[name];
         if (!declaredVersion) {
-            acc.install.push({
+            missing.push({
                 name,
                 wantedVersion: version
             });
-        } else {
-            acc.review.push({
+        }
+        return missing;
+    }, []);
+};
+const getDeclaredAdminPeerDeps = (packageJson)=>{
+    return Object.entries(ADMIN_PEER_DEPS).reduce((declared, [name, version])=>{
+        const declaredVersion = packageJson.dependencies?.[name] ?? packageJson.devDependencies?.[name];
+        if (declaredVersion) {
+            declared.push({
                 name,
                 wantedVersion: version,
                 declaredVersion
             });
         }
-        return acc;
-    }, {
-        install: [],
-        review: []
-    });
-    if (install.length > 0) {
-        logger.info('The Strapi admin needs to install the following dependencies:', os.EOL, install.map(({ name, wantedVersion })=>`  - ${name}@${wantedVersion}`).join(os.EOL));
-        await installDependencies(install, {
-            cwd,
-            logger
-        });
-        const [file, ...args] = process.argv;
-        /**
-     * Re-run the same command after installation e.g. strapi build because the yarn.lock might
-     * not be the same and could break installations. It's not the best solution, but it works.
-     */ await execa(file, args, {
-            cwd,
-            stdio: 'inherit'
-        });
-        return {
-            didInstall: true
-        };
+        return declared;
+    }, []);
+};
+const getInstallCommandHint = (missing)=>{
+    const packages = missing.map(({ name, wantedVersion })=>`${name}@${wantedVersion}`).join(' ');
+    const packageManager = managers.getPackageManager();
+    if (packageManager === 'yarn') {
+        return `yarn add ${packages}`;
+    }
+    if (packageManager === 'pnpm') {
+        return `pnpm add --save-prod ${packages}`;
     }
-    if (review.length) {
-        const errors = [];
-        for (const dep of review){
-            // The version specified in package.json could be incorrect, eg `foo`
-            let minDeclaredVersion = null;
-            try {
-                minDeclaredVersion = semver.minVersion(dep.declaredVersion);
-            } catch (err) {
-            // Intentional fall-through (variable will be left as null, throwing below)
-            }
-            if (!minDeclaredVersion) {
-                errors.push(`The declared dependency, ${dep.name} has an invalid version in package.json: ${dep.declaredVersion}`);
-            } else if (!semver.satisfies(minDeclaredVersion, dep.wantedVersion)) {
-                /**
-         * The delcared version should be semver compatible with our required version
-         * of the dependency. If it's not, we should advise the user to change it.
-         */ logger.warn([
-                    `Declared version of ${dep.name} (${minDeclaredVersion}) is not compatible with the version required by Strapi (${dep.wantedVersion}).`,
-                    'You may experience issues, we recommend you change this.'
-                ].join(os.EOL));
-            }
-            const installedVersion = await getModuleVersion(dep.name, cwd);
-            if (!installedVersion) {
-                /**
-         * TODO: when we know the packageManager we can advise the actual install command.
-         */ errors.push(`The declared dependency, ${dep.name} is not installed. You should install before re-running this command`);
-            } else if (!semver.satisfies(installedVersion, dep.wantedVersion)) {
-                logger.warn([
-                    `Declared version of ${dep.name} (${installedVersion}) is not compatible with the version required by Strapi (${dep.wantedVersion}).`,
-                    'You may experience issues, we recommend you change this.'
-                ].join(os.EOL));
-            }
+    return `npm install --legacy-peer-deps --save ${packages}`;
+};
+const reportMissingAdminPeerDeps = (logger, missing)=>{
+    logger.error('The Strapi admin is missing required dependencies:', os.EOL, missing.map(({ name, wantedVersion })=>`  - ${name}@${wantedVersion}`).join(os.EOL));
+    logger.error('Please install them manually before re-running this command:', os.EOL, `  ${getInstallCommandHint(missing)}`);
+};
+/**
+ * Validates declared admin peer dependencies (versions and node_modules presence).
+ */ const validateDeclaredAdminPeerDeps = async (cwd, logger)=>{
+    const pkg = await loadProjectPackageJson(cwd);
+    const declared = getDeclaredAdminPeerDeps(pkg.packageJson);
+    if (!declared.length) {
+        return;
+    }
+    logger.debug('Loaded package.json:', os.EOL, pkg.packageJson);
+    const errors = [];
+    for (const dep of declared){
+        let minDeclaredVersion = null;
+        try {
+            minDeclaredVersion = semver.minVersion(dep.declaredVersion);
+        } catch (err) {
+        // Intentional fall-through (variable will be left as null, throwing below)
         }
-        if (errors.length > 0 && process.env.NODE_ENV === 'development') {
-            throw new Error(`${os.EOL}- ${errors.join(`${os.EOL}- `)}`);
+        if (!minDeclaredVersion) {
+            errors.push(`The declared dependency, ${dep.name} has an invalid version in package.json: ${dep.declaredVersion}`);
+        } else if (!semver.satisfies(minDeclaredVersion, dep.wantedVersion)) {
+            logger.warn([
+                `Declared version of ${dep.name} (${minDeclaredVersion}) is not compatible with the version required by Strapi (${dep.wantedVersion}).`,
+                'You may experience issues, we recommend you change this.'
+            ].join(os.EOL));
+        }
+        const installedVersion = await getModuleVersion(dep.name, cwd);
+        if (!installedVersion) {
+            errors.push(`The declared dependency, ${dep.name} is not installed. You should install before re-running this command`);
+        } else if (!semver.satisfies(installedVersion, dep.wantedVersion)) {
+            logger.warn([
+                `Declared version of ${dep.name} (${installedVersion}) is not compatible with the version required by Strapi (${dep.wantedVersion}).`,
+                'You may experience issues, we recommend you change this.'
+            ].join(os.EOL));
         }
     }
-    if (currentHash) {
-        await writeCachedHash(cwd, currentHash);
-    }
-    return {
-        didInstall: false
-    };
-};
-const getModule = async (name, cwd)=>{
-    const modulePackagePath = resolveFrom.silent(cwd, path.join(name, 'package.json'));
-    if (!modulePackagePath) {
-        return null;
+    if (errors.length > 0 && process.env.NODE_ENV === 'development') {
+        throw new Error(`${os.EOL}- ${errors.join(`${os.EOL}- `)}`);
     }
-    const file = await fs.readFile(modulePackagePath, 'utf8').then((res)=>JSON.parse(res));
-    return file;
-};
-const getModuleVersion = async (name, cwd)=>{
-    const pkg = await getModule(name, cwd);
-    return pkg?.version || null;
 };
-const installDependencies = async (install, { cwd, logger })=>{
+const installAdminPeerDeps = async (missing, { cwd, logger })=>{
     const packageManager = managers.getPackageManager();
     if (!packageManager) {
         logger.error('Could not find a supported package manager, please install the dependencies manually.');
@@ -185,7 +150,7 @@ const installDependencies = async (install, { cwd, logger })=>{
         cwd,
         stdio: 'inherit'
     };
-    const packages = install.map(({ name, wantedVersion })=>`${name}@${wantedVersion}`);
+    const packages = missing.map(({ name, wantedVersion })=>`${name}@${wantedVersion}`);
     let result;
     if (packageManager === 'npm') {
         const npmArgs = [
@@ -216,7 +181,39 @@ const installDependencies = async (install, { cwd, logger })=>{
         throw new Error('Package installation failed');
     }
 };
+const reexecCurrentCommand = async (cwd)=>{
+    const [file, ...args] = process.argv;
+    /**
+   * Re-run the same command after installation e.g. strapi build because the yarn.lock might
+   * not be the same and could break installations. It's not the best solution, but it works.
+   */ await execa(file, args, {
+        cwd,
+        stdio: 'inherit'
+    });
+};
+const getModule = async (name, cwd)=>{
+    const modulePackagePath = resolveFrom.silent(cwd, path.join(name, 'package.json'));
+    if (!modulePackagePath) {
+        return null;
+    }
+    const file = await fs.readFile(modulePackagePath, 'utf8').then((res)=>JSON.parse(res));
+    return file;
+};
+const getModuleVersion = async (name, cwd)=>{
+    const pkg = await getModule(name, cwd);
+    return pkg?.version || null;
+};
 
-exports.checkRequiredDependencies = checkRequiredDependencies;
+exports.ADMIN_PEER_DEPS = ADMIN_PEER_DEPS;
+exports.MissingAdminPeerDepsError = MissingAdminPeerDepsError;
+exports.findUndeclaredAdminPeerDeps = findUndeclaredAdminPeerDeps;
+exports.getInstallCommandHint = getInstallCommandHint;
 exports.getModule = getModule;
+exports.hashPackageJson = hashPackageJson;
+exports.installAdminPeerDeps = installAdminPeerDeps;
+exports.readCachedHash = readCachedHash;
+exports.reexecCurrentCommand = reexecCurrentCommand;
+exports.reportMissingAdminPeerDeps = reportMissingAdminPeerDeps;
+exports.validateDeclaredAdminPeerDeps = validateDeclaredAdminPeerDeps;
+exports.writeCachedHash = writeCachedHash;
 //# sourceMappingURL=dependencies.js.map

package/dist/src/node/core/dependencies.js.map

@@ -1 +1 @@
-{"version":3,"file":"dependencies.js","sources":["../../../../src/node/core/dependencies.ts"],"sourcesContent":["import os from 'node:os';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\nimport crypto from 'node:crypto';\nimport semver, { SemVer } from 'semver';\nimport resolveFrom from 'resolve-from';\nimport execa, { CommonOptions, ExecaReturnValue } from 'execa';\nimport readPkgUp, { PackageJson } from 'read-pkg-up';\nimport type { BuildOptions } from '../build';\nimport { getPackageManager } from './managers';\n\nconst CACHE_PATH = path.join('node_modules', '.strapi', 'deps-check.hash');\n\nconst hashPackageJson = async (cwd: string): Promise<string | null> => {\n  try {\n    const content = await fs.readFile(path.join(cwd, 'package.json'), 'utf8');\n    return crypto.createHash('sha1').update(content).digest('hex');\n  } catch {\n    return null;\n  }\n};\n\nconst readCachedHash = (cwd: string): Promise<string | null> =>\n  fs.readFile(path.join(cwd, CACHE_PATH), 'utf8').catch(() => null);\n\nconst writeCachedHash = async (cwd: string, hash: string): Promise<void> => {\n  try {\n    await fs.mkdir(path.dirname(path.join(cwd, CACHE_PATH)), { recursive: true });\n    await fs.writeFile(path.join(cwd, CACHE_PATH), hash, 'utf8');\n  } catch {\n    // best-effort cache write — silently ignore\n  }\n};\n\n/**\n * From V5 this will be imported from the package.json of `@strapi/strapi`.\n */\nconst PEER_DEPS = {\n  react: '^18.0.0',\n  'react-dom': '^18.0.0',\n  'react-router-dom': '^6.0.0',\n  'styled-components': '^6.0.0',\n};\n\ninterface CheckRequiredDependenciesResult {\n  didInstall: boolean;\n}\n\ninterface DepToInstall {\n  name: string;\n  wantedVersion: string;\n  declaredVersion?: never;\n}\n\n/**\n * Checks the user's project that it has declared and installed the required dependencies\n * needed by the Strapi admin project. Whilst generally speaking most modules will be\n * declared by the actual packages there are some packages where you only really want one of\n * and thus they are declared as peer dependencies – react / styled-components / etc.\n *\n * If these deps are not installed or declared, then we prompt the user to correct this. In\n * V4 this is not a hard requirement, but in V5 it will be. Might as well get people started now.\n */\nconst checkRequiredDependencies = async ({\n  cwd,\n  logger,\n}: Pick<BuildOptions, 'cwd' | 'logger'>): Promise<CheckRequiredDependenciesResult> => {\n  /**\n   * This enables us to use experimental deps for libraries like\n   * react or styled-components. This is useful for testing against.\n   */\n  if (process.env.USE_EXPERIMENTAL_DEPENDENCIES === 'true') {\n    logger.warn('You are using experimental dependencies that may not be compatible with Strapi.');\n    return { didInstall: false };\n  }\n\n  // Hash-cache: skip the full check when package.json hasn't changed since\n  // the last successful pass. The cache lives under node_modules so it's\n  // already gitignored and disposable (a `yarn install` wipe re-runs it).\n  const currentHash = await hashPackageJson(cwd);\n  if (currentHash) {\n    const cachedHash = await readCachedHash(cwd);\n    if (cachedHash === currentHash) {\n      return { didInstall: false };\n    }\n  }\n\n  const pkg = await readPkgUp({ cwd });\n\n  if (!pkg) {\n    throw new Error(`Could not find package.json at path: ${cwd}`);\n  }\n\n  logger.debug('Loaded package.json:', os.EOL, pkg.packageJson);\n\n  interface DepToReview {\n    name: string;\n    wantedVersion: string;\n    declaredVersion: string;\n  }\n\n  /**\n   * Run through each of the peer deps and figure out if they need to be\n   * installed or they need their version checked against.\n   */\n  const { install, review } = Object.entries(PEER_DEPS).reduce<{\n    install: DepToInstall[];\n    review: DepToReview[];\n  }>(\n    (acc, [name, version]) => {\n      if (!pkg.packageJson.dependencies) {\n        throw new Error(`Could not find dependencies in package.json at path: ${cwd}`);\n      }\n\n      const declaredVersion =\n        pkg.packageJson.dependencies[name] ?? pkg.packageJson.devDependencies?.[name];\n\n      if (!declaredVersion) {\n        acc.install.push({\n          name,\n          wantedVersion: version,\n        });\n      } else {\n        acc.review.push({\n          name,\n          wantedVersion: version,\n          declaredVersion,\n        });\n      }\n\n      return acc;\n    },\n    {\n      install: [],\n      review: [],\n    }\n  );\n\n  if (install.length > 0) {\n    logger.info(\n      'The Strapi admin needs to install the following dependencies:',\n      os.EOL,\n      install.map(({ name, wantedVersion }) => `  - ${name}@${wantedVersion}`).join(os.EOL)\n    );\n\n    await installDependencies(install, {\n      cwd,\n      logger,\n    });\n\n    const [file, ...args] = process.argv;\n\n    /**\n     * Re-run the same command after installation e.g. strapi build because the yarn.lock might\n     * not be the same and could break installations. It's not the best solution, but it works.\n     */\n    await execa(file, args, { cwd, stdio: 'inherit' });\n    return { didInstall: true };\n  }\n\n  if (review.length) {\n    const errors: string[] = [];\n\n    for (const dep of review) {\n      // The version specified in package.json could be incorrect, eg `foo`\n      let minDeclaredVersion: SemVer | null = null;\n      try {\n        minDeclaredVersion = semver.minVersion(dep.declaredVersion);\n      } catch (err) {\n        // Intentional fall-through (variable will be left as null, throwing below)\n      }\n\n      if (!minDeclaredVersion) {\n        errors.push(\n          `The declared dependency, ${dep.name} has an invalid version in package.json: ${dep.declaredVersion}`\n        );\n      } else if (!semver.satisfies(minDeclaredVersion, dep.wantedVersion)) {\n        /**\n         * The delcared version should be semver compatible with our required version\n         * of the dependency. If it's not, we should advise the user to change it.\n         */\n        logger.warn(\n          [\n            `Declared version of ${dep.name} (${minDeclaredVersion}) is not compatible with the version required by Strapi (${dep.wantedVersion}).`,\n            'You may experience issues, we recommend you change this.',\n          ].join(os.EOL)\n        );\n      }\n\n      const installedVersion = await getModuleVersion(dep.name, cwd);\n\n      if (!installedVersion) {\n        /**\n         * TODO: when we know the packageManager we can advise the actual install command.\n         */\n        errors.push(\n          `The declared dependency, ${dep.name} is not installed. You should install before re-running this command`\n        );\n      } else if (!semver.satisfies(installedVersion, dep.wantedVersion)) {\n        logger.warn(\n          [\n            `Declared version of ${dep.name} (${installedVersion}) is not compatible with the version required by Strapi (${dep.wantedVersion}).`,\n            'You may experience issues, we recommend you change this.',\n          ].join(os.EOL)\n        );\n      }\n    }\n\n    if (errors.length > 0 && process.env.NODE_ENV === 'development') {\n      throw new Error(`${os.EOL}- ${errors.join(`${os.EOL}- `)}`);\n    }\n  }\n\n  if (currentHash) {\n    await writeCachedHash(cwd, currentHash);\n  }\n\n  return { didInstall: false };\n};\n\nconst getModule = async (name: string, cwd: string): Promise<PackageJson | null> => {\n  const modulePackagePath = resolveFrom.silent(cwd, path.join(name, 'package.json'));\n  if (!modulePackagePath) {\n    return null;\n  }\n  const file = await fs.readFile(modulePackagePath, 'utf8').then((res) => JSON.parse(res));\n\n  return file;\n};\n\nconst getModuleVersion = async (name: string, cwd: string): Promise<string | null> => {\n  const pkg = await getModule(name, cwd);\n\n  return pkg?.version || null;\n};\n\nconst installDependencies = async (\n  install: DepToInstall[],\n  { cwd, logger }: Pick<BuildOptions, 'cwd' | 'logger'>\n) => {\n  const packageManager = getPackageManager();\n\n  if (!packageManager) {\n    logger.error(\n      'Could not find a supported package manager, please install the dependencies manually.'\n    );\n    process.exit(1);\n  }\n\n  const execOptions: CommonOptions<'utf8'> = {\n    encoding: 'utf8',\n    cwd,\n    stdio: 'inherit',\n  };\n\n  const packages = install.map(({ name, wantedVersion }) => `${name}@${wantedVersion}`);\n\n  let result: ExecaReturnValue<string> | undefined;\n\n  if (packageManager === 'npm') {\n    const npmArgs = ['install', '--legacy-peer-deps', '--save', ...packages];\n    logger.info(`Running 'npm ${npmArgs.join(' ')}'`);\n    result = await execa('npm', npmArgs, execOptions);\n  } else if (packageManager === 'yarn') {\n    const yarnArgs = ['add', ...packages];\n    logger.info(`Running 'yarn ${yarnArgs.join(' ')}'`);\n    result = await execa('yarn', yarnArgs, execOptions);\n  } else if (packageManager === 'pnpm') {\n    const pnpmArgs = ['add', '--save-prod', ...packages];\n    logger.info(`Running 'pnpm ${pnpmArgs.join(' ')}'`);\n    result = await execa('pnpm', pnpmArgs, execOptions);\n  }\n\n  if (result?.exitCode || result?.failed) {\n    throw new Error('Package installation failed');\n  }\n};\n\nexport { checkRequiredDependencies, getModule };\nexport type { CheckRequiredDependenciesResult, PackageJson };\n"],"names":["CACHE_PATH","path","join","hashPackageJson","cwd","content","fs","readFile","crypto","createHash","update","digest","readCachedHash","catch","writeCachedHash","hash","mkdir","dirname","recursive","writeFile","PEER_DEPS","react","checkRequiredDependencies","logger","process","env","USE_EXPERIMENTAL_DEPENDENCIES","warn","didInstall","currentHash","cachedHash","pkg","readPkgUp","Error","debug","os","EOL","packageJson","install","review","Object","entries","reduce","acc","name","version","dependencies","declaredVersion","devDependencies","push","wantedVersion","length","info","map","installDependencies","file","args","argv","execa","stdio","errors","dep","minDeclaredVersion","semver","minVersion","err","satisfies","installedVersion","getModuleVersion","NODE_ENV","getModule","modulePackagePath","resolveFrom","silent","then","res","JSON","parse","packageManager","getPackageManager","error","exit","execOptions","encoding","packages","result","npmArgs","yarnArgs","pnpmArgs","exitCode","failed"],"mappings":"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"}
+{"version":3,"file":"dependencies.js","sources":["../../../../src/node/core/dependencies.ts"],"sourcesContent":["import os from 'node:os';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\nimport crypto from 'node:crypto';\nimport semver, { SemVer } from 'semver';\nimport resolveFrom from 'resolve-from';\nimport execa, { CommonOptions, ExecaReturnValue } from 'execa';\nimport readPkgUp, { PackageJson } from 'read-pkg-up';\n\nimport type { Logger } from '../../cli/utils/logger';\nimport { getPackageManager } from './managers';\n\nconst CACHE_PATH = path.join('node_modules', '.strapi', 'deps-check.hash');\n\nconst hashPackageJson = async (cwd: string): Promise<string | null> => {\n  try {\n    const content = await fs.readFile(path.join(cwd, 'package.json'), 'utf8');\n    return crypto.createHash('sha1').update(content).digest('hex');\n  } catch {\n    return null;\n  }\n};\n\nconst readCachedHash = (cwd: string): Promise<string | null> =>\n  fs.readFile(path.join(cwd, CACHE_PATH), 'utf8').catch(() => null);\n\nconst writeCachedHash = async (cwd: string, hash: string): Promise<void> => {\n  try {\n    await fs.mkdir(path.dirname(path.join(cwd, CACHE_PATH)), { recursive: true });\n    await fs.writeFile(path.join(cwd, CACHE_PATH), hash, 'utf8');\n  } catch {\n    // best-effort cache write — silently ignore\n  }\n};\n\n/**\n * From V5 this will be imported from the package.json of `@strapi/strapi`.\n */\nconst ADMIN_PEER_DEPS = {\n  react: '^18.0.0',\n  'react-dom': '^18.0.0',\n  'react-router-dom': '^6.0.0',\n  'styled-components': '^6.0.0',\n} as const;\n\ninterface AdminPeerDep {\n  name: string;\n  wantedVersion: string;\n}\n\ninterface DeclaredAdminPeerDep extends AdminPeerDep {\n  declaredVersion: string;\n}\n\nclass MissingAdminPeerDepsError extends Error {\n  readonly missing: AdminPeerDep[];\n\n  constructor(missing: AdminPeerDep[]) {\n    super('Missing required dependencies. Please install them and re-run this command.');\n    this.name = 'MissingAdminPeerDepsError';\n    this.missing = missing;\n  }\n}\n\nconst loadProjectPackageJson = async (cwd: string) => {\n  const pkg = await readPkgUp({ cwd });\n\n  if (!pkg) {\n    throw new Error(`Could not find package.json at path: ${cwd}`);\n  }\n\n  if (!pkg.packageJson.dependencies) {\n    throw new Error(`Could not find dependencies in package.json at path: ${cwd}`);\n  }\n\n  return pkg;\n};\n\n/**\n * Returns admin peer dependencies that are not declared in the project's package.json.\n */\nconst findUndeclaredAdminPeerDeps = async (cwd: string): Promise<AdminPeerDep[]> => {\n  const pkg = await loadProjectPackageJson(cwd);\n\n  return Object.entries(ADMIN_PEER_DEPS).reduce<AdminPeerDep[]>((missing, [name, version]) => {\n    const declaredVersion =\n      pkg.packageJson.dependencies?.[name] ?? pkg.packageJson.devDependencies?.[name];\n\n    if (!declaredVersion) {\n      missing.push({\n        name,\n        wantedVersion: version,\n      });\n    }\n\n    return missing;\n  }, []);\n};\n\nconst getDeclaredAdminPeerDeps = (packageJson: PackageJson): DeclaredAdminPeerDep[] => {\n  return Object.entries(ADMIN_PEER_DEPS).reduce<DeclaredAdminPeerDep[]>(\n    (declared, [name, version]) => {\n      const declaredVersion =\n        packageJson.dependencies?.[name] ?? packageJson.devDependencies?.[name];\n\n      if (declaredVersion) {\n        declared.push({\n          name,\n          wantedVersion: version,\n          declaredVersion,\n        });\n      }\n\n      return declared;\n    },\n    []\n  );\n};\n\nconst getInstallCommandHint = (missing: AdminPeerDep[]) => {\n  const packages = missing.map(({ name, wantedVersion }) => `${name}@${wantedVersion}`).join(' ');\n  const packageManager = getPackageManager();\n\n  if (packageManager === 'yarn') {\n    return `yarn add ${packages}`;\n  }\n\n  if (packageManager === 'pnpm') {\n    return `pnpm add --save-prod ${packages}`;\n  }\n\n  return `npm install --legacy-peer-deps --save ${packages}`;\n};\n\nconst reportMissingAdminPeerDeps = (logger: Logger, missing: AdminPeerDep[]) => {\n  logger.error(\n    'The Strapi admin is missing required dependencies:',\n    os.EOL,\n    missing.map(({ name, wantedVersion }) => `  - ${name}@${wantedVersion}`).join(os.EOL)\n  );\n  logger.error(\n    'Please install them manually before re-running this command:',\n    os.EOL,\n    `  ${getInstallCommandHint(missing)}`\n  );\n};\n\n/**\n * Validates declared admin peer dependencies (versions and node_modules presence).\n */\nconst validateDeclaredAdminPeerDeps = async (cwd: string, logger: Logger) => {\n  const pkg = await loadProjectPackageJson(cwd);\n  const declared = getDeclaredAdminPeerDeps(pkg.packageJson);\n\n  if (!declared.length) {\n    return;\n  }\n\n  logger.debug('Loaded package.json:', os.EOL, pkg.packageJson);\n\n  const errors: string[] = [];\n\n  for (const dep of declared) {\n    let minDeclaredVersion: SemVer | null = null;\n\n    try {\n      minDeclaredVersion = semver.minVersion(dep.declaredVersion);\n    } catch (err) {\n      // Intentional fall-through (variable will be left as null, throwing below)\n    }\n\n    if (!minDeclaredVersion) {\n      errors.push(\n        `The declared dependency, ${dep.name} has an invalid version in package.json: ${dep.declaredVersion}`\n      );\n    } else if (!semver.satisfies(minDeclaredVersion, dep.wantedVersion)) {\n      logger.warn(\n        [\n          `Declared version of ${dep.name} (${minDeclaredVersion}) is not compatible with the version required by Strapi (${dep.wantedVersion}).`,\n          'You may experience issues, we recommend you change this.',\n        ].join(os.EOL)\n      );\n    }\n\n    const installedVersion = await getModuleVersion(dep.name, cwd);\n\n    if (!installedVersion) {\n      errors.push(\n        `The declared dependency, ${dep.name} is not installed. You should install before re-running this command`\n      );\n    } else if (!semver.satisfies(installedVersion, dep.wantedVersion)) {\n      logger.warn(\n        [\n          `Declared version of ${dep.name} (${installedVersion}) is not compatible with the version required by Strapi (${dep.wantedVersion}).`,\n          'You may experience issues, we recommend you change this.',\n        ].join(os.EOL)\n      );\n    }\n  }\n\n  if (errors.length > 0 && process.env.NODE_ENV === 'development') {\n    throw new Error(`${os.EOL}- ${errors.join(`${os.EOL}- `)}`);\n  }\n};\n\nconst installAdminPeerDeps = async (\n  missing: AdminPeerDep[],\n  { cwd, logger }: { cwd: string; logger: Logger }\n) => {\n  const packageManager = getPackageManager();\n\n  if (!packageManager) {\n    logger.error(\n      'Could not find a supported package manager, please install the dependencies manually.'\n    );\n    process.exit(1);\n  }\n\n  const execOptions: CommonOptions<'utf8'> = {\n    encoding: 'utf8',\n    cwd,\n    stdio: 'inherit',\n  };\n\n  const packages = missing.map(({ name, wantedVersion }) => `${name}@${wantedVersion}`);\n\n  let result: ExecaReturnValue<string> | undefined;\n\n  if (packageManager === 'npm') {\n    const npmArgs = ['install', '--legacy-peer-deps', '--save', ...packages];\n    logger.info(`Running 'npm ${npmArgs.join(' ')}'`);\n    result = await execa('npm', npmArgs, execOptions);\n  } else if (packageManager === 'yarn') {\n    const yarnArgs = ['add', ...packages];\n    logger.info(`Running 'yarn ${yarnArgs.join(' ')}'`);\n    result = await execa('yarn', yarnArgs, execOptions);\n  } else if (packageManager === 'pnpm') {\n    const pnpmArgs = ['add', '--save-prod', ...packages];\n    logger.info(`Running 'pnpm ${pnpmArgs.join(' ')}'`);\n    result = await execa('pnpm', pnpmArgs, execOptions);\n  }\n\n  if (result?.exitCode || result?.failed) {\n    throw new Error('Package installation failed');\n  }\n};\n\nconst reexecCurrentCommand = async (cwd: string) => {\n  const [file, ...args] = process.argv;\n\n  /**\n   * Re-run the same command after installation e.g. strapi build because the yarn.lock might\n   * not be the same and could break installations. It's not the best solution, but it works.\n   */\n  await execa(file, args, { cwd, stdio: 'inherit' });\n};\n\nconst getModule = async (name: string, cwd: string): Promise<PackageJson | null> => {\n  const modulePackagePath = resolveFrom.silent(cwd, path.join(name, 'package.json'));\n  if (!modulePackagePath) {\n    return null;\n  }\n  const file = await fs.readFile(modulePackagePath, 'utf8').then((res) => JSON.parse(res));\n\n  return file;\n};\n\nconst getModuleVersion = async (name: string, cwd: string): Promise<string | null> => {\n  const pkg = await getModule(name, cwd);\n\n  return pkg?.version || null;\n};\n\nexport {\n  ADMIN_PEER_DEPS,\n  findUndeclaredAdminPeerDeps,\n  validateDeclaredAdminPeerDeps,\n  installAdminPeerDeps,\n  reexecCurrentCommand,\n  reportMissingAdminPeerDeps,\n  getInstallCommandHint,\n  MissingAdminPeerDepsError,\n  getModule,\n  hashPackageJson,\n  readCachedHash,\n  writeCachedHash,\n};\nexport type { AdminPeerDep, PackageJson };\n"],"names":["CACHE_PATH","path","join","hashPackageJson","cwd","content","fs","readFile","crypto","createHash","update","digest","readCachedHash","catch","writeCachedHash","hash","mkdir","dirname","recursive","writeFile","ADMIN_PEER_DEPS","react","MissingAdminPeerDepsError","Error","missing","name","loadProjectPackageJson","pkg","readPkgUp","packageJson","dependencies","findUndeclaredAdminPeerDeps","Object","entries","reduce","version","declaredVersion","devDependencies","push","wantedVersion","getDeclaredAdminPeerDeps","declared","getInstallCommandHint","packages","map","packageManager","getPackageManager","reportMissingAdminPeerDeps","logger","error","os","EOL","validateDeclaredAdminPeerDeps","length","debug","errors","dep","minDeclaredVersion","semver","minVersion","err","satisfies","warn","installedVersion","getModuleVersion","process","env","NODE_ENV","installAdminPeerDeps","exit","execOptions","encoding","stdio","result","npmArgs","info","execa","yarnArgs","pnpmArgs","exitCode","failed","reexecCurrentCommand","file","args","argv","getModule","modulePackagePath","resolveFrom","silent","then","res","JSON","parse"],"mappings":"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"}

package/dist/src/node/core/dependencies.mjs

@@ -30,149 +30,114 @@ const writeCachedHash = async (cwd, hash)=>{
 };
 /**
  * From V5 this will be imported from the package.json of `@strapi/strapi`.
- */ const PEER_DEPS = {
+ */ const ADMIN_PEER_DEPS = {
     react: '^18.0.0',
     'react-dom': '^18.0.0',
     'react-router-dom': '^6.0.0',
     'styled-components': '^6.0.0'
 };
-/**
- * Checks the user's project that it has declared and installed the required dependencies
- * needed by the Strapi admin project. Whilst generally speaking most modules will be
- * declared by the actual packages there are some packages where you only really want one of
- * and thus they are declared as peer dependencies – react / styled-components / etc.
- *
- * If these deps are not installed or declared, then we prompt the user to correct this. In
- * V4 this is not a hard requirement, but in V5 it will be. Might as well get people started now.
- */ const checkRequiredDependencies = async ({ cwd, logger })=>{
-    /**
-   * This enables us to use experimental deps for libraries like
-   * react or styled-components. This is useful for testing against.
-   */ if (process.env.USE_EXPERIMENTAL_DEPENDENCIES === 'true') {
-        logger.warn('You are using experimental dependencies that may not be compatible with Strapi.');
-        return {
-            didInstall: false
-        };
-    }
-    // Hash-cache: skip the full check when package.json hasn't changed since
-    // the last successful pass. The cache lives under node_modules so it's
-    // already gitignored and disposable (a `yarn install` wipe re-runs it).
-    const currentHash = await hashPackageJson(cwd);
-    if (currentHash) {
-        const cachedHash = await readCachedHash(cwd);
-        if (cachedHash === currentHash) {
-            return {
-                didInstall: false
-            };
-        }
+class MissingAdminPeerDepsError extends Error {
+    constructor(missing){
+        super('Missing required dependencies. Please install them and re-run this command.');
+        this.name = 'MissingAdminPeerDepsError';
+        this.missing = missing;
     }
+}
+const loadProjectPackageJson = async (cwd)=>{
     const pkg = await readPkgUp({
         cwd
     });
     if (!pkg) {
         throw new Error(`Could not find package.json at path: ${cwd}`);
     }
-    logger.debug('Loaded package.json:', os.EOL, pkg.packageJson);
-    /**
-   * Run through each of the peer deps and figure out if they need to be
-   * installed or they need their version checked against.
-   */ const { install, review } = Object.entries(PEER_DEPS).reduce((acc, [name, version])=>{
-        if (!pkg.packageJson.dependencies) {
-            throw new Error(`Could not find dependencies in package.json at path: ${cwd}`);
-        }
-        const declaredVersion = pkg.packageJson.dependencies[name] ?? pkg.packageJson.devDependencies?.[name];
+    if (!pkg.packageJson.dependencies) {
+        throw new Error(`Could not find dependencies in package.json at path: ${cwd}`);
+    }
+    return pkg;
+};
+/**
+ * Returns admin peer dependencies that are not declared in the project's package.json.
+ */ const findUndeclaredAdminPeerDeps = async (cwd)=>{
+    const pkg = await loadProjectPackageJson(cwd);
+    return Object.entries(ADMIN_PEER_DEPS).reduce((missing, [name, version])=>{
+        const declaredVersion = pkg.packageJson.dependencies?.[name] ?? pkg.packageJson.devDependencies?.[name];
         if (!declaredVersion) {
-            acc.install.push({
+            missing.push({
                 name,
                 wantedVersion: version
             });
-        } else {
-            acc.review.push({
+        }
+        return missing;
+    }, []);
+};
+const getDeclaredAdminPeerDeps = (packageJson)=>{
+    return Object.entries(ADMIN_PEER_DEPS).reduce((declared, [name, version])=>{
+        const declaredVersion = packageJson.dependencies?.[name] ?? packageJson.devDependencies?.[name];
+        if (declaredVersion) {
+            declared.push({
                 name,
                 wantedVersion: version,
                 declaredVersion
             });
         }
-        return acc;
-    }, {
-        install: [],
-        review: []
-    });
-    if (install.length > 0) {
-        logger.info('The Strapi admin needs to install the following dependencies:', os.EOL, install.map(({ name, wantedVersion })=>`  - ${name}@${wantedVersion}`).join(os.EOL));
-        await installDependencies(install, {
-            cwd,
-            logger
-        });
-        const [file, ...args] = process.argv;
-        /**
-     * Re-run the same command after installation e.g. strapi build because the yarn.lock might
-     * not be the same and could break installations. It's not the best solution, but it works.
-     */ await execa(file, args, {
-            cwd,
-            stdio: 'inherit'
-        });
-        return {
-            didInstall: true
-        };
+        return declared;
+    }, []);
+};
+const getInstallCommandHint = (missing)=>{
+    const packages = missing.map(({ name, wantedVersion })=>`${name}@${wantedVersion}`).join(' ');
+    const packageManager = getPackageManager();
+    if (packageManager === 'yarn') {
+        return `yarn add ${packages}`;
+    }
+    if (packageManager === 'pnpm') {
+        return `pnpm add --save-prod ${packages}`;
     }
-    if (review.length) {
-        const errors = [];
-        for (const dep of review){
-            // The version specified in package.json could be incorrect, eg `foo`
-            let minDeclaredVersion = null;
-            try {
-                minDeclaredVersion = semver.minVersion(dep.declaredVersion);
-            } catch (err) {
-            // Intentional fall-through (variable will be left as null, throwing below)
-            }
-            if (!minDeclaredVersion) {
-                errors.push(`The declared dependency, ${dep.name} has an invalid version in package.json: ${dep.declaredVersion}`);
-            } else if (!semver.satisfies(minDeclaredVersion, dep.wantedVersion)) {
-                /**
-         * The delcared version should be semver compatible with our required version
-         * of the dependency. If it's not, we should advise the user to change it.
-         */ logger.warn([
-                    `Declared version of ${dep.name} (${minDeclaredVersion}) is not compatible with the version required by Strapi (${dep.wantedVersion}).`,
-                    'You may experience issues, we recommend you change this.'
-                ].join(os.EOL));
-            }
-            const installedVersion = await getModuleVersion(dep.name, cwd);
-            if (!installedVersion) {
-                /**
-         * TODO: when we know the packageManager we can advise the actual install command.
-         */ errors.push(`The declared dependency, ${dep.name} is not installed. You should install before re-running this command`);
-            } else if (!semver.satisfies(installedVersion, dep.wantedVersion)) {
-                logger.warn([
-                    `Declared version of ${dep.name} (${installedVersion}) is not compatible with the version required by Strapi (${dep.wantedVersion}).`,
-                    'You may experience issues, we recommend you change this.'
-                ].join(os.EOL));
-            }
+    return `npm install --legacy-peer-deps --save ${packages}`;
+};
+const reportMissingAdminPeerDeps = (logger, missing)=>{
+    logger.error('The Strapi admin is missing required dependencies:', os.EOL, missing.map(({ name, wantedVersion })=>`  - ${name}@${wantedVersion}`).join(os.EOL));
+    logger.error('Please install them manually before re-running this command:', os.EOL, `  ${getInstallCommandHint(missing)}`);
+};
+/**
+ * Validates declared admin peer dependencies (versions and node_modules presence).
+ */ const validateDeclaredAdminPeerDeps = async (cwd, logger)=>{
+    const pkg = await loadProjectPackageJson(cwd);
+    const declared = getDeclaredAdminPeerDeps(pkg.packageJson);
+    if (!declared.length) {
+        return;
+    }
+    logger.debug('Loaded package.json:', os.EOL, pkg.packageJson);
+    const errors = [];
+    for (const dep of declared){
+        let minDeclaredVersion = null;
+        try {
+            minDeclaredVersion = semver.minVersion(dep.declaredVersion);
+        } catch (err) {
+        // Intentional fall-through (variable will be left as null, throwing below)
         }
-        if (errors.length > 0 && process.env.NODE_ENV === 'development') {
-            throw new Error(`${os.EOL}- ${errors.join(`${os.EOL}- `)}`);
+        if (!minDeclaredVersion) {
+            errors.push(`The declared dependency, ${dep.name} has an invalid version in package.json: ${dep.declaredVersion}`);
+        } else if (!semver.satisfies(minDeclaredVersion, dep.wantedVersion)) {
+            logger.warn([
+                `Declared version of ${dep.name} (${minDeclaredVersion}) is not compatible with the version required by Strapi (${dep.wantedVersion}).`,
+                'You may experience issues, we recommend you change this.'
+            ].join(os.EOL));
+        }
+        const installedVersion = await getModuleVersion(dep.name, cwd);
+        if (!installedVersion) {
+            errors.push(`The declared dependency, ${dep.name} is not installed. You should install before re-running this command`);
+        } else if (!semver.satisfies(installedVersion, dep.wantedVersion)) {
+            logger.warn([
+                `Declared version of ${dep.name} (${installedVersion}) is not compatible with the version required by Strapi (${dep.wantedVersion}).`,
+                'You may experience issues, we recommend you change this.'
+            ].join(os.EOL));
         }
     }
-    if (currentHash) {
-        await writeCachedHash(cwd, currentHash);
-    }
-    return {
-        didInstall: false
-    };
-};
-const getModule = async (name, cwd)=>{
-    const modulePackagePath = resolveFrom.silent(cwd, path.join(name, 'package.json'));
-    if (!modulePackagePath) {
-        return null;
+    if (errors.length > 0 && process.env.NODE_ENV === 'development') {
+        throw new Error(`${os.EOL}- ${errors.join(`${os.EOL}- `)}`);
     }
-    const file = await fs.readFile(modulePackagePath, 'utf8').then((res)=>JSON.parse(res));
-    return file;
-};
-const getModuleVersion = async (name, cwd)=>{
-    const pkg = await getModule(name, cwd);
-    return pkg?.version || null;
 };
-const installDependencies = async (install, { cwd, logger })=>{
+const installAdminPeerDeps = async (missing, { cwd, logger })=>{
     const packageManager = getPackageManager();
     if (!packageManager) {
         logger.error('Could not find a supported package manager, please install the dependencies manually.');
@@ -183,7 +148,7 @@ const installDependencies = async (install, { cwd, logger })=>{
         cwd,
         stdio: 'inherit'
     };
-    const packages = install.map(({ name, wantedVersion })=>`${name}@${wantedVersion}`);
+    const packages = missing.map(({ name, wantedVersion })=>`${name}@${wantedVersion}`);
     let result;
     if (packageManager === 'npm') {
         const npmArgs = [
@@ -214,6 +179,28 @@ const installDependencies = async (install, { cwd, logger })=>{
         throw new Error('Package installation failed');
     }
 };
+const reexecCurrentCommand = async (cwd)=>{
+    const [file, ...args] = process.argv;
+    /**
+   * Re-run the same command after installation e.g. strapi build because the yarn.lock might
+   * not be the same and could break installations. It's not the best solution, but it works.
+   */ await execa(file, args, {
+        cwd,
+        stdio: 'inherit'
+    });
+};
+const getModule = async (name, cwd)=>{
+    const modulePackagePath = resolveFrom.silent(cwd, path.join(name, 'package.json'));
+    if (!modulePackagePath) {
+        return null;
+    }
+    const file = await fs.readFile(modulePackagePath, 'utf8').then((res)=>JSON.parse(res));
+    return file;
+};
+const getModuleVersion = async (name, cwd)=>{
+    const pkg = await getModule(name, cwd);
+    return pkg?.version || null;
+};
 
-export { checkRequiredDependencies, getModule };
+export { ADMIN_PEER_DEPS, MissingAdminPeerDepsError, findUndeclaredAdminPeerDeps, getInstallCommandHint, getModule, hashPackageJson, installAdminPeerDeps, readCachedHash, reexecCurrentCommand, reportMissingAdminPeerDeps, validateDeclaredAdminPeerDeps, writeCachedHash };
 //# sourceMappingURL=dependencies.mjs.map