raffel 1.1.66 → 1.1.67

package/dist/tracing/interceptor.js

@@ -20,21 +20,127 @@
 import { applyHttpRouteToSpan } from './http.js';
 import { hexTraceIdToDecimal, hexSpanIdToDecimal } from './decimal-id.js';
 import { parseBaggageHeader } from './baggage.js';
+import { filterSensitiveSpanAttributes } from './safe-attributes.js';
+import { isAsyncIterable } from '../utils/type-guards.js';
+function recordSpanFailure(span, error) {
+    if (error instanceof Error) {
+        span.recordError(error);
+    }
+    else {
+        span.setStatus('error', String(error));
+    }
+}
+async function* traceAsyncIterable(tracer, span, baggage, iterable) {
+    const iterator = iterable[Symbol.asyncIterator]();
+    let iteratorDone = false;
+    let failed = false;
+    try {
+        while (true) {
+            const result = await tracer.runInSpanContext(span, baggage, () => iterator.next());
+            if (result.done) {
+                iteratorDone = true;
+                return;
+            }
+            yield result.value;
+        }
+    }
+    catch (error) {
+        failed = true;
+        recordSpanFailure(span, error);
+        throw error;
+    }
+    finally {
+        try {
+            if (!iteratorDone && iterator.return) {
+                await tracer.runInSpanContext(span, baggage, () => iterator.return());
+            }
+        }
+        catch (error) {
+            if (!failed) {
+                failed = true;
+                recordSpanFailure(span, error);
+                throw error;
+            }
+        }
+        finally {
+            if (!failed)
+                span.setStatus('ok');
+            span.finish();
+        }
+    }
+}
+function preserveAsyncIterableCapabilities(tracer, span, baggage, iterable) {
+    const tracedIterator = traceAsyncIterable(tracer, span, baggage, iterable)[Symbol.asyncIterator]();
+    return new Proxy(iterable, {
+        get(target, property) {
+            if (property === Symbol.asyncIterator) {
+                return () => tracedIterator;
+            }
+            if (property === 'next' && typeof Reflect.get(target, property) === 'function') {
+                return tracedIterator.next.bind(tracedIterator);
+            }
+            if (property === 'return' && typeof Reflect.get(target, property) === 'function') {
+                return tracedIterator.return?.bind(tracedIterator);
+            }
+            if (property === 'throw' && typeof Reflect.get(target, property) === 'function') {
+                return tracedIterator.throw?.bind(tracedIterator);
+            }
+            const value = Reflect.get(target, property, target);
+            return typeof value === 'function' ? value.bind(target) : value;
+        },
+    });
+}
+async function runWithSpan(tracer, span, baggage, operation) {
+    try {
+        const result = await tracer.runInSpanContext(span, baggage, operation);
+        if (isAsyncIterable(result)) {
+            return preserveAsyncIterableCapabilities(tracer, span, baggage, result);
+        }
+        span.setStatus('ok');
+        span.finish();
+        return result;
+    }
+    catch (error) {
+        recordSpanFailure(span, error);
+        span.finish();
+        throw error;
+    }
+}
+function createTraceOperation(tracer) {
+    return async (name, attributes, operation) => {
+        const parent = tracer.getActiveSpan();
+        const span = tracer.startSpan(name, {
+            kind: 'internal',
+            parent: parent?.context,
+            attributes: filterSensitiveSpanAttributes(attributes),
+        });
+        return runWithSpan(tracer, span, tracer.getBaggage(), operation);
+    };
+}
+function createTraceEvent(tracer) {
+    return (name, attributes = {}) => {
+        tracer.getActiveSpan()?.log(name, filterSensitiveSpanAttributes(attributes));
+    };
+}
 /**
  * Create an interceptor that automatically traces requests
  */
