eimer 0.1.1 → 0.2.0

package/dist/cjs/tracing/EimerLoggerTracerBackend.d.ts

@@ -0,0 +1,12 @@
+import type { Logger } from '../eimer/Logger';
+import type { TracerBackend } from '../eimer/TracerBackend';
+import type { TraceSpan } from '../eimer/TraceSpan';
+/**
+ * A `TracerBackend` that logs every recorded span via `Logger`
+ */
+export declare class EimerLoggerTracerBackend implements TracerBackend {
+    private readonly logger;
+    constructor(logger?: Logger);
+    handleSpan(span: TraceSpan): void;
+}
+//# sourceMappingURL=EimerLoggerTracerBackend.d.ts.map

package/dist/cjs/tracing/EimerLoggerTracerBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerLoggerTracerBackend.d.ts","sourceRoot":"","sources":["../../../src/tracing/EimerLoggerTracerBackend.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;GAEG;AACH,qBAAa,wBAAyB,YAAW,aAAa;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,CAAC,EAAE,MAAM;IAI3B,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CAGpC"}

package/dist/cjs/tracing/EimerLoggerTracerBackend.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EimerLoggerTracerBackend = void 0;
+const LogLevel_1 = require("../eimer/LogLevel");
+const EimerLogger_1 = require("../logger/EimerLogger");
+/**
+ * A `TracerBackend` that logs every recorded span via `Logger`
+ */
+class EimerLoggerTracerBackend {
+    constructor(logger) {
+        this.logger = logger ?? new EimerLogger_1.EimerLogger(LogLevel_1.LogLevel.INFO, 'EimerLoggerTracerBackend');
+    }
+    handleSpan(span) {
+        this.logger.info(`${span.name} (${span.durationMs.toFixed(2)}ms)`, span);
+    }
+}
+exports.EimerLoggerTracerBackend = EimerLoggerTracerBackend;
+//# sourceMappingURL=EimerLoggerTracerBackend.js.map

package/dist/cjs/tracing/EimerLoggerTracerBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerLoggerTracerBackend.js","sourceRoot":"","sources":["../../../src/tracing/EimerLoggerTracerBackend.ts"],"names":[],"mappings":";;;AAAA,gDAA6C;AAC7C,uDAAoD;AAMpD;;GAEG;AACH,MAAa,wBAAwB;IAGjC,YAAY,MAAe;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,IAAI,yBAAW,CAAC,mBAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC;IACvF,CAAC;IAED,UAAU,CAAC,IAAe;QACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC7E,CAAC;CACJ;AAVD,4DAUC"}

package/dist/cjs/tracing/EimerNoopTracer.d.ts

@@ -0,0 +1,17 @@
+import { TracerBackend } from 'src/eimer';
+import type { IdGenerator } from '../eimer/IdGenerator';
+import type { TraceContext } from '../eimer/TraceContext';
+import type { Tracer } from '../eimer/Tracer';
+/**
+ * `Tracer` that does nothing (except id generation)
+ * Saves a bunch of if-statements wherever a tracer is optional
+ */
+export declare class EimerNoopTracer implements Tracer {
+    private readonly idGenerator;
+    constructor(idGenerator?: IdGenerator);
+    setBackend(_backend?: TracerBackend): void;
+    startSpan(_name: string, _metadata?: Record<string, unknown>, parent?: TraceContext): TraceContext;
+    endSpan(_tracedId?: string, _metadata?: Record<string, unknown>): void;
+    shutdown(): void;
+}
+//# sourceMappingURL=EimerNoopTracer.d.ts.map

package/dist/cjs/tracing/EimerNoopTracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerNoopTracer.d.ts","sourceRoot":"","sources":["../../../src/tracing/EimerNoopTracer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;GAGG;AACH,qBAAa,eAAgB,YAAW,MAAM;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAE9B,WAAW,CAAC,EAAE,WAAW;IAIrC,UAAU,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI;IAI1C,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY;IAIlG,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAItE,QAAQ,IAAI,IAAI;CAGnB"}

package/dist/cjs/tracing/EimerNoopTracer.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EimerNoopTracer = void 0;
+const EimerIdGenerator_1 = require("../id-generator/EimerIdGenerator");
+/**
+ * `Tracer` that does nothing (except id generation)
+ * Saves a bunch of if-statements wherever a tracer is optional
+ */
+class EimerNoopTracer {
+    constructor(idGenerator) {
+        this.idGenerator = idGenerator ?? new EimerIdGenerator_1.EimerIdGenerator();
+    }
+    setBackend(_backend) {
+        // no-op
+    }
+    startSpan(_name, _metadata, parent) {
+        return { traceId: parent?.traceId ?? this.idGenerator.generateId(), spanId: this.idGenerator.generateId() };
+    }
+    endSpan(_tracedId, _metadata) {
+        // no-op
+    }
+    shutdown() {
+        // no-op
+    }
+}
+exports.EimerNoopTracer = EimerNoopTracer;
+//# sourceMappingURL=EimerNoopTracer.js.map

