@onroad/core 4.0.0-alpha.1 → 4.0.0-alpha.11

package/dist/dev/DevServer.js

@@ -0,0 +1,417 @@
+import { execSync } from "child_process";
+import { existsSync, writeFileSync } from "fs";
+import { resolve } from "path";
+// --- Main Class ---
+export class DevServer {
+    app;
+    logger;
+    databases;
+    frontendVars;
+    migrationsPath;
+    projectRoot;
+    autoMigrate;
+    composeFile;
+    tenants;
+    containers = [];
+    composeCmd = null;
+    constructor(config) {
+        this.app = config.app;
+        this.logger = config.app.logger;
+        this.databases = config.databases ?? [{ engine: "postgres" }];
+        this.frontendVars = config.frontendVars ?? {};
+        this.migrationsPath = config.migrationsPath;
+        this.projectRoot = config.projectRoot ?? process.cwd();
+        this.autoMigrate = config.autoMigrate ?? true;
+        this.composeFile = config.composeFile ?? "docker-compose.dev.yml";
+        this.tenants = config.tenants ?? ["default"];
+    }
+    // --- Public API ---
+    async start(buildConfig = {}) {
+        this.printBanner();
+        // 1. Generate docker-compose if not exists
+        this.ensureComposeFile();
+        // 2. Start database containers
+        await this.startContainers();
+        // 3. Wait for database readiness
+        await this.waitForDatabases();
+        // 4. Run migrations (if configured)
+        if (this.autoMigrate && this.migrationsPath) {
+            await this.runMigrations();
+        }
+        // 5. Build and start the OnRoadExpress server
+        const port = buildConfig.port ?? 3000;
+        await this.app.buildServer({
+            ...buildConfig,
+            port,
+        });
+        // 6. Log frontend env vars
+        this.printFrontendEnvVars(port);
+        // 7. Log summary
+        this.printSummary(port);
+    }
+    async stop() {
+        this.logger.info("Stopping DevServer...");
+        await this.app.shutdown();
+        this.stopContainers();
+        this.logger.info("DevServer stopped");
+    }
+    // --- Docker Compose ---
+    ensureComposeFile() {
+        const composePath = resolve(this.projectRoot, this.composeFile);
+        if (existsSync(composePath)) {
+            this.logger.debug("Docker Compose file already exists", { path: composePath });
+            return;
+        }
+        const content = this.generateComposeContent();
+        writeFileSync(composePath, content, "utf-8");
+        this.logger.info("Generated docker-compose.dev.yml", { path: composePath });
+    }
+    generateComposeContent() {
+        const services = [];
+        const volumes = [];
+        for (const db of this.databases) {
+            const defaults = DB_DEFAULTS[db.engine];
+            const containerName = db.containerName ?? `typeroad-dev-${db.engine}`;
+            const port = db.port ?? defaults.port;
+            const user = db.user ?? defaults.user;
+            const password = db.password ?? defaults.password;
+            const database = db.database ?? defaults.database;
+            const image = db.image ?? defaults.image;
+            const volumeName = `${containerName}-data`;
+            this.containers.push({
+                name: containerName,
+                port,
+                engine: db.engine,
+                host: "localhost",
+                user,
+                password,
+                database,
+            });
+            if (db.engine === "postgres") {
+                services.push(`  ${containerName}:
+    image: ${image}
+    container_name: ${containerName}
+    restart: unless-stopped
+    ports:
+      - "${port}:5432"
+    environment:
+      POSTGRES_USER: ${user}
+      POSTGRES_PASSWORD: ${password}
+      POSTGRES_DB: ${database}
+    volumes:
+      - ${volumeName}:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${user} -d ${database}"]
+      interval: 2s
+      timeout: 5s
+      retries: 15`);
+            }
+            else if (db.engine === "mysql") {
+                services.push(`  ${containerName}:
+    image: ${image}
+    container_name: ${containerName}
+    restart: unless-stopped
+    ports:
+      - "${port}:3306"
+    environment:
+      MYSQL_ROOT_PASSWORD: ${password}
+      MYSQL_USER: ${user}
+      MYSQL_PASSWORD: ${password}
+      MYSQL_DATABASE: ${database}
+    volumes:
+      - ${volumeName}:/var/lib/mysql
+    healthcheck:
+      test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "${user}", "-p${password}"]
+      interval: 2s
+      timeout: 5s
+      retries: 15`);
+            }
+            volumes.push(`  ${volumeName}:`);
+        }
+        return `# Auto-generated by TypeRoad DevServer
+# Do not commit — add to .gitignore
+
+services:
+${services.join("\n\n")}
+
+volumes:
+${volumes.join("\n")}
+`;
+    }
+    // --- Container Management ---
+    getComposeCommand() {
+        if (this.composeCmd)
+            return this.composeCmd;
+        // Try docker compose v2 (plugin) first, then docker-compose v1 (standalone)
+        try {
+            execSync("docker compose version", { stdio: "pipe" });
+            this.composeCmd = "docker compose";
+            return this.composeCmd;
+        }
+        catch {
+            // v2 not available
+        }
+        try {
+            execSync("docker-compose --version", { stdio: "pipe" });
+            this.composeCmd = "docker-compose";
+            return this.composeCmd;
+        }
+        catch {
+            // v1 not available
+        }
+        throw new Error("[TypeRoad DevServer] Neither 'docker compose' (v2) nor 'docker-compose' (v1) found. Install Docker Desktop or Docker Compose.");
+    }
+    async startContainers() {
+        const composePath = resolve(this.projectRoot, this.composeFile);
+        if (!this.isDockerAvailable()) {
+            throw new Error("[TypeRoad DevServer] Docker is not available. Install Docker Desktop or Docker Engine to use DevServer.");
+        }
+        const cmd = this.getComposeCommand();
+        this.logger.info(`Starting database containers... (using: ${cmd})`);
+        const maxRetries = 3;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            try {
+                execSync(`${cmd} -f "${composePath}" up -d`, {
+                    cwd: this.projectRoot,
+                    stdio: "pipe",
+                });
+                return;
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                // Transient Docker errors (closed pipe, daemon restart) — retry
+                if (attempt < maxRetries && (msg.includes("closed pipe") || msg.includes("connection refused"))) {
+                    this.logger.warn(`Docker transient error (attempt ${attempt}/${maxRetries}), retrying in 3s...`);
+                    execSync("sleep 3");
+                    continue;
+                }
+                throw new Error(`[TypeRoad DevServer] Failed to start containers: ${msg}`);
+            }
+        }
+    }
+    stopContainers() {
+        const composePath = resolve(this.projectRoot, this.composeFile);
+        try {
+            const cmd = this.getComposeCommand();
+            execSync(`${cmd} -f "${composePath}" down`, {
+                cwd: this.projectRoot,
+                stdio: "pipe",
+            });
+        }
+        catch {
+            this.logger.warn("Failed to stop containers — stop them manually");
+        }
+    }
+    isDockerAvailable() {
+        try {
+            execSync("docker info", { stdio: "pipe" });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // --- DB Readiness ---
+    async waitForDatabases() {
+        // Re-read containers info from compose if not already populated
+        if (this.containers.length === 0) {
+            this.populateContainersFromConfig();
+        }
+        for (const container of this.containers) {
+            this.logger.info(`Waiting for ${container.engine} (${container.name}) to be ready...`);
+            await this.waitForContainer(container);
+            this.logger.info(`${container.engine} (${container.name}) is ready`);
+        }
+    }
+    async waitForContainer(container, maxRetries = 30) {
+        for (let i = 0; i < maxRetries; i++) {
+            try {
+                if (container.engine === "postgres") {
+                    execSync(`docker exec ${container.name} pg_isready -U ${container.user} -d ${container.database}`, { stdio: "pipe" });
+                    return;
+                }
+                else if (container.engine === "mysql") {
+                    execSync(`docker exec ${container.name} mysqladmin ping -h localhost -u ${container.user} -p${container.password}`, { stdio: "pipe" });
+                    return;
+                }
+            }
+            catch {
+                // Not ready yet
+            }
+            await sleep(1000);
+        }
+        throw new Error(`[TypeRoad DevServer] Database ${container.name} failed to start within ${maxRetries}s`);
+    }
+    populateContainersFromConfig() {
+        for (const db of this.databases) {
+            const defaults = DB_DEFAULTS[db.engine];
+            this.containers.push({
+                name: db.containerName ?? `typeroad-dev-${db.engine}`,
+                port: db.port ?? defaults.port,
+                engine: db.engine,
+                host: "localhost",
+                user: db.user ?? defaults.user,
+                password: db.password ?? defaults.password,
+                database: db.database ?? defaults.database,
+            });
+        }
+    }
+    // --- Migrations ---
+    async waitForSequelizeConnection(maxRetries = 15) {
+        // Use a raw Sequelize connection to verify readiness
+        // without going through getConnection() which triggers runOnConnect migrations
+        if (this.containers.length === 0)
+            return;
+        const container = this.containers[0];
+        const { Sequelize } = await import("sequelize");
+        for (let i = 0; i < maxRetries; i++) {
+            let probe = null;
+            try {
+                probe = new Sequelize(container.database, container.user, container.password, {
+                    host: container.host,
+                    port: container.port,
+                    dialect: container.engine,
+                    logging: false,
+                });
+                await probe.authenticate();
+                await probe.close();
+                this.logger.info("Database connection verified");
+                return;
+            }
+            catch {
+                if (probe)
+                    try {
+                        await probe.close();
+                    }
+                    catch { /* ignore */ }
+                if (i < maxRetries - 1) {
+                    await sleep(2000);
+                }
+            }
+        }
+        this.logger.warn("Could not verify Sequelize connection — proceeding anyway");
+    }
+    async runMigrations() {
+        // Wait for the actual Sequelize connection to be stable
+        await this.waitForSequelizeConnection();
+        this.logger.info("Running database migrations...");
+        const connections = this.app.getConnections();
+        for (const conn of connections) {
+            if (conn.engine !== "sequelize")
+                continue;
+            const seqConn = conn;
+            for (const tenant of this.tenants) {
+                try {
+                    const runner = await seqConn.getMigrationRunner(tenant);
+                    const applied = await runner.up();
+                    if (applied.length > 0) {
+                        this.logger.info(`Migrations applied for tenant "${tenant}"`, {
+                            count: applied.length,
+                            migrations: applied,
+                        });
+                    }
+                    else {
+                        this.logger.info(`No pending migrations for tenant "${tenant}"`);
+                    }
+                }
+                catch (err) {
+                    this.logger.warn(`Migration failed for tenant "${tenant}" — continuing`, {
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+        }
+    }
+    // --- Frontend Env Var Logging ---
+    printFrontendEnvVars(port) {
+        const baseUrl = `http://localhost:${port}`;
+        const vars = {
+            REACT_APP_API_URL: baseUrl,
+            NEXT_PUBLIC_API_URL: baseUrl,
+            VITE_API_URL: baseUrl,
+            API_BASE_URL: baseUrl,
+            ...this.frontendVars,
+        };
+        // Add database connection vars
+        for (const container of this.containers) {
+            const prefix = container.engine.toUpperCase();
+            vars[`${prefix}_HOST`] = container.host;
+            vars[`${prefix}_PORT`] = String(container.port);
+            vars[`${prefix}_USER`] = container.user;
+            vars[`${prefix}_PASSWORD`] = container.password;
+            vars[`${prefix}_DATABASE`] = container.database;
+            if (container.engine === "postgres") {
+                vars.DATABASE_URL = `postgresql://${container.user}:${container.password}@${container.host}:${container.port}/${container.database}`;
+            }
+            else if (container.engine === "mysql") {
+                vars.DATABASE_URL = `mysql://${container.user}:${container.password}@${container.host}:${container.port}/${container.database}`;
+            }
+        }
+        console.log("");
+        console.log("┌──────────────────────────────────────────────────────────────┐");
+        console.log("│              FRONTEND ENVIRONMENT VARIABLES                  │");
+        console.log("├──────────────────────────────────────────────────────────────┤");
+        const envFileLines = [];
+        for (const [key, value] of Object.entries(vars)) {
+            console.log(`│  ${key}=${value}`);
+            envFileLines.push(`${key}=${value}`);
+        }
+        console.log("├──────────────────────────────────────────────────────────────┤");
+        console.log("│  Copy the above to your frontend .env file                  │");
+        console.log("└──────────────────────────────────────────────────────────────┘");
+        console.log("");
+        // Write .env.local for convenience
+        const envPath = resolve(this.projectRoot, ".env.dev");
+        writeFileSync(envPath, envFileLines.join("\n") + "\n", "utf-8");
+        this.logger.info("Environment variables written to .env.dev", { path: envPath });
+    }
+    // --- Banner & Summary ---
+    printBanner() {
+        console.log("");
+        console.log("  ╔══════════════════════════════════════╗");
+        console.log("  ║      TypeRoad DevServer v1.0         ║");
+        console.log("  ║   Local Development Environment      ║");
+        console.log("  ╚══════════════════════════════════════╝");
+        console.log("");
+    }
+    printSummary(port) {
+        console.log("");
+        console.log("┌──────────────────────────────────────────────────────────────┐");
+        console.log("│                    SERVER READY                              │");
+        console.log("├──────────────────────────────────────────────────────────────┤");
+        console.log(`│  API:      http://localhost:${port}`);
+        console.log(`│  Health:   http://localhost:${port}/health`);
+        for (const container of this.containers) {
+            console.log(`│  ${container.engine.toUpperCase()}:    ${container.host}:${container.port} (${container.name})`);
+        }
+        if (this.migrationsPath) {
+            console.log(`│  Migrations: ${this.migrationsPath}`);
+        }
+        console.log("├──────────────────────────────────────────────────────────────┤");
+        console.log("│  Press Ctrl+C to stop                                       │");
+        console.log("└──────────────────────────────────────────────────────────────┘");
+        console.log("");
+    }
+}
+// --- Defaults ---
+const DB_DEFAULTS = {
+    postgres: {
+        port: 5432,
+        user: "typeroad",
+        password: "typeroad_dev",
+        database: "typeroad_dev",
+        image: "postgres:16-alpine",
+    },
+    mysql: {
+        port: 3306,
+        user: "typeroad",
+        password: "typeroad_dev",
+        database: "typeroad_dev",
+        image: "mysql:8.0",
+    },
+};
+// --- Helpers ---
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=DevServer.js.map

package/dist/dev/DevServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevServer.js","sourceRoot":"","sources":["../../src/dev/DevServer.ts"],"names":[],"mappings":"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"}

package/dist/dev/MigrationCLI.d.ts

@@ -0,0 +1,19 @@
+import type { SequelizeConnectionManager } from "../database/SequelizeConnectionManager.js";
+export interface MigrationCLIConfig {
+    migrationsPath: string;
+    connection: SequelizeConnectionManager;
+    tenant?: string;
+}
+export declare class MigrationCLI {
+    private readonly migrationsPath;
+    private readonly connection;
+    private readonly tenant;
+    constructor(config: MigrationCLIConfig);
+    run(args?: string[]): Promise<void>;
+    create(name: string): void;
+    up(steps?: number): Promise<void>;
+    down(steps?: number): Promise<void>;
+    status(): Promise<void>;
+    private getRunner;
+}
+//# sourceMappingURL=MigrationCLI.d.ts.map

package/dist/dev/MigrationCLI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationCLI.d.ts","sourceRoot":"","sources":["../../src/dev/MigrationCLI.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2CAA2C,CAAA;AAI3F,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,0BAA0B,CAAA;IACtC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;gBAEnB,MAAM,EAAE,kBAAkB;IAMhC,GAAG,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAuChE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAgBpB,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAcjC,IAAI,CAAC,KAAK,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YA8Bf,SAAS;CAGxB"}

package/dist/dev/MigrationCLI.js

@@ -0,0 +1,140 @@
+import { existsSync, writeFileSync, mkdirSync } from "fs";
+import { resolve, join } from "path";
+// --- CLI ---
+export class MigrationCLI {
+    migrationsPath;
+    connection;
+    tenant;
+    constructor(config) {
+        this.migrationsPath = config.migrationsPath;
+        this.connection = config.connection;
+        this.tenant = config.tenant ?? "default";
+    }
+    async run(args = process.argv.slice(2)) {
+        const command = args[0];
+        const param = args[1];
+        switch (command) {
+            case "create":
+                if (!param) {
+                    console.error("Usage: migration create <name>");
+                    process.exit(1);
+                }
+                this.create(param);
+                break;
+            case "up":
+                await this.up(param ? parseInt(param, 10) : undefined);
+                break;
+            case "down":
+                await this.down(param ? parseInt(param, 10) : 1);
+                break;
+            case "status":
+                await this.status();
+                break;
+            default:
+                console.log("Usage: migration <create|up|down|status> [param]");
+                console.log("");
+                console.log("Commands:");
+                console.log("  create <name>   Create a new migration file");
+                console.log("  up [steps]      Run pending migrations (all or N steps)");
+                console.log("  down [steps]    Revert last N migrations (default: 1)");
+                console.log("  status          Show migration status");
+                break;
+        }
+    }
+    // --- Commands ---
+    create(name) {
+        const timestamp = new Date().toISOString().replace(/[-:T]/g, "").slice(0, 14);
+        const safeName = name.replace(/[^a-zA-Z0-9_-]/g, "-").toLowerCase();
+        const fileName = `${timestamp}-${safeName}.ts`;
+        const dirPath = resolve(this.migrationsPath);
+        if (!existsSync(dirPath)) {
+            mkdirSync(dirPath, { recursive: true });
+        }
+        const filePath = join(dirPath, fileName);
+        writeFileSync(filePath, MIGRATION_TEMPLATE(safeName), "utf-8");
+        console.log(`Migration created: ${filePath}`);
+    }
+    async up(steps) {
+        const runner = await this.getRunner();
+        const applied = await runner.up(steps);
+        if (applied.length === 0) {
+            console.log("No pending migrations.");
+        }
+        else {
+            console.log(`Applied ${applied.length} migration(s):`);
+            for (const name of applied) {
+                console.log(`  + ${name}`);
+            }
+        }
+    }
+    async down(steps = 1) {
+        const runner = await this.getRunner();
+        const reverted = await runner.down(steps);
+        if (reverted.length === 0) {
+            console.log("No migrations to revert.");
+        }
+        else {
+            console.log(`Reverted ${reverted.length} migration(s):`);
+            for (const name of reverted) {
+                console.log(`  - ${name}`);
+            }
+        }
+    }
+    async status() {
+        const runner = await this.getRunner();
+        const statuses = await runner.status();
+        if (statuses.length === 0) {
+            console.log("No migrations found.");
+            return;
+        }
+        console.log("");
+        console.log("Migration Status:");
+        console.log("─".repeat(60));
+        for (const s of statuses) {
+            const icon = s.isApplied ? "✓" : "○";
+            const status = s.isApplied ? "applied" : "pending";
+            console.log(`  ${icon} ${s.name}  (${status})`);
+        }
+        console.log("─".repeat(60));
+        const applied = statuses.filter((s) => s.isApplied).length;
+        const pending = statuses.filter((s) => !s.isApplied).length;
+        console.log(`  Total: ${statuses.length} | Applied: ${applied} | Pending: ${pending}`);
+        console.log("");
+    }
+    // --- Internal ---
+    async getRunner() {
+        return this.connection.getMigrationRunner(this.tenant);
+    }
+}
+// --- Template ---
+function MIGRATION_TEMPLATE(name) {
+    return `import type { QueryInterface, Sequelize } from "sequelize"
+
+export default {
+  async up(queryInterface: QueryInterface, sequelize: Sequelize): Promise<void> {
+    // TODO: implement migration "${name}"
+    // Example:
+    // await queryInterface.createTable("my_table", {
+    //   id: {
+    //     type: sequelize.constructor["DataTypes"].UUID,
+    //     primaryKey: true,
+    //     defaultValue: sequelize.constructor["DataTypes"].UUIDV4,
+    //   },
+    //   name: {
+    //     type: sequelize.constructor["DataTypes"].STRING,
+    //     allowNull: false,
+    //   },
+    //   createdAt: sequelize.constructor["DataTypes"].DATE,
+    //   updatedAt: sequelize.constructor["DataTypes"].DATE,
+    // })
+  },
+
+  async down(queryInterface: QueryInterface, _sequelize: Sequelize): Promise<void> {
+    // TODO: implement rollback for "${name}"
+    // Example:
+    // await queryInterface.dropTable("my_table")
+  },
+}
+`;
+}
+//# sourceMappingURL=MigrationCLI.js.map

package/dist/dev/MigrationCLI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MigrationCLI.js","sourceRoot":"","sources":["../../src/dev/MigrationCLI.ts"],"names":[],"mappings":"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"}

package/dist/dev/index.d.ts

@@ -0,0 +1,5 @@
+export { DevServer } from "./DevServer.js";
+export type { DevServerConfig, DevDatabaseConfig } from "./DevServer.js";
+export { MigrationCLI } from "./MigrationCLI.js";
+export type { MigrationCLIConfig } from "./MigrationCLI.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/dev/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dev/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAExE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/dev/index.js

@@ -0,0 +1,3 @@
+export { DevServer } from "./DevServer.js";
+export { MigrationCLI } from "./MigrationCLI.js";
+//# sourceMappingURL=index.js.map

package/dist/dev/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dev/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAG1C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA"}