@rudderjs/telescope 0.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../src/collectors/mail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9D;;GAEG;AACH,qBAAa,aAAc,YAAW,SAAS;IAIjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,oBAAmB;IAChC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAS;gBAEF,OAAO,EAAE,gBAAgB;IAEhD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA8BhC"}

package/dist/collectors/mail.js

@@ -0,0 +1,38 @@
+import { createEntry } from '../storage.js';
+/**
+ * Records mail sends by wrapping the MailRegistry adapter's send method.
+ */
+export class MailCollector {
+    storage;
+    name = 'Mail Collector';
+    type = 'mail';
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async register() {
+        try {
+            const mod = await import('@rudderjs/mail');
+            const { MailRegistry } = mod;
+            const original = MailRegistry.get();
+            if (!original)
+                return;
+            const storage = this.storage;
+            const originalSend = original.send.bind(original);
+            original['send'] = async function (mailable, options) {
+                await originalSend(mailable, options);
+                const m = mailable;
+                const opt = options;
+                storage.store(createEntry('mail', {
+                    class: m.constructor.name,
+                    to: opt['to'] ?? [],
+                    subject: m['subject'] ?? '',
+                    queued: false,
+                }, { tags: [`mail:${m.constructor.name}`] }));
+            };
+        }
+        catch {
+            // @rudderjs/mail not installed — skip
+        }
+    }
+}
+//# sourceMappingURL=mail.js.map

package/dist/collectors/mail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.js","sourceRoot":"","sources":["../../src/collectors/mail.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C;;GAEG;AACH,MAAM,OAAO,aAAa;IAIK;IAHpB,IAAI,GAAG,gBAAgB,CAAA;IACvB,IAAI,GAAG,MAAe,CAAA;IAE/B,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAE1D,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAA;YAC1C,MAAM,EAAE,YAAY,EAAE,GAAG,GAAG,CAAA;YAE5B,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,EAAE,CAAA;YACnC,IAAI,CAAC,QAAQ;gBAAE,OAAM;YAErB,MAAM,OAAO,GAAO,IAAI,CAAC,OAAO,CAAA;YAChC,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAGhD;YAAC,QAA+C,CAAC,MAAM,CAAC,GAAG,KAAK,WAC/D,QAAiB,EACjB,OAAgB;gBAEhB,MAAO,YAAsD,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;gBAChF,MAAM,CAAC,GAAK,QAAuE,CAAA;gBACnF,MAAM,GAAG,GAAG,OAAkC,CAAA;gBAC9C,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE;oBAChC,KAAK,EAAI,CAAC,CAAC,WAAW,CAAC,IAAI;oBAC3B,EAAE,EAAO,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE;oBACxB,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE;oBAC3B,MAAM,EAAG,KAAK;iBACf,EAAE,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YAC/C,CAAC,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sCAAsC;QACxC,CAAC;IACH,CAAC;CACF"}

package/dist/collectors/model.d.ts

@@ -0,0 +1,15 @@
+import type { Collector, TelescopeStorage } from '../types.js';
+/**
+ * Records model lifecycle events (created, updated, deleted) via Model.on().
+ *
+ * Registers on all models discovered through the ModelRegistry.
+ */
+export declare class ModelCollector implements Collector {
+    private readonly storage;
+    readonly name = "Model Collector";
+    readonly type: "model";
+    constructor(storage: TelescopeStorage);
+    register(): Promise<void>;
+    private observeModel;
+}
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/collectors/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9D;;;;GAIG;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,YAAY;CAyBrB"}

package/dist/collectors/model.js

