@strapi/upgrade 5.12.0 → 5.12.2

package/dist/src/modules/codemod-repository/repository.js

@@ -0,0 +1,127 @@
+'use strict';
+
+var assert = require('node:assert');
+var fse = require('fs-extra');
+var semver$1 = require('semver');
+var path = require('node:path');
+var codemod = require('../codemod/codemod.js');
+var constants$1 = require('../codemod/constants.js');
+var semver = require('../version/semver.js');
+var range = require('../version/range.js');
+require('../version/types.js');
+var constants = require('./constants.js');
+
+class CodemodRepository {
+    refresh() {
+        this.refreshAvailableVersions();
+        this.refreshAvailableFiles();
+        return this;
+    }
+    count(version) {
+        return this.findByVersion(version).length;
+    }
+    versionExists(version) {
+        return version.raw in this.groups;
+    }
+    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 by range if provided in the query
+        .filter(maybeFilterByRange)// Transform version/codemods tuples into regular objects
+        .map(([version, codemods])=>({
+                version: semver.semVerFactory(version),
+                // Filter by UID if provided in the query
+                codemods: codemods.filter(maybeFilterByUIDs)
+            }))// Only return groups with at least 1 codemod
+        .filter(({ codemods })=>codemods.length > 0);
+        function maybeFilterByRange([version]) {
+            if (!range.isRangeInstance(q.range)) {
+                return true;
+            }
+            return q.range.test(version);
+        }
+        function maybeFilterByUIDs(codemod) {
+            if (q.uids === undefined) {
+                return true;
+            }
+            return q.uids.includes(codemod.uid);
+        }
+    }
+    findByVersion(version) {
+        const literalVersion = version.raw;
+        const codemods = this.groups[literalVersion];
+        return codemods ?? [];
+    }
+    findAll() {
+        const entries = Object.entries(this.groups);
+        return entries.map(([version, codemods])=>({
+                version: semver.semVerFactory(version),
+                codemods
+            }));
+    }
+    refreshAvailableVersions() {
+        this.versions = fse.readdirSync(this.cwd) // Only keep root directories
+        .filter((filename)=>fse.statSync(path.join(this.cwd, filename)).isDirectory())// Paths should be valid semver
+        .filter((filename)=>semver$1.valid(filename) !== null)// Transform files names to SemVer instances
+        .map((version)=>semver.semVerFactory(version))// Sort versions in ascending order
+        .sort(semver$1.compare);
+        return this;
+    }
+    refreshAvailableFiles() {
+        this.groups = {};
+        for (const version of this.versions){
+            this.refreshAvailableFilesForVersion(version);
+        }
+    }
+    refreshAvailableFilesForVersion(version) {
+        const literalVersion = version.raw;
+        const versionDirectory = path.join(this.cwd, literalVersion);
+        // Ignore obsolete versions
+        if (!fse.existsSync(versionDirectory)) {
+            return;
+        }
+        this.groups[literalVersion] = fse.readdirSync(versionDirectory)// Make sure the filenames are valid codemod files
+        .filter((filename)=>fse.statSync(path.join(versionDirectory, filename)).isFile()).filter((filename)=>constants$1.CODEMOD_FILE_REGEXP.test(filename))// Transform the filenames into Codemod instances
+        .map((filename)=>{
+            const kind = parseCodemodKindFromFilename(filename);
+            const baseDirectory = this.cwd;
+            return codemod.codemodFactory({
+                kind,
+                baseDirectory,
+                version,
+                filename
+            });
+        });
+    }
+    constructor(cwd){
+        assert(fse.existsSync(cwd), `Invalid codemods directory provided "${cwd}"`);
+        this.cwd = cwd;
+        this.groups = {};
+        this.versions = [];
+    }
+}
+const parseCodemodKindFromFilename = (filename)=>{
+    const kind = filename.split('.').at(-2);
+    assert(kind !== undefined);
+    assert(constants$1.CODEMOD_ALLOWED_SUFFIXES.includes(kind));
+    return kind;
+};
+const codemodRepositoryFactory = (cwd = constants.INTERNAL_CODEMODS_DIRECTORY)=>{
+    return new CodemodRepository(cwd);
+};
+
+exports.CodemodRepository = CodemodRepository;
+exports.codemodRepositoryFactory = codemodRepositoryFactory;
+exports.parseCodemodKindFromFilename = parseCodemodKindFromFilename;
+//# sourceMappingURL=repository.js.map

