@strapi/upgrade 5.0.5 → 5.1.0

package/dist/cli.js

@@ -5,26 +5,26 @@ const commander = require("commander");
 const prompts = require("prompts");
 const semver = require("semver");
 const path$1 = require("node:path");
-const simpleGit = require("simple-git");
-const utils = require("@strapi/utils");
-const fp = require("lodash/fp");
-const fse = require("fs-extra");
+const CliTable3 = require("cli-table3");
 const assert = require("node:assert");
+const fse = require("fs-extra");
 const fastglob = require("fast-glob");
 const Runner = require("jscodeshift/src/Runner");
+const fp = require("lodash/fp");
 const node = require("esbuild-register/dist/node");
-const CliTable3 = require("cli-table3");
+const utils = require("@strapi/utils");
+const simpleGit = require("simple-git");
 const _interopDefault = (e) => e && e.__esModule ? e : { default: e };
 const os__default = /* @__PURE__ */ _interopDefault(os);
 const chalk__default = /* @__PURE__ */ _interopDefault(chalk);
 const prompts__default = /* @__PURE__ */ _interopDefault(prompts);
 const semver__default = /* @__PURE__ */ _interopDefault(semver);
 const path__default = /* @__PURE__ */ _interopDefault(path$1);
-const simpleGit__default = /* @__PURE__ */ _interopDefault(simpleGit);
-const fse__default = /* @__PURE__ */ _interopDefault(fse);
+const CliTable3__default = /* @__PURE__ */ _interopDefault(CliTable3);
 const assert__default = /* @__PURE__ */ _interopDefault(assert);
+const fse__default = /* @__PURE__ */ _interopDefault(fse);
 const fastglob__default = /* @__PURE__ */ _interopDefault(fastglob);
