@glasstrace/sdk 0.4.0 → 0.4.2

package/dist/index.d.cts

@@ -354,9 +354,13 @@ declare class GlasstraceExporter implements SpanExporter {
      * Enriches a ReadableSpan with all glasstrace.* attributes.
      * Returns a new ReadableSpan wrapper; the original span is not mutated.
      *
-     * External function calls (getSessionId, deriveErrorCategory,
-     * deriveOrmProvider, classifyFetchTarget) are individually guarded so a
-     * failure in one does not prevent the remaining attributes from being set.
+     * Only {@link SessionManager.getSessionId} is individually guarded because
+     * it calls into crypto and schema validation — a session ID failure should
+     * not prevent the rest of enrichment. The other helper calls
+     * ({@link deriveErrorCategory}, {@link deriveOrmProvider},
+     * {@link classifyFetchTarget}) are pure functions on typed string inputs
+     * and rely on the outer catch for any unexpected failure.
+     *
      * On total failure, returns the original span unchanged.
      */
     private enrichSpan;
@@ -467,6 +471,9 @@ declare function uploadSourceMaps(apiKey: string, endpoint: string, buildHash: s
  * explicit, opt-in API for manual error reporting. If no span is active
  * or OTel is not available, the call is silently ignored.
  *
+ * On the first captured error, may display a one-time diagnostic nudge
+ * to stderr if the MCP connection marker is absent (dev environments only).
+ *
  * @param error - The error to capture. Accepts `Error` objects, strings, or any value.
  *
  * @example

package/dist/index.d.ts

@@ -354,9 +354,13 @@ declare class GlasstraceExporter implements SpanExporter {
      * Enriches a ReadableSpan with all glasstrace.* attributes.
      * Returns a new ReadableSpan wrapper; the original span is not mutated.
      *
-     * External function calls (getSessionId, deriveErrorCategory,
-     * deriveOrmProvider, classifyFetchTarget) are individually guarded so a
-     * failure in one does not prevent the remaining attributes from being set.
+     * Only {@link SessionManager.getSessionId} is individually guarded because
+     * it calls into crypto and schema validation — a session ID failure should
+     * not prevent the rest of enrichment. The other helper calls
+     * ({@link deriveErrorCategory}, {@link deriveOrmProvider},
+     * {@link classifyFetchTarget}) are pure functions on typed string inputs
+     * and rely on the outer catch for any unexpected failure.
+     *
      * On total failure, returns the original span unchanged.
      */
     private enrichSpan;
@@ -467,6 +471,9 @@ declare function uploadSourceMaps(apiKey: string, endpoint: string, buildHash: s
  * explicit, opt-in API for manual error reporting. If no span is active
  * or OTel is not available, the call is silently ignored.
  *
+ * On the first captured error, may display a one-time diagnostic nudge
+ * to stderr if the MCP connection marker is absent (dev environments only).
+ *
  * @param error - The error to capture. Accepts `Error` objects, strings, or any value.
  *
  * @example

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   buildImportGraph,
   discoverTestFiles,
   extractImports
-} from "./chunk-TJ6ETQPH.js";
+} from "./chunk-67H2JEI4.js";
 import {
   DEFAULT_CAPTURE_CONFIG,
   GLASSTRACE_ATTRIBUTE_NAMES,
@@ -12,7 +12,7 @@ import {
   SourceMapUploadResponseSchema,
   getOrCreateAnonKey,
   readAnonKey
-} from "./chunk-EC5IINUT.js";
+} from "./chunk-TVOYTJ7I.js";
 import {
   INVALID_SPAN_CONTEXT,
   SamplingDecision,
@@ -452,9 +452,13 @@ var GlasstraceExporter = class {
    * Enriches a ReadableSpan with all glasstrace.* attributes.
    * Returns a new ReadableSpan wrapper; the original span is not mutated.
    *
-   * External function calls (getSessionId, deriveErrorCategory,
-   * deriveOrmProvider, classifyFetchTarget) are individually guarded so a
-   * failure in one does not prevent the remaining attributes from being set.
+   * Only {@link SessionManager.getSessionId} is individually guarded because
+   * it calls into crypto and schema validation — a session ID failure should
+   * not prevent the rest of enrichment. The other helper calls
+   * ({@link deriveErrorCategory}, {@link deriveOrmProvider},
+   * {@link classifyFetchTarget}) are pure functions on typed string inputs
+   * and rely on the outer catch for any unexpected failure.
+   *
    * On total failure, returns the original span unchanged.
    */
   enrichSpan(span) {
@@ -497,44 +501,39 @@ var GlasstraceExporter = class {
         }
       }
       const errorMessage = attrs["exception.message"];
-      if (errorMessage) {
+      if (typeof errorMessage === "string") {
         extra[ATTR.ERROR_MESSAGE] = errorMessage;
       }
-      try {
-        const errorType = attrs["exception.type"];
-        if (errorType) {
-          extra[ATTR.ERROR_CODE] = errorType;
-          extra[ATTR.ERROR_CATEGORY] = deriveErrorCategory(errorType);
-        }
-      } catch {
+      const errorType = attrs["exception.type"];
+      if (typeof errorType === "string") {
+        extra[ATTR.ERROR_CODE] = errorType;
+        extra[ATTR.ERROR_CATEGORY] = deriveErrorCategory(errorType);
       }
       const errorField = attrs["error.field"];
-      if (errorField) {
+      if (typeof errorField === "string") {
         extra[ATTR.ERROR_FIELD] = errorField;
       }
-      try {
-        const spanAny = span;
-        const instrumentationName = spanAny.instrumentationScope?.name ?? spanAny.instrumentationLibrary?.name ?? "";
-        const ormProvider = deriveOrmProvider(instrumentationName);
-        if (ormProvider) {
-          extra[ATTR.ORM_PROVIDER] = ormProvider;
-          const model = attrs["db.sql.table"] ?? attrs["db.prisma.model"];
-          if (model) {
-            extra[ATTR.ORM_MODEL] = model;
-          }
-          const operation = attrs["db.operation"];
-          if (operation) {
-            extra[ATTR.ORM_OPERATION] = operation;
-          }
+      const spanAny = span;
+      const instrumentationName = spanAny.instrumentationScope?.name ?? spanAny.instrumentationLibrary?.name ?? "";
+      const ormProvider = deriveOrmProvider(instrumentationName);
+      if (ormProvider) {
+        extra[ATTR.ORM_PROVIDER] = ormProvider;
+        const table = attrs["db.sql.table"];
+        const prismaModel = attrs["db.prisma.model"];
+        const model = typeof table === "string" ? table : typeof prismaModel === "string" ? prismaModel : void 0;
+        if (model) {
+          extra[ATTR.ORM_MODEL] = model;
         }
-      } catch {
-      }
-      try {
-        const url = attrs["http.url"] ?? attrs["url.full"];
-        if (url && span.kind === SpanKind.CLIENT) {
-          extra[ATTR.FETCH_TARGET] = classifyFetchTarget(url);
+        const operation = attrs["db.operation"];
+        if (typeof operation === "string") {
+          extra[ATTR.ORM_OPERATION] = operation;
         }
-      } catch {
+      }
+      const httpUrl = attrs["http.url"];
+      const fullUrl = attrs["url.full"];
+      const url = typeof httpUrl === "string" ? httpUrl : typeof fullUrl === "string" ? fullUrl : void 0;
+      if (url && span.kind === SpanKind.CLIENT) {
+        extra[ATTR.FETCH_TARGET] = classifyFetchTarget(url);
       }
       return createEnrichedSpan(span, extra);
     } catch {
@@ -3542,7 +3541,7 @@ function registerGlasstrace(options) {
             if (config.verbose) {
               console.info("[glasstrace] Background init firing.");
             }
-            await performInit(config, anonKey, "0.4.0");
+            await performInit(config, anonKey, "0.4.2");
             maybeInstallConsoleCapture();
           } catch (err) {
             console.warn(
@@ -3562,7 +3561,7 @@ function registerGlasstrace(options) {
             if (config.verbose) {
               console.info("[glasstrace] Background init firing.");
             }
-            await performInit(config, anonKey, "0.4.0");
+            await performInit(config, anonKey, "0.4.2");
             maybeInstallConsoleCapture();
           } catch (err) {
             console.warn(
@@ -3584,7 +3583,7 @@ function registerGlasstrace(options) {
           if (config.verbose) {
             console.info("[glasstrace] Background init firing.");
           }
-          await performInit(config, anonKeyForInit, "0.4.0");
+          await performInit(config, anonKeyForInit, "0.4.2");
           maybeInstallConsoleCapture();
         } catch (err) {
           console.warn(
@@ -3683,7 +3682,10 @@ async function uploadSourceMaps(apiKey, endpoint, buildHash, maps) {
       sourceMap: m.content
     }))
   };
-  const baseUrl = endpoint.replace(/\/+$/, "");
+  let baseUrl = endpoint;
+  while (baseUrl.endsWith("/")) {
+    baseUrl = baseUrl.slice(0, -1);
+  }
   const response = await fetch(`${baseUrl}/v1/source-maps`, {
     method: "POST",
     headers: {
@@ -3767,6 +3769,41 @@ async function handleSourceMapUpload(distDir) {
   }
 }
 
+// src/nudge/error-nudge.ts
+import { existsSync } from "fs";
+import { join as join3 } from "path";
+var hasFired = false;
+function sanitize(input) {
+  return input.replace(/[\x00-\x1f\x7f]/g, "");
+}
+function maybeShowMcpNudge(errorSummary) {
+  if (hasFired) {
+    return;
+  }
+  const config = resolveConfig();
+  if (isProductionDisabled(config)) {
+    return;
+  }
+  let markerExists = false;
+  try {
+    const markerPath = join3(process.cwd(), ".glasstrace", "mcp-connected");
+    markerExists = existsSync(markerPath);
+  } catch {
+    markerExists = false;
+  }
+  if (markerExists) {
+    return;
+  }
+  hasFired = true;
+  const safe = sanitize(errorSummary);
+  process.stderr.write(
+    `[glasstrace] Error captured: ${safe}
+  Debug with AI: ask your agent "What's the latest Glasstrace error?"
+  Not connected? Run: npx glasstrace mcp add
+`
+  );
+}
+
 // src/capture-error.ts
 function captureError(error) {
   try {
@@ -3779,6 +3816,7 @@ function captureError(error) {
       attributes["error.type"] = error.constructor.name;
     }
     span.addEvent("glasstrace.error", attributes);
+    maybeShowMcpNudge(String(error));
   } catch {
   }
 }