@logbrew/react-native 0.1.11 → 0.1.13

package/ios/GeneratedAppleDiagnostics/LogBrewCrash/NativeStackFrameSanitizer.swift

@@ -0,0 +1,170 @@
+// Generated by scripts/sync-apple-native-sources.mjs.
+// Edit the canonical Swift source, then regenerate this package boundary.
+import CoreFoundation
+import Foundation
+
+struct NativeStackFrameSanitizer {
+    private static let maxFrames = 32
+    private static let cpuTypeArm64: Int32 = 0x0100_000C
+    private static let cpuTypeX8664: Int32 = 0x0100_0007
+    private static let cpuSubtypeMask: UInt32 = 0x00FF_FFFF
+
+    func frames(from rawReport: [String: Any]) -> [NativeStackFrame]? {
+        guard let crash = rawReport["crash"] as? [String: Any],
+              let threads = crash["threads"] as? [Any]
+        else {
+            return nil
+        }
+        let crashedThreads = threads.compactMap { value -> [String: Any]? in
+            guard let thread = value as? [String: Any], strictBool(thread["crashed"]) == true else {
+                return nil
+            }
+            return thread
+        }
+        guard crashedThreads.count == 1,
+              let backtrace = crashedThreads[0]["backtrace"] as? [String: Any],
+              let rawFrames = backtrace["contents"] as? [Any],
+              let rawImages = rawReport["binary_images"] as? [Any]
+        else {
+            return nil
+        }
+
+        let images = rawImages.compactMap(parseImage)
+        return mapFrames(rawFrames, to: images)
+    }
+
+    private func mapFrames(_ rawFrames: [Any], to images: [BinaryImage]) -> [NativeStackFrame]? {
+        let identityCounts = Dictionary(
+            images.map { ($0.identity, 1) },
+            uniquingKeysWith: +,
+        )
+
+        var result: [NativeStackFrame] = []
+        result.reserveCapacity(min(rawFrames.count, Self.maxFrames))
+        for rawFrame in rawFrames {
+            guard let frame = rawFrame as? [String: Any],
+                  let instructionAddress = unsignedInteger(frame["instruction_addr"])
+            else {
+                continue
+            }
+            let matchingImages = images.filter { $0.contains(instructionAddress) }
+            guard matchingImages.count <= 1 else {
+                return nil
+            }
+            guard let image = matchingImages.first else {
+                continue
+            }
+            guard identityCounts[image.identity] == 1 else {
+                return nil
+            }
+            guard result.count < Self.maxFrames else {
+                continue
+            }
+            result.append(
+                NativeStackFrame(
+                    imageUuid: image.uuid,
+                    architecture: image.architecture,
+                    instructionOffset: String(format: "%016llx", instructionAddress - image.start),
+                ),
+            )
+        }
+        return result.isEmpty ? nil : result
+    }
+
+    private func parseImage(_ value: Any) -> BinaryImage? {
+        guard let image = value as? [String: Any],
+              let start = unsignedInteger(image["image_addr"]),
+              let size = unsignedInteger(image["image_size"]),
+              size > 0,
+              let rawUUID = image["uuid"] as? String,
+              let uuid = UUID(uuidString: rawUUID)?.uuidString.lowercased(),
+              let cpuType = signedInt32(image["cpu_type"]),
+              let cpuSubtype = signedInt32(image["cpu_subtype"]),
+              let architecture = architecture(cpuType: cpuType, cpuSubtype: cpuSubtype)
+        else {
+            return nil
+        }
+        let (end, overflow) = start.addingReportingOverflow(size)
+        guard !overflow else {
+            return nil
+        }
+        return BinaryImage(start: start, end: end, uuid: uuid, architecture: architecture)
+    }
+
+    private func architecture(cpuType: Int32, cpuSubtype: Int32) -> NativeStackArchitecture? {
+        let subtype = UInt32(bitPattern: cpuSubtype) & Self.cpuSubtypeMask
+        switch (cpuType, subtype) {
+        case (Self.cpuTypeArm64, 0), (Self.cpuTypeArm64, 1):
+            return .arm64
+        case (Self.cpuTypeArm64, 2):
+            return .arm64e
+        case (Self.cpuTypeX8664, 3):
+            return .x8664
+        default:
+            return nil
+        }
+    }
+
+    private func strictBool(_ value: Any?) -> Bool? {
+        guard let number = value as? NSNumber,
+              CFGetTypeID(number) == CFBooleanGetTypeID()
+        else {
+            return nil
+        }
+        return number.boolValue
+    }
+
+    private func unsignedInteger(_ value: Any?) -> UInt64? {
+        guard let number = integralNumber(value) else {
+            return nil
+        }
+        switch String(cString: number.objCType) {
+        case "C", "S", "I", "L", "Q":
+            return number.uint64Value
+        default:
+            let signed = number.int64Value
+            return signed < 0 ? nil : UInt64(signed)
+        }
+    }
+
+    private func signedInt32(_ value: Any?) -> Int32? {
+        guard let number = integralNumber(value) else {
+            return nil
+        }
+        return Int32(exactly: number.int64Value)
+    }
+
+    private func integralNumber(_ value: Any?) -> NSNumber? {
+        guard let number = value as? NSNumber,
+              CFGetTypeID(number) != CFBooleanGetTypeID()
+        else {
+            return nil
+        }
+        switch String(cString: number.objCType) {
+        case "c", "C", "s", "S", "i", "I", "l", "L", "q", "Q":
+            return number
+        default:
+            return nil
+        }
+    }
+}
+
+private struct BinaryImage {
+    let start: UInt64
+    let end: UInt64
+    let uuid: String
+    let architecture: NativeStackArchitecture
+
+    var identity: ImageIdentity {
+        ImageIdentity(uuid: uuid, architecture: architecture)
+    }
+
+    func contains(_ address: UInt64) -> Bool {
+        address >= start && address < end
+    }
+}
+
+private struct ImageIdentity: Hashable {
+    let uuid: String
+    let architecture: NativeStackArchitecture
+}

