@scalebun/react-native 1.0.2 → 1.0.3

package/ios/ReplaySdk.swift

@@ -1,608 +1,608 @@
-import Foundation
-import UIKit
-
-/// Main ReplaySdk native module (RCTEventEmitter subclass).
-/// Method signatures are exported to React Native via RCT_EXTERN_MODULE /
-/// RCT_EXTERN_METHOD in ReplaySdkBridge.m; this class holds the implementations
-/// and emits events to JS through `sendEvent(withName:body:)`.
-@objc(ReplaySdk)
-class ReplaySdk: RCTEventEmitter {
-
-    private var sessionManager: SessionManager?
-    private var transport: ReplayTransport?
-    private let interactionTracker = InteractionTracker()
-    private var nativeOutbox: NativeOutbox?
-    private var outboxUploader: OutboxUploader?
-    private var outboxConfig: ReplayConfig?
-
-    /// Events this module can emit to JS. Must match the JS NativeEventEmitter
-    /// listener names (ScaleBunNativeInteraction drives high-confidence touch capture).
-    override func supportedEvents() -> [String]! {
-        return [
-            "ReplaySdk_SessionStateChanged", "ReplaySdk_FrameCaptured",
-            "ReplaySdk_UploadProgress", "ReplaySdk_UploadComplete",
-            "ReplaySdk_UploadFailed", "ReplaySdk_Error",
-            "ReplaySdk_SessionLimitReached", "ReplaySdk_ScreenChanged",
-            "ScaleBunNativeInteraction"
-        ]
-    }
-
-    @objc override static func requiresMainQueueSetup() -> Bool {
-        return false
-    }
-
-    /// Attach native touch tracking to the key window.
-    /// Called from initialize() after a short delay to ensure the window is ready.
-    private func activateNativeTracking() {
-        DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) { [weak self] in
-            guard let self = self else { return }
-            guard let window = Self.getKeyWindow() else {
-                ReplayLogger.warn("Native tracking: no key window available")
-                return
-            }
-            self.interactionTracker.attach(to: window, sendEvent: { [weak self] name, payload in
-                self?.sendEvent(withName: name, body: payload)
-            })
-        }
-    }
-
-    private static func getKeyWindow() -> UIWindow? {
-        return WindowResolver.keyWindow()
-    }
-
-    // ─── Lifecycle ──────────────────────────────────────────────────────
-
-    @objc func initialize(_ config: NSDictionary,
-                          resolve: @escaping RCTPromiseResolveBlock,
-                          reject: @escaping RCTPromiseRejectBlock) {
-        do {
-            let dict = config as? [String: Any] ?? [:]
-            let replayConfig = ReplayConfig(from: dict)
-            ReplayLogger.verbose = replayConfig.verboseLogging
-
-            sessionManager = SessionManager(config: replayConfig)
-            sessionManager?.onStateChanged = { [weak self] prev, next, sessionId in
-                self?.sendEvent(withName: "ReplaySdk_SessionStateChanged", body: [
-                    "sessionId": sessionId,
-                    "previousState": prev,
-                    "newState": next,
-                    "timestamp": Int(Date().timeIntervalSince1970 * 1000)
-                ])
-            }
-            sessionManager?.onFrameCaptured = { [weak self] frameId, sessionId, seq, screen, trigger, size in
-                self?.sendEvent(withName: "ReplaySdk_FrameCaptured", body: [
-                    "frameId": frameId,
-                    "sessionId": sessionId,
-                    "timestamp": Int(Date().timeIntervalSince1970 * 1000),
-                    "sequenceNumber": seq,
-                    "screenName": screen,
-                    "trigger": trigger,
-                    "sizeBytes": size
-                ])
-            }
-            sessionManager?.onLimitReached = { [weak self] limitType, current, max, sessionId in
-                self?.sendEvent(withName: "ReplaySdk_SessionLimitReached", body: [
-                    "sessionId": sessionId,
-                    "limitType": limitType,
-                    "currentValue": current,
-                    "maxValue": max
-                ])
-            }
-            // Forward screen changes to JS so the backend event stream gets SCREEN_VIEW events
-            sessionManager?.onScreenChanged = { [weak self] screenName in
-                self?.sendEvent(withName: "ReplaySdk_ScreenChanged", body: [
-                    "screenName": screenName,
-                    "timestamp": Int(Date().timeIntervalSince1970 * 1000)
-                ])
-            }
-
-            transport = ReplayTransport(endpoint: replayConfig.endpoint,
-                                        apiKey: replayConfig.apiKey,
-                                        maxRetries: replayConfig.maxRetryAttempts)
-
-            // Native file-based outbox (default-safe: only when explicitly enabled).
-            outboxConfig = replayConfig
-            if replayConfig.enableNativeFileOutbox {
-                let ob = NativeOutbox(maxBytes: Int64(replayConfig.outboxMaxBytes),
-                                      maxAgeMs: Int64(replayConfig.outboxMaxAgeMs))
-                nativeOutbox = ob
-                // startup recovery: requeue interrupted uploads, sweep orphans, drop
-                // committed frames that violate the mask policy (masked=false).
-                ob.recover(maskRequired: ReplaySdk.maskRequired(replayConfig))
-                if replayConfig.nativeOutboxUploadEnabled {
-                    let uploader = OutboxUploader(
-                        outbox: ob,
-                        apiBaseUrl: replayConfig.apiBaseUrl,
-                        clientKey: replayConfig.clientKey,
-                        useObjectStorageForFrames: replayConfig.useObjectStorageForFrames,
-                        maxUploadAttempts: replayConfig.outboxMaxUploadAttempts,
-                        retryIntervalMs: Int64(replayConfig.outboxRetryIntervalMs),
-                        poisonMaxAttempts: replayConfig.outboxPoisonMaxAttempts,
-                        respectRetryAfter: replayConfig.outboxRespectRetryAfter,
-                        strictThreeSecondRetry: replayConfig.outboxStrictThreeSecondRetry)
-                    outboxUploader = uploader
-                    uploader.flush()
-                }
-                ReplayLogger.info("Native file outbox enabled (upload=\(replayConfig.nativeOutboxUploadEnabled))")
-            }
-
-            ReplayLogger.info("Native module initialized")
-            self.activateNativeTracking()
-            resolve(true)
-        } catch {
-            reject("INIT_ERROR", error.localizedDescription, error)
-        }
-    }
-
-    @objc func startSession(_ resolve: @escaping RCTPromiseResolveBlock,
-                             reject: @escaping RCTPromiseRejectBlock) {
-        if let id = sessionManager?.startSession() {
-            resolve(id)
-        } else {
-            reject("SESSION_ERROR", "Failed to start session", nil)
-        }
-    }
-
-    @objc func stopSession(_ resolve: @escaping RCTPromiseResolveBlock,
-                            reject: @escaping RCTPromiseRejectBlock) {
-        resolve(sessionManager?.stopSession() ?? false)
-    }
-
-    @objc func pauseSession(_ resolve: @escaping RCTPromiseResolveBlock,
-                             reject: @escaping RCTPromiseRejectBlock) {
-        resolve(sessionManager?.pauseSession() ?? false)
-    }
-
-    @objc func resumeSession(_ resolve: @escaping RCTPromiseResolveBlock,
-                              reject: @escaping RCTPromiseRejectBlock) {
-        resolve(sessionManager?.resumeSession() ?? false)
-    }
-
-    // ─── Capture ────────────────────────────────────────────────────────
-
-    @objc func captureFrame(_ reason: String,
-                            resolve: @escaping RCTPromiseResolveBlock,
-                            reject: @escaping RCTPromiseRejectBlock) {
-        sessionManager?.captureFrame(trigger: reason) { frame in
-            if let frame = frame {
-                resolve([
-                    "base64": frame["base64"] as? String ?? "",
-                    "width": frame["width"] as? Int ?? 0,
-                    "height": frame["height"] as? Int ?? 0,
-                    "sizeBytes": frame["sizeBytes"] as? Int ?? 0,
-                    "format": frame["format"] as? String ?? "jpeg",
-                    "timestamp": frame["timestamp"] as? Int ?? 0
-                ])
-            } else {
-                resolve(NSNull())
-            }
-        } ?? resolve(NSNull())
-    }
-
-    @objc func captureManualFrame(_ resolve: @escaping RCTPromiseResolveBlock,
-                                   reject: @escaping RCTPromiseRejectBlock) {
-        captureFrame("manual", resolve: resolve, reject: reject)
-    }
-
-    /// Standalone screenshot capture — works WITHOUT session initialization.
-    /// Creates a temporary ScreenshotCaptureManager, captures, and destroys.
-    /// Used by scalebun-sdk's perfCaptureScreen command for performance screenshots.
-    @objc func captureScreenshot(_ reason: String,
-                                 resolve: @escaping RCTPromiseResolveBlock,
-                                 reject: @escaping RCTPromiseRejectBlock) {
-        let config = ReplayConfig(from: [:])
-        let captureManager = ScreenshotCaptureManager(config: config)
-        captureManager.capture(
-            sessionId: "standalone",
-            screenName: "unknown",
-            trigger: reason
-        ) { frame in
-            // captureManager is retained by this closure until completion
-            _ = captureManager // prevent premature dealloc
-            if let frame = frame {
-                resolve([
-                    "base64": frame["base64"] as? String ?? "",
-                    "width": frame["width"] as? Int ?? 0,
-                    "height": frame["height"] as? Int ?? 0,
-                    "sizeBytes": frame["sizeBytes"] as? Int ?? 0,
-                    "format": frame["format"] as? String ?? "jpeg",
-                    "timestamp": frame["timestamp"] as? Int ?? 0
-                ])
-            } else {
-                resolve(NSNull())
-            }
-        }
-    }
-
-    // ─── Native file outbox ─────────────────────────────────────────────
-
-    /// Lightweight outbox bootstrap for the SaaS path where the full native
-    /// `initialize()` (which builds a SessionManager) is never called. Constructs
-    /// ONLY the durable NativeOutbox + OutboxUploader from a minimal config map.
-    /// Whether the active masking policy requires masking (drives recover() orphan sweep).
-    static func maskRequired(_ c: ReplayConfig) -> Bool {
-        return c.maskTextInputs || c.maskImages || !c.maskedElementIds.isEmpty
-    }
-
-    /// Idempotent: a no-op once the outbox exists. Resolves false when the flag is
-    /// off or already initialized.
-    @objc func initOutbox(_ config: NSDictionary,
-                          resolve: @escaping RCTPromiseResolveBlock,
-                          reject: @escaping RCTPromiseRejectBlock) {
-        if nativeOutbox != nil { resolve(true); return }
-        let dict = config as? [String: Any] ?? [:]
-        let replayConfig = ReplayConfig(from: dict)
-        if !replayConfig.enableNativeFileOutbox { resolve(false); return }
-        outboxConfig = replayConfig
-        let ob = NativeOutbox(maxBytes: Int64(replayConfig.outboxMaxBytes),
-                              maxAgeMs: Int64(replayConfig.outboxMaxAgeMs))
-        nativeOutbox = ob
-        ob.recover(maskRequired: ReplaySdk.maskRequired(replayConfig))
-        if replayConfig.nativeOutboxUploadEnabled {
-            let uploader = OutboxUploader(
-                outbox: ob,
-                apiBaseUrl: replayConfig.apiBaseUrl,
-                clientKey: replayConfig.clientKey,
-                useObjectStorageForFrames: replayConfig.useObjectStorageForFrames,
-                maxUploadAttempts: replayConfig.outboxMaxUploadAttempts,
-                retryIntervalMs: Int64(replayConfig.outboxRetryIntervalMs),
-                poisonMaxAttempts: replayConfig.outboxPoisonMaxAttempts,
-                respectRetryAfter: replayConfig.outboxRespectRetryAfter,
-                strictThreeSecondRetry: replayConfig.outboxStrictThreeSecondRetry)
-            outboxUploader = uploader
-            uploader.flush()
-        }
-        ReplayLogger.info("Native file outbox bootstrapped (upload=\(replayConfig.nativeOutboxUploadEnabled))")
-        resolve(true)
-    }
-
-    /// Capture a screenshot to the durable native outbox. Returns metadata ONLY —
-    /// no base64 crosses the bridge. Resolves null on failure / when outbox disabled.
-    @objc func captureScreenshotToFile(_ input: NSDictionary,
-                                       resolve: @escaping RCTPromiseResolveBlock,
-                                       reject: @escaping RCTPromiseRejectBlock) {
-        guard let ob = nativeOutbox else {
-            reject("OUTBOX_DISABLED", "enableNativeFileOutbox is off", nil); return
-        }
-        let dict = input as? [String: Any] ?? [:]
-        guard let sessionId = dict["sessionId"] as? String, !sessionId.isEmpty else {
-            reject("OUTBOX_ARG", "sessionId required", nil); return
-        }
-        let screenName = dict["screenName"] as? String ?? "unknown"
-        let trigger = dict["trigger"] as? String ?? "manual"
-        let cfg = outboxConfig ?? ReplayConfig(from: [:])
-
-        ob.initSession(sessionId, screenName)
-        let cm = ScreenshotCaptureManager(config: cfg)
-        cm.captureToData(sessionId: sessionId, screenName: screenName, trigger: trigger) { frame, data in
-            _ = cm // retain until completion
-            guard let meta = frame, let bytes = data else { resolve(NSNull()); return }
-            let frameId = meta["frameId"] as? String ?? ""
-            let format = meta["format"] as? String ?? "jpeg"
-            // Stage IMAGE ONLY — JS (ReplayCaptureManager) decides keyframe/delta +
-            // change-detection, then calls commitOutboxFrame (writes meta) or
-            // discardOutboxFrame (suppressed). No metadata json is written here.
-            guard let localFile = ob.writeFrameImage(sessionId, frameId, format, bytes) else {
-                resolve(NSNull()); return
-            }
-            resolve([
-                "frameId": frameId,
-                "sessionId": sessionId,
-                "localPath": localFile,
-                "width": meta["width"] ?? 0,
-                "height": meta["height"] ?? 0,
-                "sizeBytes": meta["sizeBytes"] ?? 0,
-                "format": format,
-                "contentType": meta["contentType"] ?? "image/jpeg",
-                "timestamp": meta["timestamp"] ?? 0,
-                "screenName": screenName,
-                "trigger": trigger,
-                "masked": meta["masked"] ?? false,
-                // Cheap content hash so the JS change-detector works without base64.
-                "frameHash": ReplaySdk.fnv1a(bytes),
-            ])
-        }
-    }
-
-    /// Commit a staged frame: write metadata json carrying JS-authoritative
-    /// sequenceNumber/frameType/baseFrameId. Resolves the meta path or null.
-    @objc func commitOutboxFrame(_ input: NSDictionary,
-                                 resolve: @escaping RCTPromiseResolveBlock,
-                                 reject: @escaping RCTPromiseRejectBlock) {
-        guard let ob = nativeOutbox else { resolve(NSNull()); return }
-        let meta = (input as? [String: Any]) ?? [:]
-        guard let path = ob.commitFrame(meta) else { resolve(NSNull()); return }
-        outboxUploader?.flush()
-        resolve(path)
-    }
-
-    /// Discard a staged frame the JS orchestrator suppressed (no upload).
-    @objc func discardOutboxFrame(_ sessionId: String,
-                                  frameId: String,
-                                  resolve: @escaping RCTPromiseResolveBlock,
-                                  reject: @escaping RCTPromiseRejectBlock) {
-        nativeOutbox?.discardFrame(sessionId, frameId)
-        resolve(true)
-    }
-
-    /// Append non-frame telemetry records to the session's JSONL segment outbox.
-    /// Resolves false if the outbox is disabled (JS falls back to its own path).
-    @objc func enqueueOutboxRecords(_ lane: String,
-                                    sessionId: String,
-                                    records: NSArray,
-                                    resolve: @escaping RCTPromiseResolveBlock,
-                                    reject: @escaping RCTPromiseRejectBlock) {
-        guard let ob = nativeOutbox else { resolve(false); return }
-        if sessionId.isEmpty { resolve(false); return }
-        ob.initSession(sessionId, "unknown")
-        let list = (records as? [[String: Any]]) ?? []
-        ob.appendTelemetry(sessionId, lane, list, laneFlushCount(lane), 256 * 1024)
-        outboxUploader?.flush()
-        resolve(true)
-    }
-
-    @objc func flushNativeOutbox(_ resolve: @escaping RCTPromiseResolveBlock,
-                                 reject: @escaping RCTPromiseRejectBlock) {
-        guard let ob = nativeOutbox else { resolve(false); return }
-        for sid in ob.listSessionIds() { ob.closeAllOpenSegments(sid) }
-        outboxUploader?.flush()
-        resolve(true)
-    }
-
-    @objc func recoverNativeOutbox(_ resolve: @escaping RCTPromiseResolveBlock,
-                                   reject: @escaping RCTPromiseRejectBlock) {
-        nativeOutbox?.recover()
-        resolve(true)
-    }
-
-    @objc func getOutboxStats(_ resolve: @escaping RCTPromiseResolveBlock,
-                              reject: @escaping RCTPromiseRejectBlock) {
-        guard let ob = nativeOutbox else { resolve(NSNull()); return }
-        resolve([
-            "enabled": true,
-            "uploadEnabled": outboxUploader != nil,
-            "totalBytes": ob.totalBytes(),
-            "sessionCount": ob.listSessionIds().count,
-        ])
-    }
-
-    private func laneFlushCount(_ lane: String) -> Int {
-        switch lane {
-        case "events": return 30
-        case "logs": return 50
-        case "network": return 50
-        case "errors": return 20
-        case "performance": return 50
-        default: return 30
-        }
-    }
-
-    /// FNV-1a (32-bit) over sampled bytes — cheap content hash for JS change
-    /// detection. Samples large frames so cost stays O(1)-ish; folds in length.
-    static func fnv1a(_ data: Data) -> String {
-        var h: UInt32 = 0x811c9dc5
-        let len = data.count
-        let step = len > 4096 ? (len / 4096 + 1) : 1
-        var i = 0
-        while i < len {
-            h ^= UInt32(data[i])
-            h = h &* 0x01000193
-            i += step
-        }
-        return String(h, radix: 36) + "-" + String(len, radix: 36)
-    }
-
-    // ─── Voice notes (Slice D) ──────────────────────────────────────────
-
-    private static var voiceRecorder: VoiceRecorder?
-
-    @objc func startVoiceRecording(_ resolve: @escaping RCTPromiseResolveBlock,
-                                   reject: @escaping RCTPromiseRejectBlock) {
-        let recorder = VoiceRecorder()
-        Self.voiceRecorder = recorder
-        recorder.start { granted, err in
-            if granted {
-                resolve(NSNull())
-            } else {
-                Self.voiceRecorder = nil
-                reject("VOICE_START", err ?? "could not start recording", nil)
-            }
-        }
-    }
-
-    @objc func stopVoiceRecording(_ resolve: @escaping RCTPromiseResolveBlock,
-                                  reject: @escaping RCTPromiseRejectBlock) {
-        guard let recorder = Self.voiceRecorder else { resolve(NSNull()); return }
-        recorder.stop { clip in
-            Self.voiceRecorder = nil
-            guard let clip = clip else { resolve(NSNull()); return }
-            resolve([
-                "base64": clip.base64,
-                "mime": "audio/mp4",
-                "durationMs": clip.durationMs,
-                "byteSize": clip.byteSize,
-                "transcript": clip.transcript,
-                "transcriptAvailable": clip.transcriptAvailable,
-            ])
-        }
-    }
-
-    @objc func cancelVoiceRecording(_ resolve: @escaping RCTPromiseResolveBlock,
-                                    reject: @escaping RCTPromiseRejectBlock) {
-        Self.voiceRecorder?.cancel()
-        Self.voiceRecorder = nil
-        resolve(NSNull())
-    }
-
-    // ─── Configuration ──────────────────────────────────────────────────
-
-    @objc func setEnabled(_ enabled: Bool,
-                          resolve: @escaping RCTPromiseResolveBlock,
-                          reject: @escaping RCTPromiseRejectBlock) {
-        resolve(NSNull())
-    }
-
-    @objc func setCapturingMode(_ mode: String,
-                                resolve: @escaping RCTPromiseResolveBlock,
-                                reject: @escaping RCTPromiseRejectBlock) {
-        resolve(NSNull())
-    }
-
-    @objc func setScreenshotQuality(_ quality: String,
-                                    resolve: @escaping RCTPromiseResolveBlock,
-                                    reject: @escaping RCTPromiseRejectBlock) {
-        resolve(NSNull())
-    }
-
-    @objc func setScreenshotCaptureInterval(_ intervalMs: Double,
-                                            resolve: @escaping RCTPromiseResolveBlock,
-                                            reject: @escaping RCTPromiseRejectBlock) {
-        resolve(NSNull())
-    }
-
-    @objc func setUserStepsEnabled(_ enabled: Bool,
-                                   resolve: @escaping RCTPromiseResolveBlock,
-                                   reject: @escaping RCTPromiseRejectBlock) {
-        resolve(NSNull())
-    }
-
-    @objc func setNetworkLogsEnabled(_ enabled: Bool,
-                                     resolve: @escaping RCTPromiseResolveBlock,
-                                     reject: @escaping RCTPromiseRejectBlock) {
-        resolve(NSNull())
-    }
-
-    @objc func setSdkLogsEnabled(_ enabled: Bool,
-                                 resolve: @escaping RCTPromiseResolveBlock,
-                                 reject: @escaping RCTPromiseRejectBlock) {
-        resolve(NSNull())
-    }
-
-    // ─── Privacy ────────────────────────────────────────────────────────
-
-    @objc func setPrivacyOptions(_ options: NSDictionary,
-                                 resolve: @escaping RCTPromiseResolveBlock,
-                                 reject: @escaping RCTPromiseRejectBlock) {
-        resolve(NSNull())
-    }
-
-    @objc func maskElement(_ elementId: String,
-                           resolve: @escaping RCTPromiseResolveBlock,
-                           reject: @escaping RCTPromiseRejectBlock) {
-        resolve(NSNull())
-    }
-
-    @objc func unmaskElement(_ elementId: String,
-                             resolve: @escaping RCTPromiseResolveBlock,
-                             reject: @escaping RCTPromiseRejectBlock) {
-        resolve(NSNull())
-    }
-
-    // ─── User ───────────────────────────────────────────────────────────
-
-    @objc func setUser(_ user: NSDictionary,
-                       resolve: @escaping RCTPromiseResolveBlock,
-                       reject: @escaping RCTPromiseRejectBlock) {
-        resolve(NSNull())
-    }
-
-    @objc func clearUser(_ resolve: @escaping RCTPromiseResolveBlock,
-                         reject: @escaping RCTPromiseRejectBlock) {
-        resolve(NSNull())
-    }
-
-    // ─── Breadcrumbs ────────────────────────────────────────────────────
-
-    @objc func addBreadcrumb(_ breadcrumb: NSDictionary,
-                             resolve: @escaping RCTPromiseResolveBlock,
-                             reject: @escaping RCTPromiseRejectBlock) {
-        resolve(NSNull())
-    }
-
-    @objc func addNetworkBreadcrumb(_ request: NSDictionary,
-                                    resolve: @escaping RCTPromiseResolveBlock,
-                                    reject: @escaping RCTPromiseRejectBlock) {
-        resolve(NSNull())
-    }
-
-    // ─── Screen / Interaction ─────────────────────────────────────────
-
-    @objc func setCurrentScreen(_ screenName: String,
-                                resolve: @escaping RCTPromiseResolveBlock,
-                                reject: @escaping RCTPromiseRejectBlock) {
-        sessionManager?.setCurrentScreen(screenName)
-        resolve(NSNull())
-    }
-
-    @objc func reportInteraction(_ interaction: NSDictionary,
-                                 resolve: @escaping RCTPromiseResolveBlock,
-                                 reject: @escaping RCTPromiseRejectBlock) {
-        if sessionManager?.state == .recording {
-            let trigger = interaction["type"] as? String ?? "interaction"
-            sessionManager?.captureFrame(trigger: trigger) { _ in }
-        }
-        resolve(NSNull())
-    }
-
-    // ─── Query ──────────────────────────────────────────────────────────
-
-    @objc func getSessionInfo(_ resolve: @escaping RCTPromiseResolveBlock,
-                              reject: @escaping RCTPromiseRejectBlock) {
-        resolve(sessionManager?.getSessionInfo() as Any)
-    }
-
-    @objc func getDeviceInfo(_ resolve: @escaping RCTPromiseResolveBlock,
-                             reject: @escaping RCTPromiseRejectBlock) {
-        let device = UIDevice.current
-        let screen = UIScreen.main
-        let bundle = Bundle.main
-        resolve([
-            "platform": "ios",
-            "osVersion": device.systemVersion,
-            "deviceModel": device.model,
-            "screenWidth": Int(screen.bounds.width * screen.scale),
-            "screenHeight": Int(screen.bounds.height * screen.scale),
-            "pixelDensity": screen.scale,
-            "appName": bundle.object(forInfoDictionaryKey: "CFBundleDisplayName") as? String ?? "",
-            "appVersion": bundle.object(forInfoDictionaryKey: "CFBundleShortVersionString") as? String ?? "0.0.0",
-            "bundleId": bundle.bundleIdentifier ?? "",
-            "locale": Locale.current.identifier
-        ])
-    }
-
-    @objc func getSessionReplayLink(_ resolve: @escaping RCTPromiseResolveBlock,
-                                    reject: @escaping RCTPromiseRejectBlock) {
-        if let id = sessionManager?.sessionId {
-            resolve(["url": "", "sessionId": id, "uploaded": false])
-        } else {
-            resolve(NSNull())
-        }
-    }
-
-    // ─── Upload ─────────────────────────────────────────────────────────
-
-    @objc func flushUpload(_ resolve: @escaping RCTPromiseResolveBlock,
-                           reject: @escaping RCTPromiseRejectBlock) {
-        resolve(true)
-    }
-
-    @objc func cancelUpload(_ resolve: @escaping RCTPromiseResolveBlock,
-                            reject: @escaping RCTPromiseRejectBlock) {
-        resolve(NSNull())
-    }
-
-    // ─── Cleanup ────────────────────────────────────────────────────────
-
-    @objc func destroy(_ resolve: @escaping RCTPromiseResolveBlock,
-                       reject: @escaping RCTPromiseRejectBlock) {
-        interactionTracker.detach()
-        sessionManager?.destroy()
-        transport?.destroy()
-        sessionManager = nil
-        transport = nil
-        outboxUploader = nil
-        nativeOutbox = nil
-        ReplayLogger.info("Native module destroyed")
-        resolve(NSNull())
-    }
-}
+import Foundation
+import UIKit
+
+/// Main ReplaySdk native module (RCTEventEmitter subclass).
+/// Method signatures are exported to React Native via RCT_EXTERN_MODULE /
+/// RCT_EXTERN_METHOD in ReplaySdkBridge.m; this class holds the implementations
+/// and emits events to JS through `sendEvent(withName:body:)`.
+@objc(ReplaySdk)
+class ReplaySdk: RCTEventEmitter {
+
+    private var sessionManager: SessionManager?
+    private var transport: ReplayTransport?
+    private let interactionTracker = InteractionTracker()
+    private var nativeOutbox: NativeOutbox?
+    private var outboxUploader: OutboxUploader?
+    private var outboxConfig: ReplayConfig?
+
+    /// Events this module can emit to JS. Must match the JS NativeEventEmitter
+    /// listener names (ScaleBunNativeInteraction drives high-confidence touch capture).
+    override func supportedEvents() -> [String]! {
+        return [
+            "ReplaySdk_SessionStateChanged", "ReplaySdk_FrameCaptured",
+            "ReplaySdk_UploadProgress", "ReplaySdk_UploadComplete",
+            "ReplaySdk_UploadFailed", "ReplaySdk_Error",
+            "ReplaySdk_SessionLimitReached", "ReplaySdk_ScreenChanged",
+            "ScaleBunNativeInteraction"
+        ]
+    }
+
+    @objc override static func requiresMainQueueSetup() -> Bool {
+        return false
+    }
+
+    /// Attach native touch tracking to the key window.
+    /// Called from initialize() after a short delay to ensure the window is ready.
+    private func activateNativeTracking() {
+        DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) { [weak self] in
+            guard let self = self else { return }
+            guard let window = Self.getKeyWindow() else {
+                ReplayLogger.warn("Native tracking: no key window available")
+                return
+            }
+            self.interactionTracker.attach(to: window, sendEvent: { [weak self] name, payload in
+                self?.sendEvent(withName: name, body: payload)
+            })
+        }
+    }
+
+    private static func getKeyWindow() -> UIWindow? {
+        return WindowResolver.keyWindow()
+    }
+
+    // ─── Lifecycle ──────────────────────────────────────────────────────
+
+    @objc func initialize(_ config: NSDictionary,
+                          resolve: @escaping RCTPromiseResolveBlock,
+                          reject: @escaping RCTPromiseRejectBlock) {
+        do {
+            let dict = config as? [String: Any] ?? [:]
+            let replayConfig = ReplayConfig(from: dict)
+            ReplayLogger.verbose = replayConfig.verboseLogging
+
+            sessionManager = SessionManager(config: replayConfig)
+            sessionManager?.onStateChanged = { [weak self] prev, next, sessionId in
+                self?.sendEvent(withName: "ReplaySdk_SessionStateChanged", body: [
+                    "sessionId": sessionId,
+                    "previousState": prev,
+                    "newState": next,
+                    "timestamp": Int(Date().timeIntervalSince1970 * 1000)
+                ])
+            }
+            sessionManager?.onFrameCaptured = { [weak self] frameId, sessionId, seq, screen, trigger, size in
+                self?.sendEvent(withName: "ReplaySdk_FrameCaptured", body: [
+                    "frameId": frameId,
+                    "sessionId": sessionId,
+                    "timestamp": Int(Date().timeIntervalSince1970 * 1000),
+                    "sequenceNumber": seq,
+                    "screenName": screen,
+                    "trigger": trigger,
+                    "sizeBytes": size
+                ])
+            }
+            sessionManager?.onLimitReached = { [weak self] limitType, current, max, sessionId in
+                self?.sendEvent(withName: "ReplaySdk_SessionLimitReached", body: [
+                    "sessionId": sessionId,
+                    "limitType": limitType,
+                    "currentValue": current,
+                    "maxValue": max
+                ])
+            }
+            // Forward screen changes to JS so the backend event stream gets SCREEN_VIEW events
+            sessionManager?.onScreenChanged = { [weak self] screenName in
+                self?.sendEvent(withName: "ReplaySdk_ScreenChanged", body: [
+                    "screenName": screenName,
+                    "timestamp": Int(Date().timeIntervalSince1970 * 1000)
+                ])
+            }
+
+            transport = ReplayTransport(endpoint: replayConfig.endpoint,
+                                        apiKey: replayConfig.apiKey,
+                                        maxRetries: replayConfig.maxRetryAttempts)
+
+            // Native file-based outbox (default-safe: only when explicitly enabled).
+            outboxConfig = replayConfig
+            if replayConfig.enableNativeFileOutbox {
+                let ob = NativeOutbox(maxBytes: Int64(replayConfig.outboxMaxBytes),
+                                      maxAgeMs: Int64(replayConfig.outboxMaxAgeMs))
+                nativeOutbox = ob
+                // startup recovery: requeue interrupted uploads, sweep orphans, drop
+                // committed frames that violate the mask policy (masked=false).
+                ob.recover(maskRequired: ReplaySdk.maskRequired(replayConfig))
+                if replayConfig.nativeOutboxUploadEnabled {
+                    let uploader = OutboxUploader(
+                        outbox: ob,
+                        apiBaseUrl: replayConfig.apiBaseUrl,
+                        clientKey: replayConfig.clientKey,
+                        useObjectStorageForFrames: replayConfig.useObjectStorageForFrames,
+                        maxUploadAttempts: replayConfig.outboxMaxUploadAttempts,
+                        retryIntervalMs: Int64(replayConfig.outboxRetryIntervalMs),
+                        poisonMaxAttempts: replayConfig.outboxPoisonMaxAttempts,
+                        respectRetryAfter: replayConfig.outboxRespectRetryAfter,
+                        strictThreeSecondRetry: replayConfig.outboxStrictThreeSecondRetry)
+                    outboxUploader = uploader
+                    uploader.flush()
+                }
+                ReplayLogger.info("Native file outbox enabled (upload=\(replayConfig.nativeOutboxUploadEnabled))")
+            }
+
+            ReplayLogger.info("Native module initialized")
+            self.activateNativeTracking()
+            resolve(true)
+        } catch {
+            reject("INIT_ERROR", error.localizedDescription, error)
+        }
+    }
+
+    @objc func startSession(_ resolve: @escaping RCTPromiseResolveBlock,
+                             reject: @escaping RCTPromiseRejectBlock) {
+        if let id = sessionManager?.startSession() {
+            resolve(id)
+        } else {
+            reject("SESSION_ERROR", "Failed to start session", nil)
+        }
+    }
+
+    @objc func stopSession(_ resolve: @escaping RCTPromiseResolveBlock,
+                            reject: @escaping RCTPromiseRejectBlock) {
+        resolve(sessionManager?.stopSession() ?? false)
+    }
+
+    @objc func pauseSession(_ resolve: @escaping RCTPromiseResolveBlock,
+                             reject: @escaping RCTPromiseRejectBlock) {
+        resolve(sessionManager?.pauseSession() ?? false)
+    }
+
+    @objc func resumeSession(_ resolve: @escaping RCTPromiseResolveBlock,
+                              reject: @escaping RCTPromiseRejectBlock) {
+        resolve(sessionManager?.resumeSession() ?? false)
+    }
+
+    // ─── Capture ────────────────────────────────────────────────────────
+
+    @objc func captureFrame(_ reason: String,
+                            resolve: @escaping RCTPromiseResolveBlock,
+                            reject: @escaping RCTPromiseRejectBlock) {
+        sessionManager?.captureFrame(trigger: reason) { frame in
+            if let frame = frame {
+                resolve([
+                    "base64": frame["base64"] as? String ?? "",
+                    "width": frame["width"] as? Int ?? 0,
+                    "height": frame["height"] as? Int ?? 0,
+                    "sizeBytes": frame["sizeBytes"] as? Int ?? 0,
+                    "format": frame["format"] as? String ?? "jpeg",
+                    "timestamp": frame["timestamp"] as? Int ?? 0
+                ])
+            } else {
+                resolve(NSNull())
+            }
+        } ?? resolve(NSNull())
+    }
+
+    @objc func captureManualFrame(_ resolve: @escaping RCTPromiseResolveBlock,
+                                   reject: @escaping RCTPromiseRejectBlock) {
+        captureFrame("manual", resolve: resolve, reject: reject)
+    }
+
+    /// Standalone screenshot capture — works WITHOUT session initialization.
+    /// Creates a temporary ScreenshotCaptureManager, captures, and destroys.
+    /// Used by scalebun-sdk's perfCaptureScreen command for performance screenshots.
+    @objc func captureScreenshot(_ reason: String,
+                                 resolve: @escaping RCTPromiseResolveBlock,
+                                 reject: @escaping RCTPromiseRejectBlock) {
+        let config = ReplayConfig(from: [:])
+        let captureManager = ScreenshotCaptureManager(config: config)
+        captureManager.capture(
+            sessionId: "standalone",
+            screenName: "unknown",
+            trigger: reason
+        ) { frame in
+            // captureManager is retained by this closure until completion
+            _ = captureManager // prevent premature dealloc
+            if let frame = frame {
+                resolve([
+                    "base64": frame["base64"] as? String ?? "",
+                    "width": frame["width"] as? Int ?? 0,
+                    "height": frame["height"] as? Int ?? 0,
+                    "sizeBytes": frame["sizeBytes"] as? Int ?? 0,
+                    "format": frame["format"] as? String ?? "jpeg",
+                    "timestamp": frame["timestamp"] as? Int ?? 0
+                ])
+            } else {
+                resolve(NSNull())
+            }
+        }
+    }
+
+    // ─── Native file outbox ─────────────────────────────────────────────
+
+    /// Lightweight outbox bootstrap for the SaaS path where the full native
+    /// `initialize()` (which builds a SessionManager) is never called. Constructs
+    /// ONLY the durable NativeOutbox + OutboxUploader from a minimal config map.
+    /// Whether the active masking policy requires masking (drives recover() orphan sweep).
+    static func maskRequired(_ c: ReplayConfig) -> Bool {
+        return c.maskTextInputs || c.maskImages || !c.maskedElementIds.isEmpty
+    }
+
+    /// Idempotent: a no-op once the outbox exists. Resolves false when the flag is
+    /// off or already initialized.
+    @objc func initOutbox(_ config: NSDictionary,
+                          resolve: @escaping RCTPromiseResolveBlock,
+                          reject: @escaping RCTPromiseRejectBlock) {
+        if nativeOutbox != nil { resolve(true); return }
+        let dict = config as? [String: Any] ?? [:]
+        let replayConfig = ReplayConfig(from: dict)
+        if !replayConfig.enableNativeFileOutbox { resolve(false); return }
+        outboxConfig = replayConfig
+        let ob = NativeOutbox(maxBytes: Int64(replayConfig.outboxMaxBytes),
+                              maxAgeMs: Int64(replayConfig.outboxMaxAgeMs))
+        nativeOutbox = ob
+        ob.recover(maskRequired: ReplaySdk.maskRequired(replayConfig))
+        if replayConfig.nativeOutboxUploadEnabled {
+            let uploader = OutboxUploader(
+                outbox: ob,
+                apiBaseUrl: replayConfig.apiBaseUrl,
+                clientKey: replayConfig.clientKey,
+                useObjectStorageForFrames: replayConfig.useObjectStorageForFrames,
+                maxUploadAttempts: replayConfig.outboxMaxUploadAttempts,
+                retryIntervalMs: Int64(replayConfig.outboxRetryIntervalMs),
+                poisonMaxAttempts: replayConfig.outboxPoisonMaxAttempts,
+                respectRetryAfter: replayConfig.outboxRespectRetryAfter,
+                strictThreeSecondRetry: replayConfig.outboxStrictThreeSecondRetry)
+            outboxUploader = uploader
+            uploader.flush()
+        }
+        ReplayLogger.info("Native file outbox bootstrapped (upload=\(replayConfig.nativeOutboxUploadEnabled))")
+        resolve(true)
+    }
+
+    /// Capture a screenshot to the durable native outbox. Returns metadata ONLY —
+    /// no base64 crosses the bridge. Resolves null on failure / when outbox disabled.
+    @objc func captureScreenshotToFile(_ input: NSDictionary,
+                                       resolve: @escaping RCTPromiseResolveBlock,
+                                       reject: @escaping RCTPromiseRejectBlock) {
+        guard let ob = nativeOutbox else {
+            reject("OUTBOX_DISABLED", "enableNativeFileOutbox is off", nil); return
+        }
+        let dict = input as? [String: Any] ?? [:]
+        guard let sessionId = dict["sessionId"] as? String, !sessionId.isEmpty else {
+            reject("OUTBOX_ARG", "sessionId required", nil); return
+        }
+        let screenName = dict["screenName"] as? String ?? "unknown"
+        let trigger = dict["trigger"] as? String ?? "manual"
+        let cfg = outboxConfig ?? ReplayConfig(from: [:])
+
+        ob.initSession(sessionId, screenName)
+        let cm = ScreenshotCaptureManager(config: cfg)
+        cm.captureToData(sessionId: sessionId, screenName: screenName, trigger: trigger) { frame, data in
+            _ = cm // retain until completion
+            guard let meta = frame, let bytes = data else { resolve(NSNull()); return }
+            let frameId = meta["frameId"] as? String ?? ""
+            let format = meta["format"] as? String ?? "jpeg"
+            // Stage IMAGE ONLY — JS (ReplayCaptureManager) decides keyframe/delta +
+            // change-detection, then calls commitOutboxFrame (writes meta) or
+            // discardOutboxFrame (suppressed). No metadata json is written here.
+            guard let localFile = ob.writeFrameImage(sessionId, frameId, format, bytes) else {
+                resolve(NSNull()); return
+            }
+            resolve([
+                "frameId": frameId,
+                "sessionId": sessionId,
+                "localPath": localFile,
+                "width": meta["width"] ?? 0,
+                "height": meta["height"] ?? 0,
+                "sizeBytes": meta["sizeBytes"] ?? 0,
+                "format": format,
+                "contentType": meta["contentType"] ?? "image/jpeg",
+                "timestamp": meta["timestamp"] ?? 0,
+                "screenName": screenName,
+                "trigger": trigger,
+                "masked": meta["masked"] ?? false,
+                // Cheap content hash so the JS change-detector works without base64.
+                "frameHash": ReplaySdk.fnv1a(bytes),
+            ])
+        }
+    }
+
+    /// Commit a staged frame: write metadata json carrying JS-authoritative
+    /// sequenceNumber/frameType/baseFrameId. Resolves the meta path or null.
+    @objc func commitOutboxFrame(_ input: NSDictionary,
+                                 resolve: @escaping RCTPromiseResolveBlock,
+                                 reject: @escaping RCTPromiseRejectBlock) {
+        guard let ob = nativeOutbox else { resolve(NSNull()); return }
+        let meta = (input as? [String: Any]) ?? [:]
+        guard let path = ob.commitFrame(meta) else { resolve(NSNull()); return }
+        outboxUploader?.flush()
+        resolve(path)
+    }
+
+    /// Discard a staged frame the JS orchestrator suppressed (no upload).
+    @objc func discardOutboxFrame(_ sessionId: String,
+                                  frameId: String,
+                                  resolve: @escaping RCTPromiseResolveBlock,
+                                  reject: @escaping RCTPromiseRejectBlock) {
+        nativeOutbox?.discardFrame(sessionId, frameId)
+        resolve(true)
+    }
+
+    /// Append non-frame telemetry records to the session's JSONL segment outbox.
+    /// Resolves false if the outbox is disabled (JS falls back to its own path).
+    @objc func enqueueOutboxRecords(_ lane: String,
+                                    sessionId: String,
+                                    records: NSArray,
+                                    resolve: @escaping RCTPromiseResolveBlock,
+                                    reject: @escaping RCTPromiseRejectBlock) {
+        guard let ob = nativeOutbox else { resolve(false); return }
+        if sessionId.isEmpty { resolve(false); return }
+        ob.initSession(sessionId, "unknown")
+        let list = (records as? [[String: Any]]) ?? []
+        ob.appendTelemetry(sessionId, lane, list, laneFlushCount(lane), 256 * 1024)
+        outboxUploader?.flush()
+        resolve(true)
+    }
+
+    @objc func flushNativeOutbox(_ resolve: @escaping RCTPromiseResolveBlock,
+                                 reject: @escaping RCTPromiseRejectBlock) {
+        guard let ob = nativeOutbox else { resolve(false); return }
+        for sid in ob.listSessionIds() { ob.closeAllOpenSegments(sid) }
+        outboxUploader?.flush()
+        resolve(true)
+    }
+
+    @objc func recoverNativeOutbox(_ resolve: @escaping RCTPromiseResolveBlock,
+                                   reject: @escaping RCTPromiseRejectBlock) {
+        nativeOutbox?.recover()
+        resolve(true)
+    }
+
+    @objc func getOutboxStats(_ resolve: @escaping RCTPromiseResolveBlock,
+                              reject: @escaping RCTPromiseRejectBlock) {
+        guard let ob = nativeOutbox else { resolve(NSNull()); return }
+        resolve([
+            "enabled": true,
+            "uploadEnabled": outboxUploader != nil,
+            "totalBytes": ob.totalBytes(),
+            "sessionCount": ob.listSessionIds().count,
+        ])
+    }
+
+    private func laneFlushCount(_ lane: String) -> Int {
+        switch lane {
+        case "events": return 30
+        case "logs": return 50
+        case "network": return 50
+        case "errors": return 20
+        case "performance": return 50
+        default: return 30
+        }
+    }
+
+    /// FNV-1a (32-bit) over sampled bytes — cheap content hash for JS change
+    /// detection. Samples large frames so cost stays O(1)-ish; folds in length.
+    static func fnv1a(_ data: Data) -> String {
+        var h: UInt32 = 0x811c9dc5
+        let len = data.count
+        let step = len > 4096 ? (len / 4096 + 1) : 1
+        var i = 0
+        while i < len {
+            h ^= UInt32(data[i])
+            h = h &* 0x01000193
+            i += step
+        }
+        return String(h, radix: 36) + "-" + String(len, radix: 36)
+    }
+
+    // ─── Voice notes (Slice D) ──────────────────────────────────────────
+
+    private static var voiceRecorder: VoiceRecorder?
+
+    @objc func startVoiceRecording(_ resolve: @escaping RCTPromiseResolveBlock,
+                                   reject: @escaping RCTPromiseRejectBlock) {
+        let recorder = VoiceRecorder()
+        Self.voiceRecorder = recorder
+        recorder.start { granted, err in
+            if granted {
+                resolve(NSNull())
+            } else {
+                Self.voiceRecorder = nil
+                reject("VOICE_START", err ?? "could not start recording", nil)
+            }
+        }
+    }
+
+    @objc func stopVoiceRecording(_ resolve: @escaping RCTPromiseResolveBlock,
+                                  reject: @escaping RCTPromiseRejectBlock) {
+        guard let recorder = Self.voiceRecorder else { resolve(NSNull()); return }
+        recorder.stop { clip in
+            Self.voiceRecorder = nil
+            guard let clip = clip else { resolve(NSNull()); return }
+            resolve([
+                "base64": clip.base64,
+                "mime": "audio/mp4",
+                "durationMs": clip.durationMs,
+                "byteSize": clip.byteSize,
+                "transcript": clip.transcript,
+                "transcriptAvailable": clip.transcriptAvailable,
+            ])
+        }
+    }
+
+    @objc func cancelVoiceRecording(_ resolve: @escaping RCTPromiseResolveBlock,
+                                    reject: @escaping RCTPromiseRejectBlock) {
+        Self.voiceRecorder?.cancel()
+        Self.voiceRecorder = nil
+        resolve(NSNull())
+    }
+
+    // ─── Configuration ──────────────────────────────────────────────────
+
+    @objc func setEnabled(_ enabled: Bool,
+                          resolve: @escaping RCTPromiseResolveBlock,
+                          reject: @escaping RCTPromiseRejectBlock) {
+        resolve(NSNull())
+    }
+
+    @objc func setCapturingMode(_ mode: String,
+                                resolve: @escaping RCTPromiseResolveBlock,
+                                reject: @escaping RCTPromiseRejectBlock) {
+        resolve(NSNull())
+    }
+
+    @objc func setScreenshotQuality(_ quality: String,
+                                    resolve: @escaping RCTPromiseResolveBlock,
+                                    reject: @escaping RCTPromiseRejectBlock) {
+        resolve(NSNull())
+    }
+
+    @objc func setScreenshotCaptureInterval(_ intervalMs: Double,
+                                            resolve: @escaping RCTPromiseResolveBlock,
+                                            reject: @escaping RCTPromiseRejectBlock) {
+        resolve(NSNull())
+    }
+
+    @objc func setUserStepsEnabled(_ enabled: Bool,
+                                   resolve: @escaping RCTPromiseResolveBlock,
+                                   reject: @escaping RCTPromiseRejectBlock) {
+        resolve(NSNull())
+    }
+
+    @objc func setNetworkLogsEnabled(_ enabled: Bool,
+                                     resolve: @escaping RCTPromiseResolveBlock,
+                                     reject: @escaping RCTPromiseRejectBlock) {
+        resolve(NSNull())
+    }
+
+    @objc func setSdkLogsEnabled(_ enabled: Bool,
+                                 resolve: @escaping RCTPromiseResolveBlock,
+                                 reject: @escaping RCTPromiseRejectBlock) {
+        resolve(NSNull())
+    }
+
+    // ─── Privacy ────────────────────────────────────────────────────────
+
+    @objc func setPrivacyOptions(_ options: NSDictionary,
+                                 resolve: @escaping RCTPromiseResolveBlock,
+                                 reject: @escaping RCTPromiseRejectBlock) {
+        resolve(NSNull())
+    }
+
+    @objc func maskElement(_ elementId: String,
+                           resolve: @escaping RCTPromiseResolveBlock,
+                           reject: @escaping RCTPromiseRejectBlock) {
+        resolve(NSNull())
+    }
+
+    @objc func unmaskElement(_ elementId: String,
+                             resolve: @escaping RCTPromiseResolveBlock,
+                             reject: @escaping RCTPromiseRejectBlock) {
+        resolve(NSNull())
+    }
+
+    // ─── User ───────────────────────────────────────────────────────────
+
+    @objc func setUser(_ user: NSDictionary,
+                       resolve: @escaping RCTPromiseResolveBlock,
+                       reject: @escaping RCTPromiseRejectBlock) {
+        resolve(NSNull())
+    }
+
+    @objc func clearUser(_ resolve: @escaping RCTPromiseResolveBlock,
+                         reject: @escaping RCTPromiseRejectBlock) {
+        resolve(NSNull())
+    }
+
+    // ─── Breadcrumbs ────────────────────────────────────────────────────
+
+    @objc func addBreadcrumb(_ breadcrumb: NSDictionary,
+                             resolve: @escaping RCTPromiseResolveBlock,
+                             reject: @escaping RCTPromiseRejectBlock) {
+        resolve(NSNull())
+    }
+
+    @objc func addNetworkBreadcrumb(_ request: NSDictionary,
+                                    resolve: @escaping RCTPromiseResolveBlock,
+                                    reject: @escaping RCTPromiseRejectBlock) {
+        resolve(NSNull())
+    }
+
+    // ─── Screen / Interaction ─────────────────────────────────────────
+
+    @objc func setCurrentScreen(_ screenName: String,
+                                resolve: @escaping RCTPromiseResolveBlock,
+                                reject: @escaping RCTPromiseRejectBlock) {
+        sessionManager?.setCurrentScreen(screenName)
+        resolve(NSNull())
+    }
+
+    @objc func reportInteraction(_ interaction: NSDictionary,
+                                 resolve: @escaping RCTPromiseResolveBlock,
+                                 reject: @escaping RCTPromiseRejectBlock) {
+        if sessionManager?.state == .recording {
+            let trigger = interaction["type"] as? String ?? "interaction"
+            sessionManager?.captureFrame(trigger: trigger) { _ in }
+        }
+        resolve(NSNull())
+    }
+
+    // ─── Query ──────────────────────────────────────────────────────────
+
+    @objc func getSessionInfo(_ resolve: @escaping RCTPromiseResolveBlock,
+                              reject: @escaping RCTPromiseRejectBlock) {
+        resolve(sessionManager?.getSessionInfo() as Any)
+    }
+
+    @objc func getDeviceInfo(_ resolve: @escaping RCTPromiseResolveBlock,
+                             reject: @escaping RCTPromiseRejectBlock) {
+        let device = UIDevice.current
+        let screen = UIScreen.main
+        let bundle = Bundle.main
+        resolve([
+            "platform": "ios",
+            "osVersion": device.systemVersion,
+            "deviceModel": device.model,
+            "screenWidth": Int(screen.bounds.width * screen.scale),
+            "screenHeight": Int(screen.bounds.height * screen.scale),
+            "pixelDensity": screen.scale,
+            "appName": bundle.object(forInfoDictionaryKey: "CFBundleDisplayName") as? String ?? "",
+            "appVersion": bundle.object(forInfoDictionaryKey: "CFBundleShortVersionString") as? String ?? "0.0.0",
+            "bundleId": bundle.bundleIdentifier ?? "",
+            "locale": Locale.current.identifier
+        ])
+    }
+
+    @objc func getSessionReplayLink(_ resolve: @escaping RCTPromiseResolveBlock,
+                                    reject: @escaping RCTPromiseRejectBlock) {
+        if let id = sessionManager?.sessionId {
+            resolve(["url": "", "sessionId": id, "uploaded": false])
+        } else {
+            resolve(NSNull())
+        }
+    }
+
+    // ─── Upload ─────────────────────────────────────────────────────────
+
+    @objc func flushUpload(_ resolve: @escaping RCTPromiseResolveBlock,
+                           reject: @escaping RCTPromiseRejectBlock) {
+        resolve(true)
+    }
+
+    @objc func cancelUpload(_ resolve: @escaping RCTPromiseResolveBlock,
+                            reject: @escaping RCTPromiseRejectBlock) {
+        resolve(NSNull())
+    }
+
+    // ─── Cleanup ────────────────────────────────────────────────────────
+
+    @objc func destroy(_ resolve: @escaping RCTPromiseResolveBlock,
+                       reject: @escaping RCTPromiseRejectBlock) {
+        interactionTracker.detach()
+        sessionManager?.destroy()
+        transport?.destroy()
+        sessionManager = nil
+        transport = nil
+        outboxUploader = nil
+        nativeOutbox = nil
+        ReplayLogger.info("Native module destroyed")
+        resolve(NSNull())
+    }
+}