@lwrjs/shared-utils 0.17.2-alpha.12 → 0.17.2-alpha.15

package/build/cjs/env.cjs

@@ -8,6 +8,9 @@ var __export = (target, all) => {
 // packages/@lwrjs/shared-utils/src/env.ts
 __markAsModule(exports);
 __export(exports, {
+  B3_PARENT_ID: () => B3_PARENT_ID,
+  B3_SAMPLED: () => B3_SAMPLED,
+  B3_SPAN_ID: () => B3_SPAN_ID,
   B3_TRACE_ID: () => B3_TRACE_ID,
   CORRELATION_ID: () => CORRELATION_ID,
   MRT_REQUEST_CLASS: () => MRT_REQUEST_CLASS,
@@ -16,6 +19,7 @@ __export(exports, {
   TRUE_CLIENT_IP: () => TRUE_CLIENT_IP,
   buildEnvironmentContext: () => buildEnvironmentContext,
   getFeatureFlags: () => getFeatureFlags,
+  getTraceHeaders: () => getTraceHeaders,
   isLambdaEnv: () => isLambdaEnv,
   isLocalDev: () => isLocalDev,
   parseRequestDepth: () => parseRequestDepth
@@ -69,8 +73,11 @@ function buildEnvironmentContext(runtimeParams) {
   };
 }
 var TRUE_CLIENT_IP = "true-client-ip";
-var B3_TRACE_ID = "x-b3-traceid";
 var CORRELATION_ID = "x-correlation-id";
+var B3_TRACE_ID = "x-b3-traceid";
+var B3_SPAN_ID = "x-b3-spandid";
+var B3_PARENT_ID = "x-b3-parentid";
+var B3_SAMPLED = "x-b3-sampled";
 var MRT_REQUEST_CLASS = "x-mobify-request-class";
 var ROUTE_CORE_HEADER = "x-sfdc-route-core";
 var REQUEST_DEPTH_HEADER = "x-sfdc-request-depth";
@@ -102,3 +109,19 @@ function parseRequestDepth(headers = {}, query = {}) {
   }
   return maxDepth;
 }
+function getTraceHeaders(runtimeParams, span) {
+  const headers = {};
+  if (runtimeParams.trueClientIP)
+    headers[TRUE_CLIENT_IP] = runtimeParams.trueClientIP;
+  if (runtimeParams.correlationID)
+    headers[CORRELATION_ID] = runtimeParams.correlationID;
+  if (span?.traceId) {
+    headers[B3_TRACE_ID] = span.traceId;
+    headers[B3_SAMPLED] = parseTracingFlag() ? "1" : "0";
+  }
+  if (span?.spanId)
+    headers[B3_SPAN_ID] = span.spanId;
+  if (span?.parentSpanId)
+    headers[B3_PARENT_ID] = span.parentSpanId;
+  return headers;
+}

package/build/es/env.d.ts

@@ -17,10 +17,18 @@ export declare function isLocalDev(): boolean;
  */
 export declare function buildEnvironmentContext(runtimeParams: RuntimeParams): EnvironmentContext;
 export declare const TRUE_CLIENT_IP = "true-client-ip";
-export declare const B3_TRACE_ID = "x-b3-traceid";
 export declare const CORRELATION_ID = "x-correlation-id";
+export declare const B3_TRACE_ID = "x-b3-traceid";
+export declare const B3_SPAN_ID = "x-b3-spandid";
+export declare const B3_PARENT_ID = "x-b3-parentid";
+export declare const B3_SAMPLED = "x-b3-sampled";
 export declare const MRT_REQUEST_CLASS = "x-mobify-request-class";
 export declare const ROUTE_CORE_HEADER = "x-sfdc-route-core";
 export declare const REQUEST_DEPTH_HEADER = "x-sfdc-request-depth";
 export declare function parseRequestDepth(headers?: Headers, query?: Record<string, string>): number;
+export declare function getTraceHeaders(runtimeParams: RuntimeParams, span?: {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string;
+}): HeadersInit;
 //# sourceMappingURL=env.d.ts.map

package/build/es/env.js

@@ -91,8 +91,11 @@ export function buildEnvironmentContext(runtimeParams) {
 }
 // headers used by LWR-Node and LWR@MRT
 export const TRUE_CLIENT_IP = 'true-client-ip'; // public IP of the original request source, eg: 13.123.12.3
-export const B3_TRACE_ID = 'x-b3-traceid'; // trace ID shared across service boundaries for a page request, eg: 463ac35c9f6413ad48485a3953bb6124
 export const CORRELATION_ID = 'x-correlation-id'; // shared correlation ID for the request
+export const B3_TRACE_ID = 'x-b3-traceid'; // trace ID shared across service boundaries for a page request, set to inbound B3 header || lwr.handle.view trace ID
+export const B3_SPAN_ID = 'x-b3-spandid'; // span ID for a trace
+export const B3_PARENT_ID = 'x-b3-parentid'; // parent span ID for a trace
+export const B3_SAMPLED = 'x-b3-sampled'; // "0" = tracing is off, "1" = tracing is on
 export const MRT_REQUEST_CLASS = 'x-mobify-request-class'; // contains the site base path, eg: basePath=/mysite
 export const ROUTE_CORE_HEADER = 'x-sfdc-route-core'; // helps route requests to Core efficiently, value: true
 export const REQUEST_DEPTH_HEADER = 'x-sfdc-request-depth'; // tracks the request depth to prevent cycles to the LWR server, eg: 2
@@ -126,4 +129,20 @@ export function parseRequestDepth(headers = {}, query = {}) {
     }
     return maxDepth;
 }
+export function getTraceHeaders(runtimeParams, span) {
+    const headers = {};
+    if (runtimeParams.trueClientIP)
+        headers[TRUE_CLIENT_IP] = runtimeParams.trueClientIP;
+    if (runtimeParams.correlationID)
+        headers[CORRELATION_ID] = runtimeParams.correlationID;
+    if (span?.traceId) {
+        headers[B3_TRACE_ID] = span.traceId;
+        headers[B3_SAMPLED] = parseTracingFlag() ? '1' : '0';
+    }
+    if (span?.spanId)
+        headers[B3_SPAN_ID] = span.spanId;
+    if (span?.parentSpanId)
+        headers[B3_PARENT_ID] = span.parentSpanId;
+    return headers;
+}
 //# sourceMappingURL=env.js.map

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.17.2-alpha.12",
+    "version": "0.17.2-alpha.15",
     "homepage": "https://developer.salesforce.com/docs/platform/lwr/overview",
     "repository": {
         "type": "git",
@@ -37,7 +37,7 @@
         "build/**/*.d.ts"
     ],
     "dependencies": {
-        "@lwrjs/diagnostics": "0.17.2-alpha.12",
+        "@lwrjs/diagnostics": "0.17.2-alpha.15",
         "es-module-lexer": "^1.5.4",
         "fast-json-stable-stringify": "^2.1.0",
         "magic-string": "^0.30.9",
@@ -50,13 +50,13 @@
         "slugify": "^1.4.5"
     },
     "devDependencies": {
-        "@lwrjs/types": "0.17.2-alpha.12",
+        "@lwrjs/types": "0.17.2-alpha.15",
         "@types/mime-types": "2.1.4",
         "@types/path-to-regexp": "^1.7.0",
         "memfs": "^4.13.0"
     },
     "engines": {
-        "node": ">=18.0.0"
+        "node": ">=20.0.0"
     },
-    "gitHead": "f5d7c20e7aec008c06db8d5e289c8cb1e3467005"
+    "gitHead": "91299b871adb9aea8c743d830dd62bce418a0933"
 }