@logbrew/sdk 0.1.19 → 0.1.20

package/core.cjs

@@ -133,7 +133,8 @@ const {
 
 const {
   javascriptStackEvidence,
-  validateIssueStackFrames
+  validateIssueStackFrames,
+  validateNativeStackFrames
 } = buildIssueStackHelpers({ SdkError });
 const {
   MAX_ISSUE_BREADCRUMBS,
@@ -2256,6 +2257,9 @@ function cloneSpanLinks(links) {
 
 function cloneEvent(event) {
   const attributes = { ...event.attributes, ...cloneIssueDiagnostics(event.attributes) };
+  if (Array.isArray(event.attributes.nativeStackFrames)) {
+    attributes.nativeStackFrames = event.attributes.nativeStackFrames.map((frame) => ({ ...frame }));
+  }
   if (event.attributes.metadata !== undefined) {
     attributes.metadata = { ...event.attributes.metadata };
   }
@@ -2295,11 +2299,13 @@ function validateIssue(attributes) {
   requireNonEmpty("issue title", attributes.title);
   const level = normalizeSeverity("issue level", attributes.level);
   const stackFrames = validateIssueStackFrames(attributes.stackFrames);
+  const nativeStackFrames = validateNativeStackFrames(attributes.nativeStackFrames);
   return withMetadata({
     title: attributes.title,
     level,
     ...(attributes.message !== undefined ? { message: attributes.message } : {}),
     ...(stackFrames !== undefined ? { stackFrames } : {}),
+    ...(nativeStackFrames !== undefined ? { nativeStackFrames } : {}),
     ...validateIssueDiagnostics(attributes)
   }, attributes.metadata, attributes.context);
 }

package/index.d.ts

@@ -389,6 +389,14 @@ export type IssueDiagnosticEvidence = {
   truncatedFields?: string[];
 };
 
+export type NativeStackArchitecture = "arm" | "arm64" | "arm64e" | "x86" | "x86_64";
+
+export type NativeStackFrame = {
+  imageUuid: string;
+  architecture: NativeStackArchitecture;
+  instructionOffset: string;
+};
+
 /** Public issue event attributes. */
 export type IssueAttributes = {
   title: string;
@@ -399,6 +407,8 @@ export type IssueAttributes = {
   exceptionChain?: IssueExceptionChain;
   /** Ordered privacy-bounded generated frames, capped at 32. */
   stackFrames?: IssueStackFrame[];
+  /** Ordered native image-relative frames for exact release symbolication, capped at 32. */
+  nativeStackFrames?: NativeStackFrame[];
   /** Oldest-to-newest issue history, capped at the most recent 64 entries. */
   breadcrumbs?: IssueBreadcrumb[];
   /** True when older or invalid history was omitted before capture. */

package/issue-stack.cjs

@@ -4,6 +4,9 @@ const MAX_ISSUE_STACK_FRAMES = 32;
 const MAX_ISSUE_STACK_FUNCTION_LENGTH = 256;
 const MAX_ISSUE_STACK_MODULE_LENGTH = 512;
 const SAFE_DEBUG_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/iu;
+const NATIVE_IMAGE_UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/u;
+const NATIVE_OFFSET_PATTERN = /^[0-9a-f]{16}$/u;
+const NATIVE_ARCHITECTURES = new Set(["arm", "arm64", "arm64e", "x86", "x86_64"]);
 const LOCAL_ABSOLUTE_PATH_PATTERN = /(?:^|\s)(?:\/(?:Users|home|private|tmp|var|Volumes)\/|[A-Za-z]:[\\/])/u;
 const DEBUG_ID_REGISTRY = Symbol.for("logbrew.release-artifact.debug-ids");
 
@@ -87,7 +90,31 @@ function buildIssueStackHelpers({ SdkError }) {
     });
   }
 
-  return { javascriptStackEvidence, validateIssueStackFrames };
+  function validateNativeStackFrames(frames) {
+    if (frames === undefined) {
+      return undefined;
+    }
+    if (!Array.isArray(frames) || frames.length === 0 || frames.length > MAX_ISSUE_STACK_FRAMES) {
+      throw new SdkError("validation_error", `issue nativeStackFrames must contain 1-${MAX_ISSUE_STACK_FRAMES} frames`);
+    }
+    return frames.map((frame) => {
+      const keys = frame && !Array.isArray(frame) && typeof frame === "object" ? Object.keys(frame) : [];
+      if (keys.length !== 3
+        || !keys.every((key) => ["imageUuid", "architecture", "instructionOffset"].includes(key))
+        || typeof frame.imageUuid !== "string" || !NATIVE_IMAGE_UUID_PATTERN.test(frame.imageUuid)
+        || !NATIVE_ARCHITECTURES.has(frame.architecture)
+        || typeof frame.instructionOffset !== "string" || !NATIVE_OFFSET_PATTERN.test(frame.instructionOffset)) {
+        throw new SdkError("validation_error", "issue native stack frame is invalid");
+      }
+      return {
+        imageUuid: frame.imageUuid,
+        architecture: frame.architecture,
+        instructionOffset: frame.instructionOffset
+      };
+    });
+  }
+
+  return { javascriptStackEvidence, validateIssueStackFrames, validateNativeStackFrames };
 }
 
 function parseJavaScriptStackFrame(rawLine) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logbrew/sdk",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "Public LogBrew JavaScript SDK for building, validating, and flushing event batches.",
   "type": "module",
   "main": "./index.cjs",