@goliapkg/sentori-react-native 0.3.0 → 0.4.0

package/ios/PRIVACY_AND_REVIEW.md

@@ -0,0 +1,122 @@
+# iOS Main Thread Sampler — Privacy & App Store Review Notes
+
+> **Status:** Phase 29 sub-A step 1. Documents the Mach + pthread + dyld
+> APIs the upcoming `SentoriThreadSampler.swift` will call, the App
+> Store review risk for each, and the privacy boundary. Written before
+> the Swift implementation lands so we can rule API choices in or out
+> before writing code we'd later need to rip out.
+
+## Why we need this
+
+`SentoriHangWatchdog.swift` currently captures
+`Thread.callStackSymbols` from the watchdog thread itself, not from
+main, because main is wedged when we want to sample it. The captured
+stack therefore points into our own timer machinery, which is useless
+for diagnosing the user's hang. (The file's own comment at line 100
+flags this as a stop-gap.)
+
+To get the actual wedged main-thread frames we have to walk a remote
+thread's frame pointer chain — main is alive but not running our
+code, so we resolve it via Mach + pthread APIs. This document checks
+those APIs against App Store Review Guideline 2.5.1 ("Apps must use
+only public APIs") before we commit to them.
+
+## API inventory
+
+### Public, App Store-safe
+
+| API | Header | Purpose | Risk |
+|---|---|---|---|
+| `pthread_main_np()` | `<pthread.h>` | bool: am I on main? Sanity-check before sampling. | none |
+| `pthread_self()` | `<pthread.h>` | get current pthread for `pthread_mach_thread_np`. | none |
+| `pthread_mach_thread_np(pthread_t)` | `<pthread.h>` | pthread → mach port. The `_np` suffix is Apple's mark for "non-portable extension"; it's a public API, just not POSIX-portable. | none |
+| `mach_task_self()` | `<mach/mach.h>` | this process's task port. We pass our own task only; we never look up another. | none |
+| `thread_get_state(thread, ARM_THREAD_STATE64, ...)` | `<mach/thread_act.h>` | read main thread's PC / FP / SP / LR. Same call sentry-cocoa, Firebase Crashlytics, and Bugsnag use. | low — public Mach API; reviewers expect to see it from crash-reporter SDKs. |
+| `vm_read_overwrite(self_task, addr, size, dst, ...)` | `<mach/vm_map.h>` | safe (no SIGSEGV) read of own-process memory. We restrict to `mach_task_self()` and small reads (each frame is two pointers). | low — public; flagged only when used to read other processes' memory. |
+| `_dyld_image_count()` / `_dyld_get_image_header()` / `_dyld_get_image_vmaddr_slide()` / `_dyld_get_image_uuid()` | `<mach-o/dyld.h>` | LC_UUID for dSYM matching, ASLR slide for offset calc. Public dyld API. | none |
+
+### Explicitly NOT used (private API risk)
+
+| API | Why we don't use it |
+|---|---|
+| `_pthread_main_thread_np` (underscore prefix) | private alias of `pthread_main_np()`; underscore prefix in Apple SDK = SPI, rejection-grade. |
+| `task_threads(other_task, ...)` cross-task | requires `task-port` entitlement and is reviewer-flagged. We only ever look at our own task. |
+| `task_for_pid` | gated by entitlement; not appropriate for our same-process use. |
+| `__platform_call_*` / `kdebug_trace` / signal hooking | private. |
+| `_dyld_register_func_for_*` introspection beyond UUID | not needed for stack walking. |
+
+## Why this is App Store safe
+
+Direct prior art shipping the same call set, no review issues:
+
+- **sentry-cocoa** — uses `thread_get_state` + `vm_read_overwrite` for
+  slow-frame and ANR sampling, in millions of apps.
+- **Firebase Crashlytics** — same primitives for ANR + hang capture.
+- **Bugsnag**, **Embrace** — likewise.
+- **Apple's MetricKit** (`MXCallStackTree`) walks call stacks via the
+  same public Darwin primitives. Apple themselves consume this
+  surface.
+
+Apple's stance: Review Guideline 2.5.1 forbids non-public APIs, but
+"non-public" means undocumented / underscore-prefixed / not in the
+public SDK. All calls in the public-safe table above are documented
+in Apple's developer reference and shipped in `<mach/...>` /
+`<pthread.h>` / `<mach-o/dyld.h>` headers that come with Xcode by
+default.
+
+## Privacy considerations
+
+What we capture per hang event:
+
+- Up to 64 PC values (program counter addresses) from the main
+  thread's frame pointer chain.
+- The `LC_UUID` of each loaded image and its ASLR vmaddr slide, so
+  the server can match PCs back to a dSYM (Phase 22 sub-B field).
+- Hang duration in milliseconds (already captured today).
+
+What we explicitly do NOT capture:
+
+- Other processes' memory. We only pass `mach_task_self()` to
+  `vm_read_overwrite`.
+- Function arguments, local variables, or register contents — PC
+  only, never the rest of the `arm_thread_state64_t` struct.
+- Heap content, NSString contents, user-typed text, PII.
+- Continuous-rate samples. Sampling fires only on a detected hang
+  (≥ 2s main-thread block) and is one-shot per hang (see watchdog
+  `reportedThisHang` flag at `SentoriHangWatchdog.swift:54`).
+
+Symbolication happens **server-side** against the uploaded dSYM
+(`server/src/symbolicate.rs`). On-device,
+`frames[].instructionAddress` is an ASLR-slid pointer with no
+semantic content until paired with the dSYM.
+
+For the user-facing privacy doc (what data Sentori collects and why),
+see `docs/legal/privacy.md`.
+
+## Rejection contingency
+
+If Apple Review ever rejects with reference to `vm_read_overwrite` or
+`thread_get_state`:
+
+1. Confirm sentry-cocoa / Firebase / Bugsnag are still shipping the
+   same call set. They're the canary; rejection there means a policy
+   change everyone needs to handle.
+2. Switch to `backtrace()` from `<execinfo.h>` — pure libc, walks
+   only the *current* thread, which is the watchdog thread, not
+   main. Lower fidelity (back where we started), zero risk.
+3. Last resort: ship without main-thread sampler; emit hang events
+   with empty `frames[]` and `tags.source = "sentori.hangWatchdog.no-sampler"`
+   so the dashboard can flag the gap. Feature degrades, doesn't
+   break.
+
+## Implementation references
+
+- `sdk/react-native/ios/SentoriThreadSampler.swift` — to be created in
+  Phase 29 sub-A step 2: `captureMainThreadFrames(maxFrames: Int = 64) -> [(pc: UInt64, fp: UInt64)]`
+- `sdk/react-native/ios/SentoriHangWatchdog.swift` — current
+  `Thread.callStackSymbols` capture (line 108) replaced by sampler
+  call in step 4.
+- `server/src/symbolicate.rs` — dSYM lookup + frame resolution
+  (existing, Phase 22 sub-B).
+- `docs/protocol.md` — `frames[].instructionAddress` + `debugId` +
+  `arch` field definitions (existing, Phase 22 sub-B).

package/ios/SentoriHangWatchdog.swift

@@ -0,0 +1,244 @@
+import Foundation
+
+/// iOS hang detector — mirrors the Android ANR watchdog (Phase 22 sub-D).
+///
+/// A background thread posts a tick onto the main queue every
+/// `intervalMs` and waits `timeoutMs` for it to run. If the main run
+/// loop didn't drain the tick in time we capture the main thread's
+/// call stack and write a Sentori event with `kind = "anr"` (the
+/// dashboard already groups Android ANR + iOS hang under that kind —
+/// the user-visible distinction lives in `tags.source`).
+///
+/// Single-shot per hang: once we report, we wait for the tick to
+/// land before re-arming so a 30-second freeze doesn't dump six
+/// events. Daemon thread (DispatchSourceTimer in a background
+/// queue) so it can't keep the process alive on shutdown.
+///
+/// Disabled in DEBUG builds by default — the Xcode debugger
+/// pauses the main thread routinely and we don't want a flood. The
+/// host app can override via `start(force: true)`.
+@objc public final class SentoriHangWatchdog: NSObject {
+
+    private static let pendingDirName = "sentori/pending"
+    private static let configKey = "com.sentori.config"
+
+    private static var running: Bool = false
+    private static var queue: DispatchQueue?
+    private static var timer: DispatchSourceTimer?
+    private static let lock = NSLock()
+
+    /// Start the watchdog. Idempotent. **Must be called from the main
+    /// thread** so the sampler can capture main's mach port; if called
+    /// from a background thread the sampler stays uninstalled and the
+    /// watchdog falls back to `Thread.callStackSymbols`.
+    @objc public static func start(timeoutMs: Int, intervalMs: Int, force: Bool) {
+        lock.lock()
+        defer { lock.unlock() }
+        if running { return }
+        if isDebug() && !force { return }
+
+        // Capture main's mach port for the Phase 29 sub-A sampler. No-op
+        // if we're not on main; sampler will then return [] and we
+        // gracefully fall back at capture time.
+        SentoriThreadSampler.installMainThreadHandle()
+
+        let q = DispatchQueue(label: "com.sentori.hangWatchdog", qos: .utility)
+        let t = DispatchSource.makeTimerSource(queue: q)
+        let interval = DispatchTimeInterval.milliseconds(intervalMs)
+        let timeoutNs = UInt64(max(0, timeoutMs)) * NSEC_PER_MSEC
+
+        // The "tick" path: post a Bool flip onto the main queue and
+        // record the time we did so. Read both fields in the worker
+        // tick to decide whether the main loop is alive.
+        let state = HangState()
+
+        t.schedule(deadline: .now() + interval, repeating: interval)
+        t.setEventHandler {
+            // If the previous tick is still pending after the timeout
+            // window, the main thread is wedged. Capture once, then
+            // hold off until the main loop catches up.
+            if state.armed.value, let armedAt = state.armedAt.value {
+                let elapsedNs = DispatchTime.now().uptimeNanoseconds &- armedAt.uptimeNanoseconds
+                if elapsedNs >= timeoutNs && !state.reportedThisHang.value {
+                    state.reportedThisHang.value = true
+                    captureHang(durationMs: Int(elapsedNs / NSEC_PER_MSEC))
+                }
+                return
+            }
+
+            // Main is responsive — re-arm.
+            state.armed.value = true
+            state.armedAt.value = DispatchTime.now()
+            state.reportedThisHang.value = false
+            DispatchQueue.main.async {
+                state.armed.value = false
+                state.armedAt.value = nil
+            }
+        }
+        t.resume()
+        timer = t
+        queue = q
+        running = true
+    }
+
+    @objc public static func stop() {
+        lock.lock()
+        defer { lock.unlock() }
+        timer?.cancel()
+        timer = nil
+        queue = nil
+        running = false
+    }
+
+    private static func isDebug() -> Bool {
+        #if DEBUG
+            return true
+        #else
+            return false
+        #endif
+    }
+
+    // MARK: - capture
+
+    private static func captureHang(durationMs: Int) {
+        let cfg = UserDefaults.standard.dictionary(forKey: configKey) ?? [:]
+        let release = (cfg["release"] as? String) ?? "unknown"
+        let environment = (cfg["environment"] as? String) ?? "prod"
+
+        // Phase 29 sub-A: try the Mach-based main-thread sampler first.
+        // It walks main's frame pointer chain via thread_get_state +
+        // vm_read_overwrite (see PRIVACY_AND_REVIEW.md). Returns [] on
+        // non-arm64 platforms or if installMainThreadHandle was never
+        // called from main; we then fall back to this thread's own
+        // stack — biased toward dispatch machinery but better than
+        // nothing.
+        let pcs = SentoriThreadSampler.captureMainThreadFrames(maxFrames: 64)
+        let frames: [[String: Any]]
+        let stackSource: String
+        if !pcs.isEmpty {
+            frames = pcs.map { pc -> [String: Any] in
+                return [
+                    "function": "<unsymbolicated>",
+                    "file": "<unknown>",
+                    "line": 0,
+                    "instructionAddress": String(format: "0x%llx", pc.uint64Value),
+                    "arch": "arm64",
+                    "inApp": true,
+                ]
+            }
+            stackSource = "sentori.hangWatchdog.sampler"
+        } else {
+            frames = Thread.callStackSymbols.map { sym -> [String: Any] in
+                let parts = sym.split(
+                    separator: " ", omittingEmptySubsequences: true
+                ).map(String.init)
+                let module = parts.count > 1 ? parts[1] : "<unknown>"
+                let function =
+                    parts.count > 3
+                    ? parts.dropFirst(3).joined(separator: " ")
+                    : "<anonymous>"
+                return [
+                    "function": function,
+                    "file": module,
+                    "line": 0,
+                    "inApp": !module.contains("UIKit")
+                        && !module.contains("Foundation")
+                        && !module.contains("CoreFoundation")
+                        && !module.contains("libsystem")
+                        && !module.contains("libobjc"),
+                ]
+            }
+            stackSource = "sentori.hangWatchdog.no-sampler"
+        }
+
+        let event: [String: Any] = [
+            "id": UUID().uuidString.lowercased(),
+            "timestamp": iso8601(Date()),
+            "kind": "anr",
+            "platform": "ios",
+            "release": release,
+            "environment": environment,
+            "device": [
+                "os": "ios",
+                "osVersion": osVersion(),
+                "model": deviceModel(),
+            ],
+            "app": appInfo(),
+            "user": NSNull(),
+            "tags": ["source": stackSource],
+            "breadcrumbs": [Any](),
+            "error": [
+                "type": "ApplicationNotResponding",
+                "message": "Main thread blocked for ≥ \(durationMs) ms",
+                "stack": frames,
+                "cause": NSNull(),
+            ],
+            "fingerprint": [String](),
+            "traceId": NSNull(),
+            "spanId": NSNull(),
+        ]
+
+        guard
+            let docs = FileManager.default.urls(
+                for: .documentDirectory, in: .userDomainMask
+            ).first
+        else { return }
+        let dir = docs.appendingPathComponent(pendingDirName)
+        try? FileManager.default.createDirectory(
+            at: dir, withIntermediateDirectories: true)
+        let url = dir.appendingPathComponent(
+            "\(UUID().uuidString.lowercased()).json")
+        if let data = try? JSONSerialization.data(
+            withJSONObject: event, options: [])
+        {
+            try? data.write(to: url)
+        }
+    }
+
+    private static func iso8601(_ date: Date) -> String {
+        let f = ISO8601DateFormatter()
+        f.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
+        return f.string(from: date)
+    }
+
+    private static func osVersion() -> String {
+        let v = ProcessInfo.processInfo.operatingSystemVersion
+        return "\(v.majorVersion).\(v.minorVersion).\(v.patchVersion)"
+    }
+
+    private static func deviceModel() -> String {
+        var s = utsname()
+        uname(&s)
+        return withUnsafePointer(to: &s.machine) { ptr in
+            ptr.withMemoryRebound(to: CChar.self, capacity: 1) {
+                String(validatingUTF8: $0) ?? "unknown"
+            }
+        }
+    }
+
+    private static func appInfo() -> [String: Any] {
+        let info = Bundle.main.infoDictionary ?? [:]
+        var d: [String: Any] = [
+            "version": (info["CFBundleShortVersionString"] as? String)
+                ?? "0.0.0"
+        ]
+        if let build = info["CFBundleVersion"] as? String {
+            d["build"] = build
+        }
+        return d
+    }
+}
+
+/// Mutable boxes shared between the watchdog tick and the main-queue
+/// ack. Class so the closures can mutate without `inout` and so the
+/// references survive across the `setEventHandler` capture.
+private final class HangState {
+    let armed = Box(false)
+    let armedAt = Box<DispatchTime?>(nil)
+    let reportedThisHang = Box(false)
+}
+
+private final class Box<T> {
+    var value: T
+    init(_ v: T) { self.value = v }
+}

package/ios/SentoriModule.swift

@@ -24,6 +24,25 @@ public class SentoriModule: Module {
             return SentoriCrashHandler.consumePending()
         }
 
+        // Phase 22 sub-E: opt-in iOS hang watchdog. Same JS function
+        // name as Android (sub-D) so the host app calls
+        // `startAnrWatchdog(...)` once, both platforms react.
+        // Defaults: 2 s timeout, 1 s tick interval, debug-build off.
+        Function("startAnrWatchdog") { (options: [String: Any]?) in
+            let timeoutMs = (options?["timeoutMs"] as? Int) ?? 2000
+            let intervalMs = (options?["intervalMs"] as? Int) ?? 1000
+            let force = (options?["force"] as? Bool) ?? false
+            SentoriHangWatchdog.start(
+                timeoutMs: timeoutMs,
+                intervalMs: intervalMs,
+                force: force
+            )
+        }
+
+        Function("stopAnrWatchdog") {
+            SentoriHangWatchdog.stop()
+        }
+
         // Dev-only helper used by the example app to verify the
         // crash-write / drain round-trip without writing native code in
         // the host app. Schedules a real NSException after a tick so

package/ios/SentoriThreadSampler.swift

@@ -0,0 +1,149 @@
+import Foundation
+
+/// Captures the main thread's program-counter chain for hang reporting.
+///
+/// Phase 29 sub-A. Used by `SentoriHangWatchdog` to fill an `anr` event's
+/// `frames[].instructionAddress`. Server-side symbolicates against the
+/// uploaded dSYM (Phase 22 sub-B). API surface and App Store review notes
+/// are in `PRIVACY_AND_REVIEW.md`.
+///
+/// arm64-only. On non-arm64 (Intel Mac simulators) `captureMainThreadFrames`
+/// returns an empty array; the watchdog falls back to its previous
+/// `Thread.callStackSymbols` path.
+@objc public final class SentoriThreadSampler: NSObject {
+
+    /// Mach port for the main thread, captured once at SDK init time from
+    /// main. 0 = uninstalled (or non-arm64 platform).
+    private static var mainThreadHandle: thread_t = 0
+
+    /// Captures the main thread's mach port. Must be called from the main
+    /// thread, exactly once during SDK init. Idempotent — second + later
+    /// calls are no-ops.
+    @objc public static func installMainThreadHandle() {
+        guard pthread_main_np() != 0 else { return }
+        if mainThreadHandle != 0 { return }
+        mainThreadHandle = pthread_mach_thread_np(pthread_self())
+    }
+
+    /// Walks the main thread's frame pointer chain and returns up to
+    /// `maxFrames` PCs.
+    ///
+    /// - PC[0]   = current main-thread PC (from `thread_get_state`).
+    /// - PC[i>0] = saved LR (return address) `i` frames up the stack.
+    ///
+    /// Returns an empty array if:
+    ///   * the main handle isn't installed (caller forgot
+    ///     `installMainThreadHandle` from main),
+    ///   * the platform isn't arm64,
+    ///   * `thread_get_state` or `vm_read_overwrite` fails,
+    ///   * the caller is itself on main (we don't sample our own thread).
+    ///
+    /// Bridged to Objective-C as `[NSNumber]` of unsigned 64-bit PCs.
+    @objc public static func captureMainThreadFrames(maxFrames: Int = 64) -> [NSNumber] {
+        #if arch(arm64)
+        guard mainThreadHandle != 0, maxFrames > 0 else { return [] }
+        // Don't sample ourselves — we'd race with our own register state.
+        if pthread_main_np() != 0 { return [] }
+
+        var state = arm_thread_state64_t()
+        // ARM_THREAD_STATE64_COUNT is a C macro that doesn't make the
+        // Swift import; compute it the same way the macro does
+        // (sizeof(arm_thread_state64_t) / sizeof(uint32_t)).
+        var stateCount = mach_msg_type_number_t(
+            MemoryLayout<arm_thread_state64_t>.size / MemoryLayout<UInt32>.size
+        )
+
+        let kr: kern_return_t = withUnsafeMutablePointer(to: &state) { sp in
+            sp.withMemoryRebound(to: natural_t.self, capacity: Int(stateCount)) { ptr in
+                thread_get_state(
+                    mainThreadHandle,
+                    ARM_THREAD_STATE64,
+                    ptr,
+                    &stateCount
+                )
+            }
+        }
+        guard kr == KERN_SUCCESS else { return [] }
+
+        // The intrinsics __darwin_arm_thread_state64_get_{pc,fp} also
+        // don't import cleanly into Swift. Reinterpret the struct as
+        // a UInt64 array and pick out registers by ABI index, which is
+        // identical between arm64 and arm64e (only the field names
+        // differ; the raw byte layout is the same):
+        //   __x[0..28] = indices 0..28
+        //   __fp       = index 29
+        //   __lr       = index 30
+        //   __sp       = index 31
+        //   __pc       = index 32
+        //   __cpsr / __pad = index 33 (packed)
+        // PAC bits, if any (arm64e), are stripped by stripPAC below.
+        let regs = withUnsafeBytes(of: state) { raw -> (pc: UInt64, fp: UInt64) in
+            let base = raw.baseAddress!.assumingMemoryBound(to: UInt64.self)
+            return (pc: base[32], fp: base[29])
+        }
+
+        var frames: [UInt64] = []
+        if regs.pc != 0 {
+            frames.append(stripPAC(regs.pc))
+        }
+
+        var fp = regs.fp
+        let task = mach_task_self_
+
+        while frames.count < maxFrames && fp != 0 {
+            // ARM64 frame layout (per AAPCS64): [saved fp][saved lr] at
+            // offsets 0 and 8 from the current frame pointer.
+            var nextFP: UInt64 = 0
+            var savedLR: UInt64 = 0
+
+            guard readWord(task: task, addr: fp, into: &nextFP) else { break }
+            guard readWord(task: task, addr: fp &+ 8, into: &savedLR) else { break }
+
+            // Sanity: FP must walk up the user stack (always increasing).
+            // Bail on chain corruption; still return what we have.
+            if nextFP <= fp { break }
+
+            frames.append(stripPAC(savedLR))
+            fp = nextFP
+        }
+
+        return frames.map { NSNumber(value: $0) }
+        #else
+        return []
+        #endif
+    }
+
+    // MARK: - arm64 helpers
+
+    #if arch(arm64)
+    /// Strips the pointer authentication code (PAC) from a saved LR.
+    /// On arm64 (non-arm64e) PAC bits aren't set; this is a no-op mask.
+    /// On arm64e stack-saved LRs may carry a signing tag in the high
+    /// bits; user-space PCs fit in the low 47 bits, so we mask above.
+    private static func stripPAC(_ pc: UInt64) -> UInt64 {
+        return pc & 0x0000_007F_FFFF_FFFF
+    }
+
+    /// `vm_read_overwrite` wrapper: read 8 bytes from `addr` in the given
+    /// task into `dst`. Returns true iff the read succeeded with a full
+    /// word transferred.
+    private static func readWord(
+        task: mach_port_t,
+        addr: UInt64,
+        into dst: inout UInt64
+    ) -> Bool {
+        var bytesRead: vm_size_t = 0
+        return withUnsafeMutablePointer(to: &dst) { ptr -> Bool in
+            let dstAddr = vm_address_t(UInt(bitPattern: UnsafeMutableRawPointer(ptr)))
+            let kr = vm_read_overwrite(
+                task,
+                vm_address_t(addr),
+                vm_size_t(MemoryLayout<UInt64>.size),
+                dstAddr,
+                &bytesRead
+            )
+            return kr == KERN_SUCCESS && bytesRead == MemoryLayout<UInt64>.size
+        }
+    }
+    #endif
+}

package/ios/Tests/SentoriThreadSamplerTests.swift

@@ -0,0 +1,96 @@
+// Phase 29 sub-A step 3: XCTest coverage for SentoriThreadSampler.
+//
+// Run via Xcode (target → SentoriTests, ⌘U) or via xcodebuild from the
+// iOS host:
+//   xcodebuild test \
+//     -scheme SentoriTests \
+//     -destination 'platform=iOS Simulator,name=iPhone 15'
+//
+// On Apple Silicon Mac the simulator runs the arm64 slice and the
+// sampler can walk frames; on Intel Mac the simulator slice is x86_64
+// and the sampler returns []. Both paths are asserted below.
+
+import XCTest
+
+@testable import SentoriCrashHandler
+
+final class SentoriThreadSamplerTests: XCTestCase {
+
+    override func setUp() {
+        super.setUp()
+        // Capture the main pthread → mach port mapping. setUp runs on
+        // the test runner's main queue, which is the main thread.
+        SentoriThreadSampler.installMainThreadHandle()
+    }
+
+    /// Background → sampler → main: should collect a non-trivial frame
+    /// chain on arm64 simulators.
+    func testCaptureFromBackgroundReturnsAtLeastFiveFrames() {
+        let exp = expectation(description: "background sample")
+        DispatchQueue.global(qos: .userInitiated).async {
+            let frames = SentoriThreadSampler.captureMainThreadFrames(maxFrames: 64)
+            #if arch(arm64)
+                XCTAssertGreaterThanOrEqual(
+                    frames.count, 5,
+                    "expected ≥ 5 main-thread frames on arm64; got \(frames.count)"
+                )
+                if !frames.isEmpty {
+                    XCTAssertGreaterThan(
+                        frames[0].uint64Value, 0,
+                        "first PC must be non-zero"
+                    )
+                }
+                XCTAssertLessThanOrEqual(
+                    frames.count, 64,
+                    "must respect maxFrames cap"
+                )
+            #else
+                // Intel simulator: sampler returns empty by design.
+                XCTAssertEqual(frames.count, 0)
+            #endif
+            exp.fulfill()
+        }
+        wait(for: [exp], timeout: 5.0)
+    }
+
+    /// Sampling from main itself must refuse — would race with our own
+    /// register state.
+    func testCaptureFromMainReturnsEmpty() {
+        let frames = SentoriThreadSampler.captureMainThreadFrames(maxFrames: 64)
+        XCTAssertEqual(
+            frames.count, 0,
+            "sampling from main must return [] (would race with own state)"
+        )
+    }
+
+    /// `installMainThreadHandle` must be safe to call repeatedly.
+    func testInstallIsIdempotent() {
+        SentoriThreadSampler.installMainThreadHandle()
+        SentoriThreadSampler.installMainThreadHandle()
+        SentoriThreadSampler.installMainThreadHandle()
+
+        let exp = expectation(description: "still works after re-install")
+        DispatchQueue.global().async {
+            let frames = SentoriThreadSampler.captureMainThreadFrames(maxFrames: 16)
+            #if arch(arm64)
+                XCTAssertGreaterThan(
+                    frames.count, 0,
+                    "re-installs must not break the captured handle"
+                )
+            #endif
+            exp.fulfill()
+        }
+        wait(for: [exp], timeout: 2.0)
+    }
+
+    /// `maxFrames: 0` returns empty even on arm64.
+    func testZeroMaxFramesReturnsEmpty() {
+        let exp = expectation(description: "zero max")
+        DispatchQueue.global().async {
+            let frames = SentoriThreadSampler.captureMainThreadFrames(maxFrames: 0)
+            XCTAssertEqual(frames.count, 0)
+            exp.fulfill()
+        }
+        wait(for: [exp], timeout: 2.0)
+    }
+}

package/lib/capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAoC,IAAI,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAI5E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM,IAAI,GAAG,IAAI,KAAG,IAE3C,CAAC;AAEF,eAAO,MAAM,OAAO,QAAO,IAAI,GAAG,IAAa,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,EAAE,SAAS,aAAa,KAAG,IAsBnE,CAAC;AAEF,eAAO,MAAM,gBAAgB,UAxBO,KAAK,WAAW,aAAa,KAAG,IAwBxB,CAAC"}
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAoC,IAAI,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAI5E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM,IAAI,GAAG,IAAI,KAAG,IAE3C,CAAC;AAEF,eAAO,MAAM,OAAO,QAAO,IAAI,GAAG,IAAa,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,EAAE,SAAS,aAAa,KAAG,IAyBnE,CAAC;AAEF,eAAO,MAAM,gBAAgB,UA3BO,KAAK,WAAW,aAAa,KAAG,IA2BxB,CAAC"}

package/lib/capture.js

@@ -1,5 +1,6 @@
 import { getConfig, isInitialized } from './config';
 import { getBreadcrumbs } from './breadcrumbs';
+import { markSessionErrored } from './session-tracker';
 import { parseStack } from './stack';
 import { enqueue } from './transport';
 import { uuidV7 } from './uuid';
@@ -41,6 +42,9 @@ export const captureError = (error, extras) => {
         error: errorToObject(error),
         fingerprint: extras?.fingerprint,
     };
+    // Phase 26 sub-B: a captured error promotes the current session to
+    // `errored` so the next AppState=background ping reports unhealthy.
+    markSessionErrored();
     enqueue(event);
 };
 export const captureException = captureError;

