@tallyrow/safesignal 1.3.0 → 1.4.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, 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';
+import { g as LoggerConfig, C as CreateLoggerOptions, f as Logger, R as RedactionRule, h as Redactor, i as ScrubUrlOptions, T as TraceContext, m as TransportFactory } from './types-CZtSjgq5.cjs';
+export { A as AppIdentity, a as AttributeValue, b as Attributes, B as BreadcrumbsOptions, E as ErrorInfo, L as LevelMap, c as LogContext, d as LogEvent, e as LogLevel, M as ModuleIdentity, S as SanitizerLimits, j as StackFrame, k as StackNormalizer, l as Transport } from './types-CZtSjgq5.cjs';
 
 /**
  * Public logger factories and root configuration flow.

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, 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';
+import { g as LoggerConfig, C as CreateLoggerOptions, f as Logger, R as RedactionRule, h as Redactor, i as ScrubUrlOptions, T as TraceContext, m as TransportFactory } from './types-CZtSjgq5.js';
+export { A as AppIdentity, a as AttributeValue, b as Attributes, B as BreadcrumbsOptions, E as ErrorInfo, L as LevelMap, c as LogContext, d as LogEvent, e as LogLevel, M as ModuleIdentity, S as SanitizerLimits, j as StackFrame, k as StackNormalizer, l as Transport } from './types-CZtSjgq5.js';
 
 /**
  * Public logger factories and root configuration flow.

package/dist/index.mjs

@@ -1,3 +1,119 @@
+// src/internal/errors/internal-errors.ts
+var PACKAGE_ERROR_MARKER = /* @__PURE__ */ Symbol("frontend-logging-sdk/package-error");
+var PackageError = class extends Error {
+  constructor(code, message, options = {}) {
+    super(message);
+    this.name = "PackageError";
+    this.code = code;
+    if (options.cause !== void 0) {
+      this.cause = options.cause;
+    }
+    if (options.transportName !== void 0) {
+      this.transportName = options.transportName;
+    }
+    Object.defineProperty(this, PACKAGE_ERROR_MARKER, {
+      value: true,
+      enumerable: false,
+      writable: false,
+      configurable: false
+    });
+  }
+};
+function isPackageError(value) {
+  if (typeof value !== "object" || value === null) return false;
+  return value[PACKAGE_ERROR_MARKER] === true;
+}
+function wrapAsPackageError(code, message, cause, transportName) {
+  if (isPackageError(cause)) return cause;
+  const options = { cause };
+  if (transportName !== void 0) {
+    options.transportName = transportName;
+  }
+  return new PackageError(code, message, options);
+}
+function safeNotify(onInternalError, err) {
+  try {
+    onInternalError(err);
+  } catch {
+  }
+}
+
+// src/breadcrumbs/breadcrumb-buffer.ts
+function breadcrumbFail(onInternalError, err) {
+  safeNotify(
+    onInternalError,
+    wrapAsPackageError("breadcrumb_failed", "breadcrumb failed", err)
+  );
+}
+var DEFAULT_MAX_EVENTS = 20;
+var MAX_EVENTS_BOUND = 100;
+var BREADCRUMBS_KEY = "safesignal.breadcrumbs";
+function buildSnapshot(event) {
+  const snap = {
+    ts: event.timestamp,
+    level: event.level,
+    message: event.message
+  };
+  const app = event.context.application?.name;
+  if (app !== void 0) snap.app = app;
+  const mod = event.context.module?.name;
+  if (mod !== void 0) snap.module = mod;
+  const attrs = {};
+  let hasAttrs = false;
+  for (const key of Object.keys(event.attributes)) {
+    const value = event.attributes[key];
+    if (key === BREADCRUMBS_KEY || value === void 0) continue;
+    attrs[key] = value;
+    hasAttrs = true;
+  }
+  if (hasAttrs) snap.attributes = attrs;
+  return snap;
+}
+var BreadcrumbBuffer = class {
+  constructor(maxEvents) {
+    this.ring = [];
+    this.capacity = maxEvents;
+  }
+  /** Record a compact snapshot of a post-pipeline event; oldest evicted. */
+  record(event) {
+    this.ring.push(buildSnapshot(event));
+    if (this.ring.length > this.capacity) this.ring.shift();
+  }
+  /**
+   * Attach the current trail to an error event as `attributes[BREADCRUMBS_KEY]`
+   * (ordered oldest→newest). No-op when the buffer is empty (no placeholder).
+   */
+  attachTrailTo(event) {
+    if (this.ring.length === 0) return;
+    event.attributes[BREADCRUMBS_KEY] = this.ring.slice();
+  }
+};
+var MAX_CAUSE_DEPTH = 8;
+var CAUSES_KEY = "safesignal.errorCauses";
+function getCause(value) {
+  if (value !== null && typeof value === "object" && "cause" in value) {
+    return value.cause;
+  }
+  return void 0;
+}
+function extractCauseChain(value, maxDepth) {
+  const chain = [];
+  const seen = /* @__PURE__ */ new Set();
+  if (value !== null && typeof value === "object") seen.add(value);
+  let current = getCause(value);
+  while (current !== void 0 && current !== null && chain.length < maxDepth) {
+    if (typeof current === "object") {
+      if (seen.has(current)) break;
+      seen.add(current);
+    }
+    chain.push(
+      current instanceof Error ? { name: current.name, message: current.message } : { name: "NonError", message: String(current) }
+    );
+    current = getCause(current);
+  }
+  return chain;
+}
+
 // src/context/context-merge.ts
 function mergeContexts(...sources) {
   const merged = {};
@@ -48,46 +164,6 @@ function isPlainAttributeObject(value) {
   return value !== null && value !== void 0 && typeof value === "object" && !Array.isArray(value);
 }
 
-// src/internal/errors/internal-errors.ts
-var PACKAGE_ERROR_MARKER = /* @__PURE__ */ Symbol("frontend-logging-sdk/package-error");
-var PackageError = class extends Error {
-  constructor(code, message, options = {}) {
-    super(message);
-    this.name = "PackageError";
-    this.code = code;
-    if (options.cause !== void 0) {
-      this.cause = options.cause;
-    }
-    if (options.transportName !== void 0) {
-      this.transportName = options.transportName;
-    }
-    Object.defineProperty(this, PACKAGE_ERROR_MARKER, {
-      value: true,
-      enumerable: false,
-      writable: false,
-      configurable: false
-    });
-  }
-};
-function isPackageError(value) {
-  if (typeof value !== "object" || value === null) return false;
-  return value[PACKAGE_ERROR_MARKER] === true;
-}
-function wrapAsPackageError(code, message, cause, transportName) {
-  if (isPackageError(cause)) return cause;
-  const options = { cause };
-  if (transportName !== void 0) {
-    options.transportName = transportName;
-  }
-  return new PackageError(code, message, options);
-}
-function safeNotify(onInternalError, err) {
-  try {
-    onInternalError(err);
-  } catch {
-  }
-}
-
 // src/pipeline/control-char-guard.ts
 var CONTROL_CHAR_CLASS = "[\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u2028\\u2029]";
 var HAS_CONTROL_CHAR = new RegExp(CONTROL_CHAR_CLASS);
@@ -845,6 +921,13 @@ function dispatch(event, config) {
     if (current === null) return;
     current = controlCharGuard(current, config);
     if (current === null) return;
+    if (config.breadcrumbs !== void 0 && current.level === "error") {
+      try {
+        config.breadcrumbs.attachTrailTo(current);
+      } catch (err) {
+        breadcrumbFail(config.onInternalError, err);
+      }
+    }
     current = freezeInDev(current, config);
     if (current === null) return;
   } catch (err) {
@@ -867,6 +950,13 @@ function dispatch(event, config) {
     } catch {
     }
   }
+  if (config.breadcrumbs !== void 0) {
+    try {
+      config.breadcrumbs.record(current);
+    } catch (err) {
+      breadcrumbFail(config.onInternalError, err);
+    }
+  }
 }
 
 // src/pipeline/event-builder.ts
