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

package/dist/events/traced-consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traced-consumer.d.ts","sourceRoot":"","sources":["../../src/events/traced-consumer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAmC,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAMpG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,MAAM,WAAW,qBAAqB;IACpC,mGAAmG;IACnG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,iBAAiB,0BAA0B,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,wBAAwB,EACjC,OAAO,GAAE,qBAA0B,GAClC,wBAAwB,CAO1B"}

package/dist/events/traced-consumer.js

@@ -0,0 +1,65 @@
+import { SpanKind, context, trace, } from '@opentelemetry/api';
+import { CORRELATION_ID_ATTRIBUTE, ORIGIN_ATTRIBUTE } from '../local-root/correlate.js';
+import { spanContextFromTraceparent } from '../propagation/span-context-from-traceparent.js';
+import { inSpan } from '../span/in-span.js';
+import { markSpanFailed } from '../span/mark-span-failed.js';
+import { OUTCOME_ATTRIBUTE } from '../span/outcome-attribute.js';
+import { messagingAttributes } from './messaging-attributes.js';
+export const ATTEMPT_ATTRIBUTE = 'app.messaging.attempt';
+/**
+ * Wraps what a provider calls at each delivery: every attempt runs in its own CONSUMER span,
+ * which says which attempt it is, so a redelivery reads as one. A failed attempt is an error
+ * with the code of what was thrown; the attempt after which the provider gives the event up
+ * says `dead-lettered`. The span starts the unit of work: it carries the correlation id of the
+ * event. Never the payload.
+ */
+export function tracedConsumer(handler, options = {}) {
+    return async (event, delivery) => {
+        await inSpan(startOf(event, delivery, options), async (span) => {
+            await handler(event, delivery);
+            span.setAttribute(OUTCOME_ATTRIBUTE, 'succeeded');
+        });
+    };
+}
+function startOf(event, delivery, options) {
+    const producer = event.traceparent === undefined ? undefined : spanContextFromTraceparent(event.traceparent);
+    const linked = options.trace === 'link' && producer !== undefined;
+    const spanOptions = { kind: SpanKind.CONSUMER, attributes: attributesOf(event, delivery, options) };
+    return {
+        name: `process ${options.consumer ?? event.type}`,
+        options: linked ? { ...spanOptions, root: true, links: [{ context: producer }] } : spanOptions,
+        parent: parentOf(producer, linked),
+        onFailure: (span, error) => {
+            failed(span, error, delivery);
+        },
+    };
+}
+function parentOf(producer, linked) {
+    const active = context.active();
+    return producer === undefined || linked ? active : trace.setSpanContext(active, producer);
+}
+function attributesOf(event, delivery, options) {
+    const consumer = options.consumer ?? delivery?.consumer;
+    return {
+        ...messagingAttributes({ name: 'process', type: 'process', system: delivery?.system ?? options.system }, event),
+        ...(consumer === undefined ? {} : { 'messaging.consumer.group.name': consumer }),
+        ...(options.context === undefined ? {} : { 'app.context': options.context }),
+        ...deliveryAttributes(delivery),
+        [CORRELATION_ID_ATTRIBUTE]: event.correlationId ?? event.id,
+        [ORIGIN_ATTRIBUTE]: 'event',
+    };
+}
+function deliveryAttributes(delivery) {
+    const attempt = delivery?.attempt ?? 1;
+    return {
+        ...(delivery?.destination === undefined ? {} : { 'app.messaging.source': delivery.destination }),
+        [ATTEMPT_ATTRIBUTE]: attempt,
+        ...(attempt > 1 ? { 'app.messaging.redelivered': true } : {}),
+    };
+}
+function failed(span, error, delivery) {
+    const last = delivery?.maxAttempts !== undefined && delivery.attempt >= delivery.maxAttempts;
+    markSpanFailed(span, error);
+    span.setAttribute(OUTCOME_ATTRIBUTE, last ? 'dead-lettered' : 'failed');
+}
+//# sourceMappingURL=traced-consumer.js.map

package/dist/events/traced-consumer.js.map

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

package/dist/events/traced-publisher.d.ts

