@btx-second-context/otel 0.0.0-stage → 0.0.1

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 0.0.1 — 2026-11-12
+
+- Export Node backend spans through standard OTLP/HTTP Protobuf.
+- Trace operations with labels, attributes, and parent context.
+- Preserve recorded span content with bounded queues and flush deadlines.
+- Suppress exporter tracing and report sanitized delivery outcomes.

package/README.md

@@ -1,3 +1,123 @@
-# Temporary Holding Version
+# BTX OpenTelemetry
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`@btx-second-context/otel` exports Node backend traces through standard OTLP/HTTP Protobuf and
+supports customer-defined Labels. It works with your existing OTel provider,
+instrumentation, resources, and sampler. The package does not register a provider
+or make requests when imported.
+
+The package contains compiled ESM and TypeScript declarations, with no BTX
+workspace dependencies. Node 20.6 or later is required.
+
+## Install
+
+```sh
+pnpm add @btx-second-context/otel@0.0.1
+```
+
+## Export traces
+
+```ts
+import * as btx from '@btx-second-context/otel'
+
+const processor = btx.createBtxSpanProcessor({
+  otlp: { url: process.env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT },
+})
+
+// Include processor in your provider's spanProcessors when you initialize it.
+// Keep your existing resource, context manager, instrumentation, and sampler.
+```
+
+The official OTel exporter handles encoding, HTTP transport, and retries. Standard
+`OTEL_EXPORTER_OTLP_*` and trace-specific environment settings apply. An explicit
+`otlp.url` is the full traces endpoint. Without explicit configuration, the OTel
+exporter's defaults apply. An existing standard `SpanExporter` can instead be
+supplied through `exporter`; do not supply both options.
+
+## Trace an operation
+
+```ts
+import * as btx from '@btx-second-context/otel'
+
+const reply = await btx.trace('Generate reply', () => generateReply())
+```
+
+`btx.trace(name, work)` and `btx.trace(name, options, work)` accept sync or async callbacks
+and return a promise with the original result. Nested calls create child spans.
+The helper records exceptions and ends the span when the callback settles.
+
+## Labels and attributes
+
+```ts
+import * as btx from '@btx-second-context/otel'
+
+const reply = await btx.trace(
+  'Generate reply',
+  { labels: ['reply-draft', 'customer-support'], attributes: { 'gen_ai.request.model': model } },
+  span => {
+    span.setAttributes({ 'app.source': 'support' })
+    return generateReply()
+  },
+)
+```
+
+Options propagate Labels and attributes to the operation and its children,
+including automatic instrumentation. Nested options merge Labels and override
+shared attributes. Authored span attributes take precedence for that span.
+Labels use the OTel string-array attribute `btx.labels`; the package has no fixed
+label vocabulary. Application boundaries own attribution, capture eligibility,
+and flushing. Labels and attributes never establish access.
+
+`btx.trace()` preserves the active parent, including remote parents. Without a parent,
+it starts a new trace. `btx.activeBtxTraceReference()` returns the active trace and span
+IDs. Ordinary OTel spans also export; `requireScope: true` limits capture to `btx.trace()`
+operations and their children. `btx.withoutBtxTracing(work)`
+suppresses capture, including around exporter transport.
+
+The span handle supports `setAttributes` and ignores writes after completion.
+Returned HTTP 5xx responses and `options.outcome(result)` can mark failures;
+exceptions record their original message, type, and stack. `options.kind` selects
+the OTel span kind. Instrumentation failures never repeat application work.
+
+## Delivery and content
+
+```ts
+const processor = btx.createBtxSpanProcessor({
+  maxQueueSize: 512,
+  maxExportBatchSize: 128,
+  scheduledDelayMillis: 5_000,
+  exportTimeoutMillis: 1_000,
+  flushTimeoutMillis: 1_500,
+  onExport: ({ outcome, spans }) => reportExport(outcome, spans),
+})
+
+await processor.forceFlush() // For short-lived request or job completion.
+await processor.shutdown()   // Once, during application shutdown.
+```
+
+Delivery is best effort. Sampling, queue overflow, retention decisions, transport
+failure, and deadlines can prevent delivery. Observations report counts and
+outcomes without span content; flush deadlines reject so the application can
+record a sanitized diagnostic. A successful export callback follows the standard
+exporter's result and is not a guarantee that every span was retained downstream.
+
+The processor preserves original names, recorded attributes, events, links,
+resource metadata, instrumentation scope, and upstream drop counts. It does not
+truncate content. Your provider controls SDK content limits. The optional
+`BTX_OTEL_SPAN_LIMITS` preset disables those limits; the exporter does not install
+it automatically. Preserve your own capture and sensitive-data policy.
+
+`BtxTraceRetention` supports application-owned keep/discard decisions through `options.retention`. Buffered spans share the configured queue budget; recorded errors
+preserve the execution. The application must settle its decision at completion.
+`withBtxClientDependency` and an optional `dependencyRegistry` add dependency
+metadata without replacing authored attributes or creating extra transport spans.
+
+## Development
+
+```sh
+pnpm --dir code/packages/btx-otel build
+pnpm --dir code/packages/btx-otel typecheck
+pnpm --dir code/packages/btx-otel test
+```
+
+Tests import the compiled package entry point and exercise a local OTLP receiver.
+Package publication and backend ingestion configuration are separate operations.

