@expressots/cli 3.0.0 → 4.0.0-preview.2

package/bin/migrate/generators/heroku-to-fly.js

@@ -0,0 +1,291 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateHerokuToFly = 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 generateHerokuToFly(outputDir, options) {
+    console.log(chalk_1.default.yellow("  Generating Heroku → Fly.io migration..."));
+    const vars = (0, template_loader_1.buildMigrationVars)(options);
+    // Generate fly.toml
+    const flyConfig = `# Fly.io Configuration
+# Generated by ExpressoTS CLI
+
+app = "expressots-app"
+primary_region = "iad"
+kill_signal = "SIGINT"
+kill_timeout = "5s"
+
+[experimental]
+  auto_rollback = true
+
+[build]
+  # Uses Dockerfile by default
+  # Or use Nixpacks:
+  # builder = "nixpacks"
+
+[env]
+  NODE_ENV = "production"
+  PORT = "3000"
+
+[http_service]
+  internal_port = 3000
+  force_https = true
+  auto_stop_machines = true
+  auto_start_machines = true
+  min_machines_running = 0
+  processes = ["app"]
+
+[[services]]
+  protocol = "tcp"
+  internal_port = 3000
+  processes = ["app"]
+
+  [[services.ports]]
+    port = 80
+    handlers = ["http"]
+    force_https = true
+
+  [[services.ports]]
+    port = 443
+    handlers = ["tls", "http"]
+
+  [services.concurrency]
+    type = "connections"
+    hard_limit = 25
+    soft_limit = 20
+
+  [[services.tcp_checks]]
+    interval = "15s"
+    timeout = "2s"
+    grace_period = "1s"
+
+  [[services.http_checks]]
+    interval = "10s"
+    timeout = "2s"
+    grace_period = "5s"
+    method = "GET"
+    path = "/health"
+    protocol = "http"
+`;
+    fs_1.default.writeFileSync(path_1.default.join(outputDir, "fly.toml"), flyConfig, "utf-8");
+    console.log(chalk_1.default.green("    ✓ Created fly.toml"));
+    // Generate migration checklist
+    const checklist = generateFlyChecklist();
+    fs_1.default.writeFileSync(path_1.default.join(outputDir, "MIGRATION_CHECKLIST.md"), checklist, "utf-8");
+    console.log(chalk_1.default.green("    ✓ Created MIGRATION_CHECKLIST.md"));
+    // Generate migration scripts (cross-platform)
+    const nodeScript = generateFlyMigrationScriptNode();
+    fs_1.default.writeFileSync(path_1.default.join(outputDir, "migrate.js"), nodeScript, "utf-8");
+    console.log(chalk_1.default.green("    ✓ Created migrate.js (cross-platform)"));
+    // Also generate bash script for Unix users
+    const bashScript = generateFlyMigrationScriptBash();
+    fs_1.default.writeFileSync(path_1.default.join(outputDir, "migrate.sh"), bashScript, "utf-8");
+    console.log(chalk_1.default.green("    ✓ Created migrate.sh (Unix/Mac)"));
+}
+exports.generateHerokuToFly = generateHerokuToFly;
+function generateFlyChecklist() {
+    return `# Migration Checklist: Heroku → Fly.io
+
+## Pre-Migration
+
+Install Fly CLI:
+- **Windows**: \`powershell -Command "iwr https://fly.io/install.ps1 -useb | iex"\`
+- **Mac/Linux**: \`curl -L https://fly.io/install.sh | sh\`
+
+- [ ] Create account: \`fly auth signup\` or \`fly auth login\`
+- [ ] Export Heroku config: \`heroku config --app your-app\`
+
+## Automated Migration Script
+
+\`\`\`bash
+# Set your app name
+export HEROKU_APP_NAME=your-app   # Mac/Linux
+set HEROKU_APP_NAME=your-app      # Windows CMD
+$env:HEROKU_APP_NAME="your-app"   # Windows PowerShell
+
+# Run migration
+node migrate.js
+\`\`\`
+
+## Fly.io Setup
+
+- [ ] Copy \`fly.toml\` to project root
+- [ ] Create app: \`fly apps create expressots-app\`
+- [ ] Set secrets: \`fly secrets set KEY=value\`
+
+## Database (if using PostgreSQL)
+
+- [ ] Create Fly Postgres: \`fly postgres create\`
+- [ ] Attach to app: \`fly postgres attach --app expressots-app\`
+- [ ] Export Heroku data and import to Fly Postgres
+
+## Deployment
+
+- [ ] Deploy: \`fly deploy\`
+- [ ] Check status: \`fly status\`
+- [ ] View logs: \`fly logs\`
+
+## Custom Domain
+
+- [ ] Add certificate: \`fly certs add your-domain.com\`
+- [ ] Update DNS to point to Fly
+
+## Scaling
+
+- [ ] Adjust scaling: \`fly scale count 2\`
+- [ ] Set memory: \`fly scale memory 512\`
+
+## Post-Migration
+
+- [ ] Verify endpoints
+- [ ] Monitor metrics: \`fly dashboard\`
+- [ ] Disable Heroku after verification
+`;
+}
+function generateFlyMigrationScriptNode() {
+    return `#!/usr/bin/env node
+/**
+ * Migration Script: Heroku → Fly.io
+ * Generated by ExpressoTS CLI
+ * Cross-platform (Windows, macOS, Linux)
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+
+const HEROKU_APP = process.env.HEROKU_APP_NAME || 'your-app';
+const FLY_APP = process.env.FLY_APP_NAME || 'expressots-app';
+
+function run(cmd, options = {}) {
+    console.log(\`  Running: \${cmd}\`);
+    try {
+        return execSync(cmd, { encoding: 'utf-8', stdio: 'inherit', ...options });
+    } catch (error) {
+        if (!options.ignoreError) {
+            console.error(\`  Error: \${error.message}\`);
+            process.exit(1);
+        }
+    }
+}
+
+function checkCommand(cmd) {
+    try {
+        execSync(\`\${cmd} version\`, { stdio: 'pipe' });
+        return true;
+    } catch {
+        try {
+            execSync(\`\${cmd} --version\`, { stdio: 'pipe' });
+            return true;
+        } catch {
+            return false;
+        }
+    }
+}
+
+async function main() {
+    console.log('\\n🪰 Starting Heroku → Fly.io Migration\\n');
+
+    // Check prerequisites
+    if (!checkCommand('fly') && !checkCommand('flyctl')) {
+        console.error('❌ Fly CLI required.');
+        console.error('   Windows: powershell -Command "iwr https://fly.io/install.ps1 -useb | iex"');
+        console.error('   Mac/Linux: curl -L https://fly.io/install.sh | sh');
+        process.exit(1);
+    }
+
+    const flyCmd = checkCommand('flyctl') ? 'flyctl' : 'fly';
+
+    // Export Heroku config (if available)
+    if (checkCommand('heroku')) {
+        console.log('📦 Exporting Heroku configuration...');
+        try {
+            const config = execSync(\`heroku config --app \${HEROKU_APP} --shell\`, { encoding: 'utf-8' });
+            fs.writeFileSync('.env.heroku', config);
+            console.log('  ✓ Exported to .env.heroku');
+        } catch {
+            console.log('  ⚠ Could not export. Set HEROKU_APP_NAME env var.');
+        }
+    }
+
+    // Create Fly app
+    console.log('\\n🪰 Creating Fly app...');
+    run(\`\${flyCmd} apps create \${FLY_APP}\`, { ignoreError: true });
+
+    // Import secrets
+    if (fs.existsSync('.env.heroku')) {
+        console.log('\\n🔐 Setting secrets...');
+        const envContent = fs.readFileSync('.env.heroku', 'utf-8');
+        const lines = envContent.split('\\n');
+        
+        for (const line of lines) {
+            const match = line.match(/^([A-Z_][A-Z0-9_]*)=(.*)$/);
+            if (match) {
+                const [, key, value] = match;
+                console.log(\`  Setting \${key}...\`);
+                run(\`\${flyCmd} secrets set "\${key}=\${value}" --app \${FLY_APP}\`, { ignoreError: true });
+            }
+        }
+    }
+
+    // Deploy
+    console.log('\\n🚀 Deploying to Fly.io...');
+    run(\`\${flyCmd} deploy\`);
+
+    console.log('\\n✅ Migration complete!');
+    console.log(\`   Dashboard: \${flyCmd} dashboard\`);
+    console.log(\`   Logs: \${flyCmd} logs\\n\`);
+}
+
+main().catch(console.error);
+`;
+}
+function generateFlyMigrationScriptBash() {
+    return `#!/bin/bash
+# Migration Script: Heroku → Fly.io
+# Generated by ExpressoTS CLI
+# For Unix/macOS - Windows users: use migrate.js instead
+
+set -e
+
+echo "🪰 Starting Heroku → Fly.io Migration"
+
+# Check prerequisites
+command -v fly >/dev/null 2>&1 || command -v flyctl >/dev/null 2>&1 || { 
+    echo "Fly CLI required. Install: curl -L https://fly.io/install.sh | sh"
+    exit 1
+}
+
+FLY_CMD="fly"
+command -v flyctl >/dev/null 2>&1 && FLY_CMD="flyctl"
+
+# Export Heroku config
+echo "📦 Exporting Heroku configuration..."
+heroku config --app \${HEROKU_APP_NAME:-your-app} --shell > .env.heroku
+
+# Create Fly app
+echo "🪰 Creating Fly app..."
+$FLY_CMD apps create \${FLY_APP_NAME:-expressots-app} || echo "App may already exist"
+
+# Set secrets from Heroku config
+echo "🔐 Setting secrets..."
+while IFS='=' read -r key value; do
+    if [[ ! -z "$key" && ! "$key" =~ ^# ]]; then
+        echo "  Setting $key..."
+        $FLY_CMD secrets set "$key=$value" --app \${FLY_APP_NAME:-expressots-app}
+    fi
+done < .env.heroku
+
+# Deploy
+echo "🚀 Deploying to Fly.io..."
+$FLY_CMD deploy
+
+echo "✅ Migration complete!"
+echo "   Dashboard: $FLY_CMD dashboard"
+echo "   Logs: $FLY_CMD logs"
+`;
+}

