@friggframework/devtools 2.0.0--canary.545.ae2019f.0 → 2.0.0--canary.549.a579cca.0

package/frigg-cli/utils/output.js

@@ -1,382 +0,0 @@
-/**
- * Output - Unified CLI output and interaction utilities
- *
- * Provides consistent formatting, colors, and interactive prompts across all CLI commands.
- * Replaces direct usage of chalk, console.log, inquirer, and readline.
- *
- * @example
- * const output = require('./utils/output');
- *
- * output.success('Module installed successfully');
- * output.error('Failed to connect to database', error);
- * output.info('Starting deployment...');
- *
- * const spinner = output.spinner('Downloading dependencies...');
- * // do work
- * spinner.succeed('Dependencies downloaded');
- *
- * const answer = await output.prompt({
- *   type: 'confirm',
- *   name: 'continue',
- *   message: 'Continue with installation?'
- * });
- */
-
-const chalk = require('chalk');
-const { select, input, confirm, checkbox, password } = require('@inquirer/prompts');
-
-class Output {
-  /**
-   * Display a success message with a checkmark
-   * @param {string} message - Success message to display
-   */
-  success(message) {
-    console.log(chalk.green('✓'), chalk.green(message));
-  }
-
-  /**
-   * Display an error message with an X mark
-   * @param {string} message - Error message to display
-   * @param {Error} [error] - Optional error object to display
-   */
-  error(message, error) {
-    console.error(chalk.red('✗'), chalk.red(message));
-    if (error && process.env.DEBUG) {
-      console.error(chalk.gray(error.stack || error.message));
-    }
-  }
-
-  /**
-   * Display an info message with an info icon
-   * @param {string} message - Info message to display
-   */
-  info(message) {
-    console.log(chalk.blue('ℹ'), message);
-  }
-
-  /**
-   * Display a warning message
-   * @param {string} message - Warning message to display
-   */
-  warn(message) {
-    console.warn(chalk.yellow('⚠'), chalk.yellow(message));
-  }
-
-  /**
-   * Display a debug message (only when DEBUG env var is set)
-   * @param {string} message - Debug message to display
-   */
-  debug(message) {
-    if (process.env.DEBUG) {
-      console.log(chalk.gray('🐛'), chalk.gray(message));
-    }
-  }
-
-  /**
-   * Display a header/title
-   * @param {string} title - Title to display
-   */
-  header(title) {
-    console.log('');
-    console.log(chalk.bold.cyan(title));
-    console.log(chalk.cyan('─'.repeat(title.length)));
-  }
-
-  /**
-   * Display a section separator
-   */
-  separator() {
-    console.log(chalk.gray('─'.repeat(50)));
-  }
-
-  /**
-   * Display a blank line
-   */
-  newline() {
-    console.log('');
-  }
-
-  /**
-   * Display a table of data
-   * @param {Array<Object>} data - Array of objects to display
-   * @param {Array<string>} [columns] - Column keys to display (defaults to all)
-   */
-  table(data, columns) {
-    if (!data || data.length === 0) {
-      this.info('No data to display');
-      return;
-    }
-
-    const keys = columns || Object.keys(data[0]);
-
-    // Calculate column widths
-    const widths = {};
-    keys.forEach(key => {
-      widths[key] = Math.max(
-        key.length,
-        ...data.map(row => String(row[key] || '').length)
-      );
-    });
-
-    // Print header
-    const headerRow = keys.map(key =>
-      chalk.bold(key.padEnd(widths[key]))
-    ).join('  ');
-    console.log(headerRow);
-    console.log(keys.map(key =>
-      '─'.repeat(widths[key])
-    ).join('  '));
-
-    // Print rows
-    data.forEach(row => {
-      const dataRow = keys.map(key =>
-        String(row[key] || '').padEnd(widths[key])
-      ).join('  ');
-      console.log(dataRow);
-    });
-  }
-
-  /**
-   * Display key-value pairs
-   * @param {Object} data - Object with key-value pairs
-   */
-  keyValue(data) {
-    const maxKeyLength = Math.max(...Object.keys(data).map(k => k.length));
-
-    Object.entries(data).forEach(([key, value]) => {
-      const formattedKey = chalk.gray(`${key.padEnd(maxKeyLength)}:`);
-      console.log(`${formattedKey} ${value}`);
-    });
-  }
-
-  /**
-   * Display JSON with syntax highlighting
-   * @param {Object} data - Data to display as JSON
-   * @param {number} [indent=2] - Indentation level
-   */
-  json(data, indent = 2) {
-    const json = JSON.stringify(data, null, indent);
-    // Basic syntax highlighting
-    const highlighted = json
-      .replace(/"([^"]+)":/g, chalk.blue('"$1"') + ':')  // keys
-      .replace(/: "([^"]+)"/g, ': ' + chalk.green('"$1"'))  // string values
-      .replace(/: (\d+)/g, ': ' + chalk.yellow('$1'))  // numbers
-      .replace(/: (true|false|null)/g, ': ' + chalk.magenta('$1'));  // booleans/null
-
-    console.log(highlighted);
-  }
-
-  /**
-   * Create a spinner for long-running operations
-   * @param {string} text - Spinner text
-   * @returns {Object} Spinner object with update/succeed/fail/stop methods
-   */
-  spinner(text) {
-    const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-    let frameIndex = 0;
-    let interval = null;
-    let currentText = text;
-
-    const render = () => {
-      process.stdout.write(`\r${chalk.cyan(frames[frameIndex])} ${currentText}`);
-      frameIndex = (frameIndex + 1) % frames.length;
-    };
-
-    const clear = () => {
-      process.stdout.write('\r' + ' '.repeat(process.stdout.columns || 80) + '\r');
-    };
-
-    const start = () => {
-      if (interval) return;
-      interval = setInterval(render, 80);
-    };
-
-    const stop = () => {
-      if (interval) {
-        clearInterval(interval);
-        interval = null;
-        clear();
-      }
-    };
-
-    // Auto-start
-    start();
-
-    return {
-      update: (newText) => {
-        currentText = newText;
-      },
-      succeed: (message) => {
-        stop();
-        this.success(message || currentText);
-      },
-      fail: (message) => {
-        stop();
-        this.error(message || currentText);
-      },
-      stop: () => {
-        stop();
-      }
-    };
-  }
-
-  /**
-   * Prompt user with a question (uses @inquirer/prompts)
-   * @param {Object} question - Question configuration
-   * @returns {Promise<any>} User's answer
-   */
-  async prompt(question) {
-    const { type, name, message, choices, initial, validate } = question;
-
-    try {
-      switch (type) {
-        case 'select':
-          return await select({ message, choices, default: initial });
-
-        case 'input':
-          return await input({ message, default: initial, validate });
-
-        case 'confirm':
-          return await confirm({ message, default: initial });
-
-        case 'checkbox':
-          return await checkbox({ message, choices, validate });
-
-        case 'password':
-          return await password({ message, validate });
-
-        default:
-          throw new Error(`Unknown prompt type: ${type}`);
-      }
-    } catch (error) {
-      // User cancelled (Ctrl+C)
-      if (error.message === 'User force closed the prompt') {
-        this.warn('Operation cancelled by user');
-        process.exit(0);
-      }
-      throw error;
-    }
-  }
-
-  /**
-   * Prompt for confirmation
-   * @param {string} message - Confirmation message
-   * @param {boolean} [defaultValue=false] - Default value
-   * @returns {Promise<boolean>} User's answer
-   */
-  async confirm(message, defaultValue = false) {
-    return this.prompt({
-      type: 'confirm',
-      message,
-      initial: defaultValue
-    });
-  }
-
-  /**
-   * Prompt for text input
-   * @param {string} message - Input message
-   * @param {string} [defaultValue] - Default value
-   * @param {Function} [validate] - Validation function
-   * @returns {Promise<string>} User's input
-   */
-  async input(message, defaultValue, validate) {
-    return this.prompt({
-      type: 'input',
-      message,
-      initial: defaultValue,
-      validate
-    });
-  }
-
-  /**
-   * Prompt for selection from a list
-   * @param {string} message - Selection message
-   * @param {Array<Object|string>} choices - Array of choices
-   * @param {any} [defaultValue] - Default value
-   * @returns {Promise<any>} Selected value
-   */
-  async select(message, choices, defaultValue) {
-    // Normalize choices to {name, value} format
-    const normalizedChoices = choices.map(choice => {
-      if (typeof choice === 'string') {
-        return { name: choice, value: choice };
-      }
-      return choice;
-    });
-
-    return this.prompt({
-      type: 'select',
-      message,
-      choices: normalizedChoices,
-      initial: defaultValue
-    });
-  }
-
-  /**
-   * Prompt for multiple selections
-   * @param {string} message - Selection message
-   * @param {Array<Object|string>} choices - Array of choices
-   * @returns {Promise<Array>} Selected values
-   */
-  async checkbox(message, choices) {
-    // Normalize choices to {name, value, checked} format
-    const normalizedChoices = choices.map(choice => {
-      if (typeof choice === 'string') {
-        return { name: choice, value: choice, checked: false };
-      }
-      return { ...choice, checked: choice.checked || false };
-    });
-
-    return this.prompt({
-      type: 'checkbox',
-      message,
-      choices: normalizedChoices
-    });
-  }
-
-  /**
-   * Prompt for password input
-   * @param {string} message - Password prompt message
-   * @param {Function} [validate] - Validation function
-   * @returns {Promise<string>} User's password
-   */
-  async password(message, validate) {
-    return this.prompt({
-      type: 'password',
-      message,
-      validate
-    });
-  }
-
-  /**
-   * Display a progress bar
-   * @param {number} current - Current progress (0-100)
-   * @param {number} total - Total (usually 100)
-   * @param {string} [message] - Optional message
-   */
-  progress(current, total = 100, message = '') {
-    const percentage = Math.round((current / total) * 100);
-    const barLength = 40;
-    const filledLength = Math.round((barLength * current) / total);
-    const bar = '█'.repeat(filledLength) + '░'.repeat(barLength - filledLength);
-
-    process.stdout.write(
-      `\r${chalk.cyan(bar)} ${chalk.bold(`${percentage}%`)} ${message}`
-    );
-
-    if (current >= total) {
-      console.log(''); // New line when complete
-    }
-  }
-
-  /**
-   * Log raw message without formatting (for compatibility)
-   * @param {...any} args - Arguments to log
-   */
-  log(...args) {
-    console.log(...args);
-  }
-}
-
-// Export a singleton instance
-module.exports = new Output();

