@glasstrace/sdk 1.2.1 → 1.3.1

package/README.md

@@ -199,6 +199,53 @@ body data. If your account enables the flag but a span never carries
 the internal attribute (no adapter set it), the public attribute is
 still absent. The default is "off, twice".
 
+## Source maps
+
+Glasstrace uploads server-side source maps at build time and resolves
+compiled-output stack frames back to original source on the dashboard
+and in agent prompts. Three span attributes connect the runtime trace
+to the build-time manifest:
+
+| Attribute | When stamped | Source |
+|---|---|---|
+| `glasstrace.build.hash` | every server span | `process.env.GLASSTRACE_BUILD_HASH` (read once at module load) |
+| `glasstrace.source.file` | error spans only | top user-attributable frame of `Error.stack` |
+| `glasstrace.source.line` | error spans only | top user-attributable frame of `Error.stack` |
+
+The build hash links a runtime span to the source maps uploaded
+during the same build. Set the env var in your deploy step:
+
+```bash
+# Vercel / GitHub Actions / any CI
+GLASSTRACE_BUILD_HASH=$(git rev-parse HEAD) npm run start
+```
+
+The Glasstrace `next.config.ts` wrapper (`withGlasstraceConfig`) and
+the `@glasstrace/sdk/node` upload helpers compute the same hash via
+`computeBuildHash()` (preferring `git rev-parse HEAD`, falling back
+to a deterministic content hash). When the runtime env var is unset,
+the SDK silently omits the attribute — no crash, no diagnostic — so
+projects that have not adopted the convention behave exactly as
+before; their stored traces simply do not render mapped frames in
+the dashboard.
+
+The error-source attributes are stamped only by the manual
+`captureError()` API, on the `glasstrace.error` span event. They
+report the compiled-output `file:line` from the top user-attributable
+frame; ingestion's resolver then maps that pair back to original
+source via the uploaded source map manifest. The SDK skips frames
+inside Node's built-in modules (`node:internal/*`, `node:fs`, etc.)
+and inside its own `node_modules/@glasstrace/sdk/` closure, so the
+reported frame is always the caller of `captureError()`. If
+`Error.stack` is absent, malformed, or contains only internal frames,
+the attributes are silently omitted and only the existing
+`error.message` / `error.type` / `error.stack` event attributes are
+recorded.
+
+These attributes are additive: any consumer that does not understand
+them ignores them. Existing trace pipelines and dashboards continue
+to work unchanged.
+
 ## Browser-extension discovery
 
 `glasstrace init` writes a small static file at

package/dist/{chunk-CTJO7PUZ.js → chunk-5PFPEA4C.js}

@@ -33,7 +33,7 @@ import {
   performInit,
   recordSpansDropped,
   recordSpansExported
-} from "./chunk-HV5ID2WJ.js";
+} from "./chunk-X4IK6KES.js";
 import {
   isAnonymousMode,
   isProductionDisabled,
@@ -43,11 +43,11 @@ import {
   atomicWriteFileSync,
   getOrCreateAnonKey,
   readAnonKey
-} from "./chunk-MD5XPCTQ.js";
+} from "./chunk-DW2UJUNB.js";
 import {
   GLASSTRACE_ATTRIBUTE_NAMES,
   deriveSessionId
-} from "./chunk-EBYISKQP.js";
+} from "./chunk-MQHLWSIX.js";
 import {
   __require
 } from "./chunk-NSBPE2FW.js";
@@ -264,6 +264,19 @@ function prepareErrorResponseBody(body) {
   return truncateErrorResponseBody(sanitized);
 }
 
+// src/build-info.ts
+var UNSET = "";
+function readBuildHashFromEnv() {
+  const raw = process.env.GLASSTRACE_BUILD_HASH;
+  if (typeof raw !== "string") return UNSET;
+  const trimmed = raw.trim();
+  return trimmed.length > 0 ? trimmed : UNSET;
+}
+var cachedBuildHash = readBuildHashFromEnv();
+function getBuildHash() {
+  return cachedBuildHash === UNSET ? void 0 : cachedBuildHash;
+}
+
 // src/enriching-exporter.ts
 var ATTR = GLASSTRACE_ATTRIBUTE_NAMES;
 var API_KEY_PENDING = "pending";
