react-native-mmkv 2.4.3 → 2.5.0

package/README.md

@@ -174,6 +174,14 @@ storage.recrypt('hunter2')
 storage.recrypt(undefined)
 ```
 
+### Buffers
+
+```js
+storage.set('someToken', new Uint8Array([1, 100, 255]))
+const buffer = storage.getBuffer('someToken')
+console.log(buffer) // [1, 100, 255]
+```
+
 ## Testing with Jest
 
 A mocked MMKV instance is automatically used when testing with Jest, so you will be able to use `new MMKV()` as per normal in your tests. Refer to [example/test/MMKV.test.ts](example/test/MMKV.test.ts) for an example.

package/android/CMakeLists.txt

@@ -7,6 +7,7 @@ add_subdirectory(../MMKV/Core core)
 
 include_directories(
         ../MMKV/Core
+        ../cpp
         "${NODE_MODULES_DIR}/react-native/React"
         "${NODE_MODULES_DIR}/react-native/React/Base"
         "${NODE_MODULES_DIR}/react-native/ReactCommon/jsi"
@@ -14,7 +15,7 @@ include_directories(
 
 if(${REACT_NATIVE_VERSION} LESS 66)
         file(
-                TO_CMAKE_PATH 
+                TO_CMAKE_PATH
                 "${NODE_MODULES_DIR}/react-native/ReactCommon/jsi/jsi/jsi.cpp"
                 INCLUDE_JSI_CPP
         )
@@ -24,6 +25,7 @@ add_library(reactnativemmkv  # <-- Library name
         SHARED
         src/main/cpp/cpp-adapter.cpp
         src/main/cpp/MmkvHostObject.cpp
+        ../cpp/TypedArray.cpp
         ${INCLUDE_JSI_CPP} # only on older RN versions
 )
 

package/android/build.gradle

@@ -179,8 +179,8 @@ dependencies {
 // mostly a copy of https://github.com/software-mansion/react-native-reanimated/blob/master/android/build.gradle#L115
 
 
-
-def downloadsDir = new File("$buildDir/downloads")
+def customDownloadsDir = System.getenv("REACT_NATIVE_DOWNLOADS_DIR")
+def downloadsDir = customDownloadsDir ? new File(customDownloadsDir) : new File("$buildDir/downloads")
 def thirdPartyNdkDir = new File("$buildDir/third-party-ndk")
 def thirdPartyVersionsFile = new File("${androidSourcesDir.toString()}/ReactAndroid/gradle.properties")
 def thirdPartyVersions = new Properties()
@@ -357,8 +357,12 @@ def nativeBuildDependsOn(dependsOnTask, variant) {
 
 afterEvaluate {
   if (sourceBuild) {
-    nativeBuildDependsOn(":ReactAndroid:packageReactNdkDebugLibsForBuck", "Debug")
-    nativeBuildDependsOn(":ReactAndroid:packageReactNdkReleaseLibsForBuck", "Rel")
+    if (REACT_NATIVE_VERSION < 68) {
+      nativeBuildDependsOn(":ReactAndroid:packageReactNdkLibsForBuck", null)
+    } else {
+      nativeBuildDependsOn(":ReactAndroid:packageReactNdkDebugLibsForBuck", "Debug")
+      nativeBuildDependsOn(":ReactAndroid:packageReactNdkReleaseLibsForBuck", "Rel")
+    }
   } else {
     nativeBuildDependsOn(extractAARHeaders, null)
     nativeBuildDependsOn(extractJNIFiles, null)

package/android/src/main/cpp/MmkvHostObject.cpp

@@ -7,9 +7,11 @@
 //
 
 #include "MmkvHostObject.h"
+#include "TypedArray.h"
 #include <MMKV.h>
 #include <android/log.h>
 #include <string>
+#include <vector>
 
 MmkvHostObject::MmkvHostObject(const std::string& instanceId, std::string path, std::string cryptKey) {
   __android_log_print(ANDROID_LOG_INFO, "RNMMKV", "Creating MMKV instance \"%s\"... (Path: %s, Encryption-Key: %s)",
@@ -65,16 +67,37 @@ jsi::Value MmkvHostObject::get(jsi::Runtime& runtime, const jsi::PropNameID& pro
       }
 
       auto keyName = arguments[0].getString(runtime).utf8(runtime);
+
       if (arguments[1].isBool()) {
+        // bool
         instance->set(arguments[1].getBool(), keyName);
       } else if (arguments[1].isNumber()) {
+        // number
         instance->set(arguments[1].getNumber(), keyName);
       } else if (arguments[1].isString()) {
+        // string
         auto stringValue = arguments[1].getString(runtime).utf8(runtime);
         instance->set(stringValue, keyName);
+      } else if (arguments[1].isObject()) {
+        // object
+        auto object = arguments[1].asObject(runtime);
+        if (isTypedArray(runtime, object)) {
+          // Uint8Array
+          auto typedArray = getTypedArray(runtime, object);
+          auto bufferValue = typedArray.getBuffer(runtime);
+          mmkv::MMBuffer buffer(bufferValue.data(runtime),
+                                bufferValue.size(runtime),
+                                mmkv::MMBufferCopyFlag::MMBufferNoCopy);
+          instance->set(buffer, keyName);
+        } else {
+          // unknown object
+          throw jsi::JSError(runtime, "MMKV::set: 'value' argument is an object, but not of type Uint8Array!");
+        }
       } else {
-        throw jsi::JSError(runtime, "MMKV::set: 'value' argument is not of type bool, number or string!");
+        // unknown type
+        throw jsi::JSError(runtime, "MMKV::set: 'value' argument is not of type bool, number, string or buffer!");
       }
+
       return jsi::Value::undefined();
     });
   }
@@ -151,6 +174,37 @@ jsi::Value MmkvHostObject::get(jsi::Runtime& runtime, const jsi::PropNameID& pro
     });
   }
 
+
+    if (propName == "getBuffer") {
+        // MMKV.getBuffer(key: string)
+        return jsi::Function::createFromHostFunction(runtime,
+                                                     jsi::PropNameID::forAscii(runtime, funcName),
+                                                     1,  // key
+                                                     [this](jsi::Runtime& runtime,
+                                                            const jsi::Value& thisValue,
+                                                            const jsi::Value* arguments,
+                                                            size_t count) -> jsi::Value {
+        if (!arguments[0].isString()) {
+          throw jsi::JSError(runtime, "First argument ('key') has to be of type string!");
+        }
+
+        auto keyName = arguments[0].getString(runtime).utf8(runtime);
+        mmkv::MMBuffer buffer;
+        bool hasValue = instance->getBytes(keyName, buffer);
+        if (hasValue) {
+          auto length = buffer.length();
+          TypedArray<TypedArrayKind::Uint8Array> array(runtime, length);
+          auto data = static_cast<const unsigned char*>(buffer.getPtr());
+          std::vector<unsigned char> vector(length);
+          vector.assign(data, data + length);
+          array.update(runtime, vector);
+          return array;
+        } else {
+          return jsi::Value::undefined();
+        }
+      });
+    }
+
   if (propName == "contains") {
     // MMKV.contains(key: string)
     return jsi::Function::createFromHostFunction(runtime,

package/cpp/TypedArray.cpp

@@ -0,0 +1,341 @@
+//
+//  TypedArray.cpp
+//  react-native-mmkv
+//
+//  Created by Marc Rousavy on 11.10.2022.
+//  Originally created by Expo (expo-gl)
+//
+
+#include "TypedArray.h"
+
+#include <unordered_map>
+
+template <TypedArrayKind T>
+using ContentType = typename typedArrayTypeMap<T>::type;
+
+enum class Prop
+{
+    Buffer,            // "buffer"
+    Constructor,       // "constructor"
+    Name,              // "name"
+    Proto,             // "__proto__"
+    Length,            // "length"
+    ByteLength,        // "byteLength"
+    ByteOffset,        // "offset"
+    IsView,            // "isView"
+    ArrayBuffer,       // "ArrayBuffer"
+    Int8Array,         // "Int8Array"
+    Int16Array,        // "Int16Array"
+    Int32Array,        // "Int32Array"
+    Uint8Array,        // "Uint8Array"
+    Uint8ClampedArray, // "Uint8ClampedArray"
+    Uint16Array,       // "Uint16Array"
+    Uint32Array,       // "Uint32Array"
+    Float32Array,      // "Float32Array"
+    Float64Array,      // "Float64Array"
+};
+
+class PropNameIDCache
+{
+public:
+    const jsi::PropNameID &get(jsi::Runtime &runtime, Prop prop)
+    {
+        if (!this->props[prop])
+        {
+            this->props[prop] = std::make_unique<jsi::PropNameID>(createProp(runtime, prop));
+        }
+        return *(this->props[prop]);
+    }
+
+    const jsi::PropNameID &getConstructorNameProp(jsi::Runtime &runtime, TypedArrayKind kind);
+
+    void invalidate()
+    {
+        props.erase(props.begin(), props.end());
+    }
+
+private:
+    std::unordered_map<Prop, std::unique_ptr<jsi::PropNameID>> props;
+
+    jsi::PropNameID createProp(jsi::Runtime &runtime, Prop prop);
+};
+
+PropNameIDCache propNameIDCache;
+
+void invalidateJsiPropNameIDCache()
+{
+    propNameIDCache.invalidate();
+}
+
+TypedArrayKind getTypedArrayKindForName(const std::string &name);
+
+TypedArrayBase::TypedArrayBase(jsi::Runtime &runtime, size_t size, TypedArrayKind kind)
+    : TypedArrayBase(
+          runtime,
+          runtime.global()
+              .getProperty(runtime, propNameIDCache.getConstructorNameProp(runtime, kind))
+              .asObject(runtime)
+              .asFunction(runtime)
+              .callAsConstructor(runtime, {static_cast<double>(size)})
+              .asObject(runtime)) {}
+
+TypedArrayBase::TypedArrayBase(jsi::Runtime &runtime, const jsi::Object &obj)
+    : jsi::Object(jsi::Value(runtime, obj).asObject(runtime)) {}
+
+TypedArrayKind TypedArrayBase::getKind(jsi::Runtime &runtime) const
+{
+    auto constructorName = this->getProperty(runtime, propNameIDCache.get(runtime, Prop::Constructor))
+                               .asObject(runtime)
+                               .getProperty(runtime, propNameIDCache.get(runtime, Prop::Name))
+                               .asString(runtime)
+                               .utf8(runtime);
+    return getTypedArrayKindForName(constructorName);
+};
+
+size_t TypedArrayBase::size(jsi::Runtime &runtime) const
+{
+    return getProperty(runtime, propNameIDCache.get(runtime, Prop::Length)).asNumber();
+}
+
+size_t TypedArrayBase::length(jsi::Runtime &runtime) const
+{
+    return getProperty(runtime, propNameIDCache.get(runtime, Prop::Length)).asNumber();
+}
+
+size_t TypedArrayBase::byteLength(jsi::Runtime &runtime) const
+{
+    return getProperty(runtime, propNameIDCache.get(runtime, Prop::ByteLength)).asNumber();
+}
+
+size_t TypedArrayBase::byteOffset(jsi::Runtime &runtime) const
+{
+    return getProperty(runtime, propNameIDCache.get(runtime, Prop::ByteOffset)).asNumber();
+}
+
+bool TypedArrayBase::hasBuffer(jsi::Runtime &runtime) const
+{
+    auto buffer = getProperty(runtime, propNameIDCache.get(runtime, Prop::Buffer));
+    return buffer.isObject() && buffer.asObject(runtime).isArrayBuffer(runtime);
+}
+
+std::vector<uint8_t> TypedArrayBase::toVector(jsi::Runtime &runtime)
+{
+    auto start =
+        reinterpret_cast<uint8_t *>(getBuffer(runtime).data(runtime) + byteOffset(runtime));
+    auto end = start + byteLength(runtime);
+    return std::vector<uint8_t>(start, end);
+}
+
+jsi::ArrayBuffer TypedArrayBase::getBuffer(jsi::Runtime &runtime) const
+{
+    auto buffer = getProperty(runtime, propNameIDCache.get(runtime, Prop::Buffer));
+    if (buffer.isObject() && buffer.asObject(runtime).isArrayBuffer(runtime))
+    {
+        return buffer.asObject(runtime).getArrayBuffer(runtime);
+    }
+    else
+    {
+        throw std::runtime_error("no ArrayBuffer attached");
+    }
+}
+
+bool isTypedArray(jsi::Runtime &runtime, const jsi::Object &jsObj)
+{
+    auto jsVal = runtime.global()
+                     .getProperty(runtime, propNameIDCache.get(runtime, Prop::ArrayBuffer))
+                     .asObject(runtime)
+                     .getProperty(runtime, propNameIDCache.get(runtime, Prop::IsView))
+                     .asObject(runtime)
+                     .asFunction(runtime)
+                     .callWithThis(runtime, runtime.global(), {jsi::Value(runtime, jsObj)});
+    if (jsVal.isBool())
+    {
+        return jsVal.getBool();
+    }
+    else
+    {
+        throw std::runtime_error("value is not a boolean");
+    }
+}
+
+TypedArrayBase getTypedArray(jsi::Runtime &runtime, const jsi::Object &jsObj)
+{
+    auto jsVal = runtime.global()
+                     .getProperty(runtime, propNameIDCache.get(runtime, Prop::ArrayBuffer))
+                     .asObject(runtime)
+                     .getProperty(runtime, propNameIDCache.get(runtime, Prop::IsView))
+                     .asObject(runtime)
+                     .asFunction(runtime)
+                     .callWithThis(runtime, runtime.global(), {jsi::Value(runtime, jsObj)});
+    if (jsVal.isBool())
+    {
+        return TypedArrayBase(runtime, jsObj);
+    }
+    else
+    {
+        throw std::runtime_error("value is not a boolean");
+    }
+}
+
+std::vector<uint8_t> arrayBufferToVector(jsi::Runtime &runtime, jsi::Object &jsObj)
+{
+    if (!jsObj.isArrayBuffer(runtime))
+    {
+        throw std::runtime_error("Object is not an ArrayBuffer");
+    }
+    auto jsArrayBuffer = jsObj.getArrayBuffer(runtime);
+
+    uint8_t *dataBlock = jsArrayBuffer.data(runtime);
+    size_t blockSize =
+        jsArrayBuffer.getProperty(runtime, propNameIDCache.get(runtime, Prop::ByteLength)).asNumber();
+    return std::vector<uint8_t>(dataBlock, dataBlock + blockSize);
+}
+
+void arrayBufferUpdate(
+    jsi::Runtime &runtime,
+    jsi::ArrayBuffer &buffer,
+    std::vector<uint8_t> data,
+    size_t offset)
+{
+    uint8_t *dataBlock = buffer.data(runtime);
+    size_t blockSize = buffer.size(runtime);
+    if (data.size() > blockSize)
+    {
+        throw jsi::JSError(runtime, "ArrayBuffer is to small to fit data");
+    }
+    std::copy(data.begin(), data.end(), dataBlock + offset);
+}
+
+template <TypedArrayKind T>
+TypedArray<T>::TypedArray(jsi::Runtime &runtime, size_t size) : TypedArrayBase(runtime, size, T){};
+
+template <TypedArrayKind T>
+TypedArray<T>::TypedArray(jsi::Runtime &runtime, std::vector<ContentType<T>> data)
+    : TypedArrayBase(runtime, data.size(), T)
+{
+    update(runtime, data);
+};
+
+template <TypedArrayKind T>
+TypedArray<T>::TypedArray(TypedArrayBase &&base) : TypedArrayBase(std::move(base)) {}
+
+template <TypedArrayKind T>
+std::vector<ContentType<T>> TypedArray<T>::toVector(jsi::Runtime &runtime)
+{
+    auto start =
+        reinterpret_cast<ContentType<T> *>(getBuffer(runtime).data(runtime) + byteOffset(runtime));
+    auto end = start + size(runtime);
+    return std::vector<ContentType<T>>(start, end);
+}
+
+template <TypedArrayKind T>
+void TypedArray<T>::update(jsi::Runtime &runtime, const std::vector<ContentType<T>> &data)
+{
+    if (data.size() != size(runtime))
+    {
+        throw jsi::JSError(runtime, "TypedArray can only be updated with a vector of the same size");
+    }
+    uint8_t *rawData = getBuffer(runtime).data(runtime) + byteOffset(runtime);
+    std::copy(data.begin(), data.end(), reinterpret_cast<ContentType<T> *>(rawData));
+}
+
+const jsi::PropNameID &PropNameIDCache::getConstructorNameProp(
+    jsi::Runtime &runtime,
+    TypedArrayKind kind)
+{
+    switch (kind)
+    {
+    case TypedArrayKind::Int8Array:
+        return get(runtime, Prop::Int8Array);
+    case TypedArrayKind::Int16Array:
+        return get(runtime, Prop::Int16Array);
+    case TypedArrayKind::Int32Array:
+        return get(runtime, Prop::Int32Array);
+    case TypedArrayKind::Uint8Array:
+        return get(runtime, Prop::Uint8Array);
+    case TypedArrayKind::Uint8ClampedArray:
+        return get(runtime, Prop::Uint8ClampedArray);
+    case TypedArrayKind::Uint16Array:
+        return get(runtime, Prop::Uint16Array);
+    case TypedArrayKind::Uint32Array:
+        return get(runtime, Prop::Uint32Array);
+    case TypedArrayKind::Float32Array:
+        return get(runtime, Prop::Float32Array);
+    case TypedArrayKind::Float64Array:
+        return get(runtime, Prop::Float64Array);
+    }
+}
+
+jsi::PropNameID PropNameIDCache::createProp(jsi::Runtime &runtime, Prop prop)
+{
+    auto create = [&](const std::string &propName)
+    {
+        return jsi::PropNameID::forUtf8(runtime, propName);
+    };
+    switch (prop)
+    {
+    case Prop::Buffer:
+        return create("buffer");
+    case Prop::Constructor:
+        return create("constructor");
+    case Prop::Name:
+        return create("name");
+    case Prop::Proto:
+        return create("__proto__");
+    case Prop::Length:
+        return create("length");
+    case Prop::ByteLength:
+        return create("byteLength");
+    case Prop::ByteOffset:
+        return create("byteOffset");
+    case Prop::IsView:
+        return create("isView");
+    case Prop::ArrayBuffer:
+        return create("ArrayBuffer");
+    case Prop::Int8Array:
+        return create("Int8Array");
+    case Prop::Int16Array:
+        return create("Int16Array");
+    case Prop::Int32Array:
+        return create("Int32Array");
+    case Prop::Uint8Array:
+        return create("Uint8Array");
+    case Prop::Uint8ClampedArray:
+        return create("Uint8ClampedArray");
+    case Prop::Uint16Array:
+        return create("Uint16Array");
+    case Prop::Uint32Array:
+        return create("Uint32Array");
+    case Prop::Float32Array:
+        return create("Float32Array");
+    case Prop::Float64Array:
+        return create("Float64Array");
+    }
+}
+
+std::unordered_map<std::string, TypedArrayKind> nameToKindMap = {
+    {"Int8Array", TypedArrayKind::Int8Array},
+    {"Int16Array", TypedArrayKind::Int16Array},
+    {"Int32Array", TypedArrayKind::Int32Array},
+    {"Uint8Array", TypedArrayKind::Uint8Array},
+    {"Uint8ClampedArray", TypedArrayKind::Uint8ClampedArray},
+    {"Uint16Array", TypedArrayKind::Uint16Array},
+    {"Uint32Array", TypedArrayKind::Uint32Array},
+    {"Float32Array", TypedArrayKind::Float32Array},
+    {"Float64Array", TypedArrayKind::Float64Array},
+};
+
+TypedArrayKind getTypedArrayKindForName(const std::string &name)
+{
+    return nameToKindMap.at(name);
+}
+
+template class TypedArray<TypedArrayKind::Int8Array>;
+template class TypedArray<TypedArrayKind::Int16Array>;
+template class TypedArray<TypedArrayKind::Int32Array>;
+template class TypedArray<TypedArrayKind::Uint8Array>;
+template class TypedArray<TypedArrayKind::Uint8ClampedArray>;
+template class TypedArray<TypedArrayKind::Uint16Array>;
+template class TypedArray<TypedArrayKind::Uint32Array>;
+template class TypedArray<TypedArrayKind::Float32Array>;
+template class TypedArray<TypedArrayKind::Float64Array>;

package/cpp/TypedArray.h

@@ -0,0 +1,175 @@
+//
+//  TypedArray.h
+//  react-native-mmkv
+//
+//  Created by Marc Rousavy on 11.10.2022.
+//  Originally created by Expo (expo-gl)
+//
+
+#pragma once
+
+#include <jsi/jsi.h>
+
+namespace jsi = facebook::jsi;
+
+enum class TypedArrayKind
+{
+    Int8Array,
+    Int16Array,
+    Int32Array,
+    Uint8Array,
+    Uint8ClampedArray,
+    Uint16Array,
+    Uint32Array,
+    Float32Array,
+    Float64Array,
+};
+
+template <TypedArrayKind T>
+class TypedArray;
+
+template <TypedArrayKind T>
+struct typedArrayTypeMap;
+template <>
+struct typedArrayTypeMap<TypedArrayKind::Int8Array>
+{
+    typedef int8_t type;
+};
+template <>
+struct typedArrayTypeMap<TypedArrayKind::Int16Array>
+{
+    typedef int16_t type;
+};
+template <>
+struct typedArrayTypeMap<TypedArrayKind::Int32Array>
+{
+    typedef int32_t type;
+};
+template <>
+struct typedArrayTypeMap<TypedArrayKind::Uint8Array>
+{
+    typedef uint8_t type;
+};
+template <>
+struct typedArrayTypeMap<TypedArrayKind::Uint8ClampedArray>
+{
+    typedef uint8_t type;
+};
+template <>
+struct typedArrayTypeMap<TypedArrayKind::Uint16Array>
+{
+    typedef uint16_t type;
+};
+template <>
+struct typedArrayTypeMap<TypedArrayKind::Uint32Array>
+{
+    typedef uint32_t type;
+};
+template <>
+struct typedArrayTypeMap<TypedArrayKind::Float32Array>
+{
+    typedef float type;
+};
+template <>
+struct typedArrayTypeMap<TypedArrayKind::Float64Array>
+{
+    typedef double type;
+};
+
+void invalidateJsiPropNameIDCache();
+
+class TypedArrayBase : public jsi::Object
+{
+public:
+    template <TypedArrayKind T>
+    using ContentType = typename typedArrayTypeMap<T>::type;
+
+    TypedArrayBase(jsi::Runtime &, size_t, TypedArrayKind);
+    TypedArrayBase(jsi::Runtime &, const jsi::Object &);
+    TypedArrayBase(TypedArrayBase &&) = default;
+    TypedArrayBase &operator=(TypedArrayBase &&) = default;
+
+    TypedArrayKind getKind(jsi::Runtime &runtime) const;
+
+    template <TypedArrayKind T>
+    TypedArray<T> get(jsi::Runtime &runtime) const &;
+    template <TypedArrayKind T>
+    TypedArray<T> get(jsi::Runtime &runtime) &&;
+    template <TypedArrayKind T>
+    TypedArray<T> as(jsi::Runtime &runtime) const &;
+    template <TypedArrayKind T>
+    TypedArray<T> as(jsi::Runtime &runtime) &&;
+
+    size_t size(jsi::Runtime &runtime) const;
+    size_t length(jsi::Runtime &runtime) const;
+    size_t byteLength(jsi::Runtime &runtime) const;
+    size_t byteOffset(jsi::Runtime &runtime) const;
+    bool hasBuffer(jsi::Runtime &runtime) const;
+
+    std::vector<uint8_t> toVector(jsi::Runtime &runtime);
+    jsi::ArrayBuffer getBuffer(jsi::Runtime &runtime) const;
+
+private:
+    template <TypedArrayKind>
+    friend class TypedArray;
+};
+
+bool isTypedArray(jsi::Runtime &runtime, const jsi::Object &jsObj);
+TypedArrayBase getTypedArray(jsi::Runtime &runtime, const jsi::Object &jsObj);
+
+std::vector<uint8_t> arrayBufferToVector(jsi::Runtime &runtime, jsi::Object &jsObj);
+void arrayBufferUpdate(
+    jsi::Runtime &runtime,
+    jsi::ArrayBuffer &buffer,
+    std::vector<uint8_t> data,
+    size_t offset);
+
+template <TypedArrayKind T>
+class TypedArray : public TypedArrayBase
+{
+public:
+    TypedArray(jsi::Runtime &runtime, size_t size);
+    TypedArray(jsi::Runtime &runtime, std::vector<ContentType<T>> data);
+    TypedArray(TypedArrayBase &&base);
+    TypedArray(TypedArray &&) = default;
+    TypedArray &operator=(TypedArray &&) = default;
+
+    std::vector<ContentType<T>> toVector(jsi::Runtime &runtime);
+    void update(jsi::Runtime &runtime, const std::vector<ContentType<T>> &data);
+};
+
+template <TypedArrayKind T>
+TypedArray<T> TypedArrayBase::get(jsi::Runtime &runtime) const &
+{
+    assert(getKind(runtime) == T);
+    (void)runtime; // when assert is disabled we need to mark this as used
+    return TypedArray<T>(jsi::Value(runtime, jsi::Value(runtime, *this).asObject(runtime)));
+}
+
+template <TypedArrayKind T>
+TypedArray<T> TypedArrayBase::get(jsi::Runtime &runtime) &&
+{
+    assert(getKind(runtime) == T);
+    (void)runtime; // when assert is disabled we need to mark this as used
+    return TypedArray<T>(std::move(*this));
+}
+
+template <TypedArrayKind T>
+TypedArray<T> TypedArrayBase::as(jsi::Runtime &runtime) const &
+{
+    if (getKind(runtime) != T)
+    {
+        throw jsi::JSError(runtime, "Object is not a TypedArray");
+    }
+    return get<T>(runtime);
+}
+
+template <TypedArrayKind T>
+TypedArray<T> TypedArrayBase::as(jsi::Runtime &runtime) &&
+{
+    if (getKind(runtime) != T)
+    {
+        throw jsi::JSError(runtime, "Object is not a TypedArray");
+    }
+    return std::move(*this).get<T>(runtime);
+}

package/ios/Mmkv.xcodeproj/project.pbxproj

@@ -7,8 +7,8 @@
 	objects = {
 
 /* Begin PBXBuildFile section */
-		5E555C0D2413F4C50049A1A2 /* Mmkv.mm in Sources */ = {isa = PBXBuildFile; fileRef = B3E7B5891CC2AC0600A0062D /* Mmkv.mm */; };
 		B81384EA26E23A8500A8507D /* MmkvHostObject.mm in Sources */ = {isa = PBXBuildFile; fileRef = B81384E926E23A8500A8507D /* MmkvHostObject.mm */; };
+		B8A8A9BE28F5797400345076 /* MmkvModule.mm in Sources */ = {isa = PBXBuildFile; fileRef = B8A8A9BD28F5797400345076 /* MmkvModule.mm */; };
 		B8CC270225E65597009808A2 /* JSIUtils.mm in Sources */ = {isa = PBXBuildFile; fileRef = B8CC270125E65597009808A2 /* JSIUtils.mm */; };
 /* End PBXBuildFile section */
 
@@ -26,10 +26,11 @@
 
 /* Begin PBXFileReference section */
 		134814201AA4EA6300B7C361 /* libMmkv.a */ = {isa = PBXFileReference; explicitFileType = archive.ar; includeInIndex = 0; path = libMmkv.a; sourceTree = BUILT_PRODUCTS_DIR; };
-		B3E7B5891CC2AC0600A0062D /* Mmkv.mm */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.cpp.objcpp; path = Mmkv.mm; sourceTree = "<group>"; };
 		B81384E926E23A8500A8507D /* MmkvHostObject.mm */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.cpp.objcpp; path = MmkvHostObject.mm; sourceTree = "<group>"; };
 		B81384EB26E23A8D00A8507D /* MmkvHostObject.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = MmkvHostObject.h; sourceTree = "<group>"; };
-		B865949C25E63C5C002102DB /* Mmkv.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = Mmkv.h; sourceTree = "<group>"; };
+		B8A8A9BC28F5797400345076 /* MmkvModule.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = MmkvModule.h; sourceTree = "<group>"; };
+		B8A8A9BD28F5797400345076 /* MmkvModule.mm */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.cpp.objcpp; path = MmkvModule.mm; sourceTree = "<group>"; };
+		B8A8A9BF28F5798100345076 /* cpp */ = {isa = PBXFileReference; lastKnownFileType = folder; name = cpp; path = ../cpp; sourceTree = "<group>"; };
 		B8CC270125E65597009808A2 /* JSIUtils.mm */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.cpp.objcpp; path = JSIUtils.mm; sourceTree = "<group>"; };
 		B8CC270425E655AD009808A2 /* JSIUtils.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = JSIUtils.h; sourceTree = "<group>"; };
 /* End PBXFileReference section */
@@ -60,8 +61,9 @@
 				B81384E926E23A8500A8507D /* MmkvHostObject.mm */,
 				B8CC270425E655AD009808A2 /* JSIUtils.h */,
 				B8CC270125E65597009808A2 /* JSIUtils.mm */,
-				B865949C25E63C5C002102DB /* Mmkv.h */,
-				B3E7B5891CC2AC0600A0062D /* Mmkv.mm */,
+				B8A8A9BC28F5797400345076 /* MmkvModule.h */,
+				B8A8A9BD28F5797400345076 /* MmkvModule.mm */,
+				B8A8A9BF28F5798100345076 /* cpp */,
 				134814211AA4EA7D00B7C361 /* Products */,
 			);
 			sourceTree = "<group>";
@@ -123,8 +125,8 @@
 			isa = PBXSourcesBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
-				5E555C0D2413F4C50049A1A2 /* Mmkv.mm in Sources */,
 				B81384EA26E23A8500A8507D /* MmkvHostObject.mm in Sources */,
+				B8A8A9BE28F5797400345076 /* MmkvModule.mm in Sources */,
 				B8CC270225E65597009808A2 /* JSIUtils.mm in Sources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;

package/ios/MmkvHostObject.mm

@@ -9,6 +9,8 @@
 #import <Foundation/Foundation.h>
 #import "MmkvHostObject.h"
 #import "JSIUtils.h"
+#import "TypedArray.h"
+#import <vector>
 
 MmkvHostObject::MmkvHostObject(NSString* instanceId, NSString* path, NSString* cryptKey)
 {
@@ -81,6 +83,20 @@ jsi::Value MmkvHostObject::get(jsi::Runtime& runtime, const jsi::PropNameID& pro
         // Set as UTF-8 string
         auto stringValue = convertJSIStringToNSString(runtime, arguments[1].getString(runtime));
         [instance setString:stringValue forKey:keyName];
+      } else if (arguments[1].isObject()) {
+        // object
+        auto object = arguments[1].asObject(runtime);
+        if (isTypedArray(runtime, object)) {
+          // Uint8Array
+          auto typedArray = getTypedArray(runtime, object);
+          auto bufferValue = typedArray.getBuffer(runtime);
+          auto data = [[NSData alloc] initWithBytes:bufferValue.data(runtime)
+                                             length:bufferValue.length(runtime)];
+          [instance setData:data forKey:keyName];
+        } else {
+          // unknown object
+          throw jsi::JSError(runtime, "MMKV::set: 'value' argument is an object, but not of type Uint8Array!");
+        }
       } else {
         // Invalid type
         throw jsi::JSError(runtime, "Second argument ('value') has to be of type bool, number or string!");
@@ -136,7 +152,7 @@ jsi::Value MmkvHostObject::get(jsi::Runtime& runtime, const jsi::PropNameID& pro
       }
     });
   }
-
+    
   if (propName == "getNumber") {
     // MMKV.getNumber(key: string)
     return jsi::Function::createFromHostFunction(runtime,
@@ -161,6 +177,34 @@ jsi::Value MmkvHostObject::get(jsi::Runtime& runtime, const jsi::PropNameID& pro
     });
   }
 
+  if (propName == "getBuffer") {
+    // MMKV.getBuffer(key: string)
+    return jsi::Function::createFromHostFunction(runtime,
+                                                 jsi::PropNameID::forAscii(runtime, funcName),
+                                                 1,  // key
+                                                 [this](jsi::Runtime& runtime,
+                                                        const jsi::Value& thisValue,
+                                                        const jsi::Value* arguments,
+                                                        size_t count) -> jsi::Value {
+      if (!arguments[0].isString()) {
+        throw jsi::JSError(runtime, "First argument ('key') has to be of type string!");
+      }
+
+      auto keyName = convertJSIStringToNSString(runtime, arguments[0].getString(runtime));
+      auto data = [instance getDataForKey:keyName];
+      if (data != nil) {
+        TypedArray<TypedArrayKind::Uint8Array> array(runtime, data.length);
+        auto charArray = static_cast<const unsigned char*>([data bytes]);
+        std::vector<unsigned char> vector(data.length);
+        vector.assign(charArray, charArray + data.length);
+        array.update(runtime, vector);
+        return array;
+      } else {
+        return jsi::Value::undefined();
+      }
+    });
+  }
+
   if (propName == "contains") {
     // MMKV.contains(key: string)
     return jsi::Function::createFromHostFunction(runtime,

package/lib/commonjs/MMKV.js

@@ -84,6 +84,11 @@ class MMKV {
     return func(key);
   }
 
+  getBuffer(key) {
+    const func = this.getFunctionFromCache('getBuffer');
+    return func(key);
+  }
+
   contains(key) {
     const func = this.getFunctionFromCache('contains');
     return func(key);

package/lib/commonjs/MMKV.js.map

@@ -1 +1 @@
-{"version":3,"sources":["MMKV.ts"],"names":["onValueChangedListeners","Map","MMKV","constructor","configuration","id","nativeInstance","functionCache","has","set","get","getFunctionFromCache","functionName","onValuesChanged","keys","length","key","listener","value","func","getBoolean","getString","getNumber","contains","delete","getAllKeys","clearAll","recrypt","toString","join","toJSON","addOnValueChangedListener","onValueChanged","push","remove","index","indexOf","splice"],"mappings":"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","sourcesContent":["import { createMMKV } from './createMMKV';\nimport { createMockMMKV } from './createMMKV.mock';\nimport { isJest } from './PlatformChecker';\n\ninterface Listener {\n  remove: () => void;\n}\n\n/**\n * Used for configuration of a single MMKV instance.\n */\nexport interface MMKVConfiguration {\n  /**\n   * The MMKV instance's ID. If you want to use multiple instances, make sure to use different IDs!\n   *\n   * @example\n   * ```ts\n   * const userStorage = new MMKV({ id: `user-${userId}-storage` })\n   * const globalStorage = new MMKV({ id: 'global-app-storage' })\n   * ```\n   *\n   * @default 'mmkv.default'\n   */\n  id: string;\n  /**\n   * The MMKV instance's root path. By default, MMKV stores file inside `$(Documents)/mmkv/`. You can customize MMKV's root directory on MMKV initialization:\n   *\n   * @example\n   * ```ts\n   * const temporaryStorage = new MMKV({ path: '/tmp/' })\n   * ```\n   */\n  path?: string;\n  /**\n   * The MMKV instance's encryption/decryption key. By default, MMKV stores all key-values in plain text on file, relying on iOS's sandbox to make sure the file is encrypted. Should you worry about information leaking, you can choose to encrypt MMKV.\n   *\n   * Encryption keys can have a maximum length of 16 bytes.\n   *\n   * @example\n   * ```ts\n   * const secureStorage = new MMKV({ encryptionKey: 'my-encryption-key!' })\n   * ```\n   */\n  encryptionKey?: string;\n}\n\n/**\n * Represents a single MMKV instance.\n */\ninterface MMKVInterface {\n  /**\n   * Set a value for the given `key`.\n   */\n  set: (key: string, value: boolean | string | number) => void;\n  /**\n   * Get the boolean value for the given `key`, or `undefined` if it does not exist.\n   *\n   * @default undefined\n   */\n  getBoolean: (key: string) => boolean | undefined;\n  /**\n   * Get the string value for the given `key`, or `undefined` if it does not exist.\n   *\n   * @default undefined\n   */\n  getString: (key: string) => string | undefined;\n  /**\n   * Get the number value for the given `key`, or `undefined` if it does not exist.\n   *\n   * @default undefined\n   */\n  getNumber: (key: string) => number | undefined;\n  /**\n   * Checks whether the given `key` is being stored in this MMKV instance.\n   */\n  contains: (key: string) => boolean;\n  /**\n   * Delete the given `key`.\n   */\n  delete: (key: string) => void;\n  /**\n   * Get all keys.\n   *\n   * @default []\n   */\n  getAllKeys: () => string[];\n  /**\n   * Delete all keys.\n   */\n  clearAll: () => void;\n  /**\n   * Sets (or updates) the encryption-key to encrypt all data in this MMKV instance with.\n   *\n   * To remove encryption, pass `undefined` as a key.\n   *\n   * Encryption keys can have a maximum length of 16 bytes.\n   */\n  recrypt: (key: string | undefined) => void;\n  /**\n   * Adds a value changed listener. The Listener will be called whenever any value\n   * in this storage instance changes (set or delete).\n   *\n   * To unsubscribe from value changes, call `remove()` on the Listener.\n   */\n  addOnValueChangedListener: (\n    onValueChanged: (key: string) => void\n  ) => Listener;\n}\n\nexport type NativeMMKV = Pick<\n  MMKVInterface,\n  | 'clearAll'\n  | 'contains'\n  | 'delete'\n  | 'getAllKeys'\n  | 'getBoolean'\n  | 'getNumber'\n  | 'getString'\n  | 'set'\n  | 'recrypt'\n>;\n\nconst onValueChangedListeners = new Map<string, ((key: string) => void)[]>();\n\n/**\n * A single MMKV instance.\n */\nexport class MMKV implements MMKVInterface {\n  private nativeInstance: NativeMMKV;\n  private functionCache: Partial<NativeMMKV>;\n  private id: string;\n\n  /**\n   * Creates a new MMKV instance with the given Configuration.\n   * If no custom `id` is supplied, `'mmkv.default'` will be used.\n   */\n  constructor(configuration: MMKVConfiguration = { id: 'mmkv.default' }) {\n    this.id = configuration.id;\n    this.nativeInstance = isJest()\n      ? createMockMMKV()\n      : createMMKV(configuration);\n    this.functionCache = {};\n  }\n\n  private get onValueChangedListeners() {\n    if (!onValueChangedListeners.has(this.id)) {\n      onValueChangedListeners.set(this.id, []);\n    }\n    return onValueChangedListeners.get(this.id)!;\n  }\n\n  private getFunctionFromCache<T extends keyof NativeMMKV>(\n    functionName: T\n  ): NativeMMKV[T] {\n    if (this.functionCache[functionName] == null) {\n      this.functionCache[functionName] = this.nativeInstance[functionName];\n    }\n    return this.functionCache[functionName] as NativeMMKV[T];\n  }\n\n  private onValuesChanged(keys: string[]) {\n    if (this.onValueChangedListeners.length === 0) return;\n\n    for (const key of keys) {\n      for (const listener of this.onValueChangedListeners) {\n        listener(key);\n      }\n    }\n  }\n\n  set(key: string, value: boolean | string | number): void {\n    const func = this.getFunctionFromCache('set');\n    func(key, value);\n\n    this.onValuesChanged([key]);\n  }\n  getBoolean(key: string): boolean | undefined {\n    const func = this.getFunctionFromCache('getBoolean');\n    return func(key);\n  }\n  getString(key: string): string | undefined {\n    const func = this.getFunctionFromCache('getString');\n    return func(key);\n  }\n  getNumber(key: string): number | undefined {\n    const func = this.getFunctionFromCache('getNumber');\n    return func(key);\n  }\n  contains(key: string): boolean {\n    const func = this.getFunctionFromCache('contains');\n    return func(key);\n  }\n  delete(key: string): void {\n    const func = this.getFunctionFromCache('delete');\n    func(key);\n\n    this.onValuesChanged([key]);\n  }\n  getAllKeys(): string[] {\n    const func = this.getFunctionFromCache('getAllKeys');\n    return func();\n  }\n  clearAll(): void {\n    const keys = this.getAllKeys();\n\n    const func = this.getFunctionFromCache('clearAll');\n    func();\n\n    this.onValuesChanged(keys);\n  }\n  recrypt(key: string | undefined): void {\n    const func = this.getFunctionFromCache('recrypt');\n    return func(key);\n  }\n\n  toString(): string {\n    return `MMKV (${this.id}): [${this.getAllKeys().join(', ')}]`;\n  }\n  toJSON(): object {\n    return {\n      [this.id]: this.getAllKeys(),\n    };\n  }\n\n  addOnValueChangedListener(onValueChanged: (key: string) => void): Listener {\n    this.onValueChangedListeners.push(onValueChanged);\n\n    return {\n      remove: () => {\n        const index = this.onValueChangedListeners.indexOf(onValueChanged);\n        if (index !== -1) {\n          this.onValueChangedListeners.splice(index, 1);\n        }\n      },\n    };\n  }\n}\n"]}
+{"version":3,"sources":["MMKV.ts"],"names":["onValueChangedListeners","Map","MMKV","constructor","configuration","id","nativeInstance","functionCache","has","set","get","getFunctionFromCache","functionName","onValuesChanged","keys","length","key","listener","value","func","getBoolean","getString","getNumber","getBuffer","contains","delete","getAllKeys","clearAll","recrypt","toString","join","toJSON","addOnValueChangedListener","onValueChanged","push","remove","index","indexOf","splice"],"mappings":"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","sourcesContent":["import { createMMKV } from './createMMKV';\nimport { createMockMMKV } from './createMMKV.mock';\nimport { isJest } from './PlatformChecker';\n\ninterface Listener {\n  remove: () => void;\n}\n\n/**\n * Used for configuration of a single MMKV instance.\n */\nexport interface MMKVConfiguration {\n  /**\n   * The MMKV instance's ID. If you want to use multiple instances, make sure to use different IDs!\n   *\n   * @example\n   * ```ts\n   * const userStorage = new MMKV({ id: `user-${userId}-storage` })\n   * const globalStorage = new MMKV({ id: 'global-app-storage' })\n   * ```\n   *\n   * @default 'mmkv.default'\n   */\n  id: string;\n  /**\n   * The MMKV instance's root path. By default, MMKV stores file inside `$(Documents)/mmkv/`. You can customize MMKV's root directory on MMKV initialization:\n   *\n   * @example\n   * ```ts\n   * const temporaryStorage = new MMKV({ path: '/tmp/' })\n   * ```\n   */\n  path?: string;\n  /**\n   * The MMKV instance's encryption/decryption key. By default, MMKV stores all key-values in plain text on file, relying on iOS's sandbox to make sure the file is encrypted. Should you worry about information leaking, you can choose to encrypt MMKV.\n   *\n   * Encryption keys can have a maximum length of 16 bytes.\n   *\n   * @example\n   * ```ts\n   * const secureStorage = new MMKV({ encryptionKey: 'my-encryption-key!' })\n   * ```\n   */\n  encryptionKey?: string;\n}\n\n/**\n * Represents a single MMKV instance.\n */\ninterface MMKVInterface {\n  /**\n   * Set a value for the given `key`.\n   */\n  set: (key: string, value: boolean | string | number | Uint8Array) => void;\n  /**\n   * Get the boolean value for the given `key`, or `undefined` if it does not exist.\n   *\n   * @default undefined\n   */\n  getBoolean: (key: string) => boolean | undefined;\n  /**\n   * Get the string value for the given `key`, or `undefined` if it does not exist.\n   *\n   * @default undefined\n   */\n  getString: (key: string) => string | undefined;\n  /**\n   * Get the number value for the given `key`, or `undefined` if it does not exist.\n   *\n   * @default undefined\n   */\n  getNumber: (key: string) => number | undefined;\n  /**\n   * Get a raw buffer of unsigned 8-bit (0-255) data.\n   *\n   * @default undefined\n   */\n  getBuffer: (key: string) => Uint8Array | undefined;\n  /**\n   * Checks whether the given `key` is being stored in this MMKV instance.\n   */\n  contains: (key: string) => boolean;\n  /**\n   * Delete the given `key`.\n   */\n  delete: (key: string) => void;\n  /**\n   * Get all keys.\n   *\n   * @default []\n   */\n  getAllKeys: () => string[];\n  /**\n   * Delete all keys.\n   */\n  clearAll: () => void;\n  /**\n   * Sets (or updates) the encryption-key to encrypt all data in this MMKV instance with.\n   *\n   * To remove encryption, pass `undefined` as a key.\n   *\n   * Encryption keys can have a maximum length of 16 bytes.\n   */\n  recrypt: (key: string | undefined) => void;\n  /**\n   * Adds a value changed listener. The Listener will be called whenever any value\n   * in this storage instance changes (set or delete).\n   *\n   * To unsubscribe from value changes, call `remove()` on the Listener.\n   */\n  addOnValueChangedListener: (\n    onValueChanged: (key: string) => void\n  ) => Listener;\n}\n\nexport type NativeMMKV = Pick<\n  MMKVInterface,\n  | 'clearAll'\n  | 'contains'\n  | 'delete'\n  | 'getAllKeys'\n  | 'getBoolean'\n  | 'getNumber'\n  | 'getString'\n  | 'getBuffer'\n  | 'set'\n  | 'recrypt'\n>;\n\nconst onValueChangedListeners = new Map<string, ((key: string) => void)[]>();\n\n/**\n * A single MMKV instance.\n */\nexport class MMKV implements MMKVInterface {\n  private nativeInstance: NativeMMKV;\n  private functionCache: Partial<NativeMMKV>;\n  private id: string;\n\n  /**\n   * Creates a new MMKV instance with the given Configuration.\n   * If no custom `id` is supplied, `'mmkv.default'` will be used.\n   */\n  constructor(configuration: MMKVConfiguration = { id: 'mmkv.default' }) {\n    this.id = configuration.id;\n    this.nativeInstance = isJest()\n      ? createMockMMKV()\n      : createMMKV(configuration);\n    this.functionCache = {};\n  }\n\n  private get onValueChangedListeners() {\n    if (!onValueChangedListeners.has(this.id)) {\n      onValueChangedListeners.set(this.id, []);\n    }\n    return onValueChangedListeners.get(this.id)!;\n  }\n\n  private getFunctionFromCache<T extends keyof NativeMMKV>(\n    functionName: T\n  ): NativeMMKV[T] {\n    if (this.functionCache[functionName] == null) {\n      this.functionCache[functionName] = this.nativeInstance[functionName];\n    }\n    return this.functionCache[functionName] as NativeMMKV[T];\n  }\n\n  private onValuesChanged(keys: string[]) {\n    if (this.onValueChangedListeners.length === 0) return;\n\n    for (const key of keys) {\n      for (const listener of this.onValueChangedListeners) {\n        listener(key);\n      }\n    }\n  }\n\n  set(key: string, value: boolean | string | number | Uint8Array): void {\n    const func = this.getFunctionFromCache('set');\n    func(key, value);\n\n    this.onValuesChanged([key]);\n  }\n  getBoolean(key: string): boolean | undefined {\n    const func = this.getFunctionFromCache('getBoolean');\n    return func(key);\n  }\n  getString(key: string): string | undefined {\n    const func = this.getFunctionFromCache('getString');\n    return func(key);\n  }\n  getNumber(key: string): number | undefined {\n    const func = this.getFunctionFromCache('getNumber');\n    return func(key);\n  }\n  getBuffer(key: string): Uint8Array | undefined {\n    const func = this.getFunctionFromCache('getBuffer');\n    return func(key);\n  }\n  contains(key: string): boolean {\n    const func = this.getFunctionFromCache('contains');\n    return func(key);\n  }\n  delete(key: string): void {\n    const func = this.getFunctionFromCache('delete');\n    func(key);\n\n    this.onValuesChanged([key]);\n  }\n  getAllKeys(): string[] {\n    const func = this.getFunctionFromCache('getAllKeys');\n    return func();\n  }\n  clearAll(): void {\n    const keys = this.getAllKeys();\n\n    const func = this.getFunctionFromCache('clearAll');\n    func();\n\n    this.onValuesChanged(keys);\n  }\n  recrypt(key: string | undefined): void {\n    const func = this.getFunctionFromCache('recrypt');\n    return func(key);\n  }\n\n  toString(): string {\n    return `MMKV (${this.id}): [${this.getAllKeys().join(', ')}]`;\n  }\n  toJSON(): object {\n    return {\n      [this.id]: this.getAllKeys(),\n    };\n  }\n\n  addOnValueChangedListener(onValueChanged: (key: string) => void): Listener {\n    this.onValueChangedListeners.push(onValueChanged);\n\n    return {\n      remove: () => {\n        const index = this.onValueChangedListeners.indexOf(onValueChanged);\n        if (index !== -1) {\n          this.onValueChangedListeners.splice(index, 1);\n        }\n      },\n    };\n  }\n}\n"]}

package/lib/commonjs/PlatformChecker.js

@@ -6,6 +6,11 @@ Object.defineProperty(exports, "__esModule", {
 exports.isJest = isJest;
 
 function isJest() {
+  if (global.process == null) {
+    // In a WebBrowser/Electron the `process` variable does not exist
+    return false;
+  }
+
   return process.env.JEST_WORKER_ID != null;
 }
 //# sourceMappingURL=PlatformChecker.js.map

package/lib/commonjs/PlatformChecker.js.map

@@ -1 +1 @@
-{"version":3,"sources":["PlatformChecker.ts"],"names":["isJest","process","env","JEST_WORKER_ID"],"mappings":";;;;;;;AAAO,SAASA,MAAT,GAA2B;AAChC,SAAOC,OAAO,CAACC,GAAR,CAAYC,cAAZ,IAA8B,IAArC;AACD","sourcesContent":["export function isJest(): boolean {\n  return process.env.JEST_WORKER_ID != null;\n}\n"]}
+{"version":3,"sources":["PlatformChecker.ts"],"names":["isJest","global","process","env","JEST_WORKER_ID"],"mappings":";;;;;;;AAAO,SAASA,MAAT,GAA2B;AAChC,MAAIC,MAAM,CAACC,OAAP,IAAkB,IAAtB,EAA4B;AAC1B;AACA,WAAO,KAAP;AACD;;AACD,SAAOA,OAAO,CAACC,GAAR,CAAYC,cAAZ,IAA8B,IAArC;AACD","sourcesContent":["export function isJest(): boolean {\n  if (global.process == null) {\n    // In a WebBrowser/Electron the `process` variable does not exist\n    return false;\n  }\n  return process.env.JEST_WORKER_ID != null;\n}\n"]}

package/lib/commonjs/createMMKV.mock.js

@@ -24,6 +24,10 @@ const createMockMMKV = () => {
       const result = storage.get(key);
       return typeof result === 'boolean' ? result : undefined;
     },
+    getBuffer: key => {
+      const result = storage.get(key);
+      return result instanceof Uint8Array ? result : undefined;
+    },
     getAllKeys: () => Array.from(storage.keys()),
     contains: key => storage.has(key),
     recrypt: () => {

package/lib/commonjs/createMMKV.mock.js.map

@@ -1 +1 @@
-{"version":3,"sources":["createMMKV.mock.ts"],"names":["createMockMMKV","storage","Map","clearAll","clear","delete","key","set","value","getString","result","get","undefined","getNumber","getBoolean","getAllKeys","Array","from","keys","contains","has","recrypt","console","warn"],"mappings":";;;;;;;AAEA;AACO,MAAMA,cAAc,GAAG,MAAkB;AAC9C,QAAMC,OAAO,GAAG,IAAIC,GAAJ,EAAhB;AAEA,SAAO;AACLC,IAAAA,QAAQ,EAAE,MAAMF,OAAO,CAACG,KAAR,EADX;AAELC,IAAAA,MAAM,EAAGC,GAAD,IAASL,OAAO,CAACI,MAAR,CAAeC,GAAf,CAFZ;AAGLC,IAAAA,GAAG,EAAE,CAACD,GAAD,EAAME,KAAN,KAAgBP,OAAO,CAACM,GAAR,CAAYD,GAAZ,EAAiBE,KAAjB,CAHhB;AAILC,IAAAA,SAAS,EAAGH,GAAD,IAAS;AAClB,YAAMI,MAAM,GAAGT,OAAO,CAACU,GAAR,CAAYL,GAAZ,CAAf;AACA,aAAO,OAAOI,MAAP,KAAkB,QAAlB,GAA6BA,MAA7B,GAAsCE,SAA7C;AACD,KAPI;AAQLC,IAAAA,SAAS,EAAGP,GAAD,IAAS;AAClB,YAAMI,MAAM,GAAGT,OAAO,CAACU,GAAR,CAAYL,GAAZ,CAAf;AACA,aAAO,OAAOI,MAAP,KAAkB,QAAlB,GAA6BA,MAA7B,GAAsCE,SAA7C;AACD,KAXI;AAYLE,IAAAA,UAAU,EAAGR,GAAD,IAAS;AACnB,YAAMI,MAAM,GAAGT,OAAO,CAACU,GAAR,CAAYL,GAAZ,CAAf;AACA,aAAO,OAAOI,MAAP,KAAkB,SAAlB,GAA8BA,MAA9B,GAAuCE,SAA9C;AACD,KAfI;AAgBLG,IAAAA,UAAU,EAAE,MAAMC,KAAK,CAACC,IAAN,CAAWhB,OAAO,CAACiB,IAAR,EAAX,CAhBb;AAiBLC,IAAAA,QAAQ,EAAGb,GAAD,IAASL,OAAO,CAACmB,GAAR,CAAYd,GAAZ,CAjBd;AAkBLe,IAAAA,OAAO,EAAE,MAAM;AACbC,MAAAA,OAAO,CAACC,IAAR,CAAa,uDAAb;AACD;AApBI,GAAP;AAsBD,CAzBM","sourcesContent":["import type { NativeMMKV } from 'react-native-mmkv';\n\n/* Mock MMKV instance for use in tests */\nexport const createMockMMKV = (): NativeMMKV => {\n  const storage = new Map<string, string | boolean | number>();\n\n  return {\n    clearAll: () => storage.clear(),\n    delete: (key) => storage.delete(key),\n    set: (key, value) => storage.set(key, value),\n    getString: (key) => {\n      const result = storage.get(key);\n      return typeof result === 'string' ? result : undefined;\n    },\n    getNumber: (key) => {\n      const result = storage.get(key);\n      return typeof result === 'number' ? result : undefined;\n    },\n    getBoolean: (key) => {\n      const result = storage.get(key);\n      return typeof result === 'boolean' ? result : undefined;\n    },\n    getAllKeys: () => Array.from(storage.keys()),\n    contains: (key) => storage.has(key),\n    recrypt: () => {\n      console.warn('Encryption is not supported in mocked MMKV instances!');\n    },\n  };\n};\n"]}
+{"version":3,"sources":["createMMKV.mock.ts"],"names":["createMockMMKV","storage","Map","clearAll","clear","delete","key","set","value","getString","result","get","undefined","getNumber","getBoolean","getBuffer","Uint8Array","getAllKeys","Array","from","keys","contains","has","recrypt","console","warn"],"mappings":";;;;;;;AAEA;AACO,MAAMA,cAAc,GAAG,MAAkB;AAC9C,QAAMC,OAAO,GAAG,IAAIC,GAAJ,EAAhB;AAEA,SAAO;AACLC,IAAAA,QAAQ,EAAE,MAAMF,OAAO,CAACG,KAAR,EADX;AAELC,IAAAA,MAAM,EAAGC,GAAD,IAASL,OAAO,CAACI,MAAR,CAAeC,GAAf,CAFZ;AAGLC,IAAAA,GAAG,EAAE,CAACD,GAAD,EAAME,KAAN,KAAgBP,OAAO,CAACM,GAAR,CAAYD,GAAZ,EAAiBE,KAAjB,CAHhB;AAILC,IAAAA,SAAS,EAAGH,GAAD,IAAS;AAClB,YAAMI,MAAM,GAAGT,OAAO,CAACU,GAAR,CAAYL,GAAZ,CAAf;AACA,aAAO,OAAOI,MAAP,KAAkB,QAAlB,GAA6BA,MAA7B,GAAsCE,SAA7C;AACD,KAPI;AAQLC,IAAAA,SAAS,EAAGP,GAAD,IAAS;AAClB,YAAMI,MAAM,GAAGT,OAAO,CAACU,GAAR,CAAYL,GAAZ,CAAf;AACA,aAAO,OAAOI,MAAP,KAAkB,QAAlB,GAA6BA,MAA7B,GAAsCE,SAA7C;AACD,KAXI;AAYLE,IAAAA,UAAU,EAAGR,GAAD,IAAS;AACnB,YAAMI,MAAM,GAAGT,OAAO,CAACU,GAAR,CAAYL,GAAZ,CAAf;AACA,aAAO,OAAOI,MAAP,KAAkB,SAAlB,GAA8BA,MAA9B,GAAuCE,SAA9C;AACD,KAfI;AAgBLG,IAAAA,SAAS,EAAGT,GAAD,IAAS;AAClB,YAAMI,MAAM,GAAGT,OAAO,CAACU,GAAR,CAAYL,GAAZ,CAAf;AACA,aAAOI,MAAM,YAAYM,UAAlB,GAA+BN,MAA/B,GAAwCE,SAA/C;AACD,KAnBI;AAoBLK,IAAAA,UAAU,EAAE,MAAMC,KAAK,CAACC,IAAN,CAAWlB,OAAO,CAACmB,IAAR,EAAX,CApBb;AAqBLC,IAAAA,QAAQ,EAAGf,GAAD,IAASL,OAAO,CAACqB,GAAR,CAAYhB,GAAZ,CArBd;AAsBLiB,IAAAA,OAAO,EAAE,MAAM;AACbC,MAAAA,OAAO,CAACC,IAAR,CAAa,uDAAb;AACD;AAxBI,GAAP;AA0BD,CA7BM","sourcesContent":["import type { NativeMMKV } from 'react-native-mmkv';\n\n/* Mock MMKV instance for use in tests */\nexport const createMockMMKV = (): NativeMMKV => {\n  const storage = new Map<string, string | boolean | number | Uint8Array>();\n\n  return {\n    clearAll: () => storage.clear(),\n    delete: (key) => storage.delete(key),\n    set: (key, value) => storage.set(key, value),\n    getString: (key) => {\n      const result = storage.get(key);\n      return typeof result === 'string' ? result : undefined;\n    },\n    getNumber: (key) => {\n      const result = storage.get(key);\n      return typeof result === 'number' ? result : undefined;\n    },\n    getBoolean: (key) => {\n      const result = storage.get(key);\n      return typeof result === 'boolean' ? result : undefined;\n    },\n    getBuffer: (key) => {\n      const result = storage.get(key);\n      return result instanceof Uint8Array ? result : undefined;\n    },\n    getAllKeys: () => Array.from(storage.keys()),\n    contains: (key) => storage.has(key),\n    recrypt: () => {\n      console.warn('Encryption is not supported in mocked MMKV instances!');\n    },\n  };\n};\n"]}

package/lib/commonjs/createMMKV.web.js

@@ -5,9 +5,10 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.createMMKV = void 0;
 
+var _createTextEncoder = require("./createTextEncoder");
+
 var _window$document;
 
-/* global localStorage */
 const canUseDOM = typeof window !== 'undefined' && ((_window$document = window.document) === null || _window$document === void 0 ? void 0 : _window$document.createElement) != null;
 
 const createMMKV = config => {
@@ -39,6 +40,7 @@ const createMMKV = config => {
     return domStorage;
   };
 
+  const textEncoder = (0, _createTextEncoder.createTextEncoder)();
   return {
     clearAll: () => storage().clear(),
     delete: key => storage().removeItem(key),
@@ -58,6 +60,11 @@ const createMMKV = config => {
       if (value == null) return undefined;
       return value === 'true';
     },
+    getBuffer: key => {
+      const value = storage().getItem(key);
+      if (value == null) return undefined;
+      return textEncoder.encode(value);
+    },
     getAllKeys: () => Object.keys(storage()),
     contains: key => storage().getItem(key) != null,
     recrypt: () => {

package/lib/commonjs/createMMKV.web.js.map

@@ -1 +1 @@
-{"version":3,"sources":["createMMKV.web.ts"],"names":["canUseDOM","window","document","createElement","createMMKV","config","id","Error","encryptionKey","path","storage","domStorage","global","localStorage","clearAll","clear","delete","key","removeItem","set","value","setItem","toString","getString","getItem","undefined","getNumber","Number","getBoolean","getAllKeys","Object","keys","contains","recrypt"],"mappings":";;;;;;;;;AAAA;AAGA,MAAMA,SAAS,GACb,OAAOC,MAAP,KAAkB,WAAlB,IAAiC,qBAAAA,MAAM,CAACC,QAAP,sEAAiBC,aAAjB,KAAkC,IADrE;;AAGO,MAAMC,UAAU,GAAIC,MAAD,IAA2C;AACnE,MAAIA,MAAM,CAACC,EAAP,KAAc,cAAlB,EAAkC;AAChC,UAAM,IAAIC,KAAJ,CAAU,qCAAV,CAAN;AACD;;AACD,MAAIF,MAAM,CAACG,aAAP,IAAwB,IAA5B,EAAkC;AAChC,UAAM,IAAID,KAAJ,CAAU,gDAAV,CAAN;AACD;;AACD,MAAIF,MAAM,CAACI,IAAP,IAAe,IAAnB,EAAyB;AACvB,UAAM,IAAIF,KAAJ,CAAU,uCAAV,CAAN;AACD;;AAED,QAAMG,OAAO,GAAG,MAAM;AAAA;;AACpB,QAAI,CAACV,SAAL,EAAgB;AACd,YAAM,IAAIO,KAAJ,CACJ,kFADI,CAAN;AAGD;;AACD,UAAMI,UAAU,8CACdC,MADc,4CACd,QAAQC,YADM,kFACUZ,MADV,4CACU,QAAQY,YADlB,uCACkCA,YADlD;;AAEA,QAAIF,UAAU,IAAI,IAAlB,EAAwB;AACtB,YAAM,IAAIJ,KAAJ,CAAW,yCAAX,CAAN;AACD;;AACD,WAAOI,UAAP;AACD,GAZD;;AAcA,SAAO;AACLG,IAAAA,QAAQ,EAAE,MAAMJ,OAAO,GAAGK,KAAV,EADX;AAELC,IAAAA,MAAM,EAAGC,GAAD,IAASP,OAAO,GAAGQ,UAAV,CAAqBD,GAArB,CAFZ;AAGLE,IAAAA,GAAG,EAAE,CAACF,GAAD,EAAMG,KAAN,KAAgBV,OAAO,GAAGW,OAAV,CAAkBJ,GAAlB,EAAuBG,KAAK,CAACE,QAAN,EAAvB,CAHhB;AAILC,IAAAA,SAAS,EAAGN,GAAD;AAAA;;AAAA,iCAASP,OAAO,GAAGc,OAAV,CAAkBP,GAAlB,CAAT,+DAAmCQ,SAAnC;AAAA,KAJN;AAKLC,IAAAA,SAAS,EAAGT,GAAD,IAAS;AAClB,YAAMG,KAAK,GAAGV,OAAO,GAAGc,OAAV,CAAkBP,GAAlB,CAAd;AACA,UAAIG,KAAK,IAAI,IAAb,EAAmB,OAAOK,SAAP;AACnB,aAAOE,MAAM,CAACP,KAAD,CAAb;AACD,KATI;AAULQ,IAAAA,UAAU,EAAGX,GAAD,IAAS;AACnB,YAAMG,KAAK,GAAGV,OAAO,GAAGc,OAAV,CAAkBP,GAAlB,CAAd;AACA,UAAIG,KAAK,IAAI,IAAb,EAAmB,OAAOK,SAAP;AACnB,aAAOL,KAAK,KAAK,MAAjB;AACD,KAdI;AAeLS,IAAAA,UAAU,EAAE,MAAMC,MAAM,CAACC,IAAP,CAAYrB,OAAO,EAAnB,CAfb;AAgBLsB,IAAAA,QAAQ,EAAGf,GAAD,IAASP,OAAO,GAAGc,OAAV,CAAkBP,GAAlB,KAA0B,IAhBxC;AAiBLgB,IAAAA,OAAO,EAAE,MAAM;AACb,YAAM,IAAI1B,KAAJ,CAAU,wCAAV,CAAN;AACD;AAnBI,GAAP;AAqBD,CA9CM","sourcesContent":["/* global localStorage */\nimport type { MMKVConfiguration, NativeMMKV } from 'react-native-mmkv';\n\nconst canUseDOM =\n  typeof window !== 'undefined' && window.document?.createElement != null;\n\nexport const createMMKV = (config: MMKVConfiguration): NativeMMKV => {\n  if (config.id !== 'mmkv.default') {\n    throw new Error(\"MMKV: 'id' is not supported on Web!\");\n  }\n  if (config.encryptionKey != null) {\n    throw new Error(\"MMKV: 'encryptionKey' is not supported on Web!\");\n  }\n  if (config.path != null) {\n    throw new Error(\"MMKV: 'path' is not supported on Web!\");\n  }\n\n  const storage = () => {\n    if (!canUseDOM) {\n      throw new Error(\n        'Tried to access storage on the server. Did you forget to call this in useEffect?'\n      );\n    }\n    const domStorage =\n      global?.localStorage ?? window?.localStorage ?? localStorage;\n    if (domStorage == null) {\n      throw new Error(`Could not find 'localStorage' instance!`);\n    }\n    return domStorage;\n  };\n\n  return {\n    clearAll: () => storage().clear(),\n    delete: (key) => storage().removeItem(key),\n    set: (key, value) => storage().setItem(key, value.toString()),\n    getString: (key) => storage().getItem(key) ?? undefined,\n    getNumber: (key) => {\n      const value = storage().getItem(key);\n      if (value == null) return undefined;\n      return Number(value);\n    },\n    getBoolean: (key) => {\n      const value = storage().getItem(key);\n      if (value == null) return undefined;\n      return value === 'true';\n    },\n    getAllKeys: () => Object.keys(storage()),\n    contains: (key) => storage().getItem(key) != null,\n    recrypt: () => {\n      throw new Error('`recrypt(..)` is not supported on Web!');\n    },\n  };\n};\n"]}
+{"version":3,"sources":["createMMKV.web.ts"],"names":["canUseDOM","window","document","createElement","createMMKV","config","id","Error","encryptionKey","path","storage","domStorage","global","localStorage","textEncoder","clearAll","clear","delete","key","removeItem","set","value","setItem","toString","getString","getItem","undefined","getNumber","Number","getBoolean","getBuffer","encode","getAllKeys","Object","keys","contains","recrypt"],"mappings":";;;;;;;AAEA;;;;AAEA,MAAMA,SAAS,GACb,OAAOC,MAAP,KAAkB,WAAlB,IAAiC,qBAAAA,MAAM,CAACC,QAAP,sEAAiBC,aAAjB,KAAkC,IADrE;;AAGO,MAAMC,UAAU,GAAIC,MAAD,IAA2C;AACnE,MAAIA,MAAM,CAACC,EAAP,KAAc,cAAlB,EAAkC;AAChC,UAAM,IAAIC,KAAJ,CAAU,qCAAV,CAAN;AACD;;AACD,MAAIF,MAAM,CAACG,aAAP,IAAwB,IAA5B,EAAkC;AAChC,UAAM,IAAID,KAAJ,CAAU,gDAAV,CAAN;AACD;;AACD,MAAIF,MAAM,CAACI,IAAP,IAAe,IAAnB,EAAyB;AACvB,UAAM,IAAIF,KAAJ,CAAU,uCAAV,CAAN;AACD;;AAED,QAAMG,OAAO,GAAG,MAAM;AAAA;;AACpB,QAAI,CAACV,SAAL,EAAgB;AACd,YAAM,IAAIO,KAAJ,CACJ,kFADI,CAAN;AAGD;;AACD,UAAMI,UAAU,8CACdC,MADc,4CACd,QAAQC,YADM,kFACUZ,MADV,4CACU,QAAQY,YADlB,uCACkCA,YADlD;;AAEA,QAAIF,UAAU,IAAI,IAAlB,EAAwB;AACtB,YAAM,IAAIJ,KAAJ,CAAW,yCAAX,CAAN;AACD;;AACD,WAAOI,UAAP;AACD,GAZD;;AAcA,QAAMG,WAAW,GAAG,2CAApB;AAEA,SAAO;AACLC,IAAAA,QAAQ,EAAE,MAAML,OAAO,GAAGM,KAAV,EADX;AAELC,IAAAA,MAAM,EAAGC,GAAD,IAASR,OAAO,GAAGS,UAAV,CAAqBD,GAArB,CAFZ;AAGLE,IAAAA,GAAG,EAAE,CAACF,GAAD,EAAMG,KAAN,KAAgBX,OAAO,GAAGY,OAAV,CAAkBJ,GAAlB,EAAuBG,KAAK,CAACE,QAAN,EAAvB,CAHhB;AAILC,IAAAA,SAAS,EAAGN,GAAD;AAAA;;AAAA,iCAASR,OAAO,GAAGe,OAAV,CAAkBP,GAAlB,CAAT,+DAAmCQ,SAAnC;AAAA,KAJN;AAKLC,IAAAA,SAAS,EAAGT,GAAD,IAAS;AAClB,YAAMG,KAAK,GAAGX,OAAO,GAAGe,OAAV,CAAkBP,GAAlB,CAAd;AACA,UAAIG,KAAK,IAAI,IAAb,EAAmB,OAAOK,SAAP;AACnB,aAAOE,MAAM,CAACP,KAAD,CAAb;AACD,KATI;AAULQ,IAAAA,UAAU,EAAGX,GAAD,IAAS;AACnB,YAAMG,KAAK,GAAGX,OAAO,GAAGe,OAAV,CAAkBP,GAAlB,CAAd;AACA,UAAIG,KAAK,IAAI,IAAb,EAAmB,OAAOK,SAAP;AACnB,aAAOL,KAAK,KAAK,MAAjB;AACD,KAdI;AAeLS,IAAAA,SAAS,EAAGZ,GAAD,IAAS;AAClB,YAAMG,KAAK,GAAGX,OAAO,GAAGe,OAAV,CAAkBP,GAAlB,CAAd;AACA,UAAIG,KAAK,IAAI,IAAb,EAAmB,OAAOK,SAAP;AACnB,aAAOZ,WAAW,CAACiB,MAAZ,CAAmBV,KAAnB,CAAP;AACD,KAnBI;AAoBLW,IAAAA,UAAU,EAAE,MAAMC,MAAM,CAACC,IAAP,CAAYxB,OAAO,EAAnB,CApBb;AAqBLyB,IAAAA,QAAQ,EAAGjB,GAAD,IAASR,OAAO,GAAGe,OAAV,CAAkBP,GAAlB,KAA0B,IArBxC;AAsBLkB,IAAAA,OAAO,EAAE,MAAM;AACb,YAAM,IAAI7B,KAAJ,CAAU,wCAAV,CAAN;AACD;AAxBI,GAAP;AA0BD,CArDM","sourcesContent":["/* global localStorage */\nimport type { MMKVConfiguration, NativeMMKV } from 'react-native-mmkv';\nimport { createTextEncoder } from './createTextEncoder';\n\nconst canUseDOM =\n  typeof window !== 'undefined' && window.document?.createElement != null;\n\nexport const createMMKV = (config: MMKVConfiguration): NativeMMKV => {\n  if (config.id !== 'mmkv.default') {\n    throw new Error(\"MMKV: 'id' is not supported on Web!\");\n  }\n  if (config.encryptionKey != null) {\n    throw new Error(\"MMKV: 'encryptionKey' is not supported on Web!\");\n  }\n  if (config.path != null) {\n    throw new Error(\"MMKV: 'path' is not supported on Web!\");\n  }\n\n  const storage = () => {\n    if (!canUseDOM) {\n      throw new Error(\n        'Tried to access storage on the server. Did you forget to call this in useEffect?'\n      );\n    }\n    const domStorage =\n      global?.localStorage ?? window?.localStorage ?? localStorage;\n    if (domStorage == null) {\n      throw new Error(`Could not find 'localStorage' instance!`);\n    }\n    return domStorage;\n  };\n\n  const textEncoder = createTextEncoder();\n\n  return {\n    clearAll: () => storage().clear(),\n    delete: (key) => storage().removeItem(key),\n    set: (key, value) => storage().setItem(key, value.toString()),\n    getString: (key) => storage().getItem(key) ?? undefined,\n    getNumber: (key) => {\n      const value = storage().getItem(key);\n      if (value == null) return undefined;\n      return Number(value);\n    },\n    getBoolean: (key) => {\n      const value = storage().getItem(key);\n      if (value == null) return undefined;\n      return value === 'true';\n    },\n    getBuffer: (key) => {\n      const value = storage().getItem(key);\n      if (value == null) return undefined;\n      return textEncoder.encode(value);\n    },\n    getAllKeys: () => Object.keys(storage()),\n    contains: (key) => storage().getItem(key) != null,\n    recrypt: () => {\n      throw new Error('`recrypt(..)` is not supported on Web!');\n    },\n  };\n};\n"]}

package/lib/commonjs/createTextEncoder.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createTextEncoder = createTextEncoder;
+
+/* global TextEncoder */
+function createTextEncoder() {
+  if (global.TextEncoder != null) {
+    return new global.TextEncoder();
+  } else {
+    return {
+      encode: () => {
+        throw new Error('TextEncoder is not supported in this environment!');
+      },
+      encodeInto: () => {
+        throw new Error('TextEncoder is not supported in this environment!');
+      },
+      encoding: 'utf-8'
+    };
+  }
+}
+//# sourceMappingURL=createTextEncoder.js.map

package/lib/commonjs/createTextEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["createTextEncoder.ts"],"names":["createTextEncoder","global","TextEncoder","encode","Error","encodeInto","encoding"],"mappings":";;;;;;;AAAA;AACO,SAASA,iBAAT,GAA0C;AAC/C,MAAIC,MAAM,CAACC,WAAP,IAAsB,IAA1B,EAAgC;AAC9B,WAAO,IAAID,MAAM,CAACC,WAAX,EAAP;AACD,GAFD,MAEO;AACL,WAAO;AACLC,MAAAA,MAAM,EAAE,MAAM;AACZ,cAAM,IAAIC,KAAJ,CAAU,mDAAV,CAAN;AACD,OAHI;AAILC,MAAAA,UAAU,EAAE,MAAM;AAChB,cAAM,IAAID,KAAJ,CAAU,mDAAV,CAAN;AACD,OANI;AAOLE,MAAAA,QAAQ,EAAE;AAPL,KAAP;AASD;AACF","sourcesContent":["/* global TextEncoder */\nexport function createTextEncoder(): TextEncoder {\n  if (global.TextEncoder != null) {\n    return new global.TextEncoder();\n  } else {\n    return {\n      encode: () => {\n        throw new Error('TextEncoder is not supported in this environment!');\n      },\n      encodeInto: () => {\n        throw new Error('TextEncoder is not supported in this environment!');\n      },\n      encoding: 'utf-8',\n    };\n  }\n}\n"]}

package/lib/module/MMKV.js

@@ -74,6 +74,11 @@ export class MMKV {
     return func(key);
   }
 
+  getBuffer(key) {
+    const func = this.getFunctionFromCache('getBuffer');
+    return func(key);
+  }
+
   contains(key) {
     const func = this.getFunctionFromCache('contains');
     return func(key);

package/lib/module/MMKV.js.map

@@ -1 +1 @@
-{"version":3,"sources":["MMKV.ts"],"names":["createMMKV","createMockMMKV","isJest","onValueChangedListeners","Map","MMKV","constructor","configuration","id","nativeInstance","functionCache","has","set","get","getFunctionFromCache","functionName","onValuesChanged","keys","length","key","listener","value","func","getBoolean","getString","getNumber","contains","delete","getAllKeys","clearAll","recrypt","toString","join","toJSON","addOnValueChangedListener","onValueChanged","push","remove","index","indexOf","splice"],"mappings":"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","sourcesContent":["import { createMMKV } from './createMMKV';\nimport { createMockMMKV } from './createMMKV.mock';\nimport { isJest } from './PlatformChecker';\n\ninterface Listener {\n  remove: () => void;\n}\n\n/**\n * Used for configuration of a single MMKV instance.\n */\nexport interface MMKVConfiguration {\n  /**\n   * The MMKV instance's ID. If you want to use multiple instances, make sure to use different IDs!\n   *\n   * @example\n   * ```ts\n   * const userStorage = new MMKV({ id: `user-${userId}-storage` })\n   * const globalStorage = new MMKV({ id: 'global-app-storage' })\n   * ```\n   *\n   * @default 'mmkv.default'\n   */\n  id: string;\n  /**\n   * The MMKV instance's root path. By default, MMKV stores file inside `$(Documents)/mmkv/`. You can customize MMKV's root directory on MMKV initialization:\n   *\n   * @example\n   * ```ts\n   * const temporaryStorage = new MMKV({ path: '/tmp/' })\n   * ```\n   */\n  path?: string;\n  /**\n   * The MMKV instance's encryption/decryption key. By default, MMKV stores all key-values in plain text on file, relying on iOS's sandbox to make sure the file is encrypted. Should you worry about information leaking, you can choose to encrypt MMKV.\n   *\n   * Encryption keys can have a maximum length of 16 bytes.\n   *\n   * @example\n   * ```ts\n   * const secureStorage = new MMKV({ encryptionKey: 'my-encryption-key!' })\n   * ```\n   */\n  encryptionKey?: string;\n}\n\n/**\n * Represents a single MMKV instance.\n */\ninterface MMKVInterface {\n  /**\n   * Set a value for the given `key`.\n   */\n  set: (key: string, value: boolean | string | number) => void;\n  /**\n   * Get the boolean value for the given `key`, or `undefined` if it does not exist.\n   *\n   * @default undefined\n   */\n  getBoolean: (key: string) => boolean | undefined;\n  /**\n   * Get the string value for the given `key`, or `undefined` if it does not exist.\n   *\n   * @default undefined\n   */\n  getString: (key: string) => string | undefined;\n  /**\n   * Get the number value for the given `key`, or `undefined` if it does not exist.\n   *\n   * @default undefined\n   */\n  getNumber: (key: string) => number | undefined;\n  /**\n   * Checks whether the given `key` is being stored in this MMKV instance.\n   */\n  contains: (key: string) => boolean;\n  /**\n   * Delete the given `key`.\n   */\n  delete: (key: string) => void;\n  /**\n   * Get all keys.\n   *\n   * @default []\n   */\n  getAllKeys: () => string[];\n  /**\n   * Delete all keys.\n   */\n  clearAll: () => void;\n  /**\n   * Sets (or updates) the encryption-key to encrypt all data in this MMKV instance with.\n   *\n   * To remove encryption, pass `undefined` as a key.\n   *\n   * Encryption keys can have a maximum length of 16 bytes.\n   */\n  recrypt: (key: string | undefined) => void;\n  /**\n   * Adds a value changed listener. The Listener will be called whenever any value\n   * in this storage instance changes (set or delete).\n   *\n   * To unsubscribe from value changes, call `remove()` on the Listener.\n   */\n  addOnValueChangedListener: (\n    onValueChanged: (key: string) => void\n  ) => Listener;\n}\n\nexport type NativeMMKV = Pick<\n  MMKVInterface,\n  | 'clearAll'\n  | 'contains'\n  | 'delete'\n  | 'getAllKeys'\n  | 'getBoolean'\n  | 'getNumber'\n  | 'getString'\n  | 'set'\n  | 'recrypt'\n>;\n\nconst onValueChangedListeners = new Map<string, ((key: string) => void)[]>();\n\n/**\n * A single MMKV instance.\n */\nexport class MMKV implements MMKVInterface {\n  private nativeInstance: NativeMMKV;\n  private functionCache: Partial<NativeMMKV>;\n  private id: string;\n\n  /**\n   * Creates a new MMKV instance with the given Configuration.\n   * If no custom `id` is supplied, `'mmkv.default'` will be used.\n   */\n  constructor(configuration: MMKVConfiguration = { id: 'mmkv.default' }) {\n    this.id = configuration.id;\n    this.nativeInstance = isJest()\n      ? createMockMMKV()\n      : createMMKV(configuration);\n    this.functionCache = {};\n  }\n\n  private get onValueChangedListeners() {\n    if (!onValueChangedListeners.has(this.id)) {\n      onValueChangedListeners.set(this.id, []);\n    }\n    return onValueChangedListeners.get(this.id)!;\n  }\n\n  private getFunctionFromCache<T extends keyof NativeMMKV>(\n    functionName: T\n  ): NativeMMKV[T] {\n    if (this.functionCache[functionName] == null) {\n      this.functionCache[functionName] = this.nativeInstance[functionName];\n    }\n    return this.functionCache[functionName] as NativeMMKV[T];\n  }\n\n  private onValuesChanged(keys: string[]) {\n    if (this.onValueChangedListeners.length === 0) return;\n\n    for (const key of keys) {\n      for (const listener of this.onValueChangedListeners) {\n        listener(key);\n      }\n    }\n  }\n\n  set(key: string, value: boolean | string | number): void {\n    const func = this.getFunctionFromCache('set');\n    func(key, value);\n\n    this.onValuesChanged([key]);\n  }\n  getBoolean(key: string): boolean | undefined {\n    const func = this.getFunctionFromCache('getBoolean');\n    return func(key);\n  }\n  getString(key: string): string | undefined {\n    const func = this.getFunctionFromCache('getString');\n    return func(key);\n  }\n  getNumber(key: string): number | undefined {\n    const func = this.getFunctionFromCache('getNumber');\n    return func(key);\n  }\n  contains(key: string): boolean {\n    const func = this.getFunctionFromCache('contains');\n    return func(key);\n  }\n  delete(key: string): void {\n    const func = this.getFunctionFromCache('delete');\n    func(key);\n\n    this.onValuesChanged([key]);\n  }\n  getAllKeys(): string[] {\n    const func = this.getFunctionFromCache('getAllKeys');\n    return func();\n  }\n  clearAll(): void {\n    const keys = this.getAllKeys();\n\n    const func = this.getFunctionFromCache('clearAll');\n    func();\n\n    this.onValuesChanged(keys);\n  }\n  recrypt(key: string | undefined): void {\n    const func = this.getFunctionFromCache('recrypt');\n    return func(key);\n  }\n\n  toString(): string {\n    return `MMKV (${this.id}): [${this.getAllKeys().join(', ')}]`;\n  }\n  toJSON(): object {\n    return {\n      [this.id]: this.getAllKeys(),\n    };\n  }\n\n  addOnValueChangedListener(onValueChanged: (key: string) => void): Listener {\n    this.onValueChangedListeners.push(onValueChanged);\n\n    return {\n      remove: () => {\n        const index = this.onValueChangedListeners.indexOf(onValueChanged);\n        if (index !== -1) {\n          this.onValueChangedListeners.splice(index, 1);\n        }\n      },\n    };\n  }\n}\n"]}
+{"version":3,"sources":["MMKV.ts"],"names":["createMMKV","createMockMMKV","isJest","onValueChangedListeners","Map","MMKV","constructor","configuration","id","nativeInstance","functionCache","has","set","get","getFunctionFromCache","functionName","onValuesChanged","keys","length","key","listener","value","func","getBoolean","getString","getNumber","getBuffer","contains","delete","getAllKeys","clearAll","recrypt","toString","join","toJSON","addOnValueChangedListener","onValueChanged","push","remove","index","indexOf","splice"],"mappings":"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","sourcesContent":["import { createMMKV } from './createMMKV';\nimport { createMockMMKV } from './createMMKV.mock';\nimport { isJest } from './PlatformChecker';\n\ninterface Listener {\n  remove: () => void;\n}\n\n/**\n * Used for configuration of a single MMKV instance.\n */\nexport interface MMKVConfiguration {\n  /**\n   * The MMKV instance's ID. If you want to use multiple instances, make sure to use different IDs!\n   *\n   * @example\n   * ```ts\n   * const userStorage = new MMKV({ id: `user-${userId}-storage` })\n   * const globalStorage = new MMKV({ id: 'global-app-storage' })\n   * ```\n   *\n   * @default 'mmkv.default'\n   */\n  id: string;\n  /**\n   * The MMKV instance's root path. By default, MMKV stores file inside `$(Documents)/mmkv/`. You can customize MMKV's root directory on MMKV initialization:\n   *\n   * @example\n   * ```ts\n   * const temporaryStorage = new MMKV({ path: '/tmp/' })\n   * ```\n   */\n  path?: string;\n  /**\n   * The MMKV instance's encryption/decryption key. By default, MMKV stores all key-values in plain text on file, relying on iOS's sandbox to make sure the file is encrypted. Should you worry about information leaking, you can choose to encrypt MMKV.\n   *\n   * Encryption keys can have a maximum length of 16 bytes.\n   *\n   * @example\n   * ```ts\n   * const secureStorage = new MMKV({ encryptionKey: 'my-encryption-key!' })\n   * ```\n   */\n  encryptionKey?: string;\n}\n\n/**\n * Represents a single MMKV instance.\n */\ninterface MMKVInterface {\n  /**\n   * Set a value for the given `key`.\n   */\n  set: (key: string, value: boolean | string | number | Uint8Array) => void;\n  /**\n   * Get the boolean value for the given `key`, or `undefined` if it does not exist.\n   *\n   * @default undefined\n   */\n  getBoolean: (key: string) => boolean | undefined;\n  /**\n   * Get the string value for the given `key`, or `undefined` if it does not exist.\n   *\n   * @default undefined\n   */\n  getString: (key: string) => string | undefined;\n  /**\n   * Get the number value for the given `key`, or `undefined` if it does not exist.\n   *\n   * @default undefined\n   */\n  getNumber: (key: string) => number | undefined;\n  /**\n   * Get a raw buffer of unsigned 8-bit (0-255) data.\n   *\n   * @default undefined\n   */\n  getBuffer: (key: string) => Uint8Array | undefined;\n  /**\n   * Checks whether the given `key` is being stored in this MMKV instance.\n   */\n  contains: (key: string) => boolean;\n  /**\n   * Delete the given `key`.\n   */\n  delete: (key: string) => void;\n  /**\n   * Get all keys.\n   *\n   * @default []\n   */\n  getAllKeys: () => string[];\n  /**\n   * Delete all keys.\n   */\n  clearAll: () => void;\n  /**\n   * Sets (or updates) the encryption-key to encrypt all data in this MMKV instance with.\n   *\n   * To remove encryption, pass `undefined` as a key.\n   *\n   * Encryption keys can have a maximum length of 16 bytes.\n   */\n  recrypt: (key: string | undefined) => void;\n  /**\n   * Adds a value changed listener. The Listener will be called whenever any value\n   * in this storage instance changes (set or delete).\n   *\n   * To unsubscribe from value changes, call `remove()` on the Listener.\n   */\n  addOnValueChangedListener: (\n    onValueChanged: (key: string) => void\n  ) => Listener;\n}\n\nexport type NativeMMKV = Pick<\n  MMKVInterface,\n  | 'clearAll'\n  | 'contains'\n  | 'delete'\n  | 'getAllKeys'\n  | 'getBoolean'\n  | 'getNumber'\n  | 'getString'\n  | 'getBuffer'\n  | 'set'\n  | 'recrypt'\n>;\n\nconst onValueChangedListeners = new Map<string, ((key: string) => void)[]>();\n\n/**\n * A single MMKV instance.\n */\nexport class MMKV implements MMKVInterface {\n  private nativeInstance: NativeMMKV;\n  private functionCache: Partial<NativeMMKV>;\n  private id: string;\n\n  /**\n   * Creates a new MMKV instance with the given Configuration.\n   * If no custom `id` is supplied, `'mmkv.default'` will be used.\n   */\n  constructor(configuration: MMKVConfiguration = { id: 'mmkv.default' }) {\n    this.id = configuration.id;\n    this.nativeInstance = isJest()\n      ? createMockMMKV()\n      : createMMKV(configuration);\n    this.functionCache = {};\n  }\n\n  private get onValueChangedListeners() {\n    if (!onValueChangedListeners.has(this.id)) {\n      onValueChangedListeners.set(this.id, []);\n    }\n    return onValueChangedListeners.get(this.id)!;\n  }\n\n  private getFunctionFromCache<T extends keyof NativeMMKV>(\n    functionName: T\n  ): NativeMMKV[T] {\n    if (this.functionCache[functionName] == null) {\n      this.functionCache[functionName] = this.nativeInstance[functionName];\n    }\n    return this.functionCache[functionName] as NativeMMKV[T];\n  }\n\n  private onValuesChanged(keys: string[]) {\n    if (this.onValueChangedListeners.length === 0) return;\n\n    for (const key of keys) {\n      for (const listener of this.onValueChangedListeners) {\n        listener(key);\n      }\n    }\n  }\n\n  set(key: string, value: boolean | string | number | Uint8Array): void {\n    const func = this.getFunctionFromCache('set');\n    func(key, value);\n\n    this.onValuesChanged([key]);\n  }\n  getBoolean(key: string): boolean | undefined {\n    const func = this.getFunctionFromCache('getBoolean');\n    return func(key);\n  }\n  getString(key: string): string | undefined {\n    const func = this.getFunctionFromCache('getString');\n    return func(key);\n  }\n  getNumber(key: string): number | undefined {\n    const func = this.getFunctionFromCache('getNumber');\n    return func(key);\n  }\n  getBuffer(key: string): Uint8Array | undefined {\n    const func = this.getFunctionFromCache('getBuffer');\n    return func(key);\n  }\n  contains(key: string): boolean {\n    const func = this.getFunctionFromCache('contains');\n    return func(key);\n  }\n  delete(key: string): void {\n    const func = this.getFunctionFromCache('delete');\n    func(key);\n\n    this.onValuesChanged([key]);\n  }\n  getAllKeys(): string[] {\n    const func = this.getFunctionFromCache('getAllKeys');\n    return func();\n  }\n  clearAll(): void {\n    const keys = this.getAllKeys();\n\n    const func = this.getFunctionFromCache('clearAll');\n    func();\n\n    this.onValuesChanged(keys);\n  }\n  recrypt(key: string | undefined): void {\n    const func = this.getFunctionFromCache('recrypt');\n    return func(key);\n  }\n\n  toString(): string {\n    return `MMKV (${this.id}): [${this.getAllKeys().join(', ')}]`;\n  }\n  toJSON(): object {\n    return {\n      [this.id]: this.getAllKeys(),\n    };\n  }\n\n  addOnValueChangedListener(onValueChanged: (key: string) => void): Listener {\n    this.onValueChangedListeners.push(onValueChanged);\n\n    return {\n      remove: () => {\n        const index = this.onValueChangedListeners.indexOf(onValueChanged);\n        if (index !== -1) {\n          this.onValueChangedListeners.splice(index, 1);\n        }\n      },\n    };\n  }\n}\n"]}

package/lib/module/PlatformChecker.js

@@ -1,4 +1,9 @@
 export function isJest() {
+  if (global.process == null) {
+    // In a WebBrowser/Electron the `process` variable does not exist
+    return false;
+  }
+
   return process.env.JEST_WORKER_ID != null;
 }
 //# sourceMappingURL=PlatformChecker.js.map

package/lib/module/PlatformChecker.js.map

@@ -1 +1 @@
-{"version":3,"sources":["PlatformChecker.ts"],"names":["isJest","process","env","JEST_WORKER_ID"],"mappings":"AAAA,OAAO,SAASA,MAAT,GAA2B;AAChC,SAAOC,OAAO,CAACC,GAAR,CAAYC,cAAZ,IAA8B,IAArC;AACD","sourcesContent":["export function isJest(): boolean {\n  return process.env.JEST_WORKER_ID != null;\n}\n"]}
+{"version":3,"sources":["PlatformChecker.ts"],"names":["isJest","global","process","env","JEST_WORKER_ID"],"mappings":"AAAA,OAAO,SAASA,MAAT,GAA2B;AAChC,MAAIC,MAAM,CAACC,OAAP,IAAkB,IAAtB,EAA4B;AAC1B;AACA,WAAO,KAAP;AACD;;AACD,SAAOA,OAAO,CAACC,GAAR,CAAYC,cAAZ,IAA8B,IAArC;AACD","sourcesContent":["export function isJest(): boolean {\n  if (global.process == null) {\n    // In a WebBrowser/Electron the `process` variable does not exist\n    return false;\n  }\n  return process.env.JEST_WORKER_ID != null;\n}\n"]}

package/lib/module/createMMKV.mock.js

@@ -17,6 +17,10 @@ export const createMockMMKV = () => {
       const result = storage.get(key);
       return typeof result === 'boolean' ? result : undefined;
     },
+    getBuffer: key => {
+      const result = storage.get(key);
+      return result instanceof Uint8Array ? result : undefined;
+    },
     getAllKeys: () => Array.from(storage.keys()),
     contains: key => storage.has(key),
     recrypt: () => {

package/lib/module/createMMKV.mock.js.map

@@ -1 +1 @@
-{"version":3,"sources":["createMMKV.mock.ts"],"names":["createMockMMKV","storage","Map","clearAll","clear","delete","key","set","value","getString","result","get","undefined","getNumber","getBoolean","getAllKeys","Array","from","keys","contains","has","recrypt","console","warn"],"mappings":"AAEA;AACA,OAAO,MAAMA,cAAc,GAAG,MAAkB;AAC9C,QAAMC,OAAO,GAAG,IAAIC,GAAJ,EAAhB;AAEA,SAAO;AACLC,IAAAA,QAAQ,EAAE,MAAMF,OAAO,CAACG,KAAR,EADX;AAELC,IAAAA,MAAM,EAAGC,GAAD,IAASL,OAAO,CAACI,MAAR,CAAeC,GAAf,CAFZ;AAGLC,IAAAA,GAAG,EAAE,CAACD,GAAD,EAAME,KAAN,KAAgBP,OAAO,CAACM,GAAR,CAAYD,GAAZ,EAAiBE,KAAjB,CAHhB;AAILC,IAAAA,SAAS,EAAGH,GAAD,IAAS;AAClB,YAAMI,MAAM,GAAGT,OAAO,CAACU,GAAR,CAAYL,GAAZ,CAAf;AACA,aAAO,OAAOI,MAAP,KAAkB,QAAlB,GAA6BA,MAA7B,GAAsCE,SAA7C;AACD,KAPI;AAQLC,IAAAA,SAAS,EAAGP,GAAD,IAAS;AAClB,YAAMI,MAAM,GAAGT,OAAO,CAACU,GAAR,CAAYL,GAAZ,CAAf;AACA,aAAO,OAAOI,MAAP,KAAkB,QAAlB,GAA6BA,MAA7B,GAAsCE,SAA7C;AACD,KAXI;AAYLE,IAAAA,UAAU,EAAGR,GAAD,IAAS;AACnB,YAAMI,MAAM,GAAGT,OAAO,CAACU,GAAR,CAAYL,GAAZ,CAAf;AACA,aAAO,OAAOI,MAAP,KAAkB,SAAlB,GAA8BA,MAA9B,GAAuCE,SAA9C;AACD,KAfI;AAgBLG,IAAAA,UAAU,EAAE,MAAMC,KAAK,CAACC,IAAN,CAAWhB,OAAO,CAACiB,IAAR,EAAX,CAhBb;AAiBLC,IAAAA,QAAQ,EAAGb,GAAD,IAASL,OAAO,CAACmB,GAAR,CAAYd,GAAZ,CAjBd;AAkBLe,IAAAA,OAAO,EAAE,MAAM;AACbC,MAAAA,OAAO,CAACC,IAAR,CAAa,uDAAb;AACD;AApBI,GAAP;AAsBD,CAzBM","sourcesContent":["import type { NativeMMKV } from 'react-native-mmkv';\n\n/* Mock MMKV instance for use in tests */\nexport const createMockMMKV = (): NativeMMKV => {\n  const storage = new Map<string, string | boolean | number>();\n\n  return {\n    clearAll: () => storage.clear(),\n    delete: (key) => storage.delete(key),\n    set: (key, value) => storage.set(key, value),\n    getString: (key) => {\n      const result = storage.get(key);\n      return typeof result === 'string' ? result : undefined;\n    },\n    getNumber: (key) => {\n      const result = storage.get(key);\n      return typeof result === 'number' ? result : undefined;\n    },\n    getBoolean: (key) => {\n      const result = storage.get(key);\n      return typeof result === 'boolean' ? result : undefined;\n    },\n    getAllKeys: () => Array.from(storage.keys()),\n    contains: (key) => storage.has(key),\n    recrypt: () => {\n      console.warn('Encryption is not supported in mocked MMKV instances!');\n    },\n  };\n};\n"]}
+{"version":3,"sources":["createMMKV.mock.ts"],"names":["createMockMMKV","storage","Map","clearAll","clear","delete","key","set","value","getString","result","get","undefined","getNumber","getBoolean","getBuffer","Uint8Array","getAllKeys","Array","from","keys","contains","has","recrypt","console","warn"],"mappings":"AAEA;AACA,OAAO,MAAMA,cAAc,GAAG,MAAkB;AAC9C,QAAMC,OAAO,GAAG,IAAIC,GAAJ,EAAhB;AAEA,SAAO;AACLC,IAAAA,QAAQ,EAAE,MAAMF,OAAO,CAACG,KAAR,EADX;AAELC,IAAAA,MAAM,EAAGC,GAAD,IAASL,OAAO,CAACI,MAAR,CAAeC,GAAf,CAFZ;AAGLC,IAAAA,GAAG,EAAE,CAACD,GAAD,EAAME,KAAN,KAAgBP,OAAO,CAACM,GAAR,CAAYD,GAAZ,EAAiBE,KAAjB,CAHhB;AAILC,IAAAA,SAAS,EAAGH,GAAD,IAAS;AAClB,YAAMI,MAAM,GAAGT,OAAO,CAACU,GAAR,CAAYL,GAAZ,CAAf;AACA,aAAO,OAAOI,MAAP,KAAkB,QAAlB,GAA6BA,MAA7B,GAAsCE,SAA7C;AACD,KAPI;AAQLC,IAAAA,SAAS,EAAGP,GAAD,IAAS;AAClB,YAAMI,MAAM,GAAGT,OAAO,CAACU,GAAR,CAAYL,GAAZ,CAAf;AACA,aAAO,OAAOI,MAAP,KAAkB,QAAlB,GAA6BA,MAA7B,GAAsCE,SAA7C;AACD,KAXI;AAYLE,IAAAA,UAAU,EAAGR,GAAD,IAAS;AACnB,YAAMI,MAAM,GAAGT,OAAO,CAACU,GAAR,CAAYL,GAAZ,CAAf;AACA,aAAO,OAAOI,MAAP,KAAkB,SAAlB,GAA8BA,MAA9B,GAAuCE,SAA9C;AACD,KAfI;AAgBLG,IAAAA,SAAS,EAAGT,GAAD,IAAS;AAClB,YAAMI,MAAM,GAAGT,OAAO,CAACU,GAAR,CAAYL,GAAZ,CAAf;AACA,aAAOI,MAAM,YAAYM,UAAlB,GAA+BN,MAA/B,GAAwCE,SAA/C;AACD,KAnBI;AAoBLK,IAAAA,UAAU,EAAE,MAAMC,KAAK,CAACC,IAAN,CAAWlB,OAAO,CAACmB,IAAR,EAAX,CApBb;AAqBLC,IAAAA,QAAQ,EAAGf,GAAD,IAASL,OAAO,CAACqB,GAAR,CAAYhB,GAAZ,CArBd;AAsBLiB,IAAAA,OAAO,EAAE,MAAM;AACbC,MAAAA,OAAO,CAACC,IAAR,CAAa,uDAAb;AACD;AAxBI,GAAP;AA0BD,CA7BM","sourcesContent":["import type { NativeMMKV } from 'react-native-mmkv';\n\n/* Mock MMKV instance for use in tests */\nexport const createMockMMKV = (): NativeMMKV => {\n  const storage = new Map<string, string | boolean | number | Uint8Array>();\n\n  return {\n    clearAll: () => storage.clear(),\n    delete: (key) => storage.delete(key),\n    set: (key, value) => storage.set(key, value),\n    getString: (key) => {\n      const result = storage.get(key);\n      return typeof result === 'string' ? result : undefined;\n    },\n    getNumber: (key) => {\n      const result = storage.get(key);\n      return typeof result === 'number' ? result : undefined;\n    },\n    getBoolean: (key) => {\n      const result = storage.get(key);\n      return typeof result === 'boolean' ? result : undefined;\n    },\n    getBuffer: (key) => {\n      const result = storage.get(key);\n      return result instanceof Uint8Array ? result : undefined;\n    },\n    getAllKeys: () => Array.from(storage.keys()),\n    contains: (key) => storage.has(key),\n    recrypt: () => {\n      console.warn('Encryption is not supported in mocked MMKV instances!');\n    },\n  };\n};\n"]}

package/lib/module/createMMKV.web.js

@@ -1,6 +1,7 @@
 var _window$document;
 
 /* global localStorage */
+import { createTextEncoder } from './createTextEncoder';
 const canUseDOM = typeof window !== 'undefined' && ((_window$document = window.document) === null || _window$document === void 0 ? void 0 : _window$document.createElement) != null;
 export const createMMKV = config => {
   if (config.id !== 'mmkv.default') {
@@ -31,6 +32,7 @@ export const createMMKV = config => {
     return domStorage;
   };
 
+  const textEncoder = createTextEncoder();
   return {
     clearAll: () => storage().clear(),
     delete: key => storage().removeItem(key),
@@ -50,6 +52,11 @@ export const createMMKV = config => {
       if (value == null) return undefined;
       return value === 'true';
     },
+    getBuffer: key => {
+      const value = storage().getItem(key);
+      if (value == null) return undefined;
+      return textEncoder.encode(value);
+    },
     getAllKeys: () => Object.keys(storage()),
     contains: key => storage().getItem(key) != null,
     recrypt: () => {

package/lib/module/createMMKV.web.js.map

@@ -1 +1 @@
-{"version":3,"sources":["createMMKV.web.ts"],"names":["canUseDOM","window","document","createElement","createMMKV","config","id","Error","encryptionKey","path","storage","domStorage","global","localStorage","clearAll","clear","delete","key","removeItem","set","value","setItem","toString","getString","getItem","undefined","getNumber","Number","getBoolean","getAllKeys","Object","keys","contains","recrypt"],"mappings":";;AAAA;AAGA,MAAMA,SAAS,GACb,OAAOC,MAAP,KAAkB,WAAlB,IAAiC,qBAAAA,MAAM,CAACC,QAAP,sEAAiBC,aAAjB,KAAkC,IADrE;AAGA,OAAO,MAAMC,UAAU,GAAIC,MAAD,IAA2C;AACnE,MAAIA,MAAM,CAACC,EAAP,KAAc,cAAlB,EAAkC;AAChC,UAAM,IAAIC,KAAJ,CAAU,qCAAV,CAAN;AACD;;AACD,MAAIF,MAAM,CAACG,aAAP,IAAwB,IAA5B,EAAkC;AAChC,UAAM,IAAID,KAAJ,CAAU,gDAAV,CAAN;AACD;;AACD,MAAIF,MAAM,CAACI,IAAP,IAAe,IAAnB,EAAyB;AACvB,UAAM,IAAIF,KAAJ,CAAU,uCAAV,CAAN;AACD;;AAED,QAAMG,OAAO,GAAG,MAAM;AAAA;;AACpB,QAAI,CAACV,SAAL,EAAgB;AACd,YAAM,IAAIO,KAAJ,CACJ,kFADI,CAAN;AAGD;;AACD,UAAMI,UAAU,8CACdC,MADc,4CACd,QAAQC,YADM,kFACUZ,MADV,4CACU,QAAQY,YADlB,uCACkCA,YADlD;;AAEA,QAAIF,UAAU,IAAI,IAAlB,EAAwB;AACtB,YAAM,IAAIJ,KAAJ,CAAW,yCAAX,CAAN;AACD;;AACD,WAAOI,UAAP;AACD,GAZD;;AAcA,SAAO;AACLG,IAAAA,QAAQ,EAAE,MAAMJ,OAAO,GAAGK,KAAV,EADX;AAELC,IAAAA,MAAM,EAAGC,GAAD,IAASP,OAAO,GAAGQ,UAAV,CAAqBD,GAArB,CAFZ;AAGLE,IAAAA,GAAG,EAAE,CAACF,GAAD,EAAMG,KAAN,KAAgBV,OAAO,GAAGW,OAAV,CAAkBJ,GAAlB,EAAuBG,KAAK,CAACE,QAAN,EAAvB,CAHhB;AAILC,IAAAA,SAAS,EAAGN,GAAD;AAAA;;AAAA,iCAASP,OAAO,GAAGc,OAAV,CAAkBP,GAAlB,CAAT,+DAAmCQ,SAAnC;AAAA,KAJN;AAKLC,IAAAA,SAAS,EAAGT,GAAD,IAAS;AAClB,YAAMG,KAAK,GAAGV,OAAO,GAAGc,OAAV,CAAkBP,GAAlB,CAAd;AACA,UAAIG,KAAK,IAAI,IAAb,EAAmB,OAAOK,SAAP;AACnB,aAAOE,MAAM,CAACP,KAAD,CAAb;AACD,KATI;AAULQ,IAAAA,UAAU,EAAGX,GAAD,IAAS;AACnB,YAAMG,KAAK,GAAGV,OAAO,GAAGc,OAAV,CAAkBP,GAAlB,CAAd;AACA,UAAIG,KAAK,IAAI,IAAb,EAAmB,OAAOK,SAAP;AACnB,aAAOL,KAAK,KAAK,MAAjB;AACD,KAdI;AAeLS,IAAAA,UAAU,EAAE,MAAMC,MAAM,CAACC,IAAP,CAAYrB,OAAO,EAAnB,CAfb;AAgBLsB,IAAAA,QAAQ,EAAGf,GAAD,IAASP,OAAO,GAAGc,OAAV,CAAkBP,GAAlB,KAA0B,IAhBxC;AAiBLgB,IAAAA,OAAO,EAAE,MAAM;AACb,YAAM,IAAI1B,KAAJ,CAAU,wCAAV,CAAN;AACD;AAnBI,GAAP;AAqBD,CA9CM","sourcesContent":["/* global localStorage */\nimport type { MMKVConfiguration, NativeMMKV } from 'react-native-mmkv';\n\nconst canUseDOM =\n  typeof window !== 'undefined' && window.document?.createElement != null;\n\nexport const createMMKV = (config: MMKVConfiguration): NativeMMKV => {\n  if (config.id !== 'mmkv.default') {\n    throw new Error(\"MMKV: 'id' is not supported on Web!\");\n  }\n  if (config.encryptionKey != null) {\n    throw new Error(\"MMKV: 'encryptionKey' is not supported on Web!\");\n  }\n  if (config.path != null) {\n    throw new Error(\"MMKV: 'path' is not supported on Web!\");\n  }\n\n  const storage = () => {\n    if (!canUseDOM) {\n      throw new Error(\n        'Tried to access storage on the server. Did you forget to call this in useEffect?'\n      );\n    }\n    const domStorage =\n      global?.localStorage ?? window?.localStorage ?? localStorage;\n    if (domStorage == null) {\n      throw new Error(`Could not find 'localStorage' instance!`);\n    }\n    return domStorage;\n  };\n\n  return {\n    clearAll: () => storage().clear(),\n    delete: (key) => storage().removeItem(key),\n    set: (key, value) => storage().setItem(key, value.toString()),\n    getString: (key) => storage().getItem(key) ?? undefined,\n    getNumber: (key) => {\n      const value = storage().getItem(key);\n      if (value == null) return undefined;\n      return Number(value);\n    },\n    getBoolean: (key) => {\n      const value = storage().getItem(key);\n      if (value == null) return undefined;\n      return value === 'true';\n    },\n    getAllKeys: () => Object.keys(storage()),\n    contains: (key) => storage().getItem(key) != null,\n    recrypt: () => {\n      throw new Error('`recrypt(..)` is not supported on Web!');\n    },\n  };\n};\n"]}
+{"version":3,"sources":["createMMKV.web.ts"],"names":["createTextEncoder","canUseDOM","window","document","createElement","createMMKV","config","id","Error","encryptionKey","path","storage","domStorage","global","localStorage","textEncoder","clearAll","clear","delete","key","removeItem","set","value","setItem","toString","getString","getItem","undefined","getNumber","Number","getBoolean","getBuffer","encode","getAllKeys","Object","keys","contains","recrypt"],"mappings":";;AAAA;AAEA,SAASA,iBAAT,QAAkC,qBAAlC;AAEA,MAAMC,SAAS,GACb,OAAOC,MAAP,KAAkB,WAAlB,IAAiC,qBAAAA,MAAM,CAACC,QAAP,sEAAiBC,aAAjB,KAAkC,IADrE;AAGA,OAAO,MAAMC,UAAU,GAAIC,MAAD,IAA2C;AACnE,MAAIA,MAAM,CAACC,EAAP,KAAc,cAAlB,EAAkC;AAChC,UAAM,IAAIC,KAAJ,CAAU,qCAAV,CAAN;AACD;;AACD,MAAIF,MAAM,CAACG,aAAP,IAAwB,IAA5B,EAAkC;AAChC,UAAM,IAAID,KAAJ,CAAU,gDAAV,CAAN;AACD;;AACD,MAAIF,MAAM,CAACI,IAAP,IAAe,IAAnB,EAAyB;AACvB,UAAM,IAAIF,KAAJ,CAAU,uCAAV,CAAN;AACD;;AAED,QAAMG,OAAO,GAAG,MAAM;AAAA;;AACpB,QAAI,CAACV,SAAL,EAAgB;AACd,YAAM,IAAIO,KAAJ,CACJ,kFADI,CAAN;AAGD;;AACD,UAAMI,UAAU,8CACdC,MADc,4CACd,QAAQC,YADM,kFACUZ,MADV,4CACU,QAAQY,YADlB,uCACkCA,YADlD;;AAEA,QAAIF,UAAU,IAAI,IAAlB,EAAwB;AACtB,YAAM,IAAIJ,KAAJ,CAAW,yCAAX,CAAN;AACD;;AACD,WAAOI,UAAP;AACD,GAZD;;AAcA,QAAMG,WAAW,GAAGf,iBAAiB,EAArC;AAEA,SAAO;AACLgB,IAAAA,QAAQ,EAAE,MAAML,OAAO,GAAGM,KAAV,EADX;AAELC,IAAAA,MAAM,EAAGC,GAAD,IAASR,OAAO,GAAGS,UAAV,CAAqBD,GAArB,CAFZ;AAGLE,IAAAA,GAAG,EAAE,CAACF,GAAD,EAAMG,KAAN,KAAgBX,OAAO,GAAGY,OAAV,CAAkBJ,GAAlB,EAAuBG,KAAK,CAACE,QAAN,EAAvB,CAHhB;AAILC,IAAAA,SAAS,EAAGN,GAAD;AAAA;;AAAA,iCAASR,OAAO,GAAGe,OAAV,CAAkBP,GAAlB,CAAT,+DAAmCQ,SAAnC;AAAA,KAJN;AAKLC,IAAAA,SAAS,EAAGT,GAAD,IAAS;AAClB,YAAMG,KAAK,GAAGX,OAAO,GAAGe,OAAV,CAAkBP,GAAlB,CAAd;AACA,UAAIG,KAAK,IAAI,IAAb,EAAmB,OAAOK,SAAP;AACnB,aAAOE,MAAM,CAACP,KAAD,CAAb;AACD,KATI;AAULQ,IAAAA,UAAU,EAAGX,GAAD,IAAS;AACnB,YAAMG,KAAK,GAAGX,OAAO,GAAGe,OAAV,CAAkBP,GAAlB,CAAd;AACA,UAAIG,KAAK,IAAI,IAAb,EAAmB,OAAOK,SAAP;AACnB,aAAOL,KAAK,KAAK,MAAjB;AACD,KAdI;AAeLS,IAAAA,SAAS,EAAGZ,GAAD,IAAS;AAClB,YAAMG,KAAK,GAAGX,OAAO,GAAGe,OAAV,CAAkBP,GAAlB,CAAd;AACA,UAAIG,KAAK,IAAI,IAAb,EAAmB,OAAOK,SAAP;AACnB,aAAOZ,WAAW,CAACiB,MAAZ,CAAmBV,KAAnB,CAAP;AACD,KAnBI;AAoBLW,IAAAA,UAAU,EAAE,MAAMC,MAAM,CAACC,IAAP,CAAYxB,OAAO,EAAnB,CApBb;AAqBLyB,IAAAA,QAAQ,EAAGjB,GAAD,IAASR,OAAO,GAAGe,OAAV,CAAkBP,GAAlB,KAA0B,IArBxC;AAsBLkB,IAAAA,OAAO,EAAE,MAAM;AACb,YAAM,IAAI7B,KAAJ,CAAU,wCAAV,CAAN;AACD;AAxBI,GAAP;AA0BD,CArDM","sourcesContent":["/* global localStorage */\nimport type { MMKVConfiguration, NativeMMKV } from 'react-native-mmkv';\nimport { createTextEncoder } from './createTextEncoder';\n\nconst canUseDOM =\n  typeof window !== 'undefined' && window.document?.createElement != null;\n\nexport const createMMKV = (config: MMKVConfiguration): NativeMMKV => {\n  if (config.id !== 'mmkv.default') {\n    throw new Error(\"MMKV: 'id' is not supported on Web!\");\n  }\n  if (config.encryptionKey != null) {\n    throw new Error(\"MMKV: 'encryptionKey' is not supported on Web!\");\n  }\n  if (config.path != null) {\n    throw new Error(\"MMKV: 'path' is not supported on Web!\");\n  }\n\n  const storage = () => {\n    if (!canUseDOM) {\n      throw new Error(\n        'Tried to access storage on the server. Did you forget to call this in useEffect?'\n      );\n    }\n    const domStorage =\n      global?.localStorage ?? window?.localStorage ?? localStorage;\n    if (domStorage == null) {\n      throw new Error(`Could not find 'localStorage' instance!`);\n    }\n    return domStorage;\n  };\n\n  const textEncoder = createTextEncoder();\n\n  return {\n    clearAll: () => storage().clear(),\n    delete: (key) => storage().removeItem(key),\n    set: (key, value) => storage().setItem(key, value.toString()),\n    getString: (key) => storage().getItem(key) ?? undefined,\n    getNumber: (key) => {\n      const value = storage().getItem(key);\n      if (value == null) return undefined;\n      return Number(value);\n    },\n    getBoolean: (key) => {\n      const value = storage().getItem(key);\n      if (value == null) return undefined;\n      return value === 'true';\n    },\n    getBuffer: (key) => {\n      const value = storage().getItem(key);\n      if (value == null) return undefined;\n      return textEncoder.encode(value);\n    },\n    getAllKeys: () => Object.keys(storage()),\n    contains: (key) => storage().getItem(key) != null,\n    recrypt: () => {\n      throw new Error('`recrypt(..)` is not supported on Web!');\n    },\n  };\n};\n"]}

package/lib/module/createTextEncoder.js

@@ -0,0 +1,17 @@
+/* global TextEncoder */
+export function createTextEncoder() {
+  if (global.TextEncoder != null) {
+    return new global.TextEncoder();
+  } else {
+    return {
+      encode: () => {
+        throw new Error('TextEncoder is not supported in this environment!');
+      },
+      encodeInto: () => {
+        throw new Error('TextEncoder is not supported in this environment!');
+      },
+      encoding: 'utf-8'
+    };
+  }
+}
+//# sourceMappingURL=createTextEncoder.js.map

package/lib/module/createTextEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["createTextEncoder.ts"],"names":["createTextEncoder","global","TextEncoder","encode","Error","encodeInto","encoding"],"mappings":"AAAA;AACA,OAAO,SAASA,iBAAT,GAA0C;AAC/C,MAAIC,MAAM,CAACC,WAAP,IAAsB,IAA1B,EAAgC;AAC9B,WAAO,IAAID,MAAM,CAACC,WAAX,EAAP;AACD,GAFD,MAEO;AACL,WAAO;AACLC,MAAAA,MAAM,EAAE,MAAM;AACZ,cAAM,IAAIC,KAAJ,CAAU,mDAAV,CAAN;AACD,OAHI;AAILC,MAAAA,UAAU,EAAE,MAAM;AAChB,cAAM,IAAID,KAAJ,CAAU,mDAAV,CAAN;AACD,OANI;AAOLE,MAAAA,QAAQ,EAAE;AAPL,KAAP;AASD;AACF","sourcesContent":["/* global TextEncoder */\nexport function createTextEncoder(): TextEncoder {\n  if (global.TextEncoder != null) {\n    return new global.TextEncoder();\n  } else {\n    return {\n      encode: () => {\n        throw new Error('TextEncoder is not supported in this environment!');\n      },\n      encodeInto: () => {\n        throw new Error('TextEncoder is not supported in this environment!');\n      },\n      encoding: 'utf-8',\n    };\n  }\n}\n"]}

package/lib/typescript/MMKV.d.ts

@@ -45,7 +45,7 @@ interface MMKVInterface {
     /**
      * Set a value for the given `key`.
      */
-    set: (key: string, value: boolean | string | number) => void;
+    set: (key: string, value: boolean | string | number | Uint8Array) => void;
     /**
      * Get the boolean value for the given `key`, or `undefined` if it does not exist.
      *
@@ -64,6 +64,12 @@ interface MMKVInterface {
      * @default undefined
      */
     getNumber: (key: string) => number | undefined;
+    /**
+     * Get a raw buffer of unsigned 8-bit (0-255) data.
+     *
+     * @default undefined
+     */
+    getBuffer: (key: string) => Uint8Array | undefined;
     /**
      * Checks whether the given `key` is being stored in this MMKV instance.
      */
@@ -98,7 +104,7 @@ interface MMKVInterface {
      */
     addOnValueChangedListener: (onValueChanged: (key: string) => void) => Listener;
 }
-export declare type NativeMMKV = Pick<MMKVInterface, 'clearAll' | 'contains' | 'delete' | 'getAllKeys' | 'getBoolean' | 'getNumber' | 'getString' | 'set' | 'recrypt'>;
+export declare type NativeMMKV = Pick<MMKVInterface, 'clearAll' | 'contains' | 'delete' | 'getAllKeys' | 'getBoolean' | 'getNumber' | 'getString' | 'getBuffer' | 'set' | 'recrypt'>;
 /**
  * A single MMKV instance.
  */
@@ -114,10 +120,11 @@ export declare class MMKV implements MMKVInterface {
     private get onValueChangedListeners();
     private getFunctionFromCache;
     private onValuesChanged;
-    set(key: string, value: boolean | string | number): void;
+    set(key: string, value: boolean | string | number | Uint8Array): void;
     getBoolean(key: string): boolean | undefined;
     getString(key: string): string | undefined;
     getNumber(key: string): number | undefined;
+    getBuffer(key: string): Uint8Array | undefined;
     contains(key: string): boolean;
     delete(key: string): void;
     getAllKeys(): string[];

package/lib/typescript/createTextEncoder.d.ts

@@ -0,0 +1 @@
+export declare function createTextEncoder(): TextEncoder;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-mmkv",
-  "version": "2.4.3",
+  "version": "2.5.0",
   "description": "The fastest key/value storage for React Native. ~30x faster than AsyncStorage! Works on Android, iOS and Web.",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -12,6 +12,7 @@
     "android/build.gradle",
     "android/gradle.properties",
     "android/CMakeLists.txt",
+    "cpp",
     "MMKV/Core",
     "lib/commonjs",
     "lib/module",
@@ -159,7 +160,7 @@
       [
         "typescript",
         {
-          "project": "tsconfig.build.json"
+          "project": "tsconfig.json"
         }
       ]
     ]

package/react-native-mmkv.podspec

@@ -17,7 +17,8 @@ Pod::Spec.new do |s|
   # Note how this does not include headers, since those can nameclash.
   s.source_files = [
     "ios/**/*.{m,mm}",
-    "ios/MmkvModule.h"
+    "ios/MmkvModule.h",
+    "cpp/**/*.{h,cpp}"
   ]
   # Any private headers that are not globally unique should be mentioned here.
   # Otherwise there will be a nameclash, since CocoaPods flattens out any header directories