react-native-mmkv 4.0.0-beta.9 → 4.0.1

package/NitroMmkv.podspec

@@ -25,7 +25,15 @@ Pod::Spec.new do |s|
   # Add MMKV Core dependency
   s.compiler_flags = '-x objective-c++'
   s.libraries    = 'z', 'c++'
-  s.dependency 'MMKVCore', '>= 2.2.3'
+  s.dependency 'MMKVCore', '2.2.4'
+
+  # TODO: Remove when no one uses RN 0.79 anymore
+  # Add support for React Native 0.79 or below
+  s.pod_target_xcconfig = {
+    "HEADER_SEARCH_PATHS" => ["${PODS_ROOT}/RCT-Folly"],
+    "GCC_PREPROCESSOR_DEFINITIONS" => "$(inherited) FOLLY_NO_CONFIG FOLLY_CFG_NO_COROUTINES",
+    "OTHER_CPLUSPLUSFLAGS" => "$(inherited) -DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1"
+  }
 
   load 'nitrogen/generated/ios/NitroMmkv+autolinking.rb'
   add_nitrogen_files(s)

package/android/build.gradle

@@ -5,13 +5,13 @@ buildscript {
   }
 
   dependencies {
-    classpath "com.android.tools.build:gradle:8.12.1"
+    classpath "com.android.tools.build:gradle:8.13.0"
   }
 }
 
 def reactNativeArchitectures() {
   def value = rootProject.getProperties().get("reactNativeArchitectures")
-  return value ? value.split(",") : ["x86_64", "arm64-v8a"]
+  return value ? value.split(",") : ["x86", "x86_64", "armeabi-v7a", "arm64-v8a"]
 }
 
 def isNewArchitectureEnabled() {
@@ -139,6 +139,6 @@ dependencies {
   implementation project(":react-native-nitro-modules")
 
   // Add a dependency on mmkv core (this ships a C++ prefab)
-  implementation "com.tencent:mmkv-shared:2.2.3"
+  implementation "io.github.zhongwuzw:mmkv:2.2.4"
 }
 

package/cpp/HybridMMKV.cpp

@@ -55,6 +55,9 @@ HybridMMKV::HybridMMKV(const Configuration& config) : HybridObject(TAG) {
   }
 }
 
+std::string HybridMMKV::getId() {
+  return instance->mmapID();
+}
 double HybridMMKV::getSize() {
   return instance->actualSize();
 }