@@ -379,6 +392,10 @@ var GlasstraceExporter = class {
       if (env) {
         extra[ATTR.ENVIRONMENT] = env;
       }
+      const buildHash = getBuildHash();
+      if (buildHash) {
+        extra[ATTR.BUILD_HASH] = buildHash;
+      }
       const existingCid = attrs["glasstrace.correlation.id"];
       if (typeof existingCid === "string") {
         extra[ATTR.CORRELATION_ID] = existingCid;
@@ -4207,7 +4224,7 @@ function registerGlasstrace(options) {
     setCoreState(CoreState.REGISTERING);
     startRuntimeStateWriter({
       projectRoot: process.cwd(),
-      sdkVersion: "1.2.1"
+      sdkVersion: "1.3.1"
     });
     const config = resolveConfig(options);
     if (config.verbose) {
@@ -4373,8 +4390,8 @@ async function backgroundInit(config, anonKeyForInit, generation) {
   if (config.verbose) {
     console.info("[glasstrace] Background init firing.");
   }
-  const healthReport = collectHealthReport("1.2.1");
-  const initResult = await performInit(config, anonKeyForInit, "1.2.1", healthReport);
+  const healthReport = collectHealthReport("1.3.1");
+  const initResult = await performInit(config, anonKeyForInit, "1.3.1", healthReport);
   if (generation !== registrationGeneration) return;
   const currentState = getCoreState();
   if (currentState === CoreState.SHUTTING_DOWN || currentState === CoreState.SHUTDOWN) {
@@ -4397,7 +4414,7 @@ async function backgroundInit(config, anonKeyForInit, generation) {
   }
   maybeInstallConsoleCapture();
   if (didLastInitSucceed()) {
-    startHeartbeat(config, anonKeyForInit, "1.2.1", generation, (newApiKey, accountId) => {
+    startHeartbeat(config, anonKeyForInit, "1.3.1", generation, (newApiKey, accountId) => {
       setAuthState(AuthState.CLAIMING);
       emitLifecycleEvent("auth:claim_started", { accountId });
       setResolvedApiKey(newApiKey);
@@ -4692,7 +4709,7 @@ async function handleSourceMapUpload(distDir) {
       );
       return;
     }
-    const { discoverSourceMapFiles, computeBuildHash, uploadSourceMaps } = await import("./source-map-uploader-RA4Z7TWA.js");
+    const { discoverSourceMapFiles, computeBuildHash, uploadSourceMaps } = await import("./source-map-uploader-LACAGKIW.js");
     const files = await discoverSourceMapFiles(distDir);
     if (files.length === 0) {
       console.info("[glasstrace] No source map files found. Skipping upload.");
@@ -4711,6 +4728,50 @@ async function handleSourceMapUpload(distDir) {
   }
 }
 
+// src/stack-frame.ts
+var PAREN_FRAME = /^\s*at\s+(?:[^()]+\s+)?\(([^()\s]+):(\d+):(\d+)\)\s*$/;
+var BARE_FRAME = /^\s*at\s+(?:async\s+)?([^()\s]+):(\d+):(\d+)\s*$/;
+var INTERNAL_FRAME_PATTERNS = [
+  /^node:/,
+  /^node:internal\//,
+  /[/\\]node_modules[/\\]@glasstrace[/\\]sdk[/\\]/,
+  /[/\\]packages[/\\]sdk[/\\]src[/\\]capture-error\./,
+  /[/\\]packages[/\\]sdk[/\\]src[/\\]stack-frame\./
+];
+function isInternalFrame(file) {
+  return INTERNAL_FRAME_PATTERNS.some((re) => re.test(file));
+}
+function parseTopStackFrame(stack) {
+  if (typeof stack !== "string" || stack.length === 0) return null;
+  let cursor = 0;
+  while (cursor < stack.length) {
+    const newlineAt = stack.indexOf("\n", cursor);
+    const lineEnd = newlineAt === -1 ? stack.length : newlineAt;
+    const line = stack.slice(cursor, lineEnd);
+    cursor = lineEnd + 1;
+    if (!/^\s*at\s/.test(line)) continue;
+    let file;
+    let lineStr;
+    const parenMatch = PAREN_FRAME.exec(line);
+    if (parenMatch) {
+      file = parenMatch[1];
+      lineStr = parenMatch[2];
+    } else {
+      const bareMatch = BARE_FRAME.exec(line);
+      if (bareMatch) {
+        file = bareMatch[1];
+        lineStr = bareMatch[2];
+      }
+    }
+    if (!file || !lineStr) continue;
+    if (isInternalFrame(file)) continue;
+    const lineNum = Number.parseInt(lineStr, 10);
+    if (!Number.isFinite(lineNum) || lineNum <= 0) continue;
+    return { file, line: lineNum };
+  }
+  return null;
+}
+
 // src/capture-error.ts
 function captureError(error) {
   try {
@@ -4723,6 +4784,11 @@ function captureError(error) {
       attributes["error.type"] = error.constructor.name;
       if (error.stack) {
         attributes["error.stack"] = error.stack;
+        const frame = parseTopStackFrame(error.stack);
+        if (frame) {
+          attributes[GLASSTRACE_ATTRIBUTE_NAMES.SOURCE_FILE] = frame.file;
+          attributes[GLASSTRACE_ATTRIBUTE_NAMES.SOURCE_LINE] = frame.line;
+        }
       }
     }
     span.addEvent("glasstrace.error", attributes);
@@ -4746,4 +4812,4 @@ export {
   withGlasstraceConfig,
   captureError
 };
-//# sourceMappingURL=chunk-CTJO7PUZ.js.map
+//# sourceMappingURL=chunk-5PFPEA4C.js.map