react-native-mmkv 4.0.1 → 4.1.1

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
+}