@strapi/upgrade 0.0.0-experimental.a407f3bc8fb79a53cf7975140864526b6ddbac4b → 0.0.0-experimental.d23c1d5b0e45dd06ef09977f526c85468be05403

package/dist/index.mjs

@@ -3,7 +3,7 @@ import simpleGit from "simple-git";
 import chalk from "chalk";
 import semver from "semver";
 import { packageManager } from "@strapi/utils";
-import { cloneDeep, get, has, merge, set, omit, isEqual } from "lodash/fp";
+import { cloneDeep, get, has, merge, set, omit, isEqual, groupBy, size } from "lodash/fp";
 import fse from "fs-extra";
 import assert from "node:assert";
 import { glob } from "glob";
@@ -253,13 +253,19 @@ const rangeFromVersions = (currentVersion, target) => {
   }
   throw new Error(`Invalid target set: ${target}`);
 };
+const isValidStringifiedRange = (str) => semver.validRange(str) !== null;
+const isRangeInstance = (range) => {
+  return range instanceof semver.Range;
+};
 const index$e = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   Version: types,
   isLiteralSemVer,
+  isRangeInstance,
   isSemVerReleaseType,
   isSemverInstance,
   isValidSemVer,
+  isValidStringifiedRange,
   rangeFactory,
   rangeFromReleaseType,
   rangeFromVersions,
@@ -366,7 +372,20 @@ const index$b = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePrope
 }, Symbol.toStringTag, { value: "Module" }));
 const PROJECT_PACKAGE_JSON = "package.json";
 const PROJECT_DEFAULT_ALLOWED_ROOT_PATHS = ["src", "config", "public"];
-const PROJECT_DEFAULT_ALLOWED_EXTENSIONS = ["js", "ts", "json"];
+const PROJECT_DEFAULT_CODE_EXTENSIONS = [
+  // Source files
+  "js",
+  "mjs",
+  "ts",
+  // React files
+  "jsx",
+  "tsx"
+];
+const PROJECT_DEFAULT_JSON_EXTENSIONS = ["json"];
+const PROJECT_DEFAULT_ALLOWED_EXTENSIONS = [
+  ...PROJECT_DEFAULT_CODE_EXTENSIONS,
+  ...PROJECT_DEFAULT_JSON_EXTENSIONS
+];
 const PROJECT_DEFAULT_PATTERNS = ["package.json"];
 const SCOPED_STRAPI_PACKAGE_PREFIX = "@strapi/";
 const STRAPI_DEPENDENCY_NAME = `${SCOPED_STRAPI_PACKAGE_PREFIX}strapi`;
@@ -374,6 +393,8 @@ const constants$3 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineP
   __proto__: null,
   PROJECT_DEFAULT_ALLOWED_EXTENSIONS,
   PROJECT_DEFAULT_ALLOWED_ROOT_PATHS,
+  PROJECT_DEFAULT_CODE_EXTENSIONS,
+  PROJECT_DEFAULT_JSON_EXTENSIONS,
   PROJECT_DEFAULT_PATTERNS,
   PROJECT_PACKAGE_JSON,
   SCOPED_STRAPI_PACKAGE_PREFIX,
