@okint-digital/okint-rn-storage 0.7.0 → 0.7.1

package/README.md

@@ -144,6 +144,14 @@ feature flags, hot-path UI state — use `createSyncStorage`:
   It installs lazily on first use and throws a clear error under remote JS
   debugging (no JSI runtime) — fall back to `createSyncStorageSync` there.
 
+  > **Opt-in native build.** The C++/JSI engine needs the NDK + CMake + the
+  > `ReactAndroid::jsi` prefab, so it's **off by default** — the package builds
+  > as pure Kotlin/Java and every other store works without it. Enable it on
+  > **Android** with `-PokintEnableJSI=true` (or `okintEnableJSI=true` in
+  > `android/gradle.properties`); on **iOS** it's always compiled in. When
+  > disabled, `createJSIStorage` reports the engine unavailable — use
+  > `createSyncStorageSync` (still synchronous, no NDK).
+
   Use `secure` for tokens — never a sync store.
 
 ## Compared to alternatives

package/android/build.gradle

@@ -11,6 +11,15 @@ def safeExtGet(prop, fallback) {
   rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
 }
 
+// The C++/JSI fast-path engine (createJSIStorage) needs the NDK + CMake + the
+// ReactAndroid::jsi prefab. It is OPT-IN: the default build ships pure
+// Kotlin/Java (secure/encrypted/sqlite/async + the bridge-based `fast` sync
+// store all work without it). Enable with -PokintEnableJSI=true (or
+// okintEnableJSI=true in gradle.properties). When disabled, System.loadLibrary
+// is a no-op (caught) and createJSIStorage reports the engine unavailable.
+def enableJSI = project.hasProperty("okintEnableJSI") &&
+  project.property("okintEnableJSI").toString().toBoolean()
+
 android {
   namespace "com.okint.rnstorage"
   compileSdkVersion safeExtGet("compileSdkVersion", 35)
@@ -19,21 +28,25 @@ android {
     minSdkVersion safeExtGet("minSdkVersion", 24)
     targetSdkVersion safeExtGet("targetSdkVersion", 35)
     consumerProguardFiles "proguard-rules.pro"
-    externalNativeBuild {
-      cmake {
-        cppFlags "-O2", "-frtti", "-fexceptions", "-std=c++17"
+    if (enableJSI) {
+      externalNativeBuild {
+        cmake {
+          cppFlags "-O2", "-frtti", "-fexceptions", "-std=c++17"
+        }
       }
     }
   }
 
-  // Consume React Native's prefab (JSI) for the C++ fast-path engine.
-  buildFeatures {
-    prefab true
-  }
+  if (enableJSI) {
+    // Consume React Native's prefab (JSI) for the C++ fast-path engine.
+    buildFeatures {
+      prefab true
+    }
 
-  externalNativeBuild {
-    cmake {
-      path "src/main/jni/CMakeLists.txt"
+    externalNativeBuild {
+      cmake {
+        path "src/main/jni/CMakeLists.txt"
+      }
     }
   }
 

package/android/src/main/java/com/okint/rnstorage/OkintRnStorageModule.kt

@@ -363,7 +363,8 @@ class OkintRnStorageModule(private val reactContext: ReactApplicationContext) :
    */
   @androidx.annotation.RequiresApi(Build.VERSION_CODES.P)
   private fun authenticate(cipher: Cipher, title: String, promise: Promise, onAuthed: (Cipher) -> String?) {
-    val activity = currentActivity
+    // The current Activity lives on the React context, not on the module base class.
+    val activity = reactContext.currentActivity
     if (activity == null) {
       promise.reject("E_OKINT_AUTH", "No foreground Activity to present the authentication prompt")
       return

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@okint-digital/okint-rn-storage",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Vanilla, pluggable React Native storage — one API over swappable backends: hardware Keystore/Keychain (secure), AES-encrypted blobs (encrypted), SQLite, SharedPreferences/UserDefaults (async), a synchronous fast store, or in-memory.",
   "keywords": [
     "react-native",