@lucida-analytics/react-native 0.0.0-stage → 0.1.0

package/ios/LucidaReplay.m

@@ -0,0 +1,10 @@
+#import <React/RCTBridgeModule.h>
+
+@interface RCT_EXTERN_MODULE (LucidaReplay, NSObject)
+RCT_EXTERN_METHOD(captureWireframe : (NSDictionary *)options resolver : (RCTPromiseResolveBlock)resolve rejecter : (RCTPromiseRejectBlock)reject)
+RCT_EXTERN_METHOD(installInfo : (RCTPromiseResolveBlock)resolve rejecter : (RCTPromiseRejectBlock)reject)
+// Blocking synchronous: the JS queue storage is synchronous (src/native-cipher.ts).
+RCT_EXTERN__BLOCKING_SYNCHRONOUS_METHOD(encryptQueue : (NSString *)plain)
+RCT_EXTERN__BLOCKING_SYNCHRONOUS_METHOD(decryptQueue : (NSString *)value)
+RCT_EXTERN__BLOCKING_SYNCHRONOUS_METHOD(encryptSensitive : (NSString *)pkcs1 n : (NSString *)n e : (NSString *)e plain : (NSString *)plain)
+@end

package/ios/LucidaReplay.swift

@@ -0,0 +1,61 @@
+import Foundation
+#if canImport(AdServices)
+import AdServices
+#endif
+import Lucida  // the Lucida iOS SDK (sdks/ios): ReplayBridge encodes the UIKit hierarchy
+
+/// React Native module `NativeModules.LucidaReplay`. Contract: see src/replay.ts (NativeReplayModule).
+/// Not compiled in this repository's CI (needs the React Native toolchain); the logic it calls
+/// (ReplayBridge, RRWebWireframe, UIKitViewHierarchy) is covered by `swift test` in sdks/ios.
+@objc(LucidaReplay)
+final class LucidaReplay: NSObject {
+    @objc static func requiresMainQueueSetup() -> Bool { false }
+
+    // Keychain-held AES-256-GCM key (generated on first use); same ciphertext format as the iOS SDK's queue cipher.
+    private let cipher = KeychainQueueCipher()
+
+    /// Blocking synchronous (see src/native-cipher.ts). Fails closed with "".
+    @objc(encryptQueue:)
+    func encryptQueue(_ plain: String) -> String { cipher.encrypt(plain) }
+
+    /// nil when the value cannot be decrypted (key lost or rotated); the queue then starts empty.
+    @objc(decryptQueue:)
+    func decryptQueue(_ value: String) -> String? { cipher.decrypt(value) }
+
+    /// Blocking synchronous (P-L12, src/sensitive.ts): RSA-OAEP-SHA256 with the PKCS#1 DER key; "" on failure.
+    @objc(encryptSensitive:n:e:plain:)
+    func encryptSensitive(_ pkcs1: String, n: String, e: String, plain: String) -> String {
+        ReplayBridge.encryptSensitive(pkcs1: pkcs1, n: n, e: e, plain: plain)
+    }
+
+    /// Install attribution (src/install.ts): resolves `{platform: "ios", token}`; token is NSNull when AdServices is unavailable.
+    @objc(installInfo:rejecter:)
+    func installInfo(_ resolve: @escaping (Any?) -> Void, rejecter reject: @escaping (String?, String?, Error?) -> Void) {
+        DispatchQueue.global(qos: .utility).async {
+            var token: String?
+            #if canImport(AdServices)
+            if #available(iOS 14.3, *) { token = try? AAAttribution.attributionToken() }
+            #endif
+            resolve(["platform": "ios", "token": token as Any])
+        }
+    }
+
+    /// Resolves the JSON text of one wireframe (or masked screenshot) capture, or "" when there is no key window.
+    @objc(captureWireframe:resolver:rejecter:)
+    func captureWireframe(_ options: NSDictionary, resolver resolve: @escaping (Any?) -> Void, rejecter reject: @escaping (String?, String?, Error?) -> Void) {
+        let screen = (options["screen"] as? String) ?? "Unknown"
+        let maskText = (options["maskText"] as? Bool) ?? true
+        let maskInputs = (options["maskAllTextInputs"] as? Bool) ?? true
+        let maskImages = (options["maskAllImages"] as? Bool) ?? true
+        let maskSandboxed = (options["maskSandboxedViews"] as? Bool) ?? true
+        // Screenshot mode: UIKitScreenshot paints the mask plan over the drawn window before JPEG encoding.
+        let quality: Double? = (options["mode"] as? String) == "screenshot" ? ((options["screenshotQuality"] as? Double) ?? 0.4) : nil
+        let maskScreen = (options["maskScreen"] as? Bool) ?? false  // P-M17
+        let patterns = (options["maskTextPatterns"] as? [String]) ?? []  // P-M46
+        // UIKitViewHierarchy hops to the main thread itself; this runs off it so the JS bridge never blocks.
+        DispatchQueue.global(qos: .utility).async {
+            resolve(ReplayBridge.capture(screen: screen, maskText: maskText, maskAllTextInputs: maskInputs, maskAllImages: maskImages, maskSandboxedViews: maskSandboxed,
+                                        screenshotQuality: quality, maskScreen: maskScreen, maskTextPatterns: patterns) ?? "")
+        }
+    }
+}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@lucida-analytics/react-native",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lucidaanalytics/lucida-js.git",
+    "directory": "packages/react-native"
+  },
+  "homepage": "https://github.com/lucidaanalytics/lucida-js/tree/main/packages/react-native",
+  "bugs": "https://github.com/lucidaanalytics/lucida-js/issues",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "ios",
+    "android"
+  ],
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "dependencies": {
+    "@lucida-analytics/sdk-core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "jsdom": "^26.1.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsup": "^8.5.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsgo --noEmit",
+    "test": "vitest run"
+  }
 }