@react-native-ohos/react-native-mmkv 3.3.1-1

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

@@ -0,0 +1,86 @@
+import { MMKV } from './MMKV';
+import type { Configuration } from './Types';
+/**
+ * Use the default, shared MMKV instance.
+ */
+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: Configuration): MMKV;
+/**
+ * Use the string value of the given `key` from the given MMKV storage instance.
+ *
+ * If no instance is provided, a shared default instance will be used.
+ *
+ * @example
+ * ```ts
+ * const [username, setUsername] = useMMKVString("user.name")
+ * ```
+ */
+export declare const useMMKVString: (key: string, instance?: MMKV) => [value: string | undefined, setValue: (value: string | ((current: string | undefined) => string | undefined) | undefined) => void];
+/**
+ * Use the number value of the given `key` from the given MMKV storage instance.
+ *
+ * If no instance is provided, a shared default instance will be used.
+ *
+ * @example
+ * ```ts
+ * const [age, setAge] = useMMKVNumber("user.age")
+ * ```
+ */
+export declare const useMMKVNumber: (key: string, instance?: MMKV) => [value: number | undefined, setValue: (value: number | ((current: number | undefined) => number | undefined) | undefined) => void];
+/**
+ * Use the boolean value of the given `key` from the given MMKV storage instance.
+ *
+ * If no instance is provided, a shared default instance will be used.
+ *
+ * @example
+ * ```ts
+ * const [isPremiumAccount, setIsPremiumAccount] = useMMKVBoolean("user.isPremium")
+ * ```
+ */
+export declare const useMMKVBoolean: (key: string, instance?: MMKV) => [value: boolean | undefined, setValue: (value: boolean | ((current: boolean | undefined) => boolean | undefined) | undefined) => void];
+/**
+ * Use the buffer value (unsigned 8-bit (0-255)) of the given `key` from the given MMKV storage instance.
+ *
+ * If no instance is provided, a shared default instance will be used.
+ *
+ * @example
+ * ```ts
+ * const [privateKey, setPrivateKey] = useMMKVBuffer("user.privateKey")
+ * ```
+ */
+export declare const useMMKVBuffer: (key: string, instance?: MMKV) => [value: ArrayBufferLike | undefined, setValue: (value: ArrayBufferLike | ((current: ArrayBufferLike | undefined) => ArrayBufferLike | undefined) | undefined) => void];
+/**
+ * Use an object value of the given `key` from the given MMKV storage instance.
+ *
+ * If no instance is provided, a shared default instance will be used.
+ *
+ * The object will be serialized using `JSON`.
+ *
+ * @example
+ * ```ts
+ * 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
+];
+/**
+ * Listen for changes in the given MMKV storage instance.
+ * If no instance is passed, the default instance will be used.
+ * @param valueChangedListener The function to call whenever a value inside the storage instance changes
+ * @param instance The instance to listen to changes to (or the default instance)
+ *
+ * @example
+ * ```ts
+ * useMMKVListener((key) => {
+ *   console.log(`Value for "${key}" changed!`)
+ * })
+ * ```
+ */
+export declare function useMMKVListener(valueChangedListener: (key: string) => void, instance?: MMKV): void;
+//# sourceMappingURL=hooks.d.ts.map

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,MAAM,QAAQ,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,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,sKAC8B,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

@@ -0,0 +1,4 @@
+export * from './MMKV';
+export * from './hooks';
+export { Mode, type Configuration } from './Types';
+//# sourceMappingURL=index.d.ts.map

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

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

package/package.json

