@ngn-net/nestjs-telescope 0.3.0 → 0.3.2

package/README.md

@@ -4,7 +4,7 @@
 
 A full-featured developer assistant and application monitoring suite for NestJS, inspired by Laravel Telescope. It monitors incoming HTTP requests, database queries, cache operations, background queue jobs, application events, outgoing mail, logs, unhandled exceptions, cron job schedules, Redis commands, CLI commands, ORM model lifecycle events, notifications, and authorization gate checks.
 
-All telemetry records are persisted to **MongoDB** (via Mongoose) for zero-impact storage that never touches your production database.
+All telemetry records are persisted to a **dedicated MongoDB** (via Mongoose) and accessible via a modern, high-fidelity dark-themed single-page application dashboard. Telescope uses its own MongoDB connection — completely separate from your project's database.
 
 ---
 
@@ -41,18 +41,18 @@ Telescope stores its telemetry data in a **dedicated MongoDB collection** (`tele
 
 ### MongoDB Connection
 
-Telescope connects to MongoDB using the `MONGO_URI` environment variable, or falls back to `mongodb://localhost:27017/telescope`.
+Telescope connects to its own dedicated MongoDB using the `TELESCOPE_MONGO_URI` environment variable, or falls back to `mongodb://localhost:27017/telescope`.
 
 ```bash
 # .env
-MONGO_URI=mongodb://localhost:27017/telescope
+TELESCOPE_MONGO_URI=mongodb://localhost:27017/telescope
 ```
 
 Or pass the URI directly in configuration:
 
 ```typescript
 TelescopeModule.forRoot({
-  mongoUri: 'mongodb://localhost:27017/telescope',
+  mongoUri: 'mongodb://your-mongo-host:27017/telescope',
   // ... other options
 })
 ```
@@ -64,10 +64,10 @@ TelescopeModule.forRoot({
 Install the package:
 
 ```bash
-npm install @ngn-net/nestjs-telescope @nestjs/mongoose mongoose @nestjs/jwt @nestjs/passport passport-jwt
+npm install @ngn-net/nestjs-telescope @nestjs/jwt @nestjs/passport passport-jwt
 ```
 
-Ensure you have `MongooseModule` initialized in your NestJS application.
+No need to install `mongoose` or configure `MongooseModule` — Telescope handles its own MongoDB connection internally.
 
 ---
 
@@ -75,25 +75,23 @@ Ensure you have `MongooseModule` initialized in your NestJS application.
 
 ```typescript
 import { Module } from '@nestjs/common';
-import { MongooseModule } from '@nestjs/mongoose';
 import { TelescopeModule } from '@ngn-net/nestjs-telescope';
 
 @Module({
   imports: [
-    MongooseModule.forRoot(process.env.MONGO_URI || 'mongodb://localhost:27017/telescope'),
     TelescopeModule.forRoot({
       path: 'telescope',
       jwtSecret: 'your-secret-key',
       password: 'your-password',
+      // Telescope connects to its own MongoDB automatically
+      // Default: mongodb://localhost:27017/telescope
     }),
   ],
 })
 export class AppModule {}
 ```
 
----
-
-## Optional & Peer Dependencies
+Your app's database (TypeORM/Prisma/Sequelize/etc.) stays completely separate — Telescope never touches it.
 
 All watchers are dynamically activated. If your application does not use certain modules, Telescope will safely boot without them. Simply install the peer dependencies for the watchers you want to enable:
 
@@ -147,35 +145,22 @@ You can pass configuration options into `TelescopeModule.forRoot(options)`:
 
 ```typescript
 import { Module } from '@nestjs/common';
-import { MongooseModule } from '@nestjs/mongoose';
+import { TypeOrmModule } from '@nestjs/typeorm';
 import { TelescopeModule, EntryType } from '@ngn-net/nestjs-telescope';
 
 @Module({
   imports: [
-    MongooseModule.forRoot(process.env.MONGO_URI || 'mongodb://localhost:27017/myapp'),
+    // Your project database — completely separate from Telescope
+    TypeOrmModule.forRoot({
+      type: 'postgres',
+      database: 'myapp_db',
+    }),
     TelescopeModule.forRoot({
       path: 'telescope',
       password: 'my-secure-password',
       jwtSecret: 'my-jwt-secret',
       maxEntries: 500,
-      ignorePaths: ['/health-check'],
-      enabledEntryTypes: [
-        EntryType.REQUEST,
-        EntryType.HTTP_CLIENT,
-        EntryType.QUERY,
-        EntryType.CACHE,
-        EntryType.JOB,
-        EntryType.EVENT,
-        EntryType.LOG,
-        EntryType.EXCEPTION,
-        EntryType.SCHEDULED_TASK,
-        EntryType.REDIS,
-        EntryType.MAIL,
-        EntryType.GATE,
-        EntryType.COMMAND,
-        EntryType.MODEL,
-        EntryType.NOTIFICATION,
-      ],
+      // Telescope uses its own MongoDB: mongodb://localhost:27017/telescope
     }),
   ],
 })
@@ -277,14 +262,14 @@ npm run test
 
 If upgrading from v0.2.x (which used TypeORM/SQL):
 
-1. Install the new dependencies:
+1. Update the package:
    ```bash
-   npm install @ngn-net/nestjs-telescope @nestjs/mongoose mongoose
+   npm install @ngn-net/nestjs-telescope@latest
    ```
 
-2. Add `MongooseModule.forRoot()` to your root module (if not already present).
+2. Ensure MongoDB is available at `mongodb://localhost:27017/telescope` (or configure `mongoUri`).
 
-3. Remove the old TypeORM-based telescope entity — Telescope now manages its own MongoDB collection automatically.
+3. Remove the old `TypeOrmModule` import if it was only added for Telescope.
 
 4. The old `telescope_entries` SQL table can be dropped after migration.
 

package/dist/constants.d.ts

@@ -1,5 +1,7 @@
 /** Injection token for telescope configuration options */
 export declare const TELESCOPE_OPTIONS = "TELESCOPE_OPTIONS";
+/** Injection token for Telescope's dedicated Mongoose connection name */
+export declare const TELESCOPE_MONGO_CONNECTION = "TELESCOPE_MONGO";
 /** Default base path for the Telescope UI & API */
 export declare const DEFAULT_TELESCOPE_PATH = "telescope";
 /** Default JWT secret (should always be overridden in production) */
@@ -8,5 +10,7 @@ export declare const DEFAULT_JWT_SECRET = "telescope-change-me";
 export declare const DEFAULT_MAX_ENTRIES = 1000;
 /** Default password for UI authentication */
 export declare const DEFAULT_PASSWORD = "password";
+/** Default MongoDB URI for Telescope's dedicated connection */
+export declare const DEFAULT_MONGO_URI = "mongodb://localhost:27017/telescope";
 /** Minimum interval (ms) between prune operations */
 export declare const PRUNE_THROTTLE_MS = 60000;

package/dist/constants.js

@@ -1,9 +1,11 @@
 "use strict";
 // src/constants.ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PRUNE_THROTTLE_MS = exports.DEFAULT_PASSWORD = exports.DEFAULT_MAX_ENTRIES = exports.DEFAULT_JWT_SECRET = exports.DEFAULT_TELESCOPE_PATH = exports.TELESCOPE_OPTIONS = void 0;
+exports.PRUNE_THROTTLE_MS = exports.DEFAULT_MONGO_URI = exports.DEFAULT_PASSWORD = exports.DEFAULT_MAX_ENTRIES = exports.DEFAULT_JWT_SECRET = exports.DEFAULT_TELESCOPE_PATH = exports.TELESCOPE_MONGO_CONNECTION = exports.TELESCOPE_OPTIONS = void 0;
 /** Injection token for telescope configuration options */
 exports.TELESCOPE_OPTIONS = 'TELESCOPE_OPTIONS';
+/** Injection token for Telescope's dedicated Mongoose connection name */
+exports.TELESCOPE_MONGO_CONNECTION = 'TELESCOPE_MONGO';
 /** Default base path for the Telescope UI & API */
 exports.DEFAULT_TELESCOPE_PATH = 'telescope';
 /** Default JWT secret (should always be overridden in production) */
@@ -12,5 +14,7 @@ exports.DEFAULT_JWT_SECRET = 'telescope-change-me';
 exports.DEFAULT_MAX_ENTRIES = 1000;
 /** Default password for UI authentication */
 exports.DEFAULT_PASSWORD = 'password';
+/** Default MongoDB URI for Telescope's dedicated connection */
+exports.DEFAULT_MONGO_URI = 'mongodb://localhost:27017/telescope';
 /** Minimum interval (ms) between prune operations */
 exports.PRUNE_THROTTLE_MS = 60_000;

package/dist/interfaces/telescope-options.interface.d.ts

@@ -18,6 +18,8 @@ export interface TelescopeOptions {
     ignoreCommands?: string[];
     /** Additional middleware to apply to UI routes */
     uiMiddleware?: any[];
+    /** MongoDB URI for Telescope's dedicated connection (default: 'mongodb://localhost:27017/telescope') */
+    mongoUri?: string;
 }
 export interface TelescopeOptionsFactory {
     createTelescopeOptions(): Promise<TelescopeOptions> | TelescopeOptions;

package/dist/storage/telescope-repository.service.js

@@ -17,6 +17,7 @@ const common_1 = require("@nestjs/common");
 const mongoose_1 = require("@nestjs/mongoose");
 const mongoose_2 = require("mongoose");
 const telescope_entry_entity_1 = require("./entities/telescope-entry.entity");
+const constants_1 = require("../constants");
 let TelescopeRepository = class TelescopeRepository {
     entryModel;
     constructor(entryModel) {
@@ -96,6 +97,6 @@ let TelescopeRepository = class TelescopeRepository {
 exports.TelescopeRepository = TelescopeRepository;
 exports.TelescopeRepository = TelescopeRepository = __decorate([
     (0, common_1.Injectable)(),
-    __param(0, (0, mongoose_1.InjectModel)(telescope_entry_entity_1.TelescopeEntry.name)),
+    __param(0, (0, mongoose_1.InjectModel)(telescope_entry_entity_1.TelescopeEntry.name, constants_1.TELESCOPE_MONGO_CONNECTION)),
     __metadata("design:paramtypes", [mongoose_2.Model])
 ], TelescopeRepository);

package/dist/telescope.module.js

@@ -100,10 +100,10 @@ let TelescopeModule = TelescopeModule_1 = class TelescopeModule {
         catch (e) { }
     }
     static forRoot(options = {}) {
+        const mongoUri = options.mongoUri || process.env.TELESCOPE_MONGO_URI || constants_1.DEFAULT_MONGO_URI;
         const imports = [
-            mongoose_1.MongooseModule.forFeature([
-                { name: telescope_entry_entity_1.TelescopeEntry.name, schema: telescope_entry_entity_1.TelescopeEntrySchema },
-            ]),
+            mongoose_1.MongooseModule.forRoot(mongoUri, { connectionName: constants_1.TELESCOPE_MONGO_CONNECTION }),
+            mongoose_1.MongooseModule.forFeature([{ name: telescope_entry_entity_1.TelescopeEntry.name, schema: telescope_entry_entity_1.TelescopeEntrySchema }], constants_1.TELESCOPE_MONGO_CONNECTION),
             jwt_1.JwtModule.register({
                 secret: options.jwtSecret || process.env.TELESCOPE_JWT_SECRET || constants_1.DEFAULT_JWT_SECRET,
                 signOptions: { expiresIn: '1d' },
@@ -143,9 +143,15 @@ let TelescopeModule = TelescopeModule_1 = class TelescopeModule {
             telescope_jwt_guard_1.JwtAuthGuard,
         ];
         const imports = [
-            mongoose_1.MongooseModule.forFeature([
-                { name: telescope_entry_entity_1.TelescopeEntry.name, schema: telescope_entry_entity_1.TelescopeEntrySchema },
-            ]),
+            mongoose_1.MongooseModule.forRootAsync({
+                connectionName: constants_1.TELESCOPE_MONGO_CONNECTION,
+                imports: options.imports || [],
+                inject: [constants_1.TELESCOPE_OPTIONS],
+                useFactory: async (telescopeOpts) => ({
+                    uri: telescopeOpts.mongoUri || process.env.TELESCOPE_MONGO_URI || constants_1.DEFAULT_MONGO_URI,
+                }),
+            }),
+            mongoose_1.MongooseModule.forFeature([{ name: telescope_entry_entity_1.TelescopeEntry.name, schema: telescope_entry_entity_1.TelescopeEntrySchema }], constants_1.TELESCOPE_MONGO_CONNECTION),
             jwt_1.JwtModule.registerAsync({
                 imports: options.imports || [],
                 inject: [constants_1.TELESCOPE_OPTIONS],

package/dist/ui/manifest.json

@@ -1,5 +1,5 @@
 {
   "name": "@ngn-net/nestjs-telescope",
-  "version": "0.3.0",
-  "builtAt": "2026-06-13T09:00:02.618Z"
+  "version": "0.3.2",
+  "builtAt": "2026-06-13T10:27:41.954Z"
 }

package/dist/watchers/exception.watcher.js

@@ -10,7 +10,6 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ExceptionWatcher = void 0;
-// src/watchers/exception.watcher.ts
 const common_1 = require("@nestjs/common");
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
@@ -22,11 +21,14 @@ let ExceptionWatcher = class ExceptionWatcher {
         this.telescope = telescope;
     }
     intercept(context, next) {
-        // Skip non-HTTP execution contexts (e.g. RPC/RabbitMQ or WebSockets)
         if (context.getType() !== 'http') {
             return next.handle();
         }
         const request = context.switchToHttp().getRequest();
+        const url = request.originalUrl || request.url || '';
+        if (this.telescope.shouldIgnorePath(url)) {
+            return next.handle();
+        }
         return next.handle().pipe((0, operators_1.catchError)((err) => {
             this.telescope.record({
                 type: entry_type_enum_1.EntryType.EXCEPTION,
@@ -35,10 +37,9 @@ let ExceptionWatcher = class ExceptionWatcher {
                     message: err.message || String(err),
                     stack: err.stack || null,
                     status: err.status || err.statusCode || 500,
-                    // Include request context for easier debugging
                     request: {
                         method: request?.method,
-                        url: request?.originalUrl || request?.url,
+                        url,
                         ip: request?.ip,
                     },
                 },

package/dist/watchers/gate.watcher.js

@@ -24,6 +24,10 @@ let GateWatcher = class GateWatcher {
             return next.handle();
         }
         const request = context.switchToHttp().getRequest();
+        const url = request.originalUrl || request.url || '';
+        if (this.telescope.shouldIgnorePath(url)) {
+            return next.handle();
+        }
         const user = request.user || request.auth || null;
         return next.handle().pipe((0, rxjs_1.tap)({
             next: () => {
@@ -34,7 +38,7 @@ let GateWatcher = class GateWatcher {
                         allowed: true,
                         user: user ? { id: user.sub || user.id || user.username } : null,
                         method: request.method,
-                        url: request.originalUrl || request.url,
+                        url,
                     },
                 }).catch(() => { });
             },
@@ -50,7 +54,7 @@ let GateWatcher = class GateWatcher {
                             reason: err.message || err.constructor?.name || 'Access denied',
                             user: user ? { id: user.sub || user.id || user.username } : null,
                             method: request.method,
-                            url: request.originalUrl || request.url,
+                            url,
                         },
                     }).catch(() => { });
                 }

package/dist/watchers/log.watcher.js

@@ -41,7 +41,7 @@ let LogWatcher = class LogWatcher {
                 rawMessage = chunk.toString(encoding || 'utf8');
             }
             // Skip telescope internal queries or module logs
-            if (rawMessage.includes('telescope_entries') || rawMessage.includes('TelescopeModule')) {
+            if (rawMessage.includes('telescope_entries') || rawMessage.includes('TelescopeModule') || rawMessage.includes('Telescope')) {
                 return;
             }
             // Parse the log message

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ngn-net/nestjs-telescope",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "publishConfig": {
     "access": "public"
   },