react-native-mmkv 2.12.2 → 3.0.0-beta.1

package/lib/typescript/src/NativeMmkv.d.ts

@@ -0,0 +1,79 @@
+/// <reference types="react-native/types/modules/Codegen" />
+import { TurboModule } from 'react-native';
+import { UnsafeObject } from 'react-native/Libraries/Types/CodegenTypes';
+/**
+ * Configures the mode of the MMKV instance.
+ */
+export declare enum Mode {
+    /**
+     * The MMKV instance is only used from a single process (this app).
+     */
+    SINGLE_PROCESS = 0,
+    /**
+     * The MMKV instance may be used from multiple processes, such as app clips, share extensions or background services.
+     */
+    MULTI_PROCESS = 1
+}
+/**
+ * Used for configuration of a single MMKV instance.
+ */
+export interface Configuration {
+    /**
+     * The MMKV instance's ID. If you want to use multiple instances, make sure to use different IDs!
+     *
+     * @example
+     * ```ts
+     * const userStorage = new MMKV({ id: `user-${userId}-storage` })
+     * const globalStorage = new MMKV({ id: 'global-app-storage' })
+     * ```
+     *
+     * @default 'mmkv.default'
+     */
+    id: string;
+    /**
+     * The MMKV instance's root path. By default, MMKV stores file inside `$(Documents)/mmkv/`. You can customize MMKV's root directory on MMKV initialization:
+  
+     * @example
+     * ```ts
+     * const temporaryStorage = new MMKV({ path: '/tmp/' })
+     * ```
+     *
+     * _Notice_: On iOS you can set the AppGroup bundle property to share the same storage between your app and its extensions.
+     * In this case `path` property will be ignored.
+     * See more on MMKV configuration [here](https://github.com/Tencent/MMKV/wiki/iOS_tutorial#configuration).
+     *
+     * @default undefined
+     */
+    path?: string;
+    /**
+     * 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.
+     *
+     * Encryption keys can have a maximum length of 16 bytes.
+     *
+     * @example
+     * ```ts
+     * const secureStorage = new MMKV({ encryptionKey: 'my-encryption-key!' })
+     * ```
+     *
+     * @default undefined
+     */
+    encryptionKey?: string;
+    /**
+     * Configure the processing mode for MMKV.
+     * - `SINGLE_PROCESS`: The MMKV instance is only used from a single process (this app).
+     * - `MULTI_PROCESS`: The MMKV instance may be used from multiple processes, such as app clips, share extensions or background services.
+     *
+     * @default SINGLE_PROCESS
+     */
+    mode?: Mode;
+}
+export interface Spec extends TurboModule {
+    initialize(basePath: string): boolean;
+    createMMKV(configuration: Configuration): UnsafeObject;
+}
+/**
+ * Get the MMKV TurboModule, and initialize it if this is the first time calling.
+ * This will throw an error if the module cannot be found.
+ */
+export declare function getMMKVTurboModule(): Spec;
+//# sourceMappingURL=NativeMmkv.d.ts.map

package/lib/typescript/src/NativeMmkv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeMmkv.d.ts","sourceRoot":"","sources":["../../../src/NativeMmkv.ts"],"names":[],"mappings":";AAAA,OAAO,EAA2B,WAAW,EAAE,MAAM,cAAc,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAGzE;;GAEG;AACH,oBAAY,IAAI;IACd;;OAEG;IACH,cAAc,IAAA;IACd;;OAEG;IACH,aAAa,IAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;;OAUG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,UAAU,CAAC,aAAa,EAAE,aAAa,GAAG,YAAY,CAAC;CACxD;AAKD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CA8CzC"}

package/lib/typescript/src/NativeMmkvPlatformContext.d.ts

