at-builder 1.4.4 → 1.5.0

package/src/index.ts

@@ -1,387 +0,0 @@
-#!/usr/bin/env node
-import { spawn } from "child_process";
-import path from "path";
-import fs from "fs";
-import { Command } from 'commander';
-import { getVersion, getHelpInfo, setupEnv } from "./constants/config";
-import { runDiagnostics, fixIssues } from "./services/doctor";
-import logger from "./services/logger";
-/**
- * Checks if the .env file exists at the current working directory
- *
- * @throws {Error} If the .env file is not found
- */
-const checkEnvFile = () => {
-    logger.info("checkEnvFile", "Checking if .env file exists at current working directory");
-    try {
-        // Check if the file exists and is readable
-        fs.accessSync(path.join(process.cwd(), ".env"), fs.constants.R_OK);
-        logger.info("checkEnvFile", ".env file found");
-    } catch (error) {
-        // If the file does not exist, provide helpful guidance
-        console.error('\x1b[31m%s\x1b[0m', `❌ Error: .env file not found at ${process.cwd()}`);
-        console.error('\x1b[33m%s\x1b[0m', '💡 Run "atb init" to create .env file or "atb doctor --fix" to diagnose and fix configuration issues.');
-        logger.error("checkEnvFile", `Error: Couldn't find .env file at location ${process.cwd()}`);
-        throw error;
-    }
-};
-
-// Prepare environment for spawning processes
-const productionEnv = {
-    ...process.env,
-    executionPath: process.cwd()
-};
-
-// Commander setup with proper subcommands
-const setupCommander = async () => {
-    logger.info("setupCommander", "Setting up commander");
-    const version = await getVersion();
-    const program = new Command();
-    
-    program
-        .name('atb')
-        .description('Adobe Target Activity Development CLI')
-        .version(version, "-V, --version")
-        .option("-v, --verbose", "Enable verbose logging");
-
-    // Add subcommands with proper actions
-    program
-        .command('init')
-        .description('Initialize project with .env configuration and templates')
-        .action(async (options, command) => {
-            const globalOpts = command.parent.opts();
-            await handleInit(globalOpts.verbose);
-        });
-
-    program
-        .command('new')
-        .description('Create a new Adobe Target activity with variations')
-        .action(async (options, command) => {
-            const globalOpts = command.parent.opts();
-            await handleNew(globalOpts.verbose);
-        });
-
-    program
-        .command('build')
-        .description('Build activity for development or production')
-        .option('--prod', 'Build for production deployment')
-        .action(async (options, command) => {
-            const globalOpts = command.parent.opts();
-            checkEnvFile();
-            await handleBuild(options.prod, globalOpts.verbose);
-        });
-
-    program
-        .command('dev')
-        .description('Start development server with file watching')
-        .option('--browser', 'Open in browser automatically')
-        .action(async (options, command) => {
-            const globalOpts = command.parent.opts();
-            checkEnvFile();
-            await handleDev(options.browser, globalOpts.verbose);
-        });
-
-    program
-        .command('deploy')
-        .description('Deploy activity to Adobe Target using at-deploy.js')
-        .option('--dry-run', 'Run deployment in dry-run mode without actual deployment')
-        .option('--force', 'Override the 60s post-deploy cooldown lock')
-        .action(async (options, command) => {
-            const globalOpts = command.parent.opts();
-            checkEnvFile();
-            await handleDeploy(options.dryRun, options.force, globalOpts.verbose);
-        });
-
-    program
-        .command('sync')
-        .description('Sync build.config.json with the Adobe Target activity definition')
-        .option('--scaffold', 'Auto-create missing variation folders with boilerplate')
-        .action(async (options, command) => {
-            const globalOpts = command.parent.opts();
-            checkEnvFile();
-            await handleSync(options.scaffold, globalOpts.verbose);
-        });
-
-    program
-        .command('doctor')
-        .description('Diagnose and fix project configuration issues')
-        .option('--fix', 'Automatically fix detected issues')
-        .action(async (options, command) => {
-            const globalOpts = command.parent.opts();
-            await handleDoctor(options.fix, globalOpts.verbose);
-        });
-
-    program
-        .command('install-extension')
-        .description('Install the at-builder VSCode extension from the Marketplace')
-        .option('--editor <bin>', 'Editor CLI to use (e.g. code, agy, cursor, codium)', 'code')
-        .action(async (options, command) => {
-            const globalOpts = command.parent.opts();
-            await handleInstallExtension(options.editor, globalOpts.verbose);
-        });
-
-    await program.parseAsync(process.argv);
-    
-    logger.info("setupCommander", "Commander setup complete");
-};
-
-
-
-/**
- * Spawn a command using `npm` with the given command array and environment object.
- *
- * Any entries in `scriptArgs` are forwarded to the underlying script via npm's
- * `--` passthrough (e.g. `npm run foo -- --dry-run`).
- *
- * @param commandArr - The array of command strings to pass to `npm`.
- * @param env - The environment object to pass to the spawned process.
- * @param scriptArgs - Optional flags/args to forward to the npm script itself.
- */
-const runCommand = (commandArr: string[], env: NodeJS.ProcessEnv, scriptArgs: string[] = []): void => {
-    const fullArgs = scriptArgs.length > 0
-        ? [...commandArr, "--", ...scriptArgs]
-        : commandArr;
-
-    logger.info("runCommand", `Running npm command [${fullArgs.join(", ")}]`);
-    logger.info("runCommand", `Current working directory: ${process.cwd()}`);
-
-    spawn("npm", fullArgs, {
-        cwd: path.join(__dirname, "../"),
-        env,
-        shell: true,
-        stdio: "inherit",
-    });
-};
-
-/**
- * Handles the init command
- */
-const handleInit = async (verbose: boolean): Promise<void> => {
-    if (verbose) logger.info("verbose", "Initializing new .env file");
-    
-    // Run npm init in the current working directory (where user ran atb init)
-    spawn("npm", ["init", "-y"], {
-        cwd: process.cwd(),
-        env: process.env,
-        shell: true,
-        stdio: "inherit",
-    });
-    
-    // Install @babel/runtime as dev dependency in the current directory
-    spawn("npm", ["install", "@babel/runtime", "-D"], {
-        cwd: process.cwd(),
-        env: process.env,
-        shell: true,
-        stdio: "inherit",
-    });
-    
-    setupEnv(process.cwd());
-};
-
-/**
- * Handles the new command
- */
-const handleNew = async (verbose: boolean): Promise<void> => {
-    if (verbose) logger.info("verbose", "Creating new activity");
-    runCommand(["run", "atb:plop:new:activity"], productionEnv);
-};
-
-/**
- * Handles the build command
- */
-const handleBuild = async (prod: boolean, verbose: boolean): Promise<void> => {
-    if (verbose) logger.info("verbose", `Building in ${prod ? 'production' : 'development'} mode`);
-    
-    if (prod) {
-        process.env['NODE_ENV'] = 'production';
-        logger.info("handleBuild", "Running build with production environment");
-        runCommand(['run', 'atb:build:prod'], productionEnv);
-    } else {
-        logger.info("handleBuild", "Running build with development environment");
-        runCommand(['run', 'atb:build:dev'], productionEnv);
-    }
-};
-
-/**
- * Handles the dev command
- */
-const handleDev = async (browser: boolean, verbose: boolean): Promise<void> => {
-    if (verbose) logger.info("verbose", `Starting development server with browser=${browser}`);
-    
-    const commandArr = ['run', browser ? 'atb:build:dev:puppeteer' : 'atb:build:dev'];
-    logger.info("handleDev", `Running command: ${commandArr.join(', ')}`);
-    
-    runCommand(commandArr, productionEnv);
-};
-
-/**
- * Handles the deploy command
- */
-const handleDeploy = async (dryRun: boolean, force: boolean, verbose: boolean): Promise<void> => {
-    if (verbose) logger.info("verbose", `Deploying to Adobe Target with dry-run=${dryRun} force=${force}`);
-
-    logger.info("handleDeploy", "Running Adobe Target deployment");
-
-    const scriptArgs: string[] = [];
-    if (dryRun) scriptArgs.push('--dry-run');
-    if (force) scriptArgs.push('--force');
-
-    runCommand(['run', 'atb:build:deploy'], productionEnv, scriptArgs);
-};
-
-/**
- * Handles the sync command
- */
-const handleSync = async (scaffold: boolean, verbose: boolean): Promise<void> => {
-    if (verbose) logger.info("verbose", `Syncing build.config.json with scaffold=${scaffold}`);
-
-    logger.info("handleSync", "Running Adobe Target sync");
-
-    const scriptArgs: string[] = [];
-    if (scaffold) scriptArgs.push('--scaffold');
-
-    runCommand(['run', 'atb:build:sync'], productionEnv, scriptArgs);
-};
-
-/**
- * Handles the install-extension command.
- *
- * Installs the at-builder VSCode extension from the VS Code Marketplace
- * using the editor's CLI. Defaults to `code`; users on Cursor/VSCodium
- * can pass --editor.
- */
-/**
- * Per-editor install hints for when the CLI binary isn't on PATH. Each
- * recognized editor gets a one-line, copy-pasteable suggestion. Anything
- * else falls back to a generic hint.
- */
-const EDITOR_INSTALL_HINTS: Record<string, string> = {
-    code: 'Open VSCode and run Command Palette → "Shell Command: Install \'code\' command in PATH".',
-    agy: 'Open Antigravity IDE and run Command Palette → "Shell Command: Install \'agy\' command in PATH".',
-    cursor: 'Open Cursor and run Command Palette → "Shell Command: Install \'cursor\' command in PATH".',
-    codium: 'Open VSCodium and run Command Palette → "Shell Command: Install \'codium\' command in PATH".',
-};
-
-const reportEditorNotFound = (editor: string): void => {
-    console.error(`❌ "${editor}" CLI not found in PATH.`);
-    const hint = EDITOR_INSTALL_HINTS[editor]
-        || `Make sure the "${editor}" CLI is installed and on your PATH, or pass a different --editor.`;
-    console.error(`💡 ${hint}`);
-};
-
-const handleInstallExtension = async (editor: string, verbose: boolean): Promise<void> => {
-    const extensionId = "UpendraSengar.at-builder";
-
-    if (verbose) logger.info("verbose", `Installing ${extensionId} via ${editor}`);
-
-    console.log(`📦 Installing ${extensionId} from the Marketplace via "${editor}"...`);
-
-    const result = spawn(editor, ["--install-extension", extensionId], {
-        stdio: "inherit",
-        shell: true
-    });
-
-    result.on("error", (err) => {
-        if ((err as NodeJS.ErrnoException).code === "ENOENT") {
-            reportEditorNotFound(editor);
-        } else {
-            console.error(`❌ Failed to launch "${editor}": ${err.message}`);
-        }
-        process.exit(1);
-    });
-
-    result.on("exit", (code) => {
-        if (code === 0) {
-            console.log("✅ Extension installed. Reload your editor window to activate.");
-            return;
-        }
-        // 127 = shell's "command not found". With shell:true the spawn 'error'
-        // event never fires for missing CLIs, so we surface the same hint here.
-        if (code === 127) {
-            reportEditorNotFound(editor);
-            process.exit(1);
-        }
-        console.error(`❌ "${editor} --install-extension" exited with code ${code}.`);
-        process.exit(code ?? 1);
-    });
-};
-
-/**
- * Handles the doctor command
- */
-const handleDoctor = async (autoFix: boolean, verbose: boolean): Promise<void> => {
-    if (verbose) logger.info("verbose", `Running diagnostics with auto-fix=${autoFix}`);
-    
-    logger.info("handleDoctor", "Diagnosing project configuration");
-    
-    try {
-        // Run diagnostics
-        const issues = await runDiagnostics(process.cwd(), verbose);
-        
-        if (issues.length === 0) {
-            console.log("✅ No issues found. Your project configuration is healthy!");
-            return;
-        }
-        
-        // Display issues
-        console.log(`\n🔍 Found ${issues.length} issue(s):\n`);
-        issues.forEach((issue, index) => {
-            console.log(`${index + 1}. ${issue.severity === 'error' ? '❌' : '⚠️'} ${issue.message}`);
-            if (issue.suggestion) {
-                console.log(`   💡 ${issue.suggestion}`);
-            }
-        });
-        
-        if (autoFix) {
-            console.log('\n🔧 Attempting to fix issues...\n');
-            const fixed = await fixIssues(issues, process.cwd(), verbose);
-            console.log(`\n✅ Fixed ${fixed} issue(s).`);
-            
-            if (fixed < issues.length) {
-                console.log(`⚠️ ${issues.length - fixed} issue(s) require manual attention.`);
-            }
-        } else {
-            console.log('\n💡 Run `atb doctor --fix` to automatically fix resolvable issues.');
-        }
-        
-    } catch (error) {
-        logger.error("handleDoctor", `Doctor command failed: ${error.message}`);
-        process.exit(1);
-    }
-};
-
-// Command execution logic
-/**
- * Main command execution entry point
- */
-const executeCommand = async () => {
-    logger.info("executeCommand", "Entering executeCommand");
-    await setupCommander();
-    logger.info("executeCommand", "Exiting executeCommand");
-};
-
-// Print command help
-const printCommandHelp = async () => {
-    const help = await getHelpInfo();
-    console.log(help);
-    process.exit(0);
-};
-
-/**
- * Main program flow
- */
-const main = async () => {
-    try {
-        await executeCommand();
-    } catch (error) {
-        logger.error("main", error.message);
-        process.exit(1);
-    }
-};
-
-// Print custom help if no arguments, otherwise let Commander.js handle everything
-if (process.argv.length <= 2) {
-    printCommandHelp();
-} else {
-    main();
-}