@expressots/cli 3.0.0 → 4.0.0-preview.2

package/bin/cicd/generators/gitlab-ci.js

@@ -0,0 +1,237 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateGitLabCI = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const template_loader_1 = require("./template-loader");
+async function generateGitLabCI(outputDir, options) {
+    // Try remote template, fall back to embedded
+    const result = await (0, template_loader_1.loadCICDTemplate)("gitlab", options.strategy, options, generateGitLabContentEmbedded);
+    (0, template_loader_1.logTemplateSource)("GitLab CI", result.source);
+    const filePath = path_1.default.join(outputDir, ".gitlab-ci.yml");
+    fs_1.default.writeFileSync(filePath, result.content, "utf-8");
+    console.log(chalk_1.default.green(`  ✓ Created .gitlab-ci.yml`));
+}
+exports.generateGitLabCI = generateGitLabCI;
+/**
+ * Embedded template generator (fallback when remote templates unavailable)
+ */
+function generateGitLabContentEmbedded(options) {
+    const { nodeVersion, packageManager, strategy, includeSecurity, includeE2E, includeCoverage, deployTarget, branch, } = options;
+    const installCmd = packageManager === "pnpm"
+        ? "pnpm install"
+        : packageManager === "yarn"
+            ? "yarn install"
+            : "npm ci";
+    const testCmd = packageManager === "pnpm"
+        ? "pnpm test"
+        : packageManager === "yarn"
+            ? "yarn test"
+            : "npm test";
+    const buildCmd = packageManager === "pnpm"
+        ? "pnpm build"
+        : packageManager === "yarn"
+            ? "yarn build"
+            : "npm run build";
+    const lintCmd = packageManager === "pnpm"
+        ? "pnpm lint"
+        : packageManager === "yarn"
+            ? "yarn lint"
+            : "npm run lint";
+    let content = `# GitLab CI/CD Pipeline
+# Generated by ExpressoTS CLI
+# Strategy: ${strategy}
+
+image: node:${nodeVersion}-alpine
+
+stages:
+  - lint
+  - test${includeSecurity && (strategy === "comprehensive" || strategy === "security-focused") ? "\n  - security" : ""}${includeE2E ? "\n  - e2e" : ""}
+  - build
+  - docker${deployTarget !== "none" ? "\n  - deploy" : ""}
+
+variables:
+  npm_config_cache: "$CI_PROJECT_DIR/.npm"
+  DOCKER_IMAGE: $CI_REGISTRY_IMAGE
+
+cache:
+  key: \${CI_COMMIT_REF_SLUG}
+  paths:
+    - .npm/
+    - node_modules/
+
+# Lint Stage
+lint:
+  stage: lint
+  script:
+    - ${installCmd}
+    - ${lintCmd}
+  only:
+    - ${branch}
+    - merge_requests
+
+# Test Stage
+test:
+  stage: test
+  script:
+    - ${installCmd}
+    - ${testCmd}${includeCoverage ? ` --coverage` : ""}
+  ${includeCoverage
+        ? `coverage: '/All files[^|]*\\|[^|]*\\s+([\\d\\.]+)/'
+  artifacts:
+    reports:
+      coverage_report:
+        coverage_format: cobertura
+        path: coverage/cobertura-coverage.xml`
+        : ""}
+  only:
+    - ${branch}
+    - merge_requests
+
+`;
+    // Security scanning
+    if (includeSecurity &&
+        (strategy === "comprehensive" || strategy === "security-focused")) {
+        content += `# Security Stage
+security:
+  stage: security
+  image:
+    name: aquasec/trivy:latest
+    entrypoint: [""]
+  script:
+    - trivy fs --exit-code 0 --severity HIGH,CRITICAL --format json -o trivy-report.json .
+  artifacts:
+    reports:
+      container_scanning: trivy-report.json
+    expire_in: 1 week
+  only:
+    - ${branch}
+
+`;
+        if (strategy === "security-focused") {
+            content += `dependency_scanning:
+  stage: security
+  image: node:${nodeVersion}
+  script:
+    - npm audit --audit-level=high
+  allow_failure: true
+  only:
+    - ${branch}
+
+`;
+        }
+    }
+    // E2E tests
+    if (includeE2E) {
+        content += `# E2E Tests
+e2e:
+  stage: e2e
+  services:
+    - postgres:15-alpine
+  variables:
+    DATABASE_URL: "postgresql://postgres:postgres@postgres:5432/test"
+  script:
+    - ${installCmd}
+    - ${buildCmd}
+    - npm start &
+    - sleep 10
+    - npm run test:e2e
+  only:
+    - ${branch}
+
+`;
+    }
+    // Build stage
+    content += `# Build Stage
+build:
+  stage: build
+  script:
+    - ${installCmd}
+    - ${buildCmd}
+  artifacts:
+    paths:
+      - dist/
+    expire_in: 1 week
+  only:
+    - ${branch}
+
+# Docker Build Stage
+docker:
+  stage: docker
+  image: docker:24
+  services:
+    - docker:24-dind
+  variables:
+    DOCKER_TLS_CERTDIR: "/certs"
+  before_script:
+    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
+  script:
+    - docker build -t $DOCKER_IMAGE:$CI_COMMIT_SHA -t $DOCKER_IMAGE:latest .
+    - docker push $DOCKER_IMAGE:$CI_COMMIT_SHA
+    - docker push $DOCKER_IMAGE:latest
+  only:
+    - ${branch}
+
+`;
+    // Deploy stage
+    if (deployTarget !== "none") {
+        content += generateGitLabDeployJob(deployTarget, branch);
+    }
+    return content;
+}
+function generateGitLabDeployJob(target, branch) {
+    switch (target) {
+        case "kubernetes":
+            return `# Deploy to Kubernetes
+deploy:
+  stage: deploy
+  image: bitnami/kubectl:latest
+  script:
+    - kubectl config set-cluster k8s --server="$KUBE_URL"
+    - kubectl config set-credentials gitlab --token="$KUBE_TOKEN"
+    - kubectl config set-context default --cluster=k8s --user=gitlab
+    - kubectl config use-context default
+    - kubectl set image deployment/expressots-app app=$DOCKER_IMAGE:$CI_COMMIT_SHA
+    - kubectl rollout status deployment/expressots-app
+  environment:
+    name: production
+    url: https://your-app.com
+  only:
+    - ${branch}
+  when: manual
+
+`;
+        case "railway":
+            return `# Deploy to Railway
+deploy:
+  stage: deploy
+  image: node:20-alpine
+  script:
+    - npm install -g @railway/cli
+    - railway up
+  environment:
+    name: production
+  only:
+    - ${branch}
+  when: manual
+
+`;
+        default:
+            return `# Deploy Stage
+deploy:
+  stage: deploy
+  script:
+    - echo "Deploy to ${target}"
+  environment:
+    name: production
+  only:
+    - ${branch}
+  when: manual
+
+`;
+    }
+}

