feat: add parseFlags for non-interactive CLI mode

Author: dmitriyeff

src/cli.test.ts

@@ -70,3 +70,77 @@ describe('dispatchSubcommand', () => {
 		expect(await dispatchExists(join(dispatchTmpDir, 'src/app-extensions/panel/index.ts'))).toBe(true);
 	});
 });
+
+describe('parseFlags', () => {
+	it('returns empty partial when no flags are present', async () => {
+		const { parseFlags } = await import('./cli.js');
+		expect(parseFlags(['node', 'cli.js'])).toEqual({});
+	});
+
+	it('parses --project-name', async () => {
+		const { parseFlags } = await import('./cli.js');
+		expect(parseFlags(['node', 'cli.js', '--project-name', 'my-app'])).toMatchObject({ nameOrPath: 'my-app' });
+	});
+
+	it('parses --database postgres', async () => {
+		const { parseFlags } = await import('./cli.js');
+		expect(parseFlags(['node', 'cli.js', '--database', 'postgres'])).toMatchObject({ database: 'postgres' });
+	});
+
+	it('parses --database mysql', async () => {
+		const { parseFlags } = await import('./cli.js');
+		expect(parseFlags(['node', 'cli.js', '--database', 'mysql'])).toMatchObject({ database: 'mysql' });
+	});
+
+	it('parses --database sqlite', async () => {
+		const { parseFlags } = await import('./cli.js');
+		expect(parseFlags(['node', 'cli.js', '--database', 'sqlite'])).toMatchObject({ database: 'sqlite' });
+	});
+
+	it('throws on invalid --database', async () => {
+		const { parseFlags } = await import('./cli.js');
+		expect(() => parseFlags(['node', 'cli.js', '--database', 'oracle'])).toThrow(
+			'Invalid database "oracle". Choose one of: postgres, mysql, sqlite.',
+		);
+	});
+
+	it('parses --app-extensions none as empty array', async () => {
+		const { parseFlags } = await import('./cli.js');
+		expect(parseFlags(['node', 'cli.js', '--app-extensions', 'none'])).toMatchObject({ appExtensions: [] });
+	});
+
+	it('parses --app-extensions custom-panel', async () => {
+		const { parseFlags } = await import('./cli.js');
+		expect(parseFlags(['node', 'cli.js', '--app-extensions', 'custom-panel'])).toMatchObject({
+			appExtensions: ['custom-panel'],
+		});
+	});
+
+	it('parses --app-extensions custom-panel,custom-modal', async () => {
+		const { parseFlags } = await import('./cli.js');
+		expect(parseFlags(['node', 'cli.js', '--app-extensions', 'custom-panel,custom-modal'])).toMatchObject({
+			appExtensions: ['custom-panel', 'custom-modal'],
+		});
+	});
+
+	it('throws on invalid --app-extensions value', async () => {
+		const { parseFlags } = await import('./cli.js');
+		expect(() => parseFlags(['node', 'cli.js', '--app-extensions', 'custom-widget'])).toThrow(
+			'Invalid app extension type "custom-widget". Choose from: custom-panel, custom-modal.',
+		);
+	});
+
+	it('throws on --project-name with empty value', async () => {
+		const { parseFlags } = await import('./cli.js');
+		expect(() => parseFlags(['node', 'cli.js', '--project-name', '   '])).toThrow(
+			'--project-name cannot be empty.',
+		);
+	});
+
+	it('parses all three flags together', async () => {
+		const { parseFlags } = await import('./cli.js');
+		expect(
+			parseFlags(['node', 'cli.js', '--project-name', 'my-app', '--database', 'sqlite', '--app-extensions', 'none']),
+		).toEqual({ nameOrPath: 'my-app', database: 'sqlite', appExtensions: [] });
+	});
+});

src/cli.ts

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import * as clack from '@clack/prompts';
 import { realpathSync } from 'node:fs';
 import { basename, resolve } from 'node:path';
@@ -7,7 +8,7 @@ import { promptDatabase } from './prompts/database.js';
 import { promptProjectName } from './prompts/projectName.js';
 import { nodeGenerator } from './generators/node/index.js';
 import { addAppExtension } from './subcommands/addAppExtension.js';
-import type { AppExtensionType } from './generators/interface.js';
+import type { AppExtensionType, Database } from './generators/interface.js';
 import { isAppExtensionType } from './generators/interface.js';
 
 interface NextStepOptions {
@@ -47,6 +48,54 @@ export function isCliEntrypoint(
 	}
 }
 
+interface ParsedFlags {
+	nameOrPath?: string;
+	database?: Database;
+	appExtensions?: AppExtensionType[];
+}
+
+export function parseFlags(argv: string[]): ParsedFlags {
+	const result: ParsedFlags = {};
+
+	const nameIdx = argv.indexOf('--project-name');
+	if (nameIdx !== -1) {
+		const value = argv[nameIdx + 1];
+		if (!value || value.startsWith('--')) throw new Error('--project-name requires a value.');
+		if (!value.trim()) throw new Error('--project-name cannot be empty.');
+		result.nameOrPath = value.trim();
+	}
+
+	const dbIdx = argv.indexOf('--database');
+	if (dbIdx !== -1) {
+		const value = argv[dbIdx + 1];
+		if (!value || value.startsWith('--')) throw new Error('--database requires a value.');
+		const valid: Database[] = ['postgres', 'mysql', 'sqlite'];
+		if (!valid.includes(value as Database)) {
+			throw new Error(`Invalid database "${value}". Choose one of: postgres, mysql, sqlite.`);
+		}
+		result.database = value as Database;
+	}
+
+	const extIdx = argv.indexOf('--app-extensions');
+	if (extIdx !== -1) {
+		const value = argv[extIdx + 1];
+		if (!value || value.startsWith('--')) throw new Error('--app-extensions requires a value.');
+		if (value === 'none') {
+			result.appExtensions = [];
+		} else {
+			const types = value.split(',');
+			for (const type of types) {
+				if (!isAppExtensionType(type)) {
+					throw new Error(`Invalid app extension type "${type}". Choose from: custom-panel, custom-modal.`);
+				}
+			}
+			result.appExtensions = types as AppExtensionType[];
+		}
+	}
+
+	return result;
+}
+
 export async function dispatchSubcommand(argv: string[]): Promise<boolean> {
 	const subcommand = argv[2];
 	const outputDirIdx = argv.indexOf('--output-dir');