@onroad/core 4.0.0-alpha.23 → 4.0.0-alpha.25

package/README.md

@@ -97,72 +97,88 @@ await app.buildServer({ port: 3001 })
 
 ## Architecture Overview
 
-```
-┌──────────────────────────────────────────────────┐
-│                  OnRoadExpress                   │
-│  ┌────────────┐  ┌────────────┐  ┌────────────┐ │
-│  │  Container  │  │ FilterChain│  │  EventBus  │ │
-│  │  (DI + IoC) │  │ (Middleware)│  │ (Sentinel) │ │
-│  └─────┬──────┘  └─────┬──────┘  └─────┬──────┘ │
-│        │               │               │        │
-│  ┌─────▼───────────────▼───────────────▼──────┐ │
-│  │         Request Handler (route)             │ │
-│  │  requestContext.run({ tenant, appToken })   │ │
-│  │  ┌──────────┐ ┌─────────┐ ┌────────────┐   │ │
-│  │  │Controller│→│ Service │→│ Repository │   │ │
-│  │  └──────────┘ └─────────┘ └────────────┘   │ │
-│  └─────────────────────────────────────────────┘ │
-│                                                  │
-│  ┌──────────────────────────────────────────┐   │
-│  │              Providers                    │   │
-│  │  Messaging │ Realtime │ TaskSched │ Socket│   │
-│  └──────────────────────────────────────────┘   │
-│                                                  │
-│  ┌──────────────────────────────────────────┐   │
-│  │           TransportFactory                │   │
-│  │     HttpTransport │ MessagingTransport    │   │
-│  └──────────────────────────────────────────┘   │
-└──────────────────────────────────────────────────┘
+TypeRoad follows a multi-tenant architecture designed for high isolation and developer productivity. The framework orchestrates the request lifecycle using three main internal layers: `RequestContext`, `OnRoadContainer` (DI), and the `Model/Repository` layer.
+
+### The "Matryoshka" Isolation Pattern
+
+Isolation in runtime is achieved through a nested hierarchy that ensures one tenant's request never sees another's data or instances.
+
+1.  **Nível 1: RequestContext (AsyncLocalStorage)**
+    - O `OnRoadExpress` envolve cada execução de rota em um bloco `requestContext.run()`.
+    - Atua como um "envelope" de memória global para a thread lógica atual, armazenando metadados como `tenantId`, `logger` e `appToken`.
+    - Permite que qualquer parte do sistema acesse o estado da requisição via `getRequestContext()` sem precisar de injeção manual.
+
+2.  **Nível 2: OnRoadContainer (RequestScope)**
+    - Dentro do contexto da requisição, o Container cria um objeto `RequestScope`.
+    - Este escopo é um mapa de instâncias isolado por um `UUID` único para aquela chamada HTTP.
+    - Se múltiplos serviços injetarem o mesmo `Repository`, o Container garante que eles recebam a **mesma instância** dentro daquela requisição (reuso de estado), mas instâncias **completamente diferentes** de outras requisições concorrentes.
+
+3.  **Nível 3: Repository & Connection Isolation**
+    - Repositórios são instanciados pelo Container e recebem automaticamente o `tenantId` do escopo atual.
+    - Ao executar uma query (ex: `find()`), o repositório usa seu atributo interno `this.tenant` para solicitar ao `ConnectionManager` o pool de conexões específico daquele banco de dados.
+    - Isso garante que o isolamento chegue até o nível físico do banco de dados (schema ou DB separado).
+
+```mermaid
+graph TD
+    subgraph "Nível 1: RequestContext (AsyncLocalStorage)"
+        direction TB
+        Metadata["{ tenant: 'cliente_a', logger, token }"]
+        
+        subgraph "Nível 2: OnRoadContainer (RequestScope)"
+            direction TB
+            ScopeID["Scope: UUID-123 (Tenant: 'cliente_a')"]
+            Instances["Map { Controller, Service, Repository }"]
+            
+            subgraph "Nível 3: Instância do Repository"
+                direction TB
+                Atributo["this.tenant = 'cliente_a'"]
+                Metodo["getConnection() -> Pede ao ConnectionManager o banco 'onroad_cliente_a'"]
+            end
+        end
+    end
 ```
 
 ---
 
 ## DI Container & Decorators
 
-TypeRoad uses a decorator-based DI container with automatic class scanning.
+TypeRoad uses a decorator-based DI container with automatic class scanning. It manages the lifecycle of your components through defined scopes.
 
 ### Decorators
 
-| Decorator | Scope | Purpose |
-|-----------|-------|---------|
-| `@Injectable()` | Transient (default) | Generic injectable class |
-| `@Controller("/path")` | Request | Express route handler |
-| `@Service()` | Request | Business logic layer |
-| `@Repository()` | Request | Data access layer |
+| Decorator | Scope | Relationship | Purpose |
+|-----------|-------|:---:|---------|
+| `@Controller("/path")` | `REQUEST` | entry-point | Injetado com Services; lida com req/res Express. |
+| `@Service()` | `REQUEST` | logic | Camada de orquestração e regras de negócio. |
+| `@Repository()` | `REQUEST` | data | Camada de acesso ao banco (Sequelize/Mongoose). |
+| `@Injectable()` | `TRANSIENT` | utility | Classes utilitárias instanciadas a cada uso. |
 
 ### Scopes
 
-| Scope | Behavior |
-|-------|----------|
-| `SINGLETON` | One instance for the entire application |
-| `REQUEST` | One instance per request scope |
-| `TRANSIENT` | New instance on every resolve |
+-   **`SINGLETON`**: Uma única instância para toda a aplicação (ex: `EventBus`, `ConnectionManager`).
+-   **`REQUEST`**: Uma instância por requisição HTTP. É o escopo padrão para Controllers e Services, garantindo que o estado do tenant esteja isolado.
+-   **`TRANSIENT`**: Uma nova instância é criada toda vez que a classe é injetada ou resolvida.
 
-### Usage
+### Controller, Service and Repository linkage
+
+The container manages a strict hierarchy: `Controller` -> `Service` -> `Repository`.
+
+-   **Automatic Wiring**: When you register a module via `app.register([MyController, MyService, MyRepository])`, the container scans the metadata and prepares the injection tree.
+-   **Stateful Injection**: A Repository inheriting from `SequelizeRepository` is automatically configured by the container with the current `tenant` and `connectionManager` during its instantiation in the `RequestScope`.
 
 ```ts
