@dxos/observability 0.10.0 → 0.11.0

package/dist/lib/browser/traces-browser-H4NCYCVZ.mjs

@@ -1,154 +0,0 @@
-import {
-  resolveOtlpUrl
-} from "./chunk-PSFTIG54.mjs";
-import "./chunk-J5LGTIGS.mjs";
-
-// src/extensions/otel/traces-browser.ts
-import { ROOT_CONTEXT, SpanStatusCode, context as otelContext, propagation, trace } from "@opentelemetry/api";
-import { getWebAutoInstrumentations } from "@opentelemetry/auto-instrumentations-web";
-import { W3CTraceContextPropagator } from "@opentelemetry/core";
-import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
-import { registerInstrumentations } from "@opentelemetry/instrumentation";
-import { AlwaysOnSampler, BatchSpanProcessor, ParentBasedSampler, TraceIdRatioBasedSampler } from "@opentelemetry/sdk-trace-base";
-import { WebTracerProvider } from "@opentelemetry/sdk-trace-web";
-import { ATTR_SERVICE_VERSION } from "@opentelemetry/semantic-conventions";
-import { log as log2 } from "@dxos/log";
-import { TRACE_ALL_KEY, TRACE_PROCESSOR } from "@dxos/tracing";
-
-// src/extensions/otel/span-processors.ts
-import { log } from "@dxos/log";
-var __dxlog_file = "/__w/dxos/dxos/packages/sdk/observability/src/extensions/otel/span-processors.ts";
-var TagInjectorSpanProcessor = class {
-  _getTags;
-  constructor(_getTags) {
-    this._getTags = _getTags;
-  }
-  onStart(span, _parentContext) {
-    let tags;
-    try {
-      tags = this._getTags();
-    } catch (err) {
-      log.catch(err, void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file, L: 28, S: this });
-      return;
-    }
-    for (const [key, value] of Object.entries(tags)) {
-      span.setAttribute(key, value);
-    }
-  }
-  onEnd(_span) {
-  }
-  async shutdown() {
-  }
-  async forceFlush() {
-  }
-};
-
-// src/extensions/otel/traces-browser.ts
-var __dxlog_file2 = "/__w/dxos/dxos/packages/sdk/observability/src/extensions/otel/traces-browser.ts";
-var OtelTraces = class {
-  options;
-  _tracer;
-  _tracerProvider;
-  constructor(options) {
-    this.options = options;
-    propagation.setGlobalPropagator(new W3CTraceContextPropagator());
-    const forceTraceAll = typeof localStorage !== "undefined" && localStorage.getItem(TRACE_ALL_KEY) === "true";
-    this._tracerProvider = new WebTracerProvider({
-      resource: this.options.resource,
-      sampler: new ParentBasedSampler({
-        root: forceTraceAll ? new AlwaysOnSampler() : new TraceIdRatioBasedSampler(0.3)
-      }),
-      spanProcessors: [
-        new TagInjectorSpanProcessor(this.options.getTags),
-        new BatchSpanProcessor(new OTLPTraceExporter({
-          url: resolveOtlpUrl(this.options.endpoint + "/v1/traces"),
-          headers: this.options.headers,
-          concurrencyLimit: 10
-        }), {
-          scheduledDelayMillis: 5e3
-        })
-      ]
-    });
-    trace.setGlobalTracerProvider(this._tracerProvider);
-    this._tracer = trace.getTracer("dxos-observability", this.options.resource.attributes[ATTR_SERVICE_VERSION]?.toString());
-  }
-  /**
-  * Forcibly flush the BatchSpanProcessor. Call before process exit / page unload
-  * to avoid losing queued spans (which manifests as "Missing Span" in SigNoz —
-  * their already-exported children reference a parent that never made it to OTLP).
-  */
-  async flush() {
-    await this._tracerProvider.forceFlush();
-  }
-  /**
-  * Flush + shut down the tracer provider via `WebTracerProvider.shutdown()`,
-  * which forces a final export then terminates all span processors.
-  *
-  * Terminal and effectively one-shot: safe to call after `flush()`, but
-  * `flush()` MUST NOT be called after `close()` — shutdown stops further
-  * exporting, so subsequent `close()`/`flush()` calls resolve without
-  * emitting new spans.
-  */
-  async close() {
-    await this._tracerProvider.shutdown();
-  }
-  start() {
-    log2("trace processor registered", void 0, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 62, S: this });
-    registerInstrumentations({
-      instrumentations: [
-        getWebAutoInstrumentations({
-          "@opentelemetry/instrumentation-fetch": {
-            enabled: false,
-            ignoreUrls: [
-              /api\.ipdata\.co/
-            ]
-          },
-          "@opentelemetry/instrumentation-document-load": {
-            enabled: false
-          },
-          "@opentelemetry/instrumentation-xml-http-request": {
-            enabled: false
-          },
-          "@opentelemetry/instrumentation-user-interaction": {
-            enabled: false
-          }
-        })
-      ]
-    });
-    const tracer = this._tracer;
-    TRACE_PROCESSOR.tracingBackend = {
-      startSpan: (options) => {
-        log2("begin otel trace", {
-          options
-        }, { "~LogMeta": "~LogMeta", F: __dxlog_file2, L: 87, S: this });
-        const parentCtx = options.parentContext ? propagation.extract(ROOT_CONTEXT, {
-          traceparent: options.parentContext.traceparent,
-          tracestate: options.parentContext.tracestate ?? ""
-        }) : otelContext.active();
-        const span = tracer.startSpan(options.name, options, parentCtx);
-        const sc = span.spanContext();
-        const spanContext = sc && sc.traceId && sc.spanId ? {
-          traceparent: `00-${sc.traceId}-${sc.spanId}-${(sc.traceFlags ?? 0).toString(16).padStart(2, "0")}`,
-          tracestate: sc.traceState?.serialize()
-        } : void 0;
-        return {
-          end: (endTime) => span.end(endTime),
-          setError: (err) => {
-            if (err instanceof Error) {
-              span.recordException(err);
-            }
-            span.setStatus({
-              code: SpanStatusCode.ERROR,
-              message: err instanceof Error ? err.message : String(err)
-            });
-          },
-          spanContext
-        };
-      }
-    };
-  }
-};
-export {
-  OtelTraces
-};
-//# sourceMappingURL=traces-browser-H4NCYCVZ.mjs.map

