xrelease/src/cli/commands/create.ts

xrelease (pronounced cross-release) helps you setup automated releases for your project for any language

import ora from 'ora';
import chalk from 'chalk';
import fs from 'fs/promises';
import { readConfig } from '../../core/config.js';
import { checkBranch } from '../../core/release/check-branch.js';
import { runPreReleaseChecks } from '../../core/release/pre-release-checks.js';
import { bumpVersion, type BumpType } from '../../core/release/bump-version.js';
import { generateChangelog } from '../../core/release/generate-changelog.js';
import { commitAndPush, createAndPushTag } from '../../core/git.js';
import { execa } from 'execa';
import { checkGitHubCLI, isGitHubCLIAuthenticated, createGitHubRelease } from '../../core/release/gh-cli.js';
import { glob } from 'glob';
import { updateVersionInFile } from '../../core/template.js';
import { runPreReleaseSteps } from '../../core/release/pre-release-steps.js';
import { runPostReleaseSteps } from '../../core/release/post-release-steps.js';

interface CreateOptions {
  bump?: BumpType;
  branch?: string;
  config?: string;
}

export async function createCommand(options: CreateOptions): Promise<void> {
  const spinner = ora();

  try {
    // Read config first to determine release process
    const config = await readConfig(options.config);

    // 1. Check current branch
    spinner.start('Checking current branch...');
    await checkBranch(options.branch, options.config);
    spinner.succeed('Branch check passed');

    // 2. Run pre-release checks
    spinner.start('Running pre-release checks...');
    await runPreReleaseChecks(options.config);
    spinner.succeed('Pre-release checks passed');

    // 3. Run pre-release steps
    spinner.start('Running pre-release steps...');
    await runPreReleaseSteps(options.config);
    spinner.succeed('Pre-release steps passed');

    // 4. Bump version
    spinner.start('Bumping version...');
    const newVersion = await bumpVersion(options.bump || config.release.defaultBump);
    spinner.succeed(`Version bumped to ${newVersion}`);

    // 4. Update version in configured files
    if (config.release.version?.files?.length) {
      spinner.start('Updating version in configured files...');
      for (const file of config.release.version.files) {
        try {
          await updateVersionInFile({
            path: file.path,
            pattern: file.pattern,
            template: file.template,
            version: newVersion,
          });
        } catch (error) {
          throw new Error(`Failed to update version in ${file.path}: ${error instanceof Error ? error.message : 'Unknown error'}`);
        }
      }
      spinner.succeed('Version updated in all configured files');
    }

    // 5. Generate changelog if enabled
    let changelogContent = '';
    if (config.release.changelog?.enabled) {
      spinner.start('Generating changelog...');
      await generateChangelog(newVersion, config.release.changelog.template);
      try {
        changelogContent = await fs.readFile('CHANGELOG.md', 'utf-8');
      } catch (error) {
        console.warn(chalk.yellow('Could not read changelog file, proceeding without changelog content'));
      }
      spinner.succeed('Changelog updated');
    }

    // 6. Run Release actions actions
    if (config.release.actions?.length) {
      for (const action of config.release.actions) {
        const actionName = action.name || action.type;
        spinner.start(`Running ${actionName}...`);

        switch (action.type) {
          case 'git-tag':
            await createAndPushTag(newVersion);
            break;
          case 'commit-push':
            await commitAndPush(newVersion);
            break;
          case 'github-release':
            // Check if gh CLI is available
            spinner.start('Checking GitHub CLI...');
            if (!(await checkGitHubCLI())) {
              throw new Error('GitHub CLI (gh) is required but not found. Please install it from: https://cli.github.com');
            }

            // Check if gh CLI is authenticated
            if (!(await isGitHubCLIAuthenticated())) {
              spinner.info('GitHub CLI needs authentication');
              console.log('\nPlease run: gh auth login');
              throw new Error('GitHub CLI authentication required');
            }
            spinner.succeed('GitHub CLI checks passed');

            // Find build artifacts if specified
            const assets = [];
            if (action.assets) {
              spinner.start('Collecting release assets...');
              const patterns = Array.isArray(action.assets) ? action.assets : [action.assets];
              for (const pattern of patterns) {
                const files = await glob(pattern);
                assets.push(...files);
              }
              spinner.succeed(`Found ${assets.length} release assets`);
            }

            // Create GitHub release
            spinner.start('Creating GitHub release...');
            await createGitHubRelease({
              version: newVersion,
              body: changelogContent,
              assets,
            });
            spinner.succeed('GitHub release created');
            break;
          case 'custom':
          default:
            if (action.command) {
              try {
                await execa(action.command, { shell: true });
              } catch (error) {
                throw new Error(`Custom action '${actionName}' failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
              }
            }
            break;
        }

        spinner.succeed(`${actionName} completed`);
      }
    }

    // 7. Run post-release steps
    spinner.start('Running post-release steps...');
    await runPostReleaseSteps(options.config);
    spinner.succeed('Post-release steps passed');

    console.log(chalk.green(`\n✨ Release v${newVersion} created successfully!`));
  } catch (error) {
    spinner.fail('Failed to create release');
    console.error(chalk.red(`\nError: ${error instanceof Error ? error.message : 'Unknown error'}`));
    process.exit(1);
  }
}