@@ -0,0 +1,19 @@
+import { type IntegrationEventPublisher } from '@ddd-ts-kit/kernel';
+export interface TracedPublisherOptions {
+    /** The transport, when the publisher does not name it itself (`messagingSystem`). `outbox` for one that only stores. */
+    readonly system?: string;
+}
+/**
+ * Decorates a publisher: one span per event, and its `traceparent` stamped on what goes out,
+ * so whatever handles the event next is a child of that span.
+ *
+ * A publisher that sends (`publish <type>`, PRODUCER) continues the trace the event already
+ * names: an outbox relay publishing later, from a timer and outside of any request, attaches
+ * its span to the trace of the request that stored the event, never to its own loop. A
+ * publisher that only stores (`outbox append <type>`, the operation `create`) is where that
+ * context is captured, inside the request. An event without `traceparent` continues the
+ * active span. The spans count against the caps of the local root: past them an event goes
+ * out without a span of its own, still naming the trace.
+ */
+export declare function tracedPublisher(publisher: IntegrationEventPublisher, options?: TracedPublisherOptions): IntegrationEventPublisher;
+//# sourceMappingURL=traced-publisher.d.ts.map

package/dist/events/traced-publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traced-publisher.d.ts","sourceRoot":"","sources":["../../src/events/traced-publisher.ts"],"names":[],"mappings":"AACA,OAAO,EAA4C,KAAK,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAQ9G,MAAM,WAAW,sBAAsB;IACrC,wHAAwH;IACxH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAUD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,yBAAyB,EACpC,OAAO,GAAE,sBAA2B,GACnC,yBAAyB,CAyB3B"}

package/dist/events/traced-publisher.js

@@ -0,0 +1,69 @@
+import { SpanKind, context, trace } from '@opentelemetry/api';
+import { messagingSystemOf } from '@ddd-ts-kit/kernel';
+import { admitDependencySpan } from '../local-root/admit-dependency-span.js';
+import { contextWithTraceparent } from '../propagation/context-with-traceparent.js';
+import { traceparentFromContext } from '../propagation/traceparent-from-context.js';
+import { markSpanFailed } from '../span/mark-span-failed.js';
+import { tracer } from '../span/tracer.js';
+import { messagingAttributes } from './messaging-attributes.js';
+const OUTBOX = 'outbox';
+/**
+ * Decorates a publisher: one span per event, and its `traceparent` stamped on what goes out,
+ * so whatever handles the event next is a child of that span.
+ *
+ * A publisher that sends (`publish <type>`, PRODUCER) continues the trace the event already
+ * names: an outbox relay publishing later, from a timer and outside of any request, attaches
+ * its span to the trace of the request that stored the event, never to its own loop. A
+ * publisher that only stores (`outbox append <type>`, the operation `create`) is where that
+ * context is captured, inside the request. An event without `traceparent` continues the
+ * active span. The spans count against the caps of the local root: past them an event goes
+ * out without a span of its own, still naming the trace.
+ */
+export function tracedPublisher(publisher, options = {}) {
+    const system = options.system ?? messagingSystemOf(publisher);
+    return {
+        async publish(events) {
+            const active = context.active();
+            const publications = events.map((event) => publicationOf(event, active, system));
+            const spans = publications.flatMap(({ span }) => span ?? []);
+            try {
+                // One call for the whole batch: the provider keeps its atomicity and ordering.
+                await publisher.publish(publications.map(({ event }) => event));
+            }
+            catch (error) {
+                for (const span of spans) {
+                    markSpanFailed(span, error);
+                }
+                throw error;
+            }
+            finally {
+                for (const span of spans) {
+                    span.end();
+                }
+            }
+        },
+    };
+}
+function publicationOf(event, active, system) {
+    const parent = contextWithTraceparent(active, event.traceparent);
+    const stored = system === OUTBOX;
+    const name = stored ? `outbox append ${event.type}` : `publish ${event.type}`;
+    if (!admitDependencySpan(name)) {
+        return { event: stamped(event, parent) };
+    }
+    const operation = stored
+        ? { name: 'append', type: 'create', system }
+        : { name: 'publish', type: 'send', system };
+    const options = {
+        kind: stored ? SpanKind.INTERNAL : SpanKind.PRODUCER,
+        attributes: messagingAttributes(operation, event),
+    };
+    const span = tracer().startSpan(name, options, parent);
+    return { event: stamped(event, trace.setSpan(parent, span)), span };
+}
+/** The event naming the span carried by the context, or as it is when there is none. */
+function stamped(event, from) {
+    const traceparent = traceparentFromContext(from);
+    return traceparent === undefined ? event : { ...event, traceparent };
+}
+//# sourceMappingURL=traced-publisher.js.map