package/dist/client-dependency.d.ts

@@ -0,0 +1,19 @@
+import { type Attributes } from '@opentelemetry/api';
+/** Supplied by a trusted client adapter, never by a request payload or span attributes. */
+export interface BtxClientDependency {
+    service: string;
+    resourceKind: 'table' | 'rpc';
+    resource: string;
+    method: string;
+    url: string;
+}
+export declare const clientDependencyKey: symbol;
+export interface ClientDependencyFrame {
+    readonly metadata: Readonly<BtxClientDependency>;
+    readonly origin: string;
+    readonly pathname: string;
+}
+/** Enrich automatic instrumentation without creating another span or repeating work. */
+export declare function withBtxClientDependency<T>(metadata: BtxClientDependency | null, work: () => T): T;
+/** Enrich matching transport spans only, including real retry attempts. */
+export declare function matchingClientDependency(frame: ClientDependencyFrame | undefined, attributes: Attributes): BtxClientDependency | undefined;

package/dist/client-dependency.js

@@ -0,0 +1,39 @@
+import { context, createContextKey } from '@opentelemetry/api';
+export const clientDependencyKey = createContextKey('btx.otel.client-dependency');
+/** Enrich automatic instrumentation without creating another span or repeating work. */
+export function withBtxClientDependency(metadata, work) {
+    let frame;
+    try {
+        if (metadata && /^[a-z][a-z0-9_.]{0,95}$/.test(metadata.service) &&
+            ['table', 'rpc'].includes(metadata.resourceKind) && /^[A-Za-z_][A-Za-z0-9_.-]{0,95}$/.test(metadata.resource) &&
+            /^(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)$/.test(metadata.method)) {
+            const url = new URL(metadata.url);
+            if (['https:', 'http:'].includes(url.protocol) && !url.username && !url.password) {
+                frame = { metadata: Object.freeze({ service: metadata.service, resourceKind: metadata.resourceKind,
+                        resource: metadata.resource, method: metadata.method, url: url.origin + url.pathname }), origin: url.origin, pathname: url.pathname };
+            }
+        }
+    }
+    catch { /* Invalid metadata leaves the transport span generic. */ }
+    const active = context.active().deleteValue(clientDependencyKey);
+    return context.with(frame ? active.setValue(clientDependencyKey, frame) : active, work);
+}
+/** Enrich matching transport spans only, including real retry attempts. */
+export function matchingClientDependency(frame, attributes) {
+    if (!frame)
+        return;
+    const raw = attributes['url.full'] ?? attributes['http.url'];
+    const method = attributes['http.request.method'] ?? attributes['http.method'];
+    try {
+        if (typeof raw !== 'string' || method !== frame.metadata.method)
+            return;
+        const url = new URL(raw);
+        if (url.origin !== frame.origin || url.pathname !== frame.pathname || url.username || url.password)
+            return;
+        return frame.metadata;
+    }
+    catch {
+        return;
+    }
+}
+//# sourceMappingURL=client-dependency.js.map

