feat(cli): add start command (#2501)

* feat(cli): add start command

* fix: pass port to execa command

* chore: add test

* refactor: handle error message correctly

* fix: add start to program test

Author: jorgemoya

packages/cli/src/commands/start.ts

@@ -0,0 +1,27 @@
+import { Command } from 'commander';
+import consola from 'consola';
+import { execa } from 'execa';
+import { join } from 'node:path';
+
+export const start = new Command('start')
+  .description('Start your Catalyst storefront in optimized production mode.')
+  .option('-p, --port <number>', 'Port to run the production server on (default: 3000).', '3000')
+  .option(
+    '--root-dir <path>',
+    'Path to the root directory of your Catalyst project (default: current working directory).',
+    process.cwd(),
+  )
+  .action(async (opts) => {
+    try {
+      const nextBin = join(opts.rootDir, 'node_modules', '.bin', 'next');
+
+      // @todo conditionally run `next start` or `opennextjs-cloudflare preview` based on the framework type
+      await execa(nextBin, ['start', '-p', opts.port], {
+        stdio: 'inherit',
+        cwd: opts.rootDir,
+      });
+    } catch (error) {
+      consola.error(error instanceof Error ? error.message : error);
+      process.exit(1);
+    }
+  });

packages/cli/src/program.ts

@@ -7,6 +7,7 @@ import PACKAGE_INFO from '../package.json';
 import { build } from './commands/build';
 import { deploy } from './commands/deploy';
 import { dev } from './commands/dev';
+import { start } from './commands/start';
 import { version } from './commands/version';
 
 export const program = new Command();
@@ -20,4 +21,5 @@ program
   .addCommand(build)
   .addCommand(deploy)
   .addCommand(dev)
-  .addCommand(version);
+  .addCommand(version)
+  .addCommand(start);

packages/cli/tests/commands/start.spec.ts

@@ -0,0 +1,44 @@
+import { Command } from 'commander';
+import { execa } from 'execa';
+import { expect, test, vi } from 'vitest';
+
+import { start } from '../../src/commands/start';
+import { program } from '../../src/program';
+
+vi.mock('execa', () => ({
+  execa: vi.fn(() => Promise.resolve({})),
+  __esModule: true,
+}));
+
+test('properly configured Command instance', () => {
+  expect(start).toBeInstanceOf(Command);
+  expect(start.name()).toBe('start');
+  expect(start.description()).toBe('Start your Catalyst storefront in optimized production mode.');
+  expect(start.options).toEqual(
+    expect.arrayContaining([
+      expect.objectContaining({ flags: '-p, --port <number>', defaultValue: '3000' }),
+      expect.objectContaining({ flags: '--root-dir <path>', defaultValue: process.cwd() }),
+    ]),
+  );
+});
+
+test('calls execa with Next.js production optimized server', async () => {
+  await program.parseAsync([
+    'node',
+    'catalyst',
+    'start',
+    '-p',
+    '3001',
+    '--root-dir',
+    '/path/to/root',
+  ]);
+
+  expect(execa).toHaveBeenCalledWith(
+    '/path/to/root/node_modules/.bin/next',
+    ['start', '-p', '3001'],
+    expect.objectContaining({
+      stdio: 'inherit',
+      cwd: '/path/to/root',
+    }),
+  );
+});

packages/cli/tests/index.spec.ts

@@ -18,5 +18,6 @@ describe('CLI program', () => {
     expect(commands).toContain('build');
     expect(commands).toContain('deploy');
     expect(commands).toContain('dev');
+    expect(commands).toContain('start');
   });
 });