package/dist/events/traced-publisher.js.map

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

package/dist/events/traced-subscriber.d.ts

@@ -0,0 +1,15 @@
+import { type IntegrationEventSubscriber } from '@ddd-ts-kit/kernel';
+import type { ConsumerTrace } from './consumer-trace.js';
+export interface TracedSubscriberOptions {
+    /** Default `continue`. */
+    readonly trace?: ConsumerTrace;
+    /** The transport, when neither the deliveries nor the subscriber (`messagingSystem`) name it. */
+    readonly system?: string;
+}
+/**
+ * Decorates a subscriber, for a composition without `kernelModule`: every handler runs in a
+ * CONSUMER span `process <type>` (see `tracedConsumer`). That span is a local root, so the
+ * per-root cap of dependency spans applies to each delivery separately.
+ */
+export declare function tracedSubscriber(subscriber: IntegrationEventSubscriber, options?: TracedSubscriberOptions): IntegrationEventSubscriber;
+//# sourceMappingURL=traced-subscriber.d.ts.map

package/dist/events/traced-subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traced-subscriber.d.ts","sourceRoot":"","sources":["../../src/events/traced-subscriber.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,0BAA0B,EAEhC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,MAAM,WAAW,uBAAuB;IACtC,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,iGAAiG;IACjG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,0BAA0B,EACtC,OAAO,GAAE,uBAA4B,GACpC,0BAA0B,CAc5B"}

package/dist/events/traced-subscriber.js

@@ -0,0 +1,19 @@
+import { messagingSystemOf, } from '@ddd-ts-kit/kernel';
+import { tracedConsumer } from './traced-consumer.js';
+/**
+ * Decorates a subscriber, for a composition without `kernelModule`: every handler runs in a
+ * CONSUMER span `process <type>` (see `tracedConsumer`). That span is a local root, so the
+ * per-root cap of dependency spans applies to each delivery separately.
+ */
+export function tracedSubscriber(subscriber, options = {}) {
+    const system = options.system ?? messagingSystemOf(subscriber);
+    return {
+        subscribe(type, handler) {
+            return subscriber.subscribe(type, tracedConsumer(handler, {
+                ...(options.trace === undefined ? {} : { trace: options.trace }),
+                ...(system === undefined ? {} : { system }),
+            }));
+        },
+    };
+}
+//# sourceMappingURL=traced-subscriber.js.map

package/dist/events/traced-subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traced-subscriber.js","sourceRoot":"","sources":["../../src/events/traced-subscriber.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAIlB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAStD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAsC,EACtC,OAAO,GAA4B,EAAE;IAErC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAE/D,OAAO;QACL,SAAS,CAAC,IAAY,EAAE,OAAiC;YACvD,OAAO,UAAU,CAAC,SAAS,CACzB,IAAI,EACJ,cAAc,CAAC,OAAO,EAAE;gBACtB,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;gBAChE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;aAC5C,CAAC,CACH,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/http/is-noise-path.d.ts

@@ -0,0 +1,3 @@
+/** Whether the path, without its query string, is one of the noise paths or below one of them. */
+export declare function isNoisePath(url: string, paths?: readonly string[]): boolean;
+//# sourceMappingURL=is-noise-path.d.ts.map

package/dist/http/is-noise-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-noise-path.d.ts","sourceRoot":"","sources":["../../src/http/is-noise-path.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,SAAS,MAAM,EAAgB,GAAG,OAAO,CAIxF"}

package/dist/http/is-noise-path.js

@@ -0,0 +1,7 @@
+import { NOISE_PATHS } from './noise-paths.js';
+/** Whether the path, without its query string, is one of the noise paths or below one of them. */
+export function isNoisePath(url, paths = NOISE_PATHS) {
+    const path = url.split('?', 1).join('');
+    return paths.some((noise) => path === noise || path.startsWith(`${noise}/`));
+}
+//# sourceMappingURL=is-noise-path.js.map