package/dist/cjs/tracing/EimerNoopTracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerNoopTracer.js","sourceRoot":"","sources":["../../../src/tracing/EimerNoopTracer.ts"],"names":[],"mappings":";;;AAAA,uEAAoE;AAQpE;;;GAGG;AACH,MAAa,eAAe;IAGxB,YAAY,WAAyB;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,IAAI,IAAI,mCAAgB,EAAE,CAAC;IAC7D,CAAC;IAED,UAAU,CAAC,QAAwB;QAC/B,QAAQ;IACZ,CAAC;IAED,SAAS,CAAC,KAAa,EAAE,SAAmC,EAAE,MAAqB;QAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC;IAChH,CAAC;IAED,OAAO,CAAC,SAAkB,EAAE,SAAmC;QAC3D,QAAQ;IACZ,CAAC;IAED,QAAQ;QACJ,QAAQ;IACZ,CAAC;CACJ;AAtBD,0CAsBC"}

package/dist/cjs/tracing/EimerPublishingTracerBackend.d.ts

@@ -0,0 +1,17 @@
+import type { Eimer } from '../eimer/Eimer';
+import type { Topic } from '../eimer/Topic';
+import type { TracerBackend } from '../eimer/TracerBackend';
+import type { TraceSpan } from '../eimer/TraceSpan';
+/**
+ * A `TracerBackend` that sends forwards spans through through an Eimer instance
+ *
+ * This backend only *sends* spans - it should be paired with `EimerTraceSubscriber`
+ * elsewhere on the Eimer mesh to *receive* and process the spans.
+ */
+export declare class EimerPublishingTracerBackend implements TracerBackend {
+    private readonly eimer;
+    private readonly topic;
+    constructor(eimer: Eimer, topic?: Topic);
+    handleSpan(span: TraceSpan): void;
+}
+//# sourceMappingURL=EimerPublishingTracerBackend.d.ts.map

package/dist/cjs/tracing/EimerPublishingTracerBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerPublishingTracerBackend.d.ts","sourceRoot":"","sources":["../../../src/tracing/EimerPublishingTracerBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;GAKG;AACH,qBAAa,4BAA6B,YAAW,aAAa;IAC9D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;gBAElB,KAAK,EAAE,KAAK,EAAE,KAAK,GAAE,KAAsB;IAKvD,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;CAGpC"}

package/dist/cjs/tracing/EimerPublishingTracerBackend.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EimerPublishingTracerBackend = void 0;
+/**
+ * A `TracerBackend` that sends forwards spans through through an Eimer instance
+ *
+ * This backend only *sends* spans - it should be paired with `EimerTraceSubscriber`
+ * elsewhere on the Eimer mesh to *receive* and process the spans.
+ */
+class EimerPublishingTracerBackend {
+    constructor(eimer, topic = 'eimer.traces') {
+        this.eimer = eimer;
+        this.topic = topic;
+    }
+    handleSpan(span) {
+        this.eimer.publish(this.topic, span);
+    }
+}
+exports.EimerPublishingTracerBackend = EimerPublishingTracerBackend;
+//# sourceMappingURL=EimerPublishingTracerBackend.js.map

package/dist/cjs/tracing/EimerPublishingTracerBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerPublishingTracerBackend.js","sourceRoot":"","sources":["../../../src/tracing/EimerPublishingTracerBackend.ts"],"names":[],"mappings":";;;AAKA;;;;;GAKG;AACH,MAAa,4BAA4B;IAIrC,YAAY,KAAY,EAAE,QAAe,cAAc;QACnD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,UAAU,CAAC,IAAe;QACtB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;CACJ;AAZD,oEAYC"}

package/dist/cjs/tracing/EimerTraceSubscriber.d.ts

