index.ts

import path from 'path';
import { readFileSync } from 'fs';
import { fileURLToPath } from 'url';
import chalk from 'chalk';
import { Command, Option, CommanderError } from 'commander';

import main from './main.js';
import list from './list.js';
import init from './init.js';
import validate from './validate.js';
import { InvalidUserInputError, InvalidConfigError } from './errors.js';

const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);

const packageJson = readFileSync(
  path.join(__dirname, '..', 'package.json'),
  'utf-8',
);

const program = new Command();

program
  .enablePositionalOptions()
  .version(JSON.parse(packageJson).version, '-v, --version')
  .name('hypermod')
  .argument('[path...]')
  .usage('[global options] <file-paths>...')
  .option(
    '--packages <value>',
    'Comma separated list of packages to run transforms for, @scope/package[@version]. If version is supplied, will only run transforms for that version and above',
  )
  .option(
    '-s, --sequence',
    'If the package flag is provided, runs all transforms from the provided version to the latest',
  )
  .option(
    '-t, --transform <value>',
    'The transform(s) to run, will prompt for a transform if not provided and no module is passed\nTo provide multiple transforms, separate them with commas (e.g. "-t t1,t2,t3")',
  )
  .addOption(
    new Option(
      '-p, --parser <parser>',
      'Parser to use for parsing the source files',
    )
      .choices(['babel', 'babylon', 'ts', 'tsx'])
      .default('tsx'),
  )
  .option(
    '-e, --extensions <value>',
    'Transform files with these file extensions (comma separated list)',
    'js,jsx,ts,tsx',
  )
  .option(
    '--ignore-pattern <value>',
    'Ignore files that match a provided glob expression',
    '**/node_modules/**',
  )
  .option(
    '-c, --cpus <value>',
    'Start at most N child processes to process source files',
  )
  .option('-d, --dry', 'dry run (no changes are made to files)')
  .option('--run-in-band', 'run serially in the current process')
  .option(
    '--registry <value>',
    'Define a registry where the package should be fetched from',
  )
  .option(
    '--registryToken <value>',
    'Define an authentication token to use as credentials for the registry',
  )
  .option(
    '--experimental-loader',
    'Enables the experimental package downloader',
  )
  .addOption(
    new Option(
      '--verbose <parser>',
      'Show more information about the transform process',
    )
      .choices(['0', '1', '2'])
      .default('0'),
  )
  .addHelpText(
    'after',
    `
Examples:
  # Run a transform for "@mylib/button" version 3.0.0 only
  $ hypermod --packages @mylib/button@3.0.0 /project/src

  # Run all transforms for "@mylib/button" greater than version 3.0.0 and @mylib/range greater than 4.0.0
  $ hypermod --sequence --packages @mylib/button@3.0.0,@mylib/range@4.0.0 /project/src

  # Run the "my-custom-transform" transform
  $ hypermod -t path/to/my-custom-transform /project/src

  # Display a prompt with a list of codemods from my local \`hypermod.config.js\` file(s).
  $ hypermod /project/src`,
  )
  .action((path, options) => main(path, options));

program
  .command('list <package-names...>')
  .description('list available codemods for provided packages')
  .action(packageNames => list(packageNames))
  .addHelpText(
    'after',
    `
Examples:
  # Print a list of available codemods for a single package
  $ hypermod list mylib

  # Print a list of available codemods for multiple packages
  $ hypermod list @atlaskit/avatar @emotion/monorepo`,
  );

program
  .command('init [path]')
  .description('creates a new hypermod package')
  .option('-c, --config-only', 'Output only a configuration file')
  .option('-t, --transform <value>', 'Transform version')
  .option('-p, --preset <value>', 'Preset transfrom')
  .action((path, options) =>
    init(options.transform, options.preset, options.configOnly, path),
  )
  .addHelpText(
    'after',
    `
Examples:
  # Initializes an empty hypermod package at the current directory
  $ hypermod init --transform 10.0.0 my-codemod-package

  # Initializes an empty hypermod package at the current directory
  $ hypermod init --transform 10.0.0 .

  # Initializes a new hypermod package with a transform for 10.0.0 at the foobar dir
  $ hypermod init --transform 10.0.0 ~/foobar

  # Initializes a new hypermod package with a preset "update-imports"
  $ hypermod init --package-name foobar --preset update-imports foobar

  # Initializes a configuration file only
  $ hypermod init --config-only --preset update-imports path/to/src`,
  );

program
  .command('validate [path]')
  .description('validates if a hypermod package is publishable')
  .action(path => validate(path))
  .addHelpText(
    'after',
    `
Examples:
  $ hypermod validate
  $ hypermod validate ./codemods/my-codemods`,
  );

(async function () {
  try {
    await program.parseAsync(process.argv);
  } catch (error: any) {
    if (error instanceof CommanderError) {
      if (
        error.code === 'commander.helpDisplayed' ||
        error.code === 'commander.version'
      ) {
        return;
      }

      console.error(chalk.red(error.message));
      process.exit(error.exitCode);
    }

    if (error instanceof InvalidUserInputError) {
      console.warn(chalk.red(error.message));
      console.warn(program.help());
      process.exit(9);
    }

    if (error instanceof InvalidConfigError) {
      console.warn(chalk.red(error.message));
      process.exit(7);
    }

    console.error(chalk.red(error));
    console.log(error);
    process.exit(1);
  }
})();