@rudderjs/pulse 5.0.0 → 6.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/recorders/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAEzD;;GAEG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAGhC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,IAAI,oBAAmB;gBAEH,OAAO,EAAE,YAAY;IAE5C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAsBhC"}

package/dist/{aggregators → recorders}/cache.js

@@ -1,9 +1,9 @@
 /**
  * Tracks cache hit/miss ratio by wrapping the CacheRegistry adapter.
  */
-export class CacheAggregator {
+export class CacheRecorder {
     storage;
-    name = 'Cache Aggregator';
+    name = 'Cache Recorder';
     constructor(storage) {
         this.storage = storage;
     }

package/dist/recorders/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/recorders/cache.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,aAAa;IAGK;IAFpB,IAAI,GAAG,gBAAgB,CAAA;IAEhC,YAA6B,OAAqB;QAArB,YAAO,GAAP,OAAO,CAAc;IAAG,CAAC;IAEtD,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAA;YACzD,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,EAAE,CAAA;YACnC,IAAI,CAAC,OAAO;gBAAE,OAAM;YAEpB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;YAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAExC;YAAC,OAA8C,CAAC,KAAK,CAAC,GAAG,KAAK,EAAe,GAAW,EAAqB,EAAE;gBAC9G,MAAM,KAAK,GAAG,MAAO,OAA8C,CAAC,GAAG,CAAC,CAAA;gBACxE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAA;gBACjC,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAA;gBACnC,CAAC;gBACD,OAAO,KAAK,CAAA;YACd,CAAC,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;CACF"}

package/dist/recorders/exception.d.ts

@@ -0,0 +1,11 @@
+import type { Recorder, PulseStorage } from '../types.js';
+/**
+ * Tracks exception count over time by hooking into the exception reporter.
+ */
+export declare class ExceptionRecorder implements Recorder {
+    private readonly storage;
+    readonly name = "Exception Recorder";
+    constructor(storage: PulseStorage);
+    register(): Promise<void>;
+}
+//# sourceMappingURL=exception.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exception.d.ts","sourceRoot":"","sources":["../../src/recorders/exception.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAEzD;;GAEG;AACH,qBAAa,iBAAkB,YAAW,QAAQ;IAGpC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,IAAI,wBAAuB;gBAEP,OAAO,EAAE,YAAY;IAE5C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAuBhC"}

package/dist/{aggregators → recorders}/exception.js

@@ -1,9 +1,9 @@
 /**
  * Tracks exception count over time by hooking into the exception reporter.
  */
-export class ExceptionAggregator {
+export class ExceptionRecorder {
     storage;
-    name = 'Exception Aggregator';
+    name = 'Exception Recorder';
     constructor(storage) {
         this.storage = storage;
     }

package/dist/recorders/exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception.js","sourceRoot":"","sources":["../../src/recorders/exception.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAGC;IAFpB,IAAI,GAAG,oBAAoB,CAAA;IAEpC,YAA6B,OAAqB;QAArB,YAAO,GAAP,OAAO,CAAc;IAAG,CAAC;IAEtD,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC;YACH,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAGrE,CAAA;YAED,MAAM,OAAO,GAAU,IAAI,CAAC,OAAO,CAAA;YACnC,MAAM,cAAc,GAAG,MAAM,CAAA;YAE7B,oBAAoB,CAAC,CAAC,GAAY,EAAE,EAAE;gBACpC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,CAAA;gBAC/B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAA;gBACpC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE;oBAC9B,KAAK,EAAI,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;oBACnD,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBAC7C,CAAC,CAAA;gBACF,cAAc,CAAC,GAAG,CAAC,CAAA;YACrB,CAAC,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,kBAAkB;QACpB,CAAC;IACH,CAAC;CACF"}

package/dist/{aggregators → recorders}/query.d.ts

@@ -1,11 +1,11 @@
-import type { Aggregator, PulseStorage, PulseConfig } from '../types.js';
+import type { Recorder, PulseStorage, PulseConfig } from '../types.js';
 /**
  * Tracks slow database queries by hooking into the ORM adapter.
  */
-export declare class QueryAggregator implements Aggregator {
+export declare class QueryRecorder implements Recorder {
     private readonly storage;
     private readonly config;
-    readonly name = "Query Aggregator";
+    readonly name = "Query Recorder";
     constructor(storage: PulseStorage, config: PulseConfig);
     register(): Promise<void>;
 }

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/recorders/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEtE;;GAEG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAI1C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,QAAQ,CAAC,IAAI,oBAAmB;gBAGb,OAAO,EAAE,YAAY,EACrB,MAAM,EAAG,WAAW;IAGjC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA4BhC"}

package/dist/{aggregators → recorders}/query.js

@@ -1,10 +1,10 @@
 /**
  * Tracks slow database queries by hooking into the ORM adapter.
  */
-export class QueryAggregator {
+export class QueryRecorder {
     storage;
     config;
-    name = 'Query Aggregator';
+    name = 'Query Recorder';
     constructor(storage, config) {
         this.storage = storage;
         this.config = config;

package/dist/recorders/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/recorders/query.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,aAAa;IAIL;IACA;IAJV,IAAI,GAAG,gBAAgB,CAAA;IAEhC,YACmB,OAAqB,EACrB,MAAoB;QADpB,YAAO,GAAP,OAAO,CAAc;QACrB,WAAM,GAAN,MAAM,CAAc;IACpC,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,IAAI,IAAI,CAAC,QAAQ,GAAG,SAAS,EAAE,CAAC;oBAC9B,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE;wBAC/B,GAAG,EAAO,IAAI,CAAC,GAAG;wBAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,KAAK,EAAK,IAAI,CAAC,KAAK;qBACrB,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;QACvC,CAAC;IACH,CAAC;CACF"}

package/dist/recorders/queue.d.ts

@@ -0,0 +1,19 @@
+import type { Recorder, PulseStorage } from '../types.js';
+/**
+ * Tracks queue throughput, wait time, and failed jobs by subscribing to
+ * `@rudderjs/queue/observers`. Replaces the legacy `dispatch()`
+ * monkey-patch which only fired in the dispatching process — under
+ * BullMQ, worker-side completion and failure events were never recorded
+ * and `queue_wait_time` was actually the enqueue duration, not the
+ * queue-to-active wait.
+ */
+export declare class QueueRecorder implements Recorder {
+    private readonly storage;
+    readonly name = "Queue Recorder";
+    private unsubscribe;
+    constructor(storage: PulseStorage);
+    register(): void;
+    /** @internal — used in tests + provider shutdown. */
+    unregister(): void;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/recorders/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/recorders/queue.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAEzD;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAIhC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,QAAQ,CAAC,IAAI,oBAAmB;IAChC,OAAO,CAAC,WAAW,CAA4B;gBAElB,OAAO,EAAE,YAAY;IAElD,QAAQ,IAAI,IAAI;IA6BhB,qDAAqD;IACrD,UAAU,IAAI,IAAI;CAInB"}

package/dist/recorders/queue.js

@@ -0,0 +1,52 @@
+import { queueObservers } from '@rudderjs/queue/observers';
+/**
+ * Tracks queue throughput, wait time, and failed jobs by subscribing to
+ * `@rudderjs/queue/observers`. Replaces the legacy `dispatch()`
+ * monkey-patch which only fired in the dispatching process — under
+ * BullMQ, worker-side completion and failure events were never recorded
+ * and `queue_wait_time` was actually the enqueue duration, not the
+ * queue-to-active wait.
+ */
+export class QueueRecorder {
+    storage;
+    name = 'Queue Recorder';
+    unsubscribe = null;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    register() {
+        this.unsubscribe = queueObservers.subscribe((event) => {
+            try {
+                switch (event.kind) {
+                    case 'job.active': {
+                        const wait = event.startedAt.getTime() - event.dispatchedAt.getTime();
+                        void this.storage.record('queue_wait_time', wait);
+                        break;
+                    }
+                    case 'job.completed':
+                        void this.storage.record('queue_throughput', 1);
+                        break;
+                    case 'job.failed':
+                        void this.storage.record('queue_throughput', 1);
+                        void this.storage.storeEntry('failed_job', {
+                            class: event.name,
+                            queue: event.queue,
+                            jobId: event.jobId,
+                            attempts: event.attempts,
+                            exception: event.error,
+                        });
+                        break;
+                }
+            }
+            catch {
+                // observer errors must not break the queue layer
+            }
+        });
+    }
+    /** @internal — used in tests + provider shutdown. */
+    unregister() {
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/recorders/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/recorders/queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAG1D;;;;;;;GAOG;AACH,MAAM,OAAO,aAAa;IAIK;IAHpB,IAAI,GAAG,gBAAgB,CAAA;IACxB,WAAW,GAAwB,IAAI,CAAA;IAE/C,YAA6B,OAAqB;QAArB,YAAO,GAAP,OAAO,CAAc;IAAG,CAAC;IAEtD,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,YAAY,CAAC,CAAC,CAAC;wBAClB,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,CAAA;wBACrE,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAA;wBACjD,MAAK;oBACP,CAAC;oBACD,KAAK,eAAe;wBAClB,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAA;wBAC/C,MAAK;oBACP,KAAK,YAAY;wBACf,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAA;wBAC/C,KAAK,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE;4BACzC,KAAK,EAAM,KAAK,CAAC,IAAI;4BACrB,KAAK,EAAM,KAAK,CAAC,KAAK;4BACtB,KAAK,EAAM,KAAK,CAAC,KAAK;4BACtB,QAAQ,EAAG,KAAK,CAAC,QAAQ;4BACzB,SAAS,EAAE,KAAK,CAAC,KAAK;yBACvB,CAAC,CAAA;wBACF,MAAK;gBACT,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/dist/{aggregators → recorders}/request.d.ts

@@ -1,13 +1,13 @@
 import type { AppRequest, AppResponse } from '@rudderjs/contracts';
-import type { Aggregator, PulseStorage, PulseConfig } from '../types.js';
+import type { Recorder, PulseStorage, PulseConfig } from '../types.js';
 /**
  * Tracks request throughput, duration (p50/p95/p99), and slow requests.
  * Installs as global middleware.
  */
-export declare class RequestAggregator implements Aggregator {
+export declare class RequestRecorder implements Recorder {
     private readonly storage;
     private readonly config;
-    readonly name = "Request Aggregator";
+    readonly name = "Request Recorder";
     constructor(storage: PulseStorage, config: PulseConfig);
     register(): void;
     middleware(): (req: AppRequest, res: AppResponse, next: () => Promise<void>) => Promise<void>;

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

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/recorders/request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAGtE;;;GAGG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAI5C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,QAAQ,CAAC,IAAI,sBAAqB;gBAGf,OAAO,EAAE,YAAY,EACrB,MAAM,EAAG,WAAW;IAGvC,QAAQ,IAAI,IAAI;IAIhB,UAAU,KAKM,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,MAAM,OAAO,CAAC,IAAI,CAAC;CAyB7E"}

package/dist/{aggregators → recorders}/request.js

@@ -3,10 +3,10 @@ import { isAsset } from '../utils.js';
  * Tracks request throughput, duration (p50/p95/p99), and slow requests.
  * Installs as global middleware.
  */
-export class RequestAggregator {
+export class RequestRecorder {
     storage;
     config;
-    name = 'Request Aggregator';
+    name = 'Request Recorder';
     constructor(storage, config) {
         this.storage = storage;
         this.config = config;

package/dist/recorders/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/recorders/request.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC;;;GAGG;AACH,MAAM,OAAO,eAAe;IAIP;IACA;IAJV,IAAI,GAAG,kBAAkB,CAAA;IAElC,YACmB,OAAqB,EACrB,MAAoB;QADpB,YAAO,GAAP,OAAO,CAAc;QACrB,WAAM,GAAN,MAAM,CAAc;IACpC,CAAC;IAEJ,QAAQ;QACN,mDAAmD;IACrD,CAAC;IAED,UAAU;QACR,MAAM,OAAO,GAAK,IAAI,CAAC,OAAO,CAAA;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,IAAI,IAAI,CAAA;QAC1D,MAAM,MAAM,GAAM,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,CAAA;QAE7C,OAAO,KAAK,EAAE,GAAe,EAAE,GAAgB,EAAE,IAAyB,EAAE,EAAE;YAC5E,0BAA0B;YAC1B,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,MAAM,EAAE,CAAC;gBAAE,OAAO,IAAI,EAAE,CAAA;YACpD,uDAAuD;YACvD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,EAAE,CAAA;YAEpC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;YACxB,MAAM,IAAI,EAAE,CAAA;YACZ,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAA;YAEnC,oBAAoB;YACpB,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,CAAA;YAClC,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAA;YAE5C,qBAAqB;YACrB,IAAI,QAAQ,GAAG,SAAS,EAAE,CAAC;gBACzB,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE;oBACjC,MAAM,EAAI,GAAG,CAAC,MAAM;oBACpB,GAAG,EAAO,GAAG,CAAC,GAAG;oBACjB,IAAI,EAAM,GAAG,CAAC,IAAI;oBAClB,QAAQ;iBACT,CAAC,CAAA;YACJ,CAAC;QACH,CAAC,CAAA;IACH,CAAC;CACF"}

package/dist/{aggregators → recorders}/server.d.ts

@@ -1,11 +1,11 @@
-import type { Aggregator, PulseStorage } from '../types.js';
+import type { Recorder, PulseStorage } from '../types.js';
 /**
  * Periodically collects server resource metrics — CPU usage and memory.
  */
-export declare class ServerAggregator implements Aggregator {
+export declare class ServerRecorder implements Recorder {
     private readonly storage;
     private readonly intervalMs;
-    readonly name = "Server Aggregator";
+    readonly name = "Server Recorder";
     constructor(storage: PulseStorage, intervalMs?: number);
     register(): void;
     private collect;

package/dist/recorders/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/recorders/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAEzD;;GAEG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAI3C,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ7B,QAAQ,CAAC,IAAI,qBAAoB;gBAGd,OAAO,EAAE,YAAY,EACrB,UAAU,GAAE,MAAe;IAG9C,QAAQ,IAAI,IAAI;IAOhB,OAAO,CAAC,OAAO;CAiBhB"}

package/dist/{aggregators → recorders}/server.js

@@ -2,10 +2,10 @@ import { cpus, totalmem, freemem } from 'node:os';
 /**
  * Periodically collects server resource metrics — CPU usage and memory.
  */
-export class ServerAggregator {
+export class ServerRecorder {
     storage;
     intervalMs;
-    name = 'Server Aggregator';
+    name = 'Server Recorder';
     constructor(storage, intervalMs = 15_000) {
         this.storage = storage;
         this.intervalMs = intervalMs;

package/dist/recorders/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/recorders/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAGjD;;GAEG;AACH,MAAM,OAAO,cAAc;IAIN;IACA;IAJV,IAAI,GAAG,iBAAiB,CAAA;IAEjC,YACmB,OAAqB,EACrB,aAAqB,MAAM;QAD3B,YAAO,GAAP,OAAO,CAAc;QACrB,eAAU,GAAV,UAAU,CAAiB;IAC3C,CAAC;IAEJ,QAAQ;QACN,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;QAChE,KAAK,CAAC,KAAK,EAAE,CAAA;QACb,2BAA2B;QAC3B,IAAI,CAAC,OAAO,EAAE,CAAA;IAChB,CAAC;IAEO,OAAO;QACb,0CAA0C;QAC1C,MAAM,KAAK,GAAG,IAAI,EAAE,CAAA;QACpB,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;YAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;YAClE,MAAM,IAAI,GAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;YAC7B,OAAO,GAAG,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAA;QAC7C,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAA;QAEpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAA;QAErE,2BAA2B;QAC3B,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAA;QACxB,MAAM,IAAI,GAAI,OAAO,EAAE,CAAA;QACvB,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAA;QAClD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAA;IAC3E,CAAC;CACF"}

package/dist/{aggregators → recorders}/user.d.ts

@@ -1,12 +1,12 @@
 import type { AppRequest, AppResponse } from '@rudderjs/contracts';
-import type { Aggregator, PulseStorage } from '../types.js';
+import type { Recorder, PulseStorage } from '../types.js';
 /**
  * Tracks active (unique) users per minute bucket.
  * Identifies users by session cookie, auth header, or IP.
  */
-export declare class UserAggregator implements Aggregator {
+export declare class UserRecorder implements Recorder {
     private readonly storage;
-    readonly name = "User Aggregator";
+    readonly name = "User Recorder";
     private readonly seen;
     private currentMinute;
     constructor(storage: PulseStorage);

package/dist/recorders/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/recorders/user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAGzD;;;GAGG;AACH,qBAAa,YAAa,YAAW,QAAQ;IAK/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,QAAQ,CAAC,IAAI,mBAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,aAAa,CAAI;gBAEI,OAAO,EAAE,YAAY;IAElD,QAAQ,IAAI,IAAI;IAIhB,UAAU,KAGM,KAAK,UAAU,EAAE,MAAM,WAAW,EAAE,MAAM,MAAM,OAAO,CAAC,IAAI,CAAC;IAoB7E,OAAO,CAAC,YAAY;CAWrB"}

package/dist/{aggregators → recorders}/user.js

@@ -3,9 +3,9 @@ import { isAsset } from '../utils.js';
  * Tracks active (unique) users per minute bucket.
  * Identifies users by session cookie, auth header, or IP.
  */
-export class UserAggregator {
+export class UserRecorder {
     storage;
-    name = 'User Aggregator';
+    name = 'User Recorder';
     seen = new Set();
     currentMinute = 0;
     constructor(storage) {

package/dist/recorders/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/recorders/user.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAErC;;;GAGG;AACH,MAAM,OAAO,YAAY;IAKM;IAJpB,IAAI,GAAG,eAAe,CAAA;IACd,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IACjC,aAAa,GAAG,CAAC,CAAA;IAEzB,YAA6B,OAAqB;QAArB,YAAO,GAAP,OAAO,CAAc;IAAG,CAAC;IAEtD,QAAQ;QACN,mDAAmD;IACrD,CAAC;IAED,UAAU;QACR,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAE5B,OAAO,KAAK,EAAE,GAAe,EAAE,IAAiB,EAAE,IAAyB,EAAE,EAAE;YAC7E,uDAAuD;YACvD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,EAAE,CAAA;YAEpC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAA;YAC9C,IAAI,MAAM,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;gBAClC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;gBACjB,IAAI,CAAC,aAAa,GAAG,MAAM,CAAA;YAC7B,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;YACrC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;gBACrB,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC,CAAA;YACnC,CAAC;YAED,OAAO,IAAI,EAAE,CAAA;QACf,CAAC,CAAA;IACH,CAAC;IAEO,YAAY,CAAC,GAAe;QAClC,0CAA0C;QAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAA;QACzC,IAAI,IAAI;YAAE,OAAO,QAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAA;QAE5C,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAC9D,IAAI,OAAO;YAAE,OAAO,WAAW,OAAO,EAAE,CAAA;QAExC,OAAO,MAAM,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,SAAS,EAAE,CAAA;IAC/G,CAAC;CACF"}

package/dist/routes.d.ts

@@ -0,0 +1,23 @@
+import type { MiddlewareHandler } from '@rudderjs/contracts';
+import type { PulseStorage, PulseConfig } from './types.js';
+export interface RegisterPulseRoutesOptions {
+    /** Path prefix for all pulse routes — default `/pulse` */
+    path?: string;
+    /** Auth gate — receives request, returns boolean. Same shape as `PulseConfig.auth`. */
+    auth?: PulseConfig['auth'];
+    /** Extra middleware to prepend to all routes */
+    middleware?: MiddlewareHandler[];
+}
+/**
+ * Register all Pulse routes — dashboard page and API endpoints. Called
+ * from `PulseProvider.boot()` once the router peer is resolved.
+ *
+ * Mirrors the package-UI shape established by `@rudderjs/auth`'s
+ * `registerAuthRoutes()`, `@rudderjs/telescope`'s
+ * `registerTelescopeRoutes()`, and `@rudderjs/horizon`'s
+ * `registerHorizonRoutes()`. Package-internal pages live under
+ * `views/vanilla/`, route registration is centralised here, the API
+ * handler implementations live in `api/routes.ts`.
+ */
+export declare function registerPulseRoutes(storage: PulseStorage, opts?: RegisterPulseRoutesOptions): Promise<void>;
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA2B,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAO3D,MAAM,WAAW,0BAA0B;IACzC,0DAA0D;IAC1D,IAAI,CAAC,EAAQ,MAAM,CAAA;IACnB,uFAAuF;IACvF,IAAI,CAAC,EAAQ,WAAW,CAAC,MAAM,CAAC,CAAA;IAChC,gDAAgD;IAChD,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAA;CACjC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,YAAY,EACrB,IAAI,GAAK,0BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CA2Cf"}

package/dist/routes.js

@@ -0,0 +1,44 @@
+import { Dashboard } from './views/vanilla/index.js';
+import { getOverview, getRequests, listSlowRequests, getQueues, listSlowQueries, getExceptions, getCache, getUsers, getServers, authMiddleware, } from './api/routes.js';
+/**
+ * Register all Pulse routes — dashboard page and API endpoints. Called
+ * from `PulseProvider.boot()` once the router peer is resolved.
+ *
+ * Mirrors the package-UI shape established by `@rudderjs/auth`'s
+ * `registerAuthRoutes()`, `@rudderjs/telescope`'s
+ * `registerTelescopeRoutes()`, and `@rudderjs/horizon`'s
+ * `registerHorizonRoutes()`. Package-internal pages live under
+ * `views/vanilla/`, route registration is centralised here, the API
+ * handler implementations live in `api/routes.ts`.
+ */
+export async function registerPulseRoutes(storage, opts = {}) {
+    let router;
+    try {
+        router = (await import('@rudderjs/router')).router;
+    }
+    catch {
+        return; // @rudderjs/router not installed — pulse routes disabled
+    }
+    const basePath = `/${(opts.path ?? 'pulse').replace(/^\/+/, '')}`;
+    const apiPrefix = `${basePath}/api`;
+    const middleware = [
+        ...(opts.middleware ?? []),
+        ...(opts.auth ? [authMiddleware({ auth: opts.auth })] : []),
+    ];
+    const html = (_req, res, content) => {
+        res.header('Content-Type', 'text/html').send(content);
+    };
+    // ── Dashboard UI ─────────────────────────────────────────
+    router.get(basePath, (r, s) => html(r, s, Dashboard({ apiPrefix })), middleware);
+    // ── API ──────────────────────────────────────────────────
+    router.get(`${apiPrefix}/overview`, (req, res) => getOverview(storage, req, res), middleware);
+    router.get(`${apiPrefix}/requests`, (req, res) => getRequests(storage, req, res), middleware);
+    router.get(`${apiPrefix}/slow-requests`, (req, res) => listSlowRequests(storage, req, res), middleware);
+    router.get(`${apiPrefix}/queues`, (req, res) => getQueues(storage, req, res), middleware);
+    router.get(`${apiPrefix}/slow-queries`, (req, res) => listSlowQueries(storage, req, res), middleware);
+    router.get(`${apiPrefix}/exceptions`, (req, res) => getExceptions(storage, req, res), middleware);
+    router.get(`${apiPrefix}/cache`, (req, res) => getCache(storage, req, res), middleware);
+    router.get(`${apiPrefix}/users`, (req, res) => getUsers(storage, req, res), middleware);
+    router.get(`${apiPrefix}/servers`, (req, res) => getServers(storage, req, res), middleware);
+}
+//# sourceMappingURL=routes.js.map

package/dist/routes.js.map

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

package/dist/types.d.ts

@@ -36,7 +36,7 @@ export interface EntryListOptions {
     perPage?: number | undefined;
     search?: string | undefined;
 }
-export interface Aggregator {
+export interface Recorder {
     readonly name: string;
     register(): void | Promise<void>;
 }

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAkG9D,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAgB,IAAI;IAC3B,IAAI,EAAmB,OAAO;IAC9B,OAAO,EAAgB,QAAiB;IACxC,UAAU,EAAa,WAAW;IAClC,eAAe,EAAQ,GAAG,EAAG,SAAS;IACtC,oBAAoB,EAAG,IAAI,EAAE,KAAK;IAClC,kBAAkB,EAAK,GAAG,EAAG,KAAK;IAClC,cAAc,EAAS,IAAI;IAC3B,YAAY,EAAW,IAAI;IAC3B,WAAW,EAAY,IAAI;IAC3B,gBAAgB,EAAO,IAAI;IAC3B,WAAW,EAAY,IAAI;IAC3B,aAAa,EAAU,IAAI;IAC3B,qBAAqB,EAAE,MAAM;IAC7B,IAAI,EAAmB,IAA6D;CACrF,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAuG9D,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAgB,IAAI;IAC3B,IAAI,EAAmB,OAAO;IAC9B,OAAO,EAAgB,QAAiB;IACxC,UAAU,EAAa,WAAW;IAClC,eAAe,EAAQ,GAAG,EAAG,SAAS;IACtC,oBAAoB,EAAG,IAAI,EAAE,KAAK;IAClC,kBAAkB,EAAK,GAAG,EAAG,KAAK;IAClC,cAAc,EAAS,IAAI;IAC3B,YAAY,EAAW,IAAI;IAC3B,WAAW,EAAY,IAAI;IAC3B,gBAAgB,EAAO,IAAI;IAC3B,WAAW,EAAY,IAAI;IAC3B,aAAa,EAAU,IAAI;IAC3B,qBAAqB,EAAE,MAAM;IAC7B,IAAI,EAAmB,IAA6D;CACrF,CAAA"}

package/dist/views/vanilla/Dashboard.d.ts

@@ -0,0 +1,11 @@
+export interface DashboardProps {
+    apiPrefix: string;
+}
+/**
+ * Pulse single-page dashboard — metric cards (request throughput, cache
+ * hit rate, queue jobs, exceptions, active users, server CPU/memory)
+ * with sparklines + slow-request and recent-exception tables.
+ * Auto-refreshes every 10 seconds.
+ */
+export declare function Dashboard(props: DashboardProps): string;
+//# sourceMappingURL=Dashboard.d.ts.map

package/dist/views/vanilla/Dashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dashboard.d.ts","sourceRoot":"","sources":["../../../src/views/vanilla/Dashboard.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAuOvD"}

package/dist/{ui/dashboard.js → views/vanilla/Dashboard.js}

@@ -1,9 +1,13 @@
-import { layout } from './layout.js';
+import { Layout } from './Layout.js';
 /**
- * Renders the Pulse dashboard — a single page with metric cards that auto-refresh.
+ * Pulse single-page dashboard — metric cards (request throughput, cache
+ * hit rate, queue jobs, exceptions, active users, server CPU/memory)
+ * with sparklines + slow-request and recent-exception tables.
+ * Auto-refreshes every 10 seconds.
  */
-export function dashboardPage(apiPrefix) {
-    return layout('Dashboard', `
+export function Dashboard(props) {
+    const { apiPrefix } = props;
+    const body = `
     <div x-data="dashboard()" x-init="load()" x-cloak>
       <!-- Metric Cards Grid -->
       <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-6">
@@ -166,7 +170,6 @@ export function dashboardPage(apiPrefix) {
         </div>
       </div>
 
-      <!-- Auto-refresh indicator -->
       <div class="mt-4 text-center text-xs text-gray-400">
         Auto-refreshes every 10 seconds
       </div>
@@ -229,6 +232,7 @@ export function dashboardPage(apiPrefix) {
           }
         }
       }
-    </script>`, 'pulse');
+    </script>`;
+    return Layout({ title: 'Dashboard', body });
 }
-//# sourceMappingURL=dashboard.js.map
+//# sourceMappingURL=Dashboard.js.map

package/dist/views/vanilla/Dashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dashboard.js","sourceRoot":"","sources":["../../../src/views/vanilla/Dashboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAMpC;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,CAAA;IAE3B,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBA2LQ,SAAS;uBACT,SAAS;uBACT,SAAS;uBACT,SAAS;uBACT,SAAS;uBACT,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAiClB,CAAA;IAEZ,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAA;AAC7C,CAAC"}

package/dist/views/vanilla/Layout.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared HTML chrome for Pulse dashboard pages.
+ *
+ * Vanilla mode — Alpine.js + Tailwind via CDN, no client framework
+ * dependency, no build step. Self-contained so pulse can run in any
+ * RudderJS app regardless of frontend stack.
+ */
+export interface LayoutProps {
+    title: string;
+    body: string;
+}
+export declare function Layout(props: LayoutProps): string;
+//# sourceMappingURL=Layout.d.ts.map

package/dist/views/vanilla/Layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Layout.d.ts","sourceRoot":"","sources":["../../../src/views/vanilla/Layout.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAG,MAAM,CAAA;CACd;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA6CjD"}

package/dist/{ui/layout.js → views/vanilla/Layout.js}

@@ -1,9 +1,7 @@
-/**
- * Shared HTML layout for Pulse UI pages.
- * Uses Tailwind CSS (CDN) + Alpine.js (CDN) for a zero-build UI.
- */
-export function layout(title, body, path) {
-    return `<!DOCTYPE html>
+import { html, raw } from './_html.js';
+export function Layout(props) {
+    const { title, body } = props;
+    return html `<!DOCTYPE html>
 <html lang="en">
 <head>
   <meta charset="UTF-8">
@@ -20,14 +18,11 @@ export function layout(title, body, path) {
 </head>
 <body class="bg-gray-50 text-gray-900 font-sans antialiased">
   <div class="min-h-screen">
-    <!-- Header -->
     <header class="bg-white border-b border-gray-200 px-6 py-4">
       <div class="max-w-7xl mx-auto flex items-center justify-between">
         <div class="flex items-center gap-3">
           <div class="w-8 h-8 bg-indigo-600 rounded-lg flex items-center justify-center">
-            <svg class="w-5 h-5 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z"/>
-            </svg>
+            ${raw('<svg class="w-5 h-5 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z"/></svg>')}
           </div>
           <h1 class="text-lg font-semibold">Pulse</h1>
         </div>
@@ -42,13 +37,11 @@ export function layout(title, body, path) {
         </div>
       </div>
     </header>
-
-    <!-- Content -->
     <main class="max-w-7xl mx-auto px-6 py-8">
-      ${body}
+      ${raw(body)}
     </main>
   </div>
 </body>
-</html>`;
+</html>`.value;
 }
-//# sourceMappingURL=layout.js.map
+//# sourceMappingURL=Layout.js.map

package/dist/views/vanilla/Layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Layout.js","sourceRoot":"","sources":["../../../src/views/vanilla/Layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAetC,MAAM,UAAU,MAAM,CAAC,KAAkB;IACvC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;IAE7B,OAAO,IAAI,CAAA;;;;;WAKF,KAAK;;;;;;;;;;;;;;;;cAgBF,GAAG,CAAC,8WAA8W,CAAC;;;;;;;;;;;;;;;;QAgBzX,GAAG,CAAC,IAAI,CAAC;;;;QAIT,CAAC,KAAK,CAAA;AACd,CAAC"}

package/dist/views/vanilla/_html.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tiny HTML templating helper — inlined from `@rudderjs/view`'s `html\`\``,
+ * `escapeHtml`, and `SafeString` so pulse doesn't need to pull
+ * `@rudderjs/view` (which has a `vike` peer dep that's unwanted baggage
+ * for a self-contained debug tool).
+ *
+ * Mirrors the same helper used by `@rudderjs/telescope` and
+ * `@rudderjs/horizon`. If `@rudderjs/view` ever drops the Vike peer or
+ * splits the HTML helpers into a separate package, this file can be
+ * replaced with a one-line `export ... from '@rudderjs/view'`.
+ *
+ * Semantics:
+ * - Primitives are escaped via `escapeHtml`
+ * - `null`/`undefined`/`false` render as empty string
+ * - Arrays recursively render and join (no separator)
+ * - `SafeString` instances pass through unchanged (escape hatch for
+ *   composing nested templates or injecting trusted markup)
+ */
+export declare class SafeString {
+    readonly value: string;
+    constructor(value: string);
+    toString(): string;
+}
+export declare function escapeHtml(value: unknown): string;
+export declare function html(strings: TemplateStringsArray, ...values: unknown[]): SafeString;
+/** Wrap pre-rendered, trusted HTML so it passes through `html\`\`` interpolation unchanged. */
+export declare function raw(value: string): SafeString;
+//# sourceMappingURL=_html.d.ts.map

package/dist/views/vanilla/_html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_html.d.ts","sourceRoot":"","sources":["../../../src/views/vanilla/_html.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,qBAAa,UAAU;aACO,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;IACzC,QAAQ,IAAI,MAAM;CACnB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQjD;AASD,wBAAgB,IAAI,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAMpF;AAED,+FAA+F;AAC/F,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAE7C"}