@expressots/cli 3.0.0 → 4.0.0-preview.2

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

@@ -0,0 +1,138 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateComposeToRailway = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+async function generateComposeToRailway(outputDir, options) {
+    console.log(chalk_1.default.yellow("  Generating Docker Compose → Railway migration..."));
+    // Generate railway.json
+    const railwayConfig = {
+        $schema: "https://railway.app/railway.schema.json",
+        build: {
+            builder: "DOCKERFILE",
+            dockerfilePath: "Dockerfile",
+        },
+        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 service mapping
+    const serviceMapping = generateServiceMapping();
+    fs_1.default.writeFileSync(path_1.default.join(outputDir, "service-mapping.md"), serviceMapping, "utf-8");
+    console.log(chalk_1.default.green("    ✓ Created service-mapping.md"));
+    // Generate checklist
+    const checklist = generateRailwayFromComposeChecklist();
+    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"));
+}
+exports.generateComposeToRailway = generateComposeToRailway;
+function generateServiceMapping() {
+    return `# Service Mapping: Docker Compose → Railway
+
+## How Docker Compose Services Map to Railway
+
+| Compose Service | Railway Service | Notes |
+|-----------------|-----------------|-------|
+| Your app service | Railway Web Service | Main application |
+| postgres/mysql | Railway Database | Use Railway templates |
+| redis | Railway Redis | Use Railway Redis template |
+| nginx | Not needed | Railway handles routing |
+
+## Database Services
+
+Railway provides managed databases. Instead of running in a container:
+
+1. **PostgreSQL**: Add PostgreSQL service from Railway dashboard
+2. **MySQL**: Add MySQL service from Railway dashboard
+3. **Redis**: Add Redis service from Railway dashboard
+4. **MongoDB**: Add MongoDB service from Railway dashboard
+
+The connection strings are automatically injected as environment variables.
+
+## Volumes
+
+Railway handles persistent storage differently:
+
+- **Database data**: Managed by Railway database services
+- **File uploads**: Consider using S3/R2/GCS instead
+- **Logs**: Available in Railway dashboard
+
+## Environment Variables
+
+Docker Compose environment variables should be set in Railway:
+
+\`\`\`bash
+# Using Railway CLI
+railway variables set DATABASE_URL=\${{Postgres.DATABASE_URL}}
+railway variables set REDIS_URL=\${{Redis.REDIS_URL}}
+\`\`\`
+
+Or use the Railway dashboard for variable management.
+`;
+}
+function generateRailwayFromComposeChecklist() {
+    return `# Migration Checklist: Docker Compose → Railway
+
+## Pre-Migration
+
+- [ ] Review docker-compose.yml services
+- [ ] List all environment variables
+- [ ] Identify database and cache services
+- [ ] Ensure Dockerfile is working
+
+## Railway Setup
+
+- [ ] Create Railway account
+- [ ] Install CLI: \`npm install -g @railway/cli\`
+- [ ] Login: \`railway login\`
+- [ ] Create project: \`railway init\`
+
+## Service Migration
+
+### Main Application
+- [ ] Copy railway.json to project
+- [ ] Deploy: \`railway up\`
+- [ ] Verify deployment
+
+### Database (if applicable)
+- [ ] Add PostgreSQL/MySQL from Railway dashboard
+- [ ] Note the connection string variable
+- [ ] Update app to use Railway database URL
+
+### Redis (if applicable)
+- [ ] Add Redis from Railway dashboard
+- [ ] Update REDIS_URL to use Railway variable
+
+## Environment Variables
+
+- [ ] Set all required environment variables
+- [ ] Use \`\${{ServiceName.VARIABLE}}\` for service references
+- [ ] Verify with \`railway variables\`
+
+## Volumes & Persistent Data
+
+- [ ] Migrate file uploads to S3/R2 if applicable
+- [ ] Export database data and import to Railway
+
+## Networking
+
+- [ ] Configure custom domain (optional)
+- [ ] Railway handles SSL automatically
+
+## Post-Migration
+
+- [ ] Verify all endpoints
+- [ ] Monitor logs: \`railway logs\`
+- [ ] Stop docker-compose locally
+`;
+}

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

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

package/bin/migrate/generators/compose-to-render.js

@@ -0,0 +1,148 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateComposeToRender = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+async function generateComposeToRender(outputDir, options) {
+    console.log(chalk_1.default.yellow("  Generating Docker Compose → Render migration..."));
+    // Generate render.yaml blueprint
+    const renderConfig = generateRenderBlueprint();
+    fs_1.default.writeFileSync(path_1.default.join(outputDir, "render.yaml"), renderConfig, "utf-8");
+    console.log(chalk_1.default.green("    ✓ Created render.yaml"));
+    // Generate checklist
+    const checklist = generateRenderFromComposeChecklist();
+    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"));
+}
+exports.generateComposeToRender = generateComposeToRender;
+function generateRenderBlueprint() {
+    return `# Render Blueprint
+# Generated by ExpressoTS CLI
+# Migrated from Docker Compose
+
+services:
+  # Main application service
+  - type: web
+    name: expressots-app
+    env: docker
+    region: oregon
+    plan: starter
+    dockerfilePath: ./Dockerfile
+    dockerContext: .
+    healthCheckPath: /health
+    envVars:
+      - key: NODE_ENV
+        value: production
+      - key: PORT
+        value: 3000
+      # Reference database if created below
+      # - key: DATABASE_URL
+      #   fromDatabase:
+      #     name: expressots-db
+      #     property: connectionString
+      # - key: REDIS_URL
+      #   fromService:
+      #     name: expressots-redis
+      #     type: redis
+      #     property: connectionString
+
+# Uncomment to add PostgreSQL
+# databases:
+#   - name: expressots-db
+#     databaseName: expressots
+#     user: expressots
+#     plan: starter
+
+# Uncomment to add Redis
+# services:
+#   - type: redis
+#     name: expressots-redis
+#     plan: starter
+#     maxmemoryPolicy: noeviction
+`;
+}
+function generateRenderFromComposeChecklist() {
+    return `# Migration Checklist: Docker Compose → Render
+
+## Pre-Migration
+
+- [ ] Review docker-compose.yml
+- [ ] Ensure Dockerfile works standalone
+- [ ] List all services and their dependencies
+- [ ] Document environment variables
+
+## Render Setup
+
+- [ ] Create Render account at https://render.com
+- [ ] Connect GitHub/GitLab repository
+
+## Blueprint Deployment
+
+### Option 1: Using render.yaml (Recommended)
+- [ ] Copy render.yaml to project root
+- [ ] Customize services in render.yaml
+- [ ] Push to repository
+- [ ] In Render: New → Blueprint → Select repo
+
+### Option 2: Manual Setup
+- [ ] Create Web Service in Render dashboard
+- [ ] Connect repository
+- [ ] Set Docker environment
+- [ ] Configure environment variables
+
+## Service Migration
+
+### Main Application
+- [ ] Verify Dockerfile builds correctly
+- [ ] Set environment variables
+- [ ] Configure health check path
+
+### PostgreSQL
+- [ ] Create PostgreSQL in Render
+- [ ] Update DATABASE_URL env var
+- [ ] Migrate data from local/compose database
+
+### Redis
+- [ ] Create Redis in Render
+- [ ] Update REDIS_URL env var
+
+### Other Services
+- [ ] Review any other services in compose
+- [ ] Create equivalent Render services or use alternatives
+
+## Environment Variables
+
+Render provides references between services:
+
+\`\`\`yaml
+envVars:
+  - key: DATABASE_URL
+    fromDatabase:
+      name: my-db
+      property: connectionString
+\`\`\`
+
+## Persistent Data
+
+- [ ] Database data: Use Render managed databases
+- [ ] File uploads: Use Render Disk or S3
+- [ ] Logs: Available in Render dashboard
+
+## Custom Domain
+
+- [ ] Add custom domain in Render settings
+- [ ] Update DNS (CNAME to *.onrender.com)
+- [ ] SSL is automatic
+
+## Post-Migration
+
+- [ ] Verify all endpoints
+- [ ] Check logs in dashboard
+- [ ] Monitor performance
+- [ ] Remove local docker-compose setup if no longer needed
+`;
+}

package/bin/migrate/generators/generic-migration.d.ts

@@ -0,0 +1,9 @@
+import type { MigrationOptions } from "../form";
+interface MigrationPath {
+    from: string;
+    to: string;
+    description: string;
+    complexity: string;
+}
+export declare function generateGenericMigration(outputDir: string, options: MigrationOptions, migration?: MigrationPath): Promise<void>;
+export {};

package/bin/migrate/generators/generic-migration.js

@@ -0,0 +1,221 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateGenericMigration = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+async function generateGenericMigration(outputDir, options, migration) {
+    console.log(chalk_1.default.yellow(`  Generating ${options.from} → ${options.to} migration...`));
+    // Generate generic checklist
+    const checklist = generateGenericChecklist(options, migration);
+    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 environment mapping template
+    const envMapping = generateEnvMappingTemplate(options);
+    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 notes
+    const notes = generateMigrationNotes(options, migration);
+    fs_1.default.writeFileSync(path_1.default.join(outputDir, "MIGRATION_NOTES.md"), notes, "utf-8");
+    console.log(chalk_1.default.green("    ✓ Created MIGRATION_NOTES.md"));
+}
+exports.generateGenericMigration = generateGenericMigration;
+function generateGenericChecklist(options, migration) {
+    const complexity = migration?.complexity || "medium";
+    return `# Migration Checklist: ${options.from} → ${options.to}
+
+**Complexity**: ${complexity}
+
+## Pre-Migration
+
+- [ ] Document current infrastructure configuration
+- [ ] Export all environment variables
+- [ ] Backup databases and persistent data
+- [ ] Document current DNS configuration
+- [ ] List all external service dependencies
+
+## Target Platform Setup
+
+- [ ] Create account on ${options.to}
+- [ ] Set up CLI tools if available
+- [ ] Configure authentication
+- [ ] Create new project/application
+
+## Application Migration
+
+- [ ] Prepare application configuration for ${options.to}
+- [ ] Update build scripts if necessary
+- [ ] Configure deployment pipeline
+- [ ] Set up environment variables
+
+## Database Migration
+
+- [ ] Provision database on ${options.to}
+- [ ] Export data from source database
+- [ ] Import data to target database
+- [ ] Verify data integrity
+- [ ] Update DATABASE_URL configuration
+
+## Networking & DNS
+
+- [ ] Configure custom domain on ${options.to}
+- [ ] Set up SSL/TLS certificates
+- [ ] Update DNS records
+- [ ] Verify domain propagation
+
+## Testing
+
+- [ ] Deploy to staging environment
+- [ ] Run integration tests
+- [ ] Verify all API endpoints
+- [ ] Test database connectivity
+- [ ] Check external service integrations
+
+## Go-Live
+
+- [ ] Schedule maintenance window
+- [ ] Deploy to production
+- [ ] Update DNS to point to new platform
+- [ ] Monitor for 24-48 hours
+- [ ] Verify all functionality
+
+## Post-Migration
+
+- [ ] Document new infrastructure
+- [ ] Update team runbooks
+- [ ] Decommission old infrastructure
+- [ ] Update monitoring and alerts
+`;
+}
+function generateEnvMappingTemplate(options) {
+    return `# Environment Variable Mapping: ${options.from} → ${options.to}
+
+## Instructions
+
+1. Export environment variables from ${options.from}
+2. Map them to ${options.to} equivalents
+3. Set up variables on the new platform
+
+## Variable Template
+
+| Source Variable | Target Variable | Value/Reference | Notes |
+|-----------------|-----------------|-----------------|-------|
+| DATABASE_URL | DATABASE_URL | | Connection string |
+| REDIS_URL | REDIS_URL | | Cache connection |
+| NODE_ENV | NODE_ENV | production | |
+| PORT | PORT | 3000 | May be set automatically |
+| API_KEY | API_KEY | | Secret |
+| | | | |
+
+## Platform-Specific Variables
+
+Some platforms inject their own variables. Check ${options.to} documentation for:
+
+- Automatic PORT assignment
+- Database connection strings
+- Service discovery variables
+- Platform metadata
+
+## Secrets Management
+
+Consider using a secrets manager:
+- AWS Secrets Manager
+- HashiCorp Vault
+- Doppler
+- 1Password Secrets
+
+## Exporting from ${options.from}
+
+\`\`\`bash
+# Example commands - adjust for your source platform
+# Heroku
+heroku config --app your-app --shell > .env.backup
+
+# Docker Compose
+docker-compose config | grep -A 100 environment > env-backup.txt
+
+# Kubernetes
+kubectl get configmap your-config -o yaml > configmap-backup.yaml
+kubectl get secret your-secret -o yaml > secret-backup.yaml
+\`\`\`
+`;
+}
+function generateMigrationNotes(options, migration) {
+    return `# Migration Notes: ${options.from} → ${options.to}
+
+## Overview
+
+This document contains notes and considerations for migrating from ${options.from} to ${options.to}.
+
+${migration
+        ? `
+**Complexity**: ${migration.complexity}
+**Description**: ${migration.description}
+`
+        : ""}
+
+## Key Differences
+
+### Compute Model
+Document the differences in compute model between platforms:
+- Containers vs VMs vs Serverless
+- Scaling approach
+- Cold start behavior
+
+### Networking
+- How services communicate
+- Load balancing
+- SSL/TLS handling
+
+### Storage
+- Persistent storage options
+- Database services
+- File storage
+
+### Deployment
+- CI/CD integration
+- Rollback mechanisms
+- Blue-green deployments
+
+## Potential Issues
+
+1. **Platform-specific features**: Some features from ${options.from} may not exist on ${options.to}
+2. **Performance differences**: Initial performance may differ
+3. **Cost structure**: Pricing models may be different
+4. **Vendor lock-in**: Watch for platform-specific services
+
+## Resources
+
+- ${options.to} documentation
+- Migration guides
+- Community forums
+- Support channels
+
+## Rollback Plan
+
+If migration fails:
+
+1. Revert DNS to original platform
+2. Re-enable ${options.from} services
+3. Investigate issues
+4. Plan remediation
+5. Retry migration
+
+## Timeline Estimate
+
+- Preparation: 1-2 days
+- Migration: 1-4 hours (depending on complexity)
+- Monitoring: 24-48 hours
+- Cleanup: 1 day
+
+## Sign-off
+
+- [ ] Development team reviewed
+- [ ] Operations team reviewed
+- [ ] Stakeholders notified
+- [ ] Rollback plan tested
+`;
+}

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

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