@logbrew/react-native 0.1.16 → 0.1.18

package/LogBrewReactNative.podspec

@@ -33,7 +33,7 @@ Pod::Spec.new do |spec|
       "ios/GeneratedAppleDiagnostics/**/*.swift"
     ]
     diagnostics.dependency "#{spec.name}/Core"
-    diagnostics.dependency "KSCrash/Recording", "2.5.1"
+    diagnostics.dependency "KSCrash/Recording", "2.6.0"
     diagnostics.pod_target_xcconfig = {
       "DEFINES_MODULE" => "YES",
       "SWIFT_VERSION" => "5.0"

package/README.md

@@ -335,7 +335,8 @@ the configured project does not replay an earlier project's records with the
 new project's key. The raw local KSCrash report can still contain sensitive
 process details, so apply the app's consent and retention policy to it. Hosted
 replay uploads only the bounded crash or hang issue described by the Swift
-`LogBrewCrash` contract. Status and error results expose fixed codes and bounded
+`LogBrewCrash` contract, including its capture-time service, deployment, OS,
+device-class, and application-version context. Status and error results expose fixed codes and bounded
 counters, not keys, paths, raw reports, or native error text. A custom endpoint
 must be a plain HTTPS path without embedded authentication, a query, or a fragment.
 

package/index.cjs

@@ -16,7 +16,7 @@ const {
 } = require("./metadata.cjs");
 
 const DEFAULT_SDK_NAME = "logbrew-react-native";
-const DEFAULT_SDK_VERSION = "0.1.16";
+const DEFAULT_SDK_VERSION = "0.1.18";
 const DEFAULT_ENDPOINT = "https://api.logbrew.co/v1/events";
 const MAX_ACTION_NAME_LENGTH = 64;
 const MAX_PRODUCT_ANALYTICS_SURFACE_LENGTH = 256;
@@ -595,6 +595,7 @@ function createReactNavigationSpanListener(client, navigationContainer, {
 
 function createReactNativeErrorEvent(error, {
   debugIdMap,
+  evidence,
   environment,
   fingerprint,
   handled = true,
@@ -618,6 +619,7 @@ function createReactNativeErrorEvent(error, {
   const traceContext = resolveTraceContext(trace ?? getActiveLogBrewTrace());
   const attributes = createIssueAttributesFromError(error?.reason ?? error?.error ?? error, {
     debugIdMap: debugIdMap === undefined ? runtimeReactNativeDebugIdMap() : debugIdMap,
+    evidence,
     environment,
     fingerprint,
     handled,

package/index.d.cts

@@ -20,9 +20,7 @@ export type ReactNativePlatformLike = {
   OS?: string;
   Version?: string | number;
   isPad?: boolean;
-  constants?: {
-    isTesting?: boolean;
-  };
+  constants?: { isTesting?: boolean; [key: string]: unknown };
 };
 
 export type ReactNativeAppStateLike = {
@@ -287,6 +285,7 @@ export type ReactNativeErrorIdFactoryContext = {
 
 export type CaptureReactNativeErrorOptions = ReactNativeContextOptions & {
   debugIdMap?: Record<string, string>;
+  evidence?: IssueAttributes["evidence"];
   environment?: string;
   fingerprint?: string;
   handled?: boolean;

package/index.d.ts

@@ -20,9 +20,7 @@ export type ReactNativePlatformLike = {
   OS?: string;
   Version?: string | number;
   isPad?: boolean;
-  constants?: {
-    isTesting?: boolean;
-  };
+  constants?: { isTesting?: boolean; [key: string]: unknown };
 };
 
 export type ReactNativeAppStateLike = {
@@ -287,6 +285,7 @@ export type ReactNativeErrorIdFactoryContext = {
 
 export type CaptureReactNativeErrorOptions = ReactNativeContextOptions & {
   debugIdMap?: Record<string, string>;
+  evidence?: IssueAttributes["evidence"];
   environment?: string;
   fingerprint?: string;
   handled?: boolean;

package/index.js

@@ -16,7 +16,7 @@ import {
 } from "./metadata.js";
 
 const DEFAULT_SDK_NAME = "logbrew-react-native";
-const DEFAULT_SDK_VERSION = "0.1.16";
+const DEFAULT_SDK_VERSION = "0.1.18";
 const DEFAULT_ENDPOINT = "https://api.logbrew.co/v1/events";
 const MAX_ACTION_NAME_LENGTH = 64;
 const MAX_PRODUCT_ANALYTICS_SURFACE_LENGTH = 256;
@@ -584,6 +584,7 @@ export function createReactNavigationSpanListener(client, navigationContainer, {
 
 export function createReactNativeErrorEvent(error, {
   debugIdMap,
+  evidence,
   environment,
   fingerprint,
   handled = true,
@@ -607,6 +608,7 @@ export function createReactNativeErrorEvent(error, {
   const traceContext = resolveTraceContext(trace ?? getActiveLogBrewTrace());
   const attributes = createIssueAttributesFromError(error?.reason ?? error?.error ?? error, {
     debugIdMap: debugIdMap === undefined ? runtimeReactNativeDebugIdMap() : debugIdMap,
+    evidence,
     environment,
     fingerprint,
     handled,

package/ios/AppleDiagnostics/LBRNAppleNativeDiagnostics.swift

@@ -3,7 +3,7 @@ import Foundation
 @objc(LBRNAppleNativeDiagnostics)
 public final class LBRNAppleNativeDiagnostics: NSObject, @unchecked Sendable {
     private static let shared = LBRNAppleNativeDiagnostics()
-    private static let sdkVersion = "0.1.16"
+    private static let sdkVersion = "0.1.18"
 
     private let lock = NSLock()
     private let replayQueue = DispatchQueue(label: "co.logbrew.react-native.apple-diagnostics-replay")

package/ios/GeneratedAppleDiagnostics/LogBrew/DurableDeliveryStore.swift

@@ -76,7 +76,7 @@ final class DurableDeliveryStore: @unchecked Sendable {
             recoveredEvents = recovery.events
             recoveredPrefix = recovery.prefix
             if let last = recovery.events.last {
-                let lastSequence = try Self.sequence(from: last)
+                let lastSequence = try Self.sequence(from: last.recordName)
                 guard lastSequence < UInt64.max else {
                     throw DurableStoreFailure.corrupt
                 }
@@ -109,7 +109,7 @@ final class DurableDeliveryStore: @unchecked Sendable {
             throw DurableStoreFailure.corrupt
         }
         let name = Self.eventName(sequence: nextSequence)
-        let eventData = try Self.encodeEvent(event)
+        let eventData = try Self.encode(event)
         guard eventData.count == encodedBytes else {
             throw DurableStoreFailure.corrupt
         }

package/ios/GeneratedAppleDiagnostics/LogBrew/DurableDeliveryStoreRecovery.swift

@@ -1,6 +1,14 @@
 // Generated by scripts/sync-apple-native-sources.mjs.
 // Edit the canonical Swift source, then regenerate this package boundary.
-import Darwin
+#if canImport(Musl)
+    import Musl
+#elseif canImport(Glibc)
+    import Glibc
+#elseif canImport(Darwin)
+    import Darwin
+#else
+    #error("LogBrew durable delivery requires a POSIX platform")
+#endif
 import Foundation
 
 extension DurableDeliveryStore {
@@ -167,13 +175,8 @@ extension DurableDeliveryStore {
         String(format: "event-%020llu.json", sequence)
     }
 
-    static func sequence(from recovered: RecoveredEvent) throws -> UInt64 {
-        try sequence(from: recovered.recordName)
-    }
-
     static func sequence(from name: String) throws -> UInt64 {
-        let prefix = "event-"
-        let suffix = ".json"
+        let (prefix, suffix) = ("event-", ".json")
         guard name.hasPrefix(prefix), name.hasSuffix(suffix) else {
             throw DurableStoreFailure.corrupt
         }
@@ -204,10 +207,6 @@ extension DurableDeliveryStore {
         }
     }
 
-    static func encodeEvent(_ event: Event) throws -> Data {
-        try encode(event)
-    }
-
     static func checksum(_ data: Data) -> String {
         var hash: UInt64 = 14_695_981_039_346_656_037
         for byte in data {
@@ -259,7 +258,7 @@ extension DurableDeliveryStore {
             throw DurableStoreFailure.corrupt
         }
         let record = try decodeEventRecord(from: file)
-        let encodedEvent = try encodeEvent(record.event)
+        let encodedEvent = try encode(record.event)
         guard record.version == version,
               record.sequence == sequence,
               record.sdk == sdk,

package/ios/GeneratedAppleDiagnostics/LogBrew/IssueDiagnosticEvidence.swift

@@ -0,0 +1,184 @@
+// Generated by scripts/sync-apple-native-sources.mjs.
+// Edit the canonical Swift source, then regenerate this package boundary.
+import Foundation
+
+/// App-reported code location that narrows the smallest likely fix area.
+public struct IssueLikelyFixArea: Codable, Equatable, Sendable {
+    public let component: String?
+    public let module: String?
+    public let function: String?
+    public let file: String?
+    public let line: Int?
+    public let column: Int?
+    public let inApp: Bool?
+
+    public init(
+        component: String? = nil,
+        module: String? = nil,
+        function: String? = nil,
+        file: String? = nil,
+        line: Int? = nil,
+        column: Int? = nil,
+        inApp: Bool? = nil,
+    ) {
+        self.component = component
+        self.module = module
+        self.function = function
+        self.file = file
+        self.line = line
+        self.column = column
+        self.inApp = inApp
+    }
+}
+
+/// App-reported impact without user identities or raw request data.
+public struct IssueImpactEvidence: Codable, Equatable, Sendable {
+    public let affectedUserSegment: String?
+    public let failedAction: String?
+    public let userVisibleOutcome: String?
+
+    public init(
+        affectedUserSegment: String? = nil,
+        failedAction: String? = nil,
+        userVisibleOutcome: String? = nil,
+    ) {
+        self.affectedUserSegment = affectedUserSegment
+        self.failedAction = failedAction
+        self.userVisibleOutcome = userVisibleOutcome
+    }
+}
+
+/// Explicit app-reported cause, fix, impact, and capture-state evidence.
+public struct IssueDiagnosticEvidence: Codable, Equatable, Sendable {
+    public let likelyRootCause: String?
+    public let likelyFixArea: IssueLikelyFixArea?
+    public let impact: IssueImpactEvidence?
+    public let capturedFields: [String]?
+    public let missingFields: [String]?
+    public let redactedFields: [String]?
+    public let truncatedFields: [String]?
+
+    public init(
+        likelyRootCause: String? = nil,
+        likelyFixArea: IssueLikelyFixArea? = nil,
+        impact: IssueImpactEvidence? = nil,
+        capturedFields: [String]? = nil,
+        missingFields: [String]? = nil,
+        redactedFields: [String]? = nil,
+        truncatedFields: [String]? = nil,
+    ) {
+        self.likelyRootCause = likelyRootCause
+        self.likelyFixArea = likelyFixArea
+        self.impact = impact
+        self.capturedFields = capturedFields
+        self.missingFields = missingFields
+        self.redactedFields = redactedFields
+        self.truncatedFields = truncatedFields
+    }
+}
+
+func validateIssueDiagnosticEvidence(_ value: IssueDiagnosticEvidence) throws -> IssueDiagnosticEvidence {
+    let cause = try value.likelyRootCause.map {
+        try issueText($0, label: "issue evidence likelyRootCause", maximum: 1024)
+    }
+    let fixArea = try value.likelyFixArea.map(validateIssueLikelyFixArea)
+    let impact = try value.impact.map(validateIssueImpactEvidence)
+    var seen = Set<String>()
+    let fieldLists = try [
+        ("capturedFields", value.capturedFields),
+        ("missingFields", value.missingFields),
+        ("redactedFields", value.redactedFields),
+        ("truncatedFields", value.truncatedFields),
+    ].map { name, fields in
+        try fields.map { try validateIssueEvidenceFields($0, name: name, seen: &seen) }
+    }
+    guard cause != nil || fixArea != nil || impact != nil || fieldLists.contains(where: { $0 != nil }) else {
+        throw issueValidationError("issue evidence must contain at least one field")
+    }
+    return IssueDiagnosticEvidence(
+        likelyRootCause: cause,
+        likelyFixArea: fixArea,
+        impact: impact,
+        capturedFields: fieldLists[0],
+        missingFields: fieldLists[1],
+        redactedFields: fieldLists[2],
+        truncatedFields: fieldLists[3],
+    )
+}
+
+private func validateIssueLikelyFixArea(_ value: IssueLikelyFixArea) throws -> IssueLikelyFixArea {
+    let identities = try [value.component, value.module, value.function].map { identity in
+        try identity.map {
+            try issueText($0, label: "issue evidence likelyFixArea identity", maximum: 256,
+                          disallowLocationDelimiters: true)
+        }
+    }
+    let file = try value.file.map(validateIssueRelativePath)
+    let coordinates = try [value.line, value.column].map { coordinate in
+        try coordinate.map {
+            guard (1 ... Int(Int32.max)).contains($0) else {
+                throw issueValidationError("issue evidence likelyFixArea coordinate must be a positive integer")
+            }
+            return $0
+        }
+    }
+    guard identities.contains(where: { $0 != nil }) || file != nil || coordinates.contains(where: { $0 != nil }) else {
+        throw issueValidationError("issue evidence likelyFixArea must identify a code location")
+    }
+    return IssueLikelyFixArea(
+        component: identities[0], module: identities[1], function: identities[2], file: file,
+        line: coordinates[0], column: coordinates[1], inApp: value.inApp,
+    )
+}
+
+private func validateIssueImpactEvidence(_ value: IssueImpactEvidence) throws -> IssueImpactEvidence {
+    let values = try [
+        (value.affectedUserSegment, 256, true),
+        (value.failedAction, 256, true),
+        (value.userVisibleOutcome, 512, false),
+    ].map { text, maximum, rejectLocation in
+        try text.map {
+            try issueText($0, label: "issue evidence impact", maximum: maximum,
+                          disallowLocationDelimiters: rejectLocation)
+        }
+    }
+    guard values.contains(where: { $0 != nil }) else {
+        throw issueValidationError("issue evidence impact must contain at least one field")
+    }
+    return IssueImpactEvidence(
+        affectedUserSegment: values[0], failedAction: values[1], userVisibleOutcome: values[2],
+    )
+}
+
+private func validateIssueEvidenceFields(
+    _ fields: [String],
+    name: String,
+    seen: inout Set<String>,
+) throws -> [String] {
+    guard (1 ... 32).contains(fields.count), Set(fields).count == fields.count,
+          fields.allSatisfy({ validMachineKey($0, maximum: 64, separators: ["_", ".", "-"], allowNumericStart: true) })
+    else {
+        throw issueValidationError("issue evidence \(name) must contain 1-32 unique bounded fields")
+    }
+    for field in fields where !seen.insert(field).inserted {
+        throw issueValidationError("issue evidence field \(field) has conflicting states")
+    }
+    return fields
+}
+
+private func validateIssueRelativePath(_ value: String) throws -> String {
+    let path = try issueText(
+        value.replacingOccurrences(of: "\\", with: "/"),
+        label: "issue evidence likelyFixArea file",
+        maximum: 256,
+        disallowLocationDelimiters: true,
+    )
+    let parts = path.split(separator: "/", omittingEmptySubsequences: false)
+    let drivePath = path.count >= 3 && path[path.index(after: path.startIndex)] == ":"
+    guard !path.hasPrefix("/"), !drivePath, !path.contains("://"),
+          parts.allSatisfy({ !$0.isEmpty && $0 != "." && $0 != ".." })
+    else {
+        throw issueValidationError("issue evidence likelyFixArea file must be a safe relative path")
+    }
+    return path
+}

package/ios/GeneratedAppleDiagnostics/LogBrew/IssueDiagnostics.swift

@@ -101,6 +101,7 @@ public extension IssueAttributes {
         handled: Bool = true,
         breadcrumbs: [IssueBreadcrumb]? = nil,
         breadcrumbsTruncated: Bool? = nil,
+        evidence: IssueDiagnosticEvidence? = nil,
         metadata: Metadata? = nil,
         context: TelemetryContext? = nil,
         fileID: String = #fileID,
@@ -136,6 +137,7 @@ public extension IssueAttributes {
             stackFrames: [rootFrame],
             breadcrumbs: breadcrumbs,
             breadcrumbsTruncated: breadcrumbsTruncated,
+            evidence: evidence,
             metadata: metadata,
             context: context,
         )
@@ -186,6 +188,7 @@ func normalizeIssueAttributes(_ value: IssueAttributes) throws -> IssueAttribute
     }
     let breadcrumbs = try normalizeIssueBreadcrumbs(value.breadcrumbs)
     let breadcrumbsWereCapped = (value.breadcrumbs?.count ?? 0) > maximumIssueBreadcrumbs
+    let evidence = try value.evidence.map(validateIssueDiagnosticEvidence)
     let context = try value.context.map { try validateTelemetryContext($0) }
     try validateMetadata(value.metadata, label: "issue metadata")
     return IssueAttributes(
@@ -197,6 +200,7 @@ func normalizeIssueAttributes(_ value: IssueAttributes) throws -> IssueAttribute
         stackFrames: stackFrames,
         breadcrumbs: breadcrumbs,
         breadcrumbsTruncated: breadcrumbsWereCapped ? true : value.breadcrumbsTruncated,
+        evidence: evidence,
         metadata: value.metadata,
         context: context,
         nativeStackFrames: value.nativeStackFrames,
@@ -224,6 +228,7 @@ func issueAttributes(
         breadcrumbsTruncated: value.breadcrumbsTruncated == true
             || snapshot.truncated
             || combined.count > maximumIssueBreadcrumbs,
+        evidence: value.evidence,
         metadata: value.metadata,
         context: value.context,
         nativeStackFrames: value.nativeStackFrames,
@@ -377,7 +382,7 @@ func issueText(
     disallowLocationDelimiters: Bool = false,
 ) throws -> String {
     let normalized = value.trimmingCharacters(in: .whitespacesAndNewlines)
-    guard !normalized.isEmpty, normalized.count <= maximum, !containsForbiddenControl(normalized),
+    guard !normalized.isEmpty, normalized.unicodeScalars.count <= maximum, !containsForbiddenControl(normalized),
           !disallowLocationDelimiters || (!normalized.contains("?") && !normalized.contains("#"))
     else {
         throw issueValidationError("\(label) is invalid")

package/ios/GeneratedAppleDiagnostics/LogBrew/LogBrewClient.swift

@@ -64,7 +64,6 @@ public final class LogBrewClient: @unchecked Sendable {
         let context = try resolvedContext(event: attributes.context)
         let attributes = issueAttributes(attributes, adding: breadcrumbStore.snapshot())
             .withContext(context)
-            .withCorrelationMetadata()
         try pushEvent(.issue(validateIssue(attributes)), id: id, timestamp: timestamp)
     }
 
@@ -76,7 +75,7 @@ public final class LogBrewClient: @unchecked Sendable {
     public func log(_ id: String, timestamp: String, attributes: LogAttributes) throws {
         let context = try resolvedContext(event: attributes.context)
         try pushEvent(
-            .log(validateLog(attributes.withContext(context).withCorrelationMetadata())),
+            .log(validateLog(attributes.withContext(context))),
             id: id,
             timestamp: timestamp,
         )
@@ -103,7 +102,7 @@ public final class LogBrewClient: @unchecked Sendable {
     public func action(_ id: String, timestamp: String, attributes: ActionAttributes) throws {
         let context = try resolvedContext(event: attributes.context)
         try pushEvent(
-            .action(validateAction(attributes.withContext(context).withCorrelationMetadata())),
+            .action(validateAction(attributes.withContext(context))),
             id: id,
             timestamp: timestamp,
         )
@@ -112,7 +111,7 @@ public final class LogBrewClient: @unchecked Sendable {
     public func metric(_ id: String, timestamp: String, attributes: MetricAttributes) throws {
         let context = try resolvedContext(event: attributes.context)
         try pushEvent(
-            .metric(validateMetric(attributes.withContext(context).withCorrelationMetadata())),
+            .metric(validateMetric(attributes.withContext(context))),
             id: id,
             timestamp: timestamp,
         )
@@ -209,22 +208,7 @@ private extension IssueAttributes {
             stackFrames: stackFrames,
             breadcrumbs: breadcrumbs,
             breadcrumbsTruncated: breadcrumbsTruncated,
-            metadata: metadata,
-            context: context,
-            nativeStackFrames: nativeStackFrames,
-        )
-    }
-
-    func withCorrelationMetadata() -> IssueAttributes {
-        IssueAttributes(
-            title: title,
-            level: level,
-            message: message,
-            exception: exception,
-            exceptionChain: exceptionChain,
-            stackFrames: stackFrames,
-            breadcrumbs: breadcrumbs,
-            breadcrumbsTruncated: breadcrumbsTruncated,
+            evidence: evidence,
             metadata: correlationMetadata(metadata, context: context),
             context: context,
             nativeStackFrames: nativeStackFrames,
@@ -234,16 +218,6 @@ private extension IssueAttributes {
 
 private extension LogAttributes {
     func withContext(_ context: TelemetryContext?) -> LogAttributes {
-        LogAttributes(
-            message: message,
-            level: level,
-            logger: logger,
-            metadata: metadata,
-            context: context,
-        )
-    }
-
-    func withCorrelationMetadata() -> LogAttributes {
         LogAttributes(
             message: message,
             level: level,
@@ -256,10 +230,6 @@ private extension LogAttributes {
 
 private extension ActionAttributes {
     func withContext(_ context: TelemetryContext?) -> ActionAttributes {
-        ActionAttributes(name: name, status: status, metadata: metadata, context: context)
-    }
-
-    func withCorrelationMetadata() -> ActionAttributes {
         ActionAttributes(
             name: name,
             status: status,
@@ -271,19 +241,6 @@ private extension ActionAttributes {
 
 private extension MetricAttributes {
     func withContext(_ context: TelemetryContext?) -> MetricAttributes {
-        MetricAttributes(
-            name: name,
-            kind: kind,
-            value: value,
-            unit: unit,
-            temporality: temporality,
-            metadata: metadata,
-            context: context,
-            description: description,
-        )
-    }
-
-    func withCorrelationMetadata() -> MetricAttributes {
         MetricAttributes(
             name: name,
             kind: kind,

package/ios/GeneratedAppleDiagnostics/LogBrew/PublicTypes.swift

@@ -175,6 +175,7 @@ public struct IssueAttributes: Codable, Equatable, Sendable {
     public let stackFrames: [IssueStackFrame]?
     public let breadcrumbs: [IssueBreadcrumb]?
     public let breadcrumbsTruncated: Bool?
+    public let evidence: IssueDiagnosticEvidence?
     public let metadata: Metadata?
     public let context: TelemetryContext?
     @_spi(CrashReplay) public let nativeStackFrames: [NativeStackFrame]?
@@ -188,6 +189,7 @@ public struct IssueAttributes: Codable, Equatable, Sendable {
         stackFrames: [IssueStackFrame]? = nil,
         breadcrumbs: [IssueBreadcrumb]? = nil,
         breadcrumbsTruncated: Bool? = nil,
+        evidence: IssueDiagnosticEvidence? = nil,
         metadata: Metadata? = nil,
         context: TelemetryContext? = nil,
     ) {
@@ -199,6 +201,7 @@ public struct IssueAttributes: Codable, Equatable, Sendable {
         self.stackFrames = stackFrames
         self.breadcrumbs = breadcrumbs
         self.breadcrumbsTruncated = breadcrumbsTruncated
+        self.evidence = evidence
         self.metadata = metadata
         self.context = context
         nativeStackFrames = nil
@@ -214,6 +217,7 @@ public struct IssueAttributes: Codable, Equatable, Sendable {
         stackFrames: [IssueStackFrame]? = nil,
         breadcrumbs: [IssueBreadcrumb]? = nil,
         breadcrumbsTruncated: Bool? = nil,
+        evidence: IssueDiagnosticEvidence? = nil,
         metadata: Metadata? = nil,
         context: TelemetryContext? = nil,
         nativeStackFrames: [NativeStackFrame]?,
@@ -226,6 +230,7 @@ public struct IssueAttributes: Codable, Equatable, Sendable {
         self.stackFrames = stackFrames
         self.breadcrumbs = breadcrumbs
         self.breadcrumbsTruncated = breadcrumbsTruncated
+        self.evidence = evidence
         self.metadata = metadata
         self.context = context
         self.nativeStackFrames = nativeStackFrames

package/ios/GeneratedAppleDiagnostics/LogBrew/TelemetryContextValidation.swift

@@ -81,9 +81,14 @@ func validateTelemetryTraceContext(
     )
 }
 
-func validMachineKey(_ value: String, maximum: Int, separators: Set<Character>) -> Bool {
+func validMachineKey(
+    _ value: String,
+    maximum: Int,
+    separators: Set<Character>,
+    allowNumericStart: Bool = false,
+) -> Bool {
     guard !value.isEmpty, value.count <= maximum, value.first?.isASCII == true,
-          value.first?.isLetter == true
+          value.first?.isLetter == true || allowNumericStart && value.first?.isNumber == true
     else {
         return false
     }

package/ios/GeneratedAppleDiagnostics/LogBrewCrash/CrashReportSanitizer.swift

@@ -28,6 +28,10 @@ struct CrashReportSanitizer {
             mechanism: mechanism(error?["type"] as? String),
             nativeStackFrames: nativeStackFrames,
             artifactIdentity: artifactIdentity,
+            context: nativeCrashContext(
+                system: rawReport["system"] as? [String: Any],
+                artifactIdentity: artifactIdentity,
+            ),
             hangState: nil,
             hangDurationMs: nil,
             source: .engine(reportID: reportID),
@@ -70,6 +74,55 @@ struct CrashReportSanitizer {
     }
 }
 
+func nativeCrashContext(
+    system: [String: Any]?,
+    artifactIdentity: NativeArtifactIdentity?,
+) -> TelemetryContext? {
+    let value = { (key: String) in crashContextValue(system?[key]) }
+    let operatingSystem = value("system_name").map {
+        TelemetryOperatingSystem(name: $0, version: value("system_version"), build: value("os_version"))
+    }
+    let family = value("model")
+    let model = value("machine")
+    let architecture = value("cpu_arch")
+    let device = family == nil && model == nil && architecture == nil
+        ? nil
+        : TelemetryDevice(family: family, model: model, architecture: architecture)
+    let applicationName = value("CFBundleName")
+    let applicationVersion = value("CFBundleShortVersionString")
+    let applicationBuild = value("CFBundleVersion")
+    let application = applicationName == nil && applicationVersion == nil && applicationBuild == nil
+        ? nil
+        : TelemetryApplication(name: applicationName, version: applicationVersion, build: applicationBuild)
+    guard artifactIdentity != nil || operatingSystem != nil || device != nil || application != nil else {
+        return nil
+    }
+    return TelemetryContext(resource: TelemetryResource(
+        service: artifactIdentity.map { TelemetryNamedVersion(name: $0.service) },
+        deployment: artifactIdentity.map {
+            TelemetryDeployment(environment: $0.environment, release: $0.release)
+        },
+        operatingSystem: operatingSystem,
+        device: device,
+        application: application,
+    ))
+}
+
+private func crashContextValue(_ rawValue: Any?) -> String? {
+    guard let value = rawValue as? String else {
+        return nil
+    }
+    let normalized = value.trimmingCharacters(in: .whitespacesAndNewlines)
+    guard (1 ... 256).contains(normalized.utf8.count),
+          !normalized.unicodeScalars.contains(where: CharacterSet.controlCharacters.contains),
+          !normalized.contains("/"),
+          !normalized.contains("\\")
+    else {
+        return nil
+    }
+    return normalized
+}
+
 struct NativeCrashTimestamp: Comparable {
     let normalized: String
     private let wholeSecond: String

package/ios/GeneratedAppleDiagnostics/LogBrewCrash/NativeCrashExceptionEvidence.swift

@@ -1,6 +1,5 @@
 // Generated by scripts/sync-apple-native-sources.mjs.
 // Edit the canonical Swift source, then regenerate this package boundary.
-import Foundation
 
 func nativeCrashExceptionChain(for exception: IssueException) -> IssueExceptionChain {
     IssueExceptionChain(entries: [
@@ -14,31 +13,3 @@ func nativeCrashExceptionChain(for exception: IssueException) -> IssueExceptionC
         ),
     ])
 }
-
-func nativeCrashExceptionChainMatches(
-    _ value: Any?,
-    expected exception: IssueException,
-) -> Bool {
-    guard let value else {
-        // Preserve retry identity for an event queued by an older SDK before chains existed.
-        return true
-    }
-    guard let chain = value as? [String: Any] else {
-        return false
-    }
-    guard let mechanism = exception.mechanism else {
-        return false
-    }
-    let expected = [
-        "entries": [[
-            "id": 0,
-            "relationship": "reported",
-            "type": exception.type,
-            "messageState": "not_captured",
-            "mechanism": ["type": mechanism.type, "handled": mechanism.handled],
-            "stackFramesState": "not_captured",
-        ]],
-        "truncated": false,
-    ] as NSDictionary
-    return chain as NSDictionary == expected
-}

package/ios/GeneratedAppleDiagnostics/LogBrewCrash/NativeCrashPublic.swift

@@ -163,6 +163,7 @@ public final class NativeCrashRecord: NSObject, @unchecked Sendable {
 
     private let nativeStackFrames: [NativeStackFrame]?
     private let artifactIdentity: NativeArtifactIdentity?
+    private let context: TelemetryContext?
     private let hangState: NativeHangIncidentState?
     private let hangDurationMs: Double?
     let source: NativeCrashRecordSource
@@ -175,6 +176,7 @@ public final class NativeCrashRecord: NSObject, @unchecked Sendable {
         mechanism: NativeCrashMechanism,
         nativeStackFrames: [NativeStackFrame]?,
         artifactIdentity: NativeArtifactIdentity?,
+        context: TelemetryContext?,
         hangState: NativeHangIncidentState?,
         hangDurationMs: Double? = nil,
         source: NativeCrashRecordSource,
@@ -186,6 +188,7 @@ public final class NativeCrashRecord: NSObject, @unchecked Sendable {
         self.mechanism = mechanism
         self.nativeStackFrames = nativeStackFrames
         self.artifactIdentity = artifactIdentity
+        self.context = context
         self.hangState = hangState
         self.hangDurationMs = hangDurationMs
         self.source = source
@@ -237,6 +240,7 @@ public final class NativeCrashRecord: NSObject, @unchecked Sendable {
             exception: issueException,
             exceptionChain: nativeCrashExceptionChain(for: issueException),
             metadata: metadata,
+            context: context,
             nativeStackFrames: nativeStackFrames,
         )
     }
@@ -254,57 +258,13 @@ public final class NativeCrashRecord: NSObject, @unchecked Sendable {
         guard event["type"] as? String == "issue",
               event["timestamp"] as? String == timestamp,
               let attributes = event["attributes"] as? [String: Any],
-              attributes["title"] as? String == issueAttributes.title,
-              attributes["level"] as? String == issueAttributes.level.canonicalValue,
-              attributes["message"] == nil,
-              exceptionMatches(attributes["exception"]),
-              nativeCrashExceptionChainMatches(
-                  attributes["exceptionChain"],
-                  expected: issueException,
-              ),
-              attributes["stackFrames"] == nil,
-              attributes["breadcrumbs"] == nil,
-              attributes["breadcrumbsTruncated"] == nil,
-              attributes["context"] == nil,
-              let metadata = attributes["metadata"] as? [String: Any],
-              metadata as NSDictionary == expectedMetadata,
-              nativeStackFramesMatch(attributes["nativeStackFrames"])
+              attributesMatch(attributes)
         else {
             return .collision
         }
         return .matching
     }
 
-    private var expectedMetadata: NSDictionary {
-        var metadata: [String: Any] = [
-            "crash.mechanism": mechanism.name,
-            "crash.replayed": true,
-        ]
-        if let artifactIdentity {
-            metadata["projectId"] = artifactIdentity.projectId
-            metadata["release"] = artifactIdentity.release
-            metadata["environment"] = artifactIdentity.environment
-            metadata["service"] = artifactIdentity.service
-        }
-        if let hangState {
-            metadata["crash.handled"] = hangState == .recovered
-        }
-        if let hangDurationMs {
-            metadata["durationMs"] = hangDurationMs
-        }
-        return metadata as NSDictionary
-    }
-
-    private var expectedException: NSDictionary {
-        [
-            "type": hangState == nil ? "AppleNativeCrash" : "AppleNativeHang",
-            "mechanism": [
-                "type": mechanism.name,
-                "handled": hangState == .recovered,
-            ],
-        ] as NSDictionary
-    }
-
     private var issueException: IssueException {
         IssueException(
             type: hangState == nil ? "AppleNativeCrash" : "AppleNativeHang",
@@ -315,31 +275,16 @@ public final class NativeCrashRecord: NSObject, @unchecked Sendable {
         )
     }
 
-    private func exceptionMatches(_ value: Any?) -> Bool {
-        guard let value else {
-            // Preserve exact retry identity for an event queued by an older SDK before typed exceptions existed.
-            return true
-        }
-        guard let exception = value as? [String: Any] else {
-            return false
-        }
-        return exception as NSDictionary == expectedException
-    }
-
-    private func nativeStackFramesMatch(_ value: Any?) -> Bool {
-        guard let nativeStackFrames else {
-            return value == nil
-        }
-        guard let frames = value as? [[String: Any]], frames.count == nativeStackFrames.count else {
+    private func attributesMatch(_ actual: [String: Any]) -> Bool {
+        guard let encoded = try? JSONEncoder().encode(issueAttributes),
+              var expected = try? JSONSerialization.jsonObject(with: encoded) as? [String: Any]
+        else {
             return false
         }
-        return zip(frames, nativeStackFrames).allSatisfy { frame, expected in
-            frame as NSDictionary == [
-                "imageUuid": expected.imageUuid,
-                "architecture": expected.architecture.rawValue,
-                "instructionOffset": expected.instructionOffset,
-            ] as NSDictionary
+        for legacyField in ["exception", "exceptionChain", "context"] where actual[legacyField] == nil {
+            expected.removeValue(forKey: legacyField)
         }
+        return actual as NSDictionary == expected as NSDictionary
     }
 }
 

package/ios/GeneratedAppleDiagnostics/LogBrewCrash/NativeHangIncidentStore.swift

@@ -93,6 +93,7 @@ struct NativeHangIncident: Codable, Equatable {
             mechanism: .deadlock,
             nativeStackFrames: nativeStackFrames,
             artifactIdentity: artifactIdentity.validatedIdentity(),
+            context: nil,
             hangState: state,
             hangDurationMs: durationMs,
             source: .hang(eventID: eventID),

package/ios/GeneratedAppleDiagnostics/SOURCE-MANIFEST.json

@@ -7,35 +7,36 @@
     "swift/logbrew-swift/Sources/LogBrew/DeliveryEngineDurable.swift": "b0d2ca07cce7fe01fc110238c7d10aa9c8ada0d28509e4c022e7fa950a4c79b9",
     "swift/logbrew-swift/Sources/LogBrew/DeliveryEngineQueue.swift": "9c8503da4023368922b8b73dd989213685a64312806ecd73d0513958ad85f883",
     "swift/logbrew-swift/Sources/LogBrew/DeliveryLifecycle.swift": "7b76541c2659cecf6614d9d6dcf9b61dc85b7a562d44fda03a026076afa02fcd",
-    "swift/logbrew-swift/Sources/LogBrew/DurableDeliveryStore.swift": "2de6a08473722ebd99b2d1762ed3356fefc0181f5cd886367fbfd52c75c6644b",
-    "swift/logbrew-swift/Sources/LogBrew/DurableDeliveryStoreRecovery.swift": "a843f784e7645f916bb0f401e88fa7d49fa8c4351dc2f26c1fbf32be3f4aaa40",
+    "swift/logbrew-swift/Sources/LogBrew/DurableDeliveryStore.swift": "7c292dda68efc3de790daf44733b25e4392226793343c21ba5df4f51fc1b402b",
+    "swift/logbrew-swift/Sources/LogBrew/DurableDeliveryStoreRecovery.swift": "79fee27975b6571954bf0b3692a50e60bbbcf53b5ab47f653a474db5c56d68ba",
     "swift/logbrew-swift/Sources/LogBrew/EventEncoding.swift": "b88b6b2d17f7d0cee9ac1a1f34ef35b192cd33d213ef3c9e1c2d21cbcc304a97",
-    "swift/logbrew-swift/Sources/LogBrew/IssueDiagnostics.swift": "fc805effd3da6084e8cac2bbfe8fdc098e07d45d6f3ce2e7df02ebe0e445591f",
+    "swift/logbrew-swift/Sources/LogBrew/IssueDiagnosticEvidence.swift": "e471f27fadaefe06971c1a98892aeb0774e840a2ce0cbb243ae9aabfa41b1c47",
+    "swift/logbrew-swift/Sources/LogBrew/IssueDiagnostics.swift": "297b8bbefd42c314a984fecb38237fb1395700c9eafcfdd1b545267bc34294cc",
     "swift/logbrew-swift/Sources/LogBrew/IssueExceptionChain.swift": "10f81cbce95b47da0a44ef9e515b150e60d71dfcc8b04be24b037b1222a373a5",
     "swift/logbrew-swift/Sources/LogBrew/LifecycleTrace.swift": "738cd3f129fac821a892404d1d42ee92bd806b6583d3dbb5379e88b14ab23c16",
-    "swift/logbrew-swift/Sources/LogBrew/LogBrewClient.swift": "0f7e23a21fd8f76af031205847cd0b8b2648a069abac8d0ddc8c16da017893b7",
+    "swift/logbrew-swift/Sources/LogBrew/LogBrewClient.swift": "186cdbda3754a811f17b82818ca8e7a1711b3b75123686cd17dc3b7441fa21cb",
     "swift/logbrew-swift/Sources/LogBrew/LogBrewLogger.swift": "d3266353a5f5139a2a1ca1a86bacce793518eb1489bf67ed9e3720b57b1c29b2",
     "swift/logbrew-swift/Sources/LogBrew/LogBrewTrace.swift": "f67edf4ca464e6a6eb1c7a22cd4997928cd27b6c2d07535855a18a053d8de924",
     "swift/logbrew-swift/Sources/LogBrew/Metadata.swift": "65840ebb3f3b79fbfc1f5faa3026c2583319e89ff26061676dc552c03ee15dbe",
     "swift/logbrew-swift/Sources/LogBrew/NativeStackFrame.swift": "ecbd418969ec4a31503d9916a8bf27f22e6863356c6fabe457c1e61027a8d805",
     "swift/logbrew-swift/Sources/LogBrew/ProductTimeline.swift": "209906aa0e8f096a347e35832840522710eadfb530053253cd73c748518e362d",
-    "swift/logbrew-swift/Sources/LogBrew/PublicTypes.swift": "1151d5402a9f5441f5d5d998fde57c8df88cb3180d2daa3e0fc49e883ab274f2",
+    "swift/logbrew-swift/Sources/LogBrew/PublicTypes.swift": "a21aee058f716ec9d41d54ad032b2c7a4d64a4b99d749a9fa2be3fd2df5c6568",
     "swift/logbrew-swift/Sources/LogBrew/TelemetryContext.swift": "ce3ac93a62a345f8c9a8f4c69ce84efc991bf02a688f49bad5e68edcff2f6e08",
-    "swift/logbrew-swift/Sources/LogBrew/TelemetryContextValidation.swift": "f631beef20a8a86f975787b4092a9798fedbe2c9e3f0d2740f81831b4adef287",
+    "swift/logbrew-swift/Sources/LogBrew/TelemetryContextValidation.swift": "23524d281a185962a2ecc75f1ca1cb775171e2f72ecd39ca325ace7e45082485",
     "swift/logbrew-swift/Sources/LogBrew/TraceEvidence.swift": "40aaa42976164c53d9f4d9e9e30d236534238da43bbe90832a673c8809ad54b6",
     "swift/logbrew-swift/Sources/LogBrew/Transport.swift": "73eec81aaebec4bc922b2a372429c88fcd3e85606a7862cd08e1795eb2a8e6cd",
     "swift/logbrew-swift/Sources/LogBrew/URLSessionTrace.swift": "d0076c72671716c41bd7498d0509e453b8182c418156e169196fee9f26fc66b1",
     "swift/logbrew-swift/Sources/LogBrew/URLSessionTracer.swift": "0cdf08f92d6111c0dc2883b87837b81f69b5c2f9a8e5501780a114c23a741af7",
     "swift/logbrew-swift/Sources/LogBrew/Validation.swift": "07ff5c2daeb829b1df4f50edb0b79727f9a81b1c9b5cde5f995f5ad6ce660aa7",
     "swift/logbrew-swift/Sources/LogBrewCrash/CrashEngine.swift": "7a46035fcaa72dd7504b4e274a92070d73dd1c45fe20e008474340d6d7c44ede",
-    "swift/logbrew-swift/Sources/LogBrewCrash/CrashReportSanitizer.swift": "a872ad63532999e74af1e9685a9382d0e02b93c6f9b942b371d47f56f8b961c0",
+    "swift/logbrew-swift/Sources/LogBrewCrash/CrashReportSanitizer.swift": "8798c8900ea28a85d6909183dc8435bc08da96573b89310d26ed178217fbc04b",
     "swift/logbrew-swift/Sources/LogBrewCrash/CrashStorageDirectory.swift": "7cd566703cbf704dc99155451ee93dcace12c35c805abc09a6dcf23975cf43f9",
     "swift/logbrew-swift/Sources/LogBrewCrash/NativeArtifactIdentity.swift": "3d785ad717dcf7302451531c18b5e1183983270a6cd78dd543a407e3facc6ae0",
     "swift/logbrew-swift/Sources/LogBrewCrash/NativeCrashCapture.swift": "e9ab5f1850a096f40592a025d16c5ffa2fdff0222004a37056898cf1cb4b0dd9",
-    "swift/logbrew-swift/Sources/LogBrewCrash/NativeCrashExceptionEvidence.swift": "08819652ce0796bee9f502de1202d236887afbcb7794d4db9adc5b6c2928ca2c",
-    "swift/logbrew-swift/Sources/LogBrewCrash/NativeCrashPublic.swift": "fe0db58c4ad348a2601d984cdf097147f0b2093baad64861aef48cc052697d9c",
+    "swift/logbrew-swift/Sources/LogBrewCrash/NativeCrashExceptionEvidence.swift": "ce191e46298d91d87b379528d610caa88b924b15a8dd912b4a164b51eb172a7a",
+    "swift/logbrew-swift/Sources/LogBrewCrash/NativeCrashPublic.swift": "7c1d028bea143c6ab34ebddaaaab64aeb69d4d950ec7a42264c567e672991748",
     "swift/logbrew-swift/Sources/LogBrewCrash/NativeCrashReplay.swift": "3eb3d93b32cf14de416f56fa30d6d65e6f268b5ec9d1a67081d7525c4efd4f80",
-    "swift/logbrew-swift/Sources/LogBrewCrash/NativeHangIncidentStore.swift": "02413ca7e003917faadcc9aa612b5d98897c75b39f67c3c845948dd9349a9d8f",
+    "swift/logbrew-swift/Sources/LogBrewCrash/NativeHangIncidentStore.swift": "5a8150083f16d6b495c9c63434809dc5f11f13ebb23211f57151bad62040781b",
     "swift/logbrew-swift/Sources/LogBrewCrash/NativeHangWatchdog.swift": "37b25904cd6576e20c40500be2c153156403b57ad7b4186a1b6b35b414145ecb",
     "swift/logbrew-swift/Sources/LogBrewCrash/NativeHangWatchdogContracts.swift": "59f51554d86c326122bb2bdce47c5a7e01996bd61f2b371eba23855032487b9f",
     "swift/logbrew-swift/Sources/LogBrewCrash/NativeHangWatchdogSystem.swift": "b87e3db246691d5b0719898cdc02ba068836647b1ac9339a73cf866eabe235ae",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logbrew/react-native",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "React Native offline delivery, Apple native diagnostics, screen, error, trace, action, and network timeline helpers for LogBrew.",
   "type": "module",
   "main": "./index.cjs",