@rudderjs/telescope 9.0.1 → 10.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/README.md +2 -0
  2. package/dist/collectors/job.d.ts +8 -2
  3. package/dist/collectors/job.d.ts.map +1 -1
  4. package/dist/collectors/job.js +52 -43
  5. package/dist/collectors/job.js.map +1 -1
  6. package/package.json +23 -23
package/README.md CHANGED
@@ -2,6 +2,8 @@
2
2
 
3
3
  Debug assistant for RudderJS — records requests, queries, jobs, exceptions, logs, mail, notifications, events, cache operations, scheduled tasks, model changes, CLI commands, outgoing HTTP requests, authorization decisions, WebSocket lifecycle, Yjs CRDT events, and `dump()`/`dd()` calls.
4
4
 
5
+ > **About the version number.** Telescope is currently at v9.x. The high major doesn't reflect 9 ground-up rewrites — it's the result of Changesets peer-bump cascades across the `@rudderjs/*` workspace, where a major bump in any peer ripples through dependents. The public API has been stable since v6.
6
+
5
7
  ## Installation
6
8
 
7
9
  ```bash
package/dist/collectors/job.d.ts CHANGED
@@ -1,12 +1,18 @@
1
1
  import type { Collector, TelescopeStorage } from '../types.js';
2
2
  /**
3
- * Records queue job dispatches by wrapping the QueueRegistry adapter's dispatch method.
3
+ * Subscribes to `@rudderjs/queue/observers` and records one entry per
4
+ * lifecycle transition. Replaces the legacy `dispatch()` monkey-patch
5
+ * which only fired in the dispatching process — under BullMQ, worker-side
6
+ * completion and failure events were never recorded.
4
7
  */
5
8
  export declare class JobCollector implements Collector {
6
9
  private readonly storage;
7
10
  readonly name = "Job Collector";
8
11
  readonly type: "job";
12
+ private unsubscribe;
9
13
  constructor(storage: TelescopeStorage);
10
- register(): Promise<void>;
14
+ register(): void;
15
+ /** @internal — used in tests + provider shutdown. */
16
+ unregister(): void;
11
17
  }
12
18
  //# sourceMappingURL=job.d.ts.map
package/dist/collectors/job.d.ts.map CHANGED
@@ -1 +1 @@
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;AAI9D;;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;CA2ChC"}
1
+ {"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../src/collectors/job.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAI9D;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,SAAS;IAKhC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,QAAQ,CAAC,IAAI,mBAAkB;IAC/B,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAS;IAC9B,OAAO,CAAC,WAAW,CAA4B;gBAElB,OAAO,EAAE,gBAAgB;IAEtD,QAAQ,IAAI,IAAI;IA2ChB,qDAAqD;IACrD,UAAU,IAAI,IAAI;CAInB"}
package/dist/collectors/job.js CHANGED
@@ -1,58 +1,67 @@
1
+ import { queueObservers } from '@rudderjs/queue/observers';
1
2
  import { createEntry } from '../storage.js';
2
3
  import { batchOpts } from '../batch-context.js';
3
4
  /**
4
- * Records queue job dispatches by wrapping the QueueRegistry adapter's dispatch method.
5
+ * Subscribes to `@rudderjs/queue/observers` and records one entry per
6
+ * lifecycle transition. Replaces the legacy `dispatch()` monkey-patch
7
+ * which only fired in the dispatching process — under BullMQ, worker-side
8
+ * completion and failure events were never recorded.
5
9
  */
6
10
  export class JobCollector {
7
11
  storage;
8
12
  name = 'Job Collector';
9
13
  type = 'job';
14
+ unsubscribe = null;
10
15
  constructor(storage) {
11
16
  this.storage = storage;
12
17
  }
13
- async register() {
14
- try {
15
- const { QueueRegistry } = await import('@rudderjs/queue');
16
- const original = QueueRegistry.get();
17
- if (!original)
18
- return;
19
- const storage = this.storage;
20
- const originalDispatch = original.dispatch.bind(original);
21
- original.dispatch = async (job, options) => {
22
- const j = job;
23
- const ctor = j.constructor;
24
- const opts = (options ?? {});
25
- const queue = opts.queue ?? ctor['queue'] ?? 'default';
26
- const delay = opts.delay ?? ctor['delay'] ?? 0;
27
- const start = Date.now();
28
- try {
29
- await originalDispatch(job, options);
30
- const duration = Date.now() - start;
31
- storage.store(createEntry('job', {
32
- class: j.constructor.name,
33
- queue,
34
- status: 'dispatched',
35
- duration,
36
- ...(delay > 0 ? { delay } : undefined),
37
- payload: JSON.parse(JSON.stringify(job)),
38
- }, { tags: [`job:${j.constructor.name}`, `queue:${queue}`, 'status:dispatched'], ...batchOpts() }));
18
+ register() {
19
+ this.unsubscribe = queueObservers.subscribe((event) => {
20
+ try {
21
+ switch (event.kind) {
22
+ case 'job.dispatched':
23
+ this.storage.store(createEntry('job', {
24
+ class: event.name,
25
+ queue: event.queue,
26
+ jobId: event.jobId,
27
+ status: 'dispatched',
28
+ payload: event.payload,
29
+ }, { tags: [`job:${event.name}`, `queue:${event.queue}`, 'status:dispatched'], ...batchOpts() }));
30
+ break;
31
+ case 'job.completed':
32
+ this.storage.store(createEntry('job', {
33
+ class: event.name,
34
+ queue: event.queue,
35
+ jobId: event.jobId,
36
+ status: 'completed',
37
+ duration: event.duration,
38
+ attempts: event.attempts,
39
+ }, { tags: [`job:${event.name}`, `queue:${event.queue}`, 'status:completed'], ...batchOpts() }));
40
+ break;
41
+ case 'job.failed':
42
+ this.storage.store(createEntry('job', {
43
+ class: event.name,
44
+ queue: event.queue,
45
+ jobId: event.jobId,
46
+ status: 'failed',
47
+ attempts: event.attempts,
48
+ exception: event.error,
49
+ ...(event.duration !== undefined ? { duration: event.duration } : {}),
50
+ }, { tags: [`job:${event.name}`, `queue:${event.queue}`, 'status:failed'], ...batchOpts() }));
51
+ break;
52
+ // job.active is intentionally not recorded — it'd double the row count
53
+ // for every job and the same data lives on the completed/failed entry.
39
54
  }
40
- catch (err) {
41
- const duration = Date.now() - start;
42
- storage.store(createEntry('job', {
43
- class: j.constructor.name,
44
- queue,
45
- status: 'failed',
46
- duration,
47
- exception: err instanceof Error ? err.message : String(err),
48
- }, { tags: [`job:${j.constructor.name}`, `queue:${queue}`, 'status:failed'], ...batchOpts() }));
49
- throw err;
50
- }
51
- };
52
- }
53
- catch {
54
- // @rudderjs/queue not installed — skip
55
- }
55
+ }
56
+ catch {
57
+ // observer errors must not break the queue layer
58
+ }
59
+ });
60
+ }
61
+ /** @internal — used in tests + provider shutdown. */
62
+ unregister() {
63
+ this.unsubscribe?.();
64
+ this.unsubscribe = null;
56
65
  }
57
66
  }
58
67
  //# sourceMappingURL=job.js.map
package/dist/collectors/job.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"job.js","sourceRoot":"","sources":["../../src/collectors/job.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"job.js","sourceRoot":"","sources":["../../src/collectors/job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAE/C;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IAKM;IAJpB,IAAI,GAAG,eAAe,CAAA;IACtB,IAAI,GAAG,KAAc,CAAA;IACtB,WAAW,GAAwB,IAAI,CAAA;IAE/C,YAA6B,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAE1D,QAAQ;QACN,IAAI,CAAC,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE;YACpD,IAAI,CAAC;gBACH,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;oBACnB,KAAK,gBAAgB;wBACnB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE;4BACpC,KAAK,EAAK,KAAK,CAAC,IAAI;4BACpB,KAAK,EAAK,KAAK,CAAC,KAAK;4BACrB,KAAK,EAAK,KAAK,CAAC,KAAK;4BACrB,MAAM,EAAI,YAAY;4BACtB,OAAO,EAAG,KAAK,CAAC,OAAO;yBACxB,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,KAAK,CAAC,KAAK,EAAE,EAAE,mBAAmB,CAAC,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC,CAAC,CAAA;wBACjG,MAAK;oBACP,KAAK,eAAe;wBAClB,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE;4BACpC,KAAK,EAAK,KAAK,CAAC,IAAI;4BACpB,KAAK,EAAK,KAAK,CAAC,KAAK;4BACrB,KAAK,EAAK,KAAK,CAAC,KAAK;4BACrB,MAAM,EAAI,WAAW;4BACrB,QAAQ,EAAE,KAAK,CAAC,QAAQ;4BACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;yBACzB,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,KAAK,CAAC,KAAK,EAAE,EAAE,kBAAkB,CAAC,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC,CAAC,CAAA;wBAChG,MAAK;oBACP,KAAK,YAAY;wBACf,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE;4BACpC,KAAK,EAAM,KAAK,CAAC,IAAI;4BACrB,KAAK,EAAM,KAAK,CAAC,KAAK;4BACtB,KAAK,EAAM,KAAK,CAAC,KAAK;4BACtB,MAAM,EAAK,QAAQ;4BACnB,QAAQ,EAAG,KAAK,CAAC,QAAQ;4BACzB,SAAS,EAAE,KAAK,CAAC,KAAK;4BACtB,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;yBACtE,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,KAAK,CAAC,KAAK,EAAE,EAAE,eAAe,CAAC,EAAE,GAAG,SAAS,EAAE,EAAE,CAAC,CAAC,CAAA;wBAC7F,MAAK;oBACP,uEAAuE;oBACvE,uEAAuE;gBACzE,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,iDAAiD;YACnD,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,qDAAqD;IACrD,UAAU;QACR,IAAI,CAAC,WAAW,EAAE,EAAE,CAAA;QACpB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;IACzB,CAAC;CACF"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rudderjs/telescope",
3
- "version": "9.0.1",
3
+ "version": "10.1.0",
4
4
  "rudderjs": {
5
5
  "provider": "TelescopeProvider",
6
6
  "stage": "monitoring"
@@ -25,26 +25,26 @@
25
25
  }
26
26
  },
27
27
  "dependencies": {
28
- "@rudderjs/core": "^0.1.4",
29
- "@rudderjs/contracts": "^0.2.0"
28
+ "@rudderjs/contracts": "^1.1.0",
29
+ "@rudderjs/core": "^1.0.0"
30
30
  },
31
31
  "peerDependencies": {
32
- "@rudderjs/router": "^0.3.1",
32
+ "@rudderjs/router": "^1.0.0",
33
33
  "@rudderjs/console": "^0.0.4",
34
- "@rudderjs/log": "^0.0.7",
35
- "@rudderjs/cache": "^0.0.12",
36
- "@rudderjs/orm": "^0.1.2",
37
- "@rudderjs/queue": "^3.0.2",
38
- "@rudderjs/mail": "^0.0.11",
39
- "@rudderjs/notification": "^0.0.12",
40
- "@rudderjs/schedule": "^0.0.12",
41
- "@rudderjs/broadcast": "^0.0.9",
42
- "@rudderjs/middleware": "^0.0.14",
34
+ "@rudderjs/log": "^1.0.0",
35
+ "@rudderjs/orm": "^1.3.0",
36
+ "@rudderjs/cache": "^1.0.0",
37
+ "@rudderjs/queue": "^4.1.0",
38
+ "@rudderjs/notification": "^1.0.0",
39
+ "@rudderjs/schedule": "^1.0.0",
40
+ "@rudderjs/middleware": "^1.0.0",
41
+ "@rudderjs/broadcast": "^1.0.0",
42
+ "@rudderjs/sync": "^0.2.2",
43
+ "@rudderjs/mail": "^1.0.0",
44
+ "@rudderjs/mcp": "^4.0.0",
45
+ "@rudderjs/ai": "^1.0.0",
43
46
  "@rudderjs/http": "^0.0.2",
44
- "@rudderjs/auth": "^3.2.1",
45
- "@rudderjs/sync": "^0.2.1",
46
- "@rudderjs/mcp": "^3.1.1",
47
- "@rudderjs/ai": "^0.1.1"
47
+ "@rudderjs/auth": "^4.0.2"
48
48
  },
49
49
  "peerDependenciesMeta": {
50
50
  "@rudderjs/console": {
@@ -98,13 +98,13 @@
98
98
  "@types/better-sqlite3": "^7.6.0",
99
99
  "typescript": "^5.4.0",
100
100
  "@rudderjs/console": "^0.0.4",
101
- "@rudderjs/broadcast": "^0.0.9",
101
+ "@rudderjs/broadcast": "^1.0.0",
102
+ "@rudderjs/sync": "^0.2.2",
102
103
  "@rudderjs/http": "^0.0.2",
103
- "@rudderjs/auth": "^3.2.1",
104
- "@rudderjs/ai": "^0.1.1",
105
- "@rudderjs/sync": "^0.2.1",
106
- "@rudderjs/support": "^0.0.4",
107
- "@rudderjs/mcp": "^3.1.1"
104
+ "@rudderjs/auth": "^4.0.2",
105
+ "@rudderjs/ai": "^1.0.0",
106
+ "@rudderjs/mcp": "^4.0.0",
107
+ "@rudderjs/support": "^1.1.0"
108
108
  },
109
109
  "author": "Suleiman Shahbari",
110
110
  "scripts": {