@glasstrace/sdk 1.3.3 → 1.3.5

package/dist/index.d.cts

@@ -351,6 +351,25 @@ declare function waitForReady(timeoutMs?: number): Promise<void>;
 /**
  * Simplified public state query for external consumers.
  * Hides implementation details like coexistence scenarios.
+ *
+ * The returned `tracing` field is the canonical user-observable signal
+ * for OTel coexistence outcomes:
+ *
+ * - `"active"` — the SDK owns the OTel provider and is exporting spans.
+ * - `"coexistence"` — another OTel provider was detected and the SDK
+ *   either auto-attached its span processor or found one already
+ *   present. Spans are exported through the existing pipeline.
+ * - `"degraded"` — the SDK is exporting but the core lifecycle entered
+ *   `ACTIVE_DEGRADED` (e.g., a non-fatal export failure).
+ * - `"not-configured"` — the SDK could not configure tracing. Covers
+ *   `OtelState.UNCONFIGURED`, `OtelState.CONFIGURING`, and
+ *   `OtelState.COEXISTENCE_FAILED` (the DISC-1556 Next 16 production
+ *   "auto-attach returned null" path). When the value is
+ *   `"not-configured"` after `registerGlasstrace()` has resolved,
+ *   spans are NOT reaching the Glasstrace exporter and the manual
+ *   `createGlasstraceSpanProcessor()` workaround should be applied.
+ *   See `runtime-state.json`'s `lastError` field for the structured
+ *   failure record.
  */
 declare function getStatus(): {
     ready: boolean;

package/dist/index.d.ts

@@ -351,6 +351,25 @@ declare function waitForReady(timeoutMs?: number): Promise<void>;
 /**
  * Simplified public state query for external consumers.
  * Hides implementation details like coexistence scenarios.
+ *
+ * The returned `tracing` field is the canonical user-observable signal
+ * for OTel coexistence outcomes:
+ *
+ * - `"active"` — the SDK owns the OTel provider and is exporting spans.
+ * - `"coexistence"` — another OTel provider was detected and the SDK
+ *   either auto-attached its span processor or found one already
+ *   present. Spans are exported through the existing pipeline.
+ * - `"degraded"` — the SDK is exporting but the core lifecycle entered
+ *   `ACTIVE_DEGRADED` (e.g., a non-fatal export failure).
+ * - `"not-configured"` — the SDK could not configure tracing. Covers
+ *   `OtelState.UNCONFIGURED`, `OtelState.CONFIGURING`, and
+ *   `OtelState.COEXISTENCE_FAILED` (the DISC-1556 Next 16 production
+ *   "auto-attach returned null" path). When the value is
+ *   `"not-configured"` after `registerGlasstrace()` has resolved,
+ *   spans are NOT reaching the Glasstrace exporter and the manual
+ *   `createGlasstraceSpanProcessor()` workaround should be applied.
+ *   See `runtime-state.json`'s `lastError` field for the structured
+ *   failure record.
  */
 declare function getStatus(): {
     ready: boolean;

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   registerGlasstrace,
   waitForReady,
   withGlasstraceConfig
-} from "./chunk-XNKG4WNQ.js";
+} from "./chunk-EK6MYHR2.js";
 import {
   GlasstraceSpanProcessor,
   SdkError,

package/dist/node-entry.cjs

@@ -22112,9 +22112,11 @@ This message will not appear once Glasstrace is added to your provider config.`
 }
 function emitGuidanceMessage() {
   const isSentry = detectSentry();
+  const isProduction = typeof process !== "undefined" && process.env?.NODE_ENV === "production";
+  const level = isProduction ? "error" : "warn";
   if (isSentry) {
     sdkLog(
-      "warn",
+      level,
       `[glasstrace] An existing OTel TracerProvider is registered but Glasstrace could not auto-attach its span processor.
 Add Glasstrace to your Sentry config:
 
@@ -22127,7 +22129,7 @@ Add Glasstrace to your Sentry config:
     );
   } else {
     sdkLog(
-      "warn",
+      level,
       `[glasstrace] An existing OTel TracerProvider is registered but Glasstrace could not auto-attach its span processor.
 Add Glasstrace to your provider configuration:
 
@@ -22162,6 +22164,27 @@ function detectSentry() {
   }
 }
 
+// src/proxy-detection.ts
+function isProxyTracerProvider(value) {
+  if (value === null || value === void 0 || typeof value !== "object") {
+    return false;
+  }
+  return "getTracer" in value && typeof value.getTracer === "function" && "getDelegate" in value && typeof value.getDelegate === "function" && "setDelegate" in value && typeof value.setDelegate === "function" && "getDelegateTracer" in value && typeof value.getDelegateTracer === "function";
+}
+function isProxyTracer(value, ownerProvider) {
+  if (value === null || value === void 0 || typeof value !== "object") {
+    return false;
+  }
+  const structurallyShaped = "_getTracer" in value && typeof value._getTracer === "function" && "startSpan" in value && typeof value.startSpan === "function" && "startActiveSpan" in value && typeof value.startActiveSpan === "function";
+  if (!structurallyShaped) {
+    return false;
+  }
+  if (!Object.hasOwn(value, "_provider")) {
+    return false;
+  }
+  return value._provider === ownerProvider;
+}
+
 // src/otel-config.ts
 var resolvedApiKey = API_KEY_PENDING;
 var activeExporter = null;
@@ -22200,7 +22223,7 @@ async function configureOtel(config2, sessionManager) {
   });
   const existingProvider = trace.getTracerProvider();
   const probeTracer = existingProvider.getTracer("glasstrace-probe");
-  const anotherProviderRegistered = probeTracer.constructor.name !== "ProxyTracer";
+  const anotherProviderRegistered = !isProxyTracerProvider(existingProvider) || !isProxyTracer(probeTracer, existingProvider);
   if (anotherProviderRegistered) {
     setCoexistenceState("coexisting");
     await runCoexistencePath(existingProvider, config2);
@@ -22254,11 +22277,27 @@ async function runCoexistencePath(existingProvider, config2) {
   setOtelState(OtelState.COEXISTENCE_FAILED);
   emitLifecycleEvent("otel:configured", { state: OtelState.COEXISTENCE_FAILED, scenario: "C/F" });
   emitLifecycleEvent("otel:injection_failed", { reason: "provider internals inaccessible" });
+  emitLifecycleEvent("otel:failed", {
+    category: "auto-attach-returned-null",
+    message: "tryAutoAttachGlasstraceProcessor returned null \u2014 the existing OTel TracerProvider exposed no injection point. Spans are not reaching the Glasstrace exporter. Apply the manual createGlasstraceSpanProcessor() workaround documented in the SDK README.",
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    providerClass: readProviderClass(existingProvider)
+  });
   const coreState = getCoreState();
   if (coreState === CoreState.ACTIVE || coreState === CoreState.KEY_RESOLVED) {
     setCoreState(CoreState.ACTIVE_DEGRADED);
   }
 }
+function readProviderClass(tracerProvider) {
+  try {
+    const proxy = tracerProvider;
+    const delegate = typeof proxy.getDelegate === "function" ? proxy.getDelegate() : tracerProvider;
+    const name = delegate?.constructor?.name;
+    return typeof name === "string" && name.length > 0 ? name : void 0;
+  } catch {
+    return void 0;
+  }
+}
 async function runRegistrationPath(config2, sessionManager) {
   const exporterUrl = `${config2.endpoint}/v1/traces`;
   const createOtlpExporter = (url2, headers) => new OTLPTraceExporter({ url: url2, headers });
@@ -22561,6 +22600,7 @@ init_console_capture();
 var _projectRoot = null;
 var _sdkVersion = "unknown";
 var _lastScenario;
+var _lastError;
 var _debounceTimer = null;
 var _started = false;
 function startRuntimeStateWriter(options) {
@@ -22583,6 +22623,10 @@ function startRuntimeStateWriter(options) {
     _lastScenario = scenario;
     debouncedWrite();
   });
+  onLifecycleEvent("otel:failed", (payload) => {
+    _lastError = { ...payload };
+    debouncedWrite();
+  });
   onLifecycleEvent("auth:key_resolved", () => debouncedWrite());
   onLifecycleEvent("auth:claim_started", () => debouncedWrite());
   onLifecycleEvent("auth:claim_completed", () => debouncedWrite());
@@ -22610,6 +22654,9 @@ function writeStateNow() {
       auth: { state: state.auth },
       otel: { state: state.otel, scenario: _lastScenario }
     };
+    if (_lastError) {
+      runtimeState.lastError = _lastError;
+    }
     const dir = (0, import_node_path.join)(_projectRoot, ".glasstrace");
     const filePath = (0, import_node_path.join)(dir, "runtime-state.json");
     (0, import_node_fs.mkdirSync)(dir, { recursive: true, mode: 448 });
@@ -22654,7 +22701,7 @@ function registerGlasstrace(options) {
     setCoreState(CoreState.REGISTERING);
     startRuntimeStateWriter({
       projectRoot: process.cwd(),
-      sdkVersion: "1.3.3"
+      sdkVersion: "1.3.5"
     });
     const config2 = resolveConfig(options);
     if (config2.verbose) {
@@ -22670,8 +22717,9 @@ function registerGlasstrace(options) {
     if (config2.verbose) {
       console.info("[glasstrace] Not production-disabled.");
     }
-    const existingProbe = trace.getTracerProvider().getTracer("glasstrace-probe");
-    const anotherProviderRegistered = existingProbe.constructor.name !== "ProxyTracer";
+    const existingTracerProvider = trace.getTracerProvider();
+    const existingProbe = existingTracerProvider.getTracer("glasstrace-probe");
+    const anotherProviderRegistered = !isProxyTracerProvider(existingTracerProvider) || !isProxyTracer(existingProbe, existingTracerProvider);
     if (anotherProviderRegistered) {
       setCoexistenceState("coexisting");
     }
@@ -22820,8 +22868,8 @@ async function backgroundInit(config2, anonKeyForInit, generation) {
   if (config2.verbose) {
     console.info("[glasstrace] Background init firing.");
   }
-  const healthReport = collectHealthReport("1.3.3");
-  const initResult = await performInit(config2, anonKeyForInit, "1.3.3", healthReport);
+  const healthReport = collectHealthReport("1.3.5");
+  const initResult = await performInit(config2, anonKeyForInit, "1.3.5", healthReport);
   if (generation !== registrationGeneration) return;
   const currentState = getCoreState();
   if (currentState === CoreState.SHUTTING_DOWN || currentState === CoreState.SHUTDOWN) {
@@ -22844,7 +22892,7 @@ async function backgroundInit(config2, anonKeyForInit, generation) {
   }
   maybeInstallConsoleCapture();
   if (didLastInitSucceed()) {
-    startHeartbeat(config2, anonKeyForInit, "1.3.3", generation, (newApiKey, accountId) => {
+    startHeartbeat(config2, anonKeyForInit, "1.3.5", generation, (newApiKey, accountId) => {
       setAuthState(AuthState.CLAIMING);
       emitLifecycleEvent("auth:claim_started", { accountId });
       setResolvedApiKey(newApiKey);