@glasstrace/sdk 0.2.3 → 0.4.1

package/dist/index.d.cts

@@ -467,6 +467,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

@@ -467,6 +467,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

@@ -1,16 +1,18 @@
 import {
-  AnonApiKeySchema,
+  buildImportGraph,
+  discoverTestFiles,
+  extractImports
+} from "./chunk-LAMTBURS.js";
+import {
   DEFAULT_CAPTURE_CONFIG,
   GLASSTRACE_ATTRIBUTE_NAMES,
   SdkCachedConfigSchema,
   SdkInitResponseSchema,
   SessionIdSchema,
   SourceMapUploadResponseSchema,
-  buildImportGraph,
-  createAnonApiKey,
-  discoverTestFiles,
-  extractImports
-} from "./chunk-CUFIV225.js";
+  getOrCreateAnonKey,
+  readAnonKey
+} from "./chunk-EC5IINUT.js";
 import {
   INVALID_SPAN_CONTEXT,
   SamplingDecision,
@@ -180,60 +182,11 @@ function classifyFetchTarget(url) {
   return "unknown";
 }
 
-// src/anon-key.ts
-import { readFile, writeFile, mkdir, chmod } from "fs/promises";
-import { join } from "path";
-var GLASSTRACE_DIR = ".glasstrace";
-var ANON_KEY_FILE = "anon_key";
-var ephemeralKeyCache = /* @__PURE__ */ new Map();
-async function readAnonKey(projectRoot) {
-  const root = projectRoot ?? process.cwd();
-  const keyPath = join(root, GLASSTRACE_DIR, ANON_KEY_FILE);
-  try {
-    const content = await readFile(keyPath, "utf-8");
-    const result = AnonApiKeySchema.safeParse(content);
-    if (result.success) {
-      return result.data;
-    }
-  } catch {
-  }
-  const cached = ephemeralKeyCache.get(root);
-  if (cached !== void 0) {
-    return cached;
-  }
-  return null;
-}
-async function getOrCreateAnonKey(projectRoot) {
-  const root = projectRoot ?? process.cwd();
-  const dirPath = join(root, GLASSTRACE_DIR);
-  const keyPath = join(dirPath, ANON_KEY_FILE);
-  const existingKey = await readAnonKey(root);
-  if (existingKey !== null) {
-    return existingKey;
-  }
-  const cached = ephemeralKeyCache.get(root);
-  if (cached !== void 0) {
-    return cached;
-  }
-  const newKey = createAnonApiKey();
-  try {
-    await mkdir(dirPath, { recursive: true, mode: 448 });
-    await writeFile(keyPath, newKey, "utf-8");
-    await chmod(keyPath, 384);
-  } catch (err) {
-    ephemeralKeyCache.set(root, newKey);
-    console.warn(
-      `[glasstrace] Failed to persist anonymous key to ${keyPath}: ${err instanceof Error ? err.message : String(err)}. Using ephemeral key.`
-    );
-  }
-  return newKey;
-}
-
 // src/init-client.ts
 import { readFileSync } from "fs";
-import { writeFile as writeFile2, mkdir as mkdir2 } from "fs/promises";
-import { join as join2 } from "path";
-var GLASSTRACE_DIR2 = ".glasstrace";
+import { writeFile, mkdir } from "fs/promises";
+import { join } from "path";
+var GLASSTRACE_DIR = ".glasstrace";
 var CONFIG_FILE = "config";
 var TWENTY_FOUR_HOURS_MS = 24 * 60 * 60 * 1e3;
 var INIT_TIMEOUT_MS = 1e4;
@@ -241,7 +194,7 @@ var currentConfig = null;
 var rateLimitBackoff = false;
 function loadCachedConfig(projectRoot) {
   const root = projectRoot ?? process.cwd();
-  const configPath = join2(root, GLASSTRACE_DIR2, CONFIG_FILE);
+  const configPath = join(root, GLASSTRACE_DIR, CONFIG_FILE);
   try {
     const content = readFileSync(configPath, "utf-8");
     const parsed = JSON.parse(content);
@@ -264,15 +217,15 @@ function loadCachedConfig(projectRoot) {
 }
 async function saveCachedConfig(response, projectRoot) {
   const root = projectRoot ?? process.cwd();
-  const dirPath = join2(root, GLASSTRACE_DIR2);
-  const configPath = join2(dirPath, CONFIG_FILE);
+  const dirPath = join(root, GLASSTRACE_DIR);
+  const configPath = join(dirPath, CONFIG_FILE);
   try {
-    await mkdir2(dirPath, { recursive: true });
+    await mkdir(dirPath, { recursive: true });
     const cached = {
       response,
       cachedAt: Date.now()
     };
-    await writeFile2(configPath, JSON.stringify(cached), "utf-8");
+    await writeFile(configPath, JSON.stringify(cached), "utf-8");
   } catch (err) {
     console.warn(
       `[glasstrace] Failed to cache config to ${configPath}: ${err instanceof Error ? err.message : String(err)}`
@@ -3589,7 +3542,7 @@ function registerGlasstrace(options) {
             if (config.verbose) {
               console.info("[glasstrace] Background init firing.");
             }
-            await performInit(config, anonKey, "0.2.3");
+            await performInit(config, anonKey, "0.4.1");
             maybeInstallConsoleCapture();
           } catch (err) {
             console.warn(
@@ -3609,7 +3562,7 @@ function registerGlasstrace(options) {
             if (config.verbose) {
               console.info("[glasstrace] Background init firing.");
             }
-            await performInit(config, anonKey, "0.2.3");
+            await performInit(config, anonKey, "0.4.1");
             maybeInstallConsoleCapture();
           } catch (err) {
             console.warn(
@@ -3631,7 +3584,7 @@ function registerGlasstrace(options) {
           if (config.verbose) {
             console.info("[glasstrace] Background init firing.");
           }
-          await performInit(config, anonKeyForInit, "0.2.3");
+          await performInit(config, anonKeyForInit, "0.4.1");
           maybeInstallConsoleCapture();
         } catch (err) {
           console.warn(
@@ -3730,7 +3683,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: {
@@ -3814,6 +3770,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 {
@@ -3826,6 +3817,7 @@ function captureError(error) {
       attributes["error.type"] = error.constructor.name;
     }
     span.addEvent("glasstrace.error", attributes);
+    maybeShowMcpNudge(String(error));
   } catch {
   }
 }