@@ -0,0 +1,17 @@
+import type { Eimer } from '../eimer/Eimer';
+import type { Topic } from '../eimer/Topic';
+import type { TracerBackend } from '../eimer/TracerBackend';
+/**
+ * The companion to `EimerPublishingTracerBackend`.
+ *
+ * Subscribes to the Eimer traces on `topic` and forwards every received
+ *  `TraceSpan` into its configured `backend`
+ */
+export declare class EimerTraceSubscriber {
+    private readonly backend;
+    private readonly unsubscribe;
+    constructor(eimer: Eimer, backend: TracerBackend, topic?: Topic);
+    /** Stop receiving spans and unsubscribe from `topic`. */
+    stop(): void;
+}
+//# sourceMappingURL=EimerTraceSubscriber.d.ts.map

package/dist/cjs/tracing/EimerTraceSubscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerTraceSubscriber.d.ts","sourceRoot":"","sources":["../../../src/tracing/EimerTraceSubscriber.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG5D;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;gBAE7B,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,GAAE,KAAsB;IAO/E,yDAAyD;IACzD,IAAI,IAAI,IAAI;CAGf"}

package/dist/cjs/tracing/EimerTraceSubscriber.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EimerTraceSubscriber = void 0;
+/**
+ * The companion to `EimerPublishingTracerBackend`.
+ *
+ * Subscribes to the Eimer traces on `topic` and forwards every received
+ *  `TraceSpan` into its configured `backend`
+ */
+class EimerTraceSubscriber {
+    constructor(eimer, backend, topic = 'eimer.traces') {
+        this.backend = backend;
+        this.unsubscribe = eimer.subscribe(topic, (payload) => {
+            this.backend.handleSpan(payload);
+        });
+    }
+    /** Stop receiving spans and unsubscribe from `topic`. */
+    stop() {
+        this.unsubscribe();
+    }
+}
+exports.EimerTraceSubscriber = EimerTraceSubscriber;
+//# sourceMappingURL=EimerTraceSubscriber.js.map

package/dist/cjs/tracing/EimerTraceSubscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerTraceSubscriber.js","sourceRoot":"","sources":["../../../src/tracing/EimerTraceSubscriber.ts"],"names":[],"mappings":";;;AAKA;;;;;GAKG;AACH,MAAa,oBAAoB;IAI7B,YAAY,KAAY,EAAE,OAAsB,EAAE,QAAe,cAAc;QAC3E,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YAClD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAoB,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACP,CAAC;IAED,yDAAyD;IACzD,IAAI;QACA,IAAI,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;CACJ;AAfD,oDAeC"}

package/dist/cjs/tracing/EimerTracer.d.ts

@@ -0,0 +1,21 @@
+import type { IdGenerator } from '../eimer/IdGenerator';
+import type { TraceContext } from '../eimer/TraceContext';
+import type { Tracer } from '../eimer/Tracer';
+import type { TracerBackend } from '../eimer/TracerBackend';
+/**
+ * A reference `Tracer` implementation.
+ *
+ * Keeps open spans in memory until they are "end"-ed and then
+ * forwards them to its `TracerBackend`
+ */
+export declare class EimerTracer implements Tracer {
+    private backend;
+    private readonly idGenerator;
+    private readonly openSpans;
+    constructor(backend?: TracerBackend, idGenerator?: IdGenerator);
+    setBackend(backend: TracerBackend): void;
+    startSpan(name: string, metadata?: Record<string, unknown>, parent?: TraceContext): TraceContext;
+    endSpan(spanId: string, metadata?: Record<string, unknown>): void;
+    shutdown(): void;
+}
+//# sourceMappingURL=EimerTracer.d.ts.map

package/dist/cjs/tracing/EimerTracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerTracer.d.ts","sourceRoot":"","sources":["../../../src/tracing/EimerTracer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG5D;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,MAAM;IACtC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;gBAEnD,OAAO,CAAC,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,WAAW;IAK9D,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAIxC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY;IAehG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAqBjE,QAAQ,IAAI,IAAI;CAGnB"}