package/dist/lib/browser/traces-browser-H4NCYCVZ.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/extensions/otel/traces-browser.ts", "../../../src/extensions/otel/span-processors.ts"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport {\n  ROOT_CONTEXT,\n  SpanStatusCode,\n  type Tracer,\n  context as otelContext,\n  propagation,\n  trace,\n} from '@opentelemetry/api';\nimport { getWebAutoInstrumentations } from '@opentelemetry/auto-instrumentations-web';\nimport { W3CTraceContextPropagator } from '@opentelemetry/core';\nimport { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';\nimport { registerInstrumentations } from '@opentelemetry/instrumentation';\nimport {\n  AlwaysOnSampler,\n  BatchSpanProcessor,\n  ParentBasedSampler,\n  TraceIdRatioBasedSampler,\n} from '@opentelemetry/sdk-trace-base';\nimport { WebTracerProvider } from '@opentelemetry/sdk-trace-web';\nimport { ATTR_SERVICE_VERSION } from '@opentelemetry/semantic-conventions';\n\nimport { log } from '@dxos/log';\nimport { type RemoteSpan, type StartSpanOptions, TRACE_ALL_KEY, TRACE_PROCESSOR } from '@dxos/tracing';\n\nimport { type OtelOptions, resolveOtlpUrl } from './otel';\nimport { TagInjectorSpanProcessor } from './span-processors';\n\nexport class OtelTraces {\n  private _tracer: Tracer;\n  private readonly _tracerProvider: WebTracerProvider;\n\n  constructor(private readonly options: OtelOptions) {\n    propagation.setGlobalPropagator(new W3CTraceContextPropagator());\n\n    const forceTraceAll = typeof localStorage !== 'undefined' && localStorage.getItem(TRACE_ALL_KEY) === 'true';\n\n    this._tracerProvider = new WebTracerProvider({\n      resource: this.options.resource,\n      sampler: new ParentBasedSampler({\n        root: forceTraceAll ? new AlwaysOnSampler() : new TraceIdRatioBasedSampler(0.3),\n      }),\n      spanProcessors: [\n        new TagInjectorSpanProcessor(this.options.getTags),\n        new BatchSpanProcessor(\n          new OTLPTraceExporter({\n            url: resolveOtlpUrl(this.options.endpoint + '/v1/traces'),\n            headers: this.options.headers,\n            concurrencyLimit: 10,\n          }),\n          { scheduledDelayMillis: 5_000 },\n        ),\n      ],\n    });\n\n    trace.setGlobalTracerProvider(this._tracerProvider);\n\n    this._tracer = trace.getTracer(\n      'dxos-observability',\n      this.options.resource.attributes[ATTR_SERVICE_VERSION]?.toString(),\n    );\n  }\n\n  /**\n   * Forcibly flush the BatchSpanProcessor. Call before process exit / page unload\n   * to avoid losing queued spans (which manifests as \"Missing Span\" in SigNoz —\n   * their already-exported children reference a parent that never made it to OTLP).\n   */\n  public async flush(): Promise<void> {\n    await this._tracerProvider.forceFlush();\n  }\n\n  /**\n   * Flush + shut down the tracer provider via `WebTracerProvider.shutdown()`,\n   * which forces a final export then terminates all span processors.\n   *\n   * Terminal and effectively one-shot: safe to call after `flush()`, but\n   * `flush()` MUST NOT be called after `close()` — shutdown stops further\n   * exporting, so subsequent `close()`/`flush()` calls resolve without\n   * emitting new spans.\n   */\n  public async close(): Promise<void> {\n    await this._tracerProvider.shutdown();\n  }\n\n  public start(): void {\n    log('trace processor registered');\n\n    registerInstrumentations({\n      instrumentations: [\n        getWebAutoInstrumentations({\n          '@opentelemetry/instrumentation-fetch': { enabled: false, ignoreUrls: [/api\\.ipdata\\.co/] },\n          '@opentelemetry/instrumentation-document-load': { enabled: false },\n          '@opentelemetry/instrumentation-xml-http-request': { enabled: false },\n          '@opentelemetry/instrumentation-user-interaction': { enabled: false },\n        }),\n      ],\n    });\n\n    const tracer = this._tracer;\n\n    TRACE_PROCESSOR.tracingBackend = {\n      startSpan: (options: StartSpanOptions): RemoteSpan => {\n        log('begin otel trace', { options });\n        const parentCtx = options.parentContext\n          ? propagation.extract(ROOT_CONTEXT, {\n              traceparent: options.parentContext.traceparent,\n              tracestate: options.parentContext.tracestate ?? '',\n            })\n          : otelContext.active();\n\n        const span = tracer.startSpan(options.name, options, parentCtx);\n\n        const sc = span.spanContext();\n        const spanContext =\n          sc && sc.traceId && sc.spanId\n            ? {\n                traceparent: `00-${sc.traceId}-${sc.spanId}-${(sc.traceFlags ?? 0).toString(16).padStart(2, '0')}`,\n                tracestate: sc.traceState?.serialize(),\n              }\n            : undefined;\n\n        return {\n          end: (endTime?: number) => span.end(endTime),\n          setError: (err: unknown) => {\n            if (err instanceof Error) {\n              span.recordException(err);\n            }\n            span.setStatus({ code: SpanStatusCode.ERROR, message: err instanceof Error ? err.message : String(err) });\n          },\n          spanContext,\n        };\n      },\n    };\n  }\n}\n", "//\n// Copyright 2025 DXOS.org\n//\n\nimport { type Context } from '@opentelemetry/api';\nimport { type ReadableSpan, type Span, type SpanProcessor } from '@opentelemetry/sdk-trace-base';\n\nimport { log } from '@dxos/log';\n\n/**\n * Injects dynamic tags as attributes on every span.\n *\n * This is an `onStart`-only processor; `onEnd`/`shutdown`/`forceFlush` are no-ops\n * because this processor never holds pending work (delegates export to downstream\n * processors like BatchSpanProcessor).\n *\n * Use for tags that are not known at provider construction (e.g. identity\n * resolved asynchronously after login). For values known at startup, prefer\n * putting them on the `Resource` — see `extension.ts`.\n *\n * Failures in the tag provider are swallowed so they can never break span\n * recording (the processor is best-effort and runs on the startSpan hot path).\n */\nexport class TagInjectorSpanProcessor implements SpanProcessor {\n  constructor(private readonly _getTags: () => Record<string, string>) {}\n\n  onStart(span: Span, _parentContext: Context): void {\n    let tags: Record<string, string>;\n    try {\n      tags = this._getTags();\n    } catch (err) {\n      log.catch(err);\n      return;\n    }\n    for (const [key, value] of Object.entries(tags)) {\n      span.setAttribute(key, value);\n    }\n  }\n\n  onEnd(_span: ReadableSpan): void {}\n\n  async shutdown(): Promise<void> {}\n\n  async forceFlush(): Promise<void> {}\n}\n"],
-  "mappings": "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",
-  "names": ["ROOT_CONTEXT", "SpanStatusCode", "context", "otelContext", "propagation", "trace", "getWebAutoInstrumentations", "W3CTraceContextPropagator", "OTLPTraceExporter", "registerInstrumentations", "AlwaysOnSampler", "BatchSpanProcessor", "ParentBasedSampler", "TraceIdRatioBasedSampler", "WebTracerProvider", "ATTR_SERVICE_VERSION", "log", "TRACE_ALL_KEY", "TRACE_PROCESSOR", "log", "_getTags", "onStart", "span", "_parentContext", "tags", "catch", "err", "onEnd", "forceFlush", "__dxlog_file", "OtelTraces", "_tracer", "_tracerProvider", "propagation", "setGlobalPropagator", "forceTraceAll", "WebTracerProvider", "resource", "options", "sampler", "ParentBasedSampler", "spanProcessors", "BatchSpanProcessor", "url", "endpoint", "headers", "concurrencyLimit", "scheduledDelayMillis", "trace", "start", "registerInstrumentations", "instrumentations", "getWebAutoInstrumentations", "TRACE_PROCESSOR", "startSpan", "log", "traceparent", "parentContext", "tracestate", "active", "tracer", "name", "spanContext", "sc", "traceId", "spanId", "traceState", "serialize", "undefined", "end", "setError", "err", "Error", "span", "recordException", "setStatus", "message"]
-}