package/bin/cicd/generators/index.d.ts

@@ -0,0 +1,6 @@
+export { generateGitHubActions } from "./github-actions";
+export { generateGitLabCI } from "./gitlab-ci";
+export { generateCircleCI } from "./circleci";
+export { generateJenkinsfile } from "./jenkins";
+export { generateBitbucketPipelines } from "./bitbucket";
+export { generateAzureDevOps } from "./azure-devops";

package/bin/cicd/generators/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAzureDevOps = exports.generateBitbucketPipelines = exports.generateJenkinsfile = exports.generateCircleCI = exports.generateGitLabCI = exports.generateGitHubActions = void 0;
+var github_actions_1 = require("./github-actions");
+Object.defineProperty(exports, "generateGitHubActions", { enumerable: true, get: function () { return github_actions_1.generateGitHubActions; } });
+var gitlab_ci_1 = require("./gitlab-ci");
+Object.defineProperty(exports, "generateGitLabCI", { enumerable: true, get: function () { return gitlab_ci_1.generateGitLabCI; } });
+var circleci_1 = require("./circleci");
+Object.defineProperty(exports, "generateCircleCI", { enumerable: true, get: function () { return circleci_1.generateCircleCI; } });
+var jenkins_1 = require("./jenkins");
+Object.defineProperty(exports, "generateJenkinsfile", { enumerable: true, get: function () { return jenkins_1.generateJenkinsfile; } });
+var bitbucket_1 = require("./bitbucket");
+Object.defineProperty(exports, "generateBitbucketPipelines", { enumerable: true, get: function () { return bitbucket_1.generateBitbucketPipelines; } });
+var azure_devops_1 = require("./azure-devops");
+Object.defineProperty(exports, "generateAzureDevOps", { enumerable: true, get: function () { return azure_devops_1.generateAzureDevOps; } });