@@ -0,0 +1,9 @@
+import { TurboModule } from 'react-native';
+export interface Spec extends TurboModule {
+    /**
+     * Gets the base directory of the documents storage
+     */
+    getBaseDirectory(): string;
+}
+export declare const PlatformContext: Spec;
+//# sourceMappingURL=NativeMmkvPlatformContext.d.ts.map

package/lib/typescript/src/NativeMmkvPlatformContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeMmkvPlatformContext.d.ts","sourceRoot":"","sources":["../../../src/NativeMmkvPlatformContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAuB,MAAM,cAAc,CAAC;AAEhE,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;OAEG;IACH,gBAAgB,IAAI,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,eAAe,MAE3B,CAAC"}

package/lib/typescript/src/PlatformChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformChecker.d.ts","sourceRoot":"","sources":["../../../src/PlatformChecker.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,IAAI,OAAO,CAMhC"}

package/lib/typescript/src/__tests__/hooks.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hooks.test.d.ts.map

package/lib/typescript/src/__tests__/hooks.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/hooks.test.tsx"],"names":[],"mappings":""}

package/lib/typescript/src/createMMKV.d.ts

@@ -0,0 +1,3 @@
+import type { Configuration, NativeMMKV } from './MMKV';
+export declare const createMMKV: (config: Configuration) => NativeMMKV;
+//# sourceMappingURL=createMMKV.d.ts.map

package/lib/typescript/src/createMMKV.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMMKV.d.ts","sourceRoot":"","sources":["../../../src/createMMKV.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAKxD,eAAO,MAAM,UAAU,WAAY,aAAa,KAAG,UAUlD,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { NativeMMKV } from './MMKV';
+export declare const createMockMMKV: () => NativeMMKV;
+//# sourceMappingURL=createMMKV.mock.d.ts.map

package/lib/typescript/src/createMMKV.mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMMKV.mock.d.ts","sourceRoot":"","sources":["../../../src/createMMKV.mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGzC,eAAO,MAAM,cAAc,QAAO,UAiCjC,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { Configuration, NativeMMKV } from './MMKV';
+export declare const createMMKV: (config: Configuration) => NativeMMKV;
+//# sourceMappingURL=createMMKV.web.d.ts.map

package/lib/typescript/src/createMMKV.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMMKV.web.d.ts","sourceRoot":"","sources":["../../../src/createMMKV.web.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAoBxD,eAAO,MAAM,UAAU,WAAY,aAAa,KAAG,UAwGlD,CAAC"}

package/lib/typescript/src/createTextEncoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTextEncoder.d.ts","sourceRoot":"","sources":["../../../src/createTextEncoder.ts"],"names":[],"mappings":"AACA,wBAAgB,iBAAiB,IAAI,WAAW,CAc/C"}

package/lib/typescript/{hooks.d.ts → src/hooks.d.ts}

@@ -1,4 +1,4 @@
-import { MMKV, MMKVConfiguration } from './MMKV';
+import { MMKV, Configuration } from './MMKV';
 /**
  * Use the default, shared MMKV instance.
  */
@@ -7,7 +7,7 @@ export declare function useMMKV(): MMKV;
  * Use a custom MMKV instance with the given configuration.
  * @param configuration The configuration to initialize the MMKV instance with. Does not have to be memoized.
  */
-export declare function useMMKV(configuration: MMKVConfiguration): MMKV;
+export declare function useMMKV(configuration: Configuration): MMKV;
 /**
  * Use the string value of the given `key` from the given MMKV storage instance.
  *
@@ -51,7 +51,7 @@ export declare const useMMKVBoolean: (key: string, instance?: MMKV) => [value: b
  * const [privateKey, setPrivateKey] = useMMKVBuffer("user.privateKey")
  * ```
  */
