@rudderjs/telescope 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Suleiman Shahbari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+# @rudderjs/telescope
+
+Debug assistant for RudderJS — records requests, queries, jobs, exceptions, logs, mail, notifications, events, cache operations, scheduled tasks, and model changes.
+
+## Installation
+
+```bash
+pnpm add @rudderjs/telescope
+```
+
+## Setup
+
+```ts
+// bootstrap/providers.ts
+import { telescope } from '@rudderjs/telescope'
+import configs from '../config/index.js'
+export default [..., telescope(configs.telescope), ...]
+```
+
+## Telescope Facade
+
+```ts
+import { Telescope } from '@rudderjs/telescope'
+
+// List entries by type
+const requests   = await Telescope.list({ type: 'request', perPage: 25 })
+const exceptions = await Telescope.list({ type: 'exception' })
+const queries    = await Telescope.list({ type: 'query', search: 'SELECT' })
+
+// Find a single entry
+const entry = await Telescope.find('entry-id')
+
+// Count entries
+const total       = await Telescope.count()
+const jobCount    = await Telescope.count('job')
+
+// Prune entries
+await Telescope.prune('log')   // prune by type
+await Telescope.prune()        // prune all
+```
+
+## `Telescope` Methods
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `list(options?)` | `TelescopeEntry[]` | List entries with type/tag/search/pagination filters |
+| `find(id)` | `TelescopeEntry \| null` | Find a single entry by ID |
+| `count(type?)` | `number` | Count entries, optionally filtered by type |
+| `prune(type?)` | `void` | Delete entries, optionally by type |
+| `record(entry)` | `void` | Manually record an entry |
+
+## Entry Types
+
+Telescope records 11 entry types:
+
+| Type | Collector | Description |
+|------|-----------|-------------|
+| `request` | RequestCollector | HTTP requests and responses |
+| `query` | QueryCollector | Database queries (flags slow queries) |
+| `job` | JobCollector | Queue job dispatch and execution |
+| `exception` | ExceptionCollector | Unhandled exceptions |
+| `log` | LogCollector | Log messages |
+| `mail` | MailCollector | Sent emails |
+| `notification` | NotificationCollector | Dispatched notifications |
+| `event` | EventCollector | Dispatched events |
+| `cache` | CacheCollector | Cache hits, misses, writes |
+| `schedule` | ScheduleCollector | Scheduled task execution |
+| `model` | ModelCollector | Model create/update/delete |
+
+## Storage Drivers
+
+- **`memory`** (default) — In-process, bounded by `maxEntries`. Good for development.
+- **`sqlite`** — Persistent storage via `better-sqlite3`. Run `pnpm add better-sqlite3` to enable.
+
+## Configuration
+
+```ts
+// config/telescope.ts
+export default {
+  enabled: true,
+  path: 'telescope',
+  storage: 'memory',
+  sqlitePath: '.telescope.db',
+  maxEntries: 1000,
+  pruneAfterHours: 24,
+  recordRequests: true,
+  recordQueries: true,
+  recordJobs: true,
+  recordExceptions: true,
+  recordLogs: true,
+  recordMail: true,
+  recordNotifications: true,
+  recordEvents: true,
+  recordCache: true,
+  recordSchedule: true,
+  recordModels: true,
+  ignoreRequests: ['/telescope*', '/health'],
+  slowQueryThreshold: 100,
+  auth: null,
+} satisfies TelescopeConfig
+```
+
+## Dashboard
+
+Telescope serves a built-in UI at `/{path}` with dedicated pages for each entry type, detail views, and a search interface.
+
+## Notes
+
+- Auto-prune runs on a background interval.
+- Optional peers: `@rudderjs/log`, `@rudderjs/orm`, `@rudderjs/cache`, `@rudderjs/queue`, `@rudderjs/mail`, `@rudderjs/notification`, `@rudderjs/schedule`.
+- `createEntry()` helper is exported for manually constructing entries.

package/boost/guidelines.md