package/dist/http/is-noise-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-noise-path.js","sourceRoot":"","sources":["../../src/http/is-noise-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,kGAAkG;AAClG,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,KAAK,GAAsB,WAAW;IAC7E,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAExC,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;AAC/E,CAAC"}

package/dist/http/is-noise-route.d.ts

@@ -0,0 +1,6 @@
+/** A route nobody follows in a trace: probes, metrics, and the documentation routes of the kit. */
+export declare function isNoiseRoute(route: {
+    readonly path: string;
+    readonly operationId: string;
+}): boolean;
+//# sourceMappingURL=is-noise-route.d.ts.map

package/dist/http/is-noise-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-noise-route.d.ts","sourceRoot":"","sources":["../../src/http/is-noise-route.ts"],"names":[],"mappings":"AAIA,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAEpG"}

package/dist/http/is-noise-route.js

@@ -0,0 +1,7 @@
+import { isNoisePath } from './is-noise-path.js';
+const DOCUMENTATION_OPERATIONS = new Set(['getOpenApiDocument', 'getOpenApiUi']);
+/** A route nobody follows in a trace: probes, metrics, and the documentation routes of the kit. */
+export function isNoiseRoute(route) {
+    return DOCUMENTATION_OPERATIONS.has(route.operationId) || isNoisePath(route.path);
+}
+//# sourceMappingURL=is-noise-route.js.map

package/dist/http/is-noise-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-noise-route.js","sourceRoot":"","sources":["../../src/http/is-noise-route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC,CAAC;AAEjF,mGAAmG;AACnG,MAAM,UAAU,YAAY,CAAC,KAA8D;IACzF,OAAO,wBAAwB,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACpF,CAAC"}

package/dist/http/noise-paths.d.ts

@@ -0,0 +1,3 @@
+/** Paths that get no span by default: probes, metrics scrapes, documentation, browser plumbing. */
+export declare const NOISE_PATHS: readonly string[];
+//# sourceMappingURL=noise-paths.d.ts.map

package/dist/http/noise-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noise-paths.d.ts","sourceRoot":"","sources":["../../src/http/noise-paths.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAYxC,CAAC"}

package/dist/http/noise-paths.js

@@ -0,0 +1,15 @@
+/** Paths that get no span by default: probes, metrics scrapes, documentation, browser plumbing. */
+export const NOISE_PATHS = [
+    '/health',
+    '/healthz',
+    '/livez',
+    '/live',
+    '/ready',
+    '/readyz',
+    '/startup',
+    '/metrics',
+    '/docs',
+    '/openapi.json',
+    '/favicon.ico',
+];
+//# sourceMappingURL=noise-paths.js.map

package/dist/http/noise-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noise-paths.js","sourceRoot":"","sources":["../../src/http/noise-paths.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,CAAC,MAAM,WAAW,GAAsB;IAC5C,SAAS;IACT,UAAU;IACV,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,SAAS;IACT,UAAU;IACV,UAAU;IACV,OAAO;IACP,eAAe;IACf,cAAc;CACf,CAAC"}

package/dist/http/traced-routes.d.ts

@@ -0,0 +1,28 @@
+/** The route a request was matched to, as the HTTP pipeline of the kit describes it. */
+export interface TracedRoute {
+    readonly method: string;
+    /** The template (`/orders/:id`), never the URL that was called. */
+    readonly path: string;
+    readonly operationId: string;
+}
+/** What the pipeline answered. */
+export interface TracedResponse {
+    readonly status: number;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly body?: unknown;
+}
+export interface TracedRoutesOptions {
+    /** Routes that get no span of their own. Defaults to health, readiness, metrics and documentation routes. */
+    readonly ignore?: (route: TracedRoute) => boolean;
+}
+type Around = <R extends TracedResponse>(route: TracedRoute, respond: () => Promise<R>) => Promise<R>;
+/**
+ * The `around` hook of `@ddd-ts-kit/http` (`ExecuteOptions`): the SERVER span of each request,
+ * named by method and route template, `POST /orders/:id/lines`, never by the URL. The span an
+ * HTTP instrumentation already opened for the request is renamed and completed; without one,
+ * the span is started here. It says the operation, the status, the correlation id, and for a
+ * refusal the code of the problem answered: a 4xx is an answer, a 5xx an error.
+ */
+export declare function tracedRoutes(options?: TracedRoutesOptions): Around;
+export {};
+//# sourceMappingURL=traced-routes.d.ts.map