-export declare const useMMKVBuffer: (key: string, instance?: MMKV) => [value: Uint8Array | undefined, setValue: (value: Uint8Array | ((current: Uint8Array | undefined) => Uint8Array | undefined) | undefined) => void];
+export declare const useMMKVBuffer: (key: string, instance?: MMKV) => [value: ArrayBuffer | undefined, setValue: (value: ArrayBuffer | ((current: ArrayBuffer | undefined) => ArrayBuffer | undefined) | undefined) => void];
 /**
  * Use an object value of the given `key` from the given MMKV storage instance.
  *
@@ -64,7 +64,10 @@ export declare const useMMKVBuffer: (key: string, instance?: MMKV) => [value: Ui
  * const [user, setUser] = useMMKVObject<User>("user")
  * ```
  */
-export declare function useMMKVObject<T>(key: string, instance?: MMKV): [value: T | undefined, setValue: (value: T | undefined | ((prevValue: T | undefined) => T | undefined)) => void];
+export declare function useMMKVObject<T>(key: string, instance?: MMKV): [
+    value: T | undefined,
+    setValue: (value: T | undefined | ((prevValue: T | undefined) => T | undefined)) => void
+];
 /**
  * Listen for changes in the given MMKV storage instance.
  * If no instance is passed, the default instance will be used.

package/lib/typescript/src/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAwB7C;;GAEG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAAC;AAChC;;;GAGG;AACH,wBAAgB,OAAO,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;AAiF5D;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,QAnEjB,MAAM,aACA,IAAI,kIAC8B,IAAI,CAmEpD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,QAjFjB,MAAM,aACA,IAAI,kIAC8B,IAAI,CAiFpD,CAAC;AACF;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,QA9FlB,MAAM,aACA,IAAI,sIAC8B,IAAI,CA8FpD,CAAC;AACF;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,QA3GjB,MAAM,aACA,IAAI,sJAC8B,IAAI,CA2GpD,CAAC;AACF;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,IAAI,GACd;IACD,KAAK,EAAE,CAAC,GAAG,SAAS;IACpB,QAAQ,EAAE,CACR,KAAK,EAAE,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,SAAS,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,GAAG,SAAS,CAAC,KACjE,IAAI;CACV,CA4BA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,oBAAoB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,EAC3C,QAAQ,CAAC,EAAE,IAAI,GACd,IAAI,CAYN"}

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}

package/package.json

@@ -1,17 +1,18 @@
 {
   "name": "react-native-mmkv",
-  "version": "2.12.2",
+  "version": "3.0.0-beta.1",
   "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",
-  "types": "lib/typescript/index.d.ts",
-  "react-native": "lib/module/index",
+  "types": "lib/typescript/src/index.d.ts",
+  "react-native": "src/index",
   "source": "src/index",
   "files": [
     "android/src",
     "android/build.gradle",
-    "android/gradle.properties",
     "android/CMakeLists.txt",
+    "android/cpp-adapter.cpp",
+    "android/gradle.properties",
     "cpp",
     "MMKV/Core",
     "lib/commonjs",
@@ -21,7 +22,6 @@
     "ios/**/*.m",
     "ios/**/*.mm",
     "ios/**/*.cpp",
-    "ios/Mmkv.xcodeproj/project.pbxproj",
     "src",
     "react-native-mmkv.podspec",
     "README.md",
@@ -34,21 +34,32 @@
     "lint-ci": "yarn lint -f ./node_modules/@firmnav/eslint-github-actions-formatter/dist/formatter.js",
     "lint-cpp": "scripts/clang-format.sh",
     "test": "jest",
+    "typecheck": "tsc --noEmit",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
     "prepare": "git submodule update --init --recursive && bob build",
     "prepack": "bob build",
     "update-submodule": "git submodule update --remote --merge",
-    "release": "release-it",
-    "example": "yarn --cwd example",
     "pods": "cd example && yarn pods",
-    "bootstrap": "git submodule update --init --recursive && yarn && cd example && yarn bootstrap"
+    "release": "release-it",
+    "codegen": "npx react-native codegen"
   },
   "keywords": [
     "react-native",
     "ios",
-    "android"
+    "android",
+    "mmkv",
+    "storage",
+    "key",
+    "value",
+    "fast",
+    "turbo",
+    "async"
   ],