package/bin/cicd/generators/jenkins.d.ts

@@ -0,0 +1,2 @@
+import type { GeneratorOptions } from "./github-actions";
+export declare function generateJenkinsfile(outputDir: string, options: GeneratorOptions): Promise<void>;

package/bin/cicd/generators/jenkins.js

@@ -0,0 +1,248 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateJenkinsfile = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const template_loader_1 = require("./template-loader");
+async function generateJenkinsfile(outputDir, options) {
+    // Try remote template, fall back to embedded
+    const result = await (0, template_loader_1.loadCICDTemplate)("jenkins", options.strategy, options, generateJenkinsContentEmbedded);
+    (0, template_loader_1.logTemplateSource)("Jenkins", result.source);
+    const filePath = path_1.default.join(outputDir, "Jenkinsfile");
+    fs_1.default.writeFileSync(filePath, result.content, "utf-8");
+    console.log(chalk_1.default.green(`  ✓ Created Jenkinsfile`));
+}
+exports.generateJenkinsfile = generateJenkinsfile;
+/**
+ * Embedded template generator (fallback when remote templates unavailable)
+ */
+function generateJenkinsContentEmbedded(options) {
+    const { projectName, nodeVersion, packageManager, strategy, includeSecurity, includeE2E, includeCoverage, deployTarget, branch, } = options;
+    const installCmd = packageManager === "pnpm"
+        ? "pnpm install"
+        : packageManager === "yarn"
+            ? "yarn install"
+            : "npm ci";
+    const testCmd = packageManager === "pnpm"
+        ? "pnpm test"
+        : packageManager === "yarn"
+            ? "yarn test"
+            : "npm test";
+    const buildCmd = packageManager === "pnpm"
+        ? "pnpm build"
+        : packageManager === "yarn"
+            ? "yarn build"
+            : "npm run build";
+    const lintCmd = packageManager === "pnpm"
+        ? "pnpm lint"
+        : packageManager === "yarn"
+            ? "yarn lint"
+            : "npm run lint";
+    let content = `// Jenkinsfile
+// Generated by ExpressoTS CLI
+// Strategy: ${strategy}
+
+pipeline {
+    agent any
+    
+    environment {
+        NODE_VERSION = '${nodeVersion}'
+        DOCKER_IMAGE = '${projectName}'
+        DOCKER_TAG = "\${BUILD_NUMBER}"
+    }
+    
+    tools {
+        nodejs "node-\${NODE_VERSION}"
+    }
+    
+    options {
+        buildDiscarder(logRotator(numToKeepStr: '10'))
+        timeout(time: 30, unit: 'MINUTES')
+        disableConcurrentBuilds()
+    }
+    
+    stages {
+        stage('Checkout') {
+            steps {
+                checkout scm
+            }
+        }
+        
+        stage('Install Dependencies') {
+            steps {
+                sh '${installCmd}'
+            }
+        }
+        
+        stage('Lint') {
+            steps {
+                sh '${lintCmd}'
+            }
+        }
+        
+        stage('Test') {
+            steps {
+                sh '${testCmd}${includeCoverage ? " --coverage" : ""}'
+            }
+`;
+    if (includeCoverage) {
+        content += `            post {
+                always {
+                    publishHTML(target: [
+                        allowMissing: false,
+                        alwaysLinkToLastBuild: true,
+                        keepAll: true,
+                        reportDir: 'coverage/lcov-report',
+                        reportFiles: 'index.html',
+                        reportName: 'Coverage Report'
+                    ])
+                }
+            }
+`;
+    }
+    content += `        }
+`;
+    // Security stage
+    if (includeSecurity &&
+        (strategy === "comprehensive" || strategy === "security-focused")) {
+        content += `        
+        stage('Security Scan') {
+            steps {
+                script {
+                    // Run npm audit
+                    sh 'npm audit --audit-level=high || true'
+                    
+                    // Run Trivy if available
+                    sh '''
+                        if command -v trivy &> /dev/null; then
+                            trivy fs --exit-code 0 --severity HIGH,CRITICAL .
+                        else
+                            echo "Trivy not installed, skipping filesystem scan"
+                        fi
+                    '''
+                }
+            }
+        }
+`;
+    }
+    // E2E tests
+    if (includeE2E) {
+        content += `        
+        stage('E2E Tests') {
+            steps {
+                script {
+                    sh '${buildCmd}'
+                    sh '''
+                        npm start &
+                        sleep 10
+                        npm run test:e2e
+                    '''
+                }
+            }
+        }
+`;
+    }
+    // Build stage
+    content += `        
+        stage('Build') {
+            steps {
+                sh '${buildCmd}'
+            }
+        }
+        
+        stage('Docker Build') {
+            when {
+                branch '${branch}'
+            }
+            steps {
+                script {
+                    docker.build("\${DOCKER_IMAGE}:\${DOCKER_TAG}")
+                    docker.build("\${DOCKER_IMAGE}:latest")
+                }
+            }
+        }
+        
+        stage('Docker Push') {
+            when {
+                branch '${branch}'
+            }
+            steps {
+                script {
+                    docker.withRegistry('https://registry.hub.docker.com', 'docker-hub-credentials') {
+                        docker.image("\${DOCKER_IMAGE}:\${DOCKER_TAG}").push()
+                        docker.image("\${DOCKER_IMAGE}:latest").push()
+                    }
+                }
+            }
+        }
+`;
+    // Deploy stage
+    if (deployTarget !== "none") {
+        content += generateJenkinsDeployStage(deployTarget, branch);
+    }
+    content += `    }
+    
+    post {
+        always {
+            cleanWs()
+        }
+        success {
+            echo 'Pipeline completed successfully!'
+        }
+        failure {
+            echo 'Pipeline failed!'
+        }
+    }
+}
+`;
+    return content;
+}
+function generateJenkinsDeployStage(target, branch) {
+    switch (target) {
+        case "kubernetes":
+            return `        
+        stage('Deploy to Kubernetes') {
+            when {
+                branch '${branch}'
+            }
+            steps {
+                withKubeConfig([credentialsId: 'kubeconfig']) {
+                    sh '''
+                        kubectl set image deployment/expressots-app \\
+                            app=\${DOCKER_IMAGE}:\${DOCKER_TAG}
+                        kubectl rollout status deployment/expressots-app
+                    '''
+                }
+            }
+        }
+`;
+        case "railway":
+            return `        
+        stage('Deploy to Railway') {
+            when {
+                branch '${branch}'
+            }
+            steps {
+                withCredentials([string(credentialsId: 'railway-token', variable: 'RAILWAY_TOKEN')]) {
+                    sh 'npx @railway/cli up'
+                }
+            }
+        }
+`;
+        default:
+            return `        
+        stage('Deploy') {
+            when {
+                branch '${branch}'
+            }
+            steps {
+                echo 'Deploying to ${target}...'
+            }
+        }
+`;
+    }
+}