-const CliTable3__default = /* @__PURE__ */ _interopDefault(CliTable3);
+const simpleGit__default = /* @__PURE__ */ _interopDefault(simpleGit);
 class Logger {
   isDebug;
   isSilent;
@@ -99,6 +99,7 @@ var ReleaseType = /* @__PURE__ */ ((ReleaseType2) => {
   ReleaseType2["Major"] = "major";
   ReleaseType2["Minor"] = "minor";
   ReleaseType2["Patch"] = "patch";
+  ReleaseType2["Latest"] = "latest";
   return ReleaseType2;
 })(ReleaseType || {});
 const semVerFactory = (version2) => {
@@ -120,17 +121,20 @@ const rangeFactory = (range) => {
 };
 const rangeFromReleaseType = (current, identifier) => {
   switch (identifier) {
-    case ReleaseType.Major: {
-      const nextMajor = semver__default.default.inc(current, "major");
-      return rangeFactory(`>${current.raw} <=${nextMajor}`);
+    case ReleaseType.Latest: {
+      return rangeFactory(`>${current.raw}`);
     }
-    case ReleaseType.Patch: {
-      const minor = semver__default.default.inc(current, "minor");
-      return rangeFactory(`>${current.raw} <${minor}`);
+    case ReleaseType.Major: {
+      const nextMajor = semVerFactory(current.raw).inc("major");
+      return rangeFactory(`>${current.raw} <=${nextMajor.major}`);
     }
     case ReleaseType.Minor: {
-      const major = semver__default.default.inc(current, "major");
-      return rangeFactory(`>${current.raw} <${major}`);
+      const nextMajor = semVerFactory(current.raw).inc("major");
+      return rangeFactory(`>${current.raw} <${nextMajor.raw}`);
+    }
+    case ReleaseType.Patch: {
+      const nextMinor = semVerFactory(current.raw).inc("minor");
+      return rangeFactory(`>${current.raw} <${nextMinor.raw}`);
     }
     default: {
       throw new Error("Not implemented");
@@ -150,7 +154,36 @@ const isValidStringifiedRange = (str) => semver__default.default.validRange(str)
 const isRangeInstance = (range) => {
   return range instanceof semver__default.default.Range;
 };
+class UnexpectedError extends Error {
+  constructor() {
+    super("Unexpected Error");
+  }
+}
+class NPMCandidateNotFoundError extends Error {
+  target;
+  constructor(target, message = `Couldn't find a valid NPM candidate for "${target}"`) {
+    super(message);
+    this.target = target;
+  }
+}
+class AbortedError extends Error {
+  constructor(message = "Upgrade aborted") {
+    super(message);
+  }
+}
+const unknownToError = (e) => {
+  if (e instanceof Error) {
+    return e;
+  }
+  if (typeof e === "string") {
+    return new Error(e);
+  }
+  return new UnexpectedError();
+};
 const handleError = (err, isSilent) => {
+  if (err instanceof AbortedError) {
+    process.exit(0);
+  }
   if (!isSilent) {
     console.error(
       chalk__default.default.red(`[ERROR]	[${(/* @__PURE__ */ new Date()).toISOString()}]`),
@@ -159,115 +192,6 @@ const handleError = (err, isSilent) => {
   }
   process.exit(1);
 };
-class Requirement {
-  isRequired;
-  name;
-  testCallback;
-  children;
-  constructor(name, testCallback, isRequired) {
-    this.name = name;
-    this.testCallback = testCallback;
-    this.isRequired = isRequired ?? true;
-    this.children = [];
-  }
-  setChildren(children) {
-    this.children = children;
-    return this;
-  }
-  addChild(child) {
-    this.children.push(child);
-    return this;
-  }
-  asOptional() {
-    const newInstance = requirementFactory(this.name, this.testCallback, false);
-    newInstance.setChildren(this.children);
-    return newInstance;
-  }
-  asRequired() {
-    const newInstance = requirementFactory(this.name, this.testCallback, true);
-    newInstance.setChildren(this.children);
-    return newInstance;
-  }
-  async test(context) {
-    try {
-      await this.testCallback?.(context);
-      return ok();
-    } catch (e) {
-      if (e instanceof Error) {
-        return errored(e);
-      }
-      if (typeof e === "string") {
-        return errored(new Error(e));
-      }
-      return errored(new Error("Unknown error"));
-    }
-  }
-}
-const ok = () => ({ pass: true, error: null });
-const errored = (error) => ({ pass: false, error });
-const requirementFactory = (name, testCallback, isRequired) => new Requirement(name, testCallback, isRequired);
-const REQUIRE_AVAILABLE_NEXT_MAJOR = requirementFactory(
-  "REQUIRE_AVAILABLE_NEXT_MAJOR",
-  (context) => {
-    const { project, target } = context;
-    const currentMajor = project.strapiVersion.major;
-    const targetedMajor = target.major;
-    if (targetedMajor === currentMajor) {
-      throw new Error(`You're already on the latest major version (v${currentMajor})`);
-    }
-  }
-);
-const REQUIRE_LATEST_FOR_CURRENT_MAJOR = requirementFactory(
-  "REQUIRE_LATEST_FOR_CURRENT_MAJOR",
-  (context) => {
-    const { project, target, npmVersionsMatches } = context;
-    if (npmVersionsMatches.length !== 1) {
-      const invalidVersions = npmVersionsMatches.slice(0, -1);
-      const invalidVersionsAsSemVer = invalidVersions.map((v) => v.version);
-      const nbInvalidVersions = npmVersionsMatches.length;
-      const currentMajor = project.strapiVersion.major;
-      throw new Error(
-        `Doing a major upgrade requires to be on the latest v${currentMajor} version, but found ${nbInvalidVersions} versions between the current one and ${target}: ${invalidVersionsAsSemVer}`
-      );
-    }
-  }
-);
-const REQUIRE_GIT_CLEAN_REPOSITORY = requirementFactory(
-  "REQUIRE_GIT_CLEAN_REPOSITORY",
-  async (context) => {
-    const git = simpleGit__default.default({ baseDir: context.project.cwd });
-    const status = await git.status();
-    if (!status.isClean()) {
-      throw new Error(
-        "Repository is not clean. Please commit or stash any changes before upgrading"
-      );
-    }
-  }
-);
-const REQUIRE_GIT_REPOSITORY = requirementFactory(
-  "REQUIRE_GIT_REPOSITORY",
-  async (context) => {
-    const git = simpleGit__default.default({ baseDir: context.project.cwd });
-    const isRepo = await git.checkIsRepo();
-    if (!isRepo) {
-      throw new Error("Not a git repository (or any of the parent directories)");
-    }
-  }
-).addChild(REQUIRE_GIT_CLEAN_REPOSITORY.asOptional());
-const REQUIRE_GIT_INSTALLED = requirementFactory(
-  "REQUIRE_GIT_INSTALLED",
-  async (context) => {
-    const git = simpleGit__default.default({ baseDir: context.project.cwd });
-    try {
-      await git.version();
-    } catch {
-      throw new Error("Git is not installed");
-    }
-  }
-).addChild(REQUIRE_GIT_REPOSITORY.asOptional());
-const REQUIRE_GIT = requirementFactory("REQUIRE_GIT", null).addChild(
-  REQUIRE_GIT_INSTALLED.asOptional()
-);
 class Timer {
   interval;
   constructor() {
@@ -294,46 +218,117 @@ class Timer {
 }
 const timerFactory = () => new Timer();
 const ONE_SECOND_MS = 1e3;
-class JSONTransformAPI {
-  json;
-  constructor(json) {
-    this.json = fp.cloneDeep(json);
+const path = (path2) => chalk__default.default.blue(path2);
+const version$1 = (version2) => {
+  return chalk__default.default.italic.yellow(`v${version2}`);
+};
+const codemodUID = (uid) => {
+  return chalk__default.default.bold.cyan(uid);
+};
+const projectDetails = (project) => {
+  return `Project: TYPE=${projectType(project.type)}; CWD=${path(project.cwd)}; PATHS=${project.paths.map(path)}`;
+};
+const projectType = (type) => chalk__default.default.cyan(type);
+const versionRange = (range) => chalk__default.default.italic.yellow(range.raw);
+const highlight = (arg) => chalk__default.default.bold.underline(arg);
+const upgradeStep = (text, step) => {
+  return chalk__default.default.bold(`(${step[0]}/${step[1]}) ${text}...`);
+};
+const reports = (reports2) => {
+  const rows = reports2.map(({ codemod, report }, i) => {
+    const fIndex = chalk__default.default.grey(i);
+    const fVersion = chalk__default.default.magenta(codemod.version);
+    const fKind = chalk__default.default.yellow(codemod.kind);
+    const fFormattedTransformPath = chalk__default.default.cyan(codemod.format());
+    const fTimeElapsed = i === 0 ? `${report.timeElapsed}s ${chalk__default.default.dim.italic("(cold start)")}` : `${report.timeElapsed}s`;
+    const fAffected = report.ok > 0 ? chalk__default.default.green(report.ok) : chalk__default.default.grey(0);
+    const fUnchanged = report.ok === 0 ? chalk__default.default.red(report.nochange) : chalk__default.default.grey(report.nochange);
+    return [fIndex, fVersion, fKind, fFormattedTransformPath, fAffected, fUnchanged, fTimeElapsed];
+  });
+  const table = new CliTable3__default.default({
+    style: { compact: true },
+    head: [
+      chalk__default.default.bold.grey("N°"),
+      chalk__default.default.bold.magenta("Version"),
+      chalk__default.default.bold.yellow("Kind"),
+      chalk__default.default.bold.cyan("Name"),
+      chalk__default.default.bold.green("Affected"),
+      chalk__default.default.bold.red("Unchanged"),
+      chalk__default.default.bold.blue("Duration")
+    ]
+  });
+  table.push(...rows);
+  return table.toString();
+};
+const codemodList = (codemods) => {
+  const rows = codemods.map((codemod, index) => {
+    const fIndex = chalk__default.default.grey(index);
+    const fVersion = chalk__default.default.magenta(codemod.version);
+    const fKind = chalk__default.default.yellow(codemod.kind);
+    const fName = chalk__default.default.blue(codemod.format());
+    const fUID = codemodUID(codemod.uid);
+    return [fIndex, fVersion, fKind, fName, fUID];
+  });
+  const table = new CliTable3__default.default({
+    style: { compact: true },
+    head: [
+      chalk__default.default.bold.grey("N°"),
+      chalk__default.default.bold.magenta("Version"),
+      chalk__default.default.bold.yellow("Kind"),
+      chalk__default.default.bold.blue("Name"),
+      chalk__default.default.bold.cyan("UID")
+    ]
+  });
+  table.push(...rows);
+  return table.toString();
+};
+const durationMs = (elapsedMs) => {
+  const elapsedSeconds = (elapsedMs / ONE_SECOND_MS).toFixed(3);
+  return `${elapsedSeconds}s`;
+};
+const NPM_REGISTRY_URL = "https://registry.npmjs.org";
+class Package {
+  name;
+  packageURL;
+  npmPackage;
+  constructor(name) {
+    this.name = name;
+    this.packageURL = `${NPM_REGISTRY_URL}/${name}`;
+    this.npmPackage = null;
   }
-  get(path2, defaultValue) {
-    if (!path2) {
-      return this.root();
-    }
-    return fp.cloneDeep(fp.get(path2, this.json) ?? defaultValue);
+  get isLoaded() {
+    return this.npmPackage !== null;
   }
-  has(path2) {
-    return fp.has(path2, this.json);
+  assertPackageIsLoaded(npmPackage) {
+    assert__default.default(this.isLoaded, "The package is not loaded yet");
   }
-  merge(other) {
-    this.json = fp.merge(other, this.json);
-    return this;
+  getVersionsDict() {
+    this.assertPackageIsLoaded(this.npmPackage);
+    return this.npmPackage.versions;
   }
-  root() {
-    return fp.cloneDeep(this.json);
+  getVersionsAsList() {
+    this.assertPackageIsLoaded(this.npmPackage);
+    return Object.values(this.npmPackage.versions);
   }
-  set(path2, value) {
-    this.json = fp.set(path2, value, this.json);
-    return this;
+  findVersionsInRange(range) {
+    const versions = this.getVersionsAsList();
+    return versions.filter((v) => range.test(v.version)).filter((v) => isLiteralSemVer(v.version)).sort((v1, v2) => semver__default.default.compare(v1.version, v2.version));
   }
-  remove(path2) {
-    this.json = fp.omit(path2, this.json);
+  findVersion(version2) {
+    const versions = this.getVersionsAsList();
+    return versions.find((npmVersion) => semver__default.default.eq(npmVersion.version, version2));
+  }
+  async refresh() {
+    const response = await fetch(this.packageURL);
+    assert__default.default(response.ok, `Request failed for ${this.packageURL}`);
+    this.npmPackage = await response.json();
     return this;
   }
+  versionExists(version2) {
+    return this.findVersion(version2) !== void 0;
+  }
 }
-const createJSONTransformAPI = (object) => new JSONTransformAPI(object);
-const readJSON = async (path2) => {
-  const buffer = await fse__default.default.readFile(path2);
-  return JSON.parse(buffer.toString());
-};
-const saveJSON = async (path2, json) => {
-  const jsonAsString = `${JSON.stringify(json, null, 2)}
-`;
-  await fse__default.default.writeFile(path2, jsonAsString);
-};
+const npmPackageFactory = (name) => new Package(name);
 class FileScanner {
   cwd;
   constructor(cwd) {
@@ -362,15 +357,55 @@ class AbstractRunner {
     const runConfiguration = { ...this.configuration, ...configuration };
     return this.runner(codemod.path, this.paths, runConfiguration);
   }
-}
-class CodeRunner extends AbstractRunner {
-  runner = Runner.run;
-  valid(codemod) {
-    return codemod.kind === "code";
+}
+class CodeRunner extends AbstractRunner {
+  runner = Runner.run;
+  valid(codemod) {
+    return codemod.kind === "code";
+  }
+}
+const codeRunnerFactory = (paths, configuration) => {
+  return new CodeRunner(paths, configuration);
+};
+class JSONTransformAPI {
+  json;
+  constructor(json) {
+    this.json = fp.cloneDeep(json);
+  }
+  get(path2, defaultValue) {
+    if (!path2) {
+      return this.root();
+    }
+    return fp.cloneDeep(fp.get(path2, this.json) ?? defaultValue);
+  }
+  has(path2) {
+    return fp.has(path2, this.json);
+  }
+  merge(other) {
+    this.json = fp.merge(other, this.json);
+    return this;
+  }
+  root() {
+    return fp.cloneDeep(this.json);
+  }
+  set(path2, value) {
+    this.json = fp.set(path2, value, this.json);
+    return this;
+  }
+  remove(path2) {
+    this.json = fp.omit(path2, this.json);
+    return this;
   }
 }
-const codeRunnerFactory = (paths, configuration) => {
-  return new CodeRunner(paths, configuration);
+const createJSONTransformAPI = (object) => new JSONTransformAPI(object);
+const readJSON = async (path2) => {
+  const buffer = await fse__default.default.readFile(path2);
+  return JSON.parse(buffer.toString());
+};
+const saveJSON = async (path2, json) => {
+  const jsonAsString = `${JSON.stringify(json, null, 2)}
+`;
+  await fse__default.default.writeFile(path2, jsonAsString);
 };
 const transformJSON = async (codemodPath, paths, config) => {
   const { dry } = config;
@@ -637,88 +672,6 @@ const projectFactory = (cwd) => {
 const isApplicationProject = (project) => {
   return project instanceof AppProject;
 };
-class UnexpectedError extends Error {
-  constructor() {
-    super("Unexpected Error");
-  }
-}
-const unknownToError = (e) => {
-  if (e instanceof Error) {
-    return e;
-  }
-  if (typeof e === "string") {
-    return new Error(e);
-  }
-  return new UnexpectedError();
-};
-const path = (path2) => chalk__default.default.blue(path2);
-const version$1 = (version2) => {
-  return chalk__default.default.italic.yellow(`v${version2}`);
-};
-const codemodUID = (uid) => {
-  return chalk__default.default.bold.cyan(uid);
-};
-const projectDetails = (project) => {
-  return `Project: TYPE=${projectType(project.type)}; CWD=${path(project.cwd)}; PATHS=${project.paths.map(path)}`;
-};
-const projectType = (type) => chalk__default.default.cyan(type);
-const versionRange = (range) => chalk__default.default.italic.yellow(range.raw);
-const highlight = (arg) => chalk__default.default.bold.underline(arg);
-const upgradeStep = (text, step) => {
-  return chalk__default.default.bold(`(${step[0]}/${step[1]}) ${text}...`);
-};
-const reports = (reports2) => {
-  const rows = reports2.map(({ codemod, report }, i) => {
-    const fIndex = chalk__default.default.grey(i);
-    const fVersion = chalk__default.default.magenta(codemod.version);
-    const fKind = chalk__default.default.yellow(codemod.kind);
-    const fFormattedTransformPath = chalk__default.default.cyan(codemod.format());
-    const fTimeElapsed = i === 0 ? `${report.timeElapsed}s ${chalk__default.default.dim.italic("(cold start)")}` : `${report.timeElapsed}s`;
-    const fAffected = report.ok > 0 ? chalk__default.default.green(report.ok) : chalk__default.default.grey(0);
-    const fUnchanged = report.ok === 0 ? chalk__default.default.red(report.nochange) : chalk__default.default.grey(report.nochange);
-    return [fIndex, fVersion, fKind, fFormattedTransformPath, fAffected, fUnchanged, fTimeElapsed];
-  });
-  const table = new CliTable3__default.default({
-    style: { compact: true },
-    head: [
-      chalk__default.default.bold.grey("N°"),
-      chalk__default.default.bold.magenta("Version"),
-      chalk__default.default.bold.yellow("Kind"),
-      chalk__default.default.bold.cyan("Name"),
-      chalk__default.default.bold.green("Affected"),
-      chalk__default.default.bold.red("Unchanged"),
-      chalk__default.default.bold.blue("Duration")
-    ]
-  });
-  table.push(...rows);
-  return table.toString();
-};
-const codemodList = (codemods) => {
-  const rows = codemods.map((codemod, index) => {
-    const fIndex = chalk__default.default.grey(index);
-    const fVersion = chalk__default.default.magenta(codemod.version);
-    const fKind = chalk__default.default.yellow(codemod.kind);
-    const fName = chalk__default.default.blue(codemod.format());
-    const fUID = codemodUID(codemod.uid);
-    return [fIndex, fVersion, fKind, fName, fUID];
-  });
-  const table = new CliTable3__default.default({
-    style: { compact: true },
-    head: [
-      chalk__default.default.bold.grey("N°"),
-      chalk__default.default.bold.magenta("Version"),
-      chalk__default.default.bold.yellow("Kind"),
-      chalk__default.default.bold.blue("Name"),
-      chalk__default.default.bold.cyan("UID")
-    ]
-  });
-  table.push(...rows);
-  return table.toString();
-};
-const durationMs = (elapsedMs) => {
-  const elapsedSeconds = (elapsedMs / ONE_SECOND_MS).toFixed(3);
-  return `${elapsedSeconds}s`;
-};
 const CODEMOD_CODE_SUFFIX = "code";
 const CODEMOD_JSON_SUFFIX = "json";
 const CODEMOD_ALLOWED_SUFFIXES = [CODEMOD_CODE_SUFFIX, CODEMOD_JSON_SUFFIX];
@@ -974,6 +927,15 @@ class Upgrader {
     this.logger = null;
     this.confirmationCallback = null;
   }
+  getNPMPackage() {
+    return this.npmPackage;
+  }
+  getProject() {
+    return this.project;
+  }
+  getTarget() {
+    return semVerFactory(this.target.raw);
+  }
   setRequirements(requirements) {
     this.requirements = requirements;
     return this;
@@ -1055,6 +1017,12 @@ class Upgrader {
     }
     return successReport();
   }
+  async confirm(message) {
+    if (typeof this.confirmationCallback !== "function") {
+      return true;
+    }
+    return this.confirmationCallback(message);
+  }
   async checkRequirements(requirements, context) {
     for (const requirement of requirements) {
       const { pass, error } = await requirement.test(context);
@@ -1126,7 +1094,7 @@ class Upgrader {
     const packageManagerName = await utils.packageManager.getPreferred(projectPath);
     this.logger?.debug?.(`Using ${highlight(packageManagerName)} as package manager`);
     if (this.isDry) {
-      this.logger?.debug?.(`Skipping dependencies installation (${chalk__default.default.italic("dry mode")}`);
+      this.logger?.debug?.(`Skipping dependencies installation (${chalk__default.default.italic("dry mode")})`);
       return;
     }
     await utils.packageManager.installDependencies(projectPath, packageManagerName, {
@@ -1145,72 +1113,175 @@ class Upgrader {
 }
 const resolveNPMTarget = (project, target, npmPackage) => {
   if (isSemverInstance(target)) {
-    return npmPackage.findVersion(target);
+    const version2 = npmPackage.findVersion(target);
+    if (!version2) {
+      throw new NPMCandidateNotFoundError(target);
+    }
+    return version2;
   }
   if (isSemVerReleaseType(target)) {
     const range = rangeFromVersions(project.strapiVersion, target);
     const npmVersionsMatches = npmPackage.findVersionsInRange(range);
-    return npmVersionsMatches.at(-1);
+    const version2 = npmVersionsMatches.at(-1);
+    if (!version2) {
+      throw new NPMCandidateNotFoundError(range, `The project is already up-to-date (${target})`);
+    }
+    return version2;
   }
-  return void 0;
+  throw new NPMCandidateNotFoundError(target);
 };
 const upgraderFactory = (project, target, npmPackage) => {
-  const targetedNPMVersion = resolveNPMTarget(project, target, npmPackage);
-  if (!targetedNPMVersion) {
-    throw new Error(`Couldn't find a matching version in the NPM registry for "${target}"`);
-  }
-  const semverTarget = semVerFactory(targetedNPMVersion.version);
+  const npmTarget = resolveNPMTarget(project, target, npmPackage);
+  const semverTarget = semVerFactory(npmTarget.version);
   if (semver__default.default.eq(semverTarget, project.strapiVersion)) {
-    throw new Error(`The project is already on ${version$1(semverTarget)}`);
+    throw new Error(`The project is already using v${semverTarget}`);
   }
   return new Upgrader(project, semverTarget, npmPackage);
 };
 const successReport = () => ({ success: true, error: null });
 const erroredReport = (error) => ({ success: false, error });
 const STRAPI_PACKAGE_NAME = "@strapi/strapi";
-const NPM_REGISTRY_URL = "https://registry.npmjs.org";
-class Package {
+class Requirement {
+  isRequired;
   name;
-  packageURL;
-  npmPackage;
-  constructor(name) {
+  testCallback;
+  children;
+  constructor(name, testCallback, isRequired) {
     this.name = name;
-    this.packageURL = `${NPM_REGISTRY_URL}/${name}`;
-    this.npmPackage = null;
+    this.testCallback = testCallback;
+    this.isRequired = isRequired ?? true;
+    this.children = [];
   }
-  get isLoaded() {
-    return this.npmPackage !== null;
+  setChildren(children) {
+    this.children = children;
+    return this;
   }
-  assertPackageIsLoaded(npmPackage) {
-    assert__default.default(this.isLoaded, "The package is not loaded yet");
+  addChild(child) {
+    this.children.push(child);
+    return this;
   }
-  getVersionsDict() {
-    this.assertPackageIsLoaded(this.npmPackage);
-    return this.npmPackage.versions;
+  asOptional() {
+    const newInstance = requirementFactory(this.name, this.testCallback, false);
+    newInstance.setChildren(this.children);
+    return newInstance;
   }
-  getVersionsAsList() {
-    this.assertPackageIsLoaded(this.npmPackage);
-    return Object.values(this.npmPackage.versions);
+  asRequired() {
+    const newInstance = requirementFactory(this.name, this.testCallback, true);
+    newInstance.setChildren(this.children);
+    return newInstance;
   }
-  findVersionsInRange(range) {
-    const versions = this.getVersionsAsList();
-    return versions.filter((v) => range.test(v.version)).filter((v) => isLiteralSemVer(v.version)).sort((v1, v2) => semver__default.default.compare(v1.version, v2.version));
+  async test(context) {
+    try {
+      await this.testCallback?.(context);
+      return ok();
+    } catch (e) {
+      if (e instanceof Error) {
+        return errored(e);
+      }
+      if (typeof e === "string") {
+        return errored(new Error(e));
+      }
+      return errored(new Error("Unknown error"));
+    }
   }
-  findVersion(version2) {
-    const versions = this.getVersionsAsList();
-    return versions.find((npmVersion) => semver__default.default.eq(npmVersion.version, version2));
+}
+const ok = () => ({ pass: true, error: null });
+const errored = (error) => ({ pass: false, error });
+const requirementFactory = (name, testCallback, isRequired) => new Requirement(name, testCallback, isRequired);
+const REQUIRE_AVAILABLE_NEXT_MAJOR = requirementFactory(
+  "REQUIRE_AVAILABLE_NEXT_MAJOR",
+  (context) => {
+    const { project, target } = context;
+    const currentMajor = project.strapiVersion.major;
+    const targetedMajor = target.major;
+    if (targetedMajor === currentMajor) {
+      throw new Error(`You're already on the latest major version (v${currentMajor})`);
+    }
   }
-  async refresh() {
-    const response = await fetch(this.packageURL);
-    assert__default.default(response.ok, `Request failed for ${this.packageURL}`);
-    this.npmPackage = await response.json();
-    return this;
+);
+const REQUIRE_LATEST_FOR_CURRENT_MAJOR = requirementFactory(
+  "REQUIRE_LATEST_FOR_CURRENT_MAJOR",
+  (context) => {
+    const { project, target, npmVersionsMatches } = context;
+    const { major: currentMajor } = project.strapiVersion;
+    const invalidMatches = npmVersionsMatches.filter(
+      (match) => semVerFactory(match.version).major === currentMajor
+    );
+    if (invalidMatches.length > 0) {
+      const invalidVersions = invalidMatches.map((match) => match.version);
+      const invalidVersionsCount = invalidVersions.length;
+      throw new Error(
+        `Doing a major upgrade requires to be on the latest v${currentMajor} version, but found ${invalidVersionsCount} versions between the current one and ${target}. Please upgrade to ${invalidVersions.at(-1)} and try again.`
+      );
+    }
   }
-  versionExists(version2) {
-    return this.findVersion(version2) !== void 0;
+);
+const REQUIRE_GIT_CLEAN_REPOSITORY = requirementFactory(
+  "REQUIRE_GIT_CLEAN_REPOSITORY",
+  async (context) => {
+    const git = simpleGit__default.default({ baseDir: context.project.cwd });
+    const status = await git.status();
+    if (!status.isClean()) {
+      throw new Error(
+        "Repository is not clean. Please commit or stash any changes before upgrading"
+      );
+    }
   }
-}
-const npmPackageFactory = (name) => new Package(name);
+);
+const REQUIRE_GIT_REPOSITORY = requirementFactory(
+  "REQUIRE_GIT_REPOSITORY",
+  async (context) => {
+    const git = simpleGit__default.default({ baseDir: context.project.cwd });
+    const isRepo = await git.checkIsRepo();
+    if (!isRepo) {
+      throw new Error("Not a git repository (or any of the parent directories)");
+    }
+  }
+).addChild(REQUIRE_GIT_CLEAN_REPOSITORY.asOptional());
+const REQUIRE_GIT_INSTALLED = requirementFactory(
+  "REQUIRE_GIT_INSTALLED",
+  async (context) => {
+    const git = simpleGit__default.default({ baseDir: context.project.cwd });
+    try {
+      await git.version();
+    } catch {
+      throw new Error("Git is not installed");
+    }
+  }
+).addChild(REQUIRE_GIT_REPOSITORY.asOptional());
+const REQUIRE_GIT = requirementFactory("REQUIRE_GIT", null).addChild(
+  REQUIRE_GIT_INSTALLED.asOptional()
+);
+const latest = async (upgrader, options) => {
+  if (options.target !== ReleaseType.Latest) {
+    return;
+  }
+  const npmPackage = upgrader.getNPMPackage();
+  const target = upgrader.getTarget();
+  const project = upgrader.getProject();
+  const { strapiVersion: current } = project;
+  const fTargetMajor = highlight(`v${target.major}`);
+  const fCurrentMajor = highlight(`v${current.major}`);
+  const fTarget = version$1(target);
+  const fCurrent = version$1(current);
+  const isMajorUpgrade = target.major > current.major;
+  if (isMajorUpgrade) {
+    options.logger.warn(
+      `Detected a major upgrade for the "${highlight(ReleaseType.Latest)}" tag: ${fCurrent} > ${fTarget}`
+    );
+    const newerPackageRelease = npmPackage.findVersionsInRange(rangeFactory(`>${current.raw} <${target.major}`)).at(-1);
+    if (newerPackageRelease) {
+      const fLatest = version$1(semVerFactory(newerPackageRelease.version));
+      options.logger.warn(
+        `It's recommended to first upgrade to the latest version of ${fCurrentMajor} (${fLatest}) before upgrading to ${fTargetMajor}.`
+      );
+    }
+    const proceedAnyway = await upgrader.confirm(`I know what I'm doing. Proceed anyway!`);
+    if (!proceedAnyway) {
+      throw new AbortedError();
+    }
+  }
+};
 const upgrade$1 = async (options) => {
   const timer = timerFactory();
   const { logger, codemodsTarget } = options;
@@ -1222,22 +1293,34 @@ const upgrade$1 = async (options) => {
       `The "${options.target}" upgrade can only be run on a Strapi project; for plugins, please use "codemods".`
     );
   }
+  logger.debug(
+    `Application: VERSION=${version$1(project.packageJSON.version)}; STRAPI_VERSION=${version$1(project.strapiVersion)}`
+  );
   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);
   if (codemodsTarget !== void 0) {
     upgrader.overrideCodemodsTarget(codemodsTarget);
   }
-  if (options.target === ReleaseType.Major) {
-    upgrader.addRequirement(REQUIRE_AVAILABLE_NEXT_MAJOR).addRequirement(REQUIRE_LATEST_FOR_CURRENT_MAJOR);
-  }
-  upgrader.addRequirement(REQUIRE_GIT.asOptional());
+  await runUpgradePrompts(upgrader, options);
+  addUpgradeRequirements(upgrader, options);
   const upgradeReport = await upgrader.upgrade();
   if (!upgradeReport.success) {
     throw upgradeReport.error;
   }
   timer.stop();
-  logger.info(`Completed in ${durationMs(timer.elapsedMs)}`);
+  logger.info(`Completed in ${durationMs(timer.elapsedMs)}ms`);
+};
+const runUpgradePrompts = async (upgrader, options) => {
+  if (options.target === ReleaseType.Latest) {
+    await latest(upgrader, options);
+  }
+};
+const addUpgradeRequirements = (upgrader, options) => {
+  if (options.target === ReleaseType.Major) {
+    upgrader.addRequirement(REQUIRE_AVAILABLE_NEXT_MAJOR).addRequirement(REQUIRE_LATEST_FOR_CURRENT_MAJOR);
+  }
+  upgrader.addRequirement(REQUIRE_GIT.asOptional());
 };
 const resolvePath = (cwd) => path__default.default.resolve(cwd ?? process.cwd());
 const getRangeFromTarget = (currentVersion, target) => {
@@ -1246,6 +1329,8 @@ const getRangeFromTarget = (currentVersion, target) => {
   }
   const { major, minor, patch } = currentVersion;
   switch (target) {
+    case ReleaseType.Latest:
+      throw new Error("Can't use <latest> to create a codemods range: not implemented");
     case ReleaseType.Major:
       return rangeFactory(`${major}`);
     case ReleaseType.Minor:
@@ -1365,6 +1450,10 @@ const register$1 = (program) => {
       return upgrade({ ...options, target: releaseType });
     });
   };
+  addReleaseUpgradeCommand(
+    ReleaseType.Latest,
+    "Upgrade to the latest available version of Strapi"
+  );
   addReleaseUpgradeCommand(
     ReleaseType.Major,
     "Upgrade to the next available major version of Strapi"
@@ -1477,7 +1566,7 @@ When executed on a Strapi plugin project, it shows every codemods.
     return listCodemods(options);
   });
 };
-const version = "5.0.5";
+const version = "5.1.0";
 register$1(commander.program);
 register(commander.program);
 commander.program.usage("<command> [options]").on("command:*", ([invalidCmd]) => {