@@ -954,9 +1044,32 @@ function normalizeConfig(config) {
     transports,
     redactor: config.redactor,
     sanitizerLimits,
+    breadcrumbs: resolveBreadcrumbs(config.breadcrumbs, onInternalError),
+    normalizeStack: config.normalizeStack,
     onInternalError
   };
 }
+function resolveBreadcrumbs(option, onInternalError) {
+  if (!option) return void 0;
+  const requested = option === true ? void 0 : option.maxEvents;
+  if (requested === void 0 || !Number.isFinite(requested)) {
+    return new BreadcrumbBuffer(DEFAULT_MAX_EVENTS);
+  }
+  const maxEvents = Math.min(
+    MAX_EVENTS_BOUND,
+    Math.max(1, Math.floor(requested))
+  );
+  if (maxEvents !== requested) {
+    safeNotify(
+      onInternalError,
+      new PackageError(
+        "breadcrumbs_max_clamped",
+        `breadcrumbs.maxEvents clamped to ${maxEvents}`
+      )
+    );
+  }
+  return new BreadcrumbBuffer(maxEvents);
+}
 function resolveConfigLevel(level, environment) {
   if (level === void 0) {
     return defaultLevelForEnvironment(environment);
@@ -1234,6 +1347,33 @@ function makeLogger(options, chainedContexts) {
       context,
       errorValue
     });
+    if (cfg.breadcrumbs !== void 0 && level === "error" && errorValue !== void 0) {
+      try {
+        const causes = extractCauseChain(errorValue, MAX_CAUSE_DEPTH);
+        if (causes.length > 0) {
+          event.attributes[CAUSES_KEY] = causes;
+        }
+      } catch (err) {
+        breadcrumbFail(cfg.onInternalError, err);
+      }
+    }
+    if (cfg.normalizeStack !== void 0 && level === "error" && event.error?.stack !== void 0) {
+      try {
+        const frames = cfg.normalizeStack(event.error.stack);
+        if (frames !== null && frames.length > 0) {
+          event.attributes["safesignal.stack"] = frames;
+        }
+      } catch (err) {
+        safeNotify(
+          cfg.onInternalError,
+          wrapAsPackageError(
+            "stack_normalize_failed",
+            "stack normalize failed",
+            err
+          )
+        );
+      }
+    }
     dispatch(event, cfg);
   }
   return {