-export function createTracingInterceptor(tracer) {
+export function createTracingInterceptor(tracer, options = {}) {
     return async (envelope, ctx, next) => {
         const procedure = envelope.procedure ?? 'unknown';
         // Extract parent context from envelope metadata (if propagated)
         let parentContext;
         const metadata = envelope.metadata;
-        if (metadata?.traceparent) {
-            parentContext = tracer.extractContext({
+        const extractedParent = metadata?.traceparent
+            ? tracer.extractContext({
                 traceparent: metadata.traceparent,
                 tracestate: metadata.tracestate,
-            });
-        }
+            })
+            : undefined;
+        const activeParent = tracer.getActiveSpan()?.context;
+        parentContext = options.preferActiveParent
+            ? activeParent ?? extractedParent
+            : extractedParent ?? activeParent;
         // Incoming baggage (business context, not trace identity) travels the
         // same path as traceparent/tracestate — see extractMetadataFromHeaders.
         // Always a (possibly empty) object, never undefined, so a handler can
@@ -61,21 +167,22 @@ export function createTracingInterceptor(tracer) {
         const attributes = {
             'rpc.method': procedure,
             'rpc.system': 'raffel',
+            'raffel.procedure': procedure,
         };
         if (isHttp && httpMethod) {
             attributes['http.request.method'] = httpMethod;
             if (httpRoute) {
                 attributes['http.route'] = httpRoute;
             }
-            if (httpPath) {
+            if (httpPath && !options.spanName) {
                 attributes['url.path'] = httpPath;
             }
         }
         // Start span with parent context
-        const span = tracer.startSpan(spanName, {
-            kind: 'server',
+        const span = tracer.startSpan(options.spanName ?? spanName, {
+            kind: options.spanKind ?? 'server',
             parent: parentContext,
-            attributes,
+            attributes: filterSensitiveSpanAttributes(attributes),
         });
         // Stash tracing context on `ctx` so downstream interceptors (logging,
         // metrics) and handlers can correlate. `ddTraceId` / `ddSpanId` are the
@@ -91,6 +198,8 @@ export function createTracingInterceptor(tracer) {
             ddTraceId: hexTraceIdToDecimal(span.context.traceId),
             ddSpanId: hexSpanIdToDecimal(span.context.spanId),
             baggage: incomingBaggage,
+            trace: createTraceOperation(tracer),
+            event: createTraceEvent(tracer),
         };
         if (ctx.logger?.child) {
             ctx.logger = ctx.logger.child({
@@ -101,39 +210,27 @@ export function createTracingInterceptor(tracer) {
         if (ctx.http) {
             const method = ctx.http.method.toUpperCase();
             const route = ctx.http.route ?? ctx.http.path;
-            span.setAttributes({
+            const httpAttributes = {
                 'http.request.method': method,
-                'url.path': ctx.http.path,
                 'http.route': route,
-            });
-            applyHttpRouteToSpan(span, method, {
-                route,
-                procedure,
-            });
+            };
+            if (!options.spanName) {
+                httpAttributes['url.path'] = ctx.http.path;
+            }
+            span.setAttributes(filterSensitiveSpanAttributes(httpAttributes));
+            if (!options.spanName) {
+                applyHttpRouteToSpan(span, method, {
+                    route,
+                    procedure,
+                });
+            }
         }
         // Run `next()` — and everything it awaits — with this span/baggage as
         // active, correctly restoring the caller's previous span/baggage
         // afterward regardless of how many awaits happen in between (see
         // `runInSpanContext`'s docs for why a manual enterWith+restore pair
         // doesn't do this reliably).
-        return tracer.runInSpanContext(span, incomingBaggage, async () => {
-            try {
-                const result = await next();
-                span.setStatus('ok');
-                span.finish();
-                return result;
-            }
-            catch (error) {
-                if (error instanceof Error) {
-                    span.recordError(error);
-                }
-                else {
-                    span.setStatus('error', String(error));
-                }
-                span.finish();
-                throw error;
-            }
-        });
+        return runWithSpan(tracer, span, incomingBaggage, next);
     };
 }
 /**

package/dist/tracing/interceptor.js.map

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

package/dist/tracing/opentelemetry-span.d.ts

@@ -0,0 +1,11 @@
+import { type Span as OtelSpan } from '@opentelemetry/api';
+import type { Span, SpanAttributes, SpanKind } from './types.js';
+export interface OpenTelemetrySpanAdapterOptions {
+    name: string;
+    kind: SpanKind;
+    parentSpanId?: string;
+    attributes?: SpanAttributes;
+}
+/** Adapt a native OTel span while reusing Raffel's span state bookkeeping. */
+export declare function createOpenTelemetrySpanAdapter(nativeSpan: OtelSpan, options: OpenTelemetrySpanAdapterOptions): Span;
+//# sourceMappingURL=opentelemetry-span.d.ts.map

package/dist/tracing/opentelemetry-span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry-span.d.ts","sourceRoot":"","sources":["../../src/tracing/opentelemetry-span.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,IAAI,IAAI,QAAQ,EACtB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EACV,IAAI,EACJ,cAAc,EAEd,QAAQ,EAET,MAAM,YAAY,CAAA;AAkBnB,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,cAAc,CAAA;CAC5B;AAED,8EAA8E;AAC9E,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,QAAQ,EACpB,OAAO,EAAE,+BAA+B,GACvC,IAAI,CA6FN"}

package/dist/tracing/opentelemetry-span.js

@@ -0,0 +1,101 @@
+import { SpanStatusCode as OtelSpanStatusCode, } from '@opentelemetry/api';
+import { createSpan } from './span.js';
+const OTEL_STATUS = {
+    unset: OtelSpanStatusCode.UNSET,
+    ok: OtelSpanStatusCode.OK,
+    error: OtelSpanStatusCode.ERROR,
+};
+function asOtelAttributes(attributes) {
+    const result = {};
+    for (const [key, value] of Object.entries(attributes)) {
+        if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/** Adapt a native OTel span while reusing Raffel's span state bookkeeping. */
+export function createOpenTelemetrySpanAdapter(nativeSpan, options) {
+    const nativeContext = () => {
+        const context = nativeSpan.spanContext();
+        return {
+            traceId: context.traceId,
+            spanId: context.spanId,
+            traceFlags: context.traceFlags,
+            traceState: context.traceState?.serialize(),
+            isRemote: context.isRemote,
+        };
+    };
+    const context = nativeContext();
+    const state = createSpan({
+        traceId: context.traceId,
+        spanId: context.spanId,
+        parentSpanId: options.parentSpanId,
+        name: options.name,
+        kind: options.kind,
+        isRecording: nativeSpan.isRecording(),
+        attributes: options.attributes,
+    });
+    let finished = false;
+    const span = {
+        get context() {
+            return nativeContext();
+        },
+        get name() {
+            return state.name;
+        },
+        get isRecording() {
+            return !finished && nativeSpan.isRecording();
+        },
+        setAttribute(key, value) {
+            state.setAttribute(key, value);
+            nativeSpan.setAttribute(key, value);
+            return this;
+        },
+        setAttributes(attributes) {
+            state.setAttributes(attributes);
+            nativeSpan.setAttributes(attributes);
+            return this;
+        },
+        log(message, fields) {
+            state.log(message, fields);
+            nativeSpan.addEvent(message, asOtelAttributes(fields ?? {}));
+            return this;
+        },
+        setStatus(code, message) {
+            state.setStatus(code, message);
+            nativeSpan.setStatus({ code: OTEL_STATUS[code], message });
+            return this;
+        },
+        recordError(error) {
+            state.recordError(error);
+            nativeSpan.recordException(error);
+            nativeSpan.setStatus({ code: OtelSpanStatusCode.ERROR, message: error.message });
+            return this;
+        },
+        updateName(name) {
+            state.updateName(name);
+            nativeSpan.updateName(name);
+            return this;
+        },
+        finish() {
+            if (finished)
+                return;
+            finished = true;
+            state.finish();
+            nativeSpan.end();
+        },
+        toSpanData() {
+            const data = state.toSpanData();
+            const currentContext = nativeContext();
+            return {
+                ...data,
+                traceId: currentContext.traceId,
+                spanId: currentContext.spanId,
+                context: currentContext,
+            };
+        },
+    };
+    return span;
+}
+//# sourceMappingURL=opentelemetry-span.js.map

package/dist/tracing/opentelemetry-span.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry-span.js","sourceRoot":"","sources":["../../src/tracing/opentelemetry-span.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,IAAI,kBAAkB,GAGrC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAStC,MAAM,WAAW,GAA+C;IAC9D,KAAK,EAAE,kBAAkB,CAAC,KAAK;IAC/B,EAAE,EAAE,kBAAkB,CAAC,EAAE;IACzB,KAAK,EAAE,kBAAkB,CAAC,KAAK;CAChC,CAAA;AAED,SAAS,gBAAgB,CAAC,UAAmC;IAC3D,MAAM,MAAM,GAAmB,EAAE,CAAA;IACjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YACzF,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACrB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AASD,8EAA8E;AAC9E,MAAM,UAAU,8BAA8B,CAC5C,UAAoB,EACpB,OAAwC;IAExC,MAAM,aAAa,GAAG,GAAgB,EAAE;QACtC,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,EAAE,CAAA;QACxC,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE;YAC3C,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAA;IACH,CAAC,CAAA;IACD,MAAM,OAAO,GAAG,aAAa,EAAE,CAAA;IAC/B,MAAM,KAAK,GAAG,UAAU,CAAC;QACvB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,UAAU,CAAC,WAAW,EAAE;QACrC,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAA;IACF,IAAI,QAAQ,GAAG,KAAK,CAAA;IAEpB,MAAM,IAAI,GAAS;QACjB,IAAI,OAAO;YACT,OAAO,aAAa,EAAE,CAAA;QACxB,CAAC;QAED,IAAI,IAAI;YACN,OAAO,KAAK,CAAC,IAAI,CAAA;QACnB,CAAC;QAED,IAAI,WAAW;YACb,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC,WAAW,EAAE,CAAA;QAC9C,CAAC;QAED,YAAY,CAAC,GAAG,EAAE,KAAK;YACrB,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YAC9B,UAAU,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YACnC,OAAO,IAAI,CAAA;QACb,CAAC;QAED,aAAa,CAAC,UAAU;YACtB,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,CAAA;YAC/B,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAA;YACpC,OAAO,IAAI,CAAA;QACb,CAAC;QAED,GAAG,CAAC,OAAO,EAAE,MAAM;YACjB,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;YAC1B,UAAU,CAAC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAA;YAC5D,OAAO,IAAI,CAAA;QACb,CAAC;QAED,SAAS,CAAC,IAAI,EAAE,OAAO;YACrB,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YAC9B,UAAU,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;YAC1D,OAAO,IAAI,CAAA;QACb,CAAC;QAED,WAAW,CAAC,KAAK;YACf,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;YACxB,UAAU,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;YACjC,UAAU,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;YAChF,OAAO,IAAI,CAAA;QACb,CAAC;QAED,UAAU,CAAC,IAAI;YACb,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;YACtB,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;YAC3B,OAAO,IAAI,CAAA;QACb,CAAC;QAED,MAAM;YACJ,IAAI,QAAQ;gBAAE,OAAM;YACpB,QAAQ,GAAG,IAAI,CAAA;YACf,KAAK,CAAC,MAAM,EAAE,CAAA;YACd,UAAU,CAAC,GAAG,EAAE,CAAA;QAClB,CAAC;QAED,UAAU;YACR,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,EAAE,CAAA;YAC/B,MAAM,cAAc,GAAG,aAAa,EAAE,CAAA;YACtC,OAAO;gBACL,GAAG,IAAI;gBACP,OAAO,EAAE,cAAc,CAAC,OAAO;gBAC/B,MAAM,EAAE,cAAc,CAAC,MAAM;gBAC7B,OAAO,EAAE,cAAc;aACxB,CAAA;QACH,CAAC;KACF,CAAA;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/tracing/opentelemetry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Adapter from Raffel's tracing surface to the process-wide OpenTelemetry API.
+ *
+ * The application/platform owns the global provider, context manager,
+ * processors, exporters, flushing, and shutdown. Raffel only creates child
+ * spans through the API so it composes with auto-instrumentation such as
+ * Datadog Single-Step Instrumentation.
+ */
+import type { Tracer } from './types.js';
+export interface GlobalOpenTelemetryTracerOptions {
+    /** OpenTelemetry instrumentation scope name (default: `raffel`). */
+    instrumentationName?: string;
+    /** Optional instrumentation scope version. */
+    instrumentationVersion?: string;
+}
+/**
+ * Use the OpenTelemetry tracer provider already registered by the host.
+ * This function never installs a provider or exporter and never shuts the
+ * host provider down.
+ */
+export declare function createGlobalOpenTelemetryTracer(options?: GlobalOpenTelemetryTracerOptions): Tracer;
+//# sourceMappingURL=opentelemetry.d.ts.map

package/dist/tracing/opentelemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentelemetry.d.ts","sourceRoot":"","sources":["../../src/tracing/opentelemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAOV,MAAM,EACP,MAAM,YAAY,CAAA;AAYnB,MAAM,WAAW,gCAAgC;IAC/C,oEAAoE;IACpE,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,8CAA8C;IAC9C,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,gCAAqC,GAC7C,MAAM,CA2HR"}

package/dist/tracing/opentelemetry.js

@@ -0,0 +1,111 @@
+/**
+ * Adapter from Raffel's tracing surface to the process-wide OpenTelemetry API.
+ *
+ * The application/platform owns the global provider, context manager,
+ * processors, exporters, flushing, and shutdown. Raffel only creates child
+ * spans through the API so it composes with auto-instrumentation such as
+ * Datadog Single-Step Instrumentation.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { context as otelContext, createTraceState, SpanKind as OtelSpanKind, trace as otelTrace, } from '@opentelemetry/api';
+import { createOpenTelemetrySpanAdapter } from './opentelemetry-span.js';
+import { formatW3CTraceContext, parseW3CTraceContext } from './trace-context.js';
+const OTEL_SPAN_KIND = {
+    internal: OtelSpanKind.INTERNAL,
+    server: OtelSpanKind.SERVER,
+    client: OtelSpanKind.CLIENT,
+    producer: OtelSpanKind.PRODUCER,
+    consumer: OtelSpanKind.CONSUMER,
+};
+/**
+ * Use the OpenTelemetry tracer provider already registered by the host.
+ * This function never installs a provider or exporter and never shuts the
+ * host provider down.
+ */
+export function createGlobalOpenTelemetryTracer(options = {}) {
+    const otelTracer = otelTrace.getTracer(options.instrumentationName ?? 'raffel', options.instrumentationVersion);
+    const nativeBySpan = new WeakMap();
+    const spanByNative = new WeakMap();
+    const activeSpanStorage = new AsyncLocalStorage();
+    const baggageStorage = new AsyncLocalStorage();
+    function wrapSpan(nativeSpan, name, kind, parentSpanId, initialAttributes = {}) {
+        const existing = spanByNative.get(nativeSpan);
+        if (existing)
+            return existing;
+        const span = createOpenTelemetrySpanAdapter(nativeSpan, {
+            name,
+            kind,
+            parentSpanId,
+            attributes: initialAttributes,
+        });
+        nativeBySpan.set(span, nativeSpan);
+        spanByNative.set(nativeSpan, span);
+        return span;
+    }
+    function parentOtelContext(parent) {
+        if (parent) {
+            return otelTrace.setSpanContext(otelContext.active(), {
+                traceId: parent.traceId,
+                spanId: parent.spanId,
+                traceFlags: parent.traceFlags,
+                traceState: parent.traceState ? createTraceState(parent.traceState) : undefined,
+                isRemote: parent.isRemote ?? false,
+            });
+        }
+        const manuallyActive = activeSpanStorage.getStore();
+        const nativeActive = manuallyActive && nativeBySpan.get(manuallyActive);
+        return nativeActive
+            ? otelTrace.setSpan(otelContext.active(), nativeActive)
+            : otelContext.active();
+    }
+    const tracer = {
+        startSpan(name, options = {}) {
+            const kind = options.kind ?? 'internal';
+            const nativeSpan = otelTracer.startSpan(name, {
+                kind: OTEL_SPAN_KIND[kind],
+                attributes: options.attributes,
+            }, parentOtelContext(options.parent));
+            return wrapSpan(nativeSpan, name, kind, options.parent?.spanId, options.attributes);
+        },
+        getActiveSpan() {
+            const nativeSpan = otelTrace.getSpan(otelContext.active());
+            if (nativeSpan) {
+                return wrapSpan(nativeSpan, 'external.active', 'internal');
+            }
+            return activeSpanStorage.getStore();
+        },
+        setActiveSpan(span) {
+            activeSpanStorage.enterWith(span);
+        },
+        getBaggage() {
+            return baggageStorage.getStore();
+        },
+        setBaggage(baggage) {
+            baggageStorage.enterWith(baggage);
+        },
+        runInSpanContext(span, baggage, fn) {
+            const nativeSpan = span && nativeBySpan.get(span);
+            const context = nativeSpan
+                ? otelTrace.setSpan(otelContext.active(), nativeSpan)
+                : otelContext.active();
+            return otelContext.with(context, () => activeSpanStorage.run(span, () => baggageStorage.run(baggage, fn)));
+        },
+        startSpanFromContext(name, parentContext, options = {}) {
+            return this.startSpan(name, { ...options, parent: parentContext });
+        },
+        extractContext(headers) {
+            return parseW3CTraceContext(headers);
+        },
+        injectContext(context) {
+            return formatW3CTraceContext(context);
+        },
+        async flush() {
+            // The host provider owns processors/exporters and their flush lifecycle.
+        },
+        async shutdown() {
+            // The host provider is process-global and must not be shut down by Raffel.
+        },
+    };
+    return tracer;
+}
+//# sourceMappingURL=opentelemetry.js.map

package/dist/tracing/opentelemetry.js.map

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

package/dist/tracing/safe-attributes.d.ts

@@ -0,0 +1,8 @@
+import type { SpanAttributes } from './types.js';
+/**
+ * Drop attribute categories that commonly carry credentials, personal
+ * identifiers, or high-cardinality cache keys. Tracing must never make the
+ * application fail, so unsafe attributes are omitted rather than rejected.
+ */
+export declare function filterSensitiveSpanAttributes(attributes: SpanAttributes): SpanAttributes;
+//# sourceMappingURL=safe-attributes.d.ts.map

package/dist/tracing/safe-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-attributes.d.ts","sourceRoot":"","sources":["../../src/tracing/safe-attributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAsChD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,cAAc,GAAG,cAAc,CAQxF"}

package/dist/tracing/safe-attributes.js

@@ -0,0 +1,53 @@
+const SENSITIVE_ATTRIBUTE_KEY_PATTERN = /(?:^|[._-])(?:authorization|cookie|document|documento|cpf|cnpj|oid|password|secret|token|cache[._-]?key|api[._-]?key)(?:$|[._-])/i;
+const SAFE_STRING_ATTRIBUTE_KEYS = new Set([
+    'cache.system',
+    'db.operation.name',
+    'db.system',
+    'deployment.environment',
+    'deployment.environment.name',
+    'http.request.method',
+    'http.route',
+    'messaging.system',
+    'network.protocol.name',
+    'network.protocol.version',
+    'raffel.handler.kind',
+    'raffel.interceptor',
+    'raffel.procedure',
+    'rpc.method',
+    'rpc.system',
+    'service.name',
+    'url.path',
+    'url.scheme',
+]);
+const SENSITIVE_ATTRIBUTE_VALUE_PATTERNS = [
+    /\b\d{3}\.?\d{3}\.?\d{3}-?\d{2}\b/,
+    /(?:^|[^a-z0-9])(?:bearer|oid|token)[._:=/-]?[a-z0-9]/i,
+    /^[a-f0-9]{24}$/i,
+    /^[a-z0-9._-]+(?::[a-z0-9._-]+)+$/i,
+    /^eyJ[a-z0-9_-]+\.[a-z0-9_-]+\.[a-z0-9_-]+$/i,
+];
+function hasSensitiveValue(value) {
+    if (typeof value === 'boolean')
+        return false;
+    const text = String(value);
+    if (text.length > 256 || /[\u0000-\u001f\u007f]/.test(text))
+        return true;
+    return SENSITIVE_ATTRIBUTE_VALUE_PATTERNS.some((pattern) => pattern.test(text));
+}
+/**
+ * Drop attribute categories that commonly carry credentials, personal
+ * identifiers, or high-cardinality cache keys. Tracing must never make the
+ * application fail, so unsafe attributes are omitted rather than rejected.
+ */
+export function filterSensitiveSpanAttributes(attributes) {
+    const safe = {};
+    for (const [key, value] of Object.entries(attributes)) {
+        if (SENSITIVE_ATTRIBUTE_KEY_PATTERN.test(key) || hasSensitiveValue(value))
+            continue;
+        if (typeof value === 'string' && !SAFE_STRING_ATTRIBUTE_KEYS.has(key))
+            continue;
+        safe[key] = value;
+    }
+    return safe;
+}
+//# sourceMappingURL=safe-attributes.js.map

package/dist/tracing/safe-attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-attributes.js","sourceRoot":"","sources":["../../src/tracing/safe-attributes.ts"],"names":[],"mappings":"AAEA,MAAM,+BAA+B,GAAG,mIAAmI,CAAA;AAC3K,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IACzC,cAAc;IACd,mBAAmB;IACnB,WAAW;IACX,wBAAwB;IACxB,6BAA6B;IAC7B,qBAAqB;IACrB,YAAY;IACZ,kBAAkB;IAClB,uBAAuB;IACvB,0BAA0B;IAC1B,qBAAqB;IACrB,oBAAoB;IACpB,kBAAkB;IAClB,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,UAAU;IACV,YAAY;CACb,CAAC,CAAA;AACF,MAAM,kCAAkC,GAAG;IACzC,kCAAkC;IAClC,uDAAuD;IACvD,iBAAiB;IACjB,mCAAmC;IACnC,6CAA6C;CAC9C,CAAA;AAED,SAAS,iBAAiB,CAAC,KAAgC;IACzD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC1B,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,IAAI,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IACxE,OAAO,kCAAkC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AACjF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,UAA0B;IACtE,MAAM,IAAI,GAAmB,EAAE,CAAA;IAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,IAAI,+BAA+B,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC;YAAE,SAAQ;QACnF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,0BAA0B,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAQ;QAC/E,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACnB,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/tracing/trace-context.d.ts

@@ -0,0 +1,6 @@
+import type { SpanContext, TraceHeaders } from './types.js';
+/** Parse the W3C traceparent/tracestate headers used by Raffel tracers. */
+export declare function parseW3CTraceContext(headers: TraceHeaders): SpanContext | undefined;
+/** Format a Raffel span context as W3C traceparent/tracestate headers. */
+export declare function formatW3CTraceContext(context: SpanContext): TraceHeaders;
+//# sourceMappingURL=trace-context.d.ts.map

package/dist/tracing/trace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.d.ts","sourceRoot":"","sources":["../../src/tracing/trace-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE3D,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,GAAG,SAAS,CAgBnF;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAMxE"}

package/dist/tracing/trace-context.js

@@ -0,0 +1,26 @@
+/** Parse the W3C traceparent/tracestate headers used by Raffel tracers. */
+export function parseW3CTraceContext(headers) {
+    const parts = headers.traceparent?.split('-');
+    if (!parts || parts.length !== 4)
+        return undefined;
+    const [version, traceId, spanId, flags] = parts;
+    if (version !== '00' || traceId.length !== 32 || spanId.length !== 16) {
+        return undefined;
+    }
+    return {
+        traceId,
+        spanId,
+        traceFlags: Number.parseInt(flags, 16),
+        traceState: headers.tracestate,
+        isRemote: true,
+    };
+}
+/** Format a Raffel span context as W3C traceparent/tracestate headers. */
+export function formatW3CTraceContext(context) {
+    const flags = context.traceFlags.toString(16).padStart(2, '0');
+    return {
+        traceparent: `00-${context.traceId}-${context.spanId}-${flags}`,
+        tracestate: context.traceState,
+    };
+}
+//# sourceMappingURL=trace-context.js.map

package/dist/tracing/trace-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-context.js","sourceRoot":"","sources":["../../src/tracing/trace-context.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,MAAM,UAAU,oBAAoB,CAAC,OAAqB;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;IAC7C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IAElD,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,KAAK,CAAA;IAC/C,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,IAAI,MAAM,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QACtE,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,OAAO;QACL,OAAO;QACP,MAAM;QACN,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;QACtC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,QAAQ,EAAE,IAAI;KACf,CAAA;AACH,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,qBAAqB,CAAC,OAAoB;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC9D,OAAO;QACL,WAAW,EAAE,MAAM,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,EAAE;QAC/D,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAA;AACH,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/tracing/tracer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EAQd,MAAM,YAAY,CAAA;AAInB;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,aAAkB,GAAG,MAAM,CAkN/D"}
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/tracing/tracer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EAQd,MAAM,YAAY,CAAA;AAKnB;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,aAAkB,GAAG,MAAM,CA2L/D"}