package/dist/cjs/tracing/EimerTracer.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EimerTracer = void 0;
+const now_1 = require("./now");
+const MemoryTracerBackend_1 = require("./MemoryTracerBackend");
+const EimerIdGenerator_1 = require("../id-generator/EimerIdGenerator");
+/**
+ * A reference `Tracer` implementation.
+ *
+ * Keeps open spans in memory until they are "end"-ed and then
+ * forwards them to its `TracerBackend`
+ */
+class EimerTracer {
+    constructor(backend, idGenerator) {
+        this.openSpans = new Map();
+        this.backend = backend ?? new MemoryTracerBackend_1.MemoryTracerBackend();
+        this.idGenerator = idGenerator ?? new EimerIdGenerator_1.EimerIdGenerator();
+    }
+    setBackend(backend) {
+        this.backend = backend;
+    }
+    startSpan(name, metadata, parent) {
+        const traceId = parent?.traceId ?? this.idGenerator.generateId();
+        const spanId = this.idGenerator.generateId();
+        this.openSpans.set(spanId, {
+            traceId,
+            spanId,
+            ...(parent?.spanId ? { parentSpanId: parent?.spanId } : {}),
+            name,
+            ...(metadata ? { metadata } : {}),
+            startedAt: (0, now_1.now)(),
+            durationMs: 0,
+        });
+        return { traceId, spanId };
+    }
+    endSpan(spanId, metadata) {
+        const openSpan = this.openSpans.get(spanId);
+        if (!openSpan) {
+            return;
+        }
+        this.openSpans.delete(spanId);
+        const mergedMetadata = (openSpan.metadata || metadata) ? { ...openSpan.metadata, ...metadata } : undefined;
+        const span = {
+            traceId: openSpan.traceId,
+            spanId,
+            ...(openSpan.parentSpanId ? { parentSpanId: openSpan.parentSpanId } : {}),
+            name: openSpan.name,
+            ...(mergedMetadata ? { metadata: mergedMetadata } : {}),
+            startedAt: openSpan.startedAt,
+            durationMs: (0, now_1.now)() - openSpan.startedAt,
+        };
+        this.backend.handleSpan(span);
+    }
+    shutdown() {
+        this.backend.shutdown?.();
+    }
+}
+exports.EimerTracer = EimerTracer;
+//# sourceMappingURL=EimerTracer.js.map

package/dist/cjs/tracing/EimerTracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EimerTracer.js","sourceRoot":"","sources":["../../../src/tracing/EimerTracer.ts"],"names":[],"mappings":";;;AAAA,+BAA4B;AAC5B,+DAA4D;AAE5D,uEAAoE;AAQpE;;;;;GAKG;AACH,MAAa,WAAW;IAKpB,YAAY,OAAuB,EAAE,WAAyB;QAF7C,cAAS,GAA2B,IAAI,GAAG,EAAE,CAAC;QAG3D,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,IAAI,yCAAmB,EAAE,CAAC;QACpD,IAAI,CAAC,WAAW,GAAG,WAAW,IAAI,IAAI,mCAAgB,EAAE,CAAC;IAC7D,CAAC;IAED,UAAU,CAAC,OAAsB;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,QAAkC,EAAE,MAAqB;QAC7E,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;QAC7C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE;YACvB,OAAO;YACP,MAAM;YACN,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,IAAI;YACJ,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjC,SAAS,EAAE,IAAA,SAAG,GAAE;YAChB,UAAU,EAAE,CAAC;SAChB,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO,CAAC,MAAc,EAAE,QAAkC;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,OAAO;QACX,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE9B,MAAM,cAAc,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAE3G,MAAM,IAAI,GAAc;YACpB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,MAAM;YACN,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,UAAU,EAAE,IAAA,SAAG,GAAE,GAAG,QAAQ,CAAC,SAAS;SACzC,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,QAAQ;QACJ,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC9B,CAAC;CACJ;AArDD,kCAqDC"}

package/dist/cjs/tracing/MemoryTracerBackend.d.ts

@@ -0,0 +1,14 @@
+import type { TracerBackend } from '../eimer/TracerBackend';
+import type { TraceSpan } from '../eimer/TraceSpan';
+/**
+ * A `TracerBackend` that stores spans in Memory
+ *
+ * You can extract them with `getRecords`
+ */
+export declare class MemoryTracerBackend implements TracerBackend {
+    private readonly spans;
+    handleSpan(span: TraceSpan): void;
+    getRecords(): TraceSpan[];
+    clear(): void;
+}
+//# sourceMappingURL=MemoryTracerBackend.d.ts.map

package/dist/cjs/tracing/MemoryTracerBackend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryTracerBackend.d.ts","sourceRoot":"","sources":["../../../src/tracing/MemoryTracerBackend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IAEzC,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAIjC,UAAU,IAAI,SAAS,EAAE;IAIzB,KAAK,IAAI,IAAI;CAGhB"}

package/dist/cjs/tracing/MemoryTracerBackend.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryTracerBackend = void 0;
+/**
+ * A `TracerBackend` that stores spans in Memory
+ *
+ * You can extract them with `getRecords`
+ */
+class MemoryTracerBackend {
+    constructor() {
+        this.spans = [];
+    }
+    handleSpan(span) {
+        this.spans.push(span);
+    }
+    getRecords() {
+        return [...this.spans];
+    }
+    clear() {
+        this.spans.length = 0;
+    }
+}
+exports.MemoryTracerBackend = MemoryTracerBackend;
+//# sourceMappingURL=MemoryTracerBackend.js.map

