@gravito/zenith 1.0.1 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @gravito/zenith
 
+## 1.1.0
+
+### Minor Changes
+
+- Implement several more examples and fix module issues, including:
+  - Support middleware in core route definitions.
+  - Improve Atlas driver loading and dependency injection.
+  - Add PostgreSQL support to Ecommerce MVC example.
+  - Fix internal type resolution issues across packages.
+
+### Patch Changes
+
+- Updated dependencies
+  - @gravito/atlas@1.2.0
+  - @gravito/quasar@1.2.0
+  - @gravito/stream@1.0.2
+
 ## 1.0.1
 
 ### Patch Changes

package/ECOSYSTEM_EXPANSION_RFC.md

@@ -0,0 +1,130 @@
+# Zenith Ecosystem Expansion RFC
+
+**Status**: Draft
+**Date**: 2026-01-10
+**Goal**: Expand Zenith monitoring capabilities beyond Gravito/Laravel to Python, Node.js, and Go ecosystems.
+
+---
+
+## 1. Executive Summary
+
+Gravito Zenith (Flux Console) is a unified control plane for background job processing. Currently, it supports **Gravito Stream** (Native) and **Laravel Queues** (via `laravel-zenith`). To become a true polyglot observability platform, we need to implement connectors for other popular queue systems.
+
+This RFC defines the **Universal Zenith Protocol (UZP)** and proposes implementation roadmaps for Python (Celery) and Node.js (BullMQ).
+
+---
+
+## 2. The Universal Zenith Protocol (UZP)
+
+Any background job system can be monitored by Zenith if it implements the following Redis-based interfaces.
+
+### 2.1. Discovery (Heartbeat)
+Workers must announce their presence every 30 seconds to avoid being marked as "Offline".
+
+*   **Command**: `SETEX flux_console:worker:<worker_id> 60 <payload>`
+*   **Payload (JSON)**:
+    ```json
+    {
+      "id": "celery@worker-1",
+      "hostname": "pod-xyz",
+      "pid": 1234,
+      "uptime": 3600,
+      "queues": ["high", "default"],
+      "concurrency": 4,
+      "memory": { "rss": "50MB", "heapUsed": "N/A" },
+      "framework": "celery", // "laravel", "bullmq", "asynq"
+      "language": "python",  // "php", "typescript", "go"
+      "timestamp": "2026-01-10T12:00:00Z"
+    }
+    ```
+
+### 2.2. Event Stream (Logs)
+Workers publish lifecycle events to a shared Pub/Sub channel.
+
+*   **Command**: `PUBLISH flux_console:logs <payload>`
+*   **Payload (JSON)**:
+    ```json
+    {
+      "level": "info", // "info" (start), "success", "error"
+      "message": "Processing Task: tasks.send_email",
+      "workerId": "celery@worker-1",
+      "queue": "default",
+      "jobId": "uuid-v4",
+      "timestamp": "2026-01-10T12:00:01Z",
+      "metadata": {
+        "attempt": 1,
+        "latency": 45 // ms (for success/error events)
+      }
+    }
+    ```
+
+### 2.3. Metrics (Optional but Recommended)
+Connectors should increment counters for throughput aggregation.
+
+*   `INCR flux_console:metrics:processed`
+*   `INCR flux_console:metrics:failed`
+
+---
+
+## 3. Implementation Plan: Python (Celery)
+
+**Target**: `gravito/zenith-celery` (PyPI Package)
+
+### Architecture
+Celery has a rich Signal system. We can hook into `worker_ready`, `task_prerun`, `task_success`, and `task_failure`.
+
+### Component Design
+1.  **ZenithMonitor**: A Celery Bootstep that starts a background thread for Heartbeats.
+2.  **SignalHandlers**:
+    *   `task_prerun`: Publish `level: info` log.
+    *   `task_success`: Publish `level: success` log + metrics.
+    *   `task_failure`: Publish `level: error` log with traceback.
+
+### Configuration
+```python
+# celery.py
+app.conf.zenith_redis_url = "redis://localhost:6379/0"
+app.conf.zenith_enabled = True
+```
+
+---
+
+## 4. Implementation Plan: Node.js (BullMQ)
+
+**Target**: `@gravito/zenith-bullmq` (NPM Package)
+
+*Note: Gravito Stream is based on BullMQ principles but internal. This adapter allows *standard* BullMQ instances (e.g., in a NestJS app) to report to Zenith.*
+
+### Architecture
+BullMQ uses `QueueEvents` (which listens to Redis streams). A separate "Monitor" process is the best approach to avoid modifying the worker code too much.
+
+### Component Design
+1.  **ZenithMonitor Class**:
+    ```typescript
+    const monitor = new ZenithMonitor({
+      connection: redisOptions,
+      queues: ['email', 'reports']
+    });
+    monitor.start();
+    ```
+2.  It listens to BullMQ global events (completed, failed) and bridges them to UZP.
+3.  **Heartbeat**: Since BullMQ workers don't have a central registry, the Monitor acts as a "Virtual Worker" or we require users to instantiate a `ZenithWorker` wrapper.
+
+---
+
+## 5. Implementation Plan: Go (Asynq)
+
+**Target**: `github.com/gravito-framework/zenith-asynq`
+
+### Architecture
+Asynq provides `Server` middleware.
+
+### Component Design
+1.  **Middleware**: `zenith.NewMiddleware(redisClient)`.
+2.  Wraps handler execution to capture Start/Success/Fail times.
+3.  Publishes to Redis asynchronously.
+
+---
+
+## 6. Future Work: Rust (Faktory?)
+(To be determined based on demand)