-  "repository": "https://github.com/mrousavy/react-native-mmkv",
-  "author": "Marc Rousavy <marcrousavy@hotmail.com> (https://github.com/mrousavy)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mrousavy/react-native-mmkv.git"
+  },
+  "author": "Marc Rousavy <me@mrousavy.com> (https://github.com/mrousavy)",
   "license": "(MIT AND BSD-3-Clause)",
   "bugs": {
     "url": "https://github.com/mrousavy/react-native-mmkv/issues"
@@ -58,33 +69,30 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@jamesacarr/eslint-formatter-github-actions": "^0.2.0",
-    "@react-native-community/eslint-config": "^3.2.0",
-    "@react-native-community/eslint-plugin": "^1.3.0",
+    "@react-native-community/cli-types": "^14.0.0-alpha.1",
+    "@react-native/eslint-config": "^0.75.0-main",
     "@release-it/conventional-changelog": "^8.0.1",
-    "@testing-library/react-native": "^12.4.3",
-    "@tsconfig/react-native": "^3.0.3",
-    "@types/jest": "^29.5.12",
-    "@types/react": "^18.2.55",
-    "@types/react-test-renderer": "^18.0.7",
-    "@typescript-eslint/eslint-plugin": "^7.0.1",
-    "@typescript-eslint/parser": "^7.0.1",
-    "eslint": "^8.56.0",
-    "eslint-plugin-ft-flow": "^3.0.4",
-    "eslint-plugin-jest": "^27.8.0",
+    "@types/jest": "^29.5.5",
+    "@types/react": "^18.2.70",
+    "del-cli": "^5.1.0",
+    "eslint": "^8.51.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-plugin-prettier": "^5.0.1",
     "jest": "^29.7.0",
-    "metro-react-native-babel-preset": "^0.77.0",
-    "prettier": "^3.2.5",
-    "react": "^18.2.0",
-    "react-native": "^0.71.6",
-    "react-native-builder-bob": "^0.20.4",
-    "react-test-renderer": "^18.2.0",
-    "release-it": "^15.10.1",
-    "typescript": "^5.3.3"
+    "prettier": "^3.0.3",
+    "react": "18.2.0",
+    "react-native": "0.74.0-rc.5",
+    "react-native-builder-bob": "^0.23.2",
+    "release-it": "^17.1.1",
+    "typescript": "^5.2.2"
+  },
+  "resolutions": {
+    "@types/react": "^18.2.44",
+    "@react-native-community/cli": "^14.0.0-alpha.1"
   },
   "peerDependencies": {
     "react": "*",
-    "react-native": ">=0.71.0"
+    "react-native": "*"
   },
   "jest": {
     "preset": "react-native",
@@ -137,12 +145,9 @@
   "eslintConfig": {
     "root": true,
     "extends": [
-      "@react-native-community",
+      "@react-native",
       "prettier"
     ],
-    "plugins": [
-      "jest"
-    ],
     "rules": {
       "prettier/prettier": [
         "error",
@@ -182,8 +187,12 @@
     ]
   },
   "codegenConfig": {
-    "name": "reactnativemmkv",
+    "name": "RNMmkvSpec",
     "type": "modules",
-    "jsSrcsDir": "./lib/module"
-  }
+    "jsSrcsDir": "src"
+  },
+  "dependencies": {
+    "@testing-library/react-native": "^12.4.4"
+  },
+  "packageManager": "yarn@1.22.19+sha1.4ba7fc5c6e704fce2066ecbfb0b0d8976fe62447"
 }

package/react-native-mmkv.podspec

@@ -1,6 +1,7 @@
 require "json"
 
 package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+folly_compiler_flags = '-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-to-32'
 
 Pod::Spec.new do |s|
   s.name         = "react-native-mmkv"