@@ -0,0 +1,187 @@
+{
+  "name": "@react-native-ohos/react-native-mmkv",
+  "version": "3.3.1-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/src/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "files": [
+    "cpp/**/*.h",
+    "cpp/**/*.cpp",
+    "MMKV/Core",
+    "android/src",
+    "android/build.gradle",
+    "android/CMakeLists.txt",
+    "android/cpp-adapter.cpp",
+    "android/gradle.properties",
+    "lib/commonjs",
+    "lib/module",
+    "lib/typescript",
+    "ios/**/*.h",
+    "ios/**/*.m",
+    "ios/**/*.mm",
+    "ios/**/*.cpp",
+    "src",
+    "react-native-mmkv.podspec",
+    "react-native.config.js",
+    "README.md",
+    "harmony"
+  ],
+  "scripts": {
+    "typescript": "tsc --noEmit",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "lint-ci": "yarn lint -f ./node_modules/@firmnav/eslint-github-actions-formatter/dist/formatter.js",
+    "lint-cpp": "scripts/clang-format.sh",
+    "check-all": "yarn lint --fix && yarn lint-cpp",
+    "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",
+    "pods": "cd example && yarn pods",
+    "release": "release-it",
+    "codegen": "npx react-native codegen"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "mmkv",
+    "storage",
+    "key",
+    "value",
+    "fast",
+    "turbo",
+    "async"
+  ],
+  "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"
+  },
+  "homepage": "https://github.com/mrousavy/react-native-mmkv#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@firmnav/eslint-github-actions-formatter": "^1.0.1",
+    "@jamesacarr/eslint-formatter-github-actions": "^0.2.0",
+    "@react-native-community/cli": "11.3.6",
+    "@react-native-community/cli-types": "^15.1.3",
+    "@react-native/eslint-config": "^0.77.1",
+    "@release-it/conventional-changelog": "^9.0.1",
+    "@rnoh/react-native-harmony-cli": "npm:@react-native-oh/react-native-harmony-cli@^0.0.27",
+    "@testing-library/react-native": "^13.0.1",
+    "@types/jest": "^29.5.13",
+    "@types/react": "^18.3.11",
+    "del-cli": "^6.0.0",
+    "eslint": "^8.51.0",
+    "eslint-config-prettier": "^9.0.0",
+    "eslint-plugin-prettier": "^5.2.1",
+    "jest": "^29.7.0",
+    "memfs": "4.17.2",
+    "metro": "0.82.5",
+    "prettier": "^3.3.3",
+    "react": "^18.3.1",
+    "react-native": "^0.77.1",
+    "react-native-builder-bob": "^0.40.16",
+    "react-test-renderer": "18.3.1",
+    "release-it": "^17.10.0",
+    "typescript": "^5.5.4"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "conventionalcommits",
+          "types": [
+            {
+              "type": "feat",
+              "section": "✨ Features"
+            },
+            {
+              "type": "fix",
+              "section": "🐛 Bug Fixes"
+            },
+            {
+              "type": "perf",
+              "section": "💨 Performance Improvements"
+            },
+            {
+              "type": "chore(deps)",
+              "section": "🛠️ Dependency Upgrades"
+            },
+            {
+              "type": "docs",
+              "section": "📚 Documentation"
+            }
+          ]
+        }
+      }
+    }
+  },
+  "eslintIgnore": [
+    "node_modules/",
+    "lib/",
+    "MMKV"
+  ],
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "RNMmkvSpec",
+    "type": "modules",
+    "jsSrcsDir": "src"
+  },
+  "harmony": {
+    "alias": "react-native-mmkv"
+  },
+  "packageManager": "yarn@1.22.19+sha1.4ba7fc5c6e704fce2066ecbfb0b0d8976fe62447"
+}

package/react-native-mmkv.podspec

@@ -0,0 +1,38 @@
+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::UI.puts "[react-native-mmkv] Thank you for using react-native-mmkv ❤️"
+Pod::UI.puts "[react-native-mmkv] If you enjoy using react-native-mmkv, please consider sponsoring this project: https://github.com/sponsors/mrousavy"
+
+Pod::Spec.new do |s|
+  s.name         = "react-native-mmkv"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported, :tvos => "12.0", :osx => "10.14" }
+  s.source       = { :git => "https://github.com/mrousavy/react-native-mmkv.git", :tag => "#{s.version}" }
+
+  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.libraries    = "z", "c++"
+  s.source_files = [
+    # react-native-mmkv
+    "ios/**/*.{h,m,mm}",
+    "cpp/**/*.{hpp,cpp,c,h}",
+    # MMKV/Core
+    "MMKV/Core/**/*.{h,cpp,hpp,S}",
+  ]
+
+  install_modules_dependencies(s)
+end

package/react-native.config.js

@@ -0,0 +1,20 @@
+// https://github.com/react-native-community/cli/blob/main/docs/dependencies.md
+
+module.exports = {
+  dependency: {
+    platforms: {
+      /**
+       * @type {import('@react-native-community/cli-types').IOSDependencyParams}
+       */
+      ios: {},
+      /**
+       * @type {import('@react-native-community/cli-types').AndroidDependencyParams}
+       */
+      android: {
+        cxxModuleCMakeListsModuleName: 'react-native-mmkv',
+        cxxModuleCMakeListsPath: 'CMakeLists.txt',
+        cxxModuleHeaderName: 'NativeMmkvModule',
+      },
+    },
+  },
+};

package/src/MMKV.ts