package/bin/migrate/generators/heroku-to-railway.d.ts

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

package/bin/migrate/generators/heroku-to-railway.js

@@ -0,0 +1,283 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateHerokuToRailway = 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 generateHerokuToRailway(outputDir, options) {
+    console.log(chalk_1.default.yellow("  Generating Heroku → Railway migration..."));
+    const vars = (0, template_loader_1.buildMigrationVars)(options);
+    // Generate railway.json
+    const railwayConfig = {
+        $schema: "https://railway.app/railway.schema.json",
+        build: {
+            builder: "NIXPACKS",
+        },
+        deploy: {
+            startCommand: "npm start",
+            healthcheckPath: "/health",
+            healthcheckTimeout: 300,
+            restartPolicyType: "ON_FAILURE",
+            restartPolicyMaxRetries: 10,
+        },
+    };
+    fs_1.default.writeFileSync(path_1.default.join(outputDir, "railway.json"), JSON.stringify(railwayConfig, null, 2), "utf-8");
+    console.log(chalk_1.default.green("    ✓ Created railway.json"));
+    // Generate environment variable mapping
+    if (options.includeSecrets) {
+        const envMapping = generateEnvMapping();
+        fs_1.default.writeFileSync(path_1.default.join(outputDir, "env-mapping.md"), envMapping, "utf-8");
+        console.log(chalk_1.default.green("    ✓ Created env-mapping.md"));
+    }
+    // Generate migration checklist (try remote template first)
+    const checklistResult = await (0, template_loader_1.loadMigrationTemplate)("heroku", "railway", "checklist", vars, () => generateChecklist(options));
+    (0, template_loader_1.logTemplateSource)("MIGRATION_CHECKLIST.md", checklistResult.source);
+    fs_1.default.writeFileSync(path_1.default.join(outputDir, "MIGRATION_CHECKLIST.md"), checklistResult.content, "utf-8");
+    console.log(chalk_1.default.green("    ✓ Created MIGRATION_CHECKLIST.md"));
+    // Generate migration scripts (cross-platform)
+    const nodeScript = generateMigrationScriptNode();
+    fs_1.default.writeFileSync(path_1.default.join(outputDir, "migrate.js"), nodeScript, "utf-8");
+    console.log(chalk_1.default.green("    ✓ Created migrate.js (cross-platform)"));
+    // Also generate bash script for Unix users
+    const bashScript = generateMigrationScriptBash();
+    fs_1.default.writeFileSync(path_1.default.join(outputDir, "migrate.sh"), bashScript, "utf-8");
+    console.log(chalk_1.default.green("    ✓ Created migrate.sh (Unix/Mac)"));
+}
+exports.generateHerokuToRailway = generateHerokuToRailway;
+function generateEnvMapping() {
+    return `# Environment Variable Mapping: Heroku → Railway
+
+## Common Variable Translations
+
+| Heroku Variable | Railway Variable | Notes |
+|-----------------|------------------|-------|
+| \`DATABASE_URL\` | \`DATABASE_URL\` | Same format, Railway provides PostgreSQL |
+| \`REDIS_URL\` | \`REDIS_URL\` | Same format |
+| \`PORT\` | \`PORT\` | Railway sets this automatically |
+| \`NODE_ENV\` | \`NODE_ENV\` | Set to \`production\` |
+| \`HEROKU_APP_NAME\` | \`RAILWAY_SERVICE_NAME\` | Service name |
+
+## Database Migration
+
+If using Heroku Postgres:
+1. Export data: \`heroku pg:backups:capture --app your-app\`
+2. Download: \`heroku pg:backups:download --app your-app\`
+3. Import to Railway PostgreSQL instance
+
+## Steps to Set Environment Variables
+
+\`\`\`bash
+# List Heroku config vars
+heroku config --app your-app
+
+# Set Railway variables via CLI
+railway variables set KEY=value
+
+# Or use Railway dashboard
+# https://railway.app/project/[project-id]/settings
+\`\`\`
+`;
+}
+function generateChecklist(options) {
+    return `# Migration Checklist: Heroku → Railway
+
+## Pre-Migration
+
+- [ ] Export Heroku environment variables: \`heroku config --app your-app > .env.heroku\`
+- [ ] Backup database if applicable
+- [ ] Document current Heroku add-ons
+- [ ] Note current dyno configuration
+
+## Automated Migration Script
+
+Run the cross-platform migration script:
+\`\`\`bash
+# Set your app name
+export HEROKU_APP_NAME=your-app   # Mac/Linux
+set HEROKU_APP_NAME=your-app      # Windows CMD
+$env:HEROKU_APP_NAME="your-app"   # Windows PowerShell
+
+# Run migration
+node migrate.js
+\`\`\`
+
+## Railway Setup (Manual)
+
+- [ ] Create Railway account at https://railway.app
+- [ ] Install Railway CLI: \`npm install -g @railway/cli\`
+- [ ] Login: \`railway login\`
+- [ ] Create new project: \`railway init\`
+
+## Configuration
+
+- [ ] Copy \`railway.json\` to your project root
+- [ ] Set environment variables in Railway dashboard
+- [ ] Configure custom domain (if needed)
+
+## Database Migration
+
+- [ ] Provision PostgreSQL on Railway
+- [ ] Export Heroku database
+- [ ] Import to Railway PostgreSQL
+- [ ] Update \`DATABASE_URL\`
+
+## Deployment
+
+- [ ] Deploy: \`railway up\`
+- [ ] Verify deployment in Railway dashboard
+- [ ] Test application endpoints
+- [ ] Monitor logs: \`railway logs\`
+
+## DNS & Domain
+
+- [ ] Add custom domain in Railway
+- [ ] Update DNS records
+- [ ] Verify SSL certificate
+
+## Post-Migration
+
+- [ ] Monitor for 24-48 hours
+- [ ] Disable Heroku app
+- [ ] Delete Heroku resources after verification
+
+## Rollback Plan
+
+If issues occur:
+1. Re-enable Heroku app
+2. Point DNS back to Heroku
+3. Investigate and fix Railway deployment
+`;
+}
+function generateMigrationScriptNode() {
+    return `#!/usr/bin/env node
+/**
+ * Migration Script: Heroku → Railway
+ * Generated by ExpressoTS CLI
+ * Cross-platform (Windows, macOS, Linux)
+ */
+
+const { execSync, spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const HEROKU_APP = process.env.HEROKU_APP_NAME || 'your-app';
+
+function run(cmd, options = {}) {
+    console.log(\`  Running: \${cmd}\`);
+    try {
+        return execSync(cmd, { encoding: 'utf-8', stdio: 'inherit', ...options });
+    } catch (error) {
+        if (!options.ignoreError) {
+            console.error(\`  Error: \${error.message}\`);
+            process.exit(1);
+        }
+    }
+}
+
+function checkCommand(cmd) {
+    try {
+        execSync(\`\${cmd} --version\`, { stdio: 'pipe' });
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+async function main() {
+    console.log('\\n🚀 Starting Heroku → Railway Migration\\n');
+
+    // Check prerequisites
+    if (!checkCommand('railway')) {
+        console.error('❌ Railway CLI required. Install: npm i -g @railway/cli');
+        process.exit(1);
+    }
+
+    // Export Heroku config (if heroku CLI available)
+    if (checkCommand('heroku')) {
+        console.log('📦 Exporting Heroku configuration...');
+        try {
+            const config = execSync(\`heroku config --app \${HEROKU_APP} --shell\`, { encoding: 'utf-8' });
+            fs.writeFileSync('.env.heroku', config);
+            console.log('  ✓ Exported to .env.heroku');
+        } catch {
+            console.log('  ⚠ Could not export Heroku config. Set HEROKU_APP_NAME env var.');
+        }
+    } else {
+        console.log('⚠ Heroku CLI not found. Skipping config export.');
+        console.log('  Manually export your environment variables.');
+    }
+
+    // Initialize Railway project
+    console.log('\\n🚂 Initializing Railway project...');
+    run('railway init', { ignoreError: true });
+
+    // Import environment variables
+    if (fs.existsSync('.env.heroku')) {
+        console.log('\\n🔐 Setting up environment variables...');
+        const envContent = fs.readFileSync('.env.heroku', 'utf-8');
+        const lines = envContent.split('\\n');
+        
+        for (const line of lines) {
+            const match = line.match(/^([A-Z_][A-Z0-9_]*)=(.*)$/);
+            if (match) {
+                const [, key, value] = match;
+                console.log(\`  Setting \${key}...\`);
+                run(\`railway variables set "\${key}=\${value}"\`, { ignoreError: true });
+            }
+        }
+    }
+
+    // Deploy
+    console.log('\\n🚀 Deploying to Railway...');
+    run('railway up');
+
+    console.log('\\n✅ Migration complete!');
+    console.log('   Check your deployment at: https://railway.app/dashboard\\n');
+}
+
+main().catch(console.error);
+`;
+}
+function generateMigrationScriptBash() {
+    return `#!/bin/bash
+# Migration Script: Heroku → Railway
+# Generated by ExpressoTS CLI
+# For Unix/macOS - Windows users: use migrate.js instead
+
+set -e
+
+echo "🚀 Starting Heroku → Railway Migration"
+
+# Check prerequisites
+command -v railway >/dev/null 2>&1 || { echo "Railway CLI required. Install: npm i -g @railway/cli"; exit 1; }
+command -v heroku >/dev/null 2>&1 || { echo "Heroku CLI required."; exit 1; }
+
+# Export Heroku config
+echo "📦 Exporting Heroku configuration..."
+heroku config --app \${HEROKU_APP_NAME:-your-app} --shell > .env.heroku
+
+# Initialize Railway project
+echo "🚂 Initializing Railway project..."
+railway init
+
+# Copy environment variables
+echo "🔐 Setting up environment variables..."
+while IFS='=' read -r key value; do
+    if [[ ! -z "$key" && ! "$key" =~ ^# ]]; then
+        echo "  Setting $key..."
+        railway variables set "$key=$value"
+    fi
+done < .env.heroku
+
+# Deploy
+echo "🚀 Deploying to Railway..."
+railway up
+
+echo "✅ Migration complete!"
+echo "   Check your deployment at: https://railway.app/dashboard"
+`;
+}

package/bin/migrate/generators/heroku-to-render.d.ts

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