package/dist/cjs/tracing/MemoryTracerBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryTracerBackend.js","sourceRoot":"","sources":["../../../src/tracing/MemoryTracerBackend.ts"],"names":[],"mappings":";;;AAGA;;;;GAIG;AACH,MAAa,mBAAmB;IAAhC;QACqB,UAAK,GAAgB,EAAE,CAAC;IAa7C,CAAC;IAXG,UAAU,CAAC,IAAe;QACtB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,UAAU;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,CAAC;CACJ;AAdD,kDAcC"}

package/dist/cjs/tracing/NoopTracer.d.ts

@@ -0,0 +1,16 @@
+import type { IdGenerator } from '../eimer/IdGenerator';
+import type { TraceContext } from '../eimer/TraceContext';
+import type { Tracer } from '../eimer/Tracer';
+/**
+ * `Tracer` that does nothing (except id generation)
+ * Saves a bunch of if's wherever a tracer is optional
+ */
+export declare class EimerNoopTracer implements Tracer {
+    private readonly idGenerator;
+    constructor(idGenerator?: IdGenerator);
+    setBackend(): void;
+    startTrace(name: string, metadata?: Record<string, unknown>, parent?: TraceContext): TraceContext;
+    endSpan(): void;
+    shutdown(): void;
+}
+//# sourceMappingURL=NoopTracer.d.ts.map

package/dist/cjs/tracing/NoopTracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoopTracer.d.ts","sourceRoot":"","sources":["../../../src/tracing/NoopTracer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;GAGG;AACH,qBAAa,eAAgB,YAAW,MAAM;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAE9B,WAAW,CAAC,EAAE,WAAW;IAIrC,UAAU,IAAI,IAAI;IAIlB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY;IAIjG,OAAO,IAAI,IAAI;IAIf,QAAQ,IAAI,IAAI;CAGnB"}

package/dist/cjs/tracing/NoopTracer.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EimerNoopTracer = void 0;
+const EimerIdGenerator_1 = require("../id-generator/EimerIdGenerator");
+/**
+ * `Tracer` that does nothing (except id generation)
+ * Saves a bunch of if's wherever a tracer is optional
+ */
+class EimerNoopTracer {
+    constructor(idGenerator) {
+        this.idGenerator = idGenerator ?? new EimerIdGenerator_1.EimerIdGenerator();
+    }
+    setBackend() {
+        // no-op
+    }
+    startTrace(name, metadata, parent) {
+        return parent || { traceId: this.idGenerator.generateId(), spanId: this.idGenerator.generateId() };
+    }
+    endSpan() {
+        // no-op
+    }
+    shutdown() {
+        // no-op
+    }
+}
+exports.EimerNoopTracer = EimerNoopTracer;
+//# sourceMappingURL=NoopTracer.js.map

package/dist/cjs/tracing/NoopTracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoopTracer.js","sourceRoot":"","sources":["../../../src/tracing/NoopTracer.ts"],"names":[],"mappings":";;;AAAA,uEAAoE;AAMpE;;;GAGG;AACH,MAAa,eAAe;IAGxB,YAAY,WAAyB;QACjC,IAAI,CAAC,WAAW,GAAG,WAAW,IAAI,IAAI,mCAAgB,EAAE,CAAC;IAC7D,CAAC;IAED,UAAU;QACN,QAAQ;IACZ,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,QAAkC,EAAE,MAAqB;QAC9E,OAAO,MAAM,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC;IACvG,CAAC;IAED,OAAO;QACH,QAAQ;IACZ,CAAC;IAED,QAAQ;QACJ,QAAQ;IACZ,CAAC;CACJ;AAtBD,0CAsBC"}

package/dist/cjs/tracing/index.d.ts

@@ -0,0 +1,9 @@
+export * from './ConsoleLoggingTracerBackend';
+export * from './EimerLoggerTracerBackend';
+export * from './EimerPublishingTracerBackend';
+export * from './EimerTracer';
+export * from './EimerTraceSubscriber';
+export * from './MemoryTracerBackend';
+export * from './EimerNoopTracer';
+export * from './now';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/tracing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tracing/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,OAAO,CAAC"}

