@glasstrace/sdk 1.3.3 → 1.3.4

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-XFNK4YEW.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:
 
@@ -22254,11 +22256,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 +22579,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 +22602,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 +22633,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 +22680,7 @@ function registerGlasstrace(options) {
     setCoreState(CoreState.REGISTERING);
     startRuntimeStateWriter({
       projectRoot: process.cwd(),
-      sdkVersion: "1.3.3"
+      sdkVersion: "1.3.4"
     });
     const config2 = resolveConfig(options);
     if (config2.verbose) {
@@ -22820,8 +22846,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.4");
+  const initResult = await performInit(config2, anonKeyForInit, "1.3.4", healthReport);
   if (generation !== registrationGeneration) return;
   const currentState = getCoreState();
   if (currentState === CoreState.SHUTTING_DOWN || currentState === CoreState.SHUTDOWN) {
@@ -22844,7 +22870,7 @@ async function backgroundInit(config2, anonKeyForInit, generation) {
   }
   maybeInstallConsoleCapture();
   if (didLastInitSucceed()) {
-    startHeartbeat(config2, anonKeyForInit, "1.3.3", generation, (newApiKey, accountId) => {
+    startHeartbeat(config2, anonKeyForInit, "1.3.4", generation, (newApiKey, accountId) => {
       setAuthState(AuthState.CLAIMING);
       emitLifecycleEvent("auth:claim_started", { accountId });
       setResolvedApiKey(newApiKey);