@glasstrace/sdk 0.12.1 → 0.12.3

package/dist/index.d.cts

@@ -307,7 +307,7 @@ interface InitClaimResult {
  * or request failure). Callers that do not need claim information
  * can safely ignore the return value.
  */
-declare function performInit(config: ResolvedConfig, anonKey: AnonApiKey | null, sdkVersion: string): Promise<InitClaimResult | null>;
+declare function performInit(config: ResolvedConfig, anonKey: AnonApiKey | null, sdkVersion: string, healthReport?: SdkHealthReport | null): Promise<InitClaimResult | null>;
 /**
  * Returns the current capture config from the three-tier fallback chain:
  * 1. In-memory config from latest init response
@@ -394,6 +394,10 @@ declare class GlasstraceExporter implements SpanExporter {
      */
     notifyKeyResolved(): void;
     shutdown(): Promise<void>;
+    /**
+     * Flushes any pending buffered spans (if the API key has resolved) and
+     * delegates to the underlying exporter's forceFlush to drain its queue.
+     */
     forceFlush(): Promise<void>;
     /**
      * Enriches a ReadableSpan with all glasstrace.* attributes.

package/dist/index.d.ts

@@ -307,7 +307,7 @@ interface InitClaimResult {
  * or request failure). Callers that do not need claim information
  * can safely ignore the return value.
  */
-declare function performInit(config: ResolvedConfig, anonKey: AnonApiKey | null, sdkVersion: string): Promise<InitClaimResult | null>;
+declare function performInit(config: ResolvedConfig, anonKey: AnonApiKey | null, sdkVersion: string, healthReport?: SdkHealthReport | null): Promise<InitClaimResult | null>;
 /**
  * Returns the current capture config from the three-tier fallback chain:
  * 1. In-memory config from latest init response
@@ -394,6 +394,10 @@ declare class GlasstraceExporter implements SpanExporter {
      */
     notifyKeyResolved(): void;
     shutdown(): Promise<void>;