@@ -0,0 +1,49 @@
+import { createEntry } from '../storage.js';
+/**
+ * Records model lifecycle events (created, updated, deleted) via Model.on().
+ *
+ * Registers on all models discovered through the ModelRegistry.
+ */
+export class ModelCollector {
+    storage;
+    name = 'Model Collector';
+    type = 'model';
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async register() {
+        try {
+            const orm = await import('@rudderjs/orm');
+            const registry = orm.ModelRegistry;
+            if (!registry.all)
+                return;
+            for (const [name, ModelClass] of registry.all()) {
+                this.observeModel(name, ModelClass);
+            }
+        }
+        catch {
+            // @rudderjs/orm not installed — skip
+        }
+    }
+    observeModel(modelName, ModelClass) {
+        const storage = this.storage;
+        for (const event of ['created', 'updated', 'deleted']) {
+            ModelClass.on(event, (...args) => {
+                const content = {
+                    model: modelName,
+                    action: event,
+                };
+                if (event === 'created' || event === 'updated') {
+                    content['attributes'] = args[0];
+                }
+                else if (event === 'deleted') {
+                    content['id'] = args[0];
+                }
+                storage.store(createEntry('model', content, {
+                    tags: [`model:${modelName}`, `action:${event}`],
+                }));
+            });
+        }
+    }
+}
+//# sourceMappingURL=model.js.map

package/dist/collectors/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/collectors/model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C;;;;GAIG;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,GAAG,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAA;YACzC,MAAM,QAAQ,GAAG,GAAG,CAAC,aAEpB,CAAA;YACD,IAAI,CAAC,QAAQ,CAAC,GAAG;gBAAE,OAAM;YAEzB,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC;gBAChD,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;YACrC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;IACH,CAAC;IAEO,YAAY,CAClB,SAAiB,EACjB,UAA8E;QAE9E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAE5B,KAAK,MAAM,KAAK,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAU,EAAE,CAAC;YAC/D,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,IAAe,EAAE,EAAE;gBAC1C,MAAM,OAAO,GAA4B;oBACvC,KAAK,EAAG,SAAS;oBACjB,MAAM,EAAE,KAAK;iBACd,CAAA;gBAED,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBAC/C,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;gBACjC,CAAC;qBAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBAC/B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;gBACzB,CAAC;gBAED,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE;oBAC1C,IAAI,EAAE,CAAC,SAAS,SAAS,EAAE,EAAE,UAAU,KAAK,EAAE,CAAC;iBAChD,CAAC,CAAC,CAAA;YACL,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/collectors/notification.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../src/collectors/notification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9D;;GAEG;AACH,qBAAa,qBAAsB,YAAW,SAAS;IAIzC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,4BAA2B;IACxC,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAS;gBAEV,OAAO,EAAE,gBAAgB;IAEhD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA+BhC"}

package/dist/collectors/notification.js

@@ -0,0 +1,41 @@
+import { createEntry } from '../storage.js';
+/**
+ * Records notification dispatches by wrapping the ChannelRegistry's get method.
+ */
+export class NotificationCollector {
+    storage;
+    name = 'Notification Collector';
+    type = 'notification';
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async register() {
+        try {
+            const mod = await import('@rudderjs/notification');
+            const registry = mod.ChannelRegistry;
+            const storage = this.storage;
+            const originalGet = registry.get.bind(registry);
+            registry.get = (name) => {
+                const original = originalGet(name);
+                if (!original)
+                    return original;
+                return {
+                    async send(notifiable, notification) {
+                        await original.send(notifiable, notification);
+                        const notif = notification;
+                        const n = notifiable;
+                        storage.store(createEntry('notification', {
+                            class: notif.constructor.name,
+                            channel: name,
+                            notifiable: n['id'] ?? notifiable.constructor.name,
+                        }, { tags: [`notification:${notif.constructor.name}`, `channel:${name}`] }));
+                    },
+                };
+            };
+        }
+        catch {
+            // @rudderjs/notification not installed — skip
+        }
+    }
+}
+//# sourceMappingURL=notification.js.map

