@ngn-net/nestjs-telescope 0.3.1 → 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/ui/manifest.json

@@ -1,5 +1,5 @@
 {
   "name": "@ngn-net/nestjs-telescope",
-  "version": "0.3.1",
-  "builtAt": "2026-06-13T09:06:28.974Z"
+  "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.1",
+  "version": "0.3.2",
   "publishConfig": {
     "access": "public"
   },