package/lib/capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"capture.js","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"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"}

package/lib/handlers/lifecycle.d.ts

@@ -0,0 +1,3 @@
+export declare const installLifecycleHandler: () => void;
+export declare const __uninstallLifecycleForTests: () => void;
+//# sourceMappingURL=lifecycle.d.ts.map

package/lib/handlers/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/handlers/lifecycle.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,uBAAuB,QAAO,IAqB1C,CAAC;AAEF,eAAO,MAAM,4BAA4B,QAAO,IAI/C,CAAC"}

package/lib/handlers/lifecycle.js

@@ -0,0 +1,48 @@
+/**
+ * Phase 26 sub-B: AppState binding.
+ *
+ * Subscribes to AppState transitions:
+ *   - active → start a fresh session (after a previous background end)
+ *   - background / inactive → end the current session
+ *
+ * RN's AppState fires `inactive` on iOS during multitasking peek; we
+ * end on it because that's effectively a background and the user may
+ * not return. If they do, `active` starts a new one — the on-the-wire
+ * session count goes up by one, which matches "the user opened the app
+ * twice". Sentry historically did the opposite (treat inactive as
+ * still alive), but that lets a swiped-away session never end.
+ */
+import { endSession, startSession } from '../session-tracker';
+let _installed = false;
+let _subscription = null;
+export const installLifecycleHandler = () => {
+    if (_installed)
+        return;
+    _installed = true;
+    let AppState;
+    try {
+        // RN ships AppState; in test / non-RN host the require throws and
+        // we silently no-op.
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        AppState = require('react-native').AppState;
+    }
+    catch {
+        return;
+    }
+    if (!AppState || typeof AppState.addEventListener !== 'function')
+        return;
+    _subscription = AppState.addEventListener('change', (state) => {
+        if (state === 'active') {
+            startSession();
+        }
+        else if (state === 'background' || state === 'inactive') {
+            endSession();
+        }
+    });
+};
+export const __uninstallLifecycleForTests = () => {
+    _subscription?.remove();
+    _subscription = null;
+    _installed = false;
+};
+//# sourceMappingURL=lifecycle.js.map