package/dist/collectors/notification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.js","sourceRoot":"","sources":["../../src/collectors/notification.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C;;GAEG;AACH,MAAM,OAAO,qBAAqB;IAIH;IAHpB,IAAI,GAAG,wBAAwB,CAAA;IAC/B,IAAI,GAAG,cAAuB,CAAA;IAEvC,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAE1D,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAA;YAClD,MAAM,QAAQ,GAAG,GAAG,CAAC,eAEpB,CAAA;YAED,MAAM,OAAO,GAAO,IAAI,CAAC,OAAO,CAAA;YAChC,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAE/C,QAAQ,CAAC,GAAG,GAAG,CAAC,IAAY,EAAmC,EAAE;gBAC/D,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;gBAClC,IAAI,CAAC,QAAQ;oBAAE,OAAO,QAAQ,CAAA;gBAE9B,OAAO;oBACL,KAAK,CAAC,IAAI,CAAC,UAAmB,EAAE,YAAqB;wBACnD,MAAO,QAAQ,CAAC,IAAsD,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;wBAChG,MAAM,KAAK,GAAG,YAA2E,CAAA;wBACzF,MAAM,CAAC,GAAO,UAAqC,CAAA;wBACnD,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,cAAc,EAAE;4BACxC,KAAK,EAAO,KAAK,CAAC,WAAW,CAAC,IAAI;4BAClC,OAAO,EAAK,IAAI;4BAChB,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,IAAK,UAAgD,CAAC,WAAW,CAAC,IAAI;yBAC1F,EAAE,EAAE,IAAI,EAAE,CAAC,gBAAgB,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,WAAW,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;oBAC9E,CAAC;iBACqB,CAAA;YAC1B,CAAC,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8CAA8C;QAChD,CAAC;IACH,CAAC;CACF"}

package/dist/collectors/query.d.ts

@@ -0,0 +1,13 @@
+import type { Collector, TelescopeStorage, TelescopeConfig } from '../types.js';
+/**
+ * Records database queries by hooking into the ORM's query logging.
+ */
+export declare class QueryCollector implements Collector {
+    private readonly storage;
+    private readonly config;
+    readonly name = "Query Collector";
+    readonly type: "query";
+    constructor(storage: TelescopeStorage, config: TelescopeConfig);
+    register(): Promise<void>;
+}
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/collectors/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAG/E;;GAEG;AACH,qBAAa,cAAe,YAAW,SAAS;IAK5C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,QAAQ,CAAC,IAAI,qBAAoB;IACjC,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAS;gBAGb,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAG,eAAe;IAGrC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA+BhC"}

package/dist/collectors/query.js

@@ -0,0 +1,45 @@
+import { createEntry } from '../storage.js';
+/**
+ * Records database queries by hooking into the ORM's query logging.
+ */
+export class QueryCollector {
+    storage;
+    config;
+    name = 'Query Collector';
+    type = 'query';
+    constructor(storage, config) {
+        this.storage = storage;
+        this.config = config;
+    }
+    async register() {
+        try {
+            const orm = await import('@rudderjs/orm');
+            const registry = orm.ModelRegistry;
+            if (!registry.getAdapter)
+                return;
+            const adapter = registry.getAdapter();
+            if (!adapter?.onQuery)
+                return;
+            const storage = this.storage;
+            const threshold = this.config.slowQueryThreshold ?? 100;
+            adapter.onQuery((info) => {
+                const tags = [];
+                if (info.duration > threshold)
+                    tags.push('slow');
+                if (info.model)
+                    tags.push(`model:${info.model}`);
+                storage.store(createEntry('query', {
+                    sql: info.sql,
+                    bindings: info.bindings,
+                    duration: info.duration,
+                    connection: info.connection,
+                    model: info.model,
+                }, { tags }));
+            });
+        }
+        catch {
+            // @rudderjs/orm not installed or adapter doesn't support onQuery — skip
+        }
+    }
+}
+//# sourceMappingURL=query.js.map