package/dist/cjs/tracing/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ConsoleLoggingTracerBackend"), exports);
+__exportStar(require("./EimerLoggerTracerBackend"), exports);
+__exportStar(require("./EimerPublishingTracerBackend"), exports);
+__exportStar(require("./EimerTracer"), exports);
+__exportStar(require("./EimerTraceSubscriber"), exports);
+__exportStar(require("./MemoryTracerBackend"), exports);
+__exportStar(require("./EimerNoopTracer"), exports);
+__exportStar(require("./now"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/tracing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tracing/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gEAA8C;AAC9C,6DAA2C;AAC3C,iEAA+C;AAC/C,gDAA8B;AAC9B,yDAAuC;AACvC,wDAAsC;AACtC,oDAAkC;AAClC,wCAAsB"}

package/dist/cjs/tracing/now.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns a timestamp (milliseconds since the Unix epoch) accurate enough for trace timing
+ *
+ * `Date.now()` is low-resolution and affected by adjustments of the system clock.
+ *
+ * Therefore we use `performance.now()` and add `performance.timeOrigin` to make it comparable across processes.
+ */
+export declare function now(): number;
+//# sourceMappingURL=now.d.ts.map

package/dist/cjs/tracing/now.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"now.d.ts","sourceRoot":"","sources":["../../../src/tracing/now.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,GAAG,IAAI,MAAM,CAE5B"}

package/dist/cjs/tracing/now.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.now = now;
+/**
+ * Returns a timestamp (milliseconds since the Unix epoch) accurate enough for trace timing
+ *
+ * `Date.now()` is low-resolution and affected by adjustments of the system clock.
+ *
+ * Therefore we use `performance.now()` and add `performance.timeOrigin` to make it comparable across processes.
+ */
+function now() {
+    return performance.timeOrigin + performance.now();
+}
+//# sourceMappingURL=now.js.map

package/dist/cjs/tracing/now.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"now.js","sourceRoot":"","sources":["../../../src/tracing/now.ts"],"names":[],"mappings":";;AAOA,kBAEC;AATD;;;;;;GAMG;AACH,SAAgB,GAAG;IACf,OAAO,WAAW,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;AACtD,CAAC"}

package/dist/cjs/transports/EimerUtilityProcessTransport.d.ts

@@ -4,8 +4,11 @@ import { EimerMessagePortTransport, EimerMessagePortTransportDependencies, Eimer
  * - `utilityProcess` (Electron.UtilityProcess) in the main process
  * - `process.parentPort` (Electron.ParentPort) inside the utility process
  *
- * Both satisfy eimer's MessagePort duck-type at runtime; this interface exists
- * so callers don't need an `as unknown as MessagePort` cast.
+ * Note that the two sides are *not* symmetric at runtime: `UtilityProcess`
+ * delivers the raw message to its `'message'` listener, while `ParentPort`
+ * wraps it in a `MessageEvent` (`{ data, ports }`). `EimerUtilityProcessTransport`
+ * unwraps that `MessageEvent` shape internally so callers can use this type on
+ * both ends without worrying about the discrepancy.
  */
 export interface UtilityProcessPort {
     postMessage(message: any): void;

package/dist/cjs/transports/EimerUtilityProcessTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EimerUtilityProcessTransport.d.ts","sourceRoot":"","sources":["../../../src/transports/EimerUtilityProcessTransport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,qCAAqC,EAAE,gCAAgC,EAAe,MAAM,6BAA6B,CAAC;AAE9J;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IAC/B,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAAC;IAChC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5D,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;CACjE;AAED,MAAM,WAAW,mCAAoC,SAAQ,gCAAgC;CAAG;AAEhG,MAAM,WAAW,wCAAyC,SAAQ,qCAAqC;CAAG;AAE1G;;;;;;;GAOG;AACH,qBAAa,4BAA6B,SAAQ,yBAAyB;gBAC3D,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,mCAAmC,EAAE,YAAY,CAAC,EAAE,wCAAwC;CAG/I"}
+{"version":3,"file":"EimerUtilityProcessTransport.d.ts","sourceRoot":"","sources":["../../../src/transports/EimerUtilityProcessTransport.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,qCAAqC,EAAE,gCAAgC,EAAe,MAAM,6BAA6B,CAAC;AAE9J;;;;;;;;;;GAUG;AACH,MAAM,WAAW,kBAAkB;IAC/B,WAAW,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAAC;IAChC,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5D,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;CACjE;AAED,MAAM,WAAW,mCAAoC,SAAQ,gCAAgC;CAAG;AAEhG,MAAM,WAAW,wCAAyC,SAAQ,qCAAqC;CAAG;AA+B1G;;;;;;;GAOG;AACH,qBAAa,4BAA6B,SAAQ,yBAAyB;gBAC3D,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,mCAAmC,EAAE,YAAY,CAAC,EAAE,wCAAwC;CAG/I"}

package/dist/cjs/transports/EimerUtilityProcessTransport.js

@@ -1,7 +1,35 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EimerUtilityProcessTransport = void 0;
+const EimerMessage_1 = require("../eimer/EimerMessage");
 const EimerMessagePortTransport_1 = require("./EimerMessagePortTransport");
+/**
+ * Wraps a `UtilityProcessPort` so that `'message'` listeners always receive the
+ * raw eimer message, regardless of whether the underlying port delivers it directly
+ * (`Electron.UtilityProcess`) or wrapped in a `MessageEvent` (`Electron.ParentPort`).
+ */
+class MessageEventUnwrappingPort {
+    constructor(port) {
+        this.port = port;
+    }
+    postMessage(message) {
+        this.port.postMessage(message);
+    }
+    on(event, handler) {
+        this.port.on(event, (received) => {
+            if (!EimerMessage_1.EimerMessage.isEimerMessage(received) && received !== null && typeof received === 'object' && 'data' in received) {
+                handler(received.data);
+                return;
+            }
+            handler(received);
+        });
+        return this;
+    }
+    off(event, handler) {
+        this.port.off?.(event, handler);
+        return this;
+    }
+}
 /**
  * Eimer UtilityProcess Transport
  *
@@ -12,7 +40,7 @@ const EimerMessagePortTransport_1 = require("./EimerMessagePortTransport");
  */
 class EimerUtilityProcessTransport extends EimerMessagePortTransport_1.EimerMessagePortTransport {
     constructor(port, options, dependencies) {
-        super(port, { ...options, logModuleName: options?.logModuleName ?? 'EimerUtilityProcessTransport' }, dependencies);
+        super(new MessageEventUnwrappingPort(port), { ...options, logModuleName: options?.logModuleName ?? 'EimerUtilityProcessTransport' }, dependencies);
     }
 }
 exports.EimerUtilityProcessTransport = EimerUtilityProcessTransport;

package/dist/cjs/transports/EimerUtilityProcessTransport.js.map

@@ -1 +1 @@
-{"version":3,"file":"EimerUtilityProcessTransport.js","sourceRoot":"","sources":["../../../src/transports/EimerUtilityProcessTransport.ts"],"names":[],"mappings":";;;AAAA,2EAA8J;AAoB9J;;;;;;;GAOG;AACH,MAAa,4BAA6B,SAAQ,qDAAyB;IACvE,YAAY,IAAwB,EAAE,OAA6C,EAAE,YAAuD;QACxI,KAAK,CAAC,IAAmB,EAAE,EAAE,GAAG,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,IAAI,8BAA8B,EAAE,EAAE,YAAY,CAAC,CAAC;IACtI,CAAC;CACJ;AAJD,oEAIC"}
+{"version":3,"file":"EimerUtilityProcessTransport.js","sourceRoot":"","sources":["../../../src/transports/EimerUtilityProcessTransport.ts"],"names":[],"mappings":";;;AAAA,wDAAqD;AAErD,2EAA8J;AAuB9J;;;;GAIG;AACH,MAAM,0BAA0B;IAC5B,YAA6B,IAAwB;QAAxB,SAAI,GAAJ,IAAI,CAAoB;IAAG,CAAC;IAEzD,WAAW,CAAC,OAAY;QACpB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,EAAE,CAAC,KAAgB,EAAE,OAA+B;QAChD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,QAAa,EAAQ,EAAE;YACxC,IAAI,CAAC,2BAAY,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,MAAM,IAAI,QAAQ,EAAE,CAAC;gBACpH,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACvB,OAAO;YACX,CAAC;YACD,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,GAAG,CAAC,KAAgB,EAAE,OAA+B;QACjD,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAED;;;;;;;GAOG;AACH,MAAa,4BAA6B,SAAQ,qDAAyB;IACvE,YAAY,IAAwB,EAAE,OAA6C,EAAE,YAAuD;QACxI,KAAK,CAAC,IAAI,0BAA0B,CAAC,IAAI,CAAgB,EAAE,EAAE,GAAG,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,IAAI,8BAA8B,EAAE,EAAE,YAAY,CAAC,CAAC;IACtK,CAAC;CACJ;AAJD,oEAIC"}

package/dist/esm/eimer/Eimer.js

@@ -4,6 +4,7 @@ import { EimerIdGenerator } from '../id-generator/EimerIdGenerator';
 import { EimerLogger } from '../logger/EimerLogger';
 import { EimerMessageBus } from '../message-bus/EimerMessageBus';
 import { EimerRpcManager } from '../rpc/EimerRpcManager';
+import { EimerNoopTracer } from '../tracing/EimerNoopTracer';
 /**
  * Eimer main class
  *   This class represents an instance of a "node" on the Eimer "network".
@@ -28,8 +29,9 @@ export class Eimer {
         this.nodeId = nodeId;
         this.idGenerator = dependencies?.idGenerator ?? new EimerIdGenerator();
         this.logger = dependencies?.logger ?? new EimerLogger(options?.logLevel ?? LogLevel.DEBUG, options?.logModuleName ?? 'Eimer', this.nodeId);
-        this.messageBus = dependencies?.messageBus ?? new EimerMessageBus(this.nodeId, options);
-        this.rpcManager = dependencies?.rpcManager ?? new EimerRpcManager(this.nodeId, this.messageBus, options);
+        this.tracer = dependencies?.tracer ?? new EimerNoopTracer();
+        this.messageBus = dependencies?.messageBus ?? new EimerMessageBus(this.nodeId, options, { tracer: this.tracer });
+        this.rpcManager = dependencies?.rpcManager ?? new EimerRpcManager(this.nodeId, this.messageBus, options, { tracer: this.tracer });
     }
     /**
      * Connect this Eimer instance to a `Transport`
@@ -53,12 +55,13 @@ export class Eimer {
      * Will throw on errors from handler
      * @param method name of method / rpc handler
      * @param params optional params object
-     * @param timeout override timeout from constructor options for this single call
+     * @param timeoutMs override timeout, in milliseconds, from constructor options for this single call
+     * @param meta optional metadata to attach to the request
      * @returns result from invoked handler
      */
-    async callRpc(method, params, timeout) {
+    async callRpc(method, params, timeoutMs, meta) {
         this.logger.debug('Making RPC call', { method, params });
-        return this.rpcManager.call(method, params, timeout);
+        return this.rpcManager.call(method, params, timeoutMs, meta);
     }
     /**
      * Register an RPC handler
@@ -84,10 +87,17 @@ export class Eimer {
      * Will send payload to all subscribers on the topic
      * @param topic name of topic - subscribers can subscribe to it
      * @param payload payload will be sent to subscribers
+     * @param meta optional metadata to attach to the message
      */
-    publish(topic, payload) {
+    publish(topic, payload, meta) {
         this.logger.debug('Publishing message', { topic });
-        this.messageBus.publish(new EimerMessage(this.idGenerator.generateId(), this.nodeId, topic, payload));
+        if (meta?.collectEimerTraces && meta.trace) {
+            meta.trace = this.tracer.startSpan(topic, { isEimerTrace: true, node: this.nodeId, component: 'Eimer', op: 'publish' }, meta.trace);
+        }
+        this.messageBus.publish(new EimerMessage(this.idGenerator.generateId(), this.nodeId, topic, payload, meta));
+        if (meta?.collectEimerTraces && meta.trace) {
+            this.tracer.endSpan(meta?.trace?.spanId);
+        }
     }
     /**
      * Subscribe a handler function to a topic
@@ -99,7 +109,14 @@ export class Eimer {
     subscribe(topic, payloadHandler) {
         this.logger.debug('Subscribing to topic', { topic });
         const messageHandler = (message) => {
-            payloadHandler(message.payload);
+            let trace = message.meta?.trace;
+            if (message.meta?.collectEimerTraces && trace) {
+                trace = this.tracer.startSpan(topic, { isEimerTrace: true, node: this.nodeId, component: 'Eimer', op: 'handlePayload' }, trace);
+            }
+            payloadHandler(message.payload, trace ? { ...message.meta, trace } : message.meta);
+            if (message.meta?.collectEimerTraces && trace) {
+                this.tracer.endSpan(trace.spanId);
+            }
         };
         // Get or create the topic's handler map
         let topicHandlerMap = this.handlerMap.get(topic);
@@ -160,12 +177,13 @@ export class Eimer {
     }
     /**
      * Shutdown this Eimer instance
-     * Will reject all RPC requests that are still waiting for a response
-     * and shutdown the MessageBus
+     * Will reject all RPC requests that are still waiting for a response,
+     * shutdown the MessageBus, and shutdown the Tracer
      */
     shutdown() {
         this.rpcManager.shutdown();
         this.messageBus.shutdown();
+        this.tracer.shutdown();
     }
 }
 //# sourceMappingURL=Eimer.js.map