package/dist/client-dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-dependency.js","sourceRoot":"","sources":["../src/client-dependency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAmB,MAAM,oBAAoB,CAAA;AAW/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,4BAA4B,CAAC,CAAA;AAOjF,wFAAwF;AACxF,MAAM,UAAU,uBAAuB,CAAI,QAAoC,EAAE,IAAa;IAC5F,IAAI,KAAwC,CAAA;IAC5C,IAAI,CAAC;QACH,IAAI,QAAQ,IAAI,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC5D,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,iCAAiC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC7G,4CAA4C,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACvE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;YACjC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;gBACjF,KAAK,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY;wBAChG,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAA;YACzI,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,yDAAyD,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAA;IAChE,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;AACzF,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,wBAAwB,CAAC,KAAwC,EAAE,UAAsB;IACvG,IAAI,CAAC,KAAK;QAAE,OAAM;IAClB,MAAM,GAAG,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAA;IAC5D,MAAM,MAAM,GAAG,UAAU,CAAC,qBAAqB,CAAC,IAAI,UAAU,CAAC,aAAa,CAAC,CAAA;IAC7E,IAAI,CAAC;QACH,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,KAAK,KAAK,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAM;QACvE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;QACxB,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ;YAAE,OAAM;QAC1G,OAAO,KAAK,CAAC,QAAQ,CAAA;IACvB,CAAC;IAAC,MAAM,CAAC;QAAC,OAAM;IAAC,CAAC;AACpB,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,26 @@
+import { type Attributes, type Context } from '@opentelemetry/api';
+/** Hold a bounded execution's spans until its application outcome is known. */
+export declare class BtxTraceRetention {
+    private decision;
+    private failed;
+    private listeners;
+    whenDecided(listener: (retain: boolean) => void): void;
+    preserveFailure(): void;
+    decide(retain: boolean): void;
+}
+export interface TraceMetadata {
+    labels?: readonly string[];
+    attributes?: Attributes;
+    retention?: BtxTraceRetention;
+}
+export declare const scopeKey: symbol;
+/** Snapshot metadata before starting a span so automatic children inherit it. */
+export declare function traceScopeContext(parent: Context, scope: TraceMetadata): Context;
+/** Release intake evidence once the execution is known to perform actual work. */
+export declare function retainBtxTrace(): void;
+/** Suppress both automatic instrumentation and the BTX export policy. */
+export declare function withoutBtxTracing<T>(work: () => T): T;
+export declare function activeBtxTraceReference(): {
+    traceId: string;
+    spanId: string;
+} | null;

package/dist/context.js