@@ -70,15 +73,33 @@ struct overloaded : Ts... {
 template <class... Ts>
 overloaded(Ts...) -> overloaded<Ts...>;
 
-void HybridMMKV::set(const std::string& key, const std::variant<std::string, double, bool, std::shared_ptr<ArrayBuffer>>& value) {
+void HybridMMKV::set(const std::string& key, const std::variant<bool, std::shared_ptr<ArrayBuffer>, std::string, double>& value) {
+  if (key.empty()) [[unlikely]] {
+    throw std::runtime_error("Cannot set a value for an empty key!");
+  }
+
   // Pattern-match each potential value in std::variant
-  std::visit(overloaded{[&](const std::string& string) { instance->set(string, key); }, [&](double number) { instance->set(number, key); },
-                        [&](bool b) { instance->set(b, key); },
-                        [&](const std::shared_ptr<ArrayBuffer>& buf) {
-                          MMBuffer buffer(buf->data(), buf->size(), MMBufferCopyFlag::MMBufferNoCopy);
-                          instance->set(std::move(buffer), key);
-                        }},
-             value);
+  bool didSet = std::visit(overloaded{[&](bool b) {
+                                        // boolean
+                                        return instance->set(b, key);
+                                      },
+                                      [&](const std::shared_ptr<ArrayBuffer>& buf) {
+                                        // ArrayBuffer
+                                        MMBuffer buffer(buf->data(), buf->size(), MMBufferCopyFlag::MMBufferNoCopy);
+                                        return instance->set(std::move(buffer), key);
+                                      },
+                                      [&](const std::string& string) {
+                                        // string
+                                        return instance->set(string, key);
+                                      },
+                                      [&](double number) {
+                                        // number
+                                        return instance->set(number, key);
+                                      }},
+                           value);
+  if (!didSet) {
+    throw std::runtime_error("Failed to set value for key \"" + key + "\"!");
+  }
 
   // Notify on changed
   MMKVValueChangedListenerRegistry::notifyOnValueChanged(instance->mmapID(), key);
@@ -130,13 +151,23 @@ bool HybridMMKV::contains(const std::string& key) {
   return instance->containsKey(key);
 }
 bool HybridMMKV::remove(const std::string& key) {
-  return instance->removeValueForKey(key);
+  bool wasRemoved = instance->removeValueForKey(key);
+  if (wasRemoved) {
+    // Notify on changed
+    MMKVValueChangedListenerRegistry::notifyOnValueChanged(instance->mmapID(), key);
+  }
+  return wasRemoved;
 }
 std::vector<std::string> HybridMMKV::getAllKeys() {
   return instance->allKeys();
 }
 void HybridMMKV::clearAll() {
+  auto keysBefore = getAllKeys();
   instance->clearAll();
+  for (const auto& key : keysBefore) {
+    // Notify on changed
+    MMKVValueChangedListenerRegistry::notifyOnValueChanged(instance->mmapID(), key);
+  }
 }
 void HybridMMKV::recrypt(const std::optional<std::string>& key) {
   bool successful = false;

package/cpp/HybridMMKV.hpp

@@ -19,12 +19,13 @@ public:
 
 public:
   // Properties
+  std::string getId() override;
   double getSize() override;
   bool getIsReadOnly() override;
 
 public:
   // Methods
-  void set(const std::string& key, const std::variant<std::string, double, bool, std::shared_ptr<ArrayBuffer>>& value) override;
+  void set(const std::string& key, const std::variant<bool, std::shared_ptr<ArrayBuffer>, std::string, double>& value) override;
   std::optional<bool> getBoolean(const std::string& key) override;
   std::optional<std::string> getString(const std::string& key) override;
   std::optional<double> getNumber(const std::string& key) override;

package/lib/createMMKV/createMMKV.js

@@ -2,13 +2,13 @@ import { NitroModules } from 'react-native-nitro-modules';
 import { Platform } from 'react-native';
 import { addMemoryWarningListener } from '../addMemoryWarningListener/addMemoryWarningListener';
 import { isTest } from '../isTest';
-import { createMockMMKV } from './createMMKV.mock';
+import { createMockMMKV } from './createMockMMKV';
 let factory;
 let platformContext;
 export function createMMKV(configuration) {
     if (isTest()) {
         // In a test environment, we mock the MMKV instance.
-        return createMockMMKV();
+        return createMockMMKV(configuration);
     }
     if (platformContext == null) {
         // Lazy-init the platform-context HybridObject

package/lib/createMMKV/createMMKV.web.d.ts

@@ -1,3 +1,3 @@
 import type { MMKV } from '../specs/MMKV.nitro';
 import type { Configuration } from '../specs/MMKVFactory.nitro';
-export declare function createMMKV(config: Configuration): MMKV;
+export declare function createMMKV(config?: Configuration): MMKV;

package/lib/createMMKV/createMMKV.web.js

@@ -12,7 +12,7 @@ const hasAccessToLocalStorage = () => {
 };
 const KEY_WILDCARD = '\\';
 const inMemoryStorage = new Map();
-export function createMMKV(config) {
+export function createMMKV(config = { id: 'mmkv.default' }) {
     if (config.encryptionKey != null) {
         throw new Error("MMKV: 'encryptionKey' is not supported on Web!");
     }
@@ -55,18 +55,34 @@ export function createMMKV(config) {
         }
         return `${keyPrefix}${key}`;
     };
+    const callListeners = (key) => {
+        listeners.forEach((l) => l(key));
+    };
     return {
+        id: config.id,
+        size: 0,
+        isReadOnly: false,
         clearAll: () => {
             const keys = Object.keys(storage());
             for (const key of keys) {
                 if (key.startsWith(keyPrefix)) {
                     storage().removeItem(key);
+                    callListeners(key);
                 }
             }
         },
-        remove: (key) => storage().removeItem(prefixedKey(key)) ?? false,
+        remove: (key) => {
+            storage().removeItem(prefixedKey(key));
+            const wasRemoved = storage().getItem(prefixedKey(key)) === null;
+            if (wasRemoved)
+                callListeners(key);
+            return wasRemoved;
+        },
         set: (key, value) => {
+            if (key === '')
+                throw new Error('Cannot set a value for an empty key!');
             storage().setItem(prefixedKey(key), value.toString());
+            callListeners(key);
         },
         getString: (key) => storage().getItem(prefixedKey(key)) ?? undefined,
         getNumber: (key) => {
@@ -97,8 +113,6 @@ export function createMMKV(config) {
         recrypt: () => {
             throw new Error('`recrypt(..)` is not supported on Web!');
         },
-        size: 0,
-        isReadOnly: false,
         trim: () => {
             // no-op
         },

package/lib/createMMKV/createMockMMKV.d.ts

@@ -0,0 +1,6 @@
+import type { MMKV } from '../specs/MMKV.nitro';
+import type { Configuration } from '../specs/MMKVFactory.nitro';
+/**
+ * Mock MMKV instance when used in a Jest/Test environment.
+ */
+export declare function createMockMMKV(config?: Configuration): MMKV;

package/lib/createMMKV/{createMMKV.mock.js → createMockMMKV.js}

@@ -1,7 +1,7 @@
 /**
  * Mock MMKV instance when used in a Jest/Test environment.
  */
-export function createMockMMKV() {
+export function createMockMMKV(config = { id: 'mmkv.default' }) {
     const storage = new Map();
     const listeners = new Set();
     const notifyListeners = (key) => {
@@ -10,6 +10,11 @@ export function createMockMMKV() {
         });
     };
     return {
+        id: config.id,
+        get size() {
+            return storage.size;
+        },
+        isReadOnly: false,
         clearAll: () => {
             const keysBefore = storage.keys();
             storage.clear();
@@ -26,6 +31,8 @@ export function createMockMMKV() {
             return deleted;
         },
         set: (key, value) => {
+            if (key === '')
+                throw new Error('Cannot set a value for an empty key!');
             storage.set(key, value);
             notifyListeners(key);
         },
@@ -50,10 +57,6 @@ export function createMockMMKV() {
         recrypt: () => {
             console.warn('Encryption is not supported in mocked MMKV instances!');
         },
-        get size() {
-            return storage.size;
-        },
-        isReadOnly: false,
         trim: () => {
             // no-op
         },

package/lib/specs/MMKV.nitro.d.ts

@@ -7,9 +7,23 @@ export interface MMKV extends HybridObject<{
     android: 'c++';
 }> {
     /**
-     * Set a value for the given `key`.
+     * Get the ID of this {@linkcode MMKV} instance.
+     */
+    readonly id: string;
+    /**
+     * Get the current total size of the storage, in bytes.
+     */
+    readonly size: number;
+    /**
+     * Returns whether this instance is in read-only mode or not.
+     * If this is `true`, you can only use "get"-functions.
+     */
+    readonly isReadOnly: boolean;
+    /**
+     * Set a {@linkcode value} for the given {@linkcode key}.
      *
-     * @throws an Error if the value cannot be set.
+     * @throws an Error if the {@linkcode key} is empty.
+     * @throws an Error if the {@linkcode value} cannot be set.
      */
     set(key: string, value: boolean | string | number | ArrayBuffer): void;
     /**
@@ -75,15 +89,6 @@ export interface MMKV extends HybridObject<{
      * In most applications, this is not needed at all.
      */
     trim(): void;
-    /**
-     * Get the current total size of the storage, in bytes.
-     */
-    readonly size: number;
-    /**
-     * Returns whether this instance is in read-only mode or not.
-     * If this is `true`, you can only use "get"-functions.
-     */
-    readonly isReadOnly: boolean;
     /**
      * Adds a value changed listener. The Listener will be called whenever any value
      * in this storage instance changes (set or delete).

package/nitrogen/generated/android/NitroMmkv+autolinking.cmake

@@ -13,6 +13,12 @@
 # include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/NitroMmkv+autolinking.cmake)
 # ```
 
+# Define a flag to check if we are building properly
+add_definitions(-DBUILDING_NITROMMKV_WITH_GENERATED_CMAKE_PROJECT)
+
+# Enable Raw Props parsing in react-native (for Nitro Views)
+add_definitions(-DRN_SERIALIZABLE_STATE)
+
 # Add all headers that were generated by Nitrogen
 include_directories(
   "../nitrogen/generated/shared/c++"
@@ -34,12 +40,9 @@ target_sources(
   ../nitrogen/generated/android/c++/JHybridMMKVPlatformContextSpec.cpp
 )
 
-# Define a flag to check if we are building properly
-add_definitions(-DBUILDING_NITROMMKV_WITH_GENERATED_CMAKE_PROJECT)
-
 # From node_modules/react-native/ReactAndroid/cmake-utils/folly-flags.cmake
 # Used in node_modules/react-native/ReactAndroid/cmake-utils/ReactNative-application.cmake
- target_compile_definitions(
+target_compile_definitions(
   NitroMmkv PRIVATE
   -DFOLLY_NO_CONFIG=1
   -DFOLLY_HAVE_CLOCK_GETTIME=1

package/nitrogen/generated/android/c++/JHybridMMKVPlatformContextSpec.cpp

@@ -34,6 +34,12 @@ namespace margelo::nitro::mmkv {
     method(_javaPart);
   }
 
+  std::string JHybridMMKVPlatformContextSpec::toString() {
+    static const auto method = javaClassStatic()->getMethod<jni::JString()>("toString");
+    auto javaString = method(_javaPart);
+    return javaString->toStdString();
+  }
+
   // Properties
   
 

package/nitrogen/generated/android/c++/JHybridMMKVPlatformContextSpec.hpp

@@ -41,6 +41,7 @@ namespace margelo::nitro::mmkv {
   public:
     size_t getExternalMemorySize() noexcept override;
     void dispose() noexcept override;
+    std::string toString() override;
 
   public:
     inline const jni::global_ref<JHybridMMKVPlatformContextSpec::javaobject>& getJavaPart() const noexcept {

package/nitrogen/generated/android/kotlin/com/margelo/nitro/mmkv/HybridMMKVPlatformContextSpec.kt

@@ -10,7 +10,7 @@ package com.margelo.nitro.mmkv
 import androidx.annotation.Keep
 import com.facebook.jni.HybridData
 import com.facebook.proguard.annotations.DoNotStrip
-import com.margelo.nitro.core.*
+import com.margelo.nitro.core.HybridObject
 
 /**
  * A Kotlin class representing the MMKVPlatformContext HybridObject.
@@ -36,6 +36,11 @@ abstract class HybridMMKVPlatformContextSpec: HybridObject() {
     super.updateNative(hybridData)
   }
 
+  // Default implementation of `HybridObject.toString()`
+  override fun toString(): String {
+    return "[HybridObject MMKVPlatformContext]"
+  }
+
   // Properties
   
 
@@ -51,6 +56,6 @@ abstract class HybridMMKVPlatformContextSpec: HybridObject() {
   private external fun initHybrid(): HybridData
 
   companion object {
-    private const val TAG = "HybridMMKVPlatformContextSpec"
+    protected const val TAG = "HybridMMKVPlatformContextSpec"
   }
 }

package/nitrogen/generated/ios/NitroMmkv-Swift-Cxx-Bridge.cpp

@@ -10,15 +10,16 @@
 // Include C++ implementation defined types
 #include "HybridMMKVPlatformContextSpecSwift.hpp"
 #include "NitroMmkv-Swift-Cxx-Umbrella.hpp"
+#include <NitroModules/NitroDefines.hpp>
 
 namespace margelo::nitro::mmkv::bridge::swift {
 
   // pragma MARK: std::shared_ptr<HybridMMKVPlatformContextSpec>
-  std::shared_ptr<HybridMMKVPlatformContextSpec> create_std__shared_ptr_HybridMMKVPlatformContextSpec_(void* _Nonnull swiftUnsafePointer) noexcept {
+  std::shared_ptr<HybridMMKVPlatformContextSpec> create_std__shared_ptr_HybridMMKVPlatformContextSpec_(void* NON_NULL swiftUnsafePointer) noexcept {
     NitroMmkv::HybridMMKVPlatformContextSpec_cxx swiftPart = NitroMmkv::HybridMMKVPlatformContextSpec_cxx::fromUnsafe(swiftUnsafePointer);
     return std::make_shared<margelo::nitro::mmkv::HybridMMKVPlatformContextSpecSwift>(swiftPart);
   }
-  void* _Nonnull get_std__shared_ptr_HybridMMKVPlatformContextSpec_(std__shared_ptr_HybridMMKVPlatformContextSpec_ cppType) noexcept {
+  void* NON_NULL get_std__shared_ptr_HybridMMKVPlatformContextSpec_(std__shared_ptr_HybridMMKVPlatformContextSpec_ cppType) {
     std::shared_ptr<margelo::nitro::mmkv::HybridMMKVPlatformContextSpecSwift> swiftWrapper = std::dynamic_pointer_cast<margelo::nitro::mmkv::HybridMMKVPlatformContextSpecSwift>(cppType);
     #ifdef NITRO_DEBUG
     if (swiftWrapper == nullptr) [[unlikely]] {

package/nitrogen/generated/ios/NitroMmkv-Swift-Cxx-Bridge.hpp

@@ -49,8 +49,8 @@ namespace margelo::nitro::mmkv::bridge::swift {
    * Specialized version of `std::shared_ptr<HybridMMKVPlatformContextSpec>`.
    */
   using std__shared_ptr_HybridMMKVPlatformContextSpec_ = std::shared_ptr<HybridMMKVPlatformContextSpec>;
-  std::shared_ptr<HybridMMKVPlatformContextSpec> create_std__shared_ptr_HybridMMKVPlatformContextSpec_(void* _Nonnull swiftUnsafePointer) noexcept;
-  void* _Nonnull get_std__shared_ptr_HybridMMKVPlatformContextSpec_(std__shared_ptr_HybridMMKVPlatformContextSpec_ cppType) noexcept;
+  std::shared_ptr<HybridMMKVPlatformContextSpec> create_std__shared_ptr_HybridMMKVPlatformContextSpec_(void* NON_NULL swiftUnsafePointer) noexcept;
+  void* NON_NULL get_std__shared_ptr_HybridMMKVPlatformContextSpec_(std__shared_ptr_HybridMMKVPlatformContextSpec_ cppType);
   
   // pragma MARK: std::weak_ptr<HybridMMKVPlatformContextSpec>
   using std__weak_ptr_HybridMMKVPlatformContextSpec_ = std::weak_ptr<HybridMMKVPlatformContextSpec>;

package/nitrogen/generated/ios/c++/HybridMMKVPlatformContextSpecSwift.hpp

@@ -51,6 +51,9 @@ namespace margelo::nitro::mmkv {
     void dispose() noexcept override {
       _swiftPart.dispose();
     }
+    std::string toString() override {
+      return _swiftPart.toString();
+    }
 
   public:
     // Properties

package/nitrogen/generated/ios/swift/HybridMMKVPlatformContextSpec.swift

@@ -18,6 +18,13 @@ public protocol HybridMMKVPlatformContextSpec_protocol: HybridObject {
   func getAppGroupDirectory() throws -> String?
 }
 
+public extension HybridMMKVPlatformContextSpec_protocol {
+  /// Default implementation of ``HybridObject.toString``
+  func toString() -> String {
+    return "[HybridObject MMKVPlatformContext]"
+  }
+}
+
 /// See ``HybridMMKVPlatformContextSpec``
 open class HybridMMKVPlatformContextSpec_base {
   private weak var cxxWrapper: HybridMMKVPlatformContextSpec_cxx? = nil

package/nitrogen/generated/ios/swift/HybridMMKVPlatformContextSpec_cxx.swift

@@ -76,7 +76,7 @@ open class HybridMMKVPlatformContextSpec_cxx {
    */
   public func getCxxPart() -> bridge.std__shared_ptr_HybridMMKVPlatformContextSpec_ {
     let cachedCxxPart = self.__cxxPart.lock()
-    if cachedCxxPart.__convertToBool() {
+    if Bool(fromCxx: cachedCxxPart) {
       return cachedCxxPart
     } else {
       let newCxxPart = bridge.create_std__shared_ptr_HybridMMKVPlatformContextSpec_(self.toUnsafe())
@@ -105,6 +105,14 @@ open class HybridMMKVPlatformContextSpec_cxx {
     self.__implementation.dispose()
   }
 
+  /**
+   * Call toString() on the Swift class.
+   */
+  @inline(__always)
+  public func toString() -> String {
+    return self.__implementation.toString()
+  }
+
   // Properties
   
 

package/nitrogen/generated/shared/c++/Configuration.hpp

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 // Forward declaration of `Mode` to properly resolve imports.
 namespace margelo::nitro::mmkv { enum class Mode; }
@@ -74,6 +79,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, "id"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "path"))) return false;
       if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, "encryptionKey"))) return false;

package/nitrogen/generated/shared/c++/HybridMMKVSpec.cpp

@@ -14,6 +14,7 @@ namespace margelo::nitro::mmkv {
     HybridObject::loadHybridMethods();
     // load custom methods/properties
     registerHybrids(this, [](Prototype& prototype) {
+      prototype.registerHybridGetter("id", &HybridMMKVSpec::getId);
       prototype.registerHybridGetter("size", &HybridMMKVSpec::getSize);
       prototype.registerHybridGetter("isReadOnly", &HybridMMKVSpec::getIsReadOnly);
       prototype.registerHybridMethod("set", &HybridMMKVSpec::set);

package/nitrogen/generated/shared/c++/HybridMMKVSpec.hpp

@@ -13,8 +13,6 @@
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
 
-// Forward declaration of `ArrayBuffer` to properly resolve imports.
-namespace NitroModules { class ArrayBuffer; }
 // Forward declaration of `Listener` to properly resolve imports.
 namespace margelo::nitro::mmkv { struct Listener; }
 
@@ -53,12 +51,13 @@ namespace margelo::nitro::mmkv {
 
     public:
       // Properties
+      virtual std::string getId() = 0;
       virtual double getSize() = 0;
       virtual bool getIsReadOnly() = 0;
 
     public:
       // Methods
-      virtual void set(const std::string& key, const std::variant<std::string, double, bool, std::shared_ptr<ArrayBuffer>>& value) = 0;
+      virtual void set(const std::string& key, const std::variant<bool, std::shared_ptr<ArrayBuffer>, std::string, double>& value) = 0;
       virtual std::optional<bool> getBoolean(const std::string& key) = 0;
       virtual std::optional<std::string> getString(const std::string& key) = 0;
       virtual std::optional<double> getNumber(const std::string& key) = 0;

package/nitrogen/generated/shared/c++/Listener.hpp

@@ -17,6 +17,11 @@
 #else
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
 
 
 
@@ -59,6 +64,9 @@ namespace margelo::nitro {
         return false;
       }
       jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
       if (!JSIConverter<std::function<void()>>::canConvert(runtime, obj.getProperty(runtime, "remove"))) return false;
       return true;
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "react-native-mmkv",
-  "version": "4.0.0-beta.9",
-  "description": "react-native-mmkv",
+  "version": "4.0.1",
+  "description": "⚡️ The fastest key/value storage for React Native.",
   "main": "lib/index",
   "module": "lib/index",
   "types": "lib/index.d.ts",
@@ -31,7 +31,6 @@
     "README.md"
   ],
   "scripts": {
-    "postinstall": "tsc || exit 0;",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf android/build node_modules/**/android/build lib",
     "lint": "eslint \"**/*.{js,ts,tsx}\" --fix",
@@ -61,18 +60,18 @@
   },
   "devDependencies": {
     "@expo/config-plugins": "^10.1.2",
-    "@react-native/eslint-config": "0.81.0",
+    "@react-native/eslint-config": "0.82.0",
     "@testing-library/react-native": "^13.3.1",
     "@types/jest": "^29.5.12",
     "@types/react": "^19.0.6",
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-prettier": "^5.2.1",
-    "nitrogen": "^0.29.4",
+    "nitrogen": "0.31.7",
     "prettier": "^3.3.3",
-    "react": "19.1.0",
-    "react-native": "0.81.0",
-    "react-native-nitro-modules": "^0.29.4",
+    "react": "19.1.1",
+    "react-native": "0.82.0",
+    "react-native-nitro-modules": "0.31.7",
     "typescript": "^5.8.3"
   },
   "peerDependencies": {

package/src/createMMKV/createMMKV.ts

@@ -5,7 +5,7 @@ import type { MMKVPlatformContext } from '../specs/MMKVPlatformContext.nitro'
 import { Platform } from 'react-native'
 import { addMemoryWarningListener } from '../addMemoryWarningListener/addMemoryWarningListener'
 import { isTest } from '../isTest'
-import { createMockMMKV } from './createMMKV.mock'
+import { createMockMMKV } from './createMockMMKV'
 
 let factory: MMKVFactory | undefined
 let platformContext: MMKVPlatformContext | undefined
@@ -13,7 +13,7 @@ let platformContext: MMKVPlatformContext | undefined
 export function createMMKV(configuration?: Configuration): MMKV {
   if (isTest()) {
     // In a test environment, we mock the MMKV instance.
-    return createMockMMKV()
+    return createMockMMKV(configuration)
   }
 
   if (platformContext == null) {

package/src/createMMKV/createMMKV.web.ts

@@ -19,7 +19,9 @@ const hasAccessToLocalStorage = () => {
 const KEY_WILDCARD = '\\'
 const inMemoryStorage = new Map<string, string>()
 
-export function createMMKV(config: Configuration): MMKV {
+export function createMMKV(
+  config: Configuration = { id: 'mmkv.default' }
+): MMKV {
   if (config.encryptionKey != null) {
     throw new Error("MMKV: 'encryptionKey' is not supported on Web!")
   }
@@ -78,18 +80,33 @@ export function createMMKV(config: Configuration): MMKV {
     return `${keyPrefix}${key}`
   }
 
+  const callListeners = (key: string) => {
+    listeners.forEach((l) => l(key))
+  }
+
   return {
+    id: config.id,
+    size: 0,
+    isReadOnly: false,
     clearAll: () => {
       const keys = Object.keys(storage())
       for (const key of keys) {
         if (key.startsWith(keyPrefix)) {
           storage().removeItem(key)
+          callListeners(key)
         }
       }
     },
-    remove: (key) => storage().removeItem(prefixedKey(key)) ?? false,
+    remove: (key) => {
+      storage().removeItem(prefixedKey(key))
+      const wasRemoved = storage().getItem(prefixedKey(key)) === null
+      if (wasRemoved) callListeners(key)
+      return wasRemoved
+    },
     set: (key, value) => {
+      if (key === '') throw new Error('Cannot set a value for an empty key!')
       storage().setItem(prefixedKey(key), value.toString())
+      callListeners(key)
     },
     getString: (key) => storage().getItem(prefixedKey(key)) ?? undefined,
     getNumber: (key) => {
@@ -117,8 +134,6 @@ export function createMMKV(config: Configuration): MMKV {
     recrypt: () => {
       throw new Error('`recrypt(..)` is not supported on Web!')
     },
-    size: 0,
-    isReadOnly: false,
     trim: () => {
       // no-op
     },

package/src/createMMKV/{createMMKV.mock.ts → createMockMMKV.ts}

@@ -1,9 +1,12 @@
 import type { MMKV } from '../specs/MMKV.nitro'
+import type { Configuration } from '../specs/MMKVFactory.nitro'
 
 /**
  * Mock MMKV instance when used in a Jest/Test environment.
  */
-export function createMockMMKV(): MMKV {
+export function createMockMMKV(
+  config: Configuration = { id: 'mmkv.default' }
+): MMKV {
   const storage = new Map<string, string | boolean | number | ArrayBuffer>()
   const listeners = new Set<(key: string) => void>()
 
@@ -14,6 +17,11 @@ export function createMockMMKV(): MMKV {
   }
 
   return {
+    id: config.id,
+    get size(): number {
+      return storage.size
+    },
+    isReadOnly: false,
     clearAll: () => {
       const keysBefore = storage.keys()
       storage.clear()
@@ -30,6 +38,7 @@ export function createMockMMKV(): MMKV {
       return deleted
     },
     set: (key, value) => {
+      if (key === '') throw new Error('Cannot set a value for an empty key!')
       storage.set(key, value)
       notifyListeners(key)
     },
@@ -54,10 +63,6 @@ export function createMockMMKV(): MMKV {
     recrypt: () => {
       console.warn('Encryption is not supported in mocked MMKV instances!')
     },
-    get size(): number {
-      return storage.size
-    },
-    isReadOnly: false,
     trim: () => {
       // no-op
     },

package/src/specs/MMKV.nitro.ts

@@ -6,9 +6,23 @@ export interface Listener {
 
 export interface MMKV extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
   /**
-   * Set a value for the given `key`.
+   * Get the ID of this {@linkcode MMKV} instance.
+   */
+  readonly id: string
+  /**
+   * Get the current total size of the storage, in bytes.
+   */
+  readonly size: number
+  /**
+   * Returns whether this instance is in read-only mode or not.
+   * If this is `true`, you can only use "get"-functions.
+   */
+  readonly isReadOnly: boolean
+  /**
+   * Set a {@linkcode value} for the given {@linkcode key}.
    *
-   * @throws an Error if the value cannot be set.
+   * @throws an Error if the {@linkcode key} is empty.
+   * @throws an Error if the {@linkcode value} cannot be set.
    */
   set(key: string, value: boolean | string | number | ArrayBuffer): void
   /**
@@ -74,15 +88,6 @@ export interface MMKV extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
    * In most applications, this is not needed at all.
    */
   trim(): void
-  /**
-   * Get the current total size of the storage, in bytes.
-   */
-  readonly size: number
-  /**
-   * Returns whether this instance is in read-only mode or not.
-   * If this is `true`, you can only use "get"-functions.
-   */
-  readonly isReadOnly: boolean
   /**
    * Adds a value changed listener. The Listener will be called whenever any value
    * in this storage instance changes (set or delete).

package/app.plugin.js

@@ -1 +0,0 @@
-module.exports = require('./lib/expo-plugin/withMMKV.cjs')

package/lib/createMMKV/createMMKV.mock.d.ts

@@ -1,5 +0,0 @@
-import type { MMKV } from '../specs/MMKV.nitro';
-/**
- * Mock MMKV instance when used in a Jest/Test environment.
- */
-export declare function createMockMMKV(): MMKV;

package/lib/expo-plugin/withMMKV.cjs

@@ -1,26 +0,0 @@
-"use strict";
-const { createRunOncePlugin, withGradleProperties } = require('@expo/config-plugins');
-const pkg = require('../../package.json');
-const withMMKV = (config) => {
-    // remove 32-bit architectures from gradle.properties
-    return withGradleProperties(config, (cfg) => {
-        // Define the wanted property
-        const property = {
-            type: 'property',
-            key: 'reactNativeArchitectures',
-            value: 'arm64-v8a,x86_64',
-        };
-        // If it exists, update its value
-        const index = cfg.modResults.findIndex((p) => p.type === 'property' && p.key === property.key);
-        if (index !== -1) {
-            // Overwrite it
-            cfg.modResults[index] = property;
-        }
-        else {
-            // Append it
-            cfg.modResults.push(property);
-        }
-        return cfg;
-    });
-};
-module.exports = createRunOncePlugin(withMMKV, pkg.name, pkg.version);

package/lib/expo-plugin/withMMKV.d.cts

@@ -1,3 +0,0 @@
-import type { ConfigPlugin } from '@expo/config-plugins';
-declare const _default: ConfigPlugin<{}>;
-export = _default;

package/lib/expo-plugin/withMMKV.d.ts

@@ -1,3 +0,0 @@
-import type { ConfigPlugin } from '@expo/config-plugins';
-declare const _default: ConfigPlugin<{}>;
-export default _default;

package/lib/expo-plugin/withMMKV.js

@@ -1,17 +0,0 @@
-import { createRunOncePlugin, withGradleProperties } from '@expo/config-plugins';
-const pkg = require('../../package.json');
-const withMMKV = (config) => {
-    // remove 32-bit architectures from gradle.properties
-    return withGradleProperties(config, (cfg) => {
-        // Drop any existing entry…
-        cfg.modResults = cfg.modResults.filter((p) => !(p.type === 'property' && p.key === 'reactNativeArchitectures'));
-        // …and force 64-bit only.
-        cfg.modResults.push({
-            type: 'property',
-            key: 'reactNativeArchitectures',
-            value: 'arm64-v8a,x86_64',
-        });
-        return cfg;
-    });
-};
-export default createRunOncePlugin(withMMKV, pkg.name, pkg.version);

package/src/expo-plugin/withMMKV.cts

@@ -1,31 +0,0 @@
-import type { ConfigPlugin, ExportedConfigWithProps } from '@expo/config-plugins'
-const { createRunOncePlugin, withGradleProperties } = require('@expo/config-plugins')
-import type { Properties } from '@expo/config-plugins/build/android'
-
-const pkg = require('../../package.json')
-
-const withMMKV: ConfigPlugin<{}> = (config) => {
-  // remove 32-bit architectures from gradle.properties
-  return withGradleProperties(config, (cfg: ExportedConfigWithProps<Properties.PropertiesItem[]>) => {
-    // Define the wanted property
-    const property = {
-      type: 'property',
-      key: 'reactNativeArchitectures',
-      value: 'arm64-v8a,x86_64',
-    } as const
-    // If it exists, update its value
-    const index = cfg.modResults.findIndex(
-      (p) => p.type === 'property' && p.key === property.key
-    )
-    if (index !== -1) {
-      // Overwrite it
-      cfg.modResults[index] = property
-    } else {
-      // Append it
-      cfg.modResults.push(property)
-    }
-    return cfg
-  })
-}
-
-export = createRunOncePlugin(withMMKV, pkg.name, pkg.version) as ConfigPlugin<{}>