+    /**
+     * Flushes any pending buffered spans (if the API key has resolved) and
+     * delegates to the underlying exporter's forceFlush to drain its queue.
+     */
     forceFlush(): Promise<void>;
     /**
      * Enriches a ReadableSpan with all glasstrace.* attributes.

package/dist/index.js

@@ -9,10 +9,11 @@ import {
   maybeShowMcpNudge,
   readEnvVars,
   resolveConfig,
+  sdkLog,
   uploadSourceMaps,
   uploadSourceMapsAuto,
   uploadSourceMapsPresigned
-} from "./chunk-MSMOH6IH.js";
+} from "./chunk-J576N5MN.js";
 import {
   buildImportGraph,
   discoverTestFiles,
@@ -30,6 +31,7 @@ import {
   SessionIdSchema
 } from "./chunk-OKIP4SRG.js";
 import {
+  DiagLogLevel,
   INVALID_SPAN_CONTEXT,
   SamplingDecision,
   SpanKind,
@@ -173,6 +175,58 @@ function classifyFetchTarget(url) {
   return "unknown";
 }
 
+// src/health-collector.ts
+var tracesExported = 0;
+var tracesDropped = 0;
+var initFailures = 0;
+var lastConfigSyncAt = null;
+function recordSpansExported(count) {
+  if (!Number.isFinite(count) || count < 0 || !Number.isInteger(count)) return;
+  tracesExported += count;
+}
+function recordSpansDropped(count) {
+  if (!Number.isFinite(count) || count < 0 || !Number.isInteger(count)) return;
+  tracesDropped += count;
+}
+function recordInitFailure() {
+  try {
+    initFailures += 1;
+  } catch {
+  }
+}
+function recordConfigSync(timestamp) {
+  try {
+    lastConfigSyncAt = timestamp;
+  } catch {
+  }
+}
+function collectHealthReport(sdkVersion) {
+  try {
+    const now = Date.now();
+    const configAge = lastConfigSyncAt !== null ? Math.max(0, now - lastConfigSyncAt) : 0;
+    return {
+      tracesExportedSinceLastInit: tracesExported,
+      tracesDropped,
+      initFailures,
+      configAge: Math.round(configAge),
+      sdkVersion
+    };
+  } catch {
+    return null;
+  }
+}
+function acknowledgeHealthReport(report) {
+  const exp = Math.max(0, report.tracesExportedSinceLastInit);
+  const expVal = tracesExported - exp;
+  tracesExported = Number.isFinite(expVal) ? Math.max(0, expVal) : tracesExported;
+  const drop = Math.max(0, report.tracesDropped);
+  const dropVal = tracesDropped - drop;
+  tracesDropped = Number.isFinite(dropVal) ? Math.max(0, dropVal) : tracesDropped;
+  const fail = Math.max(0, report.initFailures);
+  const failVal = initFailures - fail;
+  initFailures = Number.isFinite(failVal) ? Math.max(0, failVal) : initFailures;
+}
+
 // src/init-client.ts
 var GLASSTRACE_DIR = ".glasstrace";
 var CONFIG_FILE = "config";
@@ -222,6 +276,7 @@ function loadCachedConfig(projectRoot) {
     }
     const result = SdkInitResponseSchema.safeParse(cached.response);
     if (result.success) {
+      recordConfigSync(cached.cachedAt);
       return result.data;
     }
     console.warn("[glasstrace] Cached config failed validation. Using defaults.");
@@ -372,7 +427,7 @@ async function writeClaimedKey(newApiKey, projectRoot) {
   } catch {
   }
 }
-async function performInit(config, anonKey, sdkVersion) {
+async function performInit(config, anonKey, sdkVersion, healthReport) {
   if (rateLimitBackoff) {
     rateLimitBackoff = false;
     return null;
@@ -391,12 +446,16 @@ async function performInit(config, anonKey, sdkVersion) {
         anonKey,
         sdkVersion,
         void 0,
-        void 0,
+        healthReport ?? void 0,
         void 0,
         controller.signal
       );
       clearTimeout(timeoutId);
       currentConfig = result;
+      recordConfigSync(Date.now());
+      if (healthReport) {
+        acknowledgeHealthReport(healthReport);
+      }
       await saveCachedConfig(result);
       if (result.claimResult) {
         try {
@@ -408,6 +467,7 @@ async function performInit(config, anonKey, sdkVersion) {
       return null;
     } catch (err) {
       clearTimeout(timeoutId);
+      recordInitFailure();
       if (err instanceof DOMException && err.name === "AbortError") {
         console.warn("[glasstrace] ingestion_unreachable: Init request timed out.");
         return null;
@@ -442,6 +502,7 @@ async function performInit(config, anonKey, sdkVersion) {
       return null;
     }
   } catch (err) {
+    recordInitFailure();
     console.warn(
       `[glasstrace] Unexpected init error: ${err instanceof Error ? err.message : String(err)}`
     );
@@ -526,8 +587,15 @@ var GlasstraceExporter = class {
     const enrichedSpans = spans.map((span) => this.enrichSpan(span));
     const exporter = this.ensureDelegate();
     if (exporter) {
-      exporter.export(enrichedSpans, resultCallback);
+      exporter.export(enrichedSpans, (result) => {
+        if (result.code !== 0) {
+          sdkLog("warn", `[glasstrace] Span export failed: ${result.error?.message ?? "unknown error"}`);
+        }
+        resultCallback(result);
+      });
+      recordSpansExported(enrichedSpans.length);
     } else {
+      recordSpansDropped(enrichedSpans.length);
       resultCallback({ code: 0 });
     }
   }
@@ -546,6 +614,7 @@ var GlasstraceExporter = class {
       console.warn(
         `[glasstrace] Shutdown with ${this.pendingSpanCount} buffered spans \u2014 API key never resolved, spans lost.`
       );
+      recordSpansDropped(this.pendingSpanCount);
       for (const batch of this.pendingBatches) {
         batch.resultCallback({ code: 0 });
       }
@@ -556,7 +625,14 @@ var GlasstraceExporter = class {
       return this.delegate.shutdown();
     }
   }
+  /**
+   * Flushes any pending buffered spans (if the API key has resolved) and
+   * delegates to the underlying exporter's forceFlush to drain its queue.
+   */
   forceFlush() {
+    if (this.getApiKey() !== API_KEY_PENDING && this.pendingBatches.length > 0) {
+      this.flushPending();
+    }
     if (this.delegate?.forceFlush) {
       return this.delegate.forceFlush();
     }
@@ -688,6 +764,7 @@ var GlasstraceExporter = class {
     while (this.pendingSpanCount > MAX_PENDING_SPANS && this.pendingBatches.length > 1) {
       const evicted = this.pendingBatches.shift();
       this.pendingSpanCount -= evicted.spans.length;
+      recordSpansDropped(evicted.spans.length);
       evicted.resultCallback({ code: 0 });
       if (!this.overflowLogged) {
         this.overflowLogged = true;
@@ -709,9 +786,12 @@ var GlasstraceExporter = class {
     if (this.pendingBatches.length === 0) return;
     const exporter = this.ensureDelegate();
     if (!exporter) {
+      let discardedCount = 0;
       for (const batch of this.pendingBatches) {
+        discardedCount += batch.spans.length;
         batch.resultCallback({ code: 0 });
       }
+      recordSpansDropped(discardedCount);
       this.pendingBatches = [];
       this.pendingSpanCount = 0;
       return;
@@ -721,7 +801,13 @@ var GlasstraceExporter = class {
     this.pendingSpanCount = 0;
     for (const batch of batches) {
       const enriched = batch.spans.map((span) => this.enrichSpan(span));
-      exporter.export(enriched, batch.resultCallback);
+      exporter.export(enriched, (result) => {
+        if (result.code !== 0) {
+          sdkLog("warn", `[glasstrace] Span export failed: ${result.error?.message ?? "unknown error"}`);
+        }
+        batch.resultCallback(result);
+      });
+      recordSpansExported(enriched.length);
     }
   }
 };
@@ -3511,7 +3597,21 @@ async function configureOtel(config, sessionManager) {
     _activeExporter = null;
     return;
   }
-  const processor = new BatchSpanProcessor(glasstraceExporter);
+  if (config.verbose) {
+    diag.setLogger(
+      {
+        verbose: (msg) => sdkLog("info", `[otel] ${msg}`),
+        debug: (msg) => sdkLog("info", `[otel] ${msg}`),
+        info: (msg) => sdkLog("info", `[otel] ${msg}`),
+        warn: (msg) => sdkLog("warn", `[otel] ${msg}`),
+        error: (msg) => sdkLog("error", `[otel] ${msg}`)
+      },
+      DiagLogLevel.WARN
+    );
+  }
+  const processor = new BatchSpanProcessor(glasstraceExporter, {
+    scheduledDelayMillis: 1e3
+  });
   const provider = new BasicTracerProvider({
     spanProcessors: [processor]
   });
@@ -3672,7 +3772,8 @@ async function backgroundInit(config, anonKeyForInit, generation) {
   if (config.verbose) {
     console.info("[glasstrace] Background init firing.");
   }
-  const initResult = await performInit(config, anonKeyForInit, "0.12.1");
+  const healthReport = collectHealthReport("0.12.3");
+  const initResult = await performInit(config, anonKeyForInit, "0.12.3", healthReport);
   if (generation !== registrationGeneration) return;
   if (initResult?.claimResult) {
     setResolvedApiKey(initResult.claimResult.newApiKey);
@@ -3746,7 +3847,7 @@ async function handleSourceMapUpload(distDir) {
       );
       return;
     }
-    const { discoverSourceMapFiles: discoverSourceMapFiles2, computeBuildHash: computeBuildHash2, uploadSourceMaps: uploadSourceMaps2 } = await import("./source-map-uploader-ZFCYOURS.js");
+    const { discoverSourceMapFiles: discoverSourceMapFiles2, computeBuildHash: computeBuildHash2, uploadSourceMaps: uploadSourceMaps2 } = await import("./source-map-uploader-ZHD654EG.js");
     const files = await discoverSourceMapFiles2(distDir);
     if (files.length === 0) {
       console.info("[glasstrace] No source map files found. Skipping upload.");