@@ -0,0 +1,54 @@
+import { context, createContextKey, isSpanContextValid, trace } from '@opentelemetry/api';
+import { suppressTracing } from '@opentelemetry/core';
+/** Hold a bounded execution's spans until its application outcome is known. */
+export class BtxTraceRetention {
+    decision;
+    failed = false;
+    listeners = [];
+    whenDecided(listener) {
+        if (this.decision !== undefined)
+            listener(this.decision);
+        else
+            this.listeners.push(listener);
+    }
+    preserveFailure() { this.failed = true; }
+    decide(retain) {
+        if (this.decision !== undefined)
+            return;
+        this.decision = retain || this.failed;
+        const listeners = this.listeners;
+        this.listeners = [];
+        for (const listener of listeners) {
+            try {
+                listener(this.decision);
+            }
+            catch { /* Telemetry cannot fail application work. */ }
+        }
+    }
+}
+export const scopeKey = createContextKey('btx.otel.scope');
+/** Snapshot metadata before starting a span so automatic children inherit it. */
+export function traceScopeContext(parent, scope) {
+    const inherited = parent.getValue(scopeKey);
+    const labels = [...new Set([...(inherited?.labels ?? []), ...(scope.labels ?? [])])];
+    const attributes = Object.fromEntries(Object.entries({ ...inherited?.attributes, ...scope.attributes })
+        .map(([key, value]) => [key, Array.isArray(value) ? [...value] : value]));
+    return parent.setValue(scopeKey, Object.freeze({
+        ...scope, attributes: Object.freeze(attributes), labels: Object.freeze(labels),
+        retention: scope.retention ?? inherited?.retention,
+    }));
+}
+/** Release intake evidence once the execution is known to perform actual work. */
+export function retainBtxTrace() {
+    const scope = context.active().getValue(scopeKey);
+    scope?.retention?.decide(true);
+}
+/** Suppress both automatic instrumentation and the BTX export policy. */
+export function withoutBtxTracing(work) {
+    return context.with(suppressTracing(context.active().deleteValue(scopeKey)), work);
+}
+export function activeBtxTraceReference() {
+    const span = trace.getSpanContext(context.active());
+    return span && isSpanContextValid(span) ? { traceId: span.traceId, spanId: span.spanId } : null;
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/dependency.d.ts

@@ -0,0 +1,11 @@
+import type { Attributes } from '@opentelemetry/api';
+import type { BtxClientDependency } from './client-dependency.js';
+export interface BtxDependencyRegistry {
+    readonly services: readonly {
+        name: string;
+        matchesHost: (hostname: string) => boolean;
+    }[];
+    /** Keys use the form 'service METHOD /path'. Values are fixed operation names. */
+    readonly operations: ReadonlyMap<string, string>;
+}
+export declare function dependencyAttributes(source: Attributes, registry?: BtxDependencyRegistry, client?: BtxClientDependency): Attributes;

package/dist/dependency.js

@@ -0,0 +1,35 @@
+const identifier = /^[a-z][a-z0-9_.]{0,95}$/;
+const methods = new Set(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS', 'CONNECT', 'TRACE']);
+export function dependencyAttributes(source, registry, client) {
+    const attrs = {};
+    const method = source['http.request.method'] ?? source['http.method'];
+    if (typeof method === 'string' && methods.has(method))
+        attrs['http.request.method'] = method;
+    const status = source['http.response.status_code'] ?? source['http.status_code'];
+    if (typeof status === 'number' && Number.isInteger(status) && status >= 100 && status <= 599)
+        attrs['http.response.status_code'] = status;
+    if (client)
+        return {
+            ...attrs,
+            'btx.dependency.service': client.service,
+            'btx.dependency.resource': client.resource,
+            'btx.dependency.resource_kind': client.resourceKind,
+        };
+    if (!registry)
+        return attrs;
+    const raw = source['url.full'] ?? source['http.url'];
+    if (typeof raw !== 'string' || !URL.canParse(raw))
+        return attrs;
+    const url = new URL(raw);
+    if (url.protocol !== 'https:' || url.port)
+        return attrs;
+    const service = registry.services.find(entry => entry.matchesHost(url.hostname))?.name;
+    if (!service || !identifier.test(service))
+        return attrs;
+    attrs['btx.dependency.service'] = service;
+    const operation = registry.operations.get(`${service} ${attrs['http.request.method']} ${url.pathname}`);
+    if (operation && identifier.test(operation))
+        attrs['btx.dependency.operation'] = operation;
+    return attrs;
+}
+//# sourceMappingURL=dependency.js.map

package/dist/dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency.js","sourceRoot":"","sources":["../src/dependency.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,GAAG,yBAAyB,CAAA;AAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAA;AAEzG,MAAM,UAAU,oBAAoB,CAAC,MAAkB,EAAE,QAAgC,EAAE,MAA4B;IACrH,MAAM,KAAK,GAAe,EAAE,CAAA;IAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,qBAAqB,CAAC,IAAI,MAAM,CAAC,aAAa,CAAC,CAAA;IACrE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,KAAK,CAAC,qBAAqB,CAAC,GAAG,MAAM,CAAA;IAC5F,MAAM,MAAM,GAAG,MAAM,CAAC,2BAA2B,CAAC,IAAI,MAAM,CAAC,kBAAkB,CAAC,CAAA;IAChF,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG;QAC1F,KAAK,CAAC,2BAA2B,CAAC,GAAG,MAAM,CAAA;IAC7C,IAAI,MAAM;QAAE,OAAO;YACjB,GAAG,KAAK;YACR,wBAAwB,EAAE,MAAM,CAAC,OAAO;YACxC,yBAAyB,EAAE,MAAM,CAAC,QAAQ;YAC1C,8BAA8B,EAAE,MAAM,CAAC,YAAY;SACpD,CAAA;IACD,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,CAAA;IACpD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA;IAC/D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;IACxB,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI;QAAE,OAAO,KAAK,CAAA;IACvD,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAA;IACtF,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAA;IACvD,KAAK,CAAC,wBAAwB,CAAC,GAAG,OAAO,CAAA;IACzC,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,OAAO,IAAI,KAAK,CAAC,qBAAqB,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAA;IACvG,IAAI,SAAS,IAAI,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,KAAK,CAAC,0BAA0B,CAAC,GAAG,SAAS,CAAA;IAC1F,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { retainBtxTrace, BtxTraceRetention, activeBtxTraceReference, withoutBtxTracing } from './context.js';
+export { createBtxSpanProcessor, BTX_OTEL_LIMITS, type BtxExportObservation, type BtxSpanProcessorOptions } from './processor.js';
+export type { BtxDependencyRegistry } from './dependency.js';
+export { withBtxClientDependency, type BtxClientDependency } from './client-dependency.js';
+export { BTX_OTEL_SPAN_LIMITS, trace, type BtxSpan, type BtxSpanOutcome, type TraceOptions } from './span.js';

package/dist/index.js

@@ -0,0 +1,5 @@
+export { retainBtxTrace, BtxTraceRetention, activeBtxTraceReference, withoutBtxTracing } from './context.js';
+export { createBtxSpanProcessor, BTX_OTEL_LIMITS } from './processor.js';
+export { withBtxClientDependency } from './client-dependency.js';
+export { BTX_OTEL_SPAN_LIMITS, trace } from './span.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":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAC5G,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAA2D,MAAM,gBAAgB,CAAA;AAEjI,OAAO,EAAE,uBAAuB,EAA4B,MAAM,wBAAwB,CAAA;AAC1F,OAAO,EAAE,oBAAoB,EAAE,KAAK,EAAwD,MAAM,WAAW,CAAA"}

package/dist/processor.d.ts

@@ -0,0 +1,29 @@
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-proto';
+import { type SpanExporter, type SpanProcessor } from '@opentelemetry/sdk-trace';
+import type { BtxDependencyRegistry } from './dependency.js';
+export declare const BTX_OTEL_LIMITS: Readonly<{
+    queue: 512;
+    batch: 128;
+    exportMs: 1000;
+    flushMs: 1500;
+}>;
+export type BtxExportObservation = {
+    outcome: 'accepted' | 'failed' | 'overflow' | 'projection_failed';
+    spans: number;
+};
+export interface BtxSpanProcessorOptions {
+    /** Standard OTLP/HTTP Protobuf configuration, including standard OTel environment defaults. */
+    otlp?: ConstructorParameters<typeof OTLPTraceExporter>[0];
+    /** An existing OTel exporter, for applications that already own their transport. */
+    exporter?: SpanExporter;
+    dependencyRegistry?: BtxDependencyRegistry;
+    /** Export only trace() operations and their children. Default: false. */
+    requireScope?: boolean;
+    maxQueueSize?: number;
+    maxExportBatchSize?: number;
+    scheduledDelayMillis?: number;
+    exportTimeoutMillis?: number;
+    flushTimeoutMillis?: number;
+    onExport?: (observation: BtxExportObservation) => void;
+}
+export declare function createBtxSpanProcessor(options?: BtxSpanProcessorOptions): SpanProcessor;

package/dist/processor.js

@@ -0,0 +1,142 @@
+import { TraceFlags } from '@opentelemetry/api';
+import { ExportResultCode, isTracingSuppressed } from '@opentelemetry/core';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-proto';
+import { BatchSpanProcessor } from '@opentelemetry/sdk-trace';
+import { scopeKey, withoutBtxTracing } from './context.js';
+import { exportSpan } from './projection.js';
+import { clientDependencyKey, matchingClientDependency } from './client-dependency.js';
+export const BTX_OTEL_LIMITS = Object.freeze({ queue: 512, batch: 128, exportMs: 1_000, flushMs: 1_500 });
+export function createBtxSpanProcessor(options = {}) {
+    const positive = (value, fallback) => {
+        if (value === undefined)
+            return fallback;
+        if (!Number.isSafeInteger(value) || value <= 0)
+            throw new Error('Exporter limits must be positive integers');
+        return value;
+    };
+    const queue = positive(options.maxQueueSize, BTX_OTEL_LIMITS.queue);
+    const batchSize = positive(options.maxExportBatchSize, Math.min(BTX_OTEL_LIMITS.batch, queue));
+    if (batchSize > queue)
+        throw new Error('Export batch size exceeds queue size');
+    const exportMs = positive(options.exportTimeoutMillis ?? options.otlp?.timeoutMillis, BTX_OTEL_LIMITS.exportMs);
+    const flushMs = positive(options.flushTimeoutMillis, BTX_OTEL_LIMITS.flushMs);
+    const delayMs = positive(options.scheduledDelayMillis, 5_000);
+    if (options.exporter && options.otlp)
+        throw new Error('Configure either OTLP or an existing exporter');
+    const transport = options.exporter ?? new OTLPTraceExporter({ ...options.otlp, timeoutMillis: exportMs });
+    const scopes = new WeakMap();
+    const dependencies = new WeakMap();
+    let pending = 0;
+    let stopped = false;
+    const observe = (outcome, spans) => {
+        try {
+            withoutBtxTracing(() => options.onExport?.({ outcome, spans }));
+        }
+        catch { /* Preserve application work. */ }
+    };
+    const inFlight = new Set();
+    const exporter = {
+        export(spans, callback) {
+            let done;
+            const sending = new Promise(resolve => { done = resolve; });
+            inFlight.add(sending);
+            let completed = false;
+            const timer = setTimeout(() => finish({ code: ExportResultCode.FAILED,
+                error: new Error('Trace export deadline exceeded') }), exportMs);
+            const finish = result => {
+                if (completed)
+                    return;
+                completed = true;
+                clearTimeout(timer);
+                pending -= spans.length;
+                inFlight.delete(sending);
+                done();
+                observe(result.code === ExportResultCode.SUCCESS ? 'accepted' : 'failed', spans.length);
+                callback(result);
+            };
+            void withoutBtxTracing(async () => {
+                await Promise.all(spans.map(span => span.resource.waitForAsyncAttributes?.()));
+                if (!completed)
+                    transport.export(spans, finish);
+            }).catch(() => finish({ code: ExportResultCode.FAILED, error: new Error('Trace export failed') }));
+        },
+        shutdown: () => withoutBtxTracing(() => transport.shutdown()),
+    };
+    const batch = new BatchSpanProcessor({ exporter, maxQueueSize: queue,
+        maxExportBatchSize: batchSize, scheduledDelayMillis: delayMs,
+        exportTimeoutMillis: exportMs });
+    let flushing;
+    const flush = () => flushing ??= bounded((async () => {
+        await batch.forceFlush();
+        await Promise.all([...inFlight]);
+    })(), flushMs).finally(() => { flushing = undefined; });
+    return {
+        onStart(span, parent) {
+            try {
+                const scope = parent.getValue(scopeKey);
+                if (!stopped && !isTracingSuppressed(parent) && (!options.requireScope || scope)) {
+                    scopes.set(span, scope ?? {});
+                    const dependency = parent.getValue(clientDependencyKey);
+                    if (span.kind === 2 && dependency)
+                        dependencies.set(span, dependency);
+                }
+            }
+            catch { /* Ignore instrumentation failures. */ }
+        },
+        onEnd(span) {
+            try {
+                const scope = scopes.get(span);
+                scopes.delete(span);
+                const dependency = dependencies.get(span);
+                dependencies.delete(span);
+                if (!scope || stopped || !(span.spanContext().traceFlags & TraceFlags.SAMPLED))
+                    return;
+                if (span.status.code === 2)
+                    scope.retention?.preserveFailure();
+                if (pending >= queue) {
+                    observe('overflow', 1);
+                    return;
+                }
+                const copy = exportSpan(span, scope, options.dependencyRegistry, matchingClientDependency(dependency, span.attributes));
+                pending++;
+                const enqueue = (retain) => {
+                    if (retain && !stopped)
+                        batch.onEnd(copy);
+                    else
+                        pending--;
+                };
+                if (scope.retention)
+                    scope.retention.whenDecided(enqueue);
+                else
+                    enqueue(true);
+            }
+            catch {
+                observe('projection_failed', 1);
+            }
+        },
+        forceFlush: flush,
+        async shutdown() {
+            if (stopped)
+                return;
+            stopped = true;
+            try {
+                await flush();
+            }
+            finally {
+                await bounded(batch.shutdown(), flushMs);
+            }
+        },
+    };
+}
+async function bounded(work, timeoutMs) {
+    let timer;
+    try {
+        await Promise.race([work, new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error('Trace flush deadline exceeded')), timeoutMs);
+            })]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=processor.js.map

package/dist/processor.js.map

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

package/dist/projection.d.ts

@@ -0,0 +1,6 @@
+import type { ReadableSpan } from '@opentelemetry/sdk-trace';
+import { type BtxDependencyRegistry } from './dependency.js';
+import type { TraceMetadata } from './context.js';
+import type { BtxClientDependency } from './client-dependency.js';
+/** Copy at span end without filtering or rewriting the instrumented evidence. */
+export declare function exportSpan(span: ReadableSpan, scope: TraceMetadata, registry?: BtxDependencyRegistry, client?: BtxClientDependency): ReadableSpan;

package/dist/projection.js

@@ -0,0 +1,48 @@
+import { dependencyAttributes } from './dependency.js';
+/** Copy at span end without filtering or rewriting the instrumented evidence. */
+export function exportSpan(span, scope, registry, client) {
+    const attributes = {
+        ...(span.kind === 2 ? dependencyAttributes(span.attributes, registry, client) : {}),
+        ...scope.attributes,
+        ...span.attributes
+    };
+    // Trusted correlation is additive; authored values remain intact.
+    const labels = attributes['btx.labels'];
+    if (labels === undefined)
+        attributes['btx.labels'] = [...(scope.labels ?? [])];
+    else if (Array.isArray(labels) && labels.every((label) => typeof label === 'string'))
+        attributes['btx.labels'] = [
+            ...labels,
+            ...(scope.labels ?? []).filter((label) => !labels.includes(label))
+        ];
+    const copyAttributes = (source) => Object.fromEntries(Object.entries(source).map(([key, value]) => [key, Array.isArray(value) ? [...value] : value]));
+    const spanContext = { ...span.spanContext() };
+    return {
+        name: span.name,
+        kind: span.kind,
+        spanContext: () => spanContext,
+        parentSpanContext: span.parentSpanContext && { ...span.parentSpanContext },
+        startTime: [...span.startTime],
+        endTime: [...span.endTime],
+        duration: [...span.duration],
+        ended: span.ended,
+        status: { ...span.status },
+        attributes: copyAttributes(attributes),
+        resource: span.resource,
+        instrumentationScope: { ...span.instrumentationScope },
+        events: span.events.map((event) => ({
+            ...event,
+            time: [...event.time],
+            attributes: event.attributes && copyAttributes(event.attributes)
+        })),
+        links: span.links.map((link) => ({
+            ...link,
+            context: { ...link.context },
+            attributes: link.attributes && copyAttributes(link.attributes)
+        })),
+        droppedAttributesCount: span.droppedAttributesCount,
+        droppedEventsCount: span.droppedEventsCount,
+        droppedLinksCount: span.droppedLinksCount
+    };
+}
+//# sourceMappingURL=projection.js.map

package/dist/projection.js.map

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

package/dist/span.d.ts

@@ -0,0 +1,28 @@
+import { type Attributes, type SpanKind } from '@opentelemetry/api';
+import { type TraceMetadata } from './context.js';
+/** Disable content limits independently of the export queue and deadlines. */
+export declare const BTX_OTEL_SPAN_LIMITS: Readonly<{
+    attributeCountLimit: number;
+    attributeValueLengthLimit: number;
+    eventCountLimit: number;
+    linkCountLimit: number;
+    attributePerEventCountLimit: number;
+    attributePerLinkCountLimit: number;
+}>;
+export interface BtxSpan {
+    /** OTel attributes are retained without exporter filtering or truncation. */
+    setAttributes(attributes: Attributes): void;
+}
+export interface BtxSpanOutcome {
+    error?: boolean;
+    attributes?: Attributes;
+}
+export interface TraceOptions<T = unknown> extends TraceMetadata {
+    kind?: SpanKind;
+    outcome?: (result: T) => BtxSpanOutcome;
+}
+type TraceWork<T> = (span: BtxSpan) => T | PromiseLike<T>;
+/** Run work in an active span, ending it when the work settles. */
+export declare function trace<T>(name: string, work: TraceWork<T>): Promise<T>;
+export declare function trace<T>(name: string, options: TraceOptions<NoInfer<T>>, work: TraceWork<T>): Promise<T>;
+export {};

package/dist/span.js

@@ -0,0 +1,90 @@
+import { context, SpanStatusCode, trace as otelTrace } from '@opentelemetry/api';
+import { isTracingSuppressed } from '@opentelemetry/core';
+import { traceScopeContext } from './context.js';
+/** Disable content limits independently of the export queue and deadlines. */
+export const BTX_OTEL_SPAN_LIMITS = Object.freeze({
+    attributeCountLimit: Infinity, attributeValueLengthLimit: Infinity,
+    eventCountLimit: Infinity, linkCountLimit: Infinity,
+    attributePerEventCountLimit: Infinity, attributePerLinkCountLimit: Infinity,
+});
+const noopSpan = Object.freeze({ setAttributes: () => { } });
+function safely(action) {
+    try {
+        action();
+    }
+    catch { /* Instrumentation must preserve application work. */ }
+}
+export async function trace(name, optionsOrWork, callback) {
+    const options = typeof optionsOrWork === 'function' ? {} : optionsOrWork;
+    const work = typeof optionsOrWork === 'function' ? optionsOrWork : callback;
+    let span;
+    let parent;
+    try {
+        parent = context.active();
+        if (!isTracingSuppressed(parent)) {
+            parent = traceScopeContext(parent, options);
+            span = otelTrace.getTracer('@btx-second-context/otel', '0.0.1').startSpan(name, {
+                kind: options.kind, attributes: options.attributes,
+            }, parent);
+            if (span.isRecording())
+                parent = otelTrace.setSpan(parent, span);
+            else
+                span = undefined;
+        }
+    }
+    catch {
+        safely(() => span?.end());
+        span = undefined;
+    }
+    if (!span || !parent)
+        return work(noopSpan);
+    const owned = span;
+    let ended = false;
+    const handle = Object.freeze({
+        setAttributes(attributes) {
+            if (!ended)
+                safely(() => owned.setAttributes(attributes));
+        },
+    });
+    const run = async () => {
+        try {
+            const result = await work(handle);
+            let failed = false;
+            safely(() => {
+                const response = result instanceof Response ? result : undefined;
+                failed = !!response && response.status >= 500;
+                if (response)
+                    owned.setAttribute('http.response.status_code', response.status);
+            });
+            safely(() => {
+                const described = options.outcome?.(result);
+                failed ||= !!described?.error;
+                if (described?.attributes)
+                    handle.setAttributes(described.attributes);
+            });
+            safely(() => owned.setStatus({ code: failed ? SpanStatusCode.ERROR : SpanStatusCode.OK }));
+            return result;
+        }
+        catch (error) {
+            safely(() => owned.setStatus({ code: SpanStatusCode.ERROR, ...(error instanceof Error ? { message: error.message } : {}) }));
+            safely(() => owned.recordException(error instanceof Error || typeof error === 'string' ? error : String(error)));
+            safely(() => owned.setAttribute('error.type', error instanceof Error ? error.name : typeof error));
+            throw error;
+        }
+        finally {
+            ended = true;
+            safely(() => owned.end());
+        }
+    };
+    // A broken context manager can fail before or after invoking its callback.
+    // Reuse the application promise so neither case repeats work or replaces it.
+    let execution;
+    const once = () => execution ??= run();
+    try {
+        return await context.with(parent, once);
+    }
+    catch {
+        return execution ?? once();
+    }
+}
+//# sourceMappingURL=span.js.map

package/dist/span.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"span.js","sourceRoot":"","sources":["../src/span.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,IAAI,SAAS,EAA2D,MAAM,oBAAoB,CAAA;AACzI,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAsB,MAAM,cAAc,CAAA;AAEpE,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;IAChD,mBAAmB,EAAE,QAAQ,EAAE,yBAAyB,EAAE,QAAQ;IAClE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ;IACnD,2BAA2B,EAAE,QAAQ,EAAE,0BAA0B,EAAE,QAAQ;CAC5E,CAAC,CAAA;AAmBF,MAAM,QAAQ,GAAY,MAAM,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,CAAA;AAEpE,SAAS,MAAM,CAAC,MAAkB;IAChC,IAAI,CAAC;QAAC,MAAM,EAAE,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,qDAAqD,CAAC,CAAC;AAClF,CAAC;AAKD,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,IAAY,EACZ,aAA6C,EAC7C,QAAuB;IAEvB,MAAM,OAAO,GAAG,OAAO,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAA;IACxE,MAAM,IAAI,GAAG,OAAO,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAS,CAAA;IAC5E,IAAI,IAAsB,CAAA;IAC1B,IAAI,MAA2B,CAAA;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAA;QACzB,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;YAC3C,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE;gBAC9E,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU;aACnD,EAAE,MAAM,CAAC,CAAA;YACV,IAAI,IAAI,CAAC,WAAW,EAAE;gBAAE,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;;gBAC3D,IAAI,GAAG,SAAS,CAAA;QACvB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAA;QACzB,IAAI,GAAG,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAA;IAE3C,MAAM,KAAK,GAAG,IAAI,CAAA;IAClB,IAAI,KAAK,GAAG,KAAK,CAAA;IACjB,MAAM,MAAM,GAAY,MAAM,CAAC,MAAM,CAAC;QACpC,aAAa,CAAC,UAAsB;YAClC,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAA;QAC3D,CAAC;KACF,CAAC,CAAA;IACF,MAAM,GAAG,GAAG,KAAK,IAAI,EAAE;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAA;YACjC,IAAI,MAAM,GAAG,KAAK,CAAA;YAClB,MAAM,CAAC,GAAG,EAAE;gBACV,MAAM,QAAQ,GAAG,MAAM,YAAY,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;gBAChE,MAAM,GAAG,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,CAAA;gBAC7C,IAAI,QAAQ;oBAAE,KAAK,CAAC,YAAY,CAAC,2BAA2B,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;YAChF,CAAC,CAAC,CAAA;YACF,MAAM,CAAC,GAAG,EAAE;gBACV,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAA;gBAC3C,MAAM,KAAK,CAAC,CAAC,SAAS,EAAE,KAAK,CAAA;gBAC7B,IAAI,SAAS,EAAE,UAAU;oBAAE,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;YACvE,CAAC,CAAC,CAAA;YACF,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;YAC1F,OAAO,MAAM,CAAA;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YAC5H,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,YAAY,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YAChH,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAA;YAClG,MAAM,KAAK,CAAA;QACb,CAAC;gBAAS,CAAC;YACT,KAAK,GAAG,IAAI,CAAA;YACZ,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAA;QAC3B,CAAC;IACH,CAAC,CAAA;IACD,2EAA2E;IAC3E,6EAA6E;IAC7E,IAAI,SAAiC,CAAA;IACrC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,SAAS,KAAK,GAAG,EAAE,CAAA;IACtC,IAAI,CAAC;QAAC,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAAC,CAAC;IAC/C,MAAM,CAAC;QAAC,OAAO,SAAS,IAAI,IAAI,EAAE,CAAA;IAAC,CAAC;AACtC,CAAC"}

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@btx-second-context/otel",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@opentelemetry/core": "2.12.0",
+    "@opentelemetry/exporter-trace-otlp-proto": "0.223.0",
+    "@opentelemetry/sdk-trace": "2.12.0"
+  },
+  "peerDependencies": {
+    "@opentelemetry/api": "^1.9.0"
+  },
+  "devDependencies": {
+    "@opentelemetry/api": "1.9.1",
+    "@opentelemetry/context-async-hooks": "2.12.0",
+    "@opentelemetry/otlp-transformer": "0.223.0",
+    "@opentelemetry/resources": "2.12.0",
+    "@types/node": "^20",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.5"
+  },
+  "description": "OpenTelemetry trace export and Labels for Node backends",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=20.6.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dataporto/btx.git",
+    "directory": "code/packages/btx-otel"
+  },
+  "scripts": {
+    "typecheck": "node ../../node_modules/typescript/bin/tsc --noEmit -p tsconfig.json",
+    "build": "tsc -p tsconfig.build.json",
+    "test": "pnpm build && vitest run --config vitest.config.ts"
+  }
 }