feat: add upgrade command

commands/transform.ts

@@ -4,11 +4,7 @@ import { run as jscodeshift } from 'jscodeshift/src/Runner'
 import { bold } from 'picocolors'
 import prompts from 'prompts'
 import { TRANSFORM_OPTIONS } from '../config'
-
-export function onCancel() {
-  console.info('> Cancelled process. Program will stop now without any actions. \n')
-  process.exit(1)
-}
+import { onCancel, promptSource } from '../utils/share'
 
 const transformerDirectory = join(__dirname, '../', 'transforms')
 
@@ -32,20 +28,6 @@ const selectCodemod = async (): Promise<string> => {
   return res.transformer
 }
 
-const selectSource = async (): Promise<string> => {
-  const res = await prompts(
-    {
-      type: 'text',
-      name: 'path',
-      message: 'Which files or directories should the codemods be applied to?',
-      initial: '.',
-    },
-    { onCancel },
-  )
-
-  return res.path
-}
-
 export async function transform(codemodName?: string, source?: string, options?: Record<string, unknown>) {
   const existCodemod = TRANSFORM_OPTIONS.find(({ value }) => value === codemodName)
   const codemodSelected = !codemodName || (codemodName && !existCodemod) ? await selectCodemod() : codemodName
@@ -55,7 +37,7 @@ export async function transform(codemodName?: string, source?: string, options?:
     process.exit(1)
   }
 
-  const sourceSelected = source || (await selectSource())
+  const sourceSelected = source || (await promptSource('Which files or directories should the codemods be applied to?'))
 
   if (!sourceSelected) {
     console.info('> Source path for project is not selected. Exits the program. \n')

commands/upgrade.ts

@@ -0,0 +1,107 @@
+import { readFile } from 'node:fs/promises'
+import { join, resolve } from 'node:path'
+import type { Options } from 'jscodeshift'
+import { run as jscodeshift } from 'jscodeshift/src/Runner'
+import prompts from 'prompts'
+import { coerce, compare } from 'semver'
+import { TRANSFORM_OPTIONS } from '../config'
+import { onCancel, promptSource } from '../utils/share'
+
+const transformerDirectory = join(__dirname, '../', 'transforms')
+
+export async function upgrade(source?: string) {
+  const sourceSelected = source || (await promptSource('Which directory should the codemods be applied to?'))
+
+  if (!sourceSelected) {
+    console.info('> Source path for project is not selected. Exits the program. \n')
+    process.exit(1)
+  }
+
+  try {
+    const packageJsonPath = resolve(sourceSelected || '', 'package.json')
+    const packageJson = JSON.parse(await readFile(packageJsonPath, 'utf8'))
+
+    const codemods = suggestCodemods(packageJson)
+
+    if (codemods.length === 0) {
+      console.info('> No codemods are suggested for this project. \n')
+
+      return
+    }
+
+    const { codemodsSelected } = await prompts(
+      {
+        type: 'multiselect',
+        name: 'codemodsSelected',
+        message: `The following 'codemods' are recommended for your upgrade. Select the ones to apply.`,
+        choices: codemods.map(({ description, value, version }) => {
+          return {
+            title: `(v${version}) ${value}`,
+            description,
+            value,
+            selected: true,
+          }
+        }),
+      },
+      { onCancel },
+    )
+
+    const args: Options = {
+      dry: false,
+      babel: false,
+      silent: true,
+      ignorePattern: '**/node_modules/**',
+      extensions: 'cts,mts,ts,js,mjs,cjs',
+    }
+
+    const results = {
+      ok: 0,
+      skipped: 0,
+      failed: 0,
+      unmodified: 0,
+    }
+
+    for (const codemod of codemodsSelected) {
+      const transformerPath = require.resolve(`${transformerDirectory}/${codemod}.js`)
+
+      console.log(`> Applying codemod: ${codemod}`)
+      const { ok, skip, error, nochange } = await jscodeshift(transformerPath, [resolve(sourceSelected)], args)
+
+      results.ok += ok
+      results.skipped += skip
+      results.failed += error
+      results.unmodified += nochange
+    }
+
+    console.log('\n> Summary of the upgrade')
+    console.log(`> ${results.ok} codemods were applied successfully`)
+    console.log(`> ${results.skipped} codemods were skipped`)
+    console.log(`> ${results.failed} codemods failed`)
+    console.log(`> ${results.unmodified} codemods were skipped because they didn't change anything`)
+  } catch (err) {
+    if (err.code === 'ENOENT') {
+      console.info('> No package.json found in the selected directory. \n')
+      process.exit(1)
+    } else {
+      console.error(err.message)
+    }
+  }
+}
+
+function suggestCodemods(packageJson) {
+  const { dependencies } = packageJson
+
+  if (dependencies?.express == null) {
+    console.info('> No express dependency found in package.json. \n')
+
+    process.exit(0)
+  }
+
+  const expressVersion = coerce(dependencies.express)?.version ?? '4.0.0'
+
+  const codemodsSuggested = TRANSFORM_OPTIONS.filter((a) => {
+    return compare(a.version, expressVersion) > 0
+  })
+
+  return codemodsSuggested
+}

index.ts

@@ -5,6 +5,7 @@
 
 import { Command } from 'commander'
 import { transform } from './commands/transform'
+import { upgrade } from './commands/upgrade'
 import packageJson from './package.json'
 
 const program = new Command(packageJson.name)
@@ -22,4 +23,10 @@ const program = new Command(packageJson.name)
   // Why this option is necessary is explained here: https://github.com/tj/commander.js/pull/1427
   .enablePositionalOptions()
 
+program
+  .command('upgrade')
+  .description('Upgrade your express server to the latest version.')
+  .argument('[source]', 'Path to source files or directory to transform.')
+  .action(upgrade)
+
 program.parse(process.argv)

package.json

@@ -21,14 +21,16 @@
     "fast-glob": "^3.3.2",
     "jscodeshift": "^17.1.1",
     "picocolors": "^1.1.1",
-    "prompts": "^2.4.2"
+    "prompts": "^2.4.2",
+    "semver": "^7.6.3"
   },
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
     "@types/jest": "29.5.14",
     "@types/jscodeshift": "^0.12.0",
     "@types/node": "^22.8.1",
     "@types/prompts": "2.4.9",
+    "@types/semver": "^7.5.8",
     "jest": "29.7.0",
     "ts-jest": "29.2.5",
     "typescript": "5.6.3"

utils/share.ts

@@ -0,0 +1,20 @@
+import prompts from 'prompts'
+
+export function onCancel() {
+  console.info('> Cancelled process. Program will stop now without any actions. \n')
+  process.exit(1)
+}
+
+export const promptSource = async (message: string): Promise<string> => {
+  const res = await prompts(
+    {
+      type: 'text',
+      name: 'path',
+      message,
+      initial: '.',
+    },
+    { onCancel },
+  )
+
+  return res.path
+}