@@ -0,0 +1,142 @@
+import { createMMKV } from './createMMKV';
+import { createMockMMKV } from './createMMKV.mock';
+import { isTest } from './PlatformChecker';
+import type {
+  Configuration,
+  Listener,
+  MMKVInterface,
+  NativeMMKV,
+} from './Types';
+import { addMemoryWarningListener } from './MemoryWarningListener';
+
+const onValueChangedListeners = new Map<string, ((key: string) => void)[]>();
+
+/**
+ * A single MMKV instance.
+ */
+export class MMKV implements MMKVInterface {
+  private nativeInstance: NativeMMKV;
+  private functionCache: Partial<NativeMMKV>;
+  private id: string;
+
+  /**
+   * Creates a new MMKV instance with the given Configuration.
+   * If no custom `id` is supplied, `'mmkv.default'` will be used.
+   */
+  constructor(configuration: Configuration = { id: 'mmkv.default' }) {
+    this.id = configuration.id;
+    this.nativeInstance = isTest()
+      ? createMockMMKV()
+      : createMMKV(configuration);
+    this.functionCache = {};
+
+    addMemoryWarningListener(this);
+  }
+
+  private get onValueChangedListeners() {
+    if (!onValueChangedListeners.has(this.id)) {
+      onValueChangedListeners.set(this.id, []);
+    }
+    return onValueChangedListeners.get(this.id)!;
+  }
+
+  private getFunctionFromCache<T extends keyof NativeMMKV>(
+    functionName: T
+  ): NativeMMKV[T] {
+    if (this.functionCache[functionName] == null) {
+      this.functionCache[functionName] = this.nativeInstance[functionName];
+    }
+    return this.functionCache[functionName] as NativeMMKV[T];
+  }
+
+  private onValuesChanged(keys: string[]) {
+    if (this.onValueChangedListeners.length === 0) return;
+
+    for (const key of keys) {
+      for (const listener of this.onValueChangedListeners) {
+        listener(key);
+      }
+    }
+  }
+
+  get size(): number {
+    return this.nativeInstance.size;
+  }
+  get isReadOnly(): boolean {
+    return this.nativeInstance.isReadOnly;
+  }
+  set(key: string, value: boolean | string | number | ArrayBuffer): void {
+    const func = this.getFunctionFromCache('set');
+    func(key, value);
+
+    this.onValuesChanged([key]);
+  }
+  getBoolean(key: string): boolean | undefined {
+    const func = this.getFunctionFromCache('getBoolean');
+    return func(key);
+  }
+  getString(key: string): string | undefined {
+    const func = this.getFunctionFromCache('getString');
+    return func(key);
+  }
+  getNumber(key: string): number | undefined {
+    const func = this.getFunctionFromCache('getNumber');
+    return func(key);
+  }
+  getBuffer(key: string): ArrayBufferLike | undefined {
+    const func = this.getFunctionFromCache('getBuffer');
+    return func(key);
+  }
+  contains(key: string): boolean {
+    const func = this.getFunctionFromCache('contains');
+    return func(key);
+  }
+  delete(key: string): void {
+    const func = this.getFunctionFromCache('delete');
+    func(key);
+
+    this.onValuesChanged([key]);
+  }
+  getAllKeys(): string[] {
+    const func = this.getFunctionFromCache('getAllKeys');
+    return func();
+  }
+  clearAll(): void {
+    const keys = this.getAllKeys();
+
+    const func = this.getFunctionFromCache('clearAll');
+    func();
+
+    this.onValuesChanged(keys);
+  }
+  recrypt(key: string | undefined): void {
+    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(', ')}]`;
+  }
+  toJSON(): object {
+    return {
+      [this.id]: this.getAllKeys(),
+    };
+  }
+
+  addOnValueChangedListener(onValueChanged: (key: string) => void): Listener {
+    this.onValueChangedListeners.push(onValueChanged);
+
+    return {
+      remove: () => {
+        const index = this.onValueChangedListeners.indexOf(onValueChanged);
+        if (index !== -1) {
+          this.onValueChangedListeners.splice(index, 1);
+        }
+      },
+    };
+  }
+}

package/src/MemoryWarningListener.ts

@@ -0,0 +1,29 @@
+import { AppState } from 'react-native';
+import type { NativeEventSubscription } from 'react-native';
+import { MMKVInterface } from './Types';
+
+export function addMemoryWarningListener(mmkv: MMKVInterface): void {
+  if (global.WeakRef != null && global.FinalizationRegistry != null) {
+    // 1. Weakify MMKV so we can safely use it inside the memoryWarning event listener
+    const weakMmkv = new WeakRef(mmkv);
+    const listener = AppState.addEventListener('memoryWarning', () => {
+      // 0. Everytime we receive a memoryWarning, we try to trim the MMKV instance (if it is still valid)
+      weakMmkv.deref()?.trim();
+    });
+    // 2. Add a listener to when the MMKV instance is deleted
+    const finalization = new FinalizationRegistry(
+      (l: NativeEventSubscription) => {
+        // 3. When MMKV is deleted, this listener will be called with the memoryWarning listener.
+        l.remove();
+      }
+    );
+    // 2.1. Bind the listener to the actual MMKV instance.
+    finalization.register(mmkv, listener);
+  } else {
+    // WeakRef/FinalizationRegistry is not implemented in this engine.
+    // Just add the listener, even if it retains MMKV strong forever.
+    AppState.addEventListener('memoryWarning', () => {
+      mmkv.trim();
+    });
+  }
+}

package/src/MemoryWarningListener.web.ts

@@ -0,0 +1,5 @@
+import { MMKVInterface } from './Types';
+
+export const addMemoryWarningListener = (_mmkv: MMKVInterface): void => {
+  //no-op function, there is not a web equivalent to memory warning
+};

package/src/ModuleNotFoundError.ts

@@ -0,0 +1,95 @@
+import { NativeModules, Platform } from 'react-native';
+
+declare global {
+  // A react-native internal from TurboModuleRegistry.js
+  var __turboModuleProxy: unknown | undefined;
+}
+
+const BULLET_POINT = '\n* ';
+
+function messageWithSuggestions(
+  message: string,
+  suggestions: string[]
+): string {
+  return message + BULLET_POINT + suggestions.join(BULLET_POINT);
+}
+
+function getFrameworkType(): 'react-native' | 'expo' | 'expo-go' {
+  // check if Expo
+  const ExpoConstants =
+    NativeModules.NativeUnimoduleProxy?.modulesConstants?.ExponentConstants;
+  if (ExpoConstants != null) {
+    if (ExpoConstants.appOwnership === 'expo') {
+      // We're running Expo Go
+      return 'expo-go';
+    } else {
+      // We're running Expo bare / standalone
+      return 'expo';
+    }
+  }
+  return 'react-native';
+}
+
+export class ModuleNotFoundError extends Error {
+  constructor(cause?: unknown) {
+    // TurboModule not found, something went wrong!
+    if (global.__turboModuleProxy == null) {
+      // TurboModules are not available/new arch is not enabled.
+      // react-native-mmkv 3.x.x requires new arch (react-native >0.74)
+      // react-native-mmkv 2.x.x works on old arch (react-native <0.74)
+      const message =
+        'Failed to create a new MMKV instance: react-native-mmkv 3.x.x requires TurboModules, but the new architecture is not enabled!';
+      const suggestions: string[] = [];
+      suggestions.push(
+        'Downgrade to react-native-mmkv 2.x.x if you want to stay on the old architecture.'
+      );
+      suggestions.push(
+        'Enable the new architecture in your app to use react-native-mmkv 3.x.x. (See https://github.com/reactwg/react-native-new-architecture/blob/main/docs/enable-apps.md)'
+      );
+      const error = messageWithSuggestions(message, suggestions);
+      super(error, { cause: cause });
+      return;
+    }
+
+    const framework = getFrameworkType();
+    if (framework === 'expo-go') {
+      super(
+        'react-native-mmkv is not supported in Expo Go! Use EAS (`expo prebuild`) or eject to a bare workflow instead.'
+      );
+      return;
+    }
+
+    const message =
+      'Failed to create a new MMKV instance: The native MMKV Module could not be found.';
+    const suggestions: string[] = [];
+    suggestions.push(
+      'Make sure react-native-mmkv is correctly autolinked (run `npx react-native config` to verify)'
+    );
+    suggestions.push(
+      'Make sure you enabled the new architecture (TurboModules) and CodeGen properly generated the react-native-mmkv specs. See https://github.com/reactwg/react-native-new-architecture/blob/main/docs/enable-apps.md'
+    );
+    suggestions.push(
+      'Make sure you are using react-native 0.74.0 or higher, because react-native-mmkv is a C++ TurboModule.'
+    );
+    suggestions.push('Make sure you rebuilt the app.');
+    if (framework === 'expo') {
+      suggestions.push('Make sure you ran `expo prebuild`.');
+    }
+    switch (Platform.OS) {
+      case 'ios':
+      case 'macos':
+        suggestions.push(
+          'Make sure you ran `pod install` in the ios/ directory.'
+        );
+        break;
+      case 'android':
+        suggestions.push('Make sure gradle is synced.');
+        break;
+      default:
+        throw new Error(`MMKV is not supported on ${Platform.OS}!`);
+    }
+
+    const error = messageWithSuggestions(message, suggestions);
+    super(error, { cause: cause });
+  }
+}