@@ -10,27 +11,25 @@ Pod::Spec.new do |s|
   s.license      = package["license"]
   s.authors      = package["author"]
 
-  s.platforms    = { :ios => "11.0", :tvos => "12.0", :osx => "10.14" }
+  s.platforms    = { :ios => min_ios_version_supported }
   s.source       = { :git => "https://github.com/mrousavy/react-native-mmkv.git", :tag => "#{s.version}" }
 
-  # All source files that should be publicly visible
-  # Note how this does not include headers, since those can nameclash.
+  s.pod_target_xcconfig = {
+    "CLANG_CXX_LANGUAGE_STANDARD" => "c++17",
+    "CLANG_CXX_LIBRARY" => "libc++",
+    "CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF" => "NO",
+    # FORCE_POSIX ensures we are using C++ types instead of Objective-C types for MMKV.
+    "GCC_PREPROCESSOR_DEFINITIONS" => "$(inherited) FORCE_POSIX",
+  }
+  s.compiler_flags = '-x objective-c++'
+
   s.source_files = [
-    "ios/**/*.{m,mm}",
-    "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
-  # See https://github.com/firebase/firebase-ios-sdk/issues/4035 for more details.
-  s.preserve_paths = [
-    'ios/**/*.h'
+    # react-native-mmkv
+    "ios/**/*.{h,m,mm}",
+    "cpp/**/*.{hpp,cpp,c,h}",
+    # MMKV/Core
+    "MMKV/Core/**/*.{h,cpp,hpp,S}",
   ]
 
-  s.dependency "MMKV", ">= 1.3.3"
-  if respond_to?(:install_modules_dependencies, true)
-    install_modules_dependencies(s)
-  else
-    s.dependency "React-Core"
-  end
+  install_modules_dependencies(s)
 end

package/src/MMKV.ts

@@ -1,61 +1,22 @@
+import { AppState } from 'react-native';
 import { createMMKV } from './createMMKV';
 import { createMockMMKV } from './createMMKV.mock';
 import { isJest } from './PlatformChecker';
+import { Configuration } from './NativeMmkv';
+export { Configuration, Mode } from './NativeMmkv';
 
 interface Listener {
   remove: () => void;
 }
 
-/**
- * Used for configuration of a single MMKV instance.
- */
-export interface MMKVConfiguration {
-  /**
-   * The MMKV instance's ID. If you want to use multiple instances, make sure to use different IDs!
-   *
-   * @example
-   * ```ts
-   * const userStorage = new MMKV({ id: `user-${userId}-storage` })
-   * const globalStorage = new MMKV({ id: 'global-app-storage' })
-   * ```
-   *
-   * @default 'mmkv.default'
-   */
-  id: string;
-  /**
-   * The MMKV instance's root path. By default, MMKV stores file inside `$(Documents)/mmkv/`. You can customize MMKV's root directory on MMKV initialization:
-
-   * @example
-   * ```ts
-   * const temporaryStorage = new MMKV({ path: '/tmp/' })
-   * ```
-   * 
-   * _Notice_: On iOS you can set the AppGroup bundle property to share the same storage between your app and its extensions. 
-   * In this case `path` property will be ignored.
-   * See more on MMKV configuration [here](https://github.com/Tencent/MMKV/wiki/iOS_tutorial#configuration).
-   */
-  path?: string;
-  /**
-   * 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.
-   *
-   * Encryption keys can have a maximum length of 16 bytes.
-   *
-   * @example
-   * ```ts
-   * const secureStorage = new MMKV({ encryptionKey: 'my-encryption-key!' })
-   * ```
-   */
-  encryptionKey?: string;
-}
-
 /**
  * Represents a single MMKV instance.
  */
-interface MMKVInterface {
+export interface NativeMMKV {
   /**
    * Set a value for the given `key`.
    */
-  set: (key: string, value: boolean | string | number | Uint8Array) => void;
+  set: (key: string, value: boolean | string | number | ArrayBuffer) => void;
   /**
    * Get the boolean value for the given `key`, or `undefined` if it does not exist.
    *
@@ -79,7 +40,7 @@ interface MMKVInterface {
    *
    * @default undefined
    */
-  getBuffer: (key: string) => Uint8Array | undefined;
+  getBuffer: (key: string) => ArrayBuffer | undefined;
   /**
    * Checks whether the given `key` is being stored in this MMKV instance.
    */
@@ -106,6 +67,23 @@ interface MMKVInterface {
    * Encryption keys can have a maximum length of 16 bytes.
    */
   recrypt: (key: string | undefined) => void;
+  /**
+   * Trims the storage space and clears memory cache.
+   *
+   * Since MMKV does not resize itself after deleting keys, you can call `trim()`
+   * after deleting a bunch of keys to manually trim the memory- and
+   * disk-file to reduce storage and memory usage.
+   *
+   * In most applications, this is not needed at all.
+   */
+  trim(): void;
+  /**
+   * Get the current total size of the storage, in bytes.
+   */
+  readonly size: number;
+}
+
+interface MMKVInterface extends NativeMMKV {
   /**
    * Adds a value changed listener. The Listener will be called whenever any value
    * in this storage instance changes (set or delete).
@@ -117,20 +95,6 @@ interface MMKVInterface {
   ) => Listener;
 }
 
-export type NativeMMKV = Pick<
-  MMKVInterface,
-  | 'clearAll'
-  | 'contains'
-  | 'delete'
-  | 'getAllKeys'
-  | 'getBoolean'
-  | 'getNumber'
-  | 'getString'
-  | 'getBuffer'
-  | 'set'
-  | 'recrypt'
->;
-
 const onValueChangedListeners = new Map<string, ((key: string) => void)[]>();
 
 /**
@@ -145,12 +109,19 @@ export class MMKV implements MMKVInterface {
    * Creates a new MMKV instance with the given Configuration.
    * If no custom `id` is supplied, `'mmkv.default'` will be used.
    */
-  constructor(configuration: MMKVConfiguration = { id: 'mmkv.default' }) {
+  constructor(configuration: Configuration = { id: 'mmkv.default' }) {
     this.id = configuration.id;
     this.nativeInstance = isJest()
       ? createMockMMKV()
       : createMMKV(configuration);
     this.functionCache = {};
+
+    if ('WeakRef' in global) {
+      const weakSelf = new WeakRef(this);
+      AppState.addEventListener('memoryWarning', () => {
+        weakSelf.deref()?.trim();
+      });
+    }
   }
 
   private get onValueChangedListeners() {
@@ -179,7 +150,10 @@ export class MMKV implements MMKVInterface {
     }
   }
 
-  set(key: string, value: boolean | string | number | Uint8Array): void {
+  get size(): number {
+    return this.nativeInstance.size;
+  }
+  set(key: string, value: boolean | string | number | ArrayBuffer): void {
     const func = this.getFunctionFromCache('set');
     func(key, value);
 
@@ -197,7 +171,7 @@ export class MMKV implements MMKVInterface {
     const func = this.getFunctionFromCache('getNumber');
     return func(key);
   }
-  getBuffer(key: string): Uint8Array | undefined {
+  getBuffer(key: string): ArrayBuffer | undefined {
     const func = this.getFunctionFromCache('getBuffer');
     return func(key);
   }
@@ -227,6 +201,10 @@ export class MMKV implements MMKVInterface {
     const func = this.getFunctionFromCache('recrypt');
     return func(key);
   }
+  trim(): void {
+    const func = this.getFunctionFromCache('trim');
+    func();
+  }
 
   toString(): string {
     return `MMKV (${this.id}): [${this.getAllKeys().join(', ')}]`;