package/bin/cicd/generators/template-loader.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Template loader for CI/CD generators
+ * Handles remote template fetching with fallback to embedded templates
+ */
+import type { GeneratorOptions } from "./github-actions";
+export interface TemplateResult {
+    content: string;
+    source: "remote" | "embedded";
+}
+/**
+ * Load CI/CD template with fallback
+ */
+export declare function loadCICDTemplate(platform: string, strategy: string, options: GeneratorOptions, embeddedGenerator: (options: GeneratorOptions) => string): Promise<TemplateResult>;
+/**
+ * Log template source for debugging
+ */
+export declare function logTemplateSource(platform: string, source: "remote" | "embedded"): void;

package/bin/cicd/generators/template-loader.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * Template loader for CI/CD generators
+ * Handles remote template fetching with fallback to embedded templates
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logTemplateSource = exports.loadCICDTemplate = void 0;
+const templates_1 = require("../../templates");
+/**
+ * Load CI/CD template with fallback
+ */
+async function loadCICDTemplate(platform, strategy, options, embeddedGenerator) {
+    const manager = (0, templates_1.getTemplateManager)();
+    try {
+        // Try to fetch from remote template repository
+        const result = await manager.fetchCICDTemplate(platform, strategy);
+        if (result.data) {
+            // Template found, render with variables
+            const renderOptions = {
+                variables: {
+                    projectName: options.projectName,
+                    nodeVersion: options.nodeVersion,
+                    packageManager: options.packageManager,
+                    strategy: options.strategy,
+                    includeSecurity: options.includeSecurity,
+                    includeE2E: options.includeE2E,
+                    includeCoverage: options.includeCoverage,
+                    dockerRegistry: options.dockerRegistry || "ghcr.io",
+                    deployTarget: options.deployTarget,
+                    branch: options.branch,
+                    port: options.port,
+                    // Computed variables
+                    installCmd: getInstallCommand(options.packageManager),
+                    testCmd: getTestCommand(options.packageManager),
+                    buildCmd: getBuildCommand(options.packageManager),
+                    lintCmd: getLintCommand(options.packageManager),
+                },
+                conditionals: {
+                    includeSecurity: options.includeSecurity,
+                    includeE2E: options.includeE2E,
+                    includeCoverage: options.includeCoverage,
+                    isComprehensive: options.strategy === "comprehensive",
+                    isSecurityFocused: options.strategy === "security-focused",
+                    hasDeployTarget: options.deployTarget !== "none",
+                    deployKubernetes: options.deployTarget === "kubernetes",
+                    deployRailway: options.deployTarget === "railway",
+                    deployRender: options.deployTarget === "render",
+                    deployFly: options.deployTarget === "fly",
+                    deployECS: options.deployTarget === "ecs",
+                    deployCloudRun: options.deployTarget === "cloudrun",
+                },
+            };
+            const rendered = manager.render(result.data, renderOptions);
+            return { content: rendered, source: "remote" };
+        }
+    }
+    catch {
+        // Remote fetch failed, fall back to embedded
+    }
+    // Fall back to embedded template generator
+    return {
+        content: embeddedGenerator(options),
+        source: "embedded",
+    };
+}
+exports.loadCICDTemplate = loadCICDTemplate;
+/**
+ * Get install command for package manager
+ */
+function getInstallCommand(packageManager) {
+    switch (packageManager) {
+        case "pnpm":
+            return "pnpm install";
+        case "yarn":
+            return "yarn install";
+        default:
+            return "npm ci";
+    }
+}
+/**
+ * Get test command for package manager
+ */
+function getTestCommand(packageManager) {
+    switch (packageManager) {
+        case "pnpm":
+            return "pnpm test";
+        case "yarn":
+            return "yarn test";
+        default:
+            return "npm test";
+    }
+}
+/**
+ * Get build command for package manager
+ */
+function getBuildCommand(packageManager) {
+    switch (packageManager) {
+        case "pnpm":
+            return "pnpm build";
+        case "yarn":
+            return "yarn build";
+        default:
+            return "npm run build";
+    }
+}
+/**
+ * Get lint command for package manager
+ */
+function getLintCommand(packageManager) {
+    switch (packageManager) {
+        case "pnpm":
+            return "pnpm lint";
+        case "yarn":
+            return "yarn lint";
+        default:
+            return "npm run lint";
+    }
+}
+/**
+ * Log template source for debugging
+ */
+function logTemplateSource(platform, source) {
+    if (process.env.EXPRESSOTS_DEBUG) {
+        const sourceLabel = source === "remote" ? "remote template" : "embedded template";
+        console.log(`  [DEBUG] ${platform}: Using ${sourceLabel}`);
+    }
+}
+exports.logTemplateSource = logTemplateSource;

package/bin/cicd/index.d.ts

@@ -0,0 +1 @@
+export { cicdCommand } from "./cli";

package/bin/cicd/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cicdCommand = void 0;
+var cli_1 = require("./cli");
+Object.defineProperty(exports, "cicdCommand", { enumerable: true, get: function () { return cli_1.cicdCommand; } });

package/bin/cli.d.ts

@@ -3,4 +3,4 @@
  * The current version of the ExpressoTS Bundle.
  * core, adapters, and cli.
  */
-export declare const BUNDLE_VERSION = "3.0.0";
+export declare const BUNDLE_VERSION = "4.0.0-preview.2";