@glasstrace/sdk 0.16.0 → 0.17.1

package/dist/index.d.cts

@@ -773,6 +773,60 @@ declare function uploadSourceMapsAuto(apiKey: string, endpoint: string, buildHas
  */
 declare function captureError(error: unknown): void;
 
+/**
+ * Minimal Fetch-API `Headers`-like interface supporting case-insensitive
+ * single-value lookup. Matches `Headers` from `undici` / the Web Fetch API.
+ */
+interface FetchHeadersLike {
+    get(name: string): string | null;
+}
+/**
+ * Minimal Node `IncomingMessage.headers`-like shape: a dictionary mapping
+ * (typically lower-cased) header names to a value, a list of values, or
+ * `undefined`.
+ */
+type NodeHeadersLike = Record<string, string | string[] | undefined>;
+/**
+ * Accepted request shape for {@link captureCorrelationId}. Intentionally
+ * loose so callers can pass either a Fetch `Request` (or `NextRequest`)
+ * or a Node `IncomingMessage` without adapting the type.
+ */
+interface CorrelationIdRequest {
+    headers: FetchHeadersLike | NodeHeadersLike | undefined;
+}
+/**
+ * Captures the Glasstrace correlation ID header (`x-gt-cid`) from an
+ * incoming request and materializes it as the
+ * `glasstrace.correlation.id` attribute on the currently active OTel span
+ * (DISC-1253).
+ *
+ * The SDK does not own any HTTP instrumentation, so it cannot read this
+ * header itself. Users opt in by calling this helper from a hook that
+ * runs inside the request's OTel context — typically a Next.js
+ * `middleware.ts` or a custom server request handler.
+ *
+ * The function is intentionally forgiving:
+ * - No active span → no-op.
+ * - Missing / empty header → no-op.
+ * - Array header values (Node IncomingMessage) → the first non-empty
+ *   value is used; subsequent values are ignored because a correlation
+ *   ID is a single logical value.
+ * - Malformed or unexpected `headers` shapes → caught and ignored; the
+ *   helper never throws.
+ *
+ * @example
+ * ```ts
+ * // Next.js middleware.ts
+ * import { captureCorrelationId } from "@glasstrace/sdk";
+ *
+ * export function middleware(req: Request) {
+ *   captureCorrelationId(req);
+ *   return NextResponse.next();
+ * }
+ * ```
+ */
+declare function captureCorrelationId(req: CorrelationIdRequest | null | undefined): void;
+
 /**
  * Discovers test files by scanning the project directory for conventional
  * test file patterns. Also reads vitest/jest config files for custom include
@@ -802,4 +856,4 @@ declare function extractImports(fileContent: string): string[];
  */
 declare function buildImportGraph(projectRoot: string): Promise<ImportGraphPayload>;
 
-export { type AutoUploadOptions, type BlobUploader, type ClaimState, type FetchTarget, GlasstraceExporter, type GlasstraceExporterOptions, GlasstraceSpanProcessor, type InitClaimResult, PRESIGNED_THRESHOLD_BYTES, type ResolvedConfig, SdkError, SessionManager, type SourceMapEntry, type SourceMapFileInfo, buildImportGraph, captureError, classifyFetchTarget, collectSourceMaps, computeBuildHash, createDiscoveryHandler, createGlasstraceSpanProcessor, deriveSessionId, discoverSourceMapFiles, discoverTestFiles, extractImports, getActiveConfig, getDateString, getDiscoveryHandler, getLinkedAccountId, getOrCreateAnonKey, getOrigin, getStatus, isAnonymousMode, isProductionDisabled, isReady, loadCachedConfig, performInit, readAnonKey, readEnvVars, registerGlasstrace, resolveConfig, saveCachedConfig, sendInitRequest, uploadSourceMaps, uploadSourceMapsAuto, uploadSourceMapsPresigned, waitForReady, withGlasstraceConfig };
+export { type AutoUploadOptions, type BlobUploader, type ClaimState, type CorrelationIdRequest, type FetchTarget, GlasstraceExporter, type GlasstraceExporterOptions, GlasstraceSpanProcessor, type InitClaimResult, PRESIGNED_THRESHOLD_BYTES, type ResolvedConfig, SdkError, SessionManager, type SourceMapEntry, type SourceMapFileInfo, buildImportGraph, captureCorrelationId, captureError, classifyFetchTarget, collectSourceMaps, computeBuildHash, createDiscoveryHandler, createGlasstraceSpanProcessor, deriveSessionId, discoverSourceMapFiles, discoverTestFiles, extractImports, getActiveConfig, getDateString, getDiscoveryHandler, getLinkedAccountId, getOrCreateAnonKey, getOrigin, getStatus, isAnonymousMode, isProductionDisabled, isReady, loadCachedConfig, performInit, readAnonKey, readEnvVars, registerGlasstrace, resolveConfig, saveCachedConfig, sendInitRequest, uploadSourceMaps, uploadSourceMapsAuto, uploadSourceMapsPresigned, waitForReady, withGlasstraceConfig };

package/dist/index.d.ts

@@ -773,6 +773,60 @@ declare function uploadSourceMapsAuto(apiKey: string, endpoint: string, buildHas
  */
 declare function captureError(error: unknown): void;
 
+/**
+ * Minimal Fetch-API `Headers`-like interface supporting case-insensitive
+ * single-value lookup. Matches `Headers` from `undici` / the Web Fetch API.
+ */
+interface FetchHeadersLike {
+    get(name: string): string | null;
+}
+/**
+ * Minimal Node `IncomingMessage.headers`-like shape: a dictionary mapping
+ * (typically lower-cased) header names to a value, a list of values, or
+ * `undefined`.
+ */
+type NodeHeadersLike = Record<string, string | string[] | undefined>;
+/**
+ * Accepted request shape for {@link captureCorrelationId}. Intentionally
+ * loose so callers can pass either a Fetch `Request` (or `NextRequest`)
+ * or a Node `IncomingMessage` without adapting the type.
+ */
+interface CorrelationIdRequest {
+    headers: FetchHeadersLike | NodeHeadersLike | undefined;
+}
+/**
+ * Captures the Glasstrace correlation ID header (`x-gt-cid`) from an
+ * incoming request and materializes it as the
+ * `glasstrace.correlation.id` attribute on the currently active OTel span
+ * (DISC-1253).
+ *
+ * The SDK does not own any HTTP instrumentation, so it cannot read this
+ * header itself. Users opt in by calling this helper from a hook that
+ * runs inside the request's OTel context — typically a Next.js
+ * `middleware.ts` or a custom server request handler.
+ *
+ * The function is intentionally forgiving:
+ * - No active span → no-op.
+ * - Missing / empty header → no-op.
+ * - Array header values (Node IncomingMessage) → the first non-empty
+ *   value is used; subsequent values are ignored because a correlation
+ *   ID is a single logical value.
+ * - Malformed or unexpected `headers` shapes → caught and ignored; the
+ *   helper never throws.
+ *
+ * @example
+ * ```ts
+ * // Next.js middleware.ts
+ * import { captureCorrelationId } from "@glasstrace/sdk";
+ *
+ * export function middleware(req: Request) {
+ *   captureCorrelationId(req);
+ *   return NextResponse.next();
+ * }
+ * ```
+ */
+declare function captureCorrelationId(req: CorrelationIdRequest | null | undefined): void;
+
 /**
  * Discovers test files by scanning the project directory for conventional
  * test file patterns. Also reads vitest/jest config files for custom include
@@ -802,4 +856,4 @@ declare function extractImports(fileContent: string): string[];
  */
 declare function buildImportGraph(projectRoot: string): Promise<ImportGraphPayload>;
 
-export { type AutoUploadOptions, type BlobUploader, type ClaimState, type FetchTarget, GlasstraceExporter, type GlasstraceExporterOptions, GlasstraceSpanProcessor, type InitClaimResult, PRESIGNED_THRESHOLD_BYTES, type ResolvedConfig, SdkError, SessionManager, type SourceMapEntry, type SourceMapFileInfo, buildImportGraph, captureError, classifyFetchTarget, collectSourceMaps, computeBuildHash, createDiscoveryHandler, createGlasstraceSpanProcessor, deriveSessionId, discoverSourceMapFiles, discoverTestFiles, extractImports, getActiveConfig, getDateString, getDiscoveryHandler, getLinkedAccountId, getOrCreateAnonKey, getOrigin, getStatus, isAnonymousMode, isProductionDisabled, isReady, loadCachedConfig, performInit, readAnonKey, readEnvVars, registerGlasstrace, resolveConfig, saveCachedConfig, sendInitRequest, uploadSourceMaps, uploadSourceMapsAuto, uploadSourceMapsPresigned, waitForReady, withGlasstraceConfig };
+export { type AutoUploadOptions, type BlobUploader, type ClaimState, type CorrelationIdRequest, type FetchTarget, GlasstraceExporter, type GlasstraceExporterOptions, GlasstraceSpanProcessor, type InitClaimResult, PRESIGNED_THRESHOLD_BYTES, type ResolvedConfig, SdkError, SessionManager, type SourceMapEntry, type SourceMapFileInfo, buildImportGraph, captureCorrelationId, captureError, classifyFetchTarget, collectSourceMaps, computeBuildHash, createDiscoveryHandler, createGlasstraceSpanProcessor, deriveSessionId, discoverSourceMapFiles, discoverTestFiles, extractImports, getActiveConfig, getDateString, getDiscoveryHandler, getLinkedAccountId, getOrCreateAnonKey, getOrigin, getStatus, isAnonymousMode, isProductionDisabled, isReady, loadCachedConfig, performInit, readAnonKey, readEnvVars, registerGlasstrace, resolveConfig, saveCachedConfig, sendInitRequest, uploadSourceMaps, uploadSourceMapsAuto, uploadSourceMapsPresigned, waitForReady, withGlasstraceConfig };

package/dist/index.js

@@ -5,11 +5,12 @@ import {
   discoverSourceMapFiles,
   installConsoleCapture,
   maybeShowMcpNudge,
+  maybeShowServerActionNudge,
   sdkLog,
   uploadSourceMaps,
   uploadSourceMapsAuto,
   uploadSourceMapsPresigned
-} from "./chunk-BANTDXUT.js";
+} from "./chunk-E33Y7BQH.js";
 import {
   _setCurrentConfig,
   buildImportGraph,
@@ -27,7 +28,7 @@ import {
   recordSpansExported,
   saveCachedConfig,
   sendInitRequest
-} from "./chunk-5C2TJFLB.js";
+} from "./chunk-UUUKI65I.js";
 import {
   isAnonymousMode,
   isProductionDisabled,
@@ -37,11 +38,11 @@ import {
 import {
   getOrCreateAnonKey,
   readAnonKey
-} from "./chunk-TM5NKZTO.js";
+} from "./chunk-J5BW7V2D.js";
 import {
   GLASSTRACE_ATTRIBUTE_NAMES,
   SessionIdSchema
-} from "./chunk-7JBKXSBU.js";
+} from "./chunk-GSGX76Q5.js";
 import {
   DiagLogLevel,
   INVALID_SPAN_CONTEXT,
@@ -328,7 +329,8 @@ var GlasstraceExporter = class {
       if (typeof existingCid === "string") {
         extra[ATTR.CORRELATION_ID] = existingCid;
       }
-      const route = attrs["http.route"] ?? name;
+      const rawRoute = attrs["http.route"];
+      const route = typeof rawRoute === "string" ? rawRoute : name;
       if (route) {
         extra[ATTR.ROUTE] = route;
       }
@@ -352,6 +354,17 @@ var GlasstraceExporter = class {
       if (method) {
         extra[ATTR.HTTP_METHOD] = method;
       }
+      const actionRoute = extractLeadingPath(route);
+      if (method === "POST" && actionRoute) {
+        const isApiRoute = actionRoute === "/api" || actionRoute.startsWith("/api/");
+        const isInternalRoute = actionRoute.startsWith("/_next/");
+        if (!isApiRoute && !isInternalRoute) {
+          extra[ATTR.NEXT_ACTION_DETECTED] = true;
+          if (typeof extra[ATTR.CORRELATION_ID] !== "string") {
+            maybeShowServerActionNudge();
+          }
+        }
+      }
       const statusCode = attrs["http.status_code"] ?? attrs["http.response.status_code"];
       if (statusCode !== void 0) {
         extra[ATTR.HTTP_STATUS_CODE] = statusCode;
@@ -560,6 +573,21 @@ function getExceptionEventDetails(span) {
     message: typeof message === "string" ? message : void 0
   };
 }
+function extractLeadingPath(raw) {
+  if (!raw) return void 0;
+  const trimmed = raw.trim();
+  if (trimmed.length === 0) return void 0;
+  if (trimmed.startsWith("/")) {
+    const firstSpace = trimmed.indexOf(" ");
+    return firstSpace === -1 ? trimmed : trimmed.slice(0, firstSpace);
+  }
+  for (const token of trimmed.split(/\s+/)) {
+    if (token.startsWith("/")) {
+      return token;
+    }
+  }
+  return void 0;
+}
 function deriveOrmProvider(instrumentationName) {
   const lower = instrumentationName.toLowerCase();
   if (lower.includes("prisma")) {
@@ -4176,7 +4204,7 @@ function registerGlasstrace(options) {
     setCoreState(CoreState.REGISTERING);
     startRuntimeStateWriter({
       projectRoot: process.cwd(),
-      sdkVersion: "0.16.0"
+      sdkVersion: "0.17.1"
     });
     const config = resolveConfig(options);
     if (config.verbose) {
@@ -4341,8 +4369,8 @@ async function backgroundInit(config, anonKeyForInit, generation) {
   if (config.verbose) {
     console.info("[glasstrace] Background init firing.");
   }
-  const healthReport = collectHealthReport("0.16.0");
-  const initResult = await performInit(config, anonKeyForInit, "0.16.0", healthReport);
+  const healthReport = collectHealthReport("0.17.1");
+  const initResult = await performInit(config, anonKeyForInit, "0.17.1", healthReport);
   if (generation !== registrationGeneration) return;
   const currentState = getCoreState();
   if (currentState === CoreState.SHUTTING_DOWN || currentState === CoreState.SHUTDOWN) {
@@ -4365,7 +4393,7 @@ async function backgroundInit(config, anonKeyForInit, generation) {
   }
   maybeInstallConsoleCapture();
   if (didLastInitSucceed()) {
-    startHeartbeat(config, anonKeyForInit, "0.16.0", generation, (newApiKey, accountId) => {
+    startHeartbeat(config, anonKeyForInit, "0.17.1", generation, (newApiKey, accountId) => {
       setAuthState(AuthState.CLAIMING);
       emitLifecycleEvent("auth:claim_started", { accountId });
       setResolvedApiKey(newApiKey);
@@ -4502,7 +4530,7 @@ async function handleSourceMapUpload(distDir) {
       );
       return;
     }
-    const { discoverSourceMapFiles: discoverSourceMapFiles2, computeBuildHash: computeBuildHash2, uploadSourceMaps: uploadSourceMaps2 } = await import("./source-map-uploader-MUZPI2S5.js");
+    const { discoverSourceMapFiles: discoverSourceMapFiles2, computeBuildHash: computeBuildHash2, uploadSourceMaps: uploadSourceMaps2 } = await import("./source-map-uploader-26QPRSCG.js");
     const files = await discoverSourceMapFiles2(distDir);
     if (files.length === 0) {
       console.info("[glasstrace] No source map files found. Skipping upload.");
@@ -4540,6 +4568,67 @@ function captureError(error) {
   } catch {
   }
 }
+
+// src/correlation-id.ts
+var ATTR2 = GLASSTRACE_ATTRIBUTE_NAMES;
+var HEADER_NAME = "x-gt-cid";
+var MAX_CID_LENGTH = 128;
+function captureCorrelationId(req) {
+  try {
+    if (!req || !req.headers) {
+      return;
+    }
+    const value = readHeader(req.headers);
+    if (!value) {
+      return;
+    }
+    const span = trace.getActiveSpan();
+    if (!span) {
+      return;
+    }
+    span.setAttribute(ATTR2.CORRELATION_ID, value);
+  } catch {
+  }
+}
+function readHeader(headers) {
+  const asFetch = headers;
+  if (typeof asFetch.get === "function") {
+    const raw = asFetch.get(HEADER_NAME);
+    return firstToken(raw);
+  }
+  const dict = headers;
+  const direct = dict[HEADER_NAME];
+  if (direct !== void 0) {
+    return firstValue(direct);
+  }
+  for (const key of Object.keys(dict)) {
+    if (key.toLowerCase() === HEADER_NAME) {
+      return firstValue(dict[key]);
+    }
+  }
+  return void 0;
+}
+function firstValue(value) {
+  if (Array.isArray(value)) {
+    for (const entry of value) {
+      const token = firstToken(entry);
+      if (token) return token;
+    }
+    return void 0;
+  }
+  return firstToken(value);
+}
+function firstToken(value) {
+  if (typeof value !== "string") return void 0;
+  const parts = value.split(",");
+  for (const part of parts) {
+    const trimmed = part.trim();
+    if (trimmed.length === 0) continue;
+    if (trimmed.length > MAX_CID_LENGTH) return void 0;
+    return trimmed;
+  }
+  return void 0;
+}
 export {
   GlasstraceExporter,
   GlasstraceSpanProcessor,
@@ -4547,6 +4636,7 @@ export {
   SdkError,
   SessionManager,
   buildImportGraph,
+  captureCorrelationId,
   captureError,
   classifyFetchTarget,
   collectSourceMaps,