@logbrew/react-native 0.1.18 → 0.1.20

package/README.md

@@ -293,10 +293,15 @@ module. For a bare React Native app, add the optional subspec inside the app
 target in `ios/Podfile`, then run `pod install`:
 
 ```ruby
-logbrew_react_native_path = File.dirname(`node --print "require.resolve('@logbrew/react-native')"`)
+require 'pathname'
+logbrew_react_native_path = Pathname(File.dirname(`bun --print "require.resolve('@logbrew/react-native')"`)).relative_path_from(Pathname(__dir__)).to_s
 pod 'LogBrewReactNative/AppleNativeDiagnostics', :path => logbrew_react_native_path
 ```
 
+Keep the resolved package path relative to the Podfile directory. React Native
+autolinking declares the core pod with that relative source; CocoaPods rejects
+the same pod when the optional subspec uses an absolute source.
+
 The default `LogBrewReactNative/Core` subspec remains unchanged and supports
 iOS 13. `AppleNativeDiagnostics` requires iOS 15. Install it on the main thread
 before root registration, then start replay:
@@ -304,7 +309,8 @@ before root registration, then start replay:
 ```js
 import {
   installLogBrewAppleNativeDiagnostics,
-  replayLogBrewAppleNativeDiagnostics
+  replayLogBrewAppleNativeDiagnostics,
+  setLogBrewAppleNativeCrashContext
 } from "@logbrew/react-native/apple-native-diagnostics";
 
 const nativeStatus = installLogBrewAppleNativeDiagnostics({
@@ -317,6 +323,13 @@ const nativeStatus = installLogBrewAppleNativeDiagnostics({
   hangThresholdSeconds: 2
 });
 
+setLogBrewAppleNativeCrashContext({
+  schemaVersion: 1,
+  trace: { traceId: trace.traceId, spanId: trace.spanId, sampled: trace.sampled },
+  session: { id: "session_123" },
+  subject: { id: "subject_456", kind: "user" }
+});
+
 void replayLogBrewAppleNativeDiagnostics().catch((error) => {
   console.warn(error?.code ?? "native_diagnostics_failed");
 });
@@ -329,6 +342,11 @@ allowed, but only one integration may install native fatal capture in a given
 process. LogBrew cannot transfer or remove that ownership before process
 restart.
 
+Update this snapshot when the active trace, session, or subject changes, and
+clear it with `setLogBrewAppleNativeCrashContext(null)` on logout or session
+end. The crash report keeps one atomic snapshot from the crashed process, so a
+later app launch cannot replace it. Session and subject values must be opaque app-owned identifiers made from ASCII letters, numbers, `_`, or `-`. Do not use names, email addresses, IP addresses, or device identifiers. Resource context, tags, arbitrary fields, and values over the fixed 1 KiB snapshot limit fail before storage.
+
 Installation creates app-private, data-protected storage that iOS excludes from
 device data archives. Pending reports are partitioned by project, so changing
 the configured project does not replay an earlier project's records with the

package/apple-native-diagnostics.d.ts

@@ -1,3 +1,5 @@
+import type { TelemetrySessionContext, TelemetrySubjectContext, TelemetryTraceContext } from "@logbrew/sdk";
+
 type LogBrewAppleNativeDiagnosticsAuth =
   | { apiKey: string; clientKey?: never }
   | { clientKey: string; apiKey?: never };
@@ -32,6 +34,19 @@ export type LogBrewAppleNativeDiagnosticsReplayResult = Readonly<{
   pending: number;
 }>;
 
+export type LogBrewAppleNativeCrashContext = {
+  schemaVersion: 1;
+  trace?: TelemetryTraceContext;
+  session?: TelemetrySessionContext;
+  subject?: TelemetrySubjectContext;
+  resource?: never;
+  tags?: never;
+};
+
+export type LogBrewAppleNativeCrashContextResult = Readonly<{
+  status: "cleared" | "updated";
+}>;
+
 export declare function installLogBrewAppleNativeDiagnostics(
   configuration: LogBrewAppleNativeDiagnosticsConfiguration
 ): LogBrewAppleNativeDiagnosticsStatus;
@@ -43,10 +58,15 @@ export declare function replayLogBrewAppleNativeDiagnostics(): Promise<
 export declare function getLogBrewAppleNativeDiagnosticsStatus():
   LogBrewAppleNativeDiagnosticsStatus;
 
+export declare function setLogBrewAppleNativeCrashContext(
+  context: LogBrewAppleNativeCrashContext | null
+): LogBrewAppleNativeCrashContextResult;
+
 declare const defaultExport: {
   getLogBrewAppleNativeDiagnosticsStatus: typeof getLogBrewAppleNativeDiagnosticsStatus;
   installLogBrewAppleNativeDiagnostics: typeof installLogBrewAppleNativeDiagnostics;
   replayLogBrewAppleNativeDiagnostics: typeof replayLogBrewAppleNativeDiagnostics;
+  setLogBrewAppleNativeCrashContext: typeof setLogBrewAppleNativeCrashContext;
 };
 
 export default defaultExport;

package/apple-native-diagnostics.js

@@ -44,6 +44,26 @@ export function getLogBrewAppleNativeDiagnosticsStatus() {
   return requireStatusResult("status", result, new Set(["not_installed", "ready"]));
 }
 
+export function setLogBrewAppleNativeCrashContext(context) {
+  requireApplePlatform();
+  const nativeModule = requireNativeModule();
+  const payload = context === null ? null : normalizeCorrelationContext(context);
+  const result = callNative(nativeModule, "setNativeDiagnosticsContext", payload);
+  const expectedStatus = payload === null ? "cleared" : "updated";
+  if (isErrorResult(result)) {
+    throw new SdkError(result.code, `LogBrew Apple native diagnostics context failed with ${result.code}`);
+  }
+  if (!isPlainObject(result)
+    || Object.keys(result).length !== 1
+    || result.status !== expectedStatus) {
+    throw new SdkError(
+      "native_diagnostics_invalid_response",
+      "LogBrew Apple native diagnostics context returned an invalid response"
+    );
+  }
+  return Object.freeze({ status: expectedStatus });
+}
+
 function normalizeConfiguration(configuration) {
   if (!configuration
     || Array.isArray(configuration)
@@ -109,6 +129,81 @@ function normalizeConfiguration(configuration) {
   return payload;
 }
 
+function normalizeCorrelationContext(context) {
+  const source = exactObject(context, ["schemaVersion", "session", "subject", "trace"], "context");
+  if (source.schemaVersion !== 1) {
+    throw configurationError("context schemaVersion must be 1");
+  }
+  const output = { schemaVersion: 1 };
+  if (source.trace !== undefined) {
+    const trace = exactObject(
+      source.trace,
+      ["parentSpanId", "sampled", "spanId", "traceId"],
+      "context trace"
+    );
+    output.trace = { traceId: correlationHexId(trace.traceId, 32, "traceId") };
+    for (const [key, width] of [["spanId", 16], ["parentSpanId", 16]]) {
+      if (trace[key] !== undefined) {
+        output.trace[key] = correlationHexId(trace[key], width, key);
+      }
+    }
+    if (trace.sampled !== undefined) {
+      if (typeof trace.sampled !== "boolean") {
+        throw configurationError("context trace sampled must be a boolean");
+      }
+      output.trace.sampled = trace.sampled;
+    }
+  }
+  if (source.session !== undefined) {
+    const session = exactObject(source.session, ["id", "previousId"], "context session");
+    output.session = { id: opaqueCorrelationId(session.id, "session id") };
+    if (session.previousId !== undefined) {
+      output.session.previousId = opaqueCorrelationId(session.previousId, "session previousId");
+      if (output.session.previousId === output.session.id) {
+        throw configurationError("context session previousId must differ from id");
+      }
+    }
+  }
+  if (source.subject !== undefined) {
+    const subject = exactObject(source.subject, ["id", "kind"], "context subject");
+    if (subject.kind !== "anonymous" && subject.kind !== "user") {
+      throw configurationError("context subject kind must be anonymous or user");
+    }
+    output.subject = { id: opaqueCorrelationId(subject.id, "subject id"), kind: subject.kind };
+  }
+  if (Object.keys(output).length === 1) {
+    throw configurationError("context must include trace, session, or subject");
+  }
+  return output;
+}
+
+function exactObject(value, allowedKeys, name) {
+  if (!isPlainObject(value)) {
+    throw configurationError(`${name} must be an object`);
+  }
+  const unknown = Object.keys(value).filter((key) => !allowedKeys.includes(key)).sort();
+  if (unknown.length > 0) {
+    throw configurationError(`${name} contains unsupported fields`);
+  }
+  return value;
+}
+
+function correlationHexId(value, width, name) {
+  if (typeof value !== "string"
+    || !new RegExp(`^[0-9a-f]{${width}}$`, "iu").test(value)
+    || /^0+$/u.test(value)) {
+    throw configurationError(`context trace ${name} must be a non-zero ${width}-character hex value`);
+  }
+  return value.toLowerCase();
+}
+
+function opaqueCorrelationId(value, name) {
+  if (typeof value !== "string" || !/^[A-Za-z0-9][A-Za-z0-9_-]{0,199}$/u.test(value)) {
+    throw configurationError(`context ${name} must be an opaque app-owned identifier`);
+  }
+  return value;
+}
+
 function requireApplePlatform() {
   if (Platform?.OS !== "ios") {
     throw new SdkError(
@@ -280,7 +375,8 @@ function configurationError(message) {
 const logBrewAppleNativeDiagnostics = {
   getLogBrewAppleNativeDiagnosticsStatus,
   installLogBrewAppleNativeDiagnostics,
-  replayLogBrewAppleNativeDiagnostics
+  replayLogBrewAppleNativeDiagnostics,
+  setLogBrewAppleNativeCrashContext
 };
 
 export default logBrewAppleNativeDiagnostics;

package/expo.cjs

@@ -1,20 +1,21 @@
 const PLUGIN_NAME = "@logbrew/react-native/expo";
 const START_MARKER = "  # @generated by @logbrew/react-native/expo";
 const END_MARKER = "  # @end @logbrew/react-native/expo";
+const MANAGED_BLOCK = /  # @generated by @logbrew\/react-native\/expo[\s\S]*?  # @end @logbrew\/react-native\/expo\n?/gu;
 const POD_BLOCK = [
   START_MARKER,
-  "  logbrew_react_native_path = File.dirname(`node --print \"require.resolve('@logbrew/react-native')\"`)",
+  "  require 'pathname'",
+  "  logbrew_react_native_path = Pathname(File.dirname(`bun --print \"require.resolve('@logbrew/react-native')\"`)).relative_path_from(Pathname(__dir__)).to_s",
   "  pod 'LogBrewReactNative/AppleNativeDiagnostics', :path => logbrew_react_native_path",
   END_MARKER
 ].join("\n");
 
 function withLogBrewReactNative(config, options = {}) {
   const { withPodfile } = require("expo/config-plugins");
-  return withPodfile(config, (podfileConfig) => {
-    podfileConfig.modResults.contents = modifyPodfile(
-      podfileConfig.modResults.contents,
-      options?.appleNativeDiagnostics !== false
-    );
+  const enabled = options?.appleNativeDiagnostics !== false;
+  return withPodfile(config, podfileConfig => {
+    const podfile = podfileConfig.modResults;
+    podfile.contents = modifyPodfile(podfile.contents, enabled);
     return podfileConfig;
   });
 }
@@ -23,10 +24,7 @@ function modifyPodfile(contents, enabled = true) {
   if (typeof contents !== "string") {
     throw new TypeError(`${PLUGIN_NAME} expected Podfile text`);
   }
-  const withoutManagedBlock = contents.replace(
-    new RegExp(`${escapePattern(START_MARKER)}[\\s\\S]*?${escapePattern(END_MARKER)}\\n?`, "gu"),
-    ""
-  );
+  const withoutManagedBlock = contents.replace(MANAGED_BLOCK, "");
   if (!enabled) {
     return withoutManagedBlock;
   }
@@ -37,10 +35,6 @@ function modifyPodfile(contents, enabled = true) {
   return withoutManagedBlock.replace(targetPattern, `$1\n${POD_BLOCK}`);
 }
 
-function escapePattern(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
-}
-
 module.exports = withLogBrewReactNative;
 module.exports.modifyPodfile = modifyPodfile;
 module.exports.withLogBrewReactNative = withLogBrewReactNative;

package/index.cjs

@@ -16,7 +16,7 @@ const {
 } = require("./metadata.cjs");
 
 const DEFAULT_SDK_NAME = "logbrew-react-native";
-const DEFAULT_SDK_VERSION = "0.1.18";
+const DEFAULT_SDK_VERSION = "0.1.20";
 const DEFAULT_ENDPOINT = "https://api.logbrew.co/v1/events";
 const MAX_ACTION_NAME_LENGTH = 64;
 const MAX_PRODUCT_ANALYTICS_SURFACE_LENGTH = 256;