package/lib/handlers/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/handlers/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,IAAI,UAAU,GAAG,KAAK,CAAC;AACvB,IAAI,aAAa,GAAkC,IAAI,CAAC;AASxD,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAS,EAAE;IAChD,IAAI,UAAU;QAAE,OAAO;IACvB,UAAU,GAAG,IAAI,CAAC;IAClB,IAAI,QAAkC,CAAC;IACvC,IAAI,CAAC;QACH,kEAAkE;QAClE,qBAAqB;QACrB,iEAAiE;QACjE,QAAQ,GAAI,OAAO,CAAC,cAAc,CAAiC,CAAC,QAAQ,CAAC;IAC/E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,gBAAgB,KAAK,UAAU;QAAE,OAAO;IAEzE,aAAa,GAAG,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;QAC5D,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,YAAY,EAAE,CAAC;QACjB,CAAC;aAAM,IAAI,KAAK,KAAK,YAAY,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YAC1D,UAAU,EAAE,CAAC;QACf,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAS,EAAE;IACrD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,GAAG,IAAI,CAAC;IACrB,UAAU,GAAG,KAAK,CAAC;AACrB,CAAC,CAAC"}

package/lib/index.d.ts

@@ -7,6 +7,9 @@ export declare const sentori: {
     captureError: (error: Error, extras?: import("./capture").CaptureExtras) => void;
     captureException: (error: Error, extras?: import("./capture").CaptureExtras) => void;
     ErrorBoundary: typeof ErrorBoundary;
+    startSession: () => void;
+    endSession: (status?: "exited") => void;
+    markSessionCrashed: () => void;
 };
 export default sentori;
 export { init, init as initSentori } from './init';