package/dist/src/modules/codemod-repository/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sources":["../../../../src/modules/codemod-repository/repository.ts"],"sourcesContent":["import assert from 'node:assert';\nimport fse from 'fs-extra';\nimport semver from 'semver';\nimport path from 'node:path';\n\nimport { codemodFactory, constants } from '../codemod';\nimport { isRangeInstance, semVerFactory } from '../version';\n\nimport { INTERNAL_CODEMODS_DIRECTORY } from './constants';\n\nimport type { Codemod } from '../codemod';\nimport type { Version } from '../version';\n\nimport type { CodemodRepository as CodemodRepositoryInterface, FindQuery } from './types';\n\nexport class CodemodRepository implements CodemodRepositoryInterface {\n  private groups: Record<Version.LiteralSemVer, Codemod.Codemod[]>;\n\n  private versions: Version.SemVer[];\n\n  public cwd: string;\n\n  constructor(cwd: string) {\n    assert(fse.existsSync(cwd), `Invalid codemods directory provided \"${cwd}\"`);\n\n    this.cwd = cwd;\n\n    this.groups = {};\n    this.versions = [];\n  }\n\n  refresh() {\n    this.refreshAvailableVersions();\n    this.refreshAvailableFiles();\n\n    return this;\n  }\n\n  count(version: Version.SemVer) {\n    return this.findByVersion(version).length;\n  }\n\n  versionExists(version: Version.SemVer) {\n    return version.raw in this.groups;\n  }\n\n  has(uid: string) {\n    const result = this.find({ uids: [uid] });\n\n    if (result.length !== 1) {\n      return false;\n    }\n\n    const { codemods } = result[0];\n\n    return codemods.length === 1 && codemods[0].uid === uid;\n  }\n\n  find(q: FindQuery) {\n    const entries = Object.entries(this.groups) as Array<[Version.LiteralSemVer, Codemod.List]>;\n\n    return (\n      entries\n        // Filter by range if provided in the query\n        .filter(maybeFilterByRange)\n        // Transform version/codemods tuples into regular objects\n        .map<Codemod.VersionedCollection>(([version, codemods]) => ({\n          version: semVerFactory(version),\n          // Filter by UID if provided in the query\n          codemods: codemods.filter(maybeFilterByUIDs),\n        }))\n        // Only return groups with at least 1 codemod\n        .filter(({ codemods }) => codemods.length > 0)\n    );\n\n    function maybeFilterByRange([version]: [Version.LiteralSemVer, Codemod.List]) {\n      if (!isRangeInstance(q.range)) {\n        return true;\n      }\n\n      return q.range.test(version);\n    }\n\n    function maybeFilterByUIDs(codemod: Codemod.Codemod) {\n      if (q.uids === undefined) {\n        return true;\n      }\n\n      return q.uids.includes(codemod.uid);\n    }\n  }\n\n  findByVersion(version: Version.SemVer) {\n    const literalVersion = version.raw as Version.LiteralSemVer;\n    const codemods = this.groups[literalVersion];\n\n    return codemods ?? [];\n  }\n\n  findAll() {\n    const entries = Object.entries(this.groups);\n\n    return entries.map<Codemod.VersionedCollection>(([version, codemods]) => ({\n      version: semVerFactory(version),\n      codemods,\n    }));\n  }\n\n  private refreshAvailableVersions() {\n    this.versions = fse\n      .readdirSync(this.cwd) // Only keep root directories\n      .filter((filename) => fse.statSync(path.join(this.cwd, filename)).isDirectory())\n      // Paths should be valid semver\n      .filter((filename): filename is Version.LiteralSemVer => semver.valid(filename) !== null)\n      // Transform files names to SemVer instances\n      .map<Version.SemVer>((version) => semVerFactory(version))\n      // Sort versions in ascending order\n      .sort(semver.compare);\n\n    return this;\n  }\n\n  private refreshAvailableFiles() {\n    this.groups = {};\n\n    for (const version of this.versions) {\n      this.refreshAvailableFilesForVersion(version);\n    }\n  }\n\n  private refreshAvailableFilesForVersion(version: Version.SemVer) {\n    const literalVersion = version.raw as Version.LiteralSemVer;\n    const versionDirectory = path.join(this.cwd, literalVersion);\n\n    // Ignore obsolete versions\n    if (!fse.existsSync(versionDirectory)) {\n      return;\n    }\n\n    this.groups[literalVersion] = fse\n      .readdirSync(versionDirectory)\n      // Make sure the filenames are valid codemod files\n      .filter((filename) => fse.statSync(path.join(versionDirectory, filename)).isFile())\n      .filter((filename) => constants.CODEMOD_FILE_REGEXP.test(filename))\n      // Transform the filenames into Codemod instances\n      .map((filename) => {\n        const kind = parseCodemodKindFromFilename(filename);\n        const baseDirectory = this.cwd;\n\n        return codemodFactory({ kind, baseDirectory, version, filename });\n      });\n  }\n}\n\nexport const parseCodemodKindFromFilename = (filename: string): Codemod.Kind => {\n  const kind = filename.split('.').at(-2) as Codemod.Kind | undefined;\n\n  assert(kind !== undefined);\n  assert(constants.CODEMOD_ALLOWED_SUFFIXES.includes(kind));\n\n  return kind;\n};\n\nexport const codemodRepositoryFactory = (cwd: string = INTERNAL_CODEMODS_DIRECTORY) => {\n  return new CodemodRepository(cwd);\n};\n"],"names":["CodemodRepository","refresh","refreshAvailableVersions","refreshAvailableFiles","count","version","findByVersion","length","versionExists","raw","groups","has","uid","result","find","uids","codemods","q","entries","Object","filter","maybeFilterByRange","map","semVerFactory","maybeFilterByUIDs","isRangeInstance","range","test","codemod","undefined","includes","literalVersion","findAll","versions","fse","readdirSync","cwd","filename","statSync","path","join","isDirectory","semver","valid","sort","compare","refreshAvailableFilesForVersion","versionDirectory","existsSync","isFile","constants","kind","parseCodemodKindFromFilename","baseDirectory","codemodFactory","constructor","assert","split","at","codemodRepositoryFactory","INTERNAL_CODEMODS_DIRECTORY"],"mappings":"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"}

package/dist/src/modules/codemod-repository/repository.mjs

@@ -0,0 +1,123 @@
+import assert from 'node:assert';
+import fse from 'fs-extra';
+import semver from 'semver';
+import path from 'node:path';
+import { codemodFactory } from '../codemod/codemod.mjs';
+import { CODEMOD_FILE_REGEXP, CODEMOD_ALLOWED_SUFFIXES } from '../codemod/constants.mjs';
+import { semVerFactory } from '../version/semver.mjs';
+import { isRangeInstance } from '../version/range.mjs';
+import '../version/types.mjs';
+import { INTERNAL_CODEMODS_DIRECTORY } from './constants.mjs';
+
+class CodemodRepository {
+    refresh() {
+        this.refreshAvailableVersions();
+        this.refreshAvailableFiles();
+        return this;
+    }
+    count(version) {
+        return this.findByVersion(version).length;
+    }
+    versionExists(version) {
+        return version.raw in this.groups;
+    }
+    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 by range if provided in the query
+        .filter(maybeFilterByRange)// Transform version/codemods tuples into regular objects
+        .map(([version, codemods])=>({
+                version: semVerFactory(version),
+                // Filter by UID if provided in the query
+                codemods: codemods.filter(maybeFilterByUIDs)
+            }))// Only return groups with at least 1 codemod
+        .filter(({ codemods })=>codemods.length > 0);
+        function maybeFilterByRange([version]) {
+            if (!isRangeInstance(q.range)) {
+                return true;
+            }
+            return q.range.test(version);
+        }
+        function maybeFilterByUIDs(codemod) {
+            if (q.uids === undefined) {
+                return true;
+            }
+            return q.uids.includes(codemod.uid);
+        }
+    }
+    findByVersion(version) {
+        const literalVersion = version.raw;
+        const codemods = this.groups[literalVersion];
+        return codemods ?? [];
+    }
+    findAll() {
+        const entries = Object.entries(this.groups);
+        return entries.map(([version, codemods])=>({
+                version: semVerFactory(version),
+                codemods
+            }));
+    }
+    refreshAvailableVersions() {
+        this.versions = fse.readdirSync(this.cwd) // Only keep root directories
+        .filter((filename)=>fse.statSync(path.join(this.cwd, filename)).isDirectory())// Paths should be valid semver
+        .filter((filename)=>semver.valid(filename) !== null)// Transform files names to SemVer instances
+        .map((version)=>semVerFactory(version))// Sort versions in ascending order
+        .sort(semver.compare);
+        return this;
+    }
+    refreshAvailableFiles() {
+        this.groups = {};
+        for (const version of this.versions){
+            this.refreshAvailableFilesForVersion(version);
+        }
+    }
+    refreshAvailableFilesForVersion(version) {
+        const literalVersion = version.raw;
+        const versionDirectory = path.join(this.cwd, literalVersion);
+        // Ignore obsolete versions
+        if (!fse.existsSync(versionDirectory)) {
+            return;
+        }
+        this.groups[literalVersion] = fse.readdirSync(versionDirectory)// Make sure the filenames are valid codemod files
+        .filter((filename)=>fse.statSync(path.join(versionDirectory, filename)).isFile()).filter((filename)=>CODEMOD_FILE_REGEXP.test(filename))// Transform the filenames into Codemod instances
+        .map((filename)=>{
+            const kind = parseCodemodKindFromFilename(filename);
+            const baseDirectory = this.cwd;
+            return codemodFactory({
+                kind,
+                baseDirectory,
+                version,
+                filename
+            });
+        });
+    }
+    constructor(cwd){
+        assert(fse.existsSync(cwd), `Invalid codemods directory provided "${cwd}"`);
+        this.cwd = cwd;
+        this.groups = {};
+        this.versions = [];
+    }
+}
+const parseCodemodKindFromFilename = (filename)=>{
+    const kind = filename.split('.').at(-2);
+    assert(kind !== undefined);
+    assert(CODEMOD_ALLOWED_SUFFIXES.includes(kind));
+    return kind;
+};
+const codemodRepositoryFactory = (cwd = INTERNAL_CODEMODS_DIRECTORY)=>{
+    return new CodemodRepository(cwd);
+};
+
+export { CodemodRepository, codemodRepositoryFactory, parseCodemodKindFromFilename };
+//# sourceMappingURL=repository.mjs.map

package/dist/src/modules/codemod-repository/repository.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.mjs","sources":["../../../../src/modules/codemod-repository/repository.ts"],"sourcesContent":["import assert from 'node:assert';\nimport fse from 'fs-extra';\nimport semver from 'semver';\nimport path from 'node:path';\n\nimport { codemodFactory, constants } from '../codemod';\nimport { isRangeInstance, semVerFactory } from '../version';\n\nimport { INTERNAL_CODEMODS_DIRECTORY } from './constants';\n\nimport type { Codemod } from '../codemod';\nimport type { Version } from '../version';\n\nimport type { CodemodRepository as CodemodRepositoryInterface, FindQuery } from './types';\n\nexport class CodemodRepository implements CodemodRepositoryInterface {\n  private groups: Record<Version.LiteralSemVer, Codemod.Codemod[]>;\n\n  private versions: Version.SemVer[];\n\n  public cwd: string;\n\n  constructor(cwd: string) {\n    assert(fse.existsSync(cwd), `Invalid codemods directory provided \"${cwd}\"`);\n\n    this.cwd = cwd;\n\n    this.groups = {};\n    this.versions = [];\n  }\n\n  refresh() {\n    this.refreshAvailableVersions();\n    this.refreshAvailableFiles();\n\n    return this;\n  }\n\n  count(version: Version.SemVer) {\n    return this.findByVersion(version).length;\n  }\n\n  versionExists(version: Version.SemVer) {\n    return version.raw in this.groups;\n  }\n\n  has(uid: string) {\n    const result = this.find({ uids: [uid] });\n\n    if (result.length !== 1) {\n      return false;\n    }\n\n    const { codemods } = result[0];\n\n    return codemods.length === 1 && codemods[0].uid === uid;\n  }\n\n  find(q: FindQuery) {\n    const entries = Object.entries(this.groups) as Array<[Version.LiteralSemVer, Codemod.List]>;\n\n    return (\n      entries\n        // Filter by range if provided in the query\n        .filter(maybeFilterByRange)\n        // Transform version/codemods tuples into regular objects\n        .map<Codemod.VersionedCollection>(([version, codemods]) => ({\n          version: semVerFactory(version),\n          // Filter by UID if provided in the query\n          codemods: codemods.filter(maybeFilterByUIDs),\n        }))\n        // Only return groups with at least 1 codemod\n        .filter(({ codemods }) => codemods.length > 0)\n    );\n\n    function maybeFilterByRange([version]: [Version.LiteralSemVer, Codemod.List]) {\n      if (!isRangeInstance(q.range)) {\n        return true;\n      }\n\n      return q.range.test(version);\n    }\n\n    function maybeFilterByUIDs(codemod: Codemod.Codemod) {\n      if (q.uids === undefined) {\n        return true;\n      }\n\n      return q.uids.includes(codemod.uid);\n    }\n  }\n\n  findByVersion(version: Version.SemVer) {\n    const literalVersion = version.raw as Version.LiteralSemVer;\n    const codemods = this.groups[literalVersion];\n\n    return codemods ?? [];\n  }\n\n  findAll() {\n    const entries = Object.entries(this.groups);\n\n    return entries.map<Codemod.VersionedCollection>(([version, codemods]) => ({\n      version: semVerFactory(version),\n      codemods,\n    }));\n  }\n\n  private refreshAvailableVersions() {\n    this.versions = fse\n      .readdirSync(this.cwd) // Only keep root directories\n      .filter((filename) => fse.statSync(path.join(this.cwd, filename)).isDirectory())\n      // Paths should be valid semver\n      .filter((filename): filename is Version.LiteralSemVer => semver.valid(filename) !== null)\n      // Transform files names to SemVer instances\n      .map<Version.SemVer>((version) => semVerFactory(version))\n      // Sort versions in ascending order\n      .sort(semver.compare);\n\n    return this;\n  }\n\n  private refreshAvailableFiles() {\n    this.groups = {};\n\n    for (const version of this.versions) {\n      this.refreshAvailableFilesForVersion(version);\n    }\n  }\n\n  private refreshAvailableFilesForVersion(version: Version.SemVer) {\n    const literalVersion = version.raw as Version.LiteralSemVer;\n    const versionDirectory = path.join(this.cwd, literalVersion);\n\n    // Ignore obsolete versions\n    if (!fse.existsSync(versionDirectory)) {\n      return;\n    }\n\n    this.groups[literalVersion] = fse\n      .readdirSync(versionDirectory)\n      // Make sure the filenames are valid codemod files\n      .filter((filename) => fse.statSync(path.join(versionDirectory, filename)).isFile())\n      .filter((filename) => constants.CODEMOD_FILE_REGEXP.test(filename))\n      // Transform the filenames into Codemod instances\n      .map((filename) => {\n        const kind = parseCodemodKindFromFilename(filename);\n        const baseDirectory = this.cwd;\n\n        return codemodFactory({ kind, baseDirectory, version, filename });\n      });\n  }\n}\n\nexport const parseCodemodKindFromFilename = (filename: string): Codemod.Kind => {\n  const kind = filename.split('.').at(-2) as Codemod.Kind | undefined;\n\n  assert(kind !== undefined);\n  assert(constants.CODEMOD_ALLOWED_SUFFIXES.includes(kind));\n\n  return kind;\n};\n\nexport const codemodRepositoryFactory = (cwd: string = INTERNAL_CODEMODS_DIRECTORY) => {\n  return new CodemodRepository(cwd);\n};\n"],"names":["CodemodRepository","refresh","refreshAvailableVersions","refreshAvailableFiles","count","version","findByVersion","length","versionExists","raw","groups","has","uid","result","find","uids","codemods","q","entries","Object","filter","maybeFilterByRange","map","semVerFactory","maybeFilterByUIDs","isRangeInstance","range","test","codemod","undefined","includes","literalVersion","findAll","versions","fse","readdirSync","cwd","filename","statSync","path","join","isDirectory","semver","valid","sort","compare","refreshAvailableFilesForVersion","versionDirectory","existsSync","isFile","constants","kind","parseCodemodKindFromFilename","baseDirectory","codemodFactory","constructor","assert","split","at","codemodRepositoryFactory","INTERNAL_CODEMODS_DIRECTORY"],"mappings":"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"}

package/dist/src/modules/codemod-runner/codemod-runner.js

@@ -0,0 +1,113 @@
+'use strict';
+
+var fp = require('lodash/fp');
+var repository = require('../codemod-repository/repository.js');
+var constants = require('../codemod-repository/constants.js');
+var utils = require('../error/utils.js');
+var semver = require('../version/semver.js');
+require('semver');
+require('../version/types.js');
+var formats = require('../format/formats.js');
+
+class CodemodRunner {
+    setRange(range) {
+        this.range = range;
+        return this;
+    }
+    setLogger(logger) {
+        this.logger = logger;
+        return this;
+    }
+    onSelectCodemods(callback) {
+        this.selectCodemodsCallback = callback;
+        return this;
+    }
+    dry(enabled = true) {
+        this.isDry = enabled;
+        return this;
+    }
+    createRepository(codemodsDirectory) {
+        const repository$1 = repository.codemodRepositoryFactory(codemodsDirectory ?? constants.INTERNAL_CODEMODS_DIRECTORY);
+        // Make sure we have access to the latest snapshots of codemods on the system
+        repository$1.refresh();
+        return repository$1;
+    }
+    async safeRunAndReport(codemods) {
+        if (this.isDry) {
+            this.logger?.warn?.('Running the codemods in dry mode. No files will be modified during the process.');
+        }
+        try {
+            const reports = await this.project.runCodemods(codemods, {
+                dry: this.isDry
+            });
+            this.logger?.raw?.(formats.reports(reports));
+            if (!this.isDry) {
+                const nbAffectedTotal = reports.flatMap((report)=>report.report.ok).reduce((acc, nb)=>acc + nb, 0);
+                this.logger?.debug?.(`Successfully ran ${formats.highlight(codemods.length)} codemod(s), ${formats.highlight(nbAffectedTotal)} change(s) have been detected`);
+            }
+            return successReport();
+        } catch (e) {
+            return erroredReport(utils.unknownToError(e));
+        }
+    }
+    async runByUID(uid, codemodsDirectory) {
+        const repository = this.createRepository(codemodsDirectory);
+        if (!repository.has(uid)) {
+            throw new Error(`Unknown codemod UID provided: ${uid}`);
+        }
+        // Note: Ignore the range when running with a UID
+        const codemods = repository.find({
+            uids: [
+                uid
+            ]
+        }).flatMap(({ codemods })=>codemods);
+        return this.safeRunAndReport(codemods);
+    }
+    async run(codemodsDirectory) {
+        const repository = this.createRepository(codemodsDirectory);
+        // Find codemods matching the given range
+        const codemodsInRange = repository.find({
+            range: this.range
+        });
+        // If a selection callback is set, use it, else keep every codemods found
+        const selectedCodemods = this.selectCodemodsCallback ? await this.selectCodemodsCallback(codemodsInRange) : codemodsInRange;
+        // If no codemods have been selected (either manually or automatically)
+        // Then ignore and return a successful report
+        if (selectedCodemods.length === 0) {
+            this.logger?.debug?.(`Found no codemods to run for ${formats.versionRange(this.range)}`);
+            return successReport();
+        }
+        // Flatten the collection to a single list of codemods, the original list should already be sorted by version
+        const codemods = selectedCodemods.flatMap(({ codemods })=>codemods);
+        // Log (debug) the codemods by version
+        const codemodsByVersion = fp.groupBy('version', codemods);
+        const fRange = formats.versionRange(this.range);
+        this.logger?.debug?.(`Found ${formats.highlight(codemods.length)} codemods for ${formats.highlight(fp.size(codemodsByVersion))} version(s) using ${fRange}`);
+        for (const [version, codemods] of Object.entries(codemodsByVersion)){
+            this.logger?.debug?.(`- ${formats.version(semver.semVerFactory(version))} (${codemods.length})`);
+        }
+        return this.safeRunAndReport(codemods);
+    }
+    constructor(project, range){
+        this.project = project;
+        this.range = range;
+        this.isDry = false;
+        this.logger = null;
+        this.selectCodemodsCallback = null;
+    }
+}
+const codemodRunnerFactory = (project, range)=>{
+    return new CodemodRunner(project, range);
+};
+const successReport = ()=>({
+        success: true,
+        error: null
+    });
+const erroredReport = (error)=>({
+        success: false,
+        error
+    });
+
+exports.CodemodRunner = CodemodRunner;
+exports.codemodRunnerFactory = codemodRunnerFactory;
+//# sourceMappingURL=codemod-runner.js.map

package/dist/src/modules/codemod-runner/codemod-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemod-runner.js","sources":["../../../../src/modules/codemod-runner/codemod-runner.ts"],"sourcesContent":["import { groupBy, size } from 'lodash/fp';\n\nimport {\n  codemodRepositoryFactory,\n  constants as codemodRepositoryConstants,\n} from '../codemod-repository';\nimport { unknownToError } from '../error';\nimport { semVerFactory } from '../version';\nimport * as f from '../format';\n\nimport type { Codemod } from '../codemod';\nimport type { Logger } from '../logger';\nimport type { Project } from '../project';\nimport type { UpgradeReport } from '../upgrader';\nimport type { CodemodRunnerInterface, CodemodRunnerReport, SelectCodemodsCallback } from './types';\nimport type { Version } from '../version';\n\nexport class CodemodRunner implements CodemodRunnerInterface {\n  private readonly project: Project;\n\n  private range: Version.Range;\n\n  private isDry: boolean;\n\n  private logger: Logger | null;\n\n  private selectCodemodsCallback: SelectCodemodsCallback | null;\n\n  constructor(project: Project, range: Version.Range) {\n    this.project = project;\n    this.range = range;\n\n    this.isDry = false;\n\n    this.logger = null;\n    this.selectCodemodsCallback = null;\n  }\n\n  setRange(range: Version.Range) {\n    this.range = range;\n    return this;\n  }\n\n  setLogger(logger: Logger) {\n    this.logger = logger;\n    return this;\n  }\n\n  onSelectCodemods(callback: SelectCodemodsCallback | null) {\n    this.selectCodemodsCallback = callback;\n    return this;\n  }\n\n  dry(enabled: boolean = true) {\n    this.isDry = enabled;\n    return this;\n  }\n\n  private createRepository(codemodsDirectory?: string) {\n    const repository = codemodRepositoryFactory(\n      codemodsDirectory ?? codemodRepositoryConstants.INTERNAL_CODEMODS_DIRECTORY\n    );\n\n    // Make sure we have access to the latest snapshots of codemods on the system\n    repository.refresh();\n\n    return repository;\n  }\n\n  private async safeRunAndReport(codemods: Codemod.List) {\n    if (this.isDry) {\n      this.logger?.warn?.(\n        'Running the codemods in dry mode. No files will be modified during the process.'\n      );\n    }\n\n    try {\n      const reports = await this.project.runCodemods(codemods, { dry: this.isDry });\n\n      this.logger?.raw?.(f.reports(reports));\n\n      if (!this.isDry) {\n        const nbAffectedTotal = reports\n          .flatMap((report) => report.report.ok)\n          .reduce((acc, nb) => acc + nb, 0);\n\n        this.logger?.debug?.(\n          `Successfully ran ${f.highlight(codemods.length)} codemod(s), ${f.highlight(nbAffectedTotal)} change(s) have been detected`\n        );\n      }\n\n      return successReport();\n    } catch (e: unknown) {\n      return erroredReport(unknownToError(e));\n    }\n  }\n\n  async runByUID(uid: string, codemodsDirectory?: string): Promise<CodemodRunnerReport> {\n    const repository = this.createRepository(codemodsDirectory);\n\n    if (!repository.has(uid)) {\n      throw new Error(`Unknown codemod UID provided: ${uid}`);\n    }\n\n    // Note: Ignore the range when running with a UID\n    const codemods = repository.find({ uids: [uid] }).flatMap(({ codemods }) => codemods);\n\n    return this.safeRunAndReport(codemods);\n  }\n\n  async run(codemodsDirectory?: string): Promise<CodemodRunnerReport> {\n    const repository = this.createRepository(codemodsDirectory);\n\n    // Find codemods matching the given range\n    const codemodsInRange = repository.find({ range: this.range });\n\n    // If a selection callback is set, use it, else keep every codemods found\n    const selectedCodemods = this.selectCodemodsCallback\n      ? await this.selectCodemodsCallback(codemodsInRange)\n      : codemodsInRange;\n\n    // If no codemods have been selected (either manually or automatically)\n    // Then ignore and return a successful report\n    if (selectedCodemods.length === 0) {\n      this.logger?.debug?.(`Found no codemods to run for ${f.versionRange(this.range)}`);\n      return successReport();\n    }\n\n    // Flatten the collection to a single list of codemods, the original list should already be sorted by version\n    const codemods = selectedCodemods.flatMap(({ codemods }) => codemods);\n\n    // Log (debug) the codemods by version\n    const codemodsByVersion = groupBy('version', codemods);\n    const fRange = f.versionRange(this.range);\n\n    this.logger?.debug?.(\n      `Found ${f.highlight(codemods.length)} codemods for ${f.highlight(size(codemodsByVersion))} version(s) using ${fRange}`\n    );\n\n    for (const [version, codemods] of Object.entries(codemodsByVersion)) {\n      this.logger?.debug?.(`- ${f.version(semVerFactory(version))} (${codemods.length})`);\n    }\n\n    return this.safeRunAndReport(codemods);\n  }\n}\n\nexport const codemodRunnerFactory = (project: Project, range: Version.Range) => {\n  return new CodemodRunner(project, range);\n};\n\nconst successReport = (): UpgradeReport => ({ success: true, error: null });\nconst erroredReport = (error: Error): UpgradeReport => ({ success: false, error });\n"],"names":["CodemodRunner","setRange","range","setLogger","logger","onSelectCodemods","callback","selectCodemodsCallback","dry","enabled","isDry","createRepository","codemodsDirectory","repository","codemodRepositoryFactory","codemodRepositoryConstants","refresh","safeRunAndReport","codemods","warn","reports","project","runCodemods","raw","f","nbAffectedTotal","flatMap","report","ok","reduce","acc","nb","debug","length","successReport","e","erroredReport","unknownToError","runByUID","uid","has","Error","find","uids","run","codemodsInRange","selectedCodemods","codemodsByVersion","groupBy","fRange","size","version","Object","entries","semVerFactory","constructor","codemodRunnerFactory","success","error"],"mappings":"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"}

package/dist/src/modules/codemod-runner/codemod-runner.mjs

@@ -0,0 +1,110 @@
+import { groupBy, size } from 'lodash/fp';
+import { codemodRepositoryFactory } from '../codemod-repository/repository.mjs';
+import { INTERNAL_CODEMODS_DIRECTORY } from '../codemod-repository/constants.mjs';
+import { unknownToError } from '../error/utils.mjs';
+import { semVerFactory } from '../version/semver.mjs';
+import 'semver';
+import '../version/types.mjs';
+import { reports, highlight, versionRange, version } from '../format/formats.mjs';
+
+class CodemodRunner {
+    setRange(range) {
+        this.range = range;
+        return this;
+    }
+    setLogger(logger) {
+        this.logger = logger;
+        return this;
+    }
+    onSelectCodemods(callback) {
+        this.selectCodemodsCallback = callback;
+        return this;
+    }
+    dry(enabled = true) {
+        this.isDry = enabled;
+        return this;
+    }
+    createRepository(codemodsDirectory) {
+        const repository = codemodRepositoryFactory(codemodsDirectory ?? INTERNAL_CODEMODS_DIRECTORY);
+        // Make sure we have access to the latest snapshots of codemods on the system
+        repository.refresh();
+        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.');
+        }
+        try {
+            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();
+        } catch (e) {
+            return erroredReport(unknownToError(e));
+        }
+    }
+    async runByUID(uid, codemodsDirectory) {
+        const repository = this.createRepository(codemodsDirectory);
+        if (!repository.has(uid)) {
+            throw new Error(`Unknown codemod UID provided: ${uid}`);
+        }
+        // Note: Ignore the range when running with a UID
+        const codemods = repository.find({
+            uids: [
+                uid
+            ]
+        }).flatMap(({ codemods })=>codemods);
+        return this.safeRunAndReport(codemods);
+    }
+    async run(codemodsDirectory) {
+        const repository = this.createRepository(codemodsDirectory);
+        // Find codemods matching the given range
+        const codemodsInRange = repository.find({
+            range: this.range
+        });
+        // If a selection callback is set, use it, else keep every codemods found
+        const selectedCodemods = this.selectCodemodsCallback ? await this.selectCodemodsCallback(codemodsInRange) : codemodsInRange;
+        // If no codemods have been selected (either manually or automatically)
+        // Then ignore and return a successful report
+        if (selectedCodemods.length === 0) {
+            this.logger?.debug?.(`Found no codemods to run for ${versionRange(this.range)}`);
+            return successReport();
+        }
+        // Flatten the collection to a single list of codemods, the original list should already be sorted by version
+        const codemods = selectedCodemods.flatMap(({ codemods })=>codemods);
+        // Log (debug) the codemods by version
+        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, codemods] of Object.entries(codemodsByVersion)){
+            this.logger?.debug?.(`- ${version(semVerFactory(version$1))} (${codemods.length})`);
+        }
+        return this.safeRunAndReport(codemods);
+    }
+    constructor(project, range){
+        this.project = project;
+        this.range = range;
+        this.isDry = false;
+        this.logger = null;
+        this.selectCodemodsCallback = null;
+    }
+}
+const codemodRunnerFactory = (project, range)=>{
+    return new CodemodRunner(project, range);
+};
+const successReport = ()=>({
+        success: true,
+        error: null
+    });
+const erroredReport = (error)=>({
+        success: false,
+        error
+    });
+
+export { CodemodRunner, codemodRunnerFactory };
+//# sourceMappingURL=codemod-runner.mjs.map

package/dist/src/modules/codemod-runner/codemod-runner.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemod-runner.mjs","sources":["../../../../src/modules/codemod-runner/codemod-runner.ts"],"sourcesContent":["import { groupBy, size } from 'lodash/fp';\n\nimport {\n  codemodRepositoryFactory,\n  constants as codemodRepositoryConstants,\n} from '../codemod-repository';\nimport { unknownToError } from '../error';\nimport { semVerFactory } from '../version';\nimport * as f from '../format';\n\nimport type { Codemod } from '../codemod';\nimport type { Logger } from '../logger';\nimport type { Project } from '../project';\nimport type { UpgradeReport } from '../upgrader';\nimport type { CodemodRunnerInterface, CodemodRunnerReport, SelectCodemodsCallback } from './types';\nimport type { Version } from '../version';\n\nexport class CodemodRunner implements CodemodRunnerInterface {\n  private readonly project: Project;\n\n  private range: Version.Range;\n\n  private isDry: boolean;\n\n  private logger: Logger | null;\n\n  private selectCodemodsCallback: SelectCodemodsCallback | null;\n\n  constructor(project: Project, range: Version.Range) {\n    this.project = project;\n    this.range = range;\n\n    this.isDry = false;\n\n    this.logger = null;\n    this.selectCodemodsCallback = null;\n  }\n\n  setRange(range: Version.Range) {\n    this.range = range;\n    return this;\n  }\n\n  setLogger(logger: Logger) {\n    this.logger = logger;\n    return this;\n  }\n\n  onSelectCodemods(callback: SelectCodemodsCallback | null) {\n    this.selectCodemodsCallback = callback;\n    return this;\n  }\n\n  dry(enabled: boolean = true) {\n    this.isDry = enabled;\n    return this;\n  }\n\n  private createRepository(codemodsDirectory?: string) {\n    const repository = codemodRepositoryFactory(\n      codemodsDirectory ?? codemodRepositoryConstants.INTERNAL_CODEMODS_DIRECTORY\n    );\n\n    // Make sure we have access to the latest snapshots of codemods on the system\n    repository.refresh();\n\n    return repository;\n  }\n\n  private async safeRunAndReport(codemods: Codemod.List) {\n    if (this.isDry) {\n      this.logger?.warn?.(\n        'Running the codemods in dry mode. No files will be modified during the process.'\n      );\n    }\n\n    try {\n      const reports = await this.project.runCodemods(codemods, { dry: this.isDry });\n\n      this.logger?.raw?.(f.reports(reports));\n\n      if (!this.isDry) {\n        const nbAffectedTotal = reports\n          .flatMap((report) => report.report.ok)\n          .reduce((acc, nb) => acc + nb, 0);\n\n        this.logger?.debug?.(\n          `Successfully ran ${f.highlight(codemods.length)} codemod(s), ${f.highlight(nbAffectedTotal)} change(s) have been detected`\n        );\n      }\n\n      return successReport();\n    } catch (e: unknown) {\n      return erroredReport(unknownToError(e));\n    }\n  }\n\n  async runByUID(uid: string, codemodsDirectory?: string): Promise<CodemodRunnerReport> {\n    const repository = this.createRepository(codemodsDirectory);\n\n    if (!repository.has(uid)) {\n      throw new Error(`Unknown codemod UID provided: ${uid}`);\n    }\n\n    // Note: Ignore the range when running with a UID\n    const codemods = repository.find({ uids: [uid] }).flatMap(({ codemods }) => codemods);\n\n    return this.safeRunAndReport(codemods);\n  }\n\n  async run(codemodsDirectory?: string): Promise<CodemodRunnerReport> {\n    const repository = this.createRepository(codemodsDirectory);\n\n    // Find codemods matching the given range\n    const codemodsInRange = repository.find({ range: this.range });\n\n    // If a selection callback is set, use it, else keep every codemods found\n    const selectedCodemods = this.selectCodemodsCallback\n      ? await this.selectCodemodsCallback(codemodsInRange)\n      : codemodsInRange;\n\n    // If no codemods have been selected (either manually or automatically)\n    // Then ignore and return a successful report\n    if (selectedCodemods.length === 0) {\n      this.logger?.debug?.(`Found no codemods to run for ${f.versionRange(this.range)}`);\n      return successReport();\n    }\n\n    // Flatten the collection to a single list of codemods, the original list should already be sorted by version\n    const codemods = selectedCodemods.flatMap(({ codemods }) => codemods);\n\n    // Log (debug) the codemods by version\n    const codemodsByVersion = groupBy('version', codemods);\n    const fRange = f.versionRange(this.range);\n\n    this.logger?.debug?.(\n      `Found ${f.highlight(codemods.length)} codemods for ${f.highlight(size(codemodsByVersion))} version(s) using ${fRange}`\n    );\n\n    for (const [version, codemods] of Object.entries(codemodsByVersion)) {\n      this.logger?.debug?.(`- ${f.version(semVerFactory(version))} (${codemods.length})`);\n    }\n\n    return this.safeRunAndReport(codemods);\n  }\n}\n\nexport const codemodRunnerFactory = (project: Project, range: Version.Range) => {\n  return new CodemodRunner(project, range);\n};\n\nconst successReport = (): UpgradeReport => ({ success: true, error: null });\nconst erroredReport = (error: Error): UpgradeReport => ({ success: false, error });\n"],"names":["CodemodRunner","setRange","range","setLogger","logger","onSelectCodemods","callback","selectCodemodsCallback","dry","enabled","isDry","createRepository","codemodsDirectory","repository","codemodRepositoryFactory","codemodRepositoryConstants","refresh","safeRunAndReport","codemods","warn","reports","project","runCodemods","raw","f","nbAffectedTotal","flatMap","report","ok","reduce","acc","nb","debug","length","successReport","e","erroredReport","unknownToError","runByUID","uid","has","Error","find","uids","run","codemodsInRange","selectedCodemods","codemodsByVersion","groupBy","fRange","size","version","Object","entries","semVerFactory","constructor","codemodRunnerFactory","success","error"],"mappings":"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"}

package/dist/src/modules/error/index.js

@@ -0,0 +1,11 @@
+'use strict';
+
+var utils = require('./utils.js');
+
+
+
+exports.AbortedError = utils.AbortedError;
+exports.NPMCandidateNotFoundError = utils.NPMCandidateNotFoundError;
+exports.UnexpectedError = utils.UnexpectedError;
+exports.unknownToError = utils.unknownToError;
+//# sourceMappingURL=index.js.map

package/dist/src/modules/error/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}

package/dist/src/modules/error/index.mjs

@@ -0,0 +1,2 @@
+export { AbortedError, NPMCandidateNotFoundError, UnexpectedError, unknownToError } from './utils.mjs';
+//# sourceMappingURL=index.mjs.map

package/dist/src/modules/error/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/src/modules/error/utils.js

@@ -0,0 +1,33 @@
+'use strict';
+
+class UnexpectedError extends Error {
+    constructor(){
+        super('Unexpected Error');
+    }
+}
+class NPMCandidateNotFoundError extends Error {
+    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();
+};
+
+exports.AbortedError = AbortedError;
+exports.NPMCandidateNotFoundError = NPMCandidateNotFoundError;
+exports.UnexpectedError = UnexpectedError;
+exports.unknownToError = unknownToError;
+//# sourceMappingURL=utils.js.map

package/dist/src/modules/error/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../../../../src/modules/error/utils.ts"],"sourcesContent":["import type { Version } from '../version';\n\nexport class UnexpectedError extends Error {\n  constructor() {\n    super('Unexpected Error');\n  }\n}\n\nexport class NPMCandidateNotFoundError extends Error {\n  target: Version.SemVer | Version.Range | Version.ReleaseType;\n\n  constructor(\n    target: Version.SemVer | Version.Range | Version.ReleaseType,\n    message: string = `Couldn't find a valid NPM candidate for \"${target}\"`\n  ) {\n    super(message);\n\n    this.target = target;\n  }\n}\n\nexport class AbortedError extends Error {\n  constructor(message: string = 'Upgrade aborted') {\n    super(message);\n  }\n}\n\nexport const unknownToError = (e: unknown): Error => {\n  if (e instanceof Error) {\n    return e;\n  }\n\n  if (typeof e === 'string') {\n    return new Error(e);\n  }\n\n  return new UnexpectedError();\n};\n"],"names":["UnexpectedError","Error","constructor","NPMCandidateNotFoundError","target","message","AbortedError","unknownToError","e"],"mappings":";;AAEO,MAAMA,eAAwBC,SAAAA,KAAAA,CAAAA;IACnCC,WAAc,EAAA;AACZ,QAAA,KAAK,CAAC,kBAAA,CAAA;AACR;AACF;AAEO,MAAMC,yBAAkCF,SAAAA,KAAAA,CAAAA;IAG7CC,WACEE,CAAAA,MAA4D,EAC5DC,OAAkB,GAAA,CAAC,yCAAyC,EAAED,MAAAA,CAAO,CAAC,CAAC,CACvE;AACA,QAAA,KAAK,CAACC,OAAAA,CAAAA;QAEN,IAAI,CAACD,MAAM,GAAGA,MAAAA;AAChB;AACF;AAEO,MAAME,YAAqBL,SAAAA,KAAAA,CAAAA;IAChCC,WAAYG,CAAAA,OAAAA,GAAkB,iBAAiB,CAAE;AAC/C,QAAA,KAAK,CAACA,OAAAA,CAAAA;AACR;AACF;AAEO,MAAME,iBAAiB,CAACC,CAAAA,GAAAA;AAC7B,IAAA,IAAIA,aAAaP,KAAO,EAAA;QACtB,OAAOO,CAAAA;AACT;IAEA,IAAI,OAAOA,MAAM,QAAU,EAAA;AACzB,QAAA,OAAO,IAAIP,KAAMO,CAAAA,CAAAA,CAAAA;AACnB;AAEA,IAAA,OAAO,IAAIR,eAAAA,EAAAA;AACb;;;;;;;"}