@logbrew/sdk 0.1.18 → 0.1.20

package/README.md

@@ -25,7 +25,7 @@ node node_modules/@logbrew/sdk/examples/index.mjs agent-timeline
 npm --prefix node_modules/@logbrew/sdk/examples run agent-timeline
 ```
 
-For Vite apps, add the build-time release-artifact plugin to `vite.config.js`. It enables hidden source maps when your config has not chosen a source-map mode, injects matching Debug IDs after the build, strips embedded source text and local source prefixes, writes a privacy-bounded manifest, and can upload the prepared artifacts before the build completes:
+For Vite apps, add the build-time release-artifact plugin to `vite.config.js`. It enables hidden source maps and function-name preservation when your config has not made either choice, injects matching Debug IDs after the build, strips embedded source text and local source prefixes, writes a privacy-bounded manifest, and can upload the prepared artifacts before the build completes:
 
 ```js
 import { createLogBrewViteReleaseArtifactsPlugin } from "@logbrew/sdk/vite-release-artifacts";
@@ -48,7 +48,7 @@ export default {
 };
 ```
 
-Set `LOGBREW_RELEASE_ARTIFACT_TOKEN` in the build environment to a dedicated release-artifact token. Use `tokenEnv` when your CI uses a different environment variable name, or `dryRun: true` to prepare the complete build output without a network request. The plugin runs only during Vite builds, keeps upload disabled when `upload` is omitted, and fails the build when preparation or upload cannot complete safely. It never uses normal SDK ingest keys or account/session API values.
+Set `LOGBREW_RELEASE_ARTIFACT_TOKEN` in the build environment to a dedicated release-artifact token. Use `tokenEnv` when your CI uses a different environment variable name, or `dryRun: true` to prepare the complete build output without a network request. The plugin runs only during Vite builds, keeps upload disabled when `upload` is omitted, and fails the build when preparation or upload cannot complete safely. It never uses normal SDK ingest keys or account/session API values. When your app chooses `build.minify` or multiple Rolldown outputs explicitly, configure `keepNames` for that build; otherwise captured stacks retain shortened function labels.
 
 The package also ships the dependency-free `logbrew-release-artifacts` command for JavaScript source-map preparation and upload. Use it after your frontend build to inject matching Debug IDs, strip embedded source text by default, and create a privacy-bounded manifest that can be inspected before upload:
 
@@ -102,7 +102,7 @@ npx logbrew-release-artifacts upload-js \
 
 Non-loopback endpoints require `--allow-hosted`, a UUID `projectId` created by `manifest-js --project-id`, HTTPS, and no embedded auth values, query strings, or fragments. Local loopback preparation remains valid without a project ID. The upload command never uses normal SDK ingest keys or account/session API auth values. Full backend-symbolicated issue support is separate from artifact upload until your project has completed hosted symbolication for its release.
 
-When you capture a JavaScript error, use `createIssueAttributesFromError()` to keep error metadata structured and source-map-friendly without sending raw stack text by default. The helper also follows `Error.cause` and `AggregateError.errors` into a bounded parent-first exception graph. Automatic messages are marked redacted, every node reports whether frames were captured, truncated, or unavailable, and unsafe accessors, cycles, or the eight-node cap mark the graph truncated instead of inventing evidence. React, browser, Node, Next.js, and React Native helpers reuse this same core projection. See the shared [exception-chain contract](../../docs/exception-chain-evidence.md). Pass a Debug ID map from your app-owned build setup when you want the issue event to carry release-artifact metadata:
+When you capture a JavaScript error, use `createIssueAttributesFromError()` to keep error metadata structured and source-map-friendly without sending raw stack text by default. The helper also follows `Error.cause` and `AggregateError.errors` into a bounded parent-first exception graph. Automatic messages are marked redacted, every node reports whether frames were captured, truncated, or unavailable, and unsafe accessors, cycles, or the eight-node cap mark the graph truncated instead of inventing evidence. React, browser, Node, Next.js, and React Native helpers reuse this same core projection. See the shared [exception-chain contract](../../docs/exception-chain-evidence.md). A bundle prepared by the Vite plugin registers its Debug ID automatically; use `debugIdMap` only for a different app-owned build flow:
 
 ```js
 import { createIssueAttributesFromError, LogBrewClient } from "@logbrew/sdk";

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.18",
+  "version": "0.1.20",
   "description": "Public LogBrew JavaScript SDK for building, validating, and flushing event batches.",
   "type": "module",
   "main": "./index.cjs",

