@friggframework/devtools 2.0.0-next.6 → 2.0.0-next.61

package/frigg-cli/init-command/index.js

@@ -0,0 +1,93 @@
+/**
+ * Copyright (c) 2024 Frigg Integration Framework
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+const path = require('path');
+const chalk = require('chalk');
+const validateProjectName = require('validate-npm-package-name');
+const semver = require('semver');
+const BackendFirstHandler = require('./backend-first-handler');
+
+function checkAppName(appName) {
+    const validationResult = validateProjectName(appName);
+    if (!validationResult.validForNewPackages) {
+        console.error(
+            chalk.red(
+                `Cannot create a project named ${chalk.green(
+                    `"${appName}"`
+                )} because of npm naming restrictions:\n`
+            )
+        );
+        [
+            ...(validationResult.errors || []),
+            ...(validationResult.warnings || []),
+        ].forEach(error => {
+            console.error(chalk.red(`  * ${error}`));
+        });
+        console.error(chalk.red('\nPlease choose a different project name.'));
+        process.exit(1);
+    }
+}
+
+function checkNodeVersion() {
+    const unsupportedNodeVersion = !semver.satisfies(
+        semver.coerce(process.version),
+        '>=14'
+    );
+
+    if (unsupportedNodeVersion) {
+        console.log(
+            chalk.yellow(
+                `You are using Node ${process.version} so the project will be bootstrapped with an old unsupported version of tools.\n\n` +
+                `Please update to Node 14 or higher for a better, fully supported experience.\n`
+            )
+        );
+    }
+}
+
+async function initCommand(projectName, options) {
+    const verbose = options.verbose || false;
+    const force = options.force || false;
+    
+    checkNodeVersion();
+
+    const root = path.resolve(projectName);
+    const appName = path.basename(root);
+
+    checkAppName(appName);
+    
+    // Use backend-first handler by default
+    if (!options.template && !options.legacyFrontend) {
+        try {
+            const handler = new BackendFirstHandler(root, {
+                force,
+                verbose,
+                mode: options.mode,
+                frontend: options.frontend
+            });
+            
+            await handler.initialize();
+            return;
+        } catch (error) {
+            console.log();
+            console.log(chalk.red('Aborting installation.'));
+            console.log(chalk.red('Error:'), error.message);
+            console.log();
+            process.exit(1);
+        }
+    }
+    
+    // If we get here, show an error for legacy options
+    console.log();
+    console.log(chalk.red('Legacy template system is no longer supported.'));
+    console.log(chalk.yellow('Please use the new backend-first approach.'));
+    console.log();
+    process.exit(1);
+}
+
+module.exports = { initCommand };

package/frigg-cli/init-command/template-handler.js

@@ -0,0 +1,143 @@
+const fs = require('fs-extra');
+const path = require('path');
+const { execSync } = require('child_process');
+
+/**
+ * Handles template initialization for the frigg init command
+ */
+class TemplateHandler {
+    constructor(targetPath, options = {}) {
+        this.targetPath = targetPath;
+        this.options = options;
+        this.templatesDir = path.join(__dirname, '..', 'templates');
+    }
+
+    /**
+     * Initialize a new Frigg backend project from template
+     */
+    async initializeBackendTemplate() {
+        const templatePath = path.join(this.templatesDir, 'backend');
+        
+        if (!fs.existsSync(templatePath)) {
+            throw new Error('Backend template not found. Please ensure the CLI is properly installed.');
+        }
+
+        // Create target directory if it doesn't exist
+        await fs.ensureDir(this.targetPath);
+
+        // Check if directory is empty
+        const files = await fs.readdir(this.targetPath);
+        if (files.length > 0 && !this.options.force) {
+            throw new Error('Target directory is not empty. Use --force to override.');
+        }
+
+        console.log('🚀 Initializing new Frigg backend project...');
+
+        // Copy template files
+        await this.copyTemplateFiles(templatePath, this.targetPath);
+
+        // Update package.json with project name
+        await this.updatePackageJson();
+
+        // Update serverless.yml with project name
+        await this.updateServerlessConfig();
+
+        // Initialize git if requested
+        if (this.options.git !== false) {
+            await this.initializeGit();
+        }
+
+        // Install dependencies if requested
+        if (this.options.install !== false) {
+            await this.installDependencies();
+        }
+
+        console.log('✅ Frigg backend project initialized successfully!');
+        console.log('\nNext steps:');
+        console.log(`  cd ${path.basename(this.targetPath)}`);
+        if (this.options.install === false) {
+            console.log('  npm install');
+        }
+        console.log('  npm run docker:start');
+        console.log('  npm run backend-start');
+        console.log('\nFor more information, check the README.md file.');
+    }
+
+    /**
+     * Copy template files to target directory
+     */
+    async copyTemplateFiles(source, target) {
+        await fs.copy(source, target, {
+            overwrite: this.options.force || false,
+            filter: (src) => {
+                // Skip node_modules and other build artifacts
+                const basename = path.basename(src);
+                return !['node_modules', '.serverless', 'dist', 'build'].includes(basename);
+            }
+        });
+    }
+
+    /**
+     * Update package.json with project-specific details
+     */
+    async updatePackageJson() {
+        const packageJsonPath = path.join(this.targetPath, 'package.json');
+        const packageJson = await fs.readJson(packageJsonPath);
+        
+        // Update package name based on directory name
+        const projectName = path.basename(this.targetPath);
+        packageJson.name = projectName;
+        
+        // Remove private flag for new projects
+        delete packageJson.private;
+        
+        await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+    }
+
+    /**
+     * Update serverless.yml with project-specific details
+     */
+    async updateServerlessConfig() {
+        const serverlessPath = path.join(this.targetPath, 'serverless.yml');
+        let serverlessContent = await fs.readFile(serverlessPath, 'utf8');
+        
+        // Update service name based on directory name
+        const projectName = path.basename(this.targetPath);
+        serverlessContent = serverlessContent.replace(
+            /^service: create-frigg-app$/m,
+            `service: ${projectName}`
+        );
+        
+        await fs.writeFile(serverlessPath, serverlessContent);
+    }
+
+    /**
+     * Initialize git repository
+     */
+    async initializeGit() {
+        try {
+            console.log('📦 Initializing git repository...');
+            execSync('git init', { cwd: this.targetPath, stdio: 'ignore' });
+            execSync('git add .', { cwd: this.targetPath, stdio: 'ignore' });
+            execSync('git commit -m "Initial commit from Frigg CLI"', { 
+                cwd: this.targetPath, 
+                stdio: 'ignore' 
+            });
+        } catch (error) {
+            console.warn('⚠️  Git initialization failed. You can initialize git manually later.');
+        }
+    }
+
+    /**
+     * Install npm dependencies
+     */
+    async installDependencies() {
+        console.log('📦 Installing dependencies...');
+        execSync('npm install', { 
+            cwd: this.targetPath, 
+            stdio: 'inherit' 
+        });
+    }
+}
+
+module.exports = TemplateHandler;

