@onroad/core 4.0.0-alpha.5 → 4.0.0-alpha.7

package/README.md

@@ -25,6 +25,8 @@
 - [Storage](#storage)
 - [Health Endpoint](#health-endpoint)
 - [Graceful Shutdown](#graceful-shutdown)
+- [Local Development (DevServer)](#local-development-devserver)
+- [Migration CLI](#migration-cli)
 - [Testing](#testing)
 - [Subpath Exports](#subpath-exports)
 - [Known Pitfalls](#known-pitfalls)
@@ -601,7 +603,7 @@ await app.shutdown()
 
 ## Testing
 
-TypeRoad uses [Vitest](https://vitest.dev/) with **223 tests** across 9 test files:
+TypeRoad uses [Vitest](https://vitest.dev/) with **242 tests** across 10 test files:
 
 ```bash
 npm test              # Run all tests
@@ -611,7 +613,7 @@ npm run test:coverage # Coverage report
 
 | Test File | Tests | Covers |
 |-----------|-------|--------|
-| `container.test.ts` | 16 | DI Container, decorators, scopes |
+| `container.test.ts` | 19 | DI Container, decorators, scopes |
 | `entity.test.ts` | 14 | Entity, Column, associations |
 | `database.test.ts` | 13 | ConnectionManagers |
 | `filters.test.ts` | 33 | FilterChain, all 5 built-in filters |
@@ -620,6 +622,7 @@ npm run test:coverage # Coverage report
 | `logging.test.ts` | 20 | PinoLogger, OnRoadLogger |
 | `providers.test.ts` | 41 | All 4 providers, graceful-fail, shutdown |
 | `transport.test.ts` | 25 | HttpTransport, MessagingTransport, TransportFactory, RequestContext |
+| `dev.test.ts` | 16 | DevServer, MigrationCLI |
 
 ---
 
@@ -632,21 +635,184 @@ src/
 ├── container/                # DI Container + decorators
 ├── context/                  # RequestContext (AsyncLocalStorage)
 ├── core/                     # AbstractController/Service/Repository, Sentinel, EventBus
+├── database/                 # ConnectionManager abstract + Sequelize/Mongo implementations
+│   └── migrations/           # MigrationRunner (Umzug)
+├── dev/                      # DevServer, MigrationCLI — local dev tools
 ├── entity/                   # @Entity, @Column, @Field, associations
 ├── filters/                  # FilterChain, @Filter, built-in filters (Cors, JWT, Tenant, Role, RequestContext)
-├── security/                 # @Roles, @Public
-├── database/                 # ConnectionManager abstract + Sequelize/Mongo implementations
-├── transport/                # InterServiceTransport, HttpTransport, MessagingTransport, TransportFactory
-├── messaging/                # MatchingObject
-├── providers/                # MessagingProvider, RealtimeProvider, TaskSchedulerProvider, SocketProvider
 ├── logging/                  # OnRoadLogger interface + PinoLogger
+├── messaging/                # MatchingObject
 ├── plugins/                  # OnRoadPlugin interface
+├── providers/                # MessagingProvider, RealtimeProvider, TaskSchedulerProvider, SocketProvider
+├── security/                 # @Roles, @Public
 ├── storage/                  # StorageProvider abstract
+├── transport/                # InterServiceTransport, HttpTransport, MessagingTransport, TransportFactory
 └── types/                    # Express Request augmentation
 ```
 
 ---
 
+## Local Development (DevServer)
+
+TypeRoad includes a `DevServer` that makes local development self-sufficient — it starts database containers, runs migrations, and logs all environment variables your frontend needs.
+
+### Quick Start
+
+```ts
+import "reflect-metadata"
+import { OnRoadExpress } from "@onroad/core"
+import { SequelizeConnectionManager } from "@onroad/core/database"
+import { DevServer } from "@onroad/core/dev"
+
+const app = new OnRoadExpress({
+  connections: [
+    new SequelizeConnectionManager({
+      dialect: "postgres",
+      host: "localhost",
+      port: 5432,
+      user: "typeroad",
+      password: "typeroad_dev",
+      database: "typeroad_dev",
+      migrations: {
+        path: "./src/migrations",
+        runOnConnect: true,
+      },
+    }),
+  ],
+})
+
+// Register your controllers, services, repositories...
+app.register([/* ... */])
+
+const devServer = new DevServer({
+  app,
+  databases: [{ engine: "postgres", port: 5432 }],
+  migrationsPath: "./src/migrations",
+  tenants: ["default"],
+  frontendVars: {
+    REACT_APP_TENANT: "default",
+    REACT_APP_WS_URL: "ws://localhost:3000",
+  },
+})
+
+await devServer.start({ port: 3000 })
+// Press Ctrl+C to stop
+```
+
+### What DevServer Does
+
+1. **Generates `docker-compose.dev.yml`** — PostgreSQL (or MySQL) container with healthcheck, volumes, and sensible defaults
+2. **Starts the container** — `docker compose up -d` automatically
+3. **Waits for readiness** — polls `pg_isready` / `mysqladmin ping` until the DB accepts connections
+4. **Runs migrations** — applies all pending Umzug migrations from your configured path
+5. **Starts the API server** — calls `app.buildServer()` as usual
+6. **Logs frontend env vars** — prints a copy-pasteable block and writes `.env.dev`:
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│              FRONTEND ENVIRONMENT VARIABLES                  │
+├──────────────────────────────────────────────────────────────┤
+│  REACT_APP_API_URL=http://localhost:3000
+│  NEXT_PUBLIC_API_URL=http://localhost:3000
+│  VITE_API_URL=http://localhost:3000
+│  DATABASE_URL=postgresql://typeroad:typeroad_dev@localhost:5432/typeroad_dev
+│  REACT_APP_TENANT=default
+└──────────────────────────────────────────────────────────────┘
+```
+
+### DevServer Config
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `app` | `OnRoadExpress` | required | The app instance |
+| `databases` | `DevDatabaseConfig[]` | `[{ engine: "postgres" }]` | Database containers to start |
+| `frontendVars` | `Record<string, string>` | `{}` | Extra vars to log for frontend |
+| `migrationsPath` | `string` | — | Path to migration files |
+| `autoMigrate` | `boolean` | `true` | Run migrations on start |
+| `tenants` | `string[]` | `["default"]` | Tenants to run migrations for |
+| `composeFile` | `string` | `"docker-compose.dev.yml"` | Docker compose filename |
+
+### Database Defaults
+
+| Engine | Image | Port | User | Password | Database |
+|--------|-------|------|------|----------|----------|
+| `postgres` | `postgres:16-alpine` | `5432` | `typeroad` | `typeroad_dev` | `typeroad_dev` |
+| `mysql` | `mysql:8.0` | `3306` | `typeroad` | `typeroad_dev` | `typeroad_dev` |
+
+---
+
+## Migration CLI
+
+The `MigrationCLI` class provides a programmatic API for managing database migrations.
+
+### Usage
+
+```ts
+import { MigrationCLI } from "@onroad/core/dev"
+import { SequelizeConnectionManager } from "@onroad/core/database"
+
+const connection = new SequelizeConnectionManager({
+  dialect: "postgres",
+  host: "localhost",
+  user: "typeroad",
+  password: "typeroad_dev",
+  database: "typeroad_dev",
+  migrations: { path: "./src/migrations" },
+})
+
+const cli = new MigrationCLI({
+  migrationsPath: "./src/migrations",
+  connection,
+  tenant: "default",
+})
+
+// Run from CLI args
+await cli.run()  // reads process.argv
+
+// Or call directly
+cli.create("add-users-table")  // creates timestamped migration file
+await cli.up()                  // apply all pending
+await cli.up(1)                 // apply 1 step
+await cli.down()                // revert last migration
+await cli.status()              // show status table
+```
+
+### CLI Commands
+
+| Command | Description | Example |
+|---------|-------------|---------|
+| `create <name>` | Create a new migration file | `cli.run(["create", "add-orders"])` |
+| `up [steps]` | Apply pending migrations | `cli.run(["up"])` or `cli.run(["up", "3"])` |
+| `down [steps]` | Revert migrations (default: 1) | `cli.run(["down", "2"])` |
+| `status` | Show applied/pending status | `cli.run(["status"])` |
+
+### Migration File Format
+
+Generated `.ts` files follow the Umzug/Sequelize pattern:
+
+```ts
+import type { QueryInterface, Sequelize } from "sequelize"
+
+export default {
+  async up(queryInterface: QueryInterface, sequelize: Sequelize): Promise<void> {
+    await queryInterface.createTable("ordens", {
+      id: { type: sequelize.constructor["DataTypes"].UUID, primaryKey: true },
+      descricao: { type: sequelize.constructor["DataTypes"].STRING, allowNull: false },
+      createdAt: sequelize.constructor["DataTypes"].DATE,
+      updatedAt: sequelize.constructor["DataTypes"].DATE,
+    })
+  },
+
+  async down(queryInterface: QueryInterface): Promise<void> {
+    await queryInterface.dropTable("ordens")
+  },
+}
+```
+
+Migration state is tracked in the `__typeroad_migrations` table (configurable via `tableName` in `MigrationConfig`).
+
+---
+
 ## Subpath Exports
 
 Import only what you need:
@@ -662,6 +828,7 @@ import { HttpTransport, TransportFactory } from "@onroad/core/transport" // Tran
 import { MatchingObject } from "@onroad/core/messaging"                // Messaging
 import { PinoLogger } from "@onroad/core/logging"                      // Logging
 import { StorageProvider } from "@onroad/core/storage"                 // Storage
+import { DevServer, MigrationCLI } from "@onroad/core/dev"            // Dev Tools
 ```
 
 ---

package/dist/dev/DevServer.d.ts

@@ -0,0 +1,48 @@
+import type { OnRoadExpress, BuildServerConfig } from "../OnRoadExpress.js";
+export interface DevDatabaseConfig {
+    engine: "postgres" | "mysql";
+    port?: number;
+    user?: string;
+    password?: string;
+    database?: string;
+    image?: string;
+    containerName?: string;
+}
+export interface DevServerConfig {
+    app: OnRoadExpress;
+    databases?: DevDatabaseConfig[];
+    frontendVars?: Record<string, string>;
+    migrationsPath?: string;
+    projectRoot?: string;
+    autoMigrate?: boolean;
+    composeFile?: string;
+    tenants?: string[];
+}
+export declare class DevServer {
+    private readonly app;
+    private readonly logger;
+    private readonly databases;
+    private readonly frontendVars;
+    private readonly migrationsPath?;
+    private readonly projectRoot;
+    private readonly autoMigrate;
+    private readonly composeFile;
+    private readonly tenants;
+    private containers;
+    constructor(config: DevServerConfig);
+    start(buildConfig?: BuildServerConfig): Promise<void>;
+    stop(): Promise<void>;
+    private ensureComposeFile;
+    private generateComposeContent;
+    private startContainers;
+    private stopContainers;
+    private isDockerAvailable;
+    private waitForDatabases;
+    private waitForContainer;
+    private populateContainersFromConfig;
+    private runMigrations;
+    private printFrontendEnvVars;
+    private printBanner;
+    private printSummary;
+}
+//# sourceMappingURL=DevServer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DevServer.d.ts","sourceRoot":"","sources":["../../src/dev/DevServer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAM3E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAA;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,aAAa,CAAA;IAClB,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAcD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAQ;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,UAAU,CAAsB;gBAE5B,MAAM,EAAE,eAAe;IAc7B,KAAK,CAAC,WAAW,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BzD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,sBAAsB;YAgFhB,eAAe;IA+B7B,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,iBAAiB;YAWX,gBAAgB;YAahB,gBAAgB;IA0B9B,OAAO,CAAC,4BAA4B;YAiBtB,aAAa;IAgC3B,OAAO,CAAC,oBAAoB;IAmD5B,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,YAAY;CAqBrB"}

package/dist/dev/DevServer.js

@@ -0,0 +1,363 @@
+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 = [];
+    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
+version: "3.8"
+
+services:
+${services.join("\n\n")}
+
+volumes:
+${volumes.join("\n")}
+`;
+    }
+    // --- Container Management ---
+    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.");
+        }
+        this.logger.info("Starting database containers...");
+        try {
+            execSync(`docker compose -f "${composePath}" up -d`, {
+                cwd: this.projectRoot,
+                stdio: "pipe",
+            });
+        }
+        catch {
+            // Fallback to docker-compose (v1)
+            try {
+                execSync(`docker-compose -f "${composePath}" up -d`, {
+                    cwd: this.projectRoot,
+                    stdio: "pipe",
+                });
+            }
+            catch (err) {
+                throw new Error(`[TypeRoad DevServer] Failed to start containers: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    stopContainers() {
+        const composePath = resolve(this.projectRoot, this.composeFile);
+        try {
+            execSync(`docker compose -f "${composePath}" down`, {
+                cwd: this.projectRoot,
+                stdio: "pipe",
+            });
+        }
+        catch {
+            try {
+                execSync(`docker-compose -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 runMigrations() {
+        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"}

package/dist/index.d.ts

@@ -24,4 +24,6 @@ export { PinoLogger } from "./logging/index.js";
 export type { OnRoadLogger, PinoLoggerConfig } from "./logging/index.js";
 export type { OnRoadPlugin } from "./plugins/index.js";
 export { StorageProvider } from "./storage/index.js";
+export { DevServer, MigrationCLI } from "./dev/index.js";
+export type { DevServerConfig, DevDatabaseConfig, MigrationCLIConfig } from "./dev/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAA;AACzB,OAAO,4BAA4B,CAAA;AAGnC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAGzE,OAAO,EACL,eAAe,EACf,UAAU,EACV,UAAU,EACV,OAAO,EACP,UAAU,EACV,KAAK,EACL,YAAY,GACb,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGpF,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,EACR,eAAe,GAChB,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAG5I,OAAO,EACL,MAAM,EACN,MAAM,EACN,KAAK,EACL,OAAO,EACP,SAAS,EACT,MAAM,EACN,aAAa,EACb,QAAQ,EACR,cAAc,GACf,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAGxG,OAAO,EACL,YAAY,EACZ,WAAW,EACX,MAAM,EACN,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAG7D,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAC3G,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAG1E,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAGvD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/E,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAGtE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGrD,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,GACf,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAGxE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,kBAAkB,CAAA;AACzB,OAAO,4BAA4B,CAAA;AAGnC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAGzE,OAAO,EACL,eAAe,EACf,UAAU,EACV,UAAU,EACV,OAAO,EACP,UAAU,EACV,KAAK,EACL,YAAY,GACb,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGpF,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,EACR,eAAe,GAChB,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAG5I,OAAO,EACL,MAAM,EACN,MAAM,EACN,KAAK,EACL,OAAO,EACP,SAAS,EACT,MAAM,EACN,aAAa,EACb,QAAQ,EACR,cAAc,GACf,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAGxG,OAAO,EACL,YAAY,EACZ,WAAW,EACX,MAAM,EACN,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAG7D,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAC3G,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAG1E,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAGvD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/E,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAGtE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGrD,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,GACf,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAGxE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAGpD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACxD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -28,4 +28,6 @@ export { MessagingProvider, RealtimeProvider, TaskSchedulerProvider, SocketProvi
 export { PinoLogger } from "./logging/index.js";
 // --- Storage ---
 export { StorageProvider } from "./storage/index.js";
+// --- Dev Tools ---
+export { DevServer, MigrationCLI } from "./dev/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,kBAAkB;AAElB,OAAO,kBAAkB,CAAA;AACzB,OAAO,4BAA4B,CAAA;AAEnC,eAAe;AACf,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGlD,iCAAiC;AACjC,OAAO,EACL,eAAe,EACf,UAAU,EACV,UAAU,EACV,OAAO,EACP,UAAU,EACV,KAAK,EACL,YAAY,GACb,MAAM,sBAAsB,CAAA;AAG7B,eAAe;AACf,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,EACR,eAAe,GAChB,MAAM,iBAAiB,CAAA;AAGxB,iBAAiB;AACjB,OAAO,EACL,MAAM,EACN,MAAM,EACN,KAAK,EACL,OAAO,EACP,SAAS,EACT,MAAM,EACN,aAAa,EACb,QAAQ,EACR,cAAc,GACf,MAAM,mBAAmB,CAAA;AAG1B,kBAAkB;AAClB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,MAAM,EACN,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAW3B,mBAAmB;AACnB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAE7D,mBAAmB;AACnB,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAG3G,oBAAoB;AACpB,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAG7B,0BAA0B;AAC1B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAG/E,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,oBAAoB;AACpB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,GACf,MAAM,sBAAsB,CAAA;AAQ7B,kBAAkB;AAClB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAM/C,kBAAkB;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,kBAAkB;AAElB,OAAO,kBAAkB,CAAA;AACzB,OAAO,4BAA4B,CAAA;AAEnC,eAAe;AACf,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAGlD,iCAAiC;AACjC,OAAO,EACL,eAAe,EACf,UAAU,EACV,UAAU,EACV,OAAO,EACP,UAAU,EACV,KAAK,EACL,YAAY,GACb,MAAM,sBAAsB,CAAA;AAG7B,eAAe;AACf,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,EACR,eAAe,GAChB,MAAM,iBAAiB,CAAA;AAGxB,iBAAiB;AACjB,OAAO,EACL,MAAM,EACN,MAAM,EACN,KAAK,EACL,OAAO,EACP,SAAS,EACT,MAAM,EACN,aAAa,EACb,QAAQ,EACR,cAAc,GACf,MAAM,mBAAmB,CAAA;AAG1B,kBAAkB;AAClB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,MAAM,EACN,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAW3B,mBAAmB;AACnB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAE7D,mBAAmB;AACnB,OAAO,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAG3G,oBAAoB;AACpB,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,sBAAsB,CAAA;AAG7B,0BAA0B;AAC1B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAG/E,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,oBAAoB;AACpB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,GACf,MAAM,sBAAsB,CAAA;AAQ7B,kBAAkB;AAClB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAM/C,kBAAkB;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEpD,oBAAoB;AACpB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onroad/core",
-  "version": "4.0.0-alpha.5",
+  "version": "4.0.0-alpha.7",
   "description": "TypeScript backend framework — DI Container, Filter Chain, EventBus, Provider Pattern",
   "type": "module",
   "main": "dist/index.js",
@@ -61,6 +61,10 @@
     "./migrations": {
       "import": "./dist/database/migrations/index.js",
       "types": "./dist/database/migrations/index.d.ts"
+    },
+    "./dev": {
+      "import": "./dist/dev/index.js",
+      "types": "./dist/dev/index.d.ts"
     }
   },
   "files": [