@@ -14,5 +17,6 @@ export { addBreadcrumb } from './breadcrumbs';
 export { setUser, getUser, captureError, captureException } from './capture';
 export { ErrorBoundary } from './error-boundary';
 export { startAnrWatchdog, stopAnrWatchdog, triggerNativeCrash, } from './native';
+export { endSession, markSessionCrashed, startSession, } from './session-tracker';
 export type { Event, SentoriError, Frame, Breadcrumb, BreadcrumbType, Device, DeviceOS, App, User, Tags, EventKind, Platform, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,eAAO,MAAM,OAAO;;;;;;;;CAQnB,CAAC;AAEF,eAAe,OAAO,CAAC;AAEvB,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,KAAK,EACL,YAAY,EACZ,KAAK,EACL,UAAU,EACV,cAAc,EACd,MAAM,EACN,QAAQ,EACR,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,QAAQ,GACT,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAOjD,eAAO,MAAM,OAAO;;;;;;;;;;;CAWnB,CAAC;AAEF,eAAe,OAAO,CAAC;AAEvB,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,KAAK,EACL,YAAY,EACZ,KAAK,EACL,UAAU,EACV,cAAc,EACd,MAAM,EACN,QAAQ,EACR,GAAG,EACH,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,QAAQ,GACT,MAAM,SAAS,CAAC"}

package/lib/index.js

@@ -2,6 +2,7 @@ import { init } from './init';
 import { addBreadcrumb } from './breadcrumbs';
 import { setUser, getUser, captureError, captureException } from './capture';
 import { ErrorBoundary } from './error-boundary';
+import { endSession, markSessionCrashed, startSession, } from './session-tracker';
 export const sentori = {
     init,
     addBreadcrumb,
@@ -10,6 +11,9 @@ export const sentori = {
     captureError,
     captureException,
     ErrorBoundary,
+    startSession,
+    endSession,
+    markSessionCrashed,
 };
 export default sentori;
 export { init, init as initSentori } from './init';
@@ -17,4 +21,5 @@ export { addBreadcrumb } from './breadcrumbs';
 export { setUser, getUser, captureError, captureException } from './capture';
 export { ErrorBoundary } from './error-boundary';
 export { startAnrWatchdog, stopAnrWatchdog, triggerNativeCrash, } from './native';
+export { endSession, markSessionCrashed, startSession, } from './session-tracker';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,IAAI;IACJ,aAAa;IACb,OAAO;IACP,OAAO;IACP,YAAY;IACZ,gBAAgB;IAChB,aAAa;CACd,CAAC;AAEF,eAAe,OAAO,CAAC;AAEvB,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,IAAI;IACJ,aAAa;IACb,OAAO;IACP,OAAO;IACP,YAAY;IACZ,gBAAgB;IAChB,aAAa;IACb,YAAY;IACZ,UAAU;IACV,kBAAkB;CACnB,CAAC;AAEF,eAAe,OAAO,CAAC;AAEvB,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,WAAW,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,YAAY,GACb,MAAM,mBAAmB,CAAC"}

package/lib/native.d.ts

@@ -21,14 +21,15 @@ export declare function drainNativePending(): Promise<string[]>;
  */
 export declare function triggerNativeCrash(): void;
 /**
- * Phase 22 sub-D: start the Android ANR watchdog.
+ * Phase 22 sub-D / sub-E: cross-platform main-thread watchdog.
+ * Single JS call covers both Android ANR and iOS hang detection.
  *
- *     startAnrWatchdog()                       // default 5s/1s, prod-only
+ *     startAnrWatchdog()                       // platform defaults, prod-only
  *     startAnrWatchdog({ force: true })        // include debug builds
  *     startAnrWatchdog({ timeoutMs: 3000 })    // tighter threshold
  *
- * Returns silently on iOS / web / jest. iOS hang detection (sub-E)
- * will hook the same JS function once landed.
+ * Defaults: Android 5 s / 1 s tick; iOS 2 s / 1 s tick. Returns
+ * silently on web / jest / unsupported runtimes.
  */
 export declare function startAnrWatchdog(options?: {
     force?: boolean;

package/lib/native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwCH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd,GAAG,IAAI,CAMP;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAMzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IACzC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,IAAI,CAMP;AAED,wBAAgB,eAAe,IAAI,IAAI,CAMtC"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0CH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd,GAAG,IAAI,CAMP;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAMzC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IACzC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,GAAG,IAAI,CAMP;AAED,wBAAgB,eAAe,IAAI,IAAI,CAMtC"}

package/lib/native.js

@@ -54,14 +54,15 @@ export function triggerNativeCrash() {
     }
 }
 /**
- * Phase 22 sub-D: start the Android ANR watchdog.
+ * Phase 22 sub-D / sub-E: cross-platform main-thread watchdog.
+ * Single JS call covers both Android ANR and iOS hang detection.
  *
- *     startAnrWatchdog()                       // default 5s/1s, prod-only
+ *     startAnrWatchdog()                       // platform defaults, prod-only
  *     startAnrWatchdog({ force: true })        // include debug builds
  *     startAnrWatchdog({ timeoutMs: 3000 })    // tighter threshold
  *
- * Returns silently on iOS / web / jest. iOS hang detection (sub-E)
- * will hook the same JS function once landed.
+ * Defaults: Android 5 s / 1 s tick; iOS 2 s / 1 s tick. Returns
+ * silently on web / jest / unsupported runtimes.
  */
 export function startAnrWatchdog(options) {
     try {

package/lib/native.js.map

@@ -1 +1 @@
-{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyBH,IAAI,OAA+C,CAAA;AAEnD,SAAS,MAAM;IACb,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAA;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,mBAAmB,CAEvC,CAAA;QACD,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAsB,SAAS,CAAC,CAAA;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,IAAI,CAAA;IAChB,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAI/B;IACC,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,CAAC,GAAG,MAAM,EAAE,CAAA;IAClB,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAA;IACjB,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,CAAC,YAAY,EAAE,CAAA;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,sBAAsB,EAAE,EAAE,CAAA;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAIhC;IACC,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,gBAAgB,EAAE,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,gCAAgC;IAClC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,eAAe,EAAE,EAAE,CAAA;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;AACH,CAAC"}
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA2BH,IAAI,OAA+C,CAAA;AAEnD,SAAS,MAAM;IACb,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAA;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,mBAAmB,CAEvC,CAAA;QACD,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAsB,SAAS,CAAC,CAAA;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,IAAI,CAAA;IAChB,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAI/B;IACC,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,CAAC,GAAG,MAAM,EAAE,CAAA;IAClB,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAA;IACjB,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,CAAC,YAAY,EAAE,CAAA;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,sBAAsB,EAAE,EAAE,CAAA;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAIhC;IACC,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,gBAAgB,EAAE,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,gCAAgC;IAClC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,eAAe,EAAE,EAAE,CAAA;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;AACH,CAAC"}

package/lib/session-tracker.d.ts

@@ -0,0 +1,6 @@
+export declare const startSession: () => void;
+export declare const endSession: (status?: "exited") => void;
+export declare const markSessionErrored: () => void;
+export declare const markSessionCrashed: () => void;
+export declare const __resetSessionForTests: () => void;
+//# sourceMappingURL=session-tracker.d.ts.map

package/lib/session-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tracker.d.ts","sourceRoot":"","sources":["../src/session-tracker.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,YAAY,QAAO,IAS/B,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,SAAS,QAAQ,KAAG,IAG9C,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAAO,IAErC,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAAO,IAErC,CAAC;AAEF,eAAO,MAAM,sBAAsB,QAAO,IAEzC,CAAC"}

package/lib/session-tracker.js

@@ -0,0 +1,50 @@
+/**
+ * Phase 26 sub-B: RN session tracker glue.
+ *
+ * Mirrors the JS SDK's session-tracker but sends through the RN
+ * transport. AppState binding lives in `handlers/lifecycle.ts`; this
+ * file is just the singleton + the start/end/markErrored/markCrashed
+ * surface.
+ */
+import { SessionTracker } from '@goliapkg/sentori-core';
+import { getConfig } from './config';
+import { getUser } from './capture';
+import { sendSessionPing } from './transport';
+let _tracker = null;
+const tracker = () => {
+    if (_tracker)
+        return _tracker;
+    _tracker = new SessionTracker((ping) => {
+        const cfg = getConfig();
+        if (!cfg)
+            return;
+        void sendSessionPing(cfg.ingestUrl, cfg.token, ping);
+    });
+    return _tracker;
+};
+export const startSession = () => {
+    const cfg = getConfig();
+    if (!cfg)
+        return;
+    const user = getUser();
+    tracker().start({
+        environment: cfg.environment,
+        release: cfg.release,
+        userId: user?.id ?? null,
+    });
+};
+export const endSession = (status) => {
+    if (!_tracker)
+        return;
+    _tracker.end(status);
+};
+export const markSessionErrored = () => {
+    _tracker?.markErrored();
+};
+export const markSessionCrashed = () => {
+    _tracker?.markCrashed();
+};
+export const __resetSessionForTests = () => {
+    _tracker = null;
+};
+//# sourceMappingURL=session-tracker.js.map

package/lib/session-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tracker.js","sourceRoot":"","sources":["../src/session-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,IAAI,QAAQ,GAA0B,IAAI,CAAC;AAE3C,MAAM,OAAO,GAAG,GAAmB,EAAE;IACnC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,QAAQ,GAAG,IAAI,cAAc,CAAC,CAAC,IAAI,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,KAAK,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,GAAS,EAAE;IACrC,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,OAAO,EAAE,CAAC,KAAK,CAAC;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,IAAI;KACzB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAiB,EAAQ,EAAE;IACpD,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAS,EAAE;IAC3C,QAAQ,EAAE,WAAW,EAAE,CAAC;AAC1B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAS,EAAE;IAC3C,QAAQ,EAAE,WAAW,EAAE,CAAC;AAC1B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAS,EAAE;IAC/C,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC,CAAC"}

package/lib/transport.d.ts

@@ -5,4 +5,12 @@ export declare const flush: () => Promise<void>;
 export declare const drainOfflineQueue: () => Promise<void>;
 export declare const __resetForTests: () => void;
 export declare const __peekQueue: () => readonly Event[];
+/**
+ * Phase 26 sub-B: session ping transport. Best-effort; we don't queue
+ * pings the way we queue events because they fire on background and
+ * AsyncStorage writes during background can be killed by the OS. If
+ * the network's down, the ping is lost — the session counters tolerate
+ * this.
+ */
+export declare const sendSessionPing: (ingestUrl: string, token: string, ping: unknown) => Promise<void>;
 //# sourceMappingURL=transport.d.ts.map

package/lib/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAcrC,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,KAAG,IAUtC,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,IAEjC,CAAC;AAEF,eAAO,MAAM,KAAK,QAAa,OAAO,CAAC,IAAI,CAkB1C,CAAC;AA4FF,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,IAAI,CAatD,CAAC;AAEF,eAAO,MAAM,eAAe,QAAO,IAKlC,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,SAAS,KAAK,EAAY,CAAC"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAcrC,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,KAAG,IAUtC,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,IAEjC,CAAC;AAEF,eAAO,MAAM,KAAK,QAAa,OAAO,CAAC,IAAI,CAkB1C,CAAC;AA4FF,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,IAAI,CAatD,CAAC;AAEF,eAAO,MAAM,eAAe,QAAO,IAKlC,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,SAAS,KAAK,EAAY,CAAC;AAE1D;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,MAAM,EACjB,OAAO,MAAM,EACb,MAAM,OAAO,KACZ,OAAO,CAAC,IAAI,CAcd,CAAC"}

package/lib/transport.js

@@ -140,4 +140,27 @@ export const __resetForTests = () => {
     _started = false;
 };
 export const __peekQueue = () => _queue;
+/**
+ * Phase 26 sub-B: session ping transport. Best-effort; we don't queue
+ * pings the way we queue events because they fire on background and
+ * AsyncStorage writes during background can be killed by the OS. If
+ * the network's down, the ping is lost — the session counters tolerate
+ * this.
+ */
+export const sendSessionPing = async (ingestUrl, token, ping) => {
+    try {
+        await fetch(`${ingestUrl}/v1/sessions`, {
+            body: JSON.stringify(ping),
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'Content-Type': 'application/json',
+                'Sentori-Sdk': `react-native/${SDK_VERSION}`,
+            },
+            method: 'POST',
+        });
+    }
+    catch {
+        // best-effort
+    }
+};
 //# sourceMappingURL=transport.js.map

package/lib/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@goliapkg/sentori-react-native",
-  "version": "0.3.0",
-  "description": "Sentori SDK for React Native \u2014 JS-layer error capture, native crash handlers (iOS / Android), batched transport.",
+  "version": "0.4.0",
+  "description": "Sentori SDK for React Native — JS-layer error capture, native crash handlers (iOS / Android), batched transport.",
   "license": "MIT",
   "homepage": "https://sentori.golia.jp",
   "repository": {

package/src/capture.ts

@@ -1,5 +1,6 @@
 import { getConfig, isInitialized } from './config';
 import { getBreadcrumbs } from './breadcrumbs';
+import { markSessionErrored } from './session-tracker';
 import { parseStack } from './stack';
 import { enqueue } from './transport';
 import { uuidV7 } from './uuid';
@@ -52,6 +53,9 @@ export const captureError = (error: Error, extras?: CaptureExtras): void => {
     fingerprint: extras?.fingerprint,
   };
 
+  // Phase 26 sub-B: a captured error promotes the current session to
+  // `errored` so the next AppState=background ping reports unhealthy.
+  markSessionErrored();
   enqueue(event);
 };
 

package/src/handlers/lifecycle.ts

@@ -0,0 +1,54 @@
+/**
+ * Phase 26 sub-B: AppState binding.
+ *
+ * Subscribes to AppState transitions:
+ *   - active → start a fresh session (after a previous background end)
+ *   - background / inactive → end the current session
+ *
+ * RN's AppState fires `inactive` on iOS during multitasking peek; we
+ * end on it because that's effectively a background and the user may
+ * not return. If they do, `active` starts a new one — the on-the-wire
+ * session count goes up by one, which matches "the user opened the app
+ * twice". Sentry historically did the opposite (treat inactive as
+ * still alive), but that lets a swiped-away session never end.
+ */
+import { endSession, startSession } from '../session-tracker';
+
+let _installed = false;
+let _subscription: { remove: () => void } | null = null;
+
+type AppStateLike = {
+  addEventListener: (
+    event: 'change',
+    handler: (state: string) => void
+  ) => { remove: () => void };
+};
+
+export const installLifecycleHandler = (): void => {
+  if (_installed) return;
+  _installed = true;
+  let AppState: AppStateLike | undefined;
+  try {
+    // RN ships AppState; in test / non-RN host the require throws and
+    // we silently no-op.
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    AppState = (require('react-native') as { AppState?: AppStateLike }).AppState;
+  } catch {
+    return;
+  }
+  if (!AppState || typeof AppState.addEventListener !== 'function') return;
+
+  _subscription = AppState.addEventListener('change', (state) => {
+    if (state === 'active') {
+      startSession();
+    } else if (state === 'background' || state === 'inactive') {
+      endSession();
+    }
+  });
+};
+
+export const __uninstallLifecycleForTests = (): void => {
+  _subscription?.remove();
+  _subscription = null;
+  _installed = false;
+};

package/src/index.ts

@@ -2,6 +2,11 @@ import { init } from './init';
 import { addBreadcrumb } from './breadcrumbs';
 import { setUser, getUser, captureError, captureException } from './capture';
 import { ErrorBoundary } from './error-boundary';
+import {
+  endSession,
+  markSessionCrashed,
+  startSession,
+} from './session-tracker';
 
 export const sentori = {
   init,
@@ -11,6 +16,9 @@ export const sentori = {
   captureError,
   captureException,
   ErrorBoundary,
+  startSession,
+  endSession,
+  markSessionCrashed,
 };
 
 export default sentori;
@@ -24,6 +32,11 @@ export {
   stopAnrWatchdog,
   triggerNativeCrash,
 } from './native';
+export {
+  endSession,
+  markSessionCrashed,
+  startSession,
+} from './session-tracker';
 
 export type {
   Event,

package/src/native.ts

@@ -12,10 +12,12 @@ type SentoriNativeModule = {
     token: string
   }) => void
   /**
-   * Phase 22 sub-D: opt-in Android ANR watchdog. Posts a tick to the
-   * main looper every `intervalMs`; if not acknowledged within
-   * `timeoutMs`, captures the main-thread stack as an `anr` event.
-   * No-op on iOS today — iOS hang detection lands in sub-E.
+   * Phase 22 sub-D / sub-E: cross-platform main-thread watchdog.
+   * Android: 5 s / 1 s defaults (matches the OS ANR threshold).
+   * iOS: 2 s / 1 s (more aggressive — iOS has no system-level
+   * watchdog signal we can lean on, so we surface stutter Apple's
+   * own runtime never flags).
+   * Reports a `kind = "anr"` event when the main thread is wedged.
    */
   startAnrWatchdog?: (options?: {
     force?: boolean
@@ -83,14 +85,15 @@ export function triggerNativeCrash(): void {
 }
 
 /**
- * Phase 22 sub-D: start the Android ANR watchdog.
+ * Phase 22 sub-D / sub-E: cross-platform main-thread watchdog.
+ * Single JS call covers both Android ANR and iOS hang detection.
  *
- *     startAnrWatchdog()                       // default 5s/1s, prod-only
+ *     startAnrWatchdog()                       // platform defaults, prod-only
  *     startAnrWatchdog({ force: true })        // include debug builds
  *     startAnrWatchdog({ timeoutMs: 3000 })    // tighter threshold
  *
- * Returns silently on iOS / web / jest. iOS hang detection (sub-E)
- * will hook the same JS function once landed.
+ * Defaults: Android 5 s / 1 s tick; iOS 2 s / 1 s tick. Returns
+ * silently on web / jest / unsupported runtimes.
  */
 export function startAnrWatchdog(options?: {
   force?: boolean

package/src/session-tracker.ts

@@ -0,0 +1,53 @@
+/**
+ * Phase 26 sub-B: RN session tracker glue.
+ *
+ * Mirrors the JS SDK's session-tracker but sends through the RN
+ * transport. AppState binding lives in `handlers/lifecycle.ts`; this
+ * file is just the singleton + the start/end/markErrored/markCrashed
+ * surface.
+ */
+import { SessionTracker } from '@goliapkg/sentori-core';
+
+import { getConfig } from './config';
+import { getUser } from './capture';
+import { sendSessionPing } from './transport';
+
+let _tracker: null | SessionTracker = null;
+
+const tracker = (): SessionTracker => {
+  if (_tracker) return _tracker;
+  _tracker = new SessionTracker((ping) => {
+    const cfg = getConfig();
+    if (!cfg) return;
+    void sendSessionPing(cfg.ingestUrl, cfg.token, ping);
+  });
+  return _tracker;
+};
+
+export const startSession = (): void => {
+  const cfg = getConfig();
+  if (!cfg) return;
+  const user = getUser();
+  tracker().start({
+    environment: cfg.environment,
+    release: cfg.release,
+    userId: user?.id ?? null,
+  });
+};
+
+export const endSession = (status?: 'exited'): void => {
+  if (!_tracker) return;
+  _tracker.end(status);
+};
+
+export const markSessionErrored = (): void => {
+  _tracker?.markErrored();
+};
+
+export const markSessionCrashed = (): void => {
+  _tracker?.markCrashed();
+};
+
+export const __resetSessionForTests = (): void => {
+  _tracker = null;
+};

package/src/transport.ts

@@ -162,3 +162,30 @@ export const __resetForTests = (): void => {
 };
 
 export const __peekQueue = (): readonly Event[] => _queue;
+
+/**
+ * Phase 26 sub-B: session ping transport. Best-effort; we don't queue
+ * pings the way we queue events because they fire on background and
+ * AsyncStorage writes during background can be killed by the OS. If
+ * the network's down, the ping is lost — the session counters tolerate
+ * this.
+ */
+export const sendSessionPing = async (
+  ingestUrl: string,
+  token: string,
+  ping: unknown
+): Promise<void> => {
+  try {
+    await fetch(`${ingestUrl}/v1/sessions`, {
+      body: JSON.stringify(ping),
+      headers: {
+        Authorization: `Bearer ${token}`,
+        'Content-Type': 'application/json',
+        'Sentori-Sdk': `react-native/${SDK_VERSION}`,
+      },
+      method: 'POST',
+    });
+  } catch {
+    // best-effort
+  }
+};