package/dist/collectors/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/collectors/query.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C;;GAEG;AACH,MAAM,OAAO,cAAc;IAKN;IACA;IALV,IAAI,GAAG,iBAAiB,CAAA;IACxB,IAAI,GAAG,OAAgB,CAAA;IAEhC,YACmB,OAAyB,EACzB,MAAwB;QADxB,YAAO,GAAP,OAAO,CAAkB;QACzB,WAAM,GAAN,MAAM,CAAkB;IACxC,CAAC;IAEJ,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAA;YACzC,MAAM,QAAQ,GAAG,GAAG,CAAC,aAEpB,CAAA;YACD,IAAI,CAAC,QAAQ,CAAC,UAAU;gBAAE,OAAM;YAEhC,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAA;YACrC,IAAI,CAAC,OAAO,EAAE,OAAO;gBAAE,OAAM;YAE7B,MAAM,OAAO,GAAK,IAAI,CAAC,OAAO,CAAA;YAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,IAAI,GAAG,CAAA;YAEvD,OAAO,CAAC,OAAO,CAAC,CAAC,IAAe,EAAE,EAAE;gBAClC,MAAM,IAAI,GAAa,EAAE,CAAA;gBACzB,IAAI,IAAI,CAAC,QAAQ,GAAG,SAAS;oBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBAChD,IAAI,IAAI,CAAC,KAAK;oBAAE,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;gBAEhD,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE;oBACjC,GAAG,EAAS,IAAI,CAAC,GAAG;oBACpB,QAAQ,EAAI,IAAI,CAAC,QAAQ;oBACzB,QAAQ,EAAI,IAAI,CAAC,QAAQ;oBACzB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,KAAK,EAAO,IAAI,CAAC,KAAK;iBACvB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;YACf,CAAC,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,wEAAwE;QAC1E,CAAC;IACH,CAAC;CACF"}

package/dist/collectors/request.d.ts

@@ -0,0 +1,20 @@
+import type { AppRequest, AppResponse } from '@rudderjs/contracts';
+import type { Collector, TelescopeStorage, TelescopeConfig } from '../types.js';
+/**
+ * Records HTTP requests — method, URL, status, duration, headers, payload.
+ * Installs as global middleware via the router.
+ */
+export declare class RequestCollector implements Collector {
+    private readonly storage;
+    private readonly config;
+    readonly name = "Request Collector";
+    readonly type: "request";
+    constructor(storage: TelescopeStorage, config: TelescopeConfig);
+    register(): void;
+    /** Returns a middleware handler that records requests */
+    middleware(): (req: AppRequest, res: AppResponse, next: () => Promise<void>) => Promise<void>;
+    private shouldIgnore;
+    /** True for Vite internals, source files, and static assets */
+    private isAsset;
+}
+//# sourceMappingURL=request.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/collectors/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAG/E;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IAK9C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IALzB,QAAQ,CAAC,IAAI,uBAAsB;IACnC,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAS;gBAGf,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAG,eAAe;IAG3C,QAAQ,IAAI,IAAI;IAIhB,yDAAyD;IACzD,UAAU,KAIM,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,MAAM,OAAO,CAAC,IAAI,CAAC;IAkC5E,OAAO,CAAC,YAAY;IAOpB,+DAA+D;IAC/D,OAAO,CAAC,OAAO;CAShB"}

package/dist/collectors/request.js