package/dist/http/traced-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traced-routes.d.ts","sourceRoot":"","sources":["../../src/http/traced-routes.ts"],"names":[],"mappings":"AASA,wFAAwF;AACxF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,kCAAkC;AAClC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,6GAA6G;IAC7G,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC;CACnD;AAED,KAAK,MAAM,GAAG,CAAC,CAAC,SAAS,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEtG;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CA8BtE"}

package/dist/http/traced-routes.js

@@ -0,0 +1,76 @@
+import { SpanKind, SpanStatusCode, context, trace } from '@opentelemetry/api';
+import { CORRELATION_ID_ATTRIBUTE, ORIGIN_ATTRIBUTE } from '../local-root/correlate.js';
+import { localRoots } from '../local-root/local-roots.js';
+import { markSpanFailed } from '../span/mark-span-failed.js';
+import { OUTCOME_ATTRIBUTE } from '../span/outcome-attribute.js';
+import { refusalCode } from '../span/refusal-code.js';
+import { tracer } from '../span/tracer.js';
+import { isNoiseRoute } from './is-noise-route.js';
+/**
+ * The `around` hook of `@ddd-ts-kit/http` (`ExecuteOptions`): the SERVER span of each request,
+ * named by method and route template, `POST /orders/:id/lines`, never by the URL. The span an
+ * HTTP instrumentation already opened for the request is renamed and completed; without one,
+ * the span is started here. It says the operation, the status, the correlation id, and for a
+ * refusal the code of the problem answered: a 4xx is an answer, a 5xx an error.
+ */
+export function tracedRoutes(options = {}) {
+    const ignored = options.ignore ?? isNoiseRoute;
+    return async (route, respond) => {
+        if (ignored(route)) {
+            return respond();
+        }
+        const existing = serverSpanInProgress();
+        const span = existing ?? started(route);
+        span.updateName(`${route.method} ${route.path}`);
+        span.setAttributes({ 'http.route': route.path, 'app.operation': route.operationId });
+        try {
+            const response = await context.with(trace.setSpan(context.active(), span), respond);
+            answered(span, response);
+            return response;
+        }
+        catch (error) {
+            markSpanFailed(span, error);
+            throw error;
+        }
+        finally {
+            if (existing === undefined) {
+                span.end();
+            }
+        }
+    };
+}
+/** The active span when it is the local root and a SERVER span: the one an HTTP instrumentation opened for the request. */
+function serverSpanInProgress() {
+    const active = trace.getActiveSpan();
+    if (active === undefined || !active.isRecording() || localRoots.get(active)?.span !== active) {
+        return undefined;
+    }
+    // The API of a span does not say its kind; the span of the SDK does.
+    return Reflect.get(active, 'kind') === SpanKind.SERVER ? active : undefined;
+}
+function started(route) {
+    return tracer().startSpan(`${route.method} ${route.path}`, {
+        kind: SpanKind.SERVER,
+        attributes: { 'http.request.method': route.method },
+    });
+}
+function answered(span, { status, headers, body }) {
+    const correlationId = headers['x-correlation-id'];
+    span.setAttributes({
+        'http.response.status_code': status,
+        [ORIGIN_ATTRIBUTE]: 'http',
+        ...(correlationId === undefined ? {} : { [CORRELATION_ID_ATTRIBUTE]: correlationId }),
+        [OUTCOME_ATTRIBUTE]: outcomeOf(status),
+        ...(status >= 400 ? refusalCode(body) : {}),
+    });
+    if (status >= 500) {
+        span.setStatus({ code: SpanStatusCode.ERROR });
+    }
+}
+function outcomeOf(status) {
+    if (status >= 500) {
+        return 'failed';
+    }
+    return status >= 400 ? 'refused' : 'succeeded';
+}
+//# sourceMappingURL=traced-routes.js.map

