@ddd-ts-kit/tracing 0.0.0-stage → 0.1.1

package/dist/processors/ended-span.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ended-span.js","sourceRoot":"","sources":["../../src/processors/ended-span.ts"],"names":[],"mappings":""}

package/dist/processors/error-message-scrubber.d.ts

@@ -0,0 +1,13 @@
+import type { EndedSpan } from './ended-span.js';
+/**
+ * Removes what `recordException` and instrumentations copy from an error: the
+ * `exception.message` and `exception.stacktrace` event attributes and the status
+ * message. `exception.type` stays.
+ */
+export declare class ErrorMessageScrubber {
+    onStart(): void;
+    onEnd(span: EndedSpan): void;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=error-message-scrubber.d.ts.map

package/dist/processors/error-message-scrubber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-message-scrubber.d.ts","sourceRoot":"","sources":["../../src/processors/error-message-scrubber.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,IAAI,IAAI,CAAG;IAElB,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAW3B;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAE9B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;CACnC"}

package/dist/processors/error-message-scrubber.js

@@ -0,0 +1,21 @@
+/**
+ * Removes what `recordException` and instrumentations copy from an error: the
+ * `exception.message` and `exception.stacktrace` event attributes and the status
+ * message. `exception.type` stays.
+ */
+export class ErrorMessageScrubber {
+    onStart() { }
+    onEnd(span) {
+        for (const event of span.events) {
+            if (event.attributes === undefined) {
+                continue;
+            }
+            delete event.attributes['exception.message'];
+            delete event.attributes['exception.stacktrace'];
+        }
+        delete span.status.message;
+    }
+    async forceFlush() { }
+    async shutdown() { }
+}
+//# sourceMappingURL=error-message-scrubber.js.map

package/dist/processors/error-message-scrubber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-message-scrubber.js","sourceRoot":"","sources":["../../src/processors/error-message-scrubber.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IAC/B,OAAO,KAAU,CAAC;IAElB,KAAK,CAAC,IAAe;QACnB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACnC,SAAS;YACX,CAAC;YAED,OAAO,KAAK,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;YAC7C,OAAO,KAAK,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,UAAU,KAAmB,CAAC;IAEpC,KAAK,CAAC,QAAQ,KAAmB,CAAC;CACnC"}

package/dist/processors/url-secret-span-processor.d.ts

@@ -0,0 +1,12 @@
+import type { EndedSpan } from './ended-span.js';
+/**
+ * Redacts credentials from URLs recorded by HTTP instrumentations: query string values
+ * (names are kept) and userinfo, in `url.full`, `http.url` and `url.query`.
+ */
+export declare class UrlSecretSpanProcessor {
+    onStart(): void;
+    onEnd(span: EndedSpan): void;
+    forceFlush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=url-secret-span-processor.d.ts.map

package/dist/processors/url-secret-span-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-secret-span-processor.d.ts","sourceRoot":"","sources":["../../src/processors/url-secret-span-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAOjD;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,OAAO,IAAI,IAAI,CAAG;IAElB,KAAK,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAgB3B;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAE9B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;CACnC"}

package/dist/processors/url-secret-span-processor.js

@@ -0,0 +1,47 @@
+const REDACTED = 'REDACTED';
+const URL_ATTRIBUTES = ['url.full', 'http.url'];
+const QUERY_ATTRIBUTE = 'url.query';
+const USERINFO = /^([A-Za-z][A-Za-z0-9+.-]*:\/\/)[^/?#@]*@/;
+/**
+ * Redacts credentials from URLs recorded by HTTP instrumentations: query string values
+ * (names are kept) and userinfo, in `url.full`, `http.url` and `url.query`.
+ */
+export class UrlSecretSpanProcessor {
+    onStart() { }
+    onEnd(span) {
+        for (const key of URL_ATTRIBUTES) {
+            const value = span.attributes[key];
+            if (typeof value === 'string') {
+                span.attributes[key] = redactUrl(value);
+            }
+        }
+        const query = span.attributes[QUERY_ATTRIBUTE];
+        if (typeof query === 'string') {
+            const body = query.startsWith('?') ? query.slice(1) : query;
+            span.attributes[QUERY_ATTRIBUTE] = `${query.startsWith('?') ? '?' : ''}${redactQuery(body)}`;
+        }
+    }
+    async forceFlush() { }
+    async shutdown() { }
+}
+// Plain string surgery instead of `new URL`: the attribute may hold a relative or
+// malformed URL, and it must be redacted all the same.
+function redactUrl(url) {
+    const hashAt = url.indexOf('#');
+    const fragment = hashAt === -1 ? '' : url.slice(hashAt);
+    const withoutFragment = hashAt === -1 ? url : url.slice(0, hashAt);
+    const queryAt = withoutFragment.indexOf('?');
+    const base = queryAt === -1 ? withoutFragment : withoutFragment.slice(0, queryAt);
+    const query = queryAt === -1 ? '' : `?${redactQuery(withoutFragment.slice(queryAt + 1))}`;
+    return `${base.replace(USERINFO, `$1${REDACTED}:${REDACTED}@`)}${query}${fragment}`;
+}
+function redactQuery(query) {
+    return query
+        .split('&')
+        .map((pair) => {
+        const equals = pair.indexOf('=');
+        return equals === -1 ? pair : `${pair.slice(0, equals)}=${REDACTED}`;
+    })
+        .join('&');
+}
+//# sourceMappingURL=url-secret-span-processor.js.map

package/dist/processors/url-secret-span-processor.js.map

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

package/dist/propagation/capture-traceparent.d.ts

@@ -0,0 +1,3 @@
+/** W3C `traceparent` of the active span, to store on an outgoing message. */
+export declare function captureTraceparent(): string | undefined;
+//# sourceMappingURL=capture-traceparent.d.ts.map

package/dist/propagation/capture-traceparent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-traceparent.d.ts","sourceRoot":"","sources":["../../src/propagation/capture-traceparent.ts"],"names":[],"mappings":"AAGA,6EAA6E;AAC7E,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAEvD"}

package/dist/propagation/capture-traceparent.js

@@ -0,0 +1,7 @@
+import { context } from '@opentelemetry/api';
+import { traceparentFromContext } from './traceparent-from-context.js';
+/** W3C `traceparent` of the active span, to store on an outgoing message. */
+export function captureTraceparent() {
+    return traceparentFromContext(context.active());
+}
+//# sourceMappingURL=capture-traceparent.js.map

package/dist/propagation/capture-traceparent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-traceparent.js","sourceRoot":"","sources":["../../src/propagation/capture-traceparent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,6EAA6E;AAC7E,MAAM,UAAU,kBAAkB;IAChC,OAAO,sBAAsB,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAClD,CAAC"}

package/dist/propagation/context-with-traceparent.d.ts

@@ -0,0 +1,4 @@
+import { type Context } from '@opentelemetry/api';
+/** `base` with the remote span as parent, or `base` itself when there is none. */
+export declare function contextWithTraceparent(base: Context, traceparent: string | undefined): Context;
+//# sourceMappingURL=context-with-traceparent.d.ts.map

package/dist/propagation/context-with-traceparent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-with-traceparent.d.ts","sourceRoot":"","sources":["../../src/propagation/context-with-traceparent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGzD,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAI9F"}

package/dist/propagation/context-with-traceparent.js

@@ -0,0 +1,8 @@
+import { trace } from '@opentelemetry/api';
+import { spanContextFromTraceparent } from './span-context-from-traceparent.js';
+/** `base` with the remote span as parent, or `base` itself when there is none. */
+export function contextWithTraceparent(base, traceparent) {
+    const remote = traceparent === undefined ? undefined : spanContextFromTraceparent(traceparent);
+    return remote === undefined ? base : trace.setSpanContext(base, remote);
+}
+//# sourceMappingURL=context-with-traceparent.js.map

package/dist/propagation/context-with-traceparent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-with-traceparent.js","sourceRoot":"","sources":["../../src/propagation/context-with-traceparent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAgB,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAEhF,kFAAkF;AAClF,MAAM,UAAU,sBAAsB,CAAC,IAAa,EAAE,WAA+B;IACnF,MAAM,MAAM,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,0BAA0B,CAAC,WAAW,CAAC,CAAC;IAE/F,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC1E,CAAC"}

package/dist/propagation/run-with-traceparent.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Runs `fn` so that spans it starts continue the trace named by `traceparent`. With a
+ * missing or malformed value, `fn` runs in the current context.
+ */
+export declare function runWithTraceparent<T>(traceparent: string | undefined, fn: () => T): T;
+//# sourceMappingURL=run-with-traceparent.d.ts.map

package/dist/propagation/run-with-traceparent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-with-traceparent.d.ts","sourceRoot":"","sources":["../../src/propagation/run-with-traceparent.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAErF"}

package/dist/propagation/run-with-traceparent.js

@@ -0,0 +1,10 @@
+import { context } from '@opentelemetry/api';
+import { contextWithTraceparent } from './context-with-traceparent.js';
+/**
+ * Runs `fn` so that spans it starts continue the trace named by `traceparent`. With a
+ * missing or malformed value, `fn` runs in the current context.
+ */
+export function runWithTraceparent(traceparent, fn) {
+    return context.with(contextWithTraceparent(context.active(), traceparent), fn);
+}
+//# sourceMappingURL=run-with-traceparent.js.map

package/dist/propagation/run-with-traceparent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-with-traceparent.js","sourceRoot":"","sources":["../../src/propagation/run-with-traceparent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAI,WAA+B,EAAE,EAAW;IAChF,OAAO,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC;AACjF,CAAC"}

package/dist/propagation/span-context-from-traceparent.d.ts

@@ -0,0 +1,4 @@
+import { type SpanContext } from '@opentelemetry/api';
+/** Parses a `traceparent`. Returns undefined for anything malformed or all-zero ids. */
+export declare function spanContextFromTraceparent(traceparent: string): SpanContext | undefined;
+//# sourceMappingURL=span-context-from-traceparent.d.ts.map

package/dist/propagation/span-context-from-traceparent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-context-from-traceparent.d.ts","sourceRoot":"","sources":["../../src/propagation/span-context-from-traceparent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAM1E,wFAAwF;AACxF,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAqBvF"}

package/dist/propagation/span-context-from-traceparent.js

@@ -0,0 +1,23 @@
+import { isSpanContextValid } from '@opentelemetry/api';
+// Version 00 only, lowercase hex, exact lengths: an event is stored and replayed, so a
+// malformed value is dropped instead of being interpreted leniently.
+const TRACEPARENT = /^00-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;
+/** Parses a `traceparent`. Returns undefined for anything malformed or all-zero ids. */
+export function spanContextFromTraceparent(traceparent) {
+    const match = TRACEPARENT.exec(traceparent);
+    if (match === null) {
+        return undefined;
+    }
+    const [, traceId, spanId, flags] = match;
+    if (traceId === undefined || spanId === undefined || flags === undefined) {
+        return undefined;
+    }
+    const spanContext = {
+        traceId,
+        spanId,
+        traceFlags: Number.parseInt(flags, 16),
+        isRemote: true,
+    };
+    return isSpanContextValid(spanContext) ? spanContext : undefined;
+}
+//# sourceMappingURL=span-context-from-traceparent.js.map

package/dist/propagation/span-context-from-traceparent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span-context-from-traceparent.js","sourceRoot":"","sources":["../../src/propagation/span-context-from-traceparent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAoB,MAAM,oBAAoB,CAAC;AAE1E,uFAAuF;AACvF,qEAAqE;AACrE,MAAM,WAAW,GAAG,kDAAkD,CAAC;AAEvE,wFAAwF;AACxF,MAAM,UAAU,0BAA0B,CAAC,WAAmB;IAC5D,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAE5C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;IAEzC,IAAI,OAAO,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACzE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,WAAW,GAAgB;QAC/B,OAAO;QACP,MAAM;QACN,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;QACtC,QAAQ,EAAE,IAAI;KACf,CAAC;IAEF,OAAO,kBAAkB,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC"}

package/dist/propagation/traceparent-from-context.d.ts

@@ -0,0 +1,4 @@
+import { type Context } from '@opentelemetry/api';
+/** W3C `traceparent` of the span carried by `ctx`, if any. */
+export declare function traceparentFromContext(ctx: Context): string | undefined;
+//# sourceMappingURL=traceparent-from-context.d.ts.map

package/dist/propagation/traceparent-from-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceparent-from-context.d.ts","sourceRoot":"","sources":["../../src/propagation/traceparent-from-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7E,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAUvE"}

package/dist/propagation/traceparent-from-context.js

@@ -0,0 +1,11 @@
+import { isSpanContextValid, trace } from '@opentelemetry/api';
+/** W3C `traceparent` of the span carried by `ctx`, if any. */
+export function traceparentFromContext(ctx) {
+    const spanContext = trace.getSpanContext(ctx);
+    if (spanContext === undefined || !isSpanContextValid(spanContext)) {
+        return undefined;
+    }
+    const flags = (spanContext.traceFlags & 0xff).toString(16).padStart(2, '0');
+    return `00-${spanContext.traceId}-${spanContext.spanId}-${flags}`;
+}
+//# sourceMappingURL=traceparent-from-context.js.map

package/dist/propagation/traceparent-from-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceparent-from-context.js","sourceRoot":"","sources":["../../src/propagation/traceparent-from-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAgB,MAAM,oBAAoB,CAAC;AAE7E,8DAA8D;AAC9D,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,MAAM,WAAW,GAAG,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAE9C,IAAI,WAAW,KAAK,SAAS,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;QAClE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,WAAW,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE5E,OAAO,MAAM,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;AACpE,CAAC"}

package/dist/span/constructor-name.d.ts

@@ -0,0 +1,3 @@
+/** Read without trusting the type: an object created without prototype has no constructor. */
+export declare function constructorName(value: object): unknown;
+//# sourceMappingURL=constructor-name.d.ts.map

package/dist/span/constructor-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructor-name.d.ts","sourceRoot":"","sources":["../../src/span/constructor-name.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAStD"}

package/dist/span/constructor-name.js

@@ -0,0 +1,9 @@
+/** Read without trusting the type: an object created without prototype has no constructor. */
+export function constructorName(value) {
+    const constructor = Reflect.get(value, 'constructor');
+    const named = (typeof constructor === 'object' || typeof constructor === 'function') &&
+        constructor !== null &&
+        'name' in constructor;
+    return named ? constructor.name : undefined;
+}
+//# sourceMappingURL=constructor-name.js.map

package/dist/span/constructor-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructor-name.js","sourceRoot":"","sources":["../../src/span/constructor-name.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,WAAW,GAAY,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAE/D,MAAM,KAAK,GACT,CAAC,OAAO,WAAW,KAAK,QAAQ,IAAI,OAAO,WAAW,KAAK,UAAU,CAAC;QACtE,WAAW,KAAK,IAAI;QACpB,MAAM,IAAI,WAAW,CAAC;IAExB,OAAO,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC"}

package/dist/span/failed-traces.d.ts

@@ -0,0 +1,2 @@
+export declare const failedTraces: WeakMap<object, string>;
+//# sourceMappingURL=failed-traces.d.ts.map

package/dist/span/failed-traces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failed-traces.d.ts","sourceRoot":"","sources":["../../src/span/failed-traces.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,YAAY,yBAAgC,CAAC"}

package/dist/span/failed-traces.js

@@ -0,0 +1,3 @@
+// The trace a thrown error failed in, for a report made once its spans are over (a job, a dead letter).
+export const failedTraces = new WeakMap();
+//# sourceMappingURL=failed-traces.js.map

package/dist/span/failed-traces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failed-traces.js","sourceRoot":"","sources":["../../src/span/failed-traces.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,EAAkB,CAAC"}

package/dist/span/in-span.d.ts

@@ -0,0 +1,12 @@
+import { type Context, type Span, type SpanOptions } from '@opentelemetry/api';
+export interface SpanStart {
+    readonly name: string;
+    readonly options?: SpanOptions;
+    /** Defaults to the active context. */
+    readonly parent?: Context;
+    /** What the span says of a failure. Defaults to `markSpanFailed`: status ERROR, class and code. */
+    readonly onFailure?: (span: Span, error: unknown) => void;
+}
+/** Runs asynchronous work in a span that ends with it. A failure goes on untouched. */
+export declare function inSpan<T>(start: SpanStart, work: (span: Span) => Promise<T>): Promise<T>;
+//# sourceMappingURL=in-span.d.ts.map

package/dist/span/in-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-span.d.ts","sourceRoot":"","sources":["../../src/span/in-span.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAI/F,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,mGAAmG;IACnG,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3D;AAED,uFAAuF;AACvF,wBAAsB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAa9F"}

package/dist/span/in-span.js

@@ -0,0 +1,19 @@
+import { context, trace } from '@opentelemetry/api';
+import { markSpanFailed } from './mark-span-failed.js';
+import { tracer } from './tracer.js';
+/** Runs asynchronous work in a span that ends with it. A failure goes on untouched. */
+export async function inSpan(start, work) {
+    const parent = start.parent ?? context.active();
+    const span = tracer().startSpan(start.name, start.options ?? {}, parent);
+    try {
+        return await context.with(trace.setSpan(parent, span), () => work(span));
+    }
+    catch (error) {
+        (start.onFailure ?? markSpanFailed)(span, error);
+        throw error;
+    }
+    finally {
+        span.end();
+    }
+}
+//# sourceMappingURL=in-span.js.map

package/dist/span/in-span.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-span.js","sourceRoot":"","sources":["../../src/span/in-span.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAA6C,MAAM,oBAAoB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAWrC,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,MAAM,CAAI,KAAgB,EAAE,IAAgC;IAChF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IAEzE,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,CAAC,KAAK,CAAC,SAAS,IAAI,cAAc,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAEjD,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,GAAG,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/span/is-thenable.d.ts

@@ -0,0 +1,2 @@
+export declare function isThenable(value: unknown): value is PromiseLike<unknown>;
+//# sourceMappingURL=is-thenable.d.ts.map

package/dist/span/is-thenable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-thenable.d.ts","sourceRoot":"","sources":["../../src/span/is-thenable.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAAC,OAAO,CAAC,CAOxE"}

package/dist/span/is-thenable.js

@@ -0,0 +1,7 @@
+export function isThenable(value) {
+    return ((typeof value === 'object' || typeof value === 'function') &&
+        value !== null &&
+        'then' in value &&
+        typeof value.then === 'function');
+}
+//# sourceMappingURL=is-thenable.js.map

package/dist/span/is-thenable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-thenable.js","sourceRoot":"","sources":["../../src/span/is-thenable.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,CACL,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;QAC1D,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,CACjC,CAAC;AACJ,CAAC"}

package/dist/span/mark-span-failed.d.ts

@@ -0,0 +1,4 @@
+import { type Span } from '@opentelemetry/api';
+/** Deliberately no `recordException` and no status message: both would carry the message. */
+export declare function markSpanFailed(span: Span, error: unknown): void;
+//# sourceMappingURL=mark-span-failed.d.ts.map

package/dist/span/mark-span-failed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-span-failed.d.ts","sourceRoot":"","sources":["../../src/span/mark-span-failed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuD,KAAK,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAOpG,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAI/D"}

package/dist/span/mark-span-failed.js

@@ -0,0 +1,36 @@
+import { SpanStatusCode, isSpanContextValid } from '@opentelemetry/api';
+import { constructorName } from './constructor-name.js';
+import { failedTraces } from './failed-traces.js';
+import { refusalCode } from './refusal-code.js';
+const IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/** Deliberately no `recordException` and no status message: both would carry the message. */
+export function markSpanFailed(span, error) {
+    span.setStatus({ code: SpanStatusCode.ERROR });
+    span.setAttributes(errorAttributes(error));
+    remember(span, error);
+}
+/**
+ * What a span may say about a failure. Messages and stacks quote data (ids, emails,
+ * SQL), so only an identifier-shaped class name and a code-shaped `code` get through.
+ */
+function errorAttributes(error) {
+    if (typeof error !== 'object' || error === null) {
+        return {};
+    }
+    const className = constructorName(error);
+    return { ...(isIdentifier(className) ? { 'error.type': className } : {}), ...refusalCode(error) };
+}
+function isIdentifier(value) {
+    return typeof value === 'string' && IDENTIFIER.test(value);
+}
+/** The innermost span sees the error first: the trace it names is the one the failure happened in. */
+function remember(span, error) {
+    const spanContext = span.spanContext();
+    if (typeof error !== 'object' || error === null || failedTraces.has(error)) {
+        return;
+    }
+    if (isSpanContextValid(spanContext)) {
+        failedTraces.set(error, spanContext.traceId);
+    }
+}
+//# sourceMappingURL=mark-span-failed.js.map

package/dist/span/mark-span-failed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-span-failed.js","sourceRoot":"","sources":["../../src/span/mark-span-failed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAA8B,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,UAAU,GAAG,0BAA0B,CAAC;AAE9C,6FAA6F;AAC7F,MAAM,UAAU,cAAc,CAAC,IAAU,EAAE,KAAc;IACvD,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/C,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAEzC,OAAO,EAAE,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;AACpG,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,sGAAsG;AACtG,SAAS,QAAQ,CAAC,IAAU,EAAE,KAAc;IAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAEvC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3E,OAAO;IACT,CAAC;IAED,IAAI,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;QACpC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/span/outcome-attribute.d.ts

@@ -0,0 +1,3 @@
+/** `succeeded`, `refused` (a business answer), `failed`, and for a consumed event `dead-lettered`. */
+export declare const OUTCOME_ATTRIBUTE = "app.outcome";
+//# sourceMappingURL=outcome-attribute.d.ts.map

package/dist/span/outcome-attribute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome-attribute.d.ts","sourceRoot":"","sources":["../../src/span/outcome-attribute.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,eAAO,MAAM,iBAAiB,gBAAgB,CAAC"}

package/dist/span/outcome-attribute.js

@@ -0,0 +1,3 @@
+/** `succeeded`, `refused` (a business answer), `failed`, and for a consumed event `dead-lettered`. */
+export const OUTCOME_ATTRIBUTE = 'app.outcome';
+//# sourceMappingURL=outcome-attribute.js.map

package/dist/span/outcome-attribute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome-attribute.js","sourceRoot":"","sources":["../../src/span/outcome-attribute.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC"}

package/dist/span/refusal-code.d.ts

@@ -0,0 +1,4 @@
+import type { Attributes } from '@opentelemetry/api';
+/** The `code` of an error as a span attribute, when it is shaped like a code: never a message. */
+export declare function refusalCode(error: unknown): Attributes;
+//# sourceMappingURL=refusal-code.d.ts.map

package/dist/span/refusal-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refusal-code.d.ts","sourceRoot":"","sources":["../../src/span/refusal-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAQtD"}

package/dist/span/refusal-code.js

@@ -0,0 +1,10 @@
+const CODE = /^[A-Za-z_][A-Za-z0-9_.:-]{0,63}$/;
+/** The `code` of an error as a span attribute, when it is shaped like a code: never a message. */
+export function refusalCode(error) {
+    if (typeof error !== 'object' || error === null || !('code' in error)) {
+        return {};
+    }
+    const { code } = error;
+    return typeof code === 'string' && CODE.test(code) ? { 'app.error.code': code } : {};
+}
+//# sourceMappingURL=refusal-code.js.map

package/dist/span/refusal-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refusal-code.js","sourceRoot":"","sources":["../../src/span/refusal-code.ts"],"names":[],"mappings":"AAEA,MAAM,IAAI,GAAG,kCAAkC,CAAC;AAEhD,kGAAkG;AAClG,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,EAAE,CAAC;QACtE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAEvB,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvF,CAAC"}

package/dist/span/tracer.d.ts

@@ -0,0 +1,4 @@
+import { type Tracer } from '@opentelemetry/api';
+/** Looked up on every use so a provider registered after wrapping is still honoured. */
+export declare function tracer(): Tracer;
+//# sourceMappingURL=tracer.d.ts.map

package/dist/span/tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/span/tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAIxD,wFAAwF;AACxF,wBAAgB,MAAM,IAAI,MAAM,CAE/B"}

package/dist/span/tracer.js

@@ -0,0 +1,7 @@
+import { trace } from '@opentelemetry/api';
+const TRACER_NAME = '@ddd-ts-kit/tracing';
+/** Looked up on every use so a provider registered after wrapping is still honoured. */
+export function tracer() {
+    return trace.getTracer(TRACER_NAME);
+}
+//# sourceMappingURL=tracer.js.map

package/dist/span/tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.js","sourceRoot":"","sources":["../../src/span/tracer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAe,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,GAAG,qBAAqB,CAAC;AAE1C,wFAAwF;AACxF,MAAM,UAAU,MAAM;IACpB,OAAO,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC"}

package/dist/span/with-span.d.ts

@@ -0,0 +1,9 @@
+import { type Attributes } from '@opentelemetry/api';
+/**
+ * Runs `fn` in a span. For the composition root and platform code only (a migration, a
+ * scheduled job, a startup step): domain and application code never call it, adapters
+ * are wrapped with `traceDependency` instead. Attributes are the caller's
+ * responsibility: no user data, no secrets.
+ */
+export declare function withSpan<T>(name: string, fn: () => T, attributes?: Attributes): T;
+//# sourceMappingURL=with-span.d.ts.map

package/dist/span/with-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-span.d.ts","sourceRoot":"","sources":["../../src/span/with-span.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKrE;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,CAAC,CAgCjF"}

package/dist/span/with-span.js

@@ -0,0 +1,36 @@
+import { context, trace } from '@opentelemetry/api';
+import { isThenable } from './is-thenable.js';
+import { markSpanFailed } from './mark-span-failed.js';
+import { tracer } from './tracer.js';
+/**
+ * Runs `fn` in a span. For the composition root and platform code only (a migration, a
+ * scheduled job, a startup step): domain and application code never call it, adapters
+ * are wrapped with `traceDependency` instead. Attributes are the caller's
+ * responsibility: no user data, no secrets.
+ */
+export function withSpan(name, fn, attributes) {
+    const parent = context.active();
+    const span = tracer().startSpan(name, attributes === undefined ? {} : { attributes }, parent);
+    let result;
+    try {
+        result = context.with(trace.setSpan(parent, span), fn);
+    }
+    catch (error) {
+        markSpanFailed(span, error);
+        span.end();
+        throw error;
+    }
+    if (!isThenable(result)) {
+        span.end();
+        return result;
+    }
+    // The promise is observed, not replaced: the caller keeps the object `fn` returned.
+    result.then(() => {
+        span.end();
+    }, (error) => {
+        markSpanFailed(span, error);
+        span.end();
+    });
+    return result;
+}
+//# sourceMappingURL=with-span.js.map

package/dist/span/with-span.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-span.js","sourceRoot":"","sources":["../../src/span/with-span.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAmB,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAI,IAAY,EAAE,EAAW,EAAE,UAAuB;IAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,MAAM,CAAC,CAAC;IAC9F,IAAI,MAAS,CAAC;IAEd,IAAI,CAAC;QACH,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,GAAG,EAAE,CAAC;QAEX,MAAM,KAAK,CAAC;IACd,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,EAAE,CAAC;QAEX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,oFAAoF;IACpF,MAAM,CAAC,IAAI,CACT,GAAG,EAAE;QACH,IAAI,CAAC,GAAG,EAAE,CAAC;IACb,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;QACjB,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,GAAG,EAAE,CAAC;IACb,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/testing/expect-span-tree.d.ts

@@ -0,0 +1,10 @@
+import type { ExpectedSpan } from './expected-span.js';
+import type { SpanNode } from './span-node.js';
+/**
+ * Asserts that a trace is exactly the tree described: the same spans, under the same parents,
+ * in the order they started, with the kinds, statuses and attributes named. On a mismatch it
+ * throws an error that lists what differs, then shows both trees with the attributes the
+ * expectation names. It depends on no test framework.
+ */
+export declare function expectSpanTree(actual: readonly SpanNode[], expected: readonly ExpectedSpan[]): void;
+//# sourceMappingURL=expect-span-tree.d.ts.map

package/dist/testing/expect-span-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expect-span-tree.d.ts","sourceRoot":"","sources":["../../src/testing/expect-span-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,QAAQ,EAAE,EAAE,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAqBnG"}

package/dist/testing/expect-span-tree.js

@@ -0,0 +1,29 @@
+import { renderSpanTree } from './render-span-tree.js';
+import { spanMismatches } from './span-mismatches.js';
+/**
+ * Asserts that a trace is exactly the tree described: the same spans, under the same parents,
+ * in the order they started, with the kinds, statuses and attributes named. On a mismatch it
+ * throws an error that lists what differs, then shows both trees with the attributes the
+ * expectation names. It depends on no test framework.
+ */
+export function expectSpanTree(actual, expected) {
+    const mismatches = spanMismatches(actual, expected);
+    if (mismatches.length === 0) {
+        return;
+    }
+    const keys = [...new Set(attributeKeys(expected))];
+    throw new Error([
+        'The trace is not the one expected.',
+        ...mismatches.map((mismatch) => `  - ${mismatch}`),
+        '',
+        'Expected:',
+        renderSpanTree(expected, keys),
+        '',
+        'Found:',
+        renderSpanTree(actual, keys),
+    ].join('\n'));
+}
+function attributeKeys(spans) {
+    return spans.flatMap((span) => [...Object.keys(span.attributes ?? {}), ...attributeKeys(span.children ?? [])]);
+}
+//# sourceMappingURL=expect-span-tree.js.map

package/dist/testing/expect-span-tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expect-span-tree.js","sourceRoot":"","sources":["../../src/testing/expect-span-tree.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAA2B,EAAE,QAAiC;IAC3F,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEpD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEnD,MAAM,IAAI,KAAK,CACb;QACE,oCAAoC;QACpC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,QAAQ,EAAE,CAAC;QAClD,EAAE;QACF,WAAW;QACX,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC;QAC9B,EAAE;QACF,QAAQ;QACR,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC;KAC7B,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAA8B;IACnD,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACjH,CAAC"}