react-native-mmkv 4.0.1 → 4.1.0

package/NitroMmkv.podspec

@@ -24,7 +24,6 @@ Pod::Spec.new do |s|
 
   # Add MMKV Core dependency
   s.compiler_flags = '-x objective-c++'
-  s.libraries    = 'z', 'c++'
   s.dependency 'MMKVCore', '2.2.4'
 
   # TODO: Remove when no one uses RN 0.79 anymore

package/android/build.gradle

@@ -5,7 +5,7 @@ buildscript {
   }
 
   dependencies {
-    classpath "com.android.tools.build:gradle:8.13.0"
+    classpath "com.android.tools.build:gradle:8.13.1"
   }
 }
 

package/cpp/HybridMMKV.cpp

@@ -212,4 +212,14 @@ MMKVMode HybridMMKV::getMMKVMode(const Configuration& config) {
   }
 }
 
+double HybridMMKV::importAllFrom(const std::shared_ptr<HybridMMKVSpec>& other) {
+  auto hybridMMKV = std::dynamic_pointer_cast<HybridMMKV>(other);
+  if (hybridMMKV == nullptr) {
+    throw std::runtime_error("The given `MMKV` instance is not of type `HybridMMKV`!");
+  }
+
+  size_t importedCount = instance->importFrom(hybridMMKV->instance);
+  return static_cast<double>(importedCount);
+}
+
 } // namespace margelo::nitro::mmkv

package/cpp/HybridMMKV.hpp

@@ -37,6 +37,7 @@ public:
   void recrypt(const std::optional<std::string>& key) override;
   void trim() override;
   Listener addOnValueChangedListener(const std::function<void(const std::string& /* key */)>& onValueChanged) override;
+  double importAllFrom(const std::shared_ptr<HybridMMKVSpec>& other) override;
 
 private:
   static MMKVMode getMMKVMode(const Configuration& config);

package/cpp/HybridMMKVFactory.cpp

@@ -15,10 +15,6 @@ std::string HybridMMKVFactory::getDefaultMMKVInstanceId() {
   return DEFAULT_MMAP_ID;
 }
 
-std::shared_ptr<HybridMMKVSpec> HybridMMKVFactory::createMMKV(const Configuration& configuration) {
-  return std::make_shared<HybridMMKV>(configuration);
-}
-
 void HybridMMKVFactory::initializeMMKV(const std::string& rootPath) {
   Logger::log(LogLevel::Info, TAG, "Initializing MMKV with rootPath=%s", rootPath.c_str());
 
@@ -30,4 +26,16 @@ void HybridMMKVFactory::initializeMMKV(const std::string& rootPath) {
   MMKV::initializeMMKV(rootPath, logLevel);
 }
 
+std::shared_ptr<HybridMMKVSpec> HybridMMKVFactory::createMMKV(const Configuration& configuration) {
+  return std::make_shared<HybridMMKV>(configuration);
+}
+
+bool HybridMMKVFactory::deleteMMKV(const std::string& id) {
+  return MMKV::removeStorage(id);
+}
+
+bool HybridMMKVFactory::existsMMKV(const std::string& id) {
+  return MMKV::checkExist(id);
+}
+
 } // namespace margelo::nitro::mmkv

package/cpp/HybridMMKVFactory.hpp

@@ -17,8 +17,11 @@ public:
 
 public:
   std::string getDefaultMMKVInstanceId() override;
-  std::shared_ptr<HybridMMKVSpec> createMMKV(const Configuration& configuration) override;
   void initializeMMKV(const std::string& rootPath) override;
+
+  std::shared_ptr<HybridMMKVSpec> createMMKV(const Configuration& configuration) override;
+  bool deleteMMKV(const std::string& id) override;
+  bool existsMMKV(const std::string& id) override;
 };
 
 } // namespace margelo::nitro::mmkv

package/lib/createMMKV/createMMKV.js

@@ -1,31 +1,21 @@
-import { NitroModules } from 'react-native-nitro-modules';
 import { Platform } from 'react-native';
 import { addMemoryWarningListener } from '../addMemoryWarningListener/addMemoryWarningListener';
 import { isTest } from '../isTest';
 import { createMockMMKV } from './createMockMMKV';