@@ -0,0 +1,38 @@
+# @rudderjs/telescope — AI Coding Guidelines
+
+## What This Package Does
+
+Telescope is a development inspector for RudderJS applications. It records requests, queries, jobs, exceptions, logs, mail, notifications, events, cache operations, scheduled tasks, and model changes — providing a JSON API and (future) UI for introspection.
+
+## Architecture
+
+Three layers:
+1. **Collectors** — Middleware, event listeners, and hooks that passively record app activity
+2. **Storage** — In-memory (default) or SQLite backend for entry persistence
+3. **API** — RESTful JSON endpoints at `/{path}/api/*`
+
+## Key Patterns
+
+- Each collector implements the `Collector` interface with `register()` method
+- Collectors hook into framework subsystems via dynamic imports (graceful skip if not installed)
+- All entries share the `TelescopeEntry` shape with `type`, `content` (JSON), and `tags`
+- Related entries within a request share a `batchId` for correlation
+- Storage is accessed via `TelescopeRegistry.get()` or the `Telescope` facade
+
+## Common Tasks
+
+### Adding a new collector
+1. Create `src/collectors/my-collector.ts` implementing `Collector`
+2. Use dynamic `import()` to hook into the relevant package
+3. Store entries via `storage.store(createEntry(type, content, options))`
+4. Register in `src/index.ts` provider boot
+
+### Extending the API
+1. Add route in `src/api/routes.ts` using `router.get/post/delete()`
+2. Follow existing pattern: parse query params, call storage, return JSON
+
+## Do NOT
+
+- Import peer dependencies statically — always use dynamic `import()` with try/catch
+- Record Telescope's own API requests (the request collector ignores `/telescope*`)
+- Block the request pipeline — storage writes are fire-and-forget

package/dist/api/routes.d.ts

@@ -0,0 +1,7 @@
+import type { TelescopeStorage, TelescopeConfig } from '../types.js';
+/**
+ * Register all Telescope API routes on the router.
+ * Called during the service provider's boot phase.
+ */
+export declare function registerRoutes(storage: TelescopeStorage, config: TelescopeConfig): Promise<void>;
+//# sourceMappingURL=routes.d.ts.map

package/dist/api/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/api/routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAa,MAAM,aAAa,CAAA;AAW/E;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAG,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CA0Df"}

package/dist/api/routes.js