-import { Injectable, Scope } from "@onroad/core"
+import { Service, AbstractService } from "@onroad/core"
 
-@Injectable({ scope: Scope.SINGLETON })
-class CacheManager {
-  private store = new Map<string, unknown>()
-  get(key: string) { return this.store.get(key) }
-  set(key: string, value: unknown) { this.store.set(key, value) }
+@Service()
+class OrdemService extends AbstractService<OrdemRepository> {
+  constructor() {
+    // Shared state: the container ensures OrdemRepository
+    // is instantiated within the same RequestScope as this service.
+    super({ repository: OrdemRepository })
+  }
 }
 ```
 
-Register all classes via `app.register([...])` — the container auto-scans metadata.
-
 ---
 
 ## Controllers, Services & Repositories

package/dist/dev/DevToolsController.d.ts

@@ -0,0 +1,39 @@
+import type { Request, Response } from "express";
+export interface DevToolsConfig {
+    /** GCP project id */
+    projectId: string;
+    /** Cloud SQL instance name (short, e.g. "teraprox-postgres") */
+    instanceId: string;
+    /** GCS bucket for intermediate dump storage */
+    bucketName: string;
+    /** Default Cloud SQL source database name to export */
+    sourceDatabase: string;
+    /** Local database connection (the Docker dev DB) */
+    localDb: {
+        host: string;
+        port: number;
+        user: string;
+        password: string;
+        database: string;
+    };
+    /** Optional callback executed after restore finishes (e.g. run migrations) */
+    onAfterRestore?: () => Promise<void>;
+}
+/**
+ * Standalone route-handler class for the dev console.
+ * Routes are mounted directly by DevToolsPlugin (not via the DI container).
+ */
+export declare class DevToolsController {
+    private config;
+    private currentRestore;
+    constructor(config: DevToolsConfig);
+    checkGcloudAuth: (_req: Request, res: Response) => Promise<void>;
+    listDatabases: (_req: Request, res: Response) => Promise<void>;
+    exportAndRestore: (req: Request, res: Response) => Promise<void>;
+    restoreStatus: (_req: Request, res: Response) => Promise<void>;
+    downloadLocalBackup: (_req: Request, res: Response) => Promise<void>;
+    renderDashboard: (_req: Request, res: Response) => Promise<void>;
+    private runRestore;
+    private buildHTML;
+}
+//# sourceMappingURL=DevToolsController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsController.d.ts","sourceRoot":"","sources":["../../src/dev/DevToolsController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAQhD,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAA;IAClB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAA;IACtB,oDAAoD;IACpD,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACrC;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,cAAc,CAGrB;gBAEW,MAAM,EAAE,cAAc;IAMlC,eAAe,GAAU,MAAM,OAAO,EAAE,KAAK,QAAQ,KAAG,OAAO,CAAC,IAAI,CAAC,CAUpE;IAED,aAAa,GAAU,MAAM,OAAO,EAAE,KAAK,QAAQ,KAAG,OAAO,CAAC,IAAI,CAAC,CAuBlE;IAED,gBAAgB,GAAU,KAAK,OAAO,EAAE,KAAK,QAAQ,KAAG,OAAO,CAAC,IAAI,CAAC,CAqBpE;IAED,aAAa,GACX,MAAM,OAAO,EACb,KAAK,QAAQ,KACZ,OAAO,CAAC,IAAI,CAAC,CAEf;IAED,mBAAmB,GACjB,MAAM,OAAO,EACb,KAAK,QAAQ,KACZ,OAAO,CAAC,IAAI,CAAC,CA2Bf;IAED,eAAe,GACb,MAAM,OAAO,EACb,KAAK,QAAQ,KACZ,OAAO,CAAC,IAAI,CAAC,CAEf;YAIa,UAAU;IAoGxB,OAAO,CAAC,SAAS;CAmIlB"}

package/dist/dev/DevToolsController.js

@@ -0,0 +1,299 @@
+import { exec } from "child_process";
+import { promisify } from "util";
+import fs from "fs";
+import path from "path";
+const execAsync = promisify(exec);
+/**
+ * Standalone route-handler class for the dev console.
+ * Routes are mounted directly by DevToolsPlugin (not via the DI container).
+ */
+export class DevToolsController {
+    config;
+    currentRestore = {
+        status: "idle",
+        step: "",
+    };
+    constructor(config) {
+        this.config = config;
+    }
+    // --- Route handlers (arrow fns to preserve `this`) ---
+    checkGcloudAuth = async (_req, res) => {
+        try {
+            await execAsync("gcloud auth print-access-token", { timeout: 10_000 });
+            const { stdout } = await execAsync("gcloud config get-value account", {
+                timeout: 5_000,
+            });
+            res.json({ authenticated: true, account: stdout.trim() });
+        }
+        catch {
+            res.json({ authenticated: false, account: null });
+        }
+    };
+    listDatabases = async (_req, res) => {
+        const { projectId, instanceId } = this.config;
+        try {
+            const { stdout } = await execAsync("gcloud sql databases list --instance=" +
+                instanceId +
+                " --project=" +
+                projectId +
+                ' --format="json"', { timeout: 30_000 });
+            const databases = JSON.parse(stdout)
+                .map((d) => d.name)
+                .filter((n) => !["postgres", "template0", "template1", "cloudsqladmin"].includes(n));
+            res.json({ success: true, databases });
+        }
+        catch (error) {
+            res.status(500).json({ success: false, error: error.message });
+        }
+    };
+    exportAndRestore = async (req, res) => {
+        const { database, dropExisting } = req.body;
+        const dbName = database || this.config.sourceDatabase;
+        if (this.currentRestore.status === "running") {
+            res
+                .status(409)
+                .json({ success: false, error: "Já existe um restore em andamento." });
+            return;
+        }
+        this.currentRestore = { status: "running", step: "Iniciando..." };
+        res.json({ success: true, message: "Restore iniciado." });
+        this.runRestore(dbName, !!dropExisting).catch((err) => {
+            this.currentRestore = {
+                status: "error",
+                step: "Falhou",
+                error: err.message,
+            };
+        });
+    };
+    restoreStatus = async (_req, res) => {
+        res.json(this.currentRestore);
+    };
+    downloadLocalBackup = async (_req, res) => {
+        const { localDb } = this.config;
+        const ts = new Date().toISOString().replace(/[:.]/g, "-");
+        const filename = "local_backup_" + localDb.database + "_" + ts + ".sql";
+        const filePath = path.join("/tmp", filename);
+        try {
+            const cmd = 'PGPASSWORD="' +
+                localDb.password +
+                '" pg_dump -h ' +
+                localDb.host +
+                " -p " +
+                localDb.port +
+                " -U " +
+                localDb.user +
+                " -d " +
+                localDb.database +
+                " -F p > " +
+                filePath;
+            await execAsync(cmd, { timeout: 120_000 });
+            res.download(filePath, filename, () => {
+                if (fs.existsSync(filePath))
+                    fs.unlinkSync(filePath);
+            });
+        }
+        catch (error) {
+            res.status(500).json({ success: false, error: error.message });
+        }
+    };
+    renderDashboard = async (_req, res) => {
+        res.send(this.buildHTML());
+    };
+    // --- Background restore pipeline ---
+    async runRestore(sourceDb, dropExisting) {
+        const { projectId, instanceId, bucketName, localDb } = this.config;
+        const tempFileName = "restore_" + sourceDb + "_" + Date.now() + ".sql";
+        const gcsPath = "gs://" + bucketName + "/" + tempFileName;
+        const localPath = path.join("/tmp", tempFileName);
+        try {
+            // 1 — Export from Cloud SQL to GCS
+            this.currentRestore.step = "Exportando " + sourceDb + " do Cloud SQL...";
+            await execAsync("gcloud sql export sql " +
+                instanceId +
+                " " +
+                gcsPath +
+                " --database=" +
+                sourceDb +
+                " --project=" +
+                projectId +
+                " --quiet", { timeout: 600_000 });
+            // 2 — Download from GCS
+            this.currentRestore.step = "Baixando dump do GCS...";
+            await execAsync("gcloud storage cp " + gcsPath + " " + localPath, {
+                timeout: 300_000,
+            });
+            // 3 — Cleanup GCS (fire-and-forget)
+            execAsync("gcloud storage rm " + gcsPath).catch(() => { });
+            // 4 — Drop + recreate local DB
+            if (dropExisting) {
+                this.currentRestore.step = "Recriando banco local...";
+                const pgEnv = 'PGPASSWORD="' + localDb.password + '"';
+                const pgConn = "-h " + localDb.host + " -p " + localDb.port + " -U " + localDb.user;
+                // Terminate active connections
+                await execAsync(pgEnv +
+                    " psql " +
+                    pgConn +
+                    " -d postgres -c \"SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE datname = '" +
+                    localDb.database +
+                    "' AND pid <> pg_backend_pid();\"", { timeout: 10_000 }).catch(() => { });
+                await execAsync(pgEnv + " dropdb " + pgConn + " --if-exists " + localDb.database, { timeout: 10_000 });
+                await execAsync(pgEnv + " createdb " + pgConn + " " + localDb.database, { timeout: 10_000 });
+            }
+            // 5 — Restore SQL dump into local DB
+            this.currentRestore.step = "Restaurando dump no banco local...";
+            await execAsync('PGPASSWORD="' +
+                localDb.password +
+                '" psql -h ' +
+                localDb.host +
+                " -p " +
+                localDb.port +
+                " -U " +
+                localDb.user +
+                " -d " +
+                localDb.database +
+                " -f " +
+                localPath, { timeout: 600_000 });
+            // 6 — Run migrations
+            if (this.config.onAfterRestore) {
+                this.currentRestore.step = "Rodando migrations...";
+                await this.config.onAfterRestore();
+            }
+            this.currentRestore = { status: "done", step: "Restore completo!" };
+        }
+        catch (error) {
+            this.currentRestore = {
+                status: "error",
+                step: "Falhou",
+                error: error.message,
+            };
+        }
+        finally {
+            if (fs.existsSync(localPath))
+                fs.unlinkSync(localPath);
+        }
+    }
+    // --- Dashboard HTML (string concat to avoid template-literal nesting) ---
+    buildHTML() {
+        var cfg = this.config;
+        var css = "* { box-sizing: border-box; margin: 0; padding: 0; }" +
+            'body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; padding: 20px; background: #0f172a; color: #e2e8f0; min-height: 100vh; }' +
+            ".container { max-width: 720px; margin: 0 auto; }" +
+            "h1 { font-size: 24px; margin-bottom: 4px; color: #38bdf8; }" +
+            ".subtitle { color: #94a3b8; margin-bottom: 24px; font-size: 13px; }" +
+            ".card { background: #1e293b; border: 1px solid #334155; border-radius: 10px; padding: 20px; margin-bottom: 16px; }" +
+            ".card h2 { font-size: 15px; color: #94a3b8; margin-bottom: 12px; text-transform: uppercase; letter-spacing: 0.5px; }" +
+            ".badge { display: inline-block; padding: 3px 10px; border-radius: 9999px; font-size: 12px; font-weight: 600; }" +
+            ".badge-ok { background: #065f46; color: #34d399; }" +
+            ".badge-err { background: #7f1d1d; color: #fca5a5; }" +
+            ".badge-warn { background: #78350f; color: #fbbf24; }" +
+            ".info-grid { display: grid; grid-template-columns: 120px 1fr; gap: 6px 12px; font-size: 13px; margin: 12px 0; }" +
+            ".info-grid dt { color: #64748b; }" +
+            '.info-grid dd { color: #cbd5e1; font-family: "SF Mono", Monaco, monospace; }' +
+            ".btn { border: none; padding: 10px 20px; border-radius: 6px; cursor: pointer; font-size: 13px; font-weight: 600; transition: all 0.15s; }" +
+            ".btn:disabled { opacity: 0.5; cursor: not-allowed; }" +
+            ".btn-primary { background: #2563eb; color: white; }" +
+            ".btn-primary:hover:not(:disabled) { background: #1d4ed8; }" +
+            ".btn-outline { background: transparent; border: 1px solid #475569; color: #cbd5e1; }" +
+            ".btn-outline:hover:not(:disabled) { background: #334155; }" +
+            ".btn-sm { padding: 6px 14px; font-size: 12px; }" +
+            "select { background: #0f172a; color: #e2e8f0; border: 1px solid #475569; padding: 8px 12px; border-radius: 6px; font-size: 13px; width: 100%; }" +
+            ".progress { margin-top: 16px; padding: 14px; background: #0f172a; border-radius: 8px; border: 1px solid #334155; display: none; }" +
+            ".progress.active { display: block; }" +
+            ".progress .step { color: #38bdf8; font-weight: 600; font-size: 13px; }" +
+            ".progress .substep { color: #64748b; font-size: 12px; margin-top: 4px; }" +
+            ".progress-bar { height: 4px; background: #334155; border-radius: 2px; margin-top: 10px; overflow: hidden; }" +
+            ".progress-bar-fill { height: 100%; background: #2563eb; border-radius: 2px; transition: width 0.5s; }" +
+            ".actions { display: flex; gap: 10px; align-items: center; flex-wrap: wrap; margin-top: 12px; }" +
+            '.checkbox-label { font-size: 13px; color: #94a3b8; display: flex; align-items: center; gap: 6px; cursor: pointer; }' +
+            ".row { display: flex; gap: 8px; align-items: center; }" +
+            ".separator { border-top: 1px solid #334155; margin: 16px 0; }";
+        var body = '<div class="container">' +
+            "<h1>OnRoad Dev Console</h1>" +
+            '<p class="subtitle">Gerenciamento de banco para desenvolvimento local</p>' +
+            // Auth card
+            '<div class="card"><h2>Cloud SDK</h2>' +
+            '<div class="row">' +
+            '<span id="auth-badge" class="badge badge-warn">verificando...</span>' +
+            '<span id="auth-account" style="font-size:13px; color:#94a3b8;"></span>' +
+            "</div></div>" +
+            // Local DB card
+            '<div class="card"><h2>Banco Local</h2>' +
+            '<dl class="info-grid">' +
+            "<dt>Host</dt><dd>" + cfg.localDb.host + ":" + cfg.localDb.port + "</dd>" +
+            "<dt>Database</dt><dd>" + cfg.localDb.database + "</dd>" +
+            "<dt>User</dt><dd>" + cfg.localDb.user + "</dd>" +
+            "</dl>" +
+            '<a href="/dev/db/backup/local" class="btn btn-outline btn-sm">Exportar SQL Local</a>' +
+            "</div>" +
+            // GCP Restore card
+            '<div class="card"><h2>Restaurar do GCP</h2>' +
+            '<p style="font-size:13px; color:#64748b; margin-bottom:12px;">' +
+            'Instância <strong style="color:#cbd5e1;">' + cfg.instanceId + "</strong> " +
+            'no projeto <strong style="color:#cbd5e1;">' + cfg.projectId + "</strong>" +
+            "</p>" +
+            '<label style="display:block; font-size:13px; color:#94a3b8; margin-bottom:6px;">Banco de origem:</label>' +
+            '<div class="row">' +
+            '<select id="db-select"><option value="' + cfg.sourceDatabase + '">' + cfg.sourceDatabase + " (padrão)</option></select>" +
+            '<button onclick="loadDatabases()" class="btn btn-outline btn-sm" id="btn-load-dbs">Atualizar</button>' +
+            "</div>" +
+            '<div class="separator"></div>' +
+            '<div class="actions">' +
+            '<label class="checkbox-label"><input type="checkbox" id="drop-check" checked> Limpar banco local antes de restaurar</label>' +
+            "</div>" +
+            '<div class="actions">' +
+            '<button onclick="startRestore()" class="btn btn-primary" id="btn-restore">Restaurar Agora</button>' +
+            "</div>" +
+            '<div class="progress" id="progress">' +
+            '<div class="step" id="progress-step">Preparando...</div>' +
+            '<div class="substep" id="progress-substep"></div>' +
+            '<div class="progress-bar"><div class="progress-bar-fill" id="progress-fill" style="width:0%"></div></div>' +
+            "</div></div>" +
+            "</div>";
+        var js = "async function checkAuth(){" +
+            'var b=document.getElementById("auth-badge"),a=document.getElementById("auth-account");' +
+            'try{var r=await fetch("/dev/db/auth/status");var d=await r.json();' +
+            'if(d.authenticated){b.className="badge badge-ok";b.textContent="autenticado";a.textContent=d.account;}' +
+            'else{b.className="badge badge-err";b.textContent="não autenticado";a.textContent="Execute: gcloud auth login";}' +
+            '}catch(e){b.className="badge badge-err";b.textContent="erro";}}' +
+            "checkAuth();" +
+            "async function loadDatabases(){" +
+            'var btn=document.getElementById("btn-load-dbs");var sel=document.getElementById("db-select");btn.disabled=true;' +
+            'try{var r=await fetch("/dev/db/databases");var d=await r.json();' +
+            "if(d.success){var cur=sel.value;sel.innerHTML=d.databases.map(function(db){" +
+            "return \"<option value='\" + db + \"'\" + (db===cur?\" selected\":\"\") + \">\" + db + \"</option>\";}).join(\"\");}" +
+            '}catch(e){alert("Erro: "+e.message);}btn.disabled=false;}' +
+            "var pollId=null;" +
+            "async function startRestore(){" +
+            'var db=document.getElementById("db-select").value;' +
+            'var drop=document.getElementById("drop-check").checked;' +
+            'var btn=document.getElementById("btn-restore");' +
+            "if(!confirm(\"Restaurar '\" + db + \"' do GCP para o banco local?\" + (drop?\" O banco local será APAGADO primeiro.\":\"\")))return;" +
+            'btn.disabled=true;document.getElementById("progress").classList.add("active");' +
+            'document.getElementById("progress-fill").style.width="5%";' +
+            'document.getElementById("progress-fill").style.background="#2563eb";' +
+            'document.getElementById("progress-step").style.color="#38bdf8";' +
+            'try{var r=await fetch("/dev/db/restore",{method:"POST",headers:{"Content-Type":"application/json"},' +
+            "body:JSON.stringify({database:db,dropExisting:drop})});var d=await r.json();" +
+            'if(!d.success){alert("Erro: "+d.error);btn.disabled=false;return;}' +
+            "pollId=setInterval(pollStatus,2000);" +
+            '}catch(e){alert("Falha: "+e.message);btn.disabled=false;}}' +
+            "async function pollStatus(){" +
+            'try{var r=await fetch("/dev/db/restore/status");var d=await r.json();' +
+            'var s=document.getElementById("progress-step");var sub=document.getElementById("progress-substep");' +
+            'var fill=document.getElementById("progress-fill");var btn=document.getElementById("btn-restore");' +
+            "s.textContent=d.step;" +
+            'if(d.status==="running"){var m={"Exportando":20,"Baixando":40,"Recriando":55,"Restaurando":70,"Rodando":90};' +
+            "var pct=10;for(var k in m){if(d.step.indexOf(k)>=0)pct=m[k];}fill.style.width=pct+\"%\";}" +
+            'else if(d.status==="done"){fill.style.width="100%";fill.style.background="#22c55e";' +
+            's.style.color="#22c55e";sub.textContent="Banco local atualizado com sucesso!";clearInterval(pollId);btn.disabled=false;}' +
+            'else if(d.status==="error"){fill.style.width="100%";fill.style.background="#ef4444";' +
+            's.style.color="#ef4444";sub.textContent=d.error||"Erro desconhecido";clearInterval(pollId);btn.disabled=false;}' +
+            "}catch(e){}}";
+        return ('<!DOCTYPE html><html lang="pt-br"><head><meta charset="UTF-8">' +
+            "<title>OnRoad Dev Console</title>" +
+            "<style>" + css + "</style></head>" +
+            "<body>" + body +
+            "<script>" + js + "</script></body></html>");
+    }
+}
+//# sourceMappingURL=DevToolsController.js.map

package/dist/dev/DevToolsController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsController.js","sourceRoot":"","sources":["../../src/dev/DevToolsController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAChC,OAAO,EAAE,MAAM,IAAI,CAAA;AACnB,OAAO,IAAI,MAAM,MAAM,CAAA;AAEvB,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;AAuBjC;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAAgB;IACtB,cAAc,GAAqD;QACzE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,EAAE;KACT,CAAA;IAED,YAAY,MAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,wDAAwD;IAExD,eAAe,GAAG,KAAK,EAAE,IAAa,EAAE,GAAa,EAAiB,EAAE;QACtE,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,gCAAgC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;YACtE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,iCAAiC,EAAE;gBACpE,OAAO,EAAE,KAAK;aACf,CAAC,CAAA;YACF,GAAG,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QACnD,CAAC;IACH,CAAC,CAAA;IAED,aAAa,GAAG,KAAK,EAAE,IAAa,EAAE,GAAa,EAAiB,EAAE;QACpE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,MAAM,CAAA;QAC7C,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAChC,uCAAuC;gBACrC,UAAU;gBACV,aAAa;gBACb,SAAS;gBACT,kBAAkB,EACpB,EAAE,OAAO,EAAE,MAAM,EAAE,CACpB,CAAA;YACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;iBACjC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;iBACvB,MAAM,CACL,CAAC,CAAS,EAAE,EAAE,CACZ,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC,QAAQ,CAC/D,CAAC,CACF,CACJ,CAAA;YACH,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;QACxC,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QAChE,CAAC;IACH,CAAC,CAAA;IAED,gBAAgB,GAAG,KAAK,EAAE,GAAY,EAAE,GAAa,EAAiB,EAAE;QACtE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,IAAI,CAAA;QAC3C,MAAM,MAAM,GAAG,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAA;QAErD,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC7C,GAAG;iBACA,MAAM,CAAC,GAAG,CAAC;iBACX,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC,CAAA;YACxE,OAAM;QACR,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,CAAA;QACjE,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAA;QAEzD,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACpD,IAAI,CAAC,cAAc,GAAG;gBACpB,MAAM,EAAE,OAAO;gBACf,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,GAAG,CAAC,OAAO;aACnB,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,aAAa,GAAG,KAAK,EACnB,IAAa,EACb,GAAa,EACE,EAAE;QACjB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IAC/B,CAAC,CAAA;IAED,mBAAmB,GAAG,KAAK,EACzB,IAAa,EACb,GAAa,EACE,EAAE;QACjB,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAA;QAC/B,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QACzD,MAAM,QAAQ,GAAG,eAAe,GAAG,OAAO,CAAC,QAAQ,GAAG,GAAG,GAAG,EAAE,GAAG,MAAM,CAAA;QACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAE5C,IAAI,CAAC;YACH,MAAM,GAAG,GACP,cAAc;gBACd,OAAO,CAAC,QAAQ;gBAChB,eAAe;gBACf,OAAO,CAAC,IAAI;gBACZ,MAAM;gBACN,OAAO,CAAC,IAAI;gBACZ,MAAM;gBACN,OAAO,CAAC,IAAI;gBACZ,MAAM;gBACN,OAAO,CAAC,QAAQ;gBAChB,UAAU;gBACV,QAAQ,CAAA;YACV,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;YAC1C,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE;gBACpC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;oBAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;YACtD,CAAC,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QAChE,CAAC;IACH,CAAC,CAAA;IAED,eAAe,GAAG,KAAK,EACrB,IAAa,EACb,GAAa,EACE,EAAE;QACjB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;IAC5B,CAAC,CAAA;IAED,sCAAsC;IAE9B,KAAK,CAAC,UAAU,CACtB,QAAgB,EAChB,YAAqB;QAErB,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,CAAA;QAClE,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAA;QACtE,MAAM,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,GAAG,GAAG,YAAY,CAAA;QACzD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;QAEjD,IAAI,CAAC;YACH,mCAAmC;YACnC,IAAI,CAAC,cAAc,CAAC,IAAI,GAAG,aAAa,GAAG,QAAQ,GAAG,kBAAkB,CAAA;YACxE,MAAM,SAAS,CACb,wBAAwB;gBACtB,UAAU;gBACV,GAAG;gBACH,OAAO;gBACP,cAAc;gBACd,QAAQ;gBACR,aAAa;gBACb,SAAS;gBACT,UAAU,EACZ,EAAE,OAAO,EAAE,OAAO,EAAE,CACrB,CAAA;YAED,wBAAwB;YACxB,IAAI,CAAC,cAAc,CAAC,IAAI,GAAG,yBAAyB,CAAA;YACpD,MAAM,SAAS,CAAC,oBAAoB,GAAG,OAAO,GAAG,GAAG,GAAG,SAAS,EAAE;gBAChE,OAAO,EAAE,OAAO;aACjB,CAAC,CAAA;YAEF,oCAAoC;YACpC,SAAS,CAAC,oBAAoB,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YAEzD,+BAA+B;YAC/B,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC,cAAc,CAAC,IAAI,GAAG,0BAA0B,CAAA;gBACrD,MAAM,KAAK,GAAG,cAAc,GAAG,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAA;gBACrD,MAAM,MAAM,GACV,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAA;gBAEtE,+BAA+B;gBAC/B,MAAM,SAAS,CACb,KAAK;oBACH,QAAQ;oBACR,MAAM;oBACN,4FAA4F;oBAC5F,OAAO,CAAC,QAAQ;oBAChB,kCAAkC,EACpC,EAAE,OAAO,EAAE,MAAM,EAAE,CACpB,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;gBAEjB,MAAM,SAAS,CACb,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,eAAe,GAAG,OAAO,CAAC,QAAQ,EAChE,EAAE,OAAO,EAAE,MAAM,EAAE,CACpB,CAAA;gBACD,MAAM,SAAS,CACb,KAAK,GAAG,YAAY,GAAG,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,QAAQ,EACtD,EAAE,OAAO,EAAE,MAAM,EAAE,CACpB,CAAA;YACH,CAAC;YAED,qCAAqC;YACrC,IAAI,CAAC,cAAc,CAAC,IAAI,GAAG,oCAAoC,CAAA;YAC/D,MAAM,SAAS,CACb,cAAc;gBACZ,OAAO,CAAC,QAAQ;gBAChB,YAAY;gBACZ,OAAO,CAAC,IAAI;gBACZ,MAAM;gBACN,OAAO,CAAC,IAAI;gBACZ,MAAM;gBACN,OAAO,CAAC,IAAI;gBACZ,MAAM;gBACN,OAAO,CAAC,QAAQ;gBAChB,MAAM;gBACN,SAAS,EACX,EAAE,OAAO,EAAE,OAAO,EAAE,CACrB,CAAA;YAED,qBAAqB;YACrB,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;gBAC/B,IAAI,CAAC,cAAc,CAAC,IAAI,GAAG,uBAAuB,CAAA;gBAClD,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAA;YACpC,CAAC;YAED,IAAI,CAAC,cAAc,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAA;QACrE,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,CAAC,cAAc,GAAG;gBACpB,MAAM,EAAE,OAAO;gBACf,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,KAAK,CAAC,OAAO;aACrB,CAAA;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;gBAAE,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;QACxD,CAAC;IACH,CAAC;IAED,2EAA2E;IAEnE,SAAS;QACf,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAA;QAErB,IAAI,GAAG,GACL,sDAAsD;YACtD,iKAAiK;YACjK,kDAAkD;YAClD,6DAA6D;YAC7D,qEAAqE;YACrE,oHAAoH;YACpH,sHAAsH;YACtH,gHAAgH;YAChH,oDAAoD;YACpD,qDAAqD;YACrD,sDAAsD;YACtD,iHAAiH;YACjH,mCAAmC;YACnC,8EAA8E;YAC9E,2IAA2I;YAC3I,sDAAsD;YACtD,qDAAqD;YACrD,4DAA4D;YAC5D,sFAAsF;YACtF,4DAA4D;YAC5D,iDAAiD;YACjD,iJAAiJ;YACjJ,mIAAmI;YACnI,sCAAsC;YACtC,wEAAwE;YACxE,0EAA0E;YAC1E,6GAA6G;YAC7G,uGAAuG;YACvG,gGAAgG;YAChG,qHAAqH;YACrH,wDAAwD;YACxD,+DAA+D,CAAA;QAEjE,IAAI,IAAI,GACN,yBAAyB;YACzB,6BAA6B;YAC7B,2EAA2E;YAC3E,YAAY;YACZ,sCAAsC;YACtC,mBAAmB;YACnB,sEAAsE;YACtE,wEAAwE;YACxE,cAAc;YACd,gBAAgB;YAChB,wCAAwC;YACxC,wBAAwB;YACxB,mBAAmB,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,OAAO;YACzE,uBAAuB,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,GAAG,OAAO;YACxD,mBAAmB,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,OAAO;YAChD,OAAO;YACP,sFAAsF;YACtF,QAAQ;YACR,mBAAmB;YACnB,6CAA6C;YAC7C,gEAAgE;YAChE,2CAA2C,GAAG,GAAG,CAAC,UAAU,GAAG,YAAY;YAC3E,4CAA4C,GAAG,GAAG,CAAC,SAAS,GAAG,WAAW;YAC1E,MAAM;YACN,0GAA0G;YAC1G,mBAAmB;YACnB,wCAAwC,GAAG,GAAG,CAAC,cAAc,GAAG,IAAI,GAAG,GAAG,CAAC,cAAc,GAAG,6BAA6B;YACzH,uGAAuG;YACvG,QAAQ;YACR,+BAA+B;YAC/B,uBAAuB;YACvB,6HAA6H;YAC7H,QAAQ;YACR,uBAAuB;YACvB,oGAAoG;YACpG,QAAQ;YACR,sCAAsC;YACtC,0DAA0D;YAC1D,mDAAmD;YACnD,2GAA2G;YAC3G,cAAc;YACd,QAAQ,CAAA;QAEV,IAAI,EAAE,GACJ,6BAA6B;YAC7B,wFAAwF;YACxF,oEAAoE;YACpE,wGAAwG;YACxG,iHAAiH;YACjH,iEAAiE;YACjE,cAAc;YACd,iCAAiC;YACjC,iHAAiH;YACjH,kEAAkE;YAClE,6EAA6E;YAC7E,sHAAsH;YACtH,2DAA2D;YAC3D,kBAAkB;YAClB,gCAAgC;YAChC,oDAAoD;YACpD,yDAAyD;YACzD,iDAAiD;YACjD,sIAAsI;YACtI,gFAAgF;YAChF,4DAA4D;YAC5D,sEAAsE;YACtE,iEAAiE;YACjE,qGAAqG;YACrG,8EAA8E;YAC9E,oEAAoE;YACpE,sCAAsC;YACtC,4DAA4D;YAC5D,8BAA8B;YAC9B,uEAAuE;YACvE,qGAAqG;YACrG,mGAAmG;YACnG,uBAAuB;YACvB,8GAA8G;YAC9G,2FAA2F;YAC3F,qFAAqF;YACrF,0HAA0H;YAC1H,sFAAsF;YACtF,iHAAiH;YACjH,cAAc,CAAA;QAEhB,OAAO,CACL,gEAAgE;YAChE,mCAAmC;YACnC,SAAS,GAAG,GAAG,GAAG,iBAAiB;YACnC,QAAQ,GAAG,IAAI;YACf,UAAU,GAAG,EAAE,GAAG,yBAAyB,CAC5C,CAAA;IACH,CAAC;CACF"}

package/dist/dev/DevToolsPlugin.d.ts

@@ -0,0 +1,10 @@
+import type { OnRoadExpress } from "../OnRoadExpress.js";
+import type { OnRoadPlugin } from "../plugins/OnRoadPlugin.js";
+import type { DevToolsConfig } from "./DevToolsController.js";
+export declare class DevToolsPlugin implements OnRoadPlugin {
+    name: string;
+    private config;
+    constructor(config: DevToolsConfig);
+    install(app: OnRoadExpress): Promise<void>;
+}
+//# sourceMappingURL=DevToolsPlugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsPlugin.d.ts","sourceRoot":"","sources":["../../src/dev/DevToolsPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE7D,qBAAa,cAAe,YAAW,YAAY;IACjD,IAAI,SAAmB;IAEvB,OAAO,CAAC,MAAM,CAAgB;gBAElB,MAAM,EAAE,cAAc;IAI5B,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAiBjD"}

package/dist/dev/DevToolsPlugin.js

@@ -0,0 +1,23 @@
+import { DevToolsController } from "./DevToolsController.js";
+export class DevToolsPlugin {
+    name = "DevToolsPlugin";
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async install(app) {
+        if (process.env.NODE_ENV === "production" && !process.env.FORCE_DEV_TOOLS) {
+            return;
+        }
+        const ctrl = new DevToolsController(this.config);
+        const express = app.app;
+        express.get("/dev/db/dashboard", ctrl.renderDashboard);
+        express.get("/dev/db/auth/status", ctrl.checkGcloudAuth);
+        express.get("/dev/db/databases", ctrl.listDatabases);
+        express.get("/dev/db/backup/local", ctrl.downloadLocalBackup);
+        express.post("/dev/db/restore", ctrl.exportAndRestore);
+        express.get("/dev/db/restore/status", ctrl.restoreStatus);
+        app.logger.info("[DevToolsPlugin] Dev console available at /dev/db/dashboard");
+    }
+}
+//# sourceMappingURL=DevToolsPlugin.js.map

package/dist/dev/DevToolsPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevToolsPlugin.js","sourceRoot":"","sources":["../../src/dev/DevToolsPlugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAG5D,MAAM,OAAO,cAAc;IACzB,IAAI,GAAG,gBAAgB,CAAA;IAEf,MAAM,CAAgB;IAE9B,YAAY,MAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAkB;QAC9B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;YAC1E,OAAM;QACR,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAChD,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAA;QAEvB,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,CAAC,eAAe,CAAC,CAAA;QACtD,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,IAAI,CAAC,eAAe,CAAC,CAAA;QACxD,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,CAAC,aAAa,CAAC,CAAA;QACpD,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAA;QAC7D,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAA;QACtD,OAAO,CAAC,GAAG,CAAC,wBAAwB,EAAE,IAAI,CAAC,aAAa,CAAC,CAAA;QAEzD,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAA;IAChF,CAAC;CACF"}

package/dist/dev/index.d.ts

@@ -2,4 +2,7 @@ export { DevServer } from "./DevServer.js";
 export type { DevServerConfig, DevDatabaseConfig, GcpRestoreConfig } from "./DevServer.js";
 export { MigrationCLI } from "./MigrationCLI.js";
 export type { MigrationCLIConfig } from "./MigrationCLI.js";
+export { DevToolsController } from "./DevToolsController.js";
+export type { DevToolsConfig } from "./DevToolsController.js";
+export { DevToolsPlugin } from "./DevToolsPlugin.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAE1F,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA"}
+{"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,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAE1F,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/dev/index.js

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

package/dist/dev/index.js.map

@@ -1 +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"}
+{"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;AAGhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/index.d.ts

@@ -24,6 +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";
+export { DevServer, MigrationCLI, DevToolsController, DevToolsPlugin } from "./dev/index.js";
+export type { DevServerConfig, DevDatabaseConfig, MigrationCLIConfig, DevToolsConfig } 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;AAGpD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACxD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,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,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC5F,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -29,5 +29,5 @@ export { PinoLogger } from "./logging/index.js";
 // --- Storage ---
 export { StorageProvider } from "./storage/index.js";
 // --- Dev Tools ---
-export { DevServer, MigrationCLI } from "./dev/index.js";
+export { DevServer, MigrationCLI, DevToolsController, DevToolsPlugin } 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;AAEpD,oBAAoB;AACpB,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,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,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onroad/core",
-  "version": "4.0.0-alpha.23",
+  "version": "4.0.0-alpha.25",
   "description": "TypeScript backend framework — DI Container, Filter Chain, EventBus, Provider Pattern",
   "type": "module",
   "main": "dist/index.js",