@@ -0,0 +1,73 @@
+import { createEntry } from '../storage.js';
+/**
+ * Records HTTP requests — method, URL, status, duration, headers, payload.
+ * Installs as global middleware via the router.
+ */
+export class RequestCollector {
+    storage;
+    config;
+    name = 'Request Collector';
+    type = 'request';
+    constructor(storage, config) {
+        this.storage = storage;
+        this.config = config;
+    }
+    register() {
+        // Registration handled by the service provider — it adds this.middleware() to the router
+    }
+    /** Returns a middleware handler that records requests */
+    middleware() {
+        const storage = this.storage;
+        const ignore = this.config.ignoreRequests ?? [];
+        return async (req, res, next) => {
+            // Skip Vite internals, static assets, and source files
+            if (this.isAsset(req.path))
+                return next();
+            if (this.shouldIgnore(req.path, ignore)) {
+                return next();
+            }
+            const start = Date.now();
+            const batchId = crypto.randomUUID();
+            req['__telescopeBatchId'] = batchId;
+            await next();
+            const duration = Date.now() - start;
+            const tags = [];
+            if (duration > (this.config.slowQueryThreshold ?? 100))
+                tags.push('slow');
+            const entry = createEntry('request', {
+                method: req.method,
+                url: req.url,
+                path: req.path,
+                query: req.query,
+                headers: req.headers,
+                body: req.body,
+                duration,
+                params: req.params,
+            }, { batchId, tags });
+            storage.store(entry);
+        };
+    }
+    shouldIgnore(path, patterns) {
+        return patterns.some(p => {
+            if (p.endsWith('*'))
+                return path.startsWith(p.slice(0, -1));
+            return path === p;
+        });
+    }
+    /** True for Vite internals, source files, and static assets */
+    isAsset(path) {
+        if (path.startsWith('/@'))
+            return true; // Vite internals: /@vite, /@react-refresh, /@id, /@fs
+        if (path.startsWith('/node_modules'))
+            return true;
+        if (path.startsWith('/src/'))
+            return true; // Vite source modules during dev
+        if (path.startsWith('/pages/'))
+            return true; // Vike page modules during dev
+        if (path.startsWith('/.vite/'))
+            return true; // Vite cache
+        const segment = path.split('/').pop() ?? '';
+        return segment.includes('.'); // any file extension → static asset
+    }
+}
+//# sourceMappingURL=request.js.map

package/dist/collectors/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/collectors/request.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAKR;IACA;IALV,IAAI,GAAG,mBAAmB,CAAA;IAC1B,IAAI,GAAG,SAAkB,CAAA;IAElC,YACmB,OAAyB,EACzB,MAAwB;QADxB,YAAO,GAAP,OAAO,CAAkB;QACzB,WAAM,GAAN,MAAM,CAAkB;IACxC,CAAC;IAEJ,QAAQ;QACN,yFAAyF;IAC3F,CAAC;IAED,yDAAyD;IACzD,UAAU;QACR,MAAM,OAAO,GAAI,IAAI,CAAC,OAAO,CAAA;QAC7B,MAAM,MAAM,GAAK,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,EAAE,CAAA;QAEjD,OAAO,KAAK,EAAE,GAAe,EAAE,GAAgB,EAAE,IAAyB,EAAE,EAAE;YAC5E,uDAAuD;YACvD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,EAAE,CAAA;YACzC,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;gBACxC,OAAO,IAAI,EAAE,CAAA;YACf,CAAC;YAED,MAAM,KAAK,GAAK,IAAI,CAAC,GAAG,EAAE,CAAA;YAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAGlC;YAAC,GAA0C,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAA;YAE5E,MAAM,IAAI,EAAE,CAAA;YAEZ,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAA;YACnC,MAAM,IAAI,GAAa,EAAE,CAAA;YACzB,IAAI,QAAQ,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,IAAI,GAAG,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAEzE,MAAM,KAAK,GAAG,WAAW,CAAC,SAAS,EAAE;gBACnC,MAAM,EAAI,GAAG,CAAC,MAAM;gBACpB,GAAG,EAAO,GAAG,CAAC,GAAG;gBACjB,IAAI,EAAM,GAAG,CAAC,IAAI;gBAClB,KAAK,EAAK,GAAG,CAAC,KAAK;gBACnB,OAAO,EAAG,GAAG,CAAC,OAAO;gBACrB,IAAI,EAAM,GAAG,CAAC,IAAI;gBAClB,QAAQ;gBACR,MAAM,EAAI,GAAG,CAAC,MAAM;aACrB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;YAErB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACtB,CAAC,CAAA;IACH,CAAC;IAEO,YAAY,CAAC,IAAY,EAAE,QAAkB;QACnD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;YACvB,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;YAC3D,OAAO,IAAI,KAAK,CAAC,CAAA;QACnB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,+DAA+D;IACvD,OAAO,CAAC,IAAY;QAC1B,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAa,OAAO,IAAI,CAAA,CAAE,sDAAsD;QACzG,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC;YAAE,OAAO,IAAI,CAAA;QACjD,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YAAU,OAAO,IAAI,CAAA,CAAE,iCAAiC;QACpF,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAQ,OAAO,IAAI,CAAA,CAAE,+BAA+B;QAClF,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAQ,OAAO,IAAI,CAAA,CAAE,aAAa;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAA;QAC3C,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA,CAAuB,oCAAoC;IACzF,CAAC;CACF"}