package/frigg-cli/install-command/index.js

@@ -4,15 +4,12 @@ const { resolve } = require('node:path');
 const { updateBackendJsFile } = require('./backend-js');
 const { logInfo, logError } = require('./logger');
 const { commitChanges } = require('./commit-changes');
-const {
-    findNearestBackendPackageJson,
-    validateBackendPath,
-} = require('../utils/backend-path');
 const { handleEnvVariables } = require('./environment-variables');
 const {
     validatePackageExists,
     searchAndSelectPackage,
 } = require('./validate-package');
+const { findNearestBackendPackageJson, validateBackendPath } = require('@friggframework/core/utils');
 
 const installCommand = async (apiModuleName) => {
     try {

package/frigg-cli/jest.config.js

@@ -0,0 +1,124 @@
+module.exports = {
+  displayName: 'Frigg CLI Tests',
+  testMatch: [
+    '<rootDir>/__tests__/**/*.test.js',
+    '<rootDir>/__tests__/**/*.spec.js',
+    '<rootDir>/**/start-command.test.js',
+    '<rootDir>/**/__tests__/**/*.test.js'
+  ],
+  // Exclude utility files and config from being treated as tests
+  testPathIgnorePatterns: [
+    '/node_modules/',
+    '/__tests__/utils/',
+    '/__tests__/jest.config.js',
+    '/test-setup.js'
+  ],
+  testEnvironment: 'node',
+  collectCoverageFrom: [
+    '**/*.js',
+    '!**/*.test.js',
+    '!**/*.spec.js',
+    '!**/node_modules/**',
+    '!**/__tests__/**',
+    '!**/coverage/**'
+  ],
+  coverageDirectory: 'coverage',
+  coverageReporters: [
+    'text',
+    'text-summary',
+    'html',
+    'lcov',
+    'json'
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 85,
+      functions: 85,
+      lines: 85,
+      statements: 85
+    },
+    './install-command/index.js': {
+      branches: 90,
+      functions: 90,
+      lines: 90,
+      statements: 90
+    },
+    './build-command/index.js': {
+      branches: 90,
+      functions: 90,
+      lines: 90,
+      statements: 90
+    },
+    './deploy-command/index.js': {
+      branches: 90,
+      functions: 90,
+      lines: 90,
+      statements: 90
+    },
+    './ui-command/index.js': {
+      branches: 90,
+      functions: 90,
+      lines: 90,
+      statements: 90
+    },
+    './generate-command/index.js': {
+      branches: 90,
+      functions: 90,
+      lines: 90,
+      statements: 90
+    },
+    './db-setup-command/index.js': {
+      branches: 90,
+      functions: 90,
+      lines: 90,
+      statements: 90
+    },
+    './utils/database-validator.js': {
+      branches: 85,
+      functions: 85,
+      lines: 85,
+      statements: 85
+    },
+    './utils/prisma-runner.js': {
+      branches: 85,
+      functions: 85,
+      lines: 85,
+      statements: 85
+    },
+    './utils/error-messages.js': {
+      branches: 85,
+      functions: 85,
+      lines: 85,
+      statements: 85
+    }
+  },
+  setupFilesAfterEnv: [
+    '<rootDir>/__tests__/utils/test-setup.js'
+  ],
+  testTimeout: 10000,
+  maxWorkers: '50%',
+  verbose: true,
+  collectCoverage: true,
+  coveragePathIgnorePatterns: [
+    '/node_modules/',
+    '/__tests__/',
+    '/coverage/',
+    '.test.js',
+    '.spec.js'
+  ],
+  moduleFileExtensions: [
+    'js',
+    'json',
+    'node'
+  ],
+  transform: {},
+  // testResultsProcessor: 'jest-sonar-reporter', // Optional dependency
+  reporters: [
+    'default'
+    // jest-junit reporter removed - optional dependency
+  ],
+  watchman: false,
+  forceExit: true,
+  detectOpenHandles: true,
+  errorOnDeprecated: true
+};

package/frigg-cli/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@friggframework/frigg-cli",
+  "version": "2.0.0-next.0",
+  "description": "Frigg Framework CLI tool",
+  "main": "index.js",
+  "bin": {
+    "frigg": "./index.js"
+  },
+  "scripts": {
+    "test": "jest"
+  },
+  "dependencies": {
+    "@aws-sdk/client-cloudformation": "^3.705.0",
+    "@babel/parser": "^7.25.3",
+    "@babel/traverse": "^7.25.3",
+    "@friggframework/core": "^2.0.0-next.0",
+    "@friggframework/schemas": "^2.0.0-next.0",
+    "@inquirer/prompts": "^5.3.8",
+    "axios": "^1.7.2",
+    "chalk": "^4.1.2",
+    "commander": "^12.1.0",
+    "cross-spawn": "^7.0.3",
+    "dotenv": "^16.4.5",
+    "fs-extra": "^11.2.0",
+    "js-yaml": "^4.1.0",
+    "lodash": "4.17.21",
+    "node-cache": "^5.1.2",
+    "open": "^8.4.2",
+    "osls": "^3.40.1",
+    "semver": "^7.6.0",
+    "validate-npm-package-name": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@friggframework/devtools": "*"
+  },
+  "devDependencies": {
+    "@friggframework/devtools": "^2.0.0-next.0",
+    "jest": "^29.7.0",
+    "jest-mock-extended": "^3.0.5"
+  },
+  "keywords": [
+    "frigg",
+    "cli",
+    "integration",
+    "framework"
+  ],
+  "author": "Frigg Framework Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/friggframework/frigg.git"
+  },
+  "bugs": {
+    "url": "https://github.com/friggframework/frigg/issues"
+  },
+  "homepage": "https://github.com/friggframework/frigg#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}