package/frigg-cli/utils/provider-helper.js

@@ -1,75 +0,0 @@
-/**
- * CLI Provider Helper
- *
- * Loads the appDefinition from the user's project and resolves the
- * corresponding provider plugin package. Used by CLI commands to
- * delegate to the correct provider (AWS, Netlify, etc.).
- */
-const path = require('path');
-const fs = require('fs');
-
-/**
- * Load the appDefinition and resolve the provider plugin for CLI commands.
- *
- * This is a lightweight loader for the CLI context — it reads the backend
- * index.js directly (no need for the full core app-definition-loader which
- * searches for the nearest backend package.json at runtime).
- *
- * @param {Object} [options]
- * @param {string} [options.cwd] - Working directory (default: process.cwd())
- * @returns {{ appDefinition: Object, provider: Object, providerName: string } | null}
- *   Returns null if no appDefinition is found (caller should fall back to default behavior).
- */
-function loadProviderForCli(options = {}) {
-    const cwd = options.cwd || process.cwd();
-    const appDefinition = loadCliAppDefinition(cwd);
-
-    if (!appDefinition) {
-        return null;
-    }
-
-    const providerName = appDefinition.provider || 'aws';
-
-    // For 'aws', return null provider — CLI commands fall back to existing behavior
-    if (providerName === 'aws') {
-        return { appDefinition, provider: null, providerName: 'aws' };
-    }
-
-    // For other providers, resolve the package
-    const {
-        resolveProvider,
-    } = require('@friggframework/core/providers/resolve-provider');
-
-    const provider = resolveProvider(appDefinition);
-    return { appDefinition, provider, providerName };
-}
-
-/**
- * Load the appDefinition from the backend directory.
- * Tries backend/index.js then index.js in the current directory.
- *
- * @param {string} cwd
- * @returns {Object|null}
- */
-function loadCliAppDefinition(cwd) {
-    // Try backend/index.js first (standard Frigg app structure)
-    const backendIndexPath = path.join(cwd, 'backend', 'index.js');
-    const rootIndexPath = path.join(cwd, 'index.js');
-
-    for (const indexPath of [backendIndexPath, rootIndexPath]) {
-        if (fs.existsSync(indexPath)) {
-            try {
-                const exported = require(indexPath);
-                if (exported.Definition) {
-                    return exported.Definition;
-                }
-            } catch {
-                // Failed to load, try next
-            }
-        }
-    }
-
-    return null;
-}
-
-module.exports = { loadProviderForCli, loadCliAppDefinition };