package/dist/collectors/schedule.d.ts

@@ -0,0 +1,14 @@
+import type { Collector, TelescopeStorage } from '../types.js';
+/**
+ * Records scheduled task executions.
+ *
+ * Patches the schedule's task runner at boot time to add recording hooks.
+ */
+export declare class ScheduleCollector implements Collector {
+    private readonly storage;
+    readonly name = "Schedule Collector";
+    readonly type: "schedule";
+    constructor(storage: TelescopeStorage);
+    register(): Promise<void>;
+}
+//# sourceMappingURL=schedule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../src/collectors/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG9D;;;;GAIG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IAIrC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,wBAAuB;IACpC,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAS;gBAEN,OAAO,EAAE,gBAAgB;IAEhD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAwChC"}

package/dist/collectors/schedule.js

@@ -0,0 +1,50 @@
+import { createEntry } from '../storage.js';
+/**
+ * Records scheduled task executions.
+ *
+ * Patches the schedule's task runner at boot time to add recording hooks.
+ */
+export class ScheduleCollector {
+    storage;
+    name = 'Schedule Collector';
+    type = 'schedule';
+    constructor(storage) {
+        this.storage = storage;
+    }
+    async register() {
+        try {
+            const mod = await import('@rudderjs/schedule');
+            const sched = mod.schedule;
+            const storage = this.storage;
+            const originalCall = sched.call.bind(sched);
+            sched.call = function (fn, ...args) {
+                const task = originalCall(fn, ...args);
+                const desc = task['description'] ?? fn.name ?? 'anonymous';
+                let start;
+                task.before(() => { start = Date.now(); });
+                task.onSuccess(() => {
+                    storage.store(createEntry('schedule', {
+                        description: desc,
+                        expression: task['expression'] ?? '',
+                        status: 'success',
+                        duration: Date.now() - start,
+                    }, { tags: ['status:success'] }));
+                });
+                task.onFailure((error) => {
+                    storage.store(createEntry('schedule', {
+                        description: desc,
+                        expression: task['expression'] ?? '',
+                        status: 'failed',
+                        duration: Date.now() - start,
+                        exception: error instanceof Error ? error.message : String(error),
+                    }, { tags: ['status:failed'] }));
+                });
+                return task;
+            };
+        }
+        catch {
+            // @rudderjs/schedule not installed — skip
+        }
+    }
+}
+//# sourceMappingURL=schedule.js.map

