react-native-mmkv 2.1.1 → 2.3.0

package/ios/JSIUtils.mm

@@ -29,6 +29,7 @@ jsi::String convertNSStringToJSIString(jsi::Runtime &runtime, NSString *value)
 }
 
 jsi::Value convertObjCObjectToJSIValue(jsi::Runtime &runtime, id value);
+
 jsi::Object convertNSDictionaryToJSIObject(jsi::Runtime &runtime, NSDictionary *value)
 {
     jsi::Object result = jsi::Object(runtime);
@@ -75,16 +76,14 @@ jsi::Value convertObjCObjectToJSIValue(jsi::Runtime &runtime, id value)
     return jsi::Value::undefined();
 }
 
-id convertJSIValueToObjCObject(
-                               jsi::Runtime &runtime,
-                               const jsi::Value &value);
+id convertJSIValueToObjCObject(jsi::Runtime &runtime, const jsi::Value &value);
+
 NSString *convertJSIStringToNSString(jsi::Runtime &runtime, const jsi::String &value)
 {
     return [NSString stringWithUTF8String:value.utf8(runtime).c_str()];
 }
 
-NSArray *convertJSIArrayToNSArray(
-                                  jsi::Runtime &runtime,
+NSArray *convertJSIArrayToNSArray(jsi::Runtime &runtime,
                                   const jsi::Array &value)
 {
     size_t size = value.size(runtime);
@@ -97,8 +96,7 @@ NSArray *convertJSIArrayToNSArray(
     return [result copy];
 }
 
-NSDictionary *convertJSIObjectToNSDictionary(
-                                             jsi::Runtime &runtime,
+NSDictionary *convertJSIObjectToNSDictionary(jsi::Runtime &runtime,
                                              const jsi::Object &value)
 {
     jsi::Array propertyNames = value.getPropertyNames(runtime);
@@ -115,8 +113,7 @@ NSDictionary *convertJSIObjectToNSDictionary(
     return [result copy];
 }
 
-RCTResponseSenderBlock convertJSIFunctionToCallback(
-                                                    jsi::Runtime &runtime,
+RCTResponseSenderBlock convertJSIFunctionToCallback(jsi::Runtime &runtime,
                                                     const jsi::Function &value)
 {
     __block auto cb = value.getFunction(runtime);
@@ -126,8 +123,7 @@ RCTResponseSenderBlock convertJSIFunctionToCallback(
     };
 }
 
-id convertJSIValueToObjCObject(
-                               jsi::Runtime &runtime,
+id convertJSIValueToObjCObject(jsi::Runtime &runtime,
                                const jsi::Value &value)
 {
     if (value.isUndefined() || value.isNull()) {
@@ -148,7 +144,8 @@ id convertJSIValueToObjCObject(
             return convertJSIArrayToNSArray(runtime, o.getArray(runtime));
         }
         if (o.isFunction(runtime)) {
-            return convertJSIFunctionToCallback(runtime, std::move(o.getFunction(runtime)));
+            return convertJSIFunctionToCallback(runtime,
+                                                std::move(o.getFunction(runtime)));
         }
         return convertJSIObjectToNSDictionary(runtime, o);
     }
@@ -159,34 +156,36 @@ id convertJSIValueToObjCObject(
 Promise::Promise(jsi::Runtime &rt, jsi::Function resolve, jsi::Function reject)
 : runtime_(rt), resolve_(std::move(resolve)), reject_(std::move(reject)) {}
 
-void Promise::resolve(const jsi::Value &result) {
+void Promise::resolve(const jsi::Value &result)
+{
     resolve_.call(runtime_, result);
 }
 
-void Promise::reject(const std::string &message) {
+void Promise::reject(const std::string &message)
+{
     jsi::Object error(runtime_);
-    error.setProperty(
-                      runtime_, "message", jsi::String::createFromUtf8(runtime_, message));
+    error.setProperty(runtime_,
+                      "message",
+                      jsi::String::createFromUtf8(runtime_, message));
     reject_.call(runtime_, error);
 }
 
-jsi::Value createPromiseAsJSIValue(
-                                   jsi::Runtime &rt,
-                                   const PromiseSetupFunctionType func) {
+jsi::Value createPromiseAsJSIValue(jsi::Runtime &rt,
+                                   const PromiseSetupFunctionType func)
+{
     jsi::Function JSPromise = rt.global().getPropertyAsFunction(rt, "Promise");
-    jsi::Function fn = jsi::Function::createFromHostFunction(
-                                                             rt,
+    jsi::Function fn = jsi::Function::createFromHostFunction(rt,
                                                              jsi::PropNameID::forAscii(rt, "fn"),
                                                              2,
-                                                             [func](
-                                                                    jsi::Runtime &rt2,
+                                                             [func](jsi::Runtime &rt2,
                                                                     const jsi::Value &thisVal,
                                                                     const jsi::Value *args,
                                                                     size_t count) {
         jsi::Function resolve = args[0].getObject(rt2).getFunction(rt2);
         jsi::Function reject = args[1].getObject(rt2).getFunction(rt2);
-        auto wrapper = std::make_shared<Promise>(
-                                                 rt2, std::move(resolve), std::move(reject));
+        auto wrapper = std::make_shared<Promise>(rt2,
+                                                 std::move(resolve),
+                                                 std::move(reject));
         func(rt2, wrapper);
         return jsi::Value::undefined();
     });

package/ios/MmkvHostObject.mm

@@ -10,7 +10,8 @@
 #import "MmkvHostObject.h"
 #import "JSIUtils.h"
 
-MmkvHostObject::MmkvHostObject(NSString* instanceId, NSString* path, NSString* cryptKey) {
+MmkvHostObject::MmkvHostObject(NSString* instanceId, NSString* path, NSString* cryptKey)
+{
   NSData* cryptData = cryptKey == nil ? nil : [cryptKey dataUsingEncoding:NSUTF8StringEncoding];
   instance = [MMKV mmkvWithID:instanceId cryptKey:cryptData rootPath:path];
 
@@ -36,7 +37,8 @@ MmkvHostObject::MmkvHostObject(NSString* instanceId, NSString* path, NSString* c
   }
 }
 
-std::vector<jsi::PropNameID> MmkvHostObject::getPropertyNames(jsi::Runtime& rt) {
+std::vector<jsi::PropNameID> MmkvHostObject::getPropertyNames(jsi::Runtime& rt)
+{
   std::vector<jsi::PropNameID> result;
   result.push_back(jsi::PropNameID::forUtf8(rt, std::string("set")));
   result.push_back(jsi::PropNameID::forUtf8(rt, std::string("getBoolean")));
@@ -50,7 +52,8 @@ std::vector<jsi::PropNameID> MmkvHostObject::getPropertyNames(jsi::Runtime& rt)
   return result;
 }
 
-jsi::Value MmkvHostObject::get(jsi::Runtime& runtime, const jsi::PropNameID& propNameId) {
+jsi::Value MmkvHostObject::get(jsi::Runtime& runtime, const jsi::PropNameID& propNameId)
+{
   auto propName = propNameId.utf8(runtime);
   auto funcName = "MMKV." + propName;
 
@@ -63,9 +66,11 @@ jsi::Value MmkvHostObject::get(jsi::Runtime& runtime, const jsi::PropNameID& pro
                                                         const jsi::Value& thisValue,
                                                         const jsi::Value* arguments,
                                                         size_t count) -> jsi::Value {
-      if (!arguments[0].isString()) throw jsi::JSError(runtime, "MMKV::set: First argument ('key') has to be of type string!");
-      auto keyName = convertJSIStringToNSString(runtime, arguments[0].getString(runtime));
+      if (!arguments[0].isString()) {
+        throw jsi::JSError(runtime, "MMKV::set: First argument ('key') has to be of type string!");
+      }
 
+      auto keyName = convertJSIStringToNSString(runtime, arguments[0].getString(runtime));
       if (arguments[1].isBool()) {
         [instance setBool:arguments[1].getBool() forKey:keyName];
       } else if (arguments[1].isNumber()) {
@@ -74,8 +79,9 @@ jsi::Value MmkvHostObject::get(jsi::Runtime& runtime, const jsi::PropNameID& pro
         auto stringValue = convertJSIStringToNSString(runtime, arguments[1].getString(runtime));
         [instance setString:stringValue forKey:keyName];
       } else {
-        throw jsi::JSError(runtime, "MMKV::set: 'value' argument is not of type bool, number or string!");
+        throw jsi::JSError(runtime, "Second argument ('value') has to be of type bool, number or string!");
       }
+
       return jsi::Value::undefined();
     });
   }
@@ -89,11 +95,18 @@ jsi::Value MmkvHostObject::get(jsi::Runtime& runtime, const jsi::PropNameID& pro
                                                         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!");
+      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));
-      bool value = [instance getBoolForKey:keyName];
-      return jsi::Value(value);
+      bool hasValue;
+      auto value = [instance getBoolForKey:keyName defaultValue:false hasValue:&hasValue];
+      if (hasValue) {
+        return jsi::Value(value);
+      } else {
+        return jsi::Value::undefined();
+      }
     });
   }
 
@@ -106,14 +119,17 @@ jsi::Value MmkvHostObject::get(jsi::Runtime& runtime, const jsi::PropNameID& pro
                                                         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!");
+      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 value = [instance getStringForKey:keyName];
-      if (value != nil)
+      if (value != nil) {
         return convertNSStringToJSIString(runtime, value);
-      else
+      } else {
         return jsi::Value::undefined();
+      }
     });
   }
 
@@ -126,11 +142,18 @@ jsi::Value MmkvHostObject::get(jsi::Runtime& runtime, const jsi::PropNameID& pro
                                                         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!");
+      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 value = [instance getDoubleForKey:keyName];
-      return jsi::Value(value);
+      bool hasValue;
+      auto value = [instance getDoubleForKey:keyName defaultValue:0.0 hasValue:&hasValue];
+      if (hasValue) {
+        return jsi::Value(value);
+      } else {
+        return jsi::Value::undefined();
+      }
     });
   }
 
@@ -143,7 +166,9 @@ jsi::Value MmkvHostObject::get(jsi::Runtime& runtime, const jsi::PropNameID& pro
                                                         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!");
+      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));
       bool containsKey = [instance containsKey:keyName];
@@ -160,7 +185,9 @@ jsi::Value MmkvHostObject::get(jsi::Runtime& runtime, const jsi::PropNameID& pro
                                                         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!");
+      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));
       [instance removeValueForKey:keyName];

package/ios/MmkvModule.mm

@@ -14,7 +14,10 @@ using namespace facebook;
 
 RCT_EXPORT_MODULE(MMKV)
 
-+ (NSString*)getPropertyAsStringOrNilFromObject:(jsi::Object&)object propertyName:(std::string)propertyName runtime:(jsi::Runtime&)runtime {
++ (NSString*)getPropertyAsStringOrNilFromObject:(jsi::Object&)object
+                                   propertyName:(std::string)propertyName
+                                        runtime:(jsi::Runtime&)runtime
+{
     jsi::Value value = object.getProperty(runtime, propertyName.c_str());
     std::string string = value.isString() ? value.asString(runtime).utf8(runtime) : "";
     return string.length() > 0 ? [NSString stringWithUTF8String:string.c_str()] : nil;

package/lib/commonjs/MMKV.js

@@ -0,0 +1,142 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.MMKV = void 0;
+
+var _reactNative = require("react-native");
+
+var _createMMKV = require("./createMMKV");
+
+function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+
+const onValueChangedListeners = new Map();
+/**
+ * A single MMKV instance.
+ */
+
+class MMKV {
+  /**
+   * Creates a new MMKV instance with the given Configuration.
+   * If no custom `id` is supplied, `'mmkv.default'` will be used.
+   */
+  constructor(configuration = {
+    id: 'mmkv.default'
+  }) {
+    _defineProperty(this, "nativeInstance", void 0);
+
+    _defineProperty(this, "functionCache", void 0);
+
+    _defineProperty(this, "id", void 0);
+
+    this.id = configuration.id;
+    this.nativeInstance = (0, _createMMKV.createMMKV)(configuration);
+    this.functionCache = {};
+  }
+
+  get onValueChangedListeners() {
+    if (!onValueChangedListeners.has(this.id)) {
+      onValueChangedListeners.set(this.id, []);
+    }
+
+    return onValueChangedListeners.get(this.id);
+  }
+
+  getFunctionFromCache(functionName) {
+    if (this.functionCache[functionName] == null) {
+      this.functionCache[functionName] = this.nativeInstance[functionName];
+    }
+
+    return this.functionCache[functionName];
+  }
+
+  onValuesAboutToChange(keys) {
+    if (this.onValueChangedListeners.length === 0) return;
+    setImmediate(() => {
+      (0, _reactNative.unstable_batchedUpdates)(() => {
+        for (const key of keys) {
+          for (const listener of this.onValueChangedListeners) {
+            listener(key);
+          }
+        }
+      });
+    });
+  }
+
+  set(key, value) {
+    this.onValuesAboutToChange([key]);
+    const func = this.getFunctionFromCache('set');
+    return func(key, value);
+  }
+
+  getBoolean(key) {
+    const func = this.getFunctionFromCache('getBoolean');
+    return func(key);
+  }
+
+  getString(key) {
+    const func = this.getFunctionFromCache('getString');
+    return func(key);
+  }
+
+  getNumber(key) {
+    const func = this.getFunctionFromCache('getNumber');
+    return func(key);
+  }
+
+  contains(key) {
+    const func = this.getFunctionFromCache('contains');
+    return func(key);
+  }
+
+  delete(key) {
+    this.onValuesAboutToChange([key]);
+    const func = this.getFunctionFromCache('delete');
+    return func(key);
+  }
+
+  getAllKeys() {
+    const func = this.getFunctionFromCache('getAllKeys');
+    return func();
+  }
+
+  clearAll() {
+    const keys = this.getAllKeys();
+    this.onValuesAboutToChange(keys);
+    const func = this.getFunctionFromCache('clearAll');
+    return func();
+  }
+
+  recrypt(key) {
+    const func = this.getFunctionFromCache('recrypt');
+    return func(key);
+  }
+
+  toString() {
+    return `MMKV (${this.id}): [${this.getAllKeys().join(', ')}]`;
+  }
+
+  toJSON() {
+    return {
+      [this.id]: this.getAllKeys()
+    };
+  }
+
+  addOnValueChangedListener(onValueChanged) {
+    this.onValueChangedListeners.push(onValueChanged);
+    return {
+      remove: () => {
+        const index = this.onValueChangedListeners.indexOf(onValueChanged);
+
+        if (index !== -1) {
+          this.onValueChangedListeners.splice(index, 1);
+        }
+      }
+    };
+  }
+
+}
+
+exports.MMKV = MMKV;
+//# sourceMappingURL=MMKV.js.map

package/lib/commonjs/MMKV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["MMKV.ts"],"names":["onValueChangedListeners","Map","MMKV","constructor","configuration","id","nativeInstance","functionCache","has","set","get","getFunctionFromCache","functionName","onValuesAboutToChange","keys","length","setImmediate","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 { unstable_batchedUpdates } from 'react-native';\nimport { createMMKV } from './createMMKV';\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 = 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 onValuesAboutToChange(keys: string[]) {\n    if (this.onValueChangedListeners.length === 0) return;\n\n    setImmediate(() => {\n      unstable_batchedUpdates(() => {\n        for (const key of keys) {\n          for (const listener of this.onValueChangedListeners) {\n            listener(key);\n          }\n        }\n      });\n    });\n  }\n\n  set(key: string, value: boolean | string | number): void {\n    this.onValuesAboutToChange([key]);\n\n    const func = this.getFunctionFromCache('set');\n    return func(key, value);\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    this.onValuesAboutToChange([key]);\n\n    const func = this.getFunctionFromCache('delete');\n    return func(key);\n  }\n  getAllKeys(): string[] {\n    const func = this.getFunctionFromCache('getAllKeys');\n    return func();\n  }\n  clearAll(): void {\n    const keys = this.getAllKeys();\n    this.onValuesAboutToChange(keys);\n\n    const func = this.getFunctionFromCache('clearAll');\n    return func();\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/createMMKV.js

@@ -0,0 +1,66 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createMMKV = void 0;
+
+var _reactNative = require("react-native");
+
+// Root directory of all MMKV stores
+const ROOT_DIRECTORY = null;
+
+const createMMKV = config => {
+  // Check if the constructor exists. If not, try installing the JSI bindings.
+  if (global.mmkvCreateNewInstance == null) {
+    // Get the native MMKV ReactModule
+    const MMKVModule = _reactNative.NativeModules.MMKV;
+
+    if (MMKVModule == null) {
+      var _NativeModules$Native, _NativeModules$Native2;
+
+      let message = 'Failed to create a new MMKV instance: The native MMKV Module could not be found.';
+      message += '\n* Make sure react-native-mmkv is correctly autolinked (run `npx react-native config` to verify)';
+
+      if (_reactNative.Platform.OS === 'ios' || _reactNative.Platform.OS === 'macos') {
+        message += '\n* Make sure you ran `pod install` in the ios/ directory.';
+      }
+
+      if (_reactNative.Platform.OS === 'android') {
+        message += '\n* Make sure gradle is synced.';
+      } // check if Expo
+
+
+      const ExpoConstants = (_NativeModules$Native = _reactNative.NativeModules.NativeUnimoduleProxy) === null || _NativeModules$Native === void 0 ? void 0 : (_NativeModules$Native2 = _NativeModules$Native.modulesConstants) === null || _NativeModules$Native2 === void 0 ? void 0 : _NativeModules$Native2.ExponentConstants;
+
+      if (ExpoConstants != null) {
+        if (ExpoConstants.appOwnership === 'expo') {
+          // We're running Expo Go
+          throw new Error('react-native-mmkv is not supported in Expo Go! Use EAS (`expo prebuild`) or eject to a bare workflow instead.');
+        } else {
+          // We're running Expo bare / standalone
+          message += '\n* Make sure you ran `expo prebuild`.';
+        }
+      }
+
+      message += '\n* Make sure you rebuilt the app.';
+      throw new Error(message);
+    } // Check if we are running on-device (JSI)
+
+
+    if (global.nativeCallSyncHook == null || MMKVModule.install == null) {
+      throw new Error('Failed to create a new MMKV instance: React Native is not running on-device. MMKV can only be used when synchronous method invocations (JSI) are possible. If you are using a remote debugger (e.g. Chrome), switch to an on-device debugger (e.g. Flipper) instead.');
+    } // Call the synchronous blocking install() function
+
+
+    const result = MMKVModule.install(ROOT_DIRECTORY);
+    if (result !== true) throw new Error(`Failed to create a new MMKV instance: The native MMKV Module could not be installed! Looks like something went wrong when installing JSI bindings: ${result}`); // Check again if the constructor now exists. If not, throw an error.
+
+    if (global.mmkvCreateNewInstance == null) throw new Error('Failed to create a new MMKV instance, the native initializer function does not exist. Are you trying to use MMKV from different JS Runtimes?');
+  }
+
+  return global.mmkvCreateNewInstance(config);
+};
+
+exports.createMMKV = createMMKV;
+//# sourceMappingURL=createMMKV.js.map

package/lib/commonjs/createMMKV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["createMMKV.ts"],"names":["ROOT_DIRECTORY","createMMKV","config","global","mmkvCreateNewInstance","MMKVModule","NativeModules","MMKV","message","Platform","OS","ExpoConstants","NativeUnimoduleProxy","modulesConstants","ExponentConstants","appOwnership","Error","nativeCallSyncHook","install","result"],"mappings":";;;;;;;AAAA;;AASA;AACA,MAAMA,cAA6B,GAAG,IAAtC;;AAEO,MAAMC,UAAU,GAAIC,MAAD,IAA2C;AACnE;AACA,MAAIC,MAAM,CAACC,qBAAP,IAAgC,IAApC,EAA0C;AACxC;AACA,UAAMC,UAAU,GAAGC,2BAAcC,IAAjC;;AACA,QAAIF,UAAU,IAAI,IAAlB,EAAwB;AAAA;;AACtB,UAAIG,OAAO,GACT,kFADF;AAEAA,MAAAA,OAAO,IACL,mGADF;;AAEA,UAAIC,sBAASC,EAAT,KAAgB,KAAhB,IAAyBD,sBAASC,EAAT,KAAgB,OAA7C,EAAsD;AACpDF,QAAAA,OAAO,IAAI,4DAAX;AACD;;AACD,UAAIC,sBAASC,EAAT,KAAgB,SAApB,EAA+B;AAC7BF,QAAAA,OAAO,IAAI,iCAAX;AACD,OAVqB,CAWtB;;;AACA,YAAMG,aAAa,4BACjBL,2BAAcM,oBADG,oFACjB,sBAAoCC,gBADnB,2DACjB,uBAAsDC,iBADxD;;AAEA,UAAIH,aAAa,IAAI,IAArB,EAA2B;AACzB,YAAIA,aAAa,CAACI,YAAd,KAA+B,MAAnC,EAA2C;AACzC;AACA,gBAAM,IAAIC,KAAJ,CACJ,+GADI,CAAN;AAGD,SALD,MAKO;AACL;AACAR,UAAAA,OAAO,IAAI,wCAAX;AACD;AACF;;AAEDA,MAAAA,OAAO,IAAI,oCAAX;AACA,YAAM,IAAIQ,KAAJ,CAAUR,OAAV,CAAN;AACD,KA/BuC,CAiCxC;;;AACA,QAAIL,MAAM,CAACc,kBAAP,IAA6B,IAA7B,IAAqCZ,UAAU,CAACa,OAAX,IAAsB,IAA/D,EAAqE;AACnE,YAAM,IAAIF,KAAJ,CACJ,sQADI,CAAN;AAGD,KAtCuC,CAwCxC;;;AACA,UAAMG,MAAM,GAAGd,UAAU,CAACa,OAAX,CAAmBlB,cAAnB,CAAf;AACA,QAAImB,MAAM,KAAK,IAAf,EACE,MAAM,IAAIH,KAAJ,CACH,sJAAqJG,MAAO,EADzJ,CAAN,CA3CsC,CA+CxC;;AACA,QAAIhB,MAAM,CAACC,qBAAP,IAAgC,IAApC,EACE,MAAM,IAAIY,KAAJ,CACJ,8IADI,CAAN;AAGH;;AAED,SAAOb,MAAM,CAACC,qBAAP,CAA6BF,MAA7B,CAAP;AACD,CAzDM","sourcesContent":["import { NativeModules, Platform } from 'react-native';\nimport type { MMKVConfiguration, NativeMMKV } from 'react-native-mmkv';\n\n// global func declaration for JSI functions\ndeclare global {\n  function mmkvCreateNewInstance(configuration: MMKVConfiguration): NativeMMKV;\n  function nativeCallSyncHook(): unknown;\n}\n\n// Root directory of all MMKV stores\nconst ROOT_DIRECTORY: string | null = null;\n\nexport const createMMKV = (config: MMKVConfiguration): NativeMMKV => {\n  // Check if the constructor exists. If not, try installing the JSI bindings.\n  if (global.mmkvCreateNewInstance == null) {\n    // Get the native MMKV ReactModule\n    const MMKVModule = NativeModules.MMKV;\n    if (MMKVModule == null) {\n      let message =\n        'Failed to create a new MMKV instance: The native MMKV Module could not be found.';\n      message +=\n        '\\n* Make sure react-native-mmkv is correctly autolinked (run `npx react-native config` to verify)';\n      if (Platform.OS === 'ios' || Platform.OS === 'macos') {\n        message += '\\n* Make sure you ran `pod install` in the ios/ directory.';\n      }\n      if (Platform.OS === 'android') {\n        message += '\\n* Make sure gradle is synced.';\n      }\n      // check if Expo\n      const ExpoConstants =\n        NativeModules.NativeUnimoduleProxy?.modulesConstants?.ExponentConstants;\n      if (ExpoConstants != null) {\n        if (ExpoConstants.appOwnership === 'expo') {\n          // We're running Expo Go\n          throw new Error(\n            'react-native-mmkv is not supported in Expo Go! Use EAS (`expo prebuild`) or eject to a bare workflow instead.'\n          );\n        } else {\n          // We're running Expo bare / standalone\n          message += '\\n* Make sure you ran `expo prebuild`.';\n        }\n      }\n\n      message += '\\n* Make sure you rebuilt the app.';\n      throw new Error(message);\n    }\n\n    // Check if we are running on-device (JSI)\n    if (global.nativeCallSyncHook == null || MMKVModule.install == null) {\n      throw new Error(\n        'Failed to create a new MMKV instance: React Native is not running on-device. MMKV can only be used when synchronous method invocations (JSI) are possible. If you are using a remote debugger (e.g. Chrome), switch to an on-device debugger (e.g. Flipper) instead.'\n      );\n    }\n\n    // Call the synchronous blocking install() function\n    const result = MMKVModule.install(ROOT_DIRECTORY);\n    if (result !== true)\n      throw new Error(\n        `Failed to create a new MMKV instance: The native MMKV Module could not be installed! Looks like something went wrong when installing JSI bindings: ${result}`\n      );\n\n    // Check again if the constructor now exists. If not, throw an error.\n    if (global.mmkvCreateNewInstance == null)\n      throw new Error(\n        'Failed to create a new MMKV instance, the native initializer function does not exist. Are you trying to use MMKV from different JS Runtimes?'\n      );\n  }\n\n  return global.mmkvCreateNewInstance(config);\n};\n"]}

package/lib/commonjs/createMMKV.web.js

@@ -0,0 +1,70 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createMMKV = void 0;
+
+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 => {
+  if (config.id !== 'mmkv.default') {
+    throw new Error("MMKV: 'id' is not supported on Web!");
+  }
+
+  if (config.encryptionKey != null) {
+    throw new Error("MMKV: 'encryptionKey' is not supported on Web!");
+  }
+
+  if (config.path != null) {
+    throw new Error("MMKV: 'path' is not supported on Web!");
+  }
+
+  const storage = () => {
+    var _ref, _global$localStorage, _global, _window;
+
+    if (!canUseDOM) {
+      throw new Error('Tried to access storage on the server. Did you forget to call this in useEffect?');
+    }
+
+    const domStorage = (_ref = (_global$localStorage = (_global = global) === null || _global === void 0 ? void 0 : _global.localStorage) !== null && _global$localStorage !== void 0 ? _global$localStorage : (_window = window) === null || _window === void 0 ? void 0 : _window.localStorage) !== null && _ref !== void 0 ? _ref : localStorage;
+
+    if (domStorage == null) {
+      throw new Error(`Could not find 'localStorage' instance!`);
+    }
+
+    return domStorage;
+  };
+
+  return {
+    clearAll: () => storage().clear(),
+    delete: key => storage().removeItem(key),
+    set: (key, value) => storage().setItem(key, value.toString()),
+    getString: key => {
+      var _storage$getItem;
+
+      return (_storage$getItem = storage().getItem(key)) !== null && _storage$getItem !== void 0 ? _storage$getItem : undefined;
+    },
+    getNumber: key => {
+      var _storage$getItem2;
+
+      return Number((_storage$getItem2 = storage().getItem(key)) !== null && _storage$getItem2 !== void 0 ? _storage$getItem2 : 0);
+    },
+    getBoolean: key => {
+      var _storage$getItem3;
+
+      return Boolean((_storage$getItem3 = storage().getItem(key)) !== null && _storage$getItem3 !== void 0 ? _storage$getItem3 : false);
+    },
+    getAllKeys: () => Object.keys(storage()),
+    contains: key => storage().getItem(key) != null,
+    recrypt: () => {
+      throw new Error('`recrypt(..)` is not supported on Web!');
+    }
+  };
+};
+
+exports.createMMKV = createMMKV;
+//# sourceMappingURL=createMMKV.web.js.map

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

@@ -0,0 +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","Boolean","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;AAAA;;AAAA,aAASU,MAAM,sBAACjB,OAAO,GAAGc,OAAV,CAAkBP,GAAlB,CAAD,iEAA2B,CAA3B,CAAf;AAAA,KALN;AAMLW,IAAAA,UAAU,EAAGX,GAAD;AAAA;;AAAA,aAASY,OAAO,sBAACnB,OAAO,GAAGc,OAAV,CAAkBP,GAAlB,CAAD,iEAA2B,KAA3B,CAAhB;AAAA,KANP;AAOLa,IAAAA,UAAU,EAAE,MAAMC,MAAM,CAACC,IAAP,CAAYtB,OAAO,EAAnB,CAPb;AAQLuB,IAAAA,QAAQ,EAAGhB,GAAD,IAASP,OAAO,GAAGc,OAAV,CAAkBP,GAAlB,KAA0B,IARxC;AASLiB,IAAAA,OAAO,EAAE,MAAM;AACb,YAAM,IAAI3B,KAAJ,CAAU,wCAAV,CAAN;AACD;AAXI,GAAP;AAaD,CAtCM","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) => Number(storage().getItem(key) ?? 0),\n    getBoolean: (key) => Boolean(storage().getItem(key) ?? false),\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"]}