package/dist/lib/node-esm/chunk-EDDZWPYV.mjs

@@ -1,22 +0,0 @@
-import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
-
-// src/extensions/otel/otel.ts
-import { DiagConsoleLogger, DiagLogLevel, diag } from "@opentelemetry/api";
-var setDiagLogger = (level) => {
-  const logLevel = DiagLogLevel[level];
-  if (logLevel) {
-    diag.setLogger(new DiagConsoleLogger(), logLevel);
-  }
-};
-var resolveOtlpUrl = (url) => {
-  if (typeof window !== "undefined" && url.startsWith("/")) {
-    return new URL(url, window.location.origin).toString();
-  }
-  return url;
-};
-
-export {
-  setDiagLogger,
-  resolveOtlpUrl
-};
-//# sourceMappingURL=chunk-EDDZWPYV.mjs.map

package/dist/lib/node-esm/chunk-EDDZWPYV.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/extensions/otel/otel.ts"],
-  "sourcesContent": ["//\n// Copyright 2024 DXOS.org\n//\n\nimport { DiagConsoleLogger, DiagLogLevel, diag } from '@opentelemetry/api';\nimport { type Resource } from '@opentelemetry/resources';\n\nexport type OtelOptions = {\n  endpoint: string;\n  headers: Record<string, string>;\n  resource: Resource;\n  getTags: () => { [key: string]: string };\n  consoleDiagLogLevel?: string;\n};\n\nexport const setDiagLogger = (level?: string) => {\n  const logLevel = DiagLogLevel[level as keyof typeof DiagLogLevel];\n  if (logLevel) {\n    diag.setLogger(new DiagConsoleLogger(), logLevel);\n  }\n};\n\n/**\n * Resolve a possibly-relative OTLP exporter URL to an absolute URL.\n * The OpenTelemetry browser HTTP exporter validates user-provided URLs with `new URL(url)`,\n * which throws on relative paths like `/api/otel/v1/logs`. In a browser context we resolve\n * against `window.location.origin`; outside the browser we return the input unchanged.\n */\nexport const resolveOtlpUrl = (url: string): string => {\n  if (typeof window !== 'undefined' && url.startsWith('/')) {\n    return new URL(url, window.location.origin).toString();\n  }\n  return url;\n};\n"],
-  "mappings": ";;;AAIA,SAASA,mBAAmBC,cAAcC,YAAY;AAW/C,IAAMC,gBAAgB,CAACC,UAAAA;AAC5B,QAAMC,WAAWJ,aAAaG,KAAAA;AAC9B,MAAIC,UAAU;AACZH,SAAKI,UAAU,IAAIN,kBAAAA,GAAqBK,QAAAA;EAC1C;AACF;AAQO,IAAME,iBAAiB,CAACC,QAAAA;AAC7B,MAAI,OAAOC,WAAW,eAAeD,IAAIE,WAAW,GAAA,GAAM;AACxD,WAAO,IAAIC,IAAIH,KAAKC,OAAOG,SAASC,MAAM,EAAEC,SAAQ;EACtD;AACA,SAAON;AACT;",
-  "names": ["DiagConsoleLogger", "DiagLogLevel", "diag", "setDiagLogger", "level", "logLevel", "setLogger", "resolveOtlpUrl", "url", "window", "startsWith", "URL", "location", "origin", "toString"]
-}

package/dist/lib/node-esm/chunk-HSLMI22Q.mjs

@@ -1,11 +0,0 @@
-import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
-var __defProp = Object.defineProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-
-export {
-  __export
-};
-//# sourceMappingURL=chunk-HSLMI22Q.mjs.map

package/dist/lib/node-esm/chunk-HSLMI22Q.mjs.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": [],
-  "sourcesContent": [],
-  "mappings": "",
-  "names": []
-}