@@ -0,0 +1,99 @@
+import { dashboardPage, requestsPage, queriesPage, jobsPage, exceptionsPage, logsPage, mailPage, notificationsPage, eventsPage, cachePage, schedulePage, modelsPage, } from '../ui/pages.js';
+const ENTRY_TYPES = [
+    'request', 'query', 'job', 'exception', 'log',
+    'mail', 'notification', 'event', 'cache', 'schedule', 'model',
+];
+/**
+ * Register all Telescope API routes on the router.
+ * Called during the service provider's boot phase.
+ */
+export async function registerRoutes(storage, config) {
+    const { router } = await import('@rudderjs/router');
+    const basePath = `/${config.path ?? 'telescope'}`;
+    const prefix = `${basePath}/api`;
+    const middleware = config.auth ? [authMiddleware(config)] : [];
+    // ── UI Pages ─────────────────────────────────────────────
+    const html = (_req, res, content) => res.header('Content-Type', 'text/html').send(content);
+    router.get(basePath, (r, s) => html(r, s, dashboardPage(basePath, prefix)), middleware);
+    router.get(`${basePath}/requests`, (r, s) => html(r, s, requestsPage(basePath, prefix)), middleware);
+    router.get(`${basePath}/queries`, (r, s) => html(r, s, queriesPage(basePath, prefix)), middleware);
+    router.get(`${basePath}/jobs`, (r, s) => html(r, s, jobsPage(basePath, prefix)), middleware);
+    router.get(`${basePath}/exceptions`, (r, s) => html(r, s, exceptionsPage(basePath, prefix)), middleware);
+    router.get(`${basePath}/logs`, (r, s) => html(r, s, logsPage(basePath, prefix)), middleware);
+    router.get(`${basePath}/mail`, (r, s) => html(r, s, mailPage(basePath, prefix)), middleware);
+    router.get(`${basePath}/notifications`, (r, s) => html(r, s, notificationsPage(basePath, prefix)), middleware);
+    router.get(`${basePath}/events`, (r, s) => html(r, s, eventsPage(basePath, prefix)), middleware);
+    router.get(`${basePath}/cache`, (r, s) => html(r, s, cachePage(basePath, prefix)), middleware);
+    router.get(`${basePath}/schedule`, (r, s) => html(r, s, schedulePage(basePath, prefix)), middleware);
+    router.get(`${basePath}/models`, (r, s) => html(r, s, modelsPage(basePath, prefix)), middleware);
+    // ── List routes for each entry type ──────────────────────
+    for (const type of ENTRY_TYPES) {
+        router.get(`${prefix}/${type === 'query' ? 'queries' : `${type}s`}`, (req, res) => listEntries(storage, type, req, res), middleware);
+        router.get(`${prefix}/${type === 'query' ? 'queries' : `${type}s`}/:id`, (req, res) => showEntry(storage, req, res), middleware);
+    }
+    // ── Overview ─────────────────────────────────────────────
+    router.get(`${prefix}/overview`, async (_req, res) => {
+        const counts = {};
+        for (const type of ENTRY_TYPES) {
+            counts[type] = await storage.count(type);
+        }
+        res.json({ counts, total: await storage.count() });
+    }, middleware);
+    // ── Prune ────────────────────────────────────────────────
+    router.delete(`${prefix}/entries`, async (req, res) => {
+        const type = req.query['type'];
+        if (type && ENTRY_TYPES.includes(type)) {
+            await storage.prune(type);
+        }
+        else {
+            await storage.prune();
+        }
+        res.json({ message: 'Entries pruned.' });
+    }, middleware);
+}
+// ─── Handlers ──────────────────────────────────────────────
+async function listEntries(storage, type, req, res) {
+    const page = parseInt(req.query['page'] ?? '1', 10);
+    const perPage = parseInt(req.query['per_page'] ?? '50', 10);
+    const tag = req.query['tag'];
+    const search = req.query['search'];
+    const batchId = req.query['batch_id'];
+    const entries = await storage.list({ type, page, perPage, tag, search, batchId });
+    const total = await storage.count(type);
+    res.json({
+        data: entries,
+        meta: {
+            total,
+            page,
+            per_page: perPage,
+            last_page: Math.ceil(total / perPage),
+        },
+    });
+}
+async function showEntry(storage, req, res) {
+    const entry = await storage.find(req.params['id'] ?? '');
+    if (!entry) {
+        res.status(404).json({ message: 'Entry not found.' });
+        return;
+    }
+    // If this entry has a batchId, include related entries
+    let related = [];
+    if (entry.batchId) {
+        related = await storage.list({ batchId: entry.batchId, perPage: 100 });
+    }
+    res.json({ data: entry, related });
+}
+// ─── Auth Middleware ────────────────────────────────────────
+function authMiddleware(config) {
+    return async (req, res, next) => {
+        if (config.auth) {
+            const allowed = await config.auth(req);
+            if (!allowed) {
+                res.status(403).json({ message: 'Unauthorized.' });
+                return;
+            }
+        }
+        return next();
+    };
+}
+//# sourceMappingURL=routes.js.map

package/dist/api/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/api/routes.ts"],"names":[],"mappings":"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"}

package/dist/collectors/cache.d.ts