package/dist/http/traced-routes.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+export type { DependencyKind } from '@ddd-ts-kit/kernel';
+export { traceApplication, type TraceApplicationOptions, type TracedApplication, } from './application/trace-application.js';
+export { configureTracing, resetTracingConfiguration } from './configuration/configure-tracing.js';
+export { DEFAULT_LIFECYCLE_HOOKS } from './configuration/default-lifecycle-hooks.js';
+export type { TracingConfiguration } from './configuration/tracing-configuration.js';
+export { correlationIdFromActiveSpan } from './correlation/correlation-id-from-active-span.js';
+export { traceLogFields, type TraceLogFields } from './correlation/trace-log-fields.js';
+export { tracedErrorReporter } from './correlation/traced-error-reporter.js';
+export { traceBindings, type TracedBinding } from './dependency/trace-bindings.js';
+export { traceDependency, type TraceDependencyOptions } from './dependency/trace-dependency.js';
+export { tracedDomainEvents } from './domain-events/traced-domain-events.js';
+export type { ConsumerTrace } from './events/consumer-trace.js';
+export { ATTEMPT_ATTRIBUTE, tracedConsumer, type TracedConsumerOptions } from './events/traced-consumer.js';
+export { tracedPublisher, type TracedPublisherOptions } from './events/traced-publisher.js';
+export { tracedSubscriber, type TracedSubscriberOptions } from './events/traced-subscriber.js';
+export { isNoisePath } from './http/is-noise-path.js';
+export { isNoiseRoute } from './http/is-noise-route.js';
+export { NOISE_PATHS } from './http/noise-paths.js';
+export { tracedRoutes, type TracedResponse, type TracedRoute, type TracedRoutesOptions } from './http/traced-routes.js';
+export { tracedJob, type TracedJobOptions } from './jobs/traced-job.js';
+export { DROPPED_SPANS_ATTRIBUTE } from './local-root/admit-dependency-span.js';
+export { CORRELATION_ID_ATTRIBUTE, ORIGIN_ATTRIBUTE } from './local-root/correlate.js';
+export { LocalRootTracker } from './local-root/local-root-tracker.js';
+export { AttributeAllowList, type AttributeAllowListOptions } from './processors/attribute-allow-list.js';
+export { DEFAULT_ALLOWED_ATTRIBUTES } from './processors/default-allowed-attributes.js';
+export type { EndedSpan } from './processors/ended-span.js';
+export { ErrorMessageScrubber } from './processors/error-message-scrubber.js';
+export { UrlSecretSpanProcessor } from './processors/url-secret-span-processor.js';
+export { captureTraceparent } from './propagation/capture-traceparent.js';
+export { runWithTraceparent } from './propagation/run-with-traceparent.js';
+export { spanContextFromTraceparent } from './propagation/span-context-from-traceparent.js';
+export { traceparentFromContext } from './propagation/traceparent-from-context.js';
+export { OUTCOME_ATTRIBUTE } from './span/outcome-attribute.js';
+export { withSpan } from './span/with-span.js';
+export { traceUseCases } from './use-case/trace-use-cases.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACnG,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,YAAY,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAC5G,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACxH,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAC1G,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,YAAY,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/index.js