package/vite-release-artifacts.cjs

@@ -55,6 +55,16 @@ function resolveBuildDir(root, outDir, explicitBuildDir) {
   return resolvePathFromRoot(root, outDir || "dist");
 }
 
+function viteMajorVersion(root) {
+  try {
+    const manifestPath = require.resolve("vite/package.json", { paths: [path.resolve(root || process.cwd())] });
+    const version = JSON.parse(fs.readFileSync(manifestPath, "utf8")).version;
+    return Number.parseInt(version, 10) || 0;
+  } catch {
+    return 0;
+  }
+}
+
 function createLogBrewViteReleaseArtifactsPlugin(options) {
   const release = requiredString(options, "release");
   const environment = requiredString(options, "environment");
@@ -78,10 +88,21 @@ function createLogBrewViteReleaseArtifactsPlugin(options) {
     apply: "build",
     enforce: "post",
     config(config = {}) {
-      if (!enableSourceMaps || config.build?.sourcemap !== undefined) {
-        return null;
-      }
-      return { build: { sourcemap: "hidden" } };
+      const sourceMap = enableSourceMaps && config.build?.sourcemap === undefined;
+      const keepNames = config.build?.minify === undefined;
+      const output = config.build?.rolldownOptions?.output;
+      const viteMajor = viteMajorVersion(config.root);
+      const modernNames = keepNames && viteMajor >= 8
+        && !Array.isArray(output) && output?.keepNames === undefined;
+      const legacyNames = keepNames && viteMajor < 8
+        && config.esbuild !== false && config.esbuild?.keepNames === undefined;
+      return sourceMap || modernNames || legacyNames ? {
+        ...(sourceMap || modernNames ? { build: {
+          ...(sourceMap ? { sourcemap: "hidden" } : {}),
+          ...(modernNames ? { rolldownOptions: { output: { keepNames: true } } } : {})
+        } } : {}),
+        ...(legacyNames ? { esbuild: { keepNames: true } } : {})
+      } : null;
     },
     configResolved(config) {
       viteRoot = config?.root ? path.resolve(config.root) : process.cwd();

package/vite-release-artifacts.d.cts

@@ -28,7 +28,7 @@ export interface LogBrewViteReleaseArtifactsPlugin {
   name: "logbrew-vite-release-artifacts";
   apply: "build";
   enforce: "post";
-  config(config?: { build?: { sourcemap?: unknown } }): null | { build: { sourcemap: "hidden" } };
+  config(config?: { root?: string; build?: { sourcemap?: unknown; minify?: unknown; rolldownOptions?: { output?: { keepNames?: boolean } | Array<{ keepNames?: boolean }> } }; esbuild?: false | { keepNames?: boolean } }): null | { build?: { sourcemap?: "hidden"; rolldownOptions?: { output: { keepNames: true } } }; esbuild?: { keepNames: true } };
   configResolved(config: {
     root?: string;
     build?: { outDir?: string };

package/vite-release-artifacts.d.ts

@@ -28,7 +28,7 @@ export interface LogBrewViteReleaseArtifactsPlugin {
   name: "logbrew-vite-release-artifacts";
   apply: "build";
   enforce: "post";
-  config(config?: { build?: { sourcemap?: unknown } }): null | { build: { sourcemap: "hidden" } };
+  config(config?: { root?: string; build?: { sourcemap?: unknown; minify?: unknown; rolldownOptions?: { output?: { keepNames?: boolean } | Array<{ keepNames?: boolean }> } }; esbuild?: false | { keepNames?: boolean } }): null | { build?: { sourcemap?: "hidden"; rolldownOptions?: { output: { keepNames: true } } }; esbuild?: { keepNames: true } };
   configResolved(config: {
     root?: string;
     build?: { outDir?: string };