package/dist/bin.js

@@ -44,6 +44,59 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
+// ../atlas/src/errors/index.ts
+var DatabaseError, ConstraintViolationError, UniqueConstraintError, ForeignKeyConstraintError, NotNullConstraintError, TableNotFoundError, ConnectionError;
+var init_errors = __esm(() => {
+  DatabaseError = class DatabaseError extends Error {
+    originalError;
+    query;
+    bindings;
+    constructor(message, originalError, query, bindings) {
+      super(message);
+      this.name = "DatabaseError";
+      this.originalError = originalError;
+      this.query = query;
+      this.bindings = bindings;
+    }
+  };
+  ConstraintViolationError = class ConstraintViolationError extends DatabaseError {
+    constructor(message, originalError, query, bindings) {
+      super(message, originalError, query, bindings);
+      this.name = "ConstraintViolationError";
+    }
+  };
+  UniqueConstraintError = class UniqueConstraintError extends ConstraintViolationError {
+    constructor(message, originalError, query, bindings) {
+      super(message, originalError, query, bindings);
+      this.name = "UniqueConstraintError";
+    }
+  };
+  ForeignKeyConstraintError = class ForeignKeyConstraintError extends ConstraintViolationError {
+    constructor(message, originalError, query, bindings) {
+      super(message, originalError, query, bindings);
+      this.name = "ForeignKeyConstraintError";
+    }
+  };
+  NotNullConstraintError = class NotNullConstraintError extends ConstraintViolationError {
+    constructor(message, originalError, query, bindings) {
+      super(message, originalError, query, bindings);
+      this.name = "NotNullConstraintError";
+    }
+  };
+  TableNotFoundError = class TableNotFoundError extends DatabaseError {
+    constructor(message, originalError, query, bindings) {
+      super(message, originalError, query, bindings);
+      this.name = "TableNotFoundError";
+    }
+  };
+  ConnectionError = class ConnectionError extends DatabaseError {
+    constructor(message, originalError) {
+      super(message, originalError);
+      this.name = "ConnectionError";
+    }
+  };
+});
+
 // ../../node_modules/.bun/bson@6.10.4/node_modules/bson/lib/bson.cjs
 var require_bson = __commonJS((exports) => {
   var TypedArrayPrototypeGetSymbolToStringTag = (() => {
@@ -33364,71 +33417,20 @@ var require_lib3 = __commonJS((exports) => {
   } });
 });
 
-// ../atlas/src/errors/index.ts
-var DatabaseError, ConstraintViolationError, UniqueConstraintError, ForeignKeyConstraintError, NotNullConstraintError, TableNotFoundError, ConnectionError;
-var init_errors = __esm(() => {
-  DatabaseError = class DatabaseError extends Error {
-    originalError;
-    query;
-    bindings;
-    constructor(message, originalError, query, bindings) {
-      super(message);
-      this.name = "DatabaseError";
-      this.originalError = originalError;
-      this.query = query;
-      this.bindings = bindings;
-    }
-  };
-  ConstraintViolationError = class ConstraintViolationError extends DatabaseError {
-    constructor(message, originalError, query, bindings) {
-      super(message, originalError, query, bindings);
-      this.name = "ConstraintViolationError";
-    }
-  };
-  UniqueConstraintError = class UniqueConstraintError extends ConstraintViolationError {
-    constructor(message, originalError, query, bindings) {
-      super(message, originalError, query, bindings);
-      this.name = "UniqueConstraintError";
-    }
-  };
-  ForeignKeyConstraintError = class ForeignKeyConstraintError extends ConstraintViolationError {
-    constructor(message, originalError, query, bindings) {
-      super(message, originalError, query, bindings);
-      this.name = "ForeignKeyConstraintError";
-    }
-  };
-  NotNullConstraintError = class NotNullConstraintError extends ConstraintViolationError {
-    constructor(message, originalError, query, bindings) {
-      super(message, originalError, query, bindings);
-      this.name = "NotNullConstraintError";
-    }
-  };
-  TableNotFoundError = class TableNotFoundError extends DatabaseError {
-    constructor(message, originalError, query, bindings) {
-      super(message, originalError, query, bindings);
-      this.name = "TableNotFoundError";
-    }
-  };
-  ConnectionError = class ConnectionError extends DatabaseError {
-    constructor(message, originalError) {
-      super(message, originalError);
-      this.name = "ConnectionError";
-    }
-  };
-});
-
 // ../atlas/src/drivers/MongoDBDriver.ts
 class MongoDBDriver {
   config;
   client = null;
   db = null;
   MongoClientCtor;
-  constructor(config, deps = {}) {
+  constructor(config, deps) {
     if (config.driver !== "mongodb") {
-      throw new Error(`Invalid driver type '\${config.driver}' for MongoDBDriver`);
+      throw new Error(`Invalid driver type '${config.driver}' for MongoDBDriver`);
     }
     this.config = config;
-    this.MongoClientCtor = deps.MongoClient ?? import_mongodb.MongoClient;
+    if (deps?.MongoClient) {
+      this.MongoClientCtor = deps.MongoClient;
+    }
   }
   getDriverName() {
     return "mongodb";
@@ -33438,13 +33440,22 @@ class MongoDBDriver {
       return;
     }
     try {
-      this.client = new this.MongoClientCtor(this.config.uri ?? `mongodb://\${this.config.host}:\${this.config.port}/\${this.config.database}`);
+      const Ctor = this.MongoClientCtor || (await this.loadMongoModule()).MongoClient;
+      this.client = new Ctor(this.config.uri ?? `mongodb://${this.config.host}:${this.config.port}/${this.config.database}`);
       await this.client.connect();
       this.db = this.client.db(this.config.database);
     } catch (error) {
       throw new ConnectionError("Could not connect to MongoDB cluster", error);
     }
   }
+  async loadMongoModule() {
+    try {
+      const mongodb = await Promise.resolve().then(() => __toESM(require_lib3(), 1));
+      return mongodb;
+    } catch (e) {
+      throw new Error(`MongoDB driver requires the "mongodb" package. Please install it: bun add mongodb. Original Error: ${e}`);
+    }
+  }
   async disconnect() {
     if (this.client) {
       await this.client.close();
@@ -33537,10 +33548,8 @@ class MongoDBDriver {
     return doc;
   }
 }
-var import_mongodb;
 var init_MongoDBDriver = __esm(() => {
   init_errors();
-  import_mongodb = __toESM(require_lib3(), 1);
 });
 
 // ../../node_modules/.bun/sqlstring@2.3.3/node_modules/sqlstring/lib/SqlString.js
@@ -67480,12 +67489,14 @@ class RedisDriver {
   config;
   client = null;
   RedisCtor;
-  constructor(config, deps = {}) {
+  constructor(config, deps) {
     if (config.driver !== "redis") {
       throw new Error(`Invalid driver type '${config.driver}' for RedisDriver`);
     }
     this.config = config;
-    this.RedisCtor = deps.Redis ?? import_ioredis.default;
+    if (deps?.Redis) {
+      this.RedisCtor = deps.Redis;
+    }
   }
   getDriverName() {
     return "redis";
@@ -67495,7 +67506,8 @@ class RedisDriver {
       return;
     }
     try {
-      this.client = new this.RedisCtor({
+      const Ctor = this.RedisCtor || (await this.loadRedisModule()).default;
+      this.client = new Ctor({
         host: this.config.host,
         port: this.config.port ?? 6379,
         password: this.config.password,
@@ -67507,6 +67519,14 @@ class RedisDriver {
       throw new ConnectionError("Could not connect to Redis host", error);
     }
   }
+  async loadRedisModule() {
+    try {
+      const ioredis = await Promise.resolve().then(() => __toESM(require_built3(), 1));
+      return ioredis;
+    } catch (e) {
+      throw new Error(`Redis driver requires the "ioredis" package. Please install it: bun add ioredis. Original Error: ${e}`);
+    }
+  }
   async disconnect() {
     if (this.client) {
       await this.client.quit();
@@ -67578,10 +67598,8 @@ class RedisDriver {
     return false;
   }
 }
-var import_ioredis;
 var init_RedisDriver = __esm(() => {
   init_errors();
-  import_ioredis = __toESM(require_built3(), 1);
 });
 
 // ../../node_modules/.bun/better-sqlite3@11.10.0/node_modules/better-sqlite3/lib/util.js
@@ -68376,11 +68394,15 @@ class SQLiteDriver {
         });
         this.client.exec("PRAGMA journal_mode = WAL;");
       } else {
-        const { default: Database } = await Promise.resolve().then(() => __toESM(require_lib10(), 1));
-        this.client = new Database(this.config.database, {
-          readonly: this.config.readonly ?? false
-        });
-        this.client.pragma("journal_mode = WAL");
+        try {
+          const { default: Database } = await Promise.resolve().then(() => __toESM(require_lib10(), 1));
+          this.client = new Database(this.config.database, {
+            readonly: this.config.readonly ?? false
+          });
+          this.client.pragma("journal_mode = WAL");
+        } catch (e) {
+          throw new Error(`SQLite driver requires "better-sqlite3" when running in Node.js. Please install it: bun add better-sqlite3. Original Error: ${e}`);
+        }
       }
     } catch (error) {
       throw new ConnectionError("Could not connect to SQLite database", error);
@@ -70644,7 +70666,7 @@ var init_Connection = __esm(() => {
       return new Proxy(this, {
         get(target, prop) {
           if (prop in target) {
-            return target[prop];
+            return Reflect.get(target, prop);
           }
           if (typeof prop === "string" && target.driver && typeof target.driver[prop] === "function") {
             return target.driver[prop].bind(target.driver);
@@ -116028,7 +116050,7 @@ class NodeProbe {
   }
 }
 // ../quasar/src/QuasarAgent.ts
-var import_ioredis2 = __toESM(require_built3(), 1);
+var import_ioredis = __toESM(require_built3(), 1);
 
 // ../quasar/src/probes/BullProbe.ts
 class BullProbe {
@@ -116147,7 +116169,7 @@ class QuasarAgent {
       this.transportRedis = options.transport.client;
     } else {
       const url = options.transport?.url || options.redisUrl || "redis://localhost:6379";
-      this.transportRedis = new import_ioredis2.Redis(url, {
+      this.transportRedis = new import_ioredis.Redis(url, {
         lazyConnect: true,
         ...options.transport?.options || {}
       });
@@ -116156,7 +116178,7 @@ class QuasarAgent {
       if (options.monitor.client) {
         this.monitorRedis = options.monitor.client;
       } else if (options.monitor.url) {
-        this.monitorRedis = new import_ioredis2.Redis(options.monitor.url, {
+        this.monitorRedis = new import_ioredis.Redis(options.monitor.url, {
           lazyConnect: true,
           ...options.monitor.options || {}
         });
@@ -116252,7 +116274,7 @@ class QuasarAgent {
       return true;
     }
     const redisUrl = this.transportRedis.options?.host ? `redis://${this.transportRedis.options.host}:${this.transportRedis.options.port || 6379}` : "redis://localhost:6379";
-    this.subscriberRedis = new import_ioredis2.Redis(redisUrl, {
+    this.subscriberRedis = new import_ioredis.Redis(redisUrl, {
       lazyConnect: true
     });
     try {
@@ -118148,12 +118170,12 @@ import path from "path";
 import { fileURLToPath } from "url";
 
 // src/server/services/CommandService.ts
-var import_ioredis3 = __toESM(require_built3(), 1);
+var import_ioredis2 = __toESM(require_built3(), 1);
 
 class CommandService {
   redis;
   constructor(redisUrl) {
-    this.redis = new import_ioredis3.Redis(redisUrl, {
+    this.redis = new import_ioredis2.Redis(redisUrl, {
       lazyConnect: true
     });
   }
@@ -118211,13 +118233,13 @@ class CommandService {
 }
 
 // src/server/services/PulseService.ts
-var import_ioredis4 = __toESM(require_built3(), 1);
+var import_ioredis3 = __toESM(require_built3(), 1);
 
 class PulseService {
   redis;
   prefix = "gravito:quasar:node:";
   constructor(redisUrl) {
-    this.redis = new import_ioredis4.Redis(redisUrl, {
+    this.redis = new import_ioredis3.Redis(redisUrl, {
       lazyConnect: true
     });
   }
@@ -118269,10 +118291,10 @@ class PulseService {
 
 // src/server/services/QueueService.ts
 import { EventEmitter as EventEmitter2 } from "events";
-var import_ioredis6 = __toESM(require_built3(), 1);
+var import_ioredis5 = __toESM(require_built3(), 1);
 
 // src/server/services/AlertService.ts
-var import_ioredis5 = __toESM(require_built3(), 1);
+var import_ioredis4 = __toESM(require_built3(), 1);
 var import_nodemailer = __toESM(require_nodemailer(), 1);
 import { EventEmitter } from "events";
 
@@ -118285,7 +118307,7 @@ class AlertService {
   RULES_KEY = "gravito:zenith:alerts:rules";
   CONFIG_KEY = "gravito:zenith:alerts:config";
   constructor(redisUrl) {
-    this.redis = new import_ioredis5.Redis(redisUrl, {
+    this.redis = new import_ioredis4.Redis(redisUrl, {
       lazyConnect: true
     });
     this.rules = [
@@ -118537,10 +118559,10 @@ class QueueService {
   manager;
   alerts;
   constructor(redisUrl, prefix = "queue:", persistence) {
-    this.redis = new import_ioredis6.Redis(redisUrl, {
+    this.redis = new import_ioredis5.Redis(redisUrl, {
       lazyConnect: true
     });
-    this.subRedis = new import_ioredis6.Redis(redisUrl, {
+    this.subRedis = new import_ioredis5.Redis(redisUrl, {
       lazyConnect: true
     });
     this.prefix = prefix;

package/dist/server/index.js

@@ -43,6 +43,59 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
+// ../atlas/src/errors/index.ts
+var DatabaseError, ConstraintViolationError, UniqueConstraintError, ForeignKeyConstraintError, NotNullConstraintError, TableNotFoundError, ConnectionError;
+var init_errors = __esm(() => {
+  DatabaseError = class DatabaseError extends Error {
+    originalError;
+    query;
+    bindings;
+    constructor(message, originalError, query, bindings) {
+      super(message);
+      this.name = "DatabaseError";
+      this.originalError = originalError;
+      this.query = query;
+      this.bindings = bindings;
+    }
+  };
+  ConstraintViolationError = class ConstraintViolationError extends DatabaseError {
+    constructor(message, originalError, query, bindings) {
+      super(message, originalError, query, bindings);
+      this.name = "ConstraintViolationError";
+    }
+  };
+  UniqueConstraintError = class UniqueConstraintError extends ConstraintViolationError {
+    constructor(message, originalError, query, bindings) {
+      super(message, originalError, query, bindings);
+      this.name = "UniqueConstraintError";
+    }
+  };
+  ForeignKeyConstraintError = class ForeignKeyConstraintError extends ConstraintViolationError {
+    constructor(message, originalError, query, bindings) {
+      super(message, originalError, query, bindings);
+      this.name = "ForeignKeyConstraintError";
+    }
+  };
+  NotNullConstraintError = class NotNullConstraintError extends ConstraintViolationError {
+    constructor(message, originalError, query, bindings) {
+      super(message, originalError, query, bindings);
+      this.name = "NotNullConstraintError";
+    }
+  };
+  TableNotFoundError = class TableNotFoundError extends DatabaseError {
+    constructor(message, originalError, query, bindings) {
+      super(message, originalError, query, bindings);
+      this.name = "TableNotFoundError";
+    }
+  };
+  ConnectionError = class ConnectionError extends DatabaseError {
+    constructor(message, originalError) {
+      super(message, originalError);
+      this.name = "ConnectionError";
+    }
+  };
+});
+
 // ../../node_modules/.bun/bson@6.10.4/node_modules/bson/lib/bson.cjs
 var require_bson = __commonJS((exports) => {
   var TypedArrayPrototypeGetSymbolToStringTag = (() => {
@@ -33363,71 +33416,20 @@ var require_lib3 = __commonJS((exports) => {
   } });
 });
 
-// ../atlas/src/errors/index.ts
-var DatabaseError, ConstraintViolationError, UniqueConstraintError, ForeignKeyConstraintError, NotNullConstraintError, TableNotFoundError, ConnectionError;
-var init_errors = __esm(() => {
-  DatabaseError = class DatabaseError extends Error {
-    originalError;
-    query;
-    bindings;
-    constructor(message, originalError, query, bindings) {
-      super(message);
-      this.name = "DatabaseError";
-      this.originalError = originalError;
-      this.query = query;
-      this.bindings = bindings;
-    }
-  };
-  ConstraintViolationError = class ConstraintViolationError extends DatabaseError {
-    constructor(message, originalError, query, bindings) {
-      super(message, originalError, query, bindings);
-      this.name = "ConstraintViolationError";
-    }
-  };
-  UniqueConstraintError = class UniqueConstraintError extends ConstraintViolationError {
-    constructor(message, originalError, query, bindings) {
-      super(message, originalError, query, bindings);
-      this.name = "UniqueConstraintError";
-    }
-  };
-  ForeignKeyConstraintError = class ForeignKeyConstraintError extends ConstraintViolationError {
-    constructor(message, originalError, query, bindings) {
-      super(message, originalError, query, bindings);
-      this.name = "ForeignKeyConstraintError";
-    }
-  };
-  NotNullConstraintError = class NotNullConstraintError extends ConstraintViolationError {
-    constructor(message, originalError, query, bindings) {
-      super(message, originalError, query, bindings);
-      this.name = "NotNullConstraintError";
-    }
-  };
-  TableNotFoundError = class TableNotFoundError extends DatabaseError {
-    constructor(message, originalError, query, bindings) {
-      super(message, originalError, query, bindings);
-      this.name = "TableNotFoundError";
-    }
-  };
-  ConnectionError = class ConnectionError extends DatabaseError {
-    constructor(message, originalError) {
-      super(message, originalError);
-      this.name = "ConnectionError";
-    }
-  };
-});
-
 // ../atlas/src/drivers/MongoDBDriver.ts
 class MongoDBDriver {
   config;
   client = null;
   db = null;
   MongoClientCtor;
-  constructor(config, deps = {}) {
+  constructor(config, deps) {
     if (config.driver !== "mongodb") {
-      throw new Error(`Invalid driver type '\${config.driver}' for MongoDBDriver`);
+      throw new Error(`Invalid driver type '${config.driver}' for MongoDBDriver`);
     }
     this.config = config;
-    this.MongoClientCtor = deps.MongoClient ?? import_mongodb.MongoClient;
+    if (deps?.MongoClient) {
+      this.MongoClientCtor = deps.MongoClient;
+    }
   }
   getDriverName() {
     return "mongodb";
@@ -33437,13 +33439,22 @@ class MongoDBDriver {
       return;
     }
     try {
-      this.client = new this.MongoClientCtor(this.config.uri ?? `mongodb://\${this.config.host}:\${this.config.port}/\${this.config.database}`);
+      const Ctor = this.MongoClientCtor || (await this.loadMongoModule()).MongoClient;
+      this.client = new Ctor(this.config.uri ?? `mongodb://${this.config.host}:${this.config.port}/${this.config.database}`);
       await this.client.connect();
       this.db = this.client.db(this.config.database);
     } catch (error) {
       throw new ConnectionError("Could not connect to MongoDB cluster", error);
     }
   }
+  async loadMongoModule() {
+    try {
+      const mongodb = await Promise.resolve().then(() => __toESM(require_lib3(), 1));
+      return mongodb;
+    } catch (e) {
+      throw new Error(`MongoDB driver requires the "mongodb" package. Please install it: bun add mongodb. Original Error: ${e}`);
+    }
+  }
   async disconnect() {
     if (this.client) {
       await this.client.close();
@@ -33536,10 +33547,8 @@ class MongoDBDriver {
     return doc;
   }
 }
-var import_mongodb;
 var init_MongoDBDriver = __esm(() => {
   init_errors();
-  import_mongodb = __toESM(require_lib3(), 1);
 });
 
 // ../../node_modules/.bun/sqlstring@2.3.3/node_modules/sqlstring/lib/SqlString.js
@@ -67479,12 +67488,14 @@ class RedisDriver {
   config;
   client = null;
   RedisCtor;
-  constructor(config, deps = {}) {
+  constructor(config, deps) {
     if (config.driver !== "redis") {
       throw new Error(`Invalid driver type '${config.driver}' for RedisDriver`);
     }
     this.config = config;
-    this.RedisCtor = deps.Redis ?? import_ioredis.default;
+    if (deps?.Redis) {
+      this.RedisCtor = deps.Redis;
+    }
   }
   getDriverName() {
     return "redis";
@@ -67494,7 +67505,8 @@ class RedisDriver {
       return;
     }
     try {
-      this.client = new this.RedisCtor({
+      const Ctor = this.RedisCtor || (await this.loadRedisModule()).default;
+      this.client = new Ctor({
         host: this.config.host,
         port: this.config.port ?? 6379,
         password: this.config.password,
@@ -67506,6 +67518,14 @@ class RedisDriver {
       throw new ConnectionError("Could not connect to Redis host", error);
     }
   }
+  async loadRedisModule() {
+    try {
+      const ioredis = await Promise.resolve().then(() => __toESM(require_built3(), 1));
+      return ioredis;
+    } catch (e) {
+      throw new Error(`Redis driver requires the "ioredis" package. Please install it: bun add ioredis. Original Error: ${e}`);
+    }
+  }
   async disconnect() {
     if (this.client) {
       await this.client.quit();
@@ -67577,10 +67597,8 @@ class RedisDriver {
     return false;
   }
 }
-var import_ioredis;
 var init_RedisDriver = __esm(() => {
   init_errors();
-  import_ioredis = __toESM(require_built3(), 1);
 });
 
 // ../../node_modules/.bun/better-sqlite3@11.10.0/node_modules/better-sqlite3/lib/util.js
@@ -68375,11 +68393,15 @@ class SQLiteDriver {
         });
         this.client.exec("PRAGMA journal_mode = WAL;");
       } else {
-        const { default: Database } = await Promise.resolve().then(() => __toESM(require_lib10(), 1));
-        this.client = new Database(this.config.database, {
-          readonly: this.config.readonly ?? false
-        });
-        this.client.pragma("journal_mode = WAL");
+        try {
+          const { default: Database } = await Promise.resolve().then(() => __toESM(require_lib10(), 1));
+          this.client = new Database(this.config.database, {
+            readonly: this.config.readonly ?? false
+          });
+          this.client.pragma("journal_mode = WAL");
+        } catch (e) {
+          throw new Error(`SQLite driver requires "better-sqlite3" when running in Node.js. Please install it: bun add better-sqlite3. Original Error: ${e}`);
+        }
       }
     } catch (error) {
       throw new ConnectionError("Could not connect to SQLite database", error);
@@ -70643,7 +70665,7 @@ var init_Connection = __esm(() => {
       return new Proxy(this, {
         get(target, prop) {
           if (prop in target) {
-            return target[prop];
+            return Reflect.get(target, prop);
           }
           if (typeof prop === "string" && target.driver && typeof target.driver[prop] === "function") {
             return target.driver[prop].bind(target.driver);
@@ -116027,7 +116049,7 @@ class NodeProbe {
   }
 }
 // ../quasar/src/QuasarAgent.ts
-var import_ioredis2 = __toESM(require_built3(), 1);
+var import_ioredis = __toESM(require_built3(), 1);
 
 // ../quasar/src/probes/BullProbe.ts
 class BullProbe {
@@ -116146,7 +116168,7 @@ class QuasarAgent {
       this.transportRedis = options.transport.client;
     } else {
       const url = options.transport?.url || options.redisUrl || "redis://localhost:6379";
-      this.transportRedis = new import_ioredis2.Redis(url, {
+      this.transportRedis = new import_ioredis.Redis(url, {
         lazyConnect: true,
         ...options.transport?.options || {}
       });
@@ -116155,7 +116177,7 @@ class QuasarAgent {
       if (options.monitor.client) {
         this.monitorRedis = options.monitor.client;
       } else if (options.monitor.url) {
-        this.monitorRedis = new import_ioredis2.Redis(options.monitor.url, {
+        this.monitorRedis = new import_ioredis.Redis(options.monitor.url, {
           lazyConnect: true,
           ...options.monitor.options || {}
         });
@@ -116251,7 +116273,7 @@ class QuasarAgent {
       return true;
     }
     const redisUrl = this.transportRedis.options?.host ? `redis://${this.transportRedis.options.host}:${this.transportRedis.options.port || 6379}` : "redis://localhost:6379";
-    this.subscriberRedis = new import_ioredis2.Redis(redisUrl, {
+    this.subscriberRedis = new import_ioredis.Redis(redisUrl, {
       lazyConnect: true
     });
     try {
@@ -118147,12 +118169,12 @@ import path from "path";
 import { fileURLToPath } from "url";
 
 // src/server/services/CommandService.ts
-var import_ioredis3 = __toESM(require_built3(), 1);
+var import_ioredis2 = __toESM(require_built3(), 1);
 
 class CommandService {
   redis;
   constructor(redisUrl) {
-    this.redis = new import_ioredis3.Redis(redisUrl, {
+    this.redis = new import_ioredis2.Redis(redisUrl, {
       lazyConnect: true
     });
   }
@@ -118210,13 +118232,13 @@ class CommandService {
 }
 
 // src/server/services/PulseService.ts
-var import_ioredis4 = __toESM(require_built3(), 1);
+var import_ioredis3 = __toESM(require_built3(), 1);
 
 class PulseService {
   redis;
   prefix = "gravito:quasar:node:";
   constructor(redisUrl) {
-    this.redis = new import_ioredis4.Redis(redisUrl, {
+    this.redis = new import_ioredis3.Redis(redisUrl, {
       lazyConnect: true
     });
   }
@@ -118268,10 +118290,10 @@ class PulseService {
 
 // src/server/services/QueueService.ts
 import { EventEmitter as EventEmitter2 } from "events";
-var import_ioredis6 = __toESM(require_built3(), 1);
+var import_ioredis5 = __toESM(require_built3(), 1);
 
 // src/server/services/AlertService.ts
-var import_ioredis5 = __toESM(require_built3(), 1);
+var import_ioredis4 = __toESM(require_built3(), 1);
 var import_nodemailer = __toESM(require_nodemailer(), 1);
 import { EventEmitter } from "events";
 
@@ -118284,7 +118306,7 @@ class AlertService {
   RULES_KEY = "gravito:zenith:alerts:rules";
   CONFIG_KEY = "gravito:zenith:alerts:config";
   constructor(redisUrl) {
-    this.redis = new import_ioredis5.Redis(redisUrl, {
+    this.redis = new import_ioredis4.Redis(redisUrl, {
       lazyConnect: true
     });
     this.rules = [
@@ -118536,10 +118558,10 @@ class QueueService {
   manager;
   alerts;
   constructor(redisUrl, prefix = "queue:", persistence) {
-    this.redis = new import_ioredis6.Redis(redisUrl, {
+    this.redis = new import_ioredis5.Redis(redisUrl, {
       lazyConnect: true
     });
-    this.subRedis = new import_ioredis6.Redis(redisUrl, {
+    this.subRedis = new import_ioredis5.Redis(redisUrl, {
       lazyConnect: true
     });
     this.prefix = prefix;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravito/zenith",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Gravito Zenith: Zero-config control plane for Gravito Flux & Stream",
   "type": "module",
   "bin": {

package/DEMO.md

@@ -1,156 +0,0 @@
-# 🎮 Flux Console - Live Demo Walkthrough
-
-This guide provides a step-by-step script for demonstrating the capabilities of **Flux Console**. It simulates a real-world production environment with traffic spikes, worker processing, and real-time monitoring.
-
-## 🏗️ Architecture Setup
-
-In this demo, we will run three components locally:
-1.  **Redis**: The message broker (must be running on `localhost:6379`).
-2.  **Flux Console**: The monitoring dashboard.
-3.  **Demo Worker**: A simulated worker that processes jobs from queues (`orders`, `reports`, etc.).
-4.  **Traffic Generator**: A script to flood the queues with jobs.
-
----
-
-## 🏛️ Persistence & History (Optional)
-
-To test the **Job Archive**, **Operational Logs**, and **Search** features, you need a database. Flux Console supports two modes:
-
-### A. Zero-Config (SQLite) - **Recommended for Quick Tests**
-Simply set the `DB_DRIVER` and `DB_NAME` environment variables. It will create a local `.sqlite` file.
-```bash
-export DB_DRIVER=sqlite
-export DB_NAME=flux.sqlite
-export PERSIST_ARCHIVE_COMPLETED=true # Archive successful jobs too
-```
-
-### B. Full Stack (MySQL + Redis) - **Using Docker**
-If you have Docker installed, you can spin up a production-ready environment:
-```bash
-cd packages/flux-console
-docker-compose up -d
-```
-Then set your env variables to match:
-```bash
-export DB_HOST=localhost
-export DB_USER=root
-export DB_PASSWORD=root
-export DB_NAME=flux
-```
-
----
-
-## 🎬 Step-by-Step Demo Script
-
-### Step 1: Start the Flux Console 🖥️
-
-Open your first terminal window and launch the console. This starts both the web server and the SSE (Server-Sent Events) stream.
-
-```bash
-cd packages/flux-console
-bun run start
-```
-
-> **Verify**: Open [http://localhost:3000](http://localhost:3000) in your browser. You should see the dashboard. It might be empty or show "No Data" initially.
-
-### Step 2: Start the Worker 👷
-
-We need a worker to "eat" the jobs. Without this, jobs will just pile up in the queue.
-Open a **second terminal window**:
-
-```bash
-cd packages/flux-console
-bun run scripts/demo-worker.ts
-```
-
-> **Observe**: 
-> - You should see `[Consumer] Started`.
-> - The console output will show it's watching queues: `orders`, `notifications`, `billing`, etc.
-> - **In the Browser**: Go to the **Workers** page. You should see `worker-xxxxx` appear as "Online". Note the **Cluster RAM** and **Load** metrics which reflect your actual machine's status.
-
-### Step 3: Unleash the Traffic! 🚀
-
-Now, let's simulate a traffic spike (e.g., Black Friday sale).
-Open a **third terminal window**:
-
-```bash
-cd packages/flux-console
-bun run scripts/generate-random-traffic.ts
-```
-
-This script will:
-- Push **50 jobs** randomly distributed to different queues.
-- Some jobs are designed to **fail** (to test error handling).
-- Some jobs are **delayed**.
-
-> **Pro Tip**: Run this command multiple times rapidly to simulate a higher load spike!
-
----
-
-## 🧪 Understanding Test Job Behavior
-
-The demo worker uses a special `TestJob` class that simulates different real-world scenarios:
-
-### Intentional Failures (DLQ Testing)
-Jobs with IDs containing `"fail"` (e.g., `job-fail-1767244949663-25`) are **designed to always throw an error**. This is intentional and serves to demonstrate:
-
-1.  **Retry Mechanism**: You'll see these jobs attempt multiple times (`Attempt: 1, 2, 3...`).
-2.  **Exponential Backoff**: Each retry waits longer than the previous one (2s, 6s, 18s...).
-3.  **Dead Letter Queue (DLQ)**: After max attempts (default: 3), the job moves to the **Failed** queue.
-4.  **Error Handling UI**: You can see these in the Console's "Failed" tab with full error stack traces.
-
-**This is expected behavior!** These jobs represent scenarios like:
-- Invalid order IDs
-- Malformed email addresses
-- External API permanently rejecting a request
-
-### Normal Jobs
-Jobs without `"fail"` in their ID will:
-- Process successfully after a simulated 50ms delay
-- Update the throughput metrics
-- Disappear from the queue
-
-### The `default` Queue
-When you click **"Retry All Failed"** in the Console, failed jobs are moved back to the queue. Due to how the retry mechanism works, they may be placed in the `default` queue instead of their original queue. This is why the worker monitors both specific queues (`orders`, `email`, etc.) **and** the `default` queue.
-
----
-
-## 🎬 Step 4: The Showcase (What to show in the UI) ✨
-
-Now, switch to the browser window and walk through these views:
-
-#### 1. 📊 Dashboard (Overview)
-- **Throughput Chart**: You will see a sudden spike in the green line (Processed/min).
-- **Active Queues**: You'll see numbers jumping in `Waiting` and `Active` columns.
-- **Top Right Live Logs**: Watch the logs stream in real-time as the worker processes jobs.
-- **Log Search**: Click on **"Search Archive"** in the logs panel to open the historical log browser. This allows querying through millions of past events stored in SQL.
-
-#### 2. 🧱 Queues Page
-- Navigate to the **Queues** tab.
-- Click on `queue:orders` or `queue:email`.
-- **Action**: You can see jobs moving from **Waiting** to **Active**.
-- **Inspection**: Click the "Eye" icon (Inspector) on a queue to see the JSON payload of waiting jobs.
-
-#### 3. 🚨 Retry Handling (The "Oh No!" Moment)
-- Go to the **Queues** page and look for the **Failed** tab (Red badge).
-- You should see jobs with an error like `Simulated permanent failure`.
-- **Action**: Click the "Retry All" button specifically for the failed jobs.
-- **Result**: Watch the "Failed" count drop to 0 and the "Waiting" count go up. The worker will pick them up again.
-
-#### 4. ⚙️ Workers Page
-- Refresh or stay on the **Workers** page.
-- Observe the **Avg Load** bar changing colors (Green -> Amber) depending on your CPU usage.
-- Explain that this demonstrates the **Real-time Health Monitoring** of the infrastructure.
-
----
-
-## 🧹 Cleanup
-
-To reset the demo environment (purge all queues):
-
-```bash
-# In the third terminal
-bun run scripts/debug-redis.ts
-# OR manually flush redis if you have redis-cli installed
-# redis-cli flushall
-```