-let factory;
-let platformContext;
+import { getMMKVFactory, getPlatformContext } from '../getMMKVFactory';
 export function createMMKV(configuration) {
     if (isTest()) {
         // In a test environment, we mock the MMKV instance.
         return createMockMMKV(configuration);
     }
-    if (platformContext == null) {
-        // Lazy-init the platform-context HybridObject
-        platformContext = NitroModules.createHybridObject('MMKVPlatformContext');
-    }
-    if (factory == null) {
-        // Lazy-init the factory HybridObject
-        factory = NitroModules.createHybridObject('MMKVFactory');
-        const baseDirectory = platformContext.getBaseDirectory();
-        factory.initializeMMKV(baseDirectory);
-    }
+    const factory = getMMKVFactory();
     // Pre-parse the config
     let config = configuration ?? { id: factory.defaultMMKVInstanceId };
     if (Platform.OS === 'ios') {
         if (config.path == null) {
             // If the user set an App Group directory in Info.plist, let's use
             // the App Group as a MMKV path:
+            const platformContext = getPlatformContext();
             const appGroupDirectory = platformContext.getAppGroupDirectory();
             if (appGroupDirectory != null) {
                 config.path = appGroupDirectory;

package/lib/createMMKV/createMMKV.web.js

@@ -1,17 +1,5 @@
 import { createTextEncoder } from '../web/createTextEncoder';
-const canUseDOM = typeof window !== 'undefined' && window.document?.createElement != null;
-const hasAccessToLocalStorage = () => {
-    try {
-        // throws ACCESS_DENIED error
-        window.localStorage;
-        return true;
-    }
-    catch {
-        return false;
-    }
-};
-const KEY_WILDCARD = '\\';
-const inMemoryStorage = new Map();
+import { getLocalStorage, LOCAL_STORAGE_KEY_WILDCARD, } from '../web/getLocalStorage';
 export function createMMKV(config = { id: 'mmkv.default' }) {
     if (config.encryptionKey != null) {
         throw new Error("MMKV: 'encryptionKey' is not supported on Web!");
@@ -19,36 +7,12 @@ export function createMMKV(config = { id: 'mmkv.default' }) {
     if (config.path != null) {
         throw new Error("MMKV: 'path' is not supported on Web!");
     }
-    // canUseDOM check prevents spam in Node server environments, such as Next.js server side props.
-    if (!hasAccessToLocalStorage() && canUseDOM) {
-        console.warn('MMKV: LocalStorage has been disabled. Your experience will be limited to in-memory storage!');
-    }
-    const storage = () => {
-        if (!canUseDOM) {
-            throw new Error('Tried to access storage on the server. Did you forget to call this in useEffect?');
-        }
-        if (!hasAccessToLocalStorage()) {
-            return {
-                getItem: (key) => inMemoryStorage.get(key) ?? null,
-                setItem: (key, value) => inMemoryStorage.set(key, value),
-                removeItem: (key) => inMemoryStorage.delete(key),
-                clear: () => inMemoryStorage.clear(),
-                length: inMemoryStorage.size,
-                key: (index) => Object.keys(inMemoryStorage).at(index) ?? null,
-            };
-        }
-        const domStorage = global?.localStorage ?? window?.localStorage ?? localStorage;
-        if (domStorage == null) {
-            throw new Error(`Could not find 'localStorage' instance!`);
-        }
-        return domStorage;
-    };
     const textEncoder = createTextEncoder();
     const listeners = new Set();
-    if (config.id.includes(KEY_WILDCARD)) {
+    if (config.id.includes(LOCAL_STORAGE_KEY_WILDCARD)) {
         throw new Error('MMKV: `id` cannot contain the backslash character (`\\`)!');
     }
-    const keyPrefix = `${config.id}${KEY_WILDCARD}`; // mmkv.default\\
+    const keyPrefix = `${config.id}${LOCAL_STORAGE_KEY_WILDCARD}`; // mmkv.default\\
     const prefixedKey = (key) => {
         if (key.includes('\\')) {
             throw new Error('MMKV: `key` cannot contain the backslash character (`\\`)!');
@@ -63,53 +27,66 @@ export function createMMKV(config = { id: 'mmkv.default' }) {
         size: 0,
         isReadOnly: false,
         clearAll: () => {
-            const keys = Object.keys(storage());
+            const storage = getLocalStorage();
+            const keys = Object.keys(storage);
             for (const key of keys) {
                 if (key.startsWith(keyPrefix)) {
-                    storage().removeItem(key);
+                    storage.removeItem(key);
                     callListeners(key);
                 }
             }
         },
         remove: (key) => {
-            storage().removeItem(prefixedKey(key));
-            const wasRemoved = storage().getItem(prefixedKey(key)) === null;
+            const storage = getLocalStorage();
+            storage.removeItem(prefixedKey(key));
+            const wasRemoved = storage.getItem(prefixedKey(key)) === null;
             if (wasRemoved)
                 callListeners(key);
             return wasRemoved;
         },
         set: (key, value) => {
+            const storage = getLocalStorage();
             if (key === '')
                 throw new Error('Cannot set a value for an empty key!');
-            storage().setItem(prefixedKey(key), value.toString());
+            storage.setItem(prefixedKey(key), value.toString());
             callListeners(key);
         },
-        getString: (key) => storage().getItem(prefixedKey(key)) ?? undefined,
+        getString: (key) => {
+            const storage = getLocalStorage();
+            return storage.getItem(prefixedKey(key)) ?? undefined;
+        },
         getNumber: (key) => {
-            const value = storage().getItem(prefixedKey(key));
+            const storage = getLocalStorage();
+            const value = storage.getItem(prefixedKey(key));
             if (value == null)
                 return undefined;
             return Number(value);
         },
         getBoolean: (key) => {
-            const value = storage().getItem(prefixedKey(key));
+            const storage = getLocalStorage();
+            const value = storage.getItem(prefixedKey(key));
             if (value == null)
                 return undefined;
             return value === 'true';
         },
         getBuffer: (key) => {
-            const value = storage().getItem(prefixedKey(key));
+            const storage = getLocalStorage();
+            const value = storage.getItem(prefixedKey(key));
             if (value == null)
                 return undefined;
             return textEncoder.encode(value).buffer;
         },
         getAllKeys: () => {
-            const keys = Object.keys(storage());
+            const storage = getLocalStorage();
+            const keys = Object.keys(storage);
             return keys
                 .filter((key) => key.startsWith(keyPrefix))
                 .map((key) => key.slice(keyPrefix.length));
         },
-        contains: (key) => storage().getItem(prefixedKey(key)) != null,
+        contains: (key) => {
+            const storage = getLocalStorage();
+            return storage.getItem(prefixedKey(key)) != null;
+        },
         recrypt: () => {
             throw new Error('`recrypt(..)` is not supported on Web!');
         },
@@ -127,5 +104,18 @@ export function createMMKV(config = { id: 'mmkv.default' }) {
                 },
             };
         },
+        importAllFrom: (other) => {
+            const storage = getLocalStorage();
+            const keys = other.getAllKeys();
+            let imported = 0;
+            for (const key of keys) {
+                const string = other.getString(key);
+                if (string != null) {
+                    storage.set(key, string);
+                    imported++;
+                }
+            }
+            return imported;
+        },
     };
 }

package/lib/createMMKV/createMockMMKV.js

@@ -73,5 +73,17 @@ export function createMockMMKV(config = { id: 'mmkv.default' }) {
                 },
             };
         },
+        importAllFrom: (other) => {
+            const keys = other.getAllKeys();
+            let imported = 0;
+            for (const key of keys) {
+                const data = other.getBuffer(key);
+                if (data != null) {
+                    storage.set(key, data);
+                    imported++;
+                }
+            }
+            return imported;
+        },
     };
 }

package/lib/deleteMMKV/deleteMMKV.d.ts

@@ -0,0 +1 @@
+export declare function deleteMMKV(id: string): boolean;

package/lib/deleteMMKV/deleteMMKV.js

@@ -0,0 +1,9 @@
+import { getMMKVFactory } from '../getMMKVFactory';
+import { isTest } from '../isTest';
+export function deleteMMKV(id) {
+    if (isTest()) {
+        return true;
+    }
+    const factory = getMMKVFactory();
+    return factory.deleteMMKV(id);
+}

package/lib/deleteMMKV/deleteMMKV.web.d.ts

@@ -0,0 +1 @@
+export declare function deleteMMKV(id: string): boolean;

package/lib/deleteMMKV/deleteMMKV.web.js

@@ -0,0 +1,14 @@
+import { getLocalStorage, LOCAL_STORAGE_KEY_WILDCARD, } from '../web/getLocalStorage';
+export function deleteMMKV(id) {
+    const storage = getLocalStorage();
+    const prefix = id + LOCAL_STORAGE_KEY_WILDCARD;
+    let wasRemoved = false;
+    const keys = Object.keys(storage);
+    for (const key of keys) {
+        if (key.startsWith(prefix)) {
+            storage.removeItem(key);
+            wasRemoved = true;
+        }
+    }
+    return wasRemoved;
+}

package/lib/existsMMKV/existsMMKV.d.ts

@@ -0,0 +1 @@
+export declare function existsMMKV(id: string): boolean;

package/lib/existsMMKV/existsMMKV.js

@@ -0,0 +1,9 @@
+import { getMMKVFactory } from '../getMMKVFactory';
+import { isTest } from '../isTest';
+export function existsMMKV(id) {
+    if (isTest()) {
+        return true;
+    }
+    const factory = getMMKVFactory();
+    return factory.existsMMKV(id);
+}

package/lib/existsMMKV/existsMMKV.web.d.ts

@@ -0,0 +1 @@
+export declare function existsMMKV(id: string): boolean;

package/lib/existsMMKV/existsMMKV.web.js

@@ -0,0 +1,7 @@
+import { getLocalStorage, LOCAL_STORAGE_KEY_WILDCARD, } from '../web/getLocalStorage';
+export function existsMMKV(id) {
+    const storage = getLocalStorage();
+    const prefix = id + LOCAL_STORAGE_KEY_WILDCARD;
+    const keys = Object.keys(storage);
+    return keys.some((k) => k.startsWith(prefix));
+}

package/lib/getMMKVFactory.d.ts

@@ -0,0 +1,4 @@
+import type { MMKVFactory } from './specs/MMKVFactory.nitro';
+import type { MMKVPlatformContext } from './specs/MMKVPlatformContext.nitro';
+export declare function getPlatformContext(): MMKVPlatformContext;
+export declare function getMMKVFactory(): MMKVFactory;

package/lib/getMMKVFactory.js

@@ -0,0 +1,20 @@
+import { NitroModules } from 'react-native-nitro-modules';
+let factory;
+let platformContext;
+export function getPlatformContext() {
+    if (platformContext == null) {
+        // Lazy-init the platform-context HybridObject
+        platformContext = NitroModules.createHybridObject('MMKVPlatformContext');
+    }
+    return platformContext;
+}
+export function getMMKVFactory() {
+    if (factory == null) {
+        // Lazy-init the factory HybridObject
+        factory = NitroModules.createHybridObject('MMKVFactory');
+        const context = getPlatformContext();
+        const baseDirectory = context.getBaseDirectory();
+        factory.initializeMMKV(baseDirectory);
+    }
+    return factory;
+}

package/lib/index.d.ts

@@ -1,6 +1,8 @@
 export type { MMKV } from './specs/MMKV.nitro';
 export type { Configuration, Mode } from './specs/MMKVFactory.nitro';
 export { createMMKV } from './createMMKV/createMMKV';
+export { existsMMKV } from './existsMMKV/existsMMKV';
+export { deleteMMKV } from './deleteMMKV/deleteMMKV';
 export { useMMKV } from './hooks/useMMKV';
 export { useMMKVBoolean } from './hooks/useMMKVBoolean';
 export { useMMKVBuffer } from './hooks/useMMKVBuffer';

package/lib/index.js

@@ -1,5 +1,8 @@
 // The create function
 export { createMMKV } from './createMMKV/createMMKV';
+// Exists + Delete
+export { existsMMKV } from './existsMMKV/existsMMKV';
+export { deleteMMKV } from './deleteMMKV/deleteMMKV';
 // All the hooks
 export { useMMKV } from './hooks/useMMKV';
 export { useMMKVBoolean } from './hooks/useMMKVBoolean';

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

@@ -96,4 +96,10 @@ export interface MMKV extends HybridObject<{
      * To unsubscribe from value changes, call `remove()` on the Listener.
      */
     addOnValueChangedListener(onValueChanged: (key: string) => void): Listener;
+    /**
+     * Imports all keys and values from the
+     * given other {@linkcode MMKV} instance.
+     * @returns the number of imported keys/values.
+     */
+    importAllFrom(other: MMKV): number;
 }

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

@@ -67,15 +67,25 @@ export interface MMKVFactory extends HybridObject<{
     ios: 'c++';
     android: 'c++';
 }> {
+    /**
+     * Initialize the MMKV library with the given root path.
+     * This has to be called once, before using {@linkcode createMMKV}.
+     */
+    initializeMMKV(rootPath: string): void;
     /**
      * Create a new {@linkcode MMKV} instance with the given {@linkcode Configuration}
      */
     createMMKV(configuration: Configuration): MMKV;
     /**
-     * Initialize the MMKV library with the given root path.
-     * This has to be called once, before using {@linkcode createMMKV}.
+     * Deletes the MMKV instance with the
+     * given {@linkcode id}.
      */
-    initializeMMKV(rootPath: string): void;
+    deleteMMKV(id: string): boolean;
+    /**
+     * Returns `true` if an MMKV instance with the
+     * given {@linkcode id} exists, `false` otherwise.
+     */
+    existsMMKV(id: string): boolean;
     /**
      * Get the default MMKV instance's ID.
      * @default 'mmkv.default'

package/lib/web/getLocalStorage.d.ts

@@ -0,0 +1,2 @@
+export declare const LOCAL_STORAGE_KEY_WILDCARD = "\\";
+export declare function getLocalStorage(): Storage;

package/lib/web/getLocalStorage.js

@@ -0,0 +1,33 @@
+export const LOCAL_STORAGE_KEY_WILDCARD = '\\';
+const canUseDOM = typeof window !== 'undefined' && window.document?.createElement != null;
+const hasAccessToLocalStorage = () => {
+    try {
+        // throws ACCESS_DENIED error
+        window.localStorage;
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const inMemoryStorage = new Map();
+export function getLocalStorage() {
+    if (!canUseDOM) {
+        throw new Error('Tried to access storage on the server. Did you forget to call this in useEffect?');
+    }
+    if (!hasAccessToLocalStorage()) {
+        return {
+            getItem: (key) => inMemoryStorage.get(key) ?? null,
+            setItem: (key, value) => inMemoryStorage.set(key, value),
+            removeItem: (key) => inMemoryStorage.delete(key),
+            clear: () => inMemoryStorage.clear(),
+            length: inMemoryStorage.size,
+            key: (index) => Object.keys(inMemoryStorage).at(index) ?? null,
+        };
+    }
+    const domStorage = global?.localStorage ?? window?.localStorage ?? localStorage;
+    if (domStorage == null) {
+        throw new Error(`Could not find 'localStorage' instance!`);
+    }
+    return domStorage;
+}

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

@@ -15,8 +15,10 @@ namespace margelo::nitro::mmkv {
     // load custom methods/properties
     registerHybrids(this, [](Prototype& prototype) {
       prototype.registerHybridGetter("defaultMMKVInstanceId", &HybridMMKVFactorySpec::getDefaultMMKVInstanceId);
-      prototype.registerHybridMethod("createMMKV", &HybridMMKVFactorySpec::createMMKV);
       prototype.registerHybridMethod("initializeMMKV", &HybridMMKVFactorySpec::initializeMMKV);
+      prototype.registerHybridMethod("createMMKV", &HybridMMKVFactorySpec::createMMKV);
+      prototype.registerHybridMethod("deleteMMKV", &HybridMMKVFactorySpec::deleteMMKV);
+      prototype.registerHybridMethod("existsMMKV", &HybridMMKVFactorySpec::existsMMKV);
     });
   }
 

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

@@ -54,8 +54,10 @@ namespace margelo::nitro::mmkv {
 
     public:
       // Methods
-      virtual std::shared_ptr<HybridMMKVSpec> createMMKV(const Configuration& configuration) = 0;
       virtual void initializeMMKV(const std::string& rootPath) = 0;
+      virtual std::shared_ptr<HybridMMKVSpec> createMMKV(const Configuration& configuration) = 0;
+      virtual bool deleteMMKV(const std::string& id) = 0;
+      virtual bool existsMMKV(const std::string& id) = 0;
 
     protected:
       // Hybrid Setup

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

@@ -29,6 +29,7 @@ namespace margelo::nitro::mmkv {
       prototype.registerHybridMethod("recrypt", &HybridMMKVSpec::recrypt);
       prototype.registerHybridMethod("trim", &HybridMMKVSpec::trim);
       prototype.registerHybridMethod("addOnValueChangedListener", &HybridMMKVSpec::addOnValueChangedListener);
+      prototype.registerHybridMethod("importAllFrom", &HybridMMKVSpec::importAllFrom);
     });
   }
 

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

@@ -15,6 +15,8 @@
 
 // Forward declaration of `Listener` to properly resolve imports.
 namespace margelo::nitro::mmkv { struct Listener; }
+// Forward declaration of `HybridMMKVSpec` to properly resolve imports.
+namespace margelo::nitro::mmkv { class HybridMMKVSpec; }
 
 #include <string>
 #include <NitroModules/ArrayBuffer.hpp>
@@ -23,6 +25,8 @@ namespace margelo::nitro::mmkv { struct Listener; }
 #include <vector>
 #include "Listener.hpp"
 #include <functional>
+#include <memory>
+#include "HybridMMKVSpec.hpp"
 
 namespace margelo::nitro::mmkv {
 
@@ -69,6 +73,7 @@ namespace margelo::nitro::mmkv {
       virtual void recrypt(const std::optional<std::string>& key) = 0;
       virtual void trim() = 0;
       virtual Listener addOnValueChangedListener(const std::function<void(const std::string& /* key */)>& onValueChanged) = 0;
+      virtual double importAllFrom(const std::shared_ptr<HybridMMKVSpec>& other) = 0;
 
     protected:
       // Hybrid Setup

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-mmkv",
-  "version": "4.0.1",
+  "version": "4.1.0",
   "description": "⚡️ The fastest key/value storage for React Native.",
   "main": "lib/index",
   "module": "lib/index",

package/src/createMMKV/createMMKV.ts

@@ -1,14 +1,10 @@
-import { NitroModules } from 'react-native-nitro-modules'
 import type { MMKV } from '../specs/MMKV.nitro'
-import type { Configuration, MMKVFactory } from '../specs/MMKVFactory.nitro'
-import type { MMKVPlatformContext } from '../specs/MMKVPlatformContext.nitro'
+import type { Configuration } from '../specs/MMKVFactory.nitro'
 import { Platform } from 'react-native'
 import { addMemoryWarningListener } from '../addMemoryWarningListener/addMemoryWarningListener'
 import { isTest } from '../isTest'
 import { createMockMMKV } from './createMockMMKV'
-
-let factory: MMKVFactory | undefined
-let platformContext: MMKVPlatformContext | undefined
+import { getMMKVFactory, getPlatformContext } from '../getMMKVFactory'
 
 export function createMMKV(configuration?: Configuration): MMKV {
   if (isTest()) {
@@ -16,18 +12,7 @@ export function createMMKV(configuration?: Configuration): MMKV {
     return createMockMMKV(configuration)
   }
 
-  if (platformContext == null) {
-    // Lazy-init the platform-context HybridObject
-    platformContext = NitroModules.createHybridObject<MMKVPlatformContext>(
-      'MMKVPlatformContext'
-    )
-  }
-  if (factory == null) {
-    // Lazy-init the factory HybridObject
-    factory = NitroModules.createHybridObject<MMKVFactory>('MMKVFactory')
-    const baseDirectory = platformContext.getBaseDirectory()
-    factory.initializeMMKV(baseDirectory)
-  }
+  const factory = getMMKVFactory()
 
   // Pre-parse the config
   let config = configuration ?? { id: factory.defaultMMKVInstanceId }
@@ -36,6 +21,7 @@ export function createMMKV(configuration?: Configuration): MMKV {
     if (config.path == null) {
       // If the user set an App Group directory in Info.plist, let's use
       // the App Group as a MMKV path:
+      const platformContext = getPlatformContext()
       const appGroupDirectory = platformContext.getAppGroupDirectory()
       if (appGroupDirectory != null) {
         config.path = appGroupDirectory

package/src/createMMKV/createMMKV.web.ts

@@ -1,23 +1,10 @@
 import type { MMKV } from '../specs/MMKV.nitro'
 import type { Configuration } from '../specs/MMKVFactory.nitro'
 import { createTextEncoder } from '../web/createTextEncoder'
-
-const canUseDOM =
-  typeof window !== 'undefined' && window.document?.createElement != null
-
-const hasAccessToLocalStorage = () => {
-  try {
-    // throws ACCESS_DENIED error
-    window.localStorage
-
-    return true
-  } catch {
-    return false
-  }
-}
-
-const KEY_WILDCARD = '\\'
-const inMemoryStorage = new Map<string, string>()
+import {
+  getLocalStorage,
+  LOCAL_STORAGE_KEY_WILDCARD,
+} from '../web/getLocalStorage'
 
 export function createMMKV(
   config: Configuration = { id: 'mmkv.default' }
@@ -29,48 +16,14 @@ export function createMMKV(
     throw new Error("MMKV: 'path' is not supported on Web!")
   }
 
-  // canUseDOM check prevents spam in Node server environments, such as Next.js server side props.
-  if (!hasAccessToLocalStorage() && canUseDOM) {
-    console.warn(
-      'MMKV: LocalStorage has been disabled. Your experience will be limited to in-memory storage!'
-    )
-  }
-
-  const storage = () => {
-    if (!canUseDOM) {
-      throw new Error(
-        'Tried to access storage on the server. Did you forget to call this in useEffect?'
-      )
-    }
-
-    if (!hasAccessToLocalStorage()) {
-      return {
-        getItem: (key: string) => inMemoryStorage.get(key) ?? null,
-        setItem: (key: string, value: string) =>
-          inMemoryStorage.set(key, value),
-        removeItem: (key: string) => inMemoryStorage.delete(key),
-        clear: () => inMemoryStorage.clear(),
-        length: inMemoryStorage.size,
-        key: (index: number) => Object.keys(inMemoryStorage).at(index) ?? null,
-      } as Storage
-    }
-
-    const domStorage =
-      global?.localStorage ?? window?.localStorage ?? localStorage
-    if (domStorage == null) {
-      throw new Error(`Could not find 'localStorage' instance!`)
-    }
-    return domStorage
-  }
-
   const textEncoder = createTextEncoder()
   const listeners = new Set<(key: string) => void>()
 
-  if (config.id.includes(KEY_WILDCARD)) {
+  if (config.id.includes(LOCAL_STORAGE_KEY_WILDCARD)) {
     throw new Error('MMKV: `id` cannot contain the backslash character (`\\`)!')
   }
 
-  const keyPrefix = `${config.id}${KEY_WILDCARD}` // mmkv.default\\
+  const keyPrefix = `${config.id}${LOCAL_STORAGE_KEY_WILDCARD}` // mmkv.default\\
   const prefixedKey = (key: string) => {
     if (key.includes('\\')) {
       throw new Error(
@@ -89,48 +42,61 @@ export function createMMKV(
     size: 0,
     isReadOnly: false,
     clearAll: () => {
-      const keys = Object.keys(storage())
+      const storage = getLocalStorage()
+      const keys = Object.keys(storage)
       for (const key of keys) {
         if (key.startsWith(keyPrefix)) {
-          storage().removeItem(key)
+          storage.removeItem(key)
           callListeners(key)
         }
       }
     },
     remove: (key) => {
-      storage().removeItem(prefixedKey(key))
-      const wasRemoved = storage().getItem(prefixedKey(key)) === null
+      const storage = getLocalStorage()
+      storage.removeItem(prefixedKey(key))
+      const wasRemoved = storage.getItem(prefixedKey(key)) === null
       if (wasRemoved) callListeners(key)
       return wasRemoved
     },
     set: (key, value) => {
+      const storage = getLocalStorage()
       if (key === '') throw new Error('Cannot set a value for an empty key!')
-      storage().setItem(prefixedKey(key), value.toString())
+      storage.setItem(prefixedKey(key), value.toString())
       callListeners(key)
     },
-    getString: (key) => storage().getItem(prefixedKey(key)) ?? undefined,
+    getString: (key) => {
+      const storage = getLocalStorage()
+      return storage.getItem(prefixedKey(key)) ?? undefined
+    },
     getNumber: (key) => {
-      const value = storage().getItem(prefixedKey(key))
+      const storage = getLocalStorage()
+      const value = storage.getItem(prefixedKey(key))
       if (value == null) return undefined
       return Number(value)
     },
     getBoolean: (key) => {
-      const value = storage().getItem(prefixedKey(key))
+      const storage = getLocalStorage()
+      const value = storage.getItem(prefixedKey(key))
       if (value == null) return undefined
       return value === 'true'
     },
     getBuffer: (key) => {
-      const value = storage().getItem(prefixedKey(key))
+      const storage = getLocalStorage()
+      const value = storage.getItem(prefixedKey(key))
       if (value == null) return undefined
       return textEncoder.encode(value).buffer
     },
     getAllKeys: () => {
-      const keys = Object.keys(storage())
+      const storage = getLocalStorage()
+      const keys = Object.keys(storage)
       return keys
         .filter((key) => key.startsWith(keyPrefix))
         .map((key) => key.slice(keyPrefix.length))
     },
-    contains: (key) => storage().getItem(prefixedKey(key)) != null,
+    contains: (key) => {
+      const storage = getLocalStorage()
+      return storage.getItem(prefixedKey(key)) != null
+    },
     recrypt: () => {
       throw new Error('`recrypt(..)` is not supported on Web!')
     },
@@ -148,5 +114,18 @@ export function createMMKV(
         },
       }
     },
+    importAllFrom: (other) => {
+      const storage = getLocalStorage()
+      const keys = other.getAllKeys()
+      let imported = 0
+      for (const key of keys) {
+        const string = other.getString(key)
+        if (string != null) {
+          storage.set(key, string)
+          imported++
+        }
+      }
+      return imported
+    },
   }
 }

package/src/createMMKV/createMockMMKV.ts

@@ -79,5 +79,17 @@ export function createMockMMKV(
         },
       }
     },
+    importAllFrom: (other) => {
+      const keys = other.getAllKeys()
+      let imported = 0
+      for (const key of keys) {
+        const data = other.getBuffer(key)
+        if (data != null) {
+          storage.set(key, data)
+          imported++
+        }
+      }
+      return imported
+    },
   }
 }

package/src/deleteMMKV/deleteMMKV.ts

@@ -0,0 +1,11 @@
+import { getMMKVFactory } from '../getMMKVFactory'
+import { isTest } from '../isTest'
+
+export function deleteMMKV(id: string): boolean {
+  if (isTest()) {
+    return true
+  }
+
+  const factory = getMMKVFactory()
+  return factory.deleteMMKV(id)
+}

package/src/deleteMMKV/deleteMMKV.web.ts

@@ -0,0 +1,20 @@
+import {
+  getLocalStorage,
+  LOCAL_STORAGE_KEY_WILDCARD,
+} from '../web/getLocalStorage'
+
+export function deleteMMKV(id: string): boolean {
+  const storage = getLocalStorage()
+  const prefix = id + LOCAL_STORAGE_KEY_WILDCARD
+  let wasRemoved = false
+
+  const keys = Object.keys(storage)
+  for (const key of keys) {
+    if (key.startsWith(prefix)) {
+      storage.removeItem(key)
+      wasRemoved = true
+    }
+  }
+
+  return wasRemoved
+}

package/src/existsMMKV/existsMMKV.ts

@@ -0,0 +1,11 @@
+import { getMMKVFactory } from '../getMMKVFactory'
+import { isTest } from '../isTest'
+
+export function existsMMKV(id: string): boolean {
+  if (isTest()) {
+    return true
+  }
+
+  const factory = getMMKVFactory()
+  return factory.existsMMKV(id)
+}

package/src/existsMMKV/existsMMKV.web.ts

@@ -0,0 +1,11 @@
+import {
+  getLocalStorage,
+  LOCAL_STORAGE_KEY_WILDCARD,
+} from '../web/getLocalStorage'
+
+export function existsMMKV(id: string): boolean {
+  const storage = getLocalStorage()
+  const prefix = id + LOCAL_STORAGE_KEY_WILDCARD
+  const keys = Object.keys(storage)
+  return keys.some((k) => k.startsWith(prefix))
+}

package/src/getMMKVFactory.ts

@@ -0,0 +1,28 @@
+import { NitroModules } from 'react-native-nitro-modules'
+import type { MMKVFactory } from './specs/MMKVFactory.nitro'
+import type { MMKVPlatformContext } from './specs/MMKVPlatformContext.nitro'
+
+let factory: MMKVFactory | undefined
+let platformContext: MMKVPlatformContext | undefined
+
+export function getPlatformContext(): MMKVPlatformContext {
+  if (platformContext == null) {
+    // Lazy-init the platform-context HybridObject
+    platformContext = NitroModules.createHybridObject<MMKVPlatformContext>(
+      'MMKVPlatformContext'
+    )
+  }
+  return platformContext
+}
+
+export function getMMKVFactory(): MMKVFactory {
+  if (factory == null) {
+    // Lazy-init the factory HybridObject
+    factory = NitroModules.createHybridObject<MMKVFactory>('MMKVFactory')
+    const context = getPlatformContext()
+    const baseDirectory = context.getBaseDirectory()
+    factory.initializeMMKV(baseDirectory)
+  }
+
+  return factory
+}

package/src/index.ts

@@ -5,6 +5,10 @@ export type { Configuration, Mode } from './specs/MMKVFactory.nitro'
 // The create function
 export { createMMKV } from './createMMKV/createMMKV'
 
+// Exists + Delete
+export { existsMMKV } from './existsMMKV/existsMMKV'
+export { deleteMMKV } from './deleteMMKV/deleteMMKV'
+
 // All the hooks
 export { useMMKV } from './hooks/useMMKV'
 export { useMMKVBoolean } from './hooks/useMMKVBoolean'

package/src/specs/MMKV.nitro.ts

@@ -95,4 +95,11 @@ export interface MMKV extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
    * To unsubscribe from value changes, call `remove()` on the Listener.
    */
   addOnValueChangedListener(onValueChanged: (key: string) => void): Listener
+
+  /**
+   * Imports all keys and values from the
+   * given other {@linkcode MMKV} instance.
+   * @returns the number of imported keys/values.
+   */
+  importAllFrom(other: MMKV): number
 }

package/src/specs/MMKVFactory.nitro.ts

@@ -68,16 +68,28 @@ export interface Configuration {
 
 export interface MMKVFactory
   extends HybridObject<{ ios: 'c++'; android: 'c++' }> {
+  /**
+   * Initialize the MMKV library with the given root path.
+   * This has to be called once, before using {@linkcode createMMKV}.
+   */
+  initializeMMKV(rootPath: string): void
+
   /**
    * Create a new {@linkcode MMKV} instance with the given {@linkcode Configuration}
    */
   createMMKV(configuration: Configuration): MMKV
 
   /**
-   * Initialize the MMKV library with the given root path.
-   * This has to be called once, before using {@linkcode createMMKV}.
+   * Deletes the MMKV instance with the
+   * given {@linkcode id}.
    */
-  initializeMMKV(rootPath: string): void
+  deleteMMKV(id: string): boolean
+
+  /**
+   * Returns `true` if an MMKV instance with the
+   * given {@linkcode id} exists, `false` otherwise.
+   */
+  existsMMKV(id: string): boolean
 
   /**
    * Get the default MMKV instance's ID.

package/src/web/getLocalStorage.ts

@@ -0,0 +1,42 @@
+export const LOCAL_STORAGE_KEY_WILDCARD = '\\'
+
+const canUseDOM =
+  typeof window !== 'undefined' && window.document?.createElement != null
+
+const hasAccessToLocalStorage = () => {
+  try {
+    // throws ACCESS_DENIED error
+    window.localStorage
+
+    return true
+  } catch {
+    return false
+  }
+}
+const inMemoryStorage = new Map<string, string>()
+
+export function getLocalStorage(): Storage {
+  if (!canUseDOM) {
+    throw new Error(
+      'Tried to access storage on the server. Did you forget to call this in useEffect?'
+    )
+  }
+
+  if (!hasAccessToLocalStorage()) {
+    return {
+      getItem: (key: string) => inMemoryStorage.get(key) ?? null,
+      setItem: (key: string, value: string) => inMemoryStorage.set(key, value),
+      removeItem: (key: string) => inMemoryStorage.delete(key),
+      clear: () => inMemoryStorage.clear(),
+      length: inMemoryStorage.size,
+      key: (index: number) => Object.keys(inMemoryStorage).at(index) ?? null,
+    } as Storage
+  }
+
+  const domStorage =
+    global?.localStorage ?? window?.localStorage ?? localStorage
+  if (domStorage == null) {
+    throw new Error(`Could not find 'localStorage' instance!`)
+  }
+  return domStorage
+}