package/frigg-cli/validate-command/__tests__/adapters/validate-command.test.js

@@ -1,205 +0,0 @@
-const path = require('path');
-const fs = require('fs');
-const os = require('os');
-const {
-    createValidateCommand,
-    formatConsoleOutput,
-    autoDetectFriggApp,
-    findBackendPathInDir,
-    findBackendPath
-} = require('../../adapters/cli/validate-command');
-const { ValidationResult } = require('../../domain/entities/validation-result');
-const { ValidationError } = require('../../domain/value-objects/validation-error');
-const { FixSuggestion } = require('../../domain/value-objects/fix-suggestion');
-const { Command } = require('commander');
-
-describe('validateCommand', () => {
-    let mockOutput;
-
-    beforeEach(() => {
-        mockOutput = {
-            info: jest.fn(),
-            success: jest.fn(),
-            error: jest.fn(),
-            warn: jest.fn(),
-            log: jest.fn()
-        };
-    });
-
-    describe('createValidateCommand', () => {
-        it('registers validate command on program', () => {
-            const program = new Command();
-            createValidateCommand(program);
-            const validateCmd = program.commands.find(c => c.name() === 'validate');
-            expect(validateCmd).toBeDefined();
-        });
-
-        it('has required options', () => {
-            const program = new Command();
-            createValidateCommand(program);
-            const validateCmd = program.commands.find(c => c.name() === 'validate');
-            const options = validateCmd.options.map(o => o.long);
-            expect(options).toContain('--format');
-            expect(options).toContain('--verbose');
-        });
-    });
-
-    describe('formatConsoleOutput', () => {
-        it('outputs success for valid result', () => {
-            const result = ValidationResult.create();
-            formatConsoleOutput(result, {}, mockOutput);
-            expect(mockOutput.success).toHaveBeenCalled();
-        });
-
-        it('outputs errors for invalid result', () => {
-            const error = ValidationError.create({
-                path: 'integrations',
-                message: 'Missing integrations',
-                severity: 'error'
-            });
-            const result = ValidationResult.create({ errors: [error] });
-            formatConsoleOutput(result, {}, mockOutput);
-            const logCalls = mockOutput.log.mock.calls.flat().join(' ');
-            expect(logCalls).toContain('Missing integrations');
-        });
-
-        it('outputs warnings', () => {
-            const warning = ValidationError.create({
-                path: 'database',
-                message: 'No database configured',
-                severity: 'warning'
-            });
-            const result = ValidationResult.create({ errors: [warning] });
-            formatConsoleOutput(result, {}, mockOutput);
-            expect(mockOutput.warn).toHaveBeenCalled();
-        });
-
-        it('shows fix suggestions in verbose mode', () => {
-            const fix = FixSuggestion.create({ action: 'add', description: 'Add database configuration' });
-            const error = ValidationError.create({
-                path: 'database',
-                message: 'Missing config',
-                severity: 'error',
-                fix
-            });
-            const result = ValidationResult.create({ errors: [error] });
-            formatConsoleOutput(result, { verbose: true }, mockOutput);
-            const logCalls = mockOutput.log.mock.calls.flat().join(' ');
-            expect(logCalls).toContain('Add database configuration');
-        });
-    });
-
-    describe('findBackendPathInDir', () => {
-        let tmpDir;
-
-        beforeEach(() => {
-            tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'frigg-test-'));
-        });
-
-        afterEach(() => {
-            fs.rmSync(tmpDir, { recursive: true, force: true });
-        });
-
-        it('finds backend/index.js', () => {
-            const backendDir = path.join(tmpDir, 'backend');
-            fs.mkdirSync(backendDir);
-            fs.writeFileSync(path.join(backendDir, 'index.js'), 'module.exports = {}');
-            expect(findBackendPathInDir(tmpDir)).toBe(backendDir);
-        });
-
-        it('finds index.js with integrations keyword', () => {
-            fs.writeFileSync(path.join(tmpDir, 'index.js'), 'module.exports = { integrations: [] }');
-            expect(findBackendPathInDir(tmpDir)).toBe(tmpDir);
-        });
-
-        it('finds index.js with Definition keyword', () => {
-            fs.writeFileSync(path.join(tmpDir, 'index.js'), 'module.exports = { Definition: {} }');
-            expect(findBackendPathInDir(tmpDir)).toBe(tmpDir);
-        });
-
-        it('returns null for non-frigg directory', () => {
-            fs.writeFileSync(path.join(tmpDir, 'index.js'), 'console.log("hello")');
-            expect(findBackendPathInDir(tmpDir)).toBeNull();
-        });
-
-        it('returns null for empty directory', () => {
-            expect(findBackendPathInDir(tmpDir)).toBeNull();
-        });
-    });
-
-    describe('findBackendPath', () => {
-        let tmpDir;
-
-        beforeEach(() => {
-            tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'frigg-test-'));
-        });
-
-        afterEach(() => {
-            fs.rmSync(tmpDir, { recursive: true, force: true });
-        });
-
-        it('finds backend subdirectory with package.json', () => {
-            const backendDir = path.join(tmpDir, 'backend');
-            fs.mkdirSync(backendDir);
-            fs.writeFileSync(path.join(backendDir, 'package.json'), '{}');
-            expect(findBackendPath(tmpDir)).toBe(backendDir);
-        });
-
-        it('finds backend subdirectory with index.js', () => {
-            const backendDir = path.join(tmpDir, 'backend');
-            fs.mkdirSync(backendDir);
-            fs.writeFileSync(path.join(backendDir, 'index.js'), 'module.exports = {}');
-            expect(findBackendPath(tmpDir)).toBe(backendDir);
-        });
-
-        it('returns path itself if it has package.json', () => {
-            fs.writeFileSync(path.join(tmpDir, 'package.json'), '{}');
-            expect(findBackendPath(tmpDir)).toBe(tmpDir);
-        });
-
-        it('returns null for non-backend directory', () => {
-            expect(findBackendPath(tmpDir)).toBeNull();
-        });
-    });
-
-    describe('autoDetectFriggApp', () => {
-        let tmpDir;
-
-        beforeEach(() => {
-            tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'frigg-test-'));
-        });
-
-        afterEach(() => {
-            fs.rmSync(tmpDir, { recursive: true, force: true });
-        });
-
-        it('detects frigg app in current directory', () => {
-            const backendDir = path.join(tmpDir, 'backend');
-            fs.mkdirSync(backendDir);
-            fs.writeFileSync(path.join(backendDir, 'index.js'), 'module.exports = {}');
-            const result = autoDetectFriggApp(tmpDir);
-            expect(result).toEqual({
-                appRoot: tmpDir,
-                backendPath: backendDir
-            });
-        });
-
-        it('detects frigg app in parent directory', () => {
-            const backendDir = path.join(tmpDir, 'backend');
-            const subDir = path.join(tmpDir, 'src', 'components');
-            fs.mkdirSync(backendDir);
-            fs.mkdirSync(subDir, { recursive: true });
-            fs.writeFileSync(path.join(backendDir, 'index.js'), 'module.exports = {}');
-            const result = autoDetectFriggApp(subDir);
-            expect(result).toEqual({
-                appRoot: tmpDir,
-                backendPath: backendDir
-            });
-        });
-
-        it('returns null when no frigg app found', () => {
-            const result = autoDetectFriggApp(tmpDir);
-            expect(result).toBeNull();
-        });
-    });
-});