package/dist/collectors/schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.js","sourceRoot":"","sources":["../../src/collectors/schedule.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAIC;IAHpB,IAAI,GAAG,oBAAoB,CAAA;IAC3B,IAAI,GAAG,UAAmB,CAAA;IAEnC,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAE1D,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAA;YAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,QAEjB,CAAA;YAED,MAAM,OAAO,GAAQ,IAAI,CAAC,OAAO,CAAA;YACjC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAE3C,KAAK,CAAC,IAAI,GAAG,UAAU,EAAiB,EAAE,GAAG,IAAe;gBAC1D,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,CAAA;gBACtC,MAAM,IAAI,GAAI,IAA2C,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,WAAW,CAAA;gBAClG,IAAI,KAAa,CAAA;gBAEjB,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA,CAAC,CAAC,CAAC,CAAA;gBACzC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;oBAClB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,EAAE;wBACpC,WAAW,EAAE,IAAI;wBACjB,UAAU,EAAI,IAA2C,CAAC,YAAY,CAAC,IAAI,EAAE;wBAC7E,MAAM,EAAO,SAAS;wBACtB,QAAQ,EAAK,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;qBAChC,EAAE,EAAE,IAAI,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAA;gBACnC,CAAC,CAAC,CAAA;gBACF,IAAI,CAAC,SAAS,CAAC,CAAC,KAAc,EAAE,EAAE;oBAChC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,EAAE;wBACpC,WAAW,EAAE,IAAI;wBACjB,UAAU,EAAI,IAA2C,CAAC,YAAY,CAAC,IAAI,EAAE;wBAC7E,MAAM,EAAO,QAAQ;wBACrB,QAAQ,EAAK,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;wBAC/B,SAAS,EAAI,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;qBACpE,EAAE,EAAE,IAAI,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAA;gBAClC,CAAC,CAAC,CAAA;gBAEF,OAAO,IAAI,CAAA;YACb,CAAC,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;QAC5C,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+import { ServiceProvider, type Application } from '@rudderjs/core';
+import { type TelescopeConfig, type TelescopeStorage, type TelescopeEntry, type EntryType, type Collector, type ListOptions } from './types.js';
+export type { TelescopeConfig, TelescopeStorage, TelescopeEntry, EntryType, Collector, ListOptions };
+export { MemoryStorage, SqliteStorage, createEntry } from './storage.js';
+export { RequestCollector } from './collectors/request.js';
+export { QueryCollector } from './collectors/query.js';
+export { JobCollector } from './collectors/job.js';
+export { ExceptionCollector } from './collectors/exception.js';
+export { LogCollector } from './collectors/log.js';
+export { MailCollector } from './collectors/mail.js';
+export { NotificationCollector } from './collectors/notification.js';
+export { EventCollector } from './collectors/event.js';
+export { CacheCollector } from './collectors/cache.js';
+export { ScheduleCollector } from './collectors/schedule.js';
+export { ModelCollector } from './collectors/model.js';
+export declare class TelescopeRegistry {
+    private static storage;
+    static set(storage: TelescopeStorage): void;
+    static get(): TelescopeStorage | null;
+    /** @internal — clears the registered storage. Used for testing. */
+    static reset(): void;
+}
+export declare class Telescope {
+    private static store;
+    static list(options?: ListOptions): Promise<TelescopeEntry[]> | TelescopeEntry[];
+    static find(id: string): Promise<TelescopeEntry | null> | TelescopeEntry | null;
+    static count(type?: EntryType): Promise<number> | number;
+    static prune(type?: EntryType): Promise<void> | void;
+    static record(entry: TelescopeEntry): Promise<void> | void;
+}
+/**
+ * Returns a TelescopeServiceProvider class configured for the given config.
+ *
+ * Records requests, queries, jobs, exceptions, logs, mail, notifications,
+ * events, cache operations, scheduled tasks, and model changes.
+ *
+ * Usage in bootstrap/providers.ts:
+ *   import { telescope } from '@rudderjs/telescope'
+ *   export default [..., telescope(configs.telescope), ...]
+ */
+export declare function telescope(config?: TelescopeConfig): new (app: Application) => ServiceProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAclE,OAAO,EAAiB,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAI9J,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,CAAA;AACpG,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAItD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAgC;IAEtD,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAC3C,MAAM,CAAC,GAAG,IAAI,gBAAgB,GAAG,IAAI;IACrC,mEAAmE;IACnE,MAAM,CAAC,KAAK,IAAI,IAAI;CACrB;AAID,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,KAAK;IAMpB,MAAM,CAAC,IAAI,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,GAAG,cAAc,EAAE;IAIpF,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,cAAc,GAAG,IAAI;IAI/E,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM;IAIxD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIpD,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAG3D;AAID;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,MAAM,GAAE,eAAoB,GAAG,KAAK,GAAG,EAAE,WAAW,KAAK,eAAe,CAkGjG"}