@tallyrow/safesignal 1.0.1-rc.2 → 1.2.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { g as LoggerConfig, C as CreateLoggerOptions, f as Logger, R as RedactionRule, h as Redactor, i as ScrubUrlOptions, j as TransportFactory } from './types-D-xVvmvX.cjs';
-export { A as AppIdentity, a as AttributeValue, b as Attributes, E as ErrorInfo, L as LevelMap, c as LogContext, d as LogEvent, e as LogLevel, M as ModuleIdentity, S as SanitizerLimits, T as Transport } from './types-D-xVvmvX.cjs';
+import { g as LoggerConfig, C as CreateLoggerOptions, f as Logger, R as RedactionRule, h as Redactor, i as ScrubUrlOptions, T as TraceContext, k as TransportFactory } from './types-BiRyHi1e.cjs';
+export { A as AppIdentity, a as AttributeValue, b as Attributes, E as ErrorInfo, L as LevelMap, c as LogContext, d as LogEvent, e as LogLevel, M as ModuleIdentity, S as SanitizerLimits, j as Transport } from './types-BiRyHi1e.cjs';
 
 /**
  * Public logger factories and root configuration flow.
@@ -138,6 +138,29 @@ declare function createRedactor(rules?: RedactionRule[]): Redactor;
 
 declare function scrubUrl(url: string, options?: ScrubUrlOptions): string;
 
+/**
+ * Pure W3C `traceparent` parser — the one ergonomic affordance for the common
+ * case where a host holds the header string (e.g. SSR-injected) rather than a
+ * pre-parsed object.
+ *
+ * Format: `version-traceId-spanId-flags` =
+ *   `00-<32hex>-<16hex>-<2hex>`. Version `00` is the current spec; for forward
+ * compatibility, any 2-hex version is accepted and only the four known fields
+ * are read (extra trailing fields are ignored).
+ *
+ * The parsed candidate is run through `normalizeTraceContext`, so the result is
+ * always a valid `TraceContext` or `undefined`. NEVER throws.
+ *
+ * Specs: `specs/008-trace-context/contracts/trace-context.md` TC-5;
+ * `research.md` D2.
+ */
+
+/**
+ * Parse a W3C `traceparent` string (and optional `tracestate`) into a validated
+ * `TraceContext`, or `undefined` on any shape violation. Pure; never throws.
+ */
+declare function parseTraceparent(traceparent: string, tracestate?: string): TraceContext | undefined;
+
 /**
  * Built-in `ConsoleTransport`. Passes events to `console[level]` with the
  * event message as the first argument and the **structured `LogEvent`
@@ -164,4 +187,4 @@ declare const ConsoleTransport: TransportFactory;
 
 declare const NoopTransport: TransportFactory;
 
-export { ConsoleTransport, CreateLoggerOptions, Logger, LoggerConfig, NoopTransport, RedactionRule, Redactor, ScrubUrlOptions, TransportFactory, configureLogging, createLogger, createRedactor, getRootLogger, scrubUrl };
+export { ConsoleTransport, CreateLoggerOptions, Logger, LoggerConfig, NoopTransport, RedactionRule, Redactor, ScrubUrlOptions, TraceContext, TransportFactory, configureLogging, createLogger, createRedactor, getRootLogger, parseTraceparent, scrubUrl };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { g as LoggerConfig, C as CreateLoggerOptions, f as Logger, R as RedactionRule, h as Redactor, i as ScrubUrlOptions, j as TransportFactory } from './types-D-xVvmvX.js';
-export { A as AppIdentity, a as AttributeValue, b as Attributes, E as ErrorInfo, L as LevelMap, c as LogContext, d as LogEvent, e as LogLevel, M as ModuleIdentity, S as SanitizerLimits, T as Transport } from './types-D-xVvmvX.js';
+import { g as LoggerConfig, C as CreateLoggerOptions, f as Logger, R as RedactionRule, h as Redactor, i as ScrubUrlOptions, T as TraceContext, k as TransportFactory } from './types-BiRyHi1e.js';
+export { A as AppIdentity, a as AttributeValue, b as Attributes, E as ErrorInfo, L as LevelMap, c as LogContext, d as LogEvent, e as LogLevel, M as ModuleIdentity, S as SanitizerLimits, j as Transport } from './types-BiRyHi1e.js';
 
 /**
  * Public logger factories and root configuration flow.
@@ -138,6 +138,29 @@ declare function createRedactor(rules?: RedactionRule[]): Redactor;
 
 declare function scrubUrl(url: string, options?: ScrubUrlOptions): string;
 
+/**
+ * Pure W3C `traceparent` parser — the one ergonomic affordance for the common
+ * case where a host holds the header string (e.g. SSR-injected) rather than a
+ * pre-parsed object.
+ *
+ * Format: `version-traceId-spanId-flags` =
+ *   `00-<32hex>-<16hex>-<2hex>`. Version `00` is the current spec; for forward
+ * compatibility, any 2-hex version is accepted and only the four known fields
+ * are read (extra trailing fields are ignored).
+ *
+ * The parsed candidate is run through `normalizeTraceContext`, so the result is
+ * always a valid `TraceContext` or `undefined`. NEVER throws.
+ *
+ * Specs: `specs/008-trace-context/contracts/trace-context.md` TC-5;
+ * `research.md` D2.
+ */
+
+/**
+ * Parse a W3C `traceparent` string (and optional `tracestate`) into a validated
+ * `TraceContext`, or `undefined` on any shape violation. Pure; never throws.
+ */
+declare function parseTraceparent(traceparent: string, tracestate?: string): TraceContext | undefined;
+
 /**
  * Built-in `ConsoleTransport`. Passes events to `console[level]` with the
  * event message as the first argument and the **structured `LogEvent`
@@ -164,4 +187,4 @@ declare const ConsoleTransport: TransportFactory;
 
 declare const NoopTransport: TransportFactory;
 
-export { ConsoleTransport, CreateLoggerOptions, Logger, LoggerConfig, NoopTransport, RedactionRule, Redactor, ScrubUrlOptions, TransportFactory, configureLogging, createLogger, createRedactor, getRootLogger, scrubUrl };
+export { ConsoleTransport, CreateLoggerOptions, Logger, LoggerConfig, NoopTransport, RedactionRule, Redactor, ScrubUrlOptions, TraceContext, TransportFactory, configureLogging, createLogger, createRedactor, getRootLogger, parseTraceparent, scrubUrl };

package/dist/index.mjs

@@ -18,12 +18,16 @@ function mergeContexts(...sources) {
         src.attributes
       );
     }
+    if (src.trace !== void 0) {
+      merged.trace = src.trace;
+    }
   }
   const out = {};
   if (merged.application !== void 0) out.application = merged.application;
   if (merged.module !== void 0) out.module = merged.module;
   if (merged.environment !== void 0) out.environment = merged.environment;
   if (merged.attributes !== void 0) out.attributes = merged.attributes;
+  if (merged.trace !== void 0) out.trace = merged.trace;
   return out;
 }
 function deepMergeAttributes(earlier, later) {
@@ -92,7 +96,7 @@ function escapeControlChars(value) {
   if (!HAS_CONTROL_CHAR.test(value)) return value;
   return value.replace(CONTROL_CHAR_GLOBAL, (ch) => {
     const code = ch.charCodeAt(0);
-    return "\\u" + code.toString(16).padStart(4, "0");
+    return `\\u${code.toString(16).padStart(4, "0")}`;
   });
 }
 var controlCharGuard = (event, _config) => {
@@ -240,7 +244,10 @@ function createRedactor(rules) {
     let error = event.error;
     if (event.error !== void 0) {
       const escName = applyShapeRules(event.error.name, compiled.shapeRules);
-      const escMessage = applyShapeRules(event.error.message, compiled.shapeRules);
+      const escMessage = applyShapeRules(
+        event.error.message,
+        compiled.shapeRules
+      );
       const stack = event.error.stack;
       const escStack = stack === void 0 ? void 0 : applyShapeRules(stack, compiled.shapeRules);
       const errorChanged = escName !== event.error.name || escMessage !== event.error.message || escStack !== stack;
@@ -365,12 +372,13 @@ function isLogEventShape(value) {
     return false;
   }
   const obj = value;
-  if (typeof obj["timestamp"] !== "string") return false;
-  if (typeof obj["level"] !== "string") return false;
-  if (!VALID_LEVELS.has(obj["level"])) return false;
-  if (typeof obj["message"] !== "string") return false;
-  if (obj["attributes"] === null || typeof obj["attributes"] !== "object") return false;
-  if (obj["context"] === null || typeof obj["context"] !== "object") return false;
+  if (typeof obj.timestamp !== "string") return false;
+  if (typeof obj.level !== "string") return false;
+  if (!VALID_LEVELS.has(obj.level)) return false;
+  if (typeof obj.message !== "string") return false;
+  if (obj.attributes === null || typeof obj.attributes !== "object")
+    return false;
+  if (obj.context === null || typeof obj.context !== "object") return false;
   return true;
 }
 
@@ -450,7 +458,8 @@ function sanitizeValueImpl(value, depth, ctx) {
   if (depth > ctx.maxDepth) return "[MaxDepth]";
   if (value === null) return null;
   const t = typeof value;
-  if (t === "string") return truncateString(value, ctx.maxStringLength);
+  if (t === "string")
+    return truncateString(value, ctx.maxStringLength);
   if (t === "number") {
     const n = value;
     return Number.isFinite(n) ? n : null;
@@ -560,7 +569,7 @@ function sanitizeErrorAsAttribute(err, depth, ctx) {
   };
   const stack = safeOptional(() => err.stack);
   if (stack !== void 0) {
-    reduced["stack"] = stack;
+    reduced.stack = stack;
   }
   return sanitizeObject(reduced, depth, ctx);
 }
@@ -681,7 +690,7 @@ var urlScrub = (event, _config) => {
   const message = maybeScrubString(event.message);
   const attributes = walkAttributes2(event.attributes);
   const context = walkContext3(event.context);
-  let error = void 0;
+  let error;
   if (event.error !== void 0) {
     const scrubbedMessage = maybeScrubString(event.error.message);
     const stack = event.error.stack;
@@ -745,7 +754,7 @@ function scrubHashFragment(parsed, extras) {
     }
   }
   if (!changed) return false;
-  parsed.hash = "#" + out.join("&");
+  parsed.hash = `#${out.join("&")}`;
   return true;
 }
 function isDenied(name, extras) {
@@ -1108,6 +1117,36 @@ function installRuntime(runtime) {
   return previous;
 }
 
+// src/trace/validate.ts
+var MAX_TRACESTATE_LEN = 512;
+var TRACE_ID_RE = /^[0-9a-f]{32}$/;
+var SPAN_ID_RE = /^[0-9a-f]{16}$/;
+var ALL_ZERO_TRACE_ID = "0".repeat(32);
+var ALL_ZERO_SPAN_ID = "0".repeat(16);
+function isValidTraceId(value) {
+  return typeof value === "string" && TRACE_ID_RE.test(value) && value !== ALL_ZERO_TRACE_ID;
+}
+function isValidSpanId(value) {
+  return typeof value === "string" && SPAN_ID_RE.test(value) && value !== ALL_ZERO_SPAN_ID;
+}
+function normalizeTraceContext(candidate) {
+  if (typeof candidate !== "object" || candidate === null) {
+    return void 0;
+  }
+  const c = candidate;
+  if (!isValidTraceId(c.traceId) || !isValidSpanId(c.spanId)) {
+    return void 0;
+  }
+  const trace = { traceId: c.traceId, spanId: c.spanId };
+  if (typeof c.traceFlags === "number" && Number.isInteger(c.traceFlags) && c.traceFlags >= 0 && c.traceFlags <= 255) {
+    trace.traceFlags = c.traceFlags;
+  }
+  if (typeof c.traceState === "string" && c.traceState.length > 0 && c.traceState.length <= MAX_TRACESTATE_LEN) {
+    trace.traceState = c.traceState;
+  }
+  return trace;
+}
+
 // src/api/logger.ts
 var rootLogger;
 function installState(config) {
@@ -1180,6 +1219,14 @@ function makeLogger(options, chainedContexts) {
       ...chainedContexts,
       correlation
     );
+    if (context.trace !== void 0) {
+      const normalized = normalizeTraceContext(context.trace);
+      if (normalized === void 0) {
+        delete context.trace;
+      } else {
+        context.trace = normalized;
+      }
+    }
     const event = buildLogEvent({
       level,
       message,
@@ -1211,6 +1258,27 @@ function makeLogger(options, chainedContexts) {
   };
 }
 
+// src/trace/traceparent.ts
+var VERSION_RE = /^[0-9a-f]{2}$/;
+function parseTraceparent(traceparent, tracestate) {
+  if (typeof traceparent !== "string") return void 0;
+  const parts = traceparent.trim().split("-");
+  if (parts.length < 4) return void 0;
+  const [version, traceId, spanId, flagsHex] = parts;
+  if (version === void 0 || !VERSION_RE.test(version)) return void 0;
+  if (version === "ff") return void 0;
+  if (flagsHex === void 0 || !/^[0-9a-f]{2}$/.test(flagsHex)) {
+    return void 0;
+  }
+  const traceFlags = Number.parseInt(flagsHex, 16);
+  return normalizeTraceContext({
+    traceId,
+    spanId,
+    traceFlags,
+    ...typeof tracestate === "string" ? { traceState: tracestate } : {}
+  });
+}
+
 // src/transport/console-transport.ts
 function resolveConsoleMethod(level) {
   const slot = console[level];
@@ -1227,6 +1295,6 @@ var ConsoleTransport = () => ({
   }
 });
 
-export { ConsoleTransport, NoopTransport, configureLogging, createLogger, createRedactor, getRootLogger, scrubUrl };
+export { ConsoleTransport, NoopTransport, configureLogging, createLogger, createRedactor, getRootLogger, parseTraceparent, scrubUrl };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map