@@ -0,0 +1,32 @@
+export { traceApplication, } from './application/trace-application.js';
+export { configureTracing, resetTracingConfiguration } from './configuration/configure-tracing.js';
+export { DEFAULT_LIFECYCLE_HOOKS } from './configuration/default-lifecycle-hooks.js';
+export { correlationIdFromActiveSpan } from './correlation/correlation-id-from-active-span.js';
+export { traceLogFields } from './correlation/trace-log-fields.js';
+export { tracedErrorReporter } from './correlation/traced-error-reporter.js';
+export { traceBindings } from './dependency/trace-bindings.js';
+export { traceDependency } from './dependency/trace-dependency.js';
+export { tracedDomainEvents } from './domain-events/traced-domain-events.js';
+export { ATTEMPT_ATTRIBUTE, tracedConsumer } from './events/traced-consumer.js';
+export { tracedPublisher } from './events/traced-publisher.js';
+export { tracedSubscriber } from './events/traced-subscriber.js';
+export { isNoisePath } from './http/is-noise-path.js';
+export { isNoiseRoute } from './http/is-noise-route.js';
+export { NOISE_PATHS } from './http/noise-paths.js';
+export { tracedRoutes } from './http/traced-routes.js';
+export { tracedJob } from './jobs/traced-job.js';
+export { DROPPED_SPANS_ATTRIBUTE } from './local-root/admit-dependency-span.js';
+export { CORRELATION_ID_ATTRIBUTE, ORIGIN_ATTRIBUTE } from './local-root/correlate.js';
+export { LocalRootTracker } from './local-root/local-root-tracker.js';
+export { AttributeAllowList } from './processors/attribute-allow-list.js';
+export { DEFAULT_ALLOWED_ATTRIBUTES } from './processors/default-allowed-attributes.js';
+export { ErrorMessageScrubber } from './processors/error-message-scrubber.js';
+export { UrlSecretSpanProcessor } from './processors/url-secret-span-processor.js';
+export { captureTraceparent } from './propagation/capture-traceparent.js';
+export { runWithTraceparent } from './propagation/run-with-traceparent.js';
+export { spanContextFromTraceparent } from './propagation/span-context-from-traceparent.js';
+export { traceparentFromContext } from './propagation/traceparent-from-context.js';
+export { OUTCOME_ATTRIBUTE } from './span/outcome-attribute.js';
+export { withSpan } from './span/with-span.js';
+export { traceUseCases } from './use-case/trace-use-cases.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,GAGjB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACnG,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAuB,MAAM,mCAAmC,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAsB,MAAM,gCAAgC,CAAC;AACnF,OAAO,EAAE,eAAe,EAA+B,MAAM,kCAAkC,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAE7E,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAA8B,MAAM,6BAA6B,CAAC;AAC5G,OAAO,EAAE,eAAe,EAA+B,MAAM,8BAA8B,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAgC,MAAM,+BAA+B,CAAC;AAC/F,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAmE,MAAM,yBAAyB,CAAC;AACxH,OAAO,EAAE,SAAS,EAAyB,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACvF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAkC,MAAM,sCAAsC,CAAC;AAC1G,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAExF,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/jobs/traced-job.d.ts

@@ -0,0 +1,16 @@
+import type { JobExecution } from '@ddd-ts-kit/kernel';
+export interface TracedJobOptions {
+    /** Name of the job, `<context>.<job>`: the span is `job <name>`. */
+    readonly name: string;
+    /** Bounded context the job belongs to. */
+    readonly context?: string;
+}
+type JobRun = (execution: JobExecution) => Promise<void>;
+/**
+ * Wraps the run of a scheduled job: one trace per run, whose root span `job <name>` says the
+ * instant the run was due, the attempt and the outcome, and whose children are the commands
+ * the job sends. Always a root: a run never continues the trace of whatever armed its timer.
+ */
+export declare function tracedJob(run: JobRun, options: TracedJobOptions): JobRun;
+export {};
+//# sourceMappingURL=traced-job.d.ts.map

package/dist/jobs/traced-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traced-job.d.ts","sourceRoot":"","sources":["../../src/jobs/traced-job.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,KAAK,MAAM,GAAG,CAAC,SAAS,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAkBxE"}

package/dist/jobs/traced-job.js

@@ -0,0 +1,25 @@
+import { SpanKind } from '@opentelemetry/api';
+import { workAttributes } from '../local-root/work-attributes.js';
+import { inSpan } from '../span/in-span.js';
+import { OUTCOME_ATTRIBUTE } from '../span/outcome-attribute.js';
+/**
+ * Wraps the run of a scheduled job: one trace per run, whose root span `job <name>` says the
+ * instant the run was due, the attempt and the outcome, and whose children are the commands
+ * the job sends. Always a root: a run never continues the trace of whatever armed its timer.
+ */
+export function tracedJob(run, options) {
+    return (execution) => {
+        const attributes = {
+            'app.job.name': options.name,
+            ...(options.context === undefined ? {} : { 'app.context': options.context }),
+            'app.job.scheduled_at': execution.scheduledAt.toISOString(),
+            'app.job.attempt': execution.attempt,
+            ...workAttributes(),
+        };
+        return inSpan({ name: `job ${options.name}`, options: { kind: SpanKind.INTERNAL, root: true, attributes } }, async (span) => {
+            await run(execution);
+            span.setAttribute(OUTCOME_ATTRIBUTE, 'succeeded');
+        });
+    };
+}
+//# sourceMappingURL=traced-job.js.map