@@ -0,0 +1,13 @@
+import type { Collector, TelescopeStorage } from '../types.js';
+/**
+ * Records cache operations by wrapping the CacheRegistry adapter methods.
+ * Intercepts get/set/forget/flush and records hit/miss/set/forget ops.
+ */
+export declare class CacheCollector implements Collector {
+    private readonly storage;
+    readonly name = "Cache Collector";
+    readonly type: "cache";
+    constructor(storage: TelescopeStorage);
+    register(): Promise<void>;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/collectors/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/collectors/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9D;;;GAGG;AACH,qBAAa,cAAe,YAAW,SAAS;IAIlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,qBAAoB;IACjC,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAS;gBAEH,OAAO,EAAE,gBAAgB;IAEhD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAsChC"}

package/dist/collectors/cache.js

@@ -0,0 +1,48 @@
+import { createEntry } from '../storage.js';
+/**
+ * Records cache operations by wrapping the CacheRegistry adapter methods.
+ * Intercepts get/set/forget/flush and records hit/miss/set/forget ops.
+ */
+export class CacheCollector {
+    storage;
+    name = 'Cache Collector';
+    type = 'cache';
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async register() {
+        try {
+            const { CacheRegistry } = await import('@rudderjs/cache');
+            const original = CacheRegistry.get();
+            if (!original)
+                return;
+            const storage = this.storage;
+            const origGet = original.get.bind(original);
+            const origSet = original.set.bind(original);
+            const origForget = original.forget.bind(original);
+            const origFlush = original.flush.bind(original);
+            original.get = async (key) => {
+                const value = await origGet(key);
+                const op = value !== null ? 'hit' : 'miss';
+                storage.store(createEntry('cache', { key, operation: op }, { tags: [`cache:${op}`] }));
+                return value;
+            };
+            original.set = async (key, value, ttl) => {
+                await origSet(key, value, ttl);
+                storage.store(createEntry('cache', { key, operation: 'set', ttl }, { tags: ['cache:set'] }));
+            };
+            original.forget = async (key) => {
+                await origForget(key);
+                storage.store(createEntry('cache', { key, operation: 'forget' }, { tags: ['cache:forget'] }));
+            };
+            original.flush = async () => {
+                await origFlush();
+                storage.store(createEntry('cache', { operation: 'flush' }, { tags: ['cache:flush'] }));
+            };
+        }
+        catch {
+            // @rudderjs/cache not installed — skip
+        }
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/collectors/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/collectors/cache.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C;;;GAGG;AACH,MAAM,OAAO,cAAc;IAII;IAHpB,IAAI,GAAG,iBAAiB,CAAA;IACxB,IAAI,GAAG,OAAgB,CAAA;IAEhC,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAE1D,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAA;YACzD,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,EAAE,CAAA;YACpC,IAAI,CAAC,QAAQ;gBAAE,OAAM;YAErB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;YAE5B,MAAM,OAAO,GAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC9C,MAAM,OAAO,GAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC9C,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YACjD,MAAM,SAAS,GAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAEhD,QAAQ,CAAC,GAAG,GAAG,KAAK,EAAe,GAAW,EAAqB,EAAE;gBACnE,MAAM,KAAK,GAAG,MAAO,OAA8C,CAAC,GAAG,CAAC,CAAA;gBACxE,MAAM,EAAE,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAA;gBAC1C,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;gBACtF,OAAO,KAAK,CAAA;YACd,CAAC,CAAA;YAED,QAAQ,CAAC,GAAG,GAAG,KAAK,EAAE,GAAW,EAAE,KAAc,EAAE,GAAY,EAAiB,EAAE;gBAChF,MAAO,OAAwE,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,CAAC,CAAA;gBAChG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAA;YAC9F,CAAC,CAAA;YAED,QAAQ,CAAC,MAAM,GAAG,KAAK,EAAE,GAAW,EAAiB,EAAE;gBACrD,MAAO,UAA6C,CAAC,GAAG,CAAC,CAAA;gBACzD,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAA;YAC/F,CAAC,CAAA;YAED,QAAQ,CAAC,KAAK,GAAG,KAAK,IAAmB,EAAE;gBACzC,MAAO,SAAiC,EAAE,CAAA;gBAC1C,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAA;YACxF,CAAC,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;CACF"}

package/dist/collectors/event.d.ts

@@ -0,0 +1,13 @@
+import type { Collector, TelescopeStorage } from '../types.js';
+/**
+ * Records dispatched events by registering a wildcard ('*') listener.
+ */
+export declare class EventCollector implements Collector {
+    private readonly storage;
+    readonly name = "Event Collector";
+    readonly type: "event";
+    constructor(storage: TelescopeStorage);
+    register(): Promise<void>;
+    private record;
+}
+//# sourceMappingURL=event.d.ts.map

package/dist/collectors/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/collectors/event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9D;;GAEG;AACH,qBAAa,cAAe,YAAW,SAAS;IAIlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,qBAAoB;IACjC,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAS;gBAEH,OAAO,EAAE,gBAAgB;IAEhD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB/B,OAAO,CAAC,MAAM;CAaf"}

package/dist/collectors/event.js

@@ -0,0 +1,36 @@
+import { createEntry } from '../storage.js';
+/**
+ * Records dispatched events by registering a wildcard ('*') listener.
+ */
+export class EventCollector {
+    storage;
+    name = 'Event Collector';
+    type = 'event';
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async register() {
+        try {
+            const { dispatcher } = await import('@rudderjs/core');
+            dispatcher.register('*', {
+                handle: (event) => this.record(event),
+            });
+        }
+        catch {
+            // @rudderjs/core events not available — skip
+        }
+    }
+    record(event) {
+        const name = event && typeof event === 'object' ? event.constructor.name : 'Unknown';
+        // Don't record Telescope's own internal events
+        if (name.startsWith('Telescope'))
+            return;
+        this.storage.store(createEntry('event', {
+            name,
+            payload: event && typeof event === 'object'
+                ? JSON.parse(JSON.stringify(event))
+                : { value: event },
+        }, { tags: [`event:${name}`] }));
+    }
+}
+//# sourceMappingURL=event.js.map

package/dist/collectors/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/collectors/event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C;;GAEG;AACH,MAAM,OAAO,cAAc;IAII;IAHpB,IAAI,GAAG,iBAAiB,CAAA;IACxB,IAAI,GAAG,OAAgB,CAAA;IAEhC,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAE1D,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAInD,CAAA;YAED,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE;gBACvB,MAAM,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;aAC/C,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,6CAA6C;QAC/C,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,KAAc;QAC3B,MAAM,IAAI,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;QAEpF,+CAA+C;QAC/C,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,OAAM;QAExC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE;YACtC,IAAI;YACJ,OAAO,EAAE,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBACzC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACnC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE;SACrB,EAAE,EAAE,IAAI,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAClC,CAAC;CACF"}

package/dist/collectors/exception.d.ts

@@ -0,0 +1,13 @@
+import type { Collector, TelescopeStorage } from '../types.js';
+/**
+ * Records exceptions by wrapping the global exception reporter.
+ */
+export declare class ExceptionCollector implements Collector {
+    private readonly storage;
+    readonly name = "Exception Collector";
+    readonly type: "exception";
+    constructor(storage: TelescopeStorage);
+    register(): Promise<void>;
+    private record;
+}
+//# sourceMappingURL=exception.d.ts.map

package/dist/collectors/exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception.d.ts","sourceRoot":"","sources":["../../src/collectors/exception.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9D;;GAEG;AACH,qBAAa,kBAAmB,YAAW,SAAS;IAItC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,yBAAwB;IACrC,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAS;gBAEP,OAAO,EAAE,gBAAgB;IAEhD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB/B,OAAO,CAAC,MAAM;CAWf"}

package/dist/collectors/exception.js

@@ -0,0 +1,38 @@
+import { createEntry } from '../storage.js';
+/**
+ * Records exceptions by wrapping the global exception reporter.
+ */
+export class ExceptionCollector {
+    storage;
+    name = 'Exception Collector';
+    type = 'exception';
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async register() {
+        try {
+            const { setExceptionReporter, report } = await import('@rudderjs/core');
+            // Chain: record the exception, then forward to the previous reporter
+            const previousReport = report;
+            setExceptionReporter((err) => {
+                this.record(err);
+                previousReport(err);
+            });
+        }
+        catch {
+            // Should never fail since @rudderjs/core is a direct dep
+        }
+    }
+    record(err) {
+        const isError = err instanceof Error;
+        const tags = ['error'];
+        if (isError)
+            tags.push(`class:${err.constructor.name}`);
+        this.storage.store(createEntry('exception', {
+            class: isError ? err.constructor.name : 'Unknown',
+            message: isError ? err.message : String(err),
+            stack: isError && err.stack ? err.stack.split('\n').map(l => l.trim()) : [],
+        }, { tags, ...(isError ? { familyHash: err.constructor.name } : {}) }));
+    }
+}
+//# sourceMappingURL=exception.js.map

package/dist/collectors/exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception.js","sourceRoot":"","sources":["../../src/collectors/exception.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAIA;IAHpB,IAAI,GAAG,qBAAqB,CAAA;IAC5B,IAAI,GAAG,WAAoB,CAAA;IAEpC,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAE1D,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAGrE,CAAA;YAED,qEAAqE;YACrE,MAAM,cAAc,GAAG,MAAM,CAAA;YAC7B,oBAAoB,CAAC,CAAC,GAAY,EAAE,EAAE;gBACpC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBAChB,cAAc,CAAC,GAAG,CAAC,CAAA;YACrB,CAAC,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;QAC3D,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,GAAY;QACzB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAA;QACpC,MAAM,IAAI,GAAa,CAAC,OAAO,CAAC,CAAA;QAChC,IAAI,OAAO;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAA;QAEvD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,EAAE;YAC1C,KAAK,EAAI,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YACnD,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YAC5C,KAAK,EAAI,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;SAC9E,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACzE,CAAC;CACF"}

package/dist/collectors/job.d.ts

@@ -0,0 +1,12 @@
+import type { Collector, TelescopeStorage } from '../types.js';
+/**
+ * Records queue job dispatches by wrapping the QueueRegistry adapter's dispatch method.
+ */
+export declare class JobCollector implements Collector {
+    private readonly storage;
+    readonly name = "Job Collector";
+    readonly type: "job";
+    constructor(storage: TelescopeStorage);
+    register(): Promise<void>;
+}
+//# sourceMappingURL=job.d.ts.map

package/dist/collectors/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../src/collectors/job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9D;;GAEG;AACH,qBAAa,YAAa,YAAW,SAAS;IAIhC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,mBAAkB;IAC/B,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAS;gBAED,OAAO,EAAE,gBAAgB;IAEhD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAuChC"}

package/dist/collectors/job.js

@@ -0,0 +1,53 @@
+import { createEntry } from '../storage.js';
+/**
+ * Records queue job dispatches by wrapping the QueueRegistry adapter's dispatch method.
+ */
+export class JobCollector {
+    storage;
+    name = 'Job Collector';
+    type = 'job';
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async register() {
+        try {
+            const { QueueRegistry } = await import('@rudderjs/queue');
+            const original = QueueRegistry.get();
+            if (!original)
+                return;
+            const storage = this.storage;
+            const originalDispatch = original.dispatch.bind(original);
+            original.dispatch = async (job, options) => {
+                const j = job;
+                const ctor = j.constructor;
+                const start = Date.now();
+                try {
+                    await originalDispatch(job, options);
+                    const duration = Date.now() - start;
+                    storage.store(createEntry('job', {
+                        class: j.constructor.name,
+                        queue: ctor['queue'] ?? 'default',
+                        status: 'dispatched',
+                        duration,
+                        payload: JSON.parse(JSON.stringify(job)),
+                    }, { tags: [`job:${j.constructor.name}`, 'status:dispatched'] }));
+                }
+                catch (err) {
+                    const duration = Date.now() - start;
+                    storage.store(createEntry('job', {
+                        class: j.constructor.name,
+                        queue: ctor['queue'] ?? 'default',
+                        status: 'failed',
+                        duration,
+                        exception: err instanceof Error ? err.message : String(err),
+                    }, { tags: [`job:${j.constructor.name}`, 'status:failed'] }));
+                    throw err;
+                }
+            };
+        }
+        catch {
+            // @rudderjs/queue not installed — skip
+        }
+    }
+}
+//# sourceMappingURL=job.js.map

package/dist/collectors/job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.js","sourceRoot":"","sources":["../../src/collectors/job.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C;;GAEG;AACH,MAAM,OAAO,YAAY;IAIM;IAHpB,IAAI,GAAG,eAAe,CAAA;IACtB,IAAI,GAAG,KAAc,CAAA;IAE9B,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAE1D,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAA;YACzD,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,EAAE,CAAA;YACpC,IAAI,CAAC,QAAQ;gBAAE,OAAM;YAErB,MAAM,OAAO,GAAY,IAAI,CAAC,OAAO,CAAA;YACrC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAEzD,QAAQ,CAAC,QAAQ,GAAG,KAAK,EAAE,GAAY,EAAE,OAAiB,EAAiB,EAAE;gBAC3E,MAAM,CAAC,GAAM,GAAkE,CAAA;gBAC/E,MAAM,IAAI,GAAG,CAAC,CAAC,WAAiD,CAAA;gBAChE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBACxB,IAAI,CAAC;oBACH,MAAO,gBAAuE,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;oBAC5F,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAA;oBACnC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE;wBAC/B,KAAK,EAAK,CAAC,CAAC,WAAW,CAAC,IAAI;wBAC5B,KAAK,EAAK,IAAI,CAAC,OAAO,CAAC,IAAI,SAAS;wBACpC,MAAM,EAAI,YAAY;wBACtB,QAAQ;wBACR,OAAO,EAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;qBAC1C,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,mBAAmB,CAAC,EAAE,CAAC,CAAC,CAAA;gBACnE,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAA;oBACnC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE;wBAC/B,KAAK,EAAM,CAAC,CAAC,WAAW,CAAC,IAAI;wBAC7B,KAAK,EAAM,IAAI,CAAC,OAAO,CAAC,IAAI,SAAS;wBACrC,MAAM,EAAK,QAAQ;wBACnB,QAAQ;wBACR,SAAS,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBAC5D,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC,CAAA;oBAC7D,MAAM,GAAG,CAAA;gBACX,CAAC;YACH,CAAC,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;CACF"}

package/dist/collectors/log.d.ts

@@ -0,0 +1,13 @@
+import type { Collector, TelescopeStorage } from '../types.js';
+/**
+ * Records log entries by hooking into @rudderjs/log's listener API.
+ */
+export declare class LogCollector implements Collector {
+    private readonly storage;
+    readonly name = "Log Collector";
+    readonly type: "log";
+    constructor(storage: TelescopeStorage);
+    register(): Promise<void>;
+    private record;
+}
+//# sourceMappingURL=log.d.ts.map

package/dist/collectors/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/collectors/log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9D;;GAEG;AACH,qBAAa,YAAa,YAAW,SAAS;IAIhC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,mBAAkB;IAC/B,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAS;gBAED,OAAO,EAAE,gBAAgB;IAEhD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B,OAAO,CAAC,MAAM;CAcf"}

package/dist/collectors/log.js

@@ -0,0 +1,35 @@
+import { createEntry } from '../storage.js';
+/**
+ * Records log entries by hooking into @rudderjs/log's listener API.
+ */
+export class LogCollector {
+    storage;
+    name = 'Log Collector';
+    type = 'log';
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async register() {
+        try {
+            const { Log } = await import('@rudderjs/log');
+            Log.listen((entry) => this.record(entry));
+        }
+        catch {
+            // @rudderjs/log not installed — skip
+        }
+    }
+    record(entry) {
+        const tags = [`level:${entry.level}`];
+        if (['error', 'critical', 'alert', 'emergency'].includes(entry.level)) {
+            tags.push('error');
+        }
+        this.storage.store(createEntry('log', {
+            level: entry.level,
+            message: entry.message,
+            context: entry.context,
+            channel: entry.channel,
+            timestamp: entry.timestamp.toISOString(),
+        }, { tags }));
+    }
+}
+//# sourceMappingURL=log.js.map

package/dist/collectors/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/collectors/log.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C;;GAEG;AACH,MAAM,OAAO,YAAY;IAIM;IAHpB,IAAI,GAAG,eAAe,CAAA;IACtB,IAAI,GAAG,KAAc,CAAA;IAE9B,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAE1D,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAE3C,CAAA;YACD,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,KAAe;QAC5B,MAAM,IAAI,GAAa,CAAC,SAAS,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;QAC/C,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACtE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACpB,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE;YACpC,KAAK,EAAM,KAAK,CAAC,KAAK;YACtB,OAAO,EAAI,KAAK,CAAC,OAAO;YACxB,OAAO,EAAI,KAAK,CAAC,OAAO;YACxB,OAAO,EAAI,KAAK,CAAC,OAAO;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE;SACzC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IACf,CAAC;CACF"}

package/dist/collectors/mail.d.ts

@@ -0,0 +1,12 @@
+import type { Collector, TelescopeStorage } from '../types.js';
+/**
+ * Records mail sends by wrapping the MailRegistry adapter's send method.
+ */
+export declare class MailCollector implements Collector {
+    private readonly storage;
+    readonly name = "Mail Collector";
+    readonly type: "mail";
+    constructor(storage: TelescopeStorage);
+    register(): Promise<void>;
+}
+//# sourceMappingURL=mail.d.ts.map