@@ -385,7 +406,6 @@ class Project {
   files;
   packageJSONPath;
   packageJSON;
-  strapiVersion;
   constructor(cwd) {
     if (!fse.pathExistsSync(cwd)) {
       throw new Error(`ENOENT: no such file or directory, access '${cwd}'`);
@@ -401,14 +421,13 @@ class Project {
   }
   refresh() {
     this.refreshPackageJSON();
-    this.refreshStrapiVersion();
     this.refreshProjectFiles();
     return this;
   }
-  async runCodemods(codemods2, options) {
+  async runCodemods(codemods, options) {
     const runners = this.createProjectCodemodsRunners(options.dry);
     const reports2 = [];
-    for (const codemod of codemods2) {
+    for (const codemod of codemods) {
       for (const runner of runners) {
         if (runner.valid(codemod)) {
           const report = await runner.run(codemod);
@@ -419,16 +438,24 @@ class Project {
     return reports2;
   }
   createProjectCodemodsRunners(dry = false) {
-    const jsonFiles = this.getFilesByExtensions([".json"]);
-    const codeFiles = this.getFilesByExtensions([".js", ".ts", ".mjs"]);
+    const jsonExtensions = PROJECT_DEFAULT_JSON_EXTENSIONS.map(
+      (ext) => `.${ext}`
+    );
+    const codeExtensions = PROJECT_DEFAULT_CODE_EXTENSIONS.map(
+      (ext) => `.${ext}`
+    );
+    const jsonFiles = this.getFilesByExtensions(jsonExtensions);
+    const codeFiles = this.getFilesByExtensions(codeExtensions);
     const codeRunner = codeRunnerFactory(codeFiles, {
       dry,
+      parser: "ts",
+      runInBand: true,
+      babel: true,
+      extensions: PROJECT_DEFAULT_CODE_EXTENSIONS.join(","),
+      // Don't output any log coming from the runner
       print: false,
       silent: true,
-      extensions: "js,ts",
-      runInBand: true,
-      verbose: 0,
-      babel: true
+      verbose: 0
     });
     const jsonRunner = jsonRunnerFactory(jsonFiles, { dry, cwd: this.cwd });
     return [codeRunner, jsonRunner];
@@ -456,6 +483,19 @@ class Project {
     const scanner = fileScannerFactory(this.cwd);
     this.files = scanner.scan(patterns);
   }
+}
+class AppProject extends Project {
+  strapiVersion;
+  type = "application";
+  constructor(cwd) {
+    super(cwd);
+    this.refreshStrapiVersion();
+  }
+  refresh() {
+    super.refresh();
+    this.refreshStrapiVersion();
+    return this;
+  }
   refreshStrapiVersion() {
     this.strapiVersion = // First try to get the strapi version from the package.json dependencies
     this.findStrapiVersionFromProjectPackageJSON() ?? // If the version found is not a valid SemVer, get the Strapi version from the installed package
@@ -501,10 +541,50 @@ const formatGlobCollectionPattern = (collection) => {
   );
   return collection.length === 1 ? collection[0] : `{${collection}}`;
 };
-const projectFactory = (cwd) => new Project(cwd);
+class PluginProject extends Project {
+  type = "plugin";
+}
+const isPlugin = (cwd) => {
+  const packageJSONPath = path$1.join(cwd, PROJECT_PACKAGE_JSON);
+  try {
+    fse.accessSync(packageJSONPath);
+  } catch {
+    throw new Error(`Could not find a ${PROJECT_PACKAGE_JSON} file in ${cwd}`);
+  }
+  const packageJSONBuffer = fse.readFileSync(packageJSONPath);
+  const packageJSON = JSON.parse(packageJSONBuffer.toString());
+  return packageJSON?.strapi?.kind === "plugin";
+};
+const projectFactory = (cwd) => {
+  fse.accessSync(cwd);
+  if (isPlugin(cwd)) {
+    return new PluginProject(cwd);
+  }
+  return new AppProject(cwd);
+};
+const isPluginProject = (project) => {
+  return project instanceof PluginProject;
+};
+function assertPluginProject(project) {
+  if (!isPluginProject(project)) {
+    throw new Error("Project is not a plugin");
+  }
+}
+const isApplicationProject = (project) => {
+  return project instanceof AppProject;
+};
+function assertAppProject(project) {
+  if (!isApplicationProject(project)) {
+    throw new Error("Project is not an application");
+  }
+}
 const index$a = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
+  assertAppProject,
+  assertPluginProject,
   constants: constants$3,
+  isApplicationProject,
+  isPluginProject,
   projectFactory
 }, Symbol.toStringTag, { value: "Module" }));
 class UnexpectedError extends Error {
@@ -530,7 +610,11 @@ const path = (path2) => chalk.blue(path2);
 const version = (version2) => {
   return chalk.italic.yellow(`v${version2}`);
 };
-const versionRange = (range) => chalk.italic.yellow(range);
+const codemodUID = (uid) => {
+  return chalk.bold.cyan(uid);
+};
+const projectType = (type) => chalk.cyan(type);
+const versionRange = (range) => chalk.italic.yellow(range.raw);
 const transform = (transformFilePath) => chalk.cyan(transformFilePath);
 const highlight = (arg) => chalk.bold.underline(arg);
 const upgradeStep = (text, step) => {
@@ -562,15 +646,40 @@ const reports = (reports2) => {
   table.push(...rows);
   return table.toString();
 };
+const codemodList = (codemods) => {
+  const rows = codemods.map((codemod, index2) => {
+    const fIndex = chalk.grey(index2);
+    const fVersion = chalk.magenta(codemod.version);
+    const fKind = chalk.yellow(codemod.kind);
+    const fName = chalk.blue(codemod.format());
+    const fUID = codemodUID(codemod.uid);
+    return [fIndex, fVersion, fKind, fName, fUID];
+  });
+  const table = new CliTable3({
+    style: { compact: true },
+    head: [
+      chalk.bold.grey("N°"),
+      chalk.bold.magenta("Version"),
+      chalk.bold.yellow("Kind"),
+      chalk.bold.blue("Name"),
+      chalk.bold.cyan("UID")
+    ]
+  });
+  table.push(...rows);
+  return table.toString();
+};
 const durationMs = (elapsedMs) => {
   const elapsedSeconds = (elapsedMs / ONE_SECOND_MS).toFixed(3);
   return `${elapsedSeconds}s`;
 };
 const index$8 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
+  codemodList,
+  codemodUID,
   durationMs,
   highlight,
   path,
+  projectType,
   reports,
   transform,
   upgradeStep,
@@ -593,6 +702,7 @@ const constants$2 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineP
   CODEMOD_JSON_SUFFIX
 }, Symbol.toStringTag, { value: "Module" }));
 class Codemod {
+  uid;
   kind;
   version;
   baseDirectory;
@@ -604,9 +714,27 @@ class Codemod {
     this.baseDirectory = options.baseDirectory;
     this.filename = options.filename;
     this.path = path$1.join(this.baseDirectory, this.version.raw, this.filename);
-  }
-  format() {
-    return this.filename.replace(`.${CODEMOD_CODE_SUFFIX}.${CODEMOD_EXTENSION}`, "").replace(`.${CODEMOD_JSON_SUFFIX}.${CODEMOD_EXTENSION}`, "").replaceAll("-", " ");
+    this.uid = this.createUID();
+  }
+  createUID() {
+    const name = this.format({ stripExtension: true, stripKind: true, stripHyphens: false });
+    const kind = this.kind;
+    const version2 = this.version.raw;
+    return `${version2}-${name}-${kind}`;
+  }
+  format(options) {
+    const { stripExtension = true, stripKind = true, stripHyphens = true } = options ?? {};
+    let formatted = this.filename;
+    if (stripExtension) {
+      formatted = formatted.replace(new RegExp(`\\.${CODEMOD_EXTENSION}$`, "i"), "");
+    }
+    if (stripKind) {
+      formatted = formatted.replace(`.${CODEMOD_CODE_SUFFIX}`, "").replace(`.${CODEMOD_JSON_SUFFIX}`, "");
+    }
+    if (stripHyphens) {
+      formatted = formatted.replaceAll("-", " ");
+    }
+    return formatted;
   }
 }
 const codemodFactory = (options) => new Codemod(options);
@@ -615,6 +743,20 @@ const index$7 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.definePrope
   codemodFactory,
   constants: constants$2
 }, Symbol.toStringTag, { value: "Module" }));
+const INTERNAL_CODEMODS_DIRECTORY = path$1.join(
+  __dirname,
+  // upgrade/dist
+  "..",
+  // upgrade
+  "resources",
+  // upgrade/resources
+  "codemods"
+  // upgrade/resources/codemods
+);
+const constants$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  INTERNAL_CODEMODS_DIRECTORY
+}, Symbol.toStringTag, { value: "Module" }));
 class CodemodRepository {
   groups;
   versions;
@@ -633,23 +775,48 @@ class CodemodRepository {
   count(version2) {
     return this.findByVersion(version2).length;
   }
-  countRange(range) {
-    return this.findByRange(range).length;
-  }
-  exists(version2) {
+  versionExists(version2) {
     return version2.raw in this.groups;
   }
-  findByRange(range) {
+  has(uid) {
+    const result = this.find({ uids: [uid] });
+    if (result.length !== 1) {
+      return false;
+    }
+    const { codemods } = result[0];
+    return codemods.length === 1 && codemods[0].uid === uid;
+  }
+  find(q) {
     const entries = Object.entries(this.groups);
-    return entries.filter(([version2]) => range.test(version2)).map(([version2, codemods2]) => ({
+    return entries.filter(maybeFilterByRange).map(([version2, codemods]) => ({
       version: semVerFactory(version2),
-      codemods: codemods2
-    }));
+      // Filter by UID if provided in the query
+      codemods: codemods.filter(maybeFilterByUIDs)
+    })).filter(({ codemods }) => codemods.length > 0);
+    function maybeFilterByRange([version2]) {
+      if (!isRangeInstance(q.range)) {
+        return true;
+      }
+      return q.range.test(version2);
+    }
+    function maybeFilterByUIDs(codemod) {
+      if (q.uids === void 0) {
+        return true;
+      }
+      return q.uids.includes(codemod.uid);
+    }
   }
   findByVersion(version2) {
     const literalVersion = version2.raw;
-    const codemods2 = this.groups[literalVersion];
-    return codemods2 ?? [];
+    const codemods = this.groups[literalVersion];
+    return codemods ?? [];
+  }
+  findAll() {
+    const entries = Object.entries(this.groups);
+    return entries.map(([version2, codemods]) => ({
+      version: semVerFactory(version2),
+      codemods
+    }));
   }
   refreshAvailableVersions() {
     this.versions = fse.readdirSync(this.cwd).filter((filename) => fse.statSync(path$1.join(this.cwd, filename)).isDirectory()).filter((filename) => semver.valid(filename) !== null).map((version2) => semVerFactory(version2)).sort(semver.compare);
@@ -680,18 +847,9 @@ const parseCodemodKindFromFilename = (filename) => {
   assert(CODEMOD_ALLOWED_SUFFIXES.includes(kind));
   return kind;
 };
-const codemodRepositoryFactory = (cwd) => new CodemodRepository(cwd);
-const INTERNAL_CODEMODS_DIRECTORY = path$1.join(
-  __dirname,
-  "..",
-  "..",
-  "resources",
-  "codemods"
-);
-const constants$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
-  __proto__: null,
-  INTERNAL_CODEMODS_DIRECTORY
-}, Symbol.toStringTag, { value: "Module" }));
+const codemodRepositoryFactory = (cwd = INTERNAL_CODEMODS_DIRECTORY) => {
+  return new CodemodRepository(cwd);
+};
 const index$6 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   codemodRepositoryFactory,
@@ -726,34 +884,59 @@ class CodemodRunner {
     this.isDry = enabled;
     return this;
   }
-  async run(codemodsDirectory) {
+  createRepository(codemodsDirectory) {
     const repository = codemodRepositoryFactory(
       codemodsDirectory ?? INTERNAL_CODEMODS_DIRECTORY
     );
     repository.refresh();
-    const allVersionedCodemods = repository.findByRange(this.range);
-    const versionedCodemods = this.selectCodemodsCallback ? await this.selectCodemodsCallback(allVersionedCodemods) : allVersionedCodemods;
-    const hasCodemodsToRun = versionedCodemods.length > 0;
-    if (!hasCodemodsToRun) {
-      this.logger?.debug(`Found no codemods to run for ${versionRange(this.range)}`);
-      return successReport$1();
+    return repository;
+  }
+  async safeRunAndReport(codemods) {
+    if (this.isDry) {
+      this.logger?.warn?.(
+        "Running the codemods in dry mode. No files will be modified during the process."
+      );
     }
-    this.logger?.debug(
-      `Found codemods for ${highlight(
-        versionedCodemods.length
-      )} version(s) using ${versionRange(this.range)}`
-    );
-    versionedCodemods.forEach(
-      ({ version: version$1, codemods: codemods22 }) => this.logger?.debug(`- ${version(version$1)} (${codemods22.length})`)
-    );
-    const codemods2 = versionedCodemods.map(({ codemods: codemods22 }) => codemods22).flat();
     try {
-      const reports$1 = await this.project.runCodemods(codemods2, { dry: this.isDry });
-      this.logger?.raw(reports(reports$1));
+      const reports$1 = await this.project.runCodemods(codemods, { dry: this.isDry });
+      this.logger?.raw?.(reports(reports$1));
+      if (!this.isDry) {
+        const nbAffectedTotal = reports$1.flatMap((report) => report.report.ok).reduce((acc, nb) => acc + nb, 0);
+        this.logger?.debug?.(
+          `Successfully ran ${highlight(codemods.length)} codemod(s), ${highlight(nbAffectedTotal)} change(s) have been detected`
+        );
+      }
+      return successReport$1();
     } catch (e) {
       return erroredReport$1(unknownToError(e));
     }
-    return successReport$1();
+  }
+  async runByUID(uid, codemodsDirectory) {
+    const repository = this.createRepository(codemodsDirectory);
+    if (!repository.has(uid)) {
+      throw new Error(`Unknown codemod UID provided: ${uid}`);
+    }
+    const codemods = repository.find({ uids: [uid] }).flatMap(({ codemods: codemods2 }) => codemods2);
+    return this.safeRunAndReport(codemods);
+  }
+  async run(codemodsDirectory) {
+    const repository = this.createRepository(codemodsDirectory);
+    const codemodsInRange = repository.find({ range: this.range });
+    const selectedCodemods = this.selectCodemodsCallback ? await this.selectCodemodsCallback(codemodsInRange) : codemodsInRange;
+    if (selectedCodemods.length === 0) {
+      this.logger?.debug?.(`Found no codemods to run for ${versionRange(this.range)}`);
+      return successReport$1();
+    }
+    const codemods = selectedCodemods.flatMap(({ codemods: codemods2 }) => codemods2);
+    const codemodsByVersion = groupBy("version", codemods);
+    const fRange = versionRange(this.range);
+    this.logger?.debug?.(
+      `Found ${highlight(codemods.length)} codemods for ${highlight(size(codemodsByVersion))} version(s) using ${fRange}`
+    );
+    for (const [version$1, codemods2] of Object.entries(codemodsByVersion)) {
+      this.logger?.debug?.(`- ${version(semVerFactory(version$1))} (${codemods2.length})`);
+    }
+    return this.safeRunAndReport(codemods);
   }
 }
 const codemodRunnerFactory = (project, range) => {
@@ -792,7 +975,7 @@ class Upgrader {
     this.codemodsTarget = semVerFactory(
       `${this.target.major}.${this.target.minor}.${this.target.patch}`
     );
-    this.logger?.debug(
+    this.logger?.debug?.(
       `The codemods target has been synced with the upgrade target. The codemod runner will now look for ${version(
         this.codemodsTarget
       )}`
@@ -801,7 +984,7 @@ class Upgrader {
   }
   overrideCodemodsTarget(target) {
     this.codemodsTarget = target;
-    this.logger?.debug(
+    this.logger?.debug?.(
       `Overriding the codemods target. The codemod runner will now look for ${version(target)}`
     );
     return this;
@@ -821,38 +1004,40 @@ class Upgrader {
   addRequirement(requirement) {
     this.requirements.push(requirement);
     const fRequired = requirement.isRequired ? "(required)" : "(optional)";
-    this.logger?.debug(
+    this.logger?.debug?.(
       `Added a new requirement to the upgrade: ${highlight(requirement.name)} ${fRequired}`
     );
     return this;
   }
   async upgrade() {
-    this.logger?.info(
+    this.logger?.info?.(
       `Upgrading from ${version(this.project.strapiVersion)} to ${version(this.target)}`
     );
     if (this.isDry) {
-      this.logger?.warn(
+      this.logger?.warn?.(
         "Running the upgrade in dry mode. No files will be modified during the process."
       );
     }
     const range = rangeFromVersions(this.project.strapiVersion, this.target);
     const codemodsRange = rangeFromVersions(this.project.strapiVersion, this.codemodsTarget);
     const npmVersionsMatches = this.npmPackage?.findVersionsInRange(range) ?? [];
-    this.logger?.debug(
+    this.logger?.debug?.(
       `Found ${highlight(npmVersionsMatches.length)} versions satisfying ${versionRange(range)}`
     );
     try {
-      this.logger?.info(upgradeStep("Checking requirement", [1, 4]));
+      this.logger?.info?.(upgradeStep("Checking requirement", [1, 4]));
       await this.checkRequirements(this.requirements, {
         npmVersionsMatches,
         project: this.project,
         target: this.target
       });
-      this.logger?.info(upgradeStep("Applying the latest code modifications", [2, 4]));
+      this.logger?.info?.(upgradeStep("Applying the latest code modifications", [2, 4]));
       await this.runCodemods(codemodsRange);
-      this.logger?.info(upgradeStep("Upgrading Strapi dependencies", [3, 4]));
+      this.logger?.debug?.("Refreshing project information...");
+      this.project.refresh();
+      this.logger?.info?.(upgradeStep("Upgrading Strapi dependencies", [3, 4]));
       await this.updateDependencies();
-      this.logger?.info(upgradeStep("Installing dependencies", [4, 4]));
+      this.logger?.info?.(upgradeStep("Installing dependencies", [4, 4]));
       await this.installDependencies();
     } catch (e) {
       return erroredReport(unknownToError(e));
@@ -885,7 +1070,7 @@ class Upgrader {
     if (requirement.isRequired) {
       throw error;
     }
-    this.logger?.warn(warningMessage);
+    this.logger?.warn?.(warningMessage);
     const response = await this.confirmationCallback?.(confirmationMessage);
     if (!response) {
       throw error;
@@ -896,9 +1081,11 @@ class Upgrader {
     const json = createJSONTransformAPI(packageJSON);
     const dependencies = json.get("dependencies", {});
     const strapiDependencies = this.getScopedStrapiDependencies(dependencies);
-    this.logger?.debug(`Found ${highlight(strapiDependencies.length)} dependency(ies) to update`);
+    this.logger?.debug?.(
+      `Found ${highlight(strapiDependencies.length)} dependency(ies) to update`
+    );
     strapiDependencies.forEach(
-      (dependency) => this.logger?.debug(`- ${dependency[0]} (${dependency[1]} -> ${this.target})`)
+      (dependency) => this.logger?.debug?.(`- ${dependency[0]} (${dependency[1]} -> ${this.target})`)
     );
     if (strapiDependencies.length === 0) {
       return;
@@ -906,7 +1093,7 @@ class Upgrader {
     strapiDependencies.forEach(([name]) => json.set(`dependencies.${name}`, this.target.raw));
     const updatedPackageJSON = json.root();
     if (this.isDry) {
-      this.logger?.debug(`Skipping dependencies update (${chalk.italic("dry mode")})`);
+      this.logger?.debug?.(`Skipping dependencies update (${chalk.italic("dry mode")})`);
       return;
     }
     await saveJSON(packageJSONPath, updatedPackageJSON);
@@ -926,9 +1113,9 @@ class Upgrader {
   async installDependencies() {
     const projectPath = this.project.cwd;
     const packageManagerName = await packageManager.getPreferred(projectPath);
-    this.logger?.debug(`Using ${highlight(packageManagerName)} as package manager`);
+    this.logger?.debug?.(`Using ${highlight(packageManagerName)} as package manager`);
     if (this.isDry) {
-      this.logger?.debug(`Skipping dependencies installation (${chalk.italic("dry mode")}`);
+      this.logger?.debug?.(`Skipping dependencies installation (${chalk.italic("dry mode")}`);
       return;
     }
     await packageManager.installDependencies(projectPath, packageManagerName, {
@@ -1027,6 +1214,11 @@ const upgrade = async (options) => {
   const { logger, codemodsTarget } = options;
   const cwd = path$1.resolve(options.cwd ?? process.cwd());
   const project = projectFactory(cwd);
+  if (!isApplicationProject(project)) {
+    throw new Error(
+      `The "${options.target}" upgrade can only be run on a Strapi project; for plugins, please use "codemods".`
+    );
+  }
   const npmPackage = npmPackageFactory(STRAPI_PACKAGE_NAME);
   await npmPackage.refresh();
   const upgrader = upgraderFactory(project, options.target, npmPackage).dry(options.dry ?? false).onConfirm(options.confirm ?? null).setLogger(logger);
@@ -1044,20 +1236,7 @@ const upgrade = async (options) => {
   timer.stop();
   logger.info(`Completed in ${durationMs(timer.elapsedMs)}`);
 };
-const codemods = async (options) => {
-  const timer = timerFactory();
-  const { logger } = options;
-  const cwd = path$1.resolve(options.cwd ?? process.cwd());
-  const project = projectFactory(cwd);
-  const range = getRangeFromTarget(project.strapiVersion, options.target);
-  const codemodRunner = codemodRunnerFactory(project, range).dry(options.dry ?? false).onSelectCodemods(options.selectCodemods ?? null).setLogger(logger);
-  const executionReport = await codemodRunner.run();
-  if (!executionReport.success) {
-    throw executionReport.error;
-  }
-  timer.stop();
-  logger.info(`Completed in ${timer.elapsedMs}`);
-};
+const resolvePath = (cwd) => path$1.resolve(cwd ?? process.cwd());
 const getRangeFromTarget = (currentVersion, target) => {
   if (isSemverInstance(target)) {
     return rangeFactory(target);
@@ -1074,9 +1253,60 @@ const getRangeFromTarget = (currentVersion, target) => {
       throw new Error(`Invalid target set: ${target}`);
   }
 };
+const findRangeFromTarget = (project, target) => {
+  if (isRangeInstance(target)) {
+    return target;
+  }
+  if (isApplicationProject(project)) {
+    return getRangeFromTarget(project.strapiVersion, target);
+  }
+  return rangeFactory("*");
+};
+const runCodemods = async (options) => {
+  const timer = timerFactory();
+  const { logger, uid } = options;
+  const cwd = resolvePath(options.cwd);
+  const project = projectFactory(cwd);
+  const range = findRangeFromTarget(project, options.target);
+  logger.debug(`Project: ${projectType(project.type)} found in ${path(cwd)}`);
+  logger.debug(`Range: set to ${versionRange(range)}`);
+  const codemodRunner = codemodRunnerFactory(project, range).dry(options.dry ?? false).onSelectCodemods(options.selectCodemods ?? null).setLogger(logger);
+  let report;
+  if (uid !== void 0) {
+    logger.debug(`Running a single codemod: ${codemodUID(uid)}`);
+    report = await codemodRunner.runByUID(uid);
+  } else {
+    report = await codemodRunner.run();
+  }
+  if (!report.success) {
+    throw report.error;
+  }
+  timer.stop();
+  logger.info(`Completed in ${timer.elapsedMs}`);
+};
+const listCodemods = async (options) => {
+  const { logger, target } = options;
+  const cwd = resolvePath(options.cwd);
+  const project = projectFactory(cwd);
+  const range = findRangeFromTarget(project, target);
+  logger.debug(`Project: ${projectType(project.type)} found in ${path(cwd)}`);
+  logger.debug(`Range: set to ${versionRange(range)}`);
+  const repo = codemodRepositoryFactory();
+  repo.refresh();
+  const groups = repo.find({ range });
+  const codemods = groups.flatMap((collection) => collection.codemods);
+  logger.debug(`Found ${highlight(codemods.length)} codemods`);
+  if (codemods.length === 0) {
+    logger.info(`Found no codemods matching ${versionRange(range)}`);
+    return;
+  }
+  const fCodemods = codemodList(codemods);
+  logger.raw(fCodemods);
+};
 const index$4 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  codemods,
+  listCodemods,
+  runCodemods,
   upgrade
 }, Symbol.toStringTag, { value: "Module" }));
 class Logger {