@friggframework/devtools 2.0.0-next.11 → 2.0.0-next.110

package/frigg-cli/index.js

@@ -1,12 +1,103 @@
 #!/usr/bin/env node
 
+// Version Detection Wrapper
+// This code runs when frigg-cli is installed globally
+// It checks for a local installation and prefers it if newer
+(function versionDetection() {
+    // Skip version detection if explicitly disabled (prevents recursion)
+    if (process.env.FRIGG_CLI_SKIP_VERSION_CHECK === 'true') {
+        return;
+    }
+
+    const path = require('path');
+    const fs = require('fs');
+    const semver = require('semver');
+    const { spawn } = require('child_process');
+
+    // Get the directory from which the command was invoked
+    const cwd = process.cwd();
+
+    // Try to find local frigg-cli installation
+    const localCliPath = path.join(cwd, 'node_modules', '@friggframework', 'frigg-cli');
+    const localCliPackageJson = path.join(localCliPath, 'package.json');
+    const localCliIndex = path.join(localCliPath, 'index.js');
+
+    // Get global version (this package)
+    const globalVersion = require('./package.json').version;
+
+    // Check if local installation exists
+    if (fs.existsSync(localCliPackageJson) && fs.existsSync(localCliIndex)) {
+        try {
+            const localPackage = JSON.parse(fs.readFileSync(localCliPackageJson, 'utf8'));
+            const localVersion = localPackage.version;
+
+            // Compare versions
+            const comparison = semver.compare(localVersion, globalVersion);
+
+            if (comparison >= 0) {
+                // Local version is newer or equal - use it
+                console.log(`Using local frigg-cli@${localVersion} (global: ${globalVersion})`);
+
+                // Execute local CLI as subprocess to avoid module resolution issues
+                const args = process.argv.slice(2); // Remove 'node' and script path
+                const child = spawn(process.execPath, [localCliIndex, ...args], {
+                    stdio: 'inherit',
+                    env: {
+                        ...process.env,
+                        FRIGG_CLI_SKIP_VERSION_CHECK: 'true', // Prevent recursion
+                    },
+                });
+
+                child.on('exit', (code) => {
+                    process.exit(code || 0);
+                });
+
+                // Signal that we've delegated to local CLI
+                process.on('SIGINT', () => {
+                    child.kill('SIGINT');
+                });
+
+                // Prevent further execution
+                return true; // Indicates we've delegated
+            } else {
+                // Global version is newer - warn user
+                console.warn(`⚠️  Version mismatch: global frigg-cli@${globalVersion} is newer than local frigg-cli@${localVersion}`);
+                console.warn(`   Consider updating local version: npm install @friggframework/frigg-cli@latest`);
+            }
+        } catch (error) {
+            // Failed to read local package.json or compare versions
+            // Continue with global version silently
+        }
+    }
+
+    // Return false to indicate we should continue with global version
+    return false;
+})();
+
 const { Command } = require('commander');
+const { initCommand } = require('./init-command');
 const { installCommand } = require('./install-command');
 const { startCommand } = require('./start-command'); // Assuming you have a startCommand module
 const { buildCommand } = require('./build-command');
 const { deployCommand } = require('./deploy-command');
+const { generateIamCommand } = require('./generate-iam-command');
+const { uiCommand } = require('./ui-command');
+const { dbSetupCommand } = require('./db-setup-command');
+const { doctorCommand } = require('./doctor-command');
+const { repairCommand } = require('./repair-command');
+const { authCommand } = require('./auth-command');
+const { ssmPushCommand } = require('./ssm-command');
 
 const program = new Command();
+
+program
+    .command('init [templateName]')
+    .description('Initialize a new Frigg application')
+    .option('-t, --template <template>', 'template to use', 'backend-only')
+    .option('-n, --name <name>', 'project name')
+    .option('-d, --directory <directory>', 'target directory')
+    .action(initCommand);
+
 program
     .command('install [apiModuleName]')
     .description('Install an API module')
@@ -16,20 +107,117 @@ program
     .command('start')
     .description('Run the backend and optional frontend')
     .option('-s, --stage <stage>', 'deployment stage', 'dev')
+    .option('-v, --verbose', 'enable verbose output')
     .action(startCommand);
 
 program
     .command('build')
     .description('Build the serverless application')
     .option('-s, --stage <stage>', 'deployment stage', 'dev')
+    .option('-v, --verbose', 'enable verbose output')
+    .option('-p, --production', 'build for production (enables AWS discovery)')
     .action(buildCommand);
 
 program
     .command('deploy')
     .description('Deploy the serverless application')
     .option('-s, --stage <stage>', 'deployment stage', 'dev')
+    .option('-v, --verbose', 'enable verbose output')
+    .option('-f, --force', 'force deployment (bypasses caching for layers and functions)')
+    .option('--skip-doctor', 'skip post-deployment health check')
     .action(deployCommand);
 
+program
+    .command('generate-iam')
+    .description('Generate IAM CloudFormation template based on app definition')
+    .option('-o, --output <path>', 'output directory', 'backend/infrastructure')
+    .option('-u, --user <name>', 'deployment user name', 'frigg-deployment-user')
+    .option('-s, --stack-name <name>', 'CloudFormation stack name', 'frigg-deployment-iam')
+    .option('-v, --verbose', 'enable verbose output')
+    .action(generateIamCommand);
+
+program
+    .command('ui')
+    .description('Launch the Frigg Management UI')
+    .option('-p, --port <port>', 'port to run the UI on', '3210')
+    .option('--no-open', 'do not open browser automatically')
+    .action(uiCommand);
+
+program
+    .command('db:setup')
+    .description('Set up database schema and generate Prisma client')
+    .option('-s, --stage <stage>', 'deployment stage', 'development')
+    .option('-v, --verbose', 'enable verbose output')
+    .action(dbSetupCommand);
+
+program
+    .command('doctor [stackName]')
+    .description('Run health check on deployed CloudFormation stack')
+    .option('-r, --region <region>', 'AWS region (defaults to AWS_REGION env var or us-east-1)')
+    .option('-f, --format <format>', 'output format (console or json)', 'console')
+    .option('-o, --output <path>', 'save report to file')
+    .option('-v, --verbose', 'enable verbose output')
+    .action(doctorCommand);
+
+program
+    .command('repair <stackName>')
+    .description('Repair infrastructure issues (import orphaned resources, reconcile property drift)')
+    .option('-r, --region <region>', 'AWS region (defaults to AWS_REGION env var or us-east-1)')
+    .option('--import', 'import orphaned resources into stack')
+    .option('--reconcile', 'reconcile property drift')
+    .option('--mode <mode>', 'reconciliation mode (template or resource)', 'template')
+    .option('-y, --yes', 'skip confirmation prompts')
+    .option('-v, --verbose', 'enable verbose output')
+    .action(repairCommand);
+
+// SSM command group for the parameter offload feature (ADR-027)
+const ssmProgram = program
+    .command('ssm')
+    .description('Manage SSM Parameter Store offloaded configuration');
+
+ssmProgram
+    .command('push')
+    .description('Push SSM-offloaded environment values to Parameter Store')
+    .option('-s, --stage <stage>', 'deployment stage', 'dev')
+    .option('-r, --region <region>', 'AWS region (defaults to AWS_REGION env var or us-east-1)')
+    .option('--allow-empty', 'skip (instead of fail on) keys with missing or empty values')
+    .option('--tier <tier>', 'override tier for all keys: standard (4KB values) or advanced (8KB, billed)')
+    .action(ssmPushCommand);
+
+// Auth command group for testing API module authentication
+const authProgram = program
+    .command('auth')
+    .description('Test API module authentication');
+
+authProgram
+    .command('test <module>')
+    .description('Test authentication for an API module')
+    .option('--api-key <key>', 'API key for API-Key authentication')
+    .option('--port <port>', 'Callback server port', '3333')
+    .option('--timeout <seconds>', 'OAuth callback timeout', '300')
+    .option('-v, --verbose', 'Enable verbose output')
+    .action(authCommand.test);
+
+authProgram
+    .command('list')
+    .description('List saved credentials')
+    .option('--json', 'Output as JSON')
+    .action(authCommand.list);
+
+authProgram
+    .command('get <module>')
+    .description('Get credentials for a module')
+    .option('--json', 'Output as JSON')
+    .option('--export', 'Export as environment variables')
+    .action(authCommand.get);
+
+authProgram
+    .command('delete [module]')
+    .description('Delete saved credentials')
+    .option('--all', 'Delete all credentials')
+    .option('-y, --yes', 'Skip confirmation')
+    .action(authCommand.delete);
+
 program.parse(process.argv);
 
-module.exports = { installCommand, startCommand, buildCommand, deployCommand };
+module.exports = { initCommand, installCommand, startCommand, buildCommand, deployCommand, generateIamCommand, uiCommand, dbSetupCommand, doctorCommand, repairCommand, authCommand, ssmPushCommand };

package/frigg-cli/index.test.js

@@ -1,10 +1,7 @@
 const { Command } = require('commander');
 const { installCommand } = require('./index');
 const { validatePackageExists } = require('./install-command/validate-package');
-const {
-    findNearestBackendPackageJson,
-    validateBackendPath,
-} = require('./utils/backend-path');
+const { findNearestBackendPackageJson, validateBackendPath } = require('@friggframework/core');
 const { installPackage } = require('./install-command/install-package');
 const { createIntegrationFile } = require('./install-command/integration-file');
 const { updateBackendJsFile } = require('./install-command/backend-js');