package/dist/jobs/traced-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traced-job.js","sourceRoot":"","sources":["../../src/jobs/traced-job.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAWjE;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,OAAyB;IAC9D,OAAO,CAAC,SAAS,EAAE,EAAE;QACnB,MAAM,UAAU,GAAG;YACjB,cAAc,EAAE,OAAO,CAAC,IAAI;YAC5B,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;YAC5E,sBAAsB,EAAE,SAAS,CAAC,WAAW,CAAC,WAAW,EAAE;YAC3D,iBAAiB,EAAE,SAAS,CAAC,OAAO;YACpC,GAAG,cAAc,EAAE;SACpB,CAAC;QAEF,OAAO,MAAM,CACX,EAAE,IAAI,EAAE,OAAO,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAC7F,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,MAAM,GAAG,CAAC,SAAS,CAAC,CAAC;YACrB,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;QACpD,CAAC,CACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/local-root/admit-dependency-span.d.ts

@@ -0,0 +1,7 @@
+export declare const DROPPED_SPANS_ATTRIBUTE = "app.dependency_spans.dropped";
+/**
+ * Counts one more dependency span under the active local root, or refuses it once a cap
+ * is reached. A loop of a thousand repository calls must not become a thousand spans.
+ */
+export declare function admitDependencySpan(name: string): boolean;
+//# sourceMappingURL=admit-dependency-span.d.ts.map

package/dist/local-root/admit-dependency-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admit-dependency-span.d.ts","sourceRoot":"","sources":["../../src/local-root/admit-dependency-span.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AAEtE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA2BzD"}

package/dist/local-root/admit-dependency-span.js

@@ -0,0 +1,30 @@
+import { context, trace } from '@opentelemetry/api';
+import { tracingConfiguration } from '../configuration/configure-tracing.js';
+import { correlate } from './correlate.js';
+import { localRoots } from './local-roots.js';
+export const DROPPED_SPANS_ATTRIBUTE = 'app.dependency_spans.dropped';
+/**
+ * Counts one more dependency span under the active local root, or refuses it once a cap
+ * is reached. A loop of a thousand repository calls must not become a thousand spans.
+ */
+export function admitDependencySpan(name) {
+    const active = trace.getSpan(context.active());
+    const root = active === undefined ? undefined : localRoots.get(active);
+    if (root === undefined) {
+        return true;
+    }
+    correlate(root);
+    const { maxSpansPerName, maxSpansPerRoot } = tracingConfiguration();
+    const sameName = root.perName.get(name) ?? 0;
+    if (root.total >= maxSpansPerRoot || sameName >= maxSpansPerName) {
+        root.dropped += 1;
+        if (root.span.isRecording()) {
+            root.span.setAttribute(DROPPED_SPANS_ATTRIBUTE, root.dropped);
+        }
+        return false;
+    }
+    root.perName.set(name, sameName + 1);
+    root.total += 1;
+    return true;
+}
+//# sourceMappingURL=admit-dependency-span.js.map

package/dist/local-root/admit-dependency-span.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admit-dependency-span.js","sourceRoot":"","sources":["../../src/local-root/admit-dependency-span.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,CAAC,MAAM,uBAAuB,GAAG,8BAA8B,CAAC;AAEtE;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEvE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,IAAI,CAAC,CAAC;IAEhB,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,GAAG,oBAAoB,EAAE,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7C,IAAI,IAAI,CAAC,KAAK,IAAI,eAAe,IAAI,QAAQ,IAAI,eAAe,EAAE,CAAC;QACjE,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QAElB,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,uBAAuB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAEhB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/local-root/correlate.d.ts

@@ -0,0 +1,9 @@
+import type { LocalRoot } from './local-root.js';
+export declare const CORRELATION_ID_ATTRIBUTE = "app.correlation_id";
+export declare const ORIGIN_ATTRIBUTE = "app.origin";
+/**
+ * Names the execution context on the local root, once. Identifiers of the work only: who acts
+ * and for which tenant never become span attributes.
+ */
+export declare function correlate(root: LocalRoot): void;
+//# sourceMappingURL=correlate.d.ts.map