package/ios/GeneratedAppleDiagnostics/SOURCE-MANIFEST.json

@@ -0,0 +1,43 @@
+{
+  "schemaVersion": 1,
+  "sources": {
+    "swift/logbrew-swift/Sources/LogBrew/AutomaticTelemetryContext.swift": "76ab7f8a7c79db1d54ba13da8d61d96af62c509116b7df0f9d220d5c88364c00",
+    "swift/logbrew-swift/Sources/LogBrew/DeliveryEngine.swift": "f98ef86db1a5e5144cd9ab30df325a3602823167c784a22a63904a593725e814",
+    "swift/logbrew-swift/Sources/LogBrew/DeliveryEngineAutomatic.swift": "5ca25a8dc626d33c2b9fa85242acc4715c736024324008897deac906212b65ae",
+    "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/EventEncoding.swift": "b88b6b2d17f7d0cee9ac1a1f34ef35b192cd33d213ef3c9e1c2d21cbcc304a97",
+    "swift/logbrew-swift/Sources/LogBrew/IssueDiagnostics.swift": "797e6e25f203930e85f827bf211b58c73e6b10938b9f0943f2fe6f6757186ba9",
+    "swift/logbrew-swift/Sources/LogBrew/LifecycleTrace.swift": "738cd3f129fac821a892404d1d42ee92bd806b6583d3dbb5379e88b14ab23c16",
+    "swift/logbrew-swift/Sources/LogBrew/LogBrewClient.swift": "2e6dd7c9ef07f181a2798c36a820338e3f81369b1b9c7b85c5c3b6f44103732c",
+    "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": "d64de009cd9f8f43fc059cd8fefc2a282c781ba8543be2f56cb48cb757dbe924",
+    "swift/logbrew-swift/Sources/LogBrew/TelemetryContext.swift": "ce3ac93a62a345f8c9a8f4c69ce84efc991bf02a688f49bad5e68edcff2f6e08",
+    "swift/logbrew-swift/Sources/LogBrew/TelemetryContextValidation.swift": "f631beef20a8a86f975787b4092a9798fedbe2c9e3f0d2740f81831b4adef287",
+    "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": "5551ee5237cbdf1c9ed4ee93025f95313e4dd84f31ce7cb774d1dc01175213c7",
+    "swift/logbrew-swift/Sources/LogBrewCrash/CrashEngine.swift": "7a46035fcaa72dd7504b4e274a92070d73dd1c45fe20e008474340d6d7c44ede",
+    "swift/logbrew-swift/Sources/LogBrewCrash/CrashReportSanitizer.swift": "a872ad63532999e74af1e9685a9382d0e02b93c6f9b942b371d47f56f8b961c0",
+    "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/NativeCrashPublic.swift": "ee209aa25b1c6bcadf84604f145fc55c251c8697e745c87283703dbdd5bbf5ba",
+    "swift/logbrew-swift/Sources/LogBrewCrash/NativeCrashReplay.swift": "3eb3d93b32cf14de416f56fa30d6d65e6f268b5ec9d1a67081d7525c4efd4f80",
+    "swift/logbrew-swift/Sources/LogBrewCrash/NativeHangIncidentStore.swift": "02413ca7e003917faadcc9aa612b5d98897c75b39f67c3c845948dd9349a9d8f",
+    "swift/logbrew-swift/Sources/LogBrewCrash/NativeHangWatchdog.swift": "37b25904cd6576e20c40500be2c153156403b57ad7b4186a1b6b35b414145ecb",
+    "swift/logbrew-swift/Sources/LogBrewCrash/NativeHangWatchdogContracts.swift": "59f51554d86c326122bb2bdce47c5a7e01996bd61f2b371eba23855032487b9f",
+    "swift/logbrew-swift/Sources/LogBrewCrash/NativeHangWatchdogSystem.swift": "b87e3db246691d5b0719898cdc02ba068836647b1ac9339a73cf866eabe235ae",
+    "swift/logbrew-swift/Sources/LogBrewCrash/NativeMainThreadStackCapture.swift": "66f4a53faabf1cc0d65983689e86bc2a9334649b8bb9726a8104822c988693db",
+    "swift/logbrew-swift/Sources/LogBrewCrash/NativeStackFrameSanitizer.swift": "31570c08f182f709ef898ece15dcdc7624b5d8f77e6fb7db3f94d4f14d93585f"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@logbrew/react-native",
-  "version": "0.1.11",
-  "description": "React Native offline delivery, screen, error, trace, action, and network timeline helpers for LogBrew.",
+  "version": "0.1.13",
+  "description": "React Native offline delivery, Apple native diagnostics, screen, error, trace, action, and network timeline helpers for LogBrew.",
   "type": "module",
   "main": "./index.cjs",
   "module": "./index.js",
@@ -114,6 +114,28 @@
         "default": "./metro.cjs"
       },
       "default": "./metro.js"
+    },
+    "./apple-native-diagnostics": {
+      "react-native": {
+        "types": "./apple-native-diagnostics.d.ts",
+        "default": "./apple-native-diagnostics.js"
+      },
+      "import": {
+        "types": "./apple-native-diagnostics.d.ts",
+        "default": "./apple-native-diagnostics.js"
+      },
+      "default": "./apple-native-diagnostics.js"
+    },
+    "./expo": {
+      "import": {
+        "types": "./expo.d.ts",
+        "default": "./expo.js"
+      },
+      "require": {
+        "types": "./expo.d.ts",
+        "default": "./expo.cjs"
+      },
+      "default": "./expo.cjs"
     }
   },
   "files": [
@@ -161,6 +183,11 @@
     "metro.js",
     "metro.d.ts",
     "metro.d.cts",
+    "apple-native-diagnostics.js",
+    "apple-native-diagnostics.d.ts",
+    "expo.cjs",
+    "expo.js",
+    "expo.d.ts",
     "LogBrewReactNative.podspec",
     "android/build.gradle",
     "android/src/main",
@@ -174,8 +201,11 @@
     "ios/LBRNPrivateStorage.m",
     "ios/LBRNEventRecordStore.h",
     "ios/LBRNEventRecordStore.m",
+    "ios/AppleDiagnostics",
+    "ios/GeneratedAppleDiagnostics",
     "react-native.config.js",
     "src",
+    "scripts/sync-apple-native-sources.mjs",
     "README.md",
     "examples"
   ],
@@ -188,7 +218,9 @@
     "logs",
     "traces",
     "events",
-    "source-maps"
+    "source-maps",
+    "crash-reporting",
+    "app-hangs"
   ],
   "sideEffects": false,
   "codegenConfig": {
@@ -208,11 +240,17 @@
     "url": "git+https://github.com/LogBrewCo/sdk.git"
   },
   "peerDependencies": {
-    "@logbrew/sdk": "^0.1.5",
+    "@logbrew/sdk": "^0.1.7",
+    "expo": ">=49",
     "react": ">=18",
     "react-native": ">=0.72"
   },
+  "peerDependenciesMeta": {
+    "expo": {
+      "optional": true
+    }
+  },
   "scripts": {
-    "test": "node --check index.js && node --check index.cjs && node --check index.native.js && node --check apollo.js && node --check apollo.cjs && node --check instrumentation.js && node --check instrumentation.cjs && node --check lifecycle.js && node --check lifecycle.cjs && node --check global-errors.js && node --check global-errors.native.js && node --check global-errors.cjs && node --check promise-rejections.cjs && node --check fatal-replay.cjs && node --check metadata.js && node --check metadata.cjs && node --check native-bridge.js && node --check native-bridge.cjs && node --check resource-fetch.js && node --check resource-fetch.cjs && node --check release-artifacts.js && node --check release-artifacts.cjs && node --check metro.js && node --check metro.cjs && node --check examples/index.mjs && node --check examples/apollo-link-spans.mjs && node --check examples/instrumentation-kit.mjs && node --check examples/lifecycle-spans.mjs && node --check examples/native-bridge-scope.mjs && node --check examples/navigation-resource-spans.mjs && node --check examples/readme-example.mjs && node --check examples/real-user-smoke.mjs && node --check examples/resource-fetch-spans.mjs && node --check examples/trace-correlation.mjs && node --test"
+    "test": "node scripts/sync-apple-native-sources.mjs --check && node --check index.js && node --check index.cjs && node --check index.native.js && node --check apple-native-diagnostics.js && node --check expo.js && node --check expo.cjs && node --check apollo.js && node --check apollo.cjs && node --check instrumentation.js && node --check instrumentation.cjs && node --check lifecycle.js && node --check lifecycle.cjs && node --check global-errors.js && node --check global-errors.native.js && node --check global-errors.cjs && node --check promise-rejections.cjs && node --check fatal-replay.cjs && node --check metadata.js && node --check metadata.cjs && node --check native-bridge.js && node --check native-bridge.cjs && node --check resource-fetch.js && node --check resource-fetch.cjs && node --check release-artifacts.js && node --check release-artifacts.cjs && node --check metro.js && node --check metro.cjs && node --check examples/index.mjs && node --check examples/apollo-link-spans.mjs && node --check examples/instrumentation-kit.mjs && node --check examples/lifecycle-spans.mjs && node --check examples/native-bridge-scope.mjs && node --check examples/navigation-resource-spans.mjs && node --check examples/readme-example.mjs && node --check examples/real-user-smoke.mjs && node --check examples/resource-fetch-spans.mjs && node --check examples/trace-correlation.mjs && node --test"
   }
 }

package/promise-rejections.cjs

@@ -223,7 +223,9 @@ function createEvent(mechanism) {
   delete error.stack;
   const event = createReactNativeErrorEvent(error, {
     id: nextEventId(),
-    includeStack: false
+    handled: false,
+    includeStack: false,
+    mechanism
   });
   return {
     ...event,

package/scripts/sync-apple-native-sources.mjs

@@ -0,0 +1,93 @@
+import assert from "node:assert/strict";
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const scriptDirectory = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(scriptDirectory, "..");
+const repositoryRoot = path.resolve(packageRoot, "../..");
+const generatedRoot = path.join(packageRoot, "ios", "GeneratedAppleDiagnostics");
+const sourceRoot = path.join(repositoryRoot, "swift", "logbrew-swift", "Sources");
+const sourceModules = ["LogBrew", "LogBrewCrash"];
+const generatedHeader = [
+  "// Generated by scripts/sync-apple-native-sources.mjs.",
+  "// Edit the canonical Swift source, then regenerate this package boundary.",
+  ""
+].join("\n");
+const mode = process.argv[2] ?? "--check";
+
+assert.ok(
+  generatedRoot.startsWith(`${packageRoot}${path.sep}`)
+    && path.basename(generatedRoot) === "GeneratedAppleDiagnostics",
+  "refusing to operate outside the package-generated source directory"
+);
+
+const expected = expectedFiles();
+if (mode === "--write") {
+  fs.rmSync(generatedRoot, { force: true, recursive: true });
+  for (const [relativePath, contents] of expected) {
+    const destination = path.join(generatedRoot, relativePath);
+    fs.mkdirSync(path.dirname(destination), { recursive: true });
+    fs.writeFileSync(destination, contents, "utf8");
+  }
+  process.stdout.write(`generated ${expected.size} Apple diagnostics source files\n`);
+} else if (mode === "--check") {
+  const actualPaths = listFiles(generatedRoot).map((filePath) =>
+    path.relative(generatedRoot, filePath)
+  );
+  assert.deepEqual(actualPaths, [...expected.keys()]);
+  for (const [relativePath, contents] of expected) {
+    assert.equal(
+      fs.readFileSync(path.join(generatedRoot, relativePath), "utf8"),
+      contents,
+      `${relativePath} is stale; run the source sync with --write`
+    );
+  }
+  process.stdout.write(`verified ${expected.size} Apple diagnostics source files\n`);
+} else {
+  throw new Error("usage: sync-apple-native-sources.mjs [--check|--write]");
+}
+
+function expectedFiles() {
+  const files = new Map();
+  const manifest = {};
+  for (const moduleName of sourceModules) {
+    const moduleRoot = path.join(sourceRoot, moduleName);
+    for (const sourcePath of listFiles(moduleRoot).filter((filePath) => filePath.endsWith(".swift"))) {
+      const moduleRelativePath = path.relative(moduleRoot, sourcePath);
+      const relativePath = path.join(moduleName, moduleRelativePath);
+      const canonical = fs.readFileSync(sourcePath, "utf8");
+      const transformed = transformCanonicalSource(canonical);
+      const contents = `${generatedHeader}${transformed}`;
+      files.set(relativePath, contents);
+      manifest[path.join("swift", "logbrew-swift", "Sources", relativePath)] =
+        crypto.createHash("sha256").update(canonical).digest("hex");
+    }
+  }
+  files.set(
+    "SOURCE-MANIFEST.json",
+    `${JSON.stringify({ schemaVersion: 1, sources: manifest }, null, 2)}\n`
+  );
+  return new Map([...files].sort(([left], [right]) => left.localeCompare(right)));
+}
+
+function transformCanonicalSource(canonical) {
+  return canonical
+    .replaceAll("@_spi(CrashReplay) import LogBrew\n", "")
+    .replaceAll("@objc(LBW", "@objc(LBRNApple")
+    .replaceAll("@preconcurrency import KSCrashRecording\n", "@preconcurrency import KSCrash\n")
+    .replaceAll("@preconcurrency import KSCrashRecordingCore\n", "@preconcurrency import KSCrash\n");
+}
+
+function listFiles(root) {
+  if (!fs.existsSync(root)) {
+    return [];
+  }
+  return fs.readdirSync(root, { withFileTypes: true })
+    .flatMap((entry) => {
+      const entryPath = path.join(root, entry.name);
+      return entry.isDirectory() ? listFiles(entryPath) : [entryPath];
+    })
+    .sort();
+}

package/src/NativeLogBrewAppleDiagnostics.ts

@@ -0,0 +1,12 @@
+import type { CodegenTypes, TurboModule } from "react-native";
+import { TurboModuleRegistry } from "react-native";
+
+export interface Spec extends TurboModule {
+  installNativeDiagnostics(
+    configuration: CodegenTypes.UnsafeObject
+  ): CodegenTypes.UnsafeObject;
+  replayNativeDiagnostics(): Promise<CodegenTypes.UnsafeObject>;
+  nativeDiagnosticsStatus(): CodegenTypes.UnsafeObject;
+}
+
+export default TurboModuleRegistry.get<Spec>("LogBrewAppleDiagnostics");