@novastera-oss/nitro-metamask 0.6.3 → 0.7.2

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

@@ -1,15 +1,55 @@
-import type { NitroMetamask as NitroMetamaskSpec, ConnectResult } from './specs/nitro-metamask.nitro';
+import type { NitroMetamask as NitroMetamaskSpec, ConnectResult, ConnectSignResult } from './specs/nitro-metamask.nitro';
 /**
  * NitroMetamask - MetaMask connector for React Native
  *
+ * Provides native MetaMask wallet integration via Nitro modules.
+ *
  * @example
  * ```ts
  * import { NitroMetamask } from '@novastera-oss/nitro-metamask'
  *
- * const result = await NitroMetamask.connect()
+ * // Optional: configure before use
+ * NitroMetamask.configure('https://yourdomain.com', 'yourscheme')
+ *
+ * // Connect wallet
+ * const { address, chainId } = await NitroMetamask.connect()
+ *
+ * // Sign a message
  * const signature = await NitroMetamask.signMessage('Hello')
+ *
+ * // Connect and sign in one step (SIWE)
+ * const result = await NitroMetamask.connectSign('my-nonce', BigInt(Date.now()))
  * ```
  */
 export declare const NitroMetamask: NitroMetamaskSpec;
-export type { ConnectResult, NitroMetamaskSpec };
+export type { ConnectResult, ConnectSignResult, NitroMetamaskSpec };
+/**
+ * Parses a structured Nitro error message that contains a numeric error code prefix.
+ *
+ * Nitro errors from the native layer are formatted as `"[<code>] <message>"`.
+ * This utility extracts the code and message so the JS layer can handle them
+ * programmatically (e.g., detecting `code: 2` for MetaMask not installed).
+ *
+ * @param e - The error to parse. Can be an `Error`, a string, or any value.
+ * @returns An object `{ code: number; message: string }` if the error message
+ *          matches the `[code] message` pattern, or `null` if it does not.
+ *
+ * @example
+ * ```ts
+ * import { parseNitroError } from '@novastera-oss/nitro-metamask'
+ *
+ * try {
+ *   await NitroMetamask.connect()
+ * } catch (e) {
+ *   const parsed = parseNitroError(e)
+ *   if (parsed?.code === 2) {
+ *     // MetaMask is not installed — redirect user to App Store / Play Store
+ *   }
+ * }
+ * ```
+ */
+export declare function parseNitroError(e: unknown): {
+    code: number;
+    message: string;
+} | null;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,IAAI,iBAAiB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAErG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,mBAAsE,CAAA;AAEhG,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,IAAI,iBAAiB,EAClC,aAAa,EACb,iBAAiB,EAClB,MAAM,8BAA8B,CAAA;AAErC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,aAAa,mBAAsE,CAAA;AAEhG,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAA;AAEnE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAMpF"}

package/lib/typescript/src/specs/nitro-metamask.nitro.d.ts

@@ -23,14 +23,42 @@ export interface NitroMetamask extends HybridObject<{
      *                         This is used to return to your app after MetaMask operations.
      */
     configure(dappUrl?: string, deepLinkScheme?: string): void;
+    /**
+     * Connect to the user's MetaMask wallet.
+     *
+     * Opens the MetaMask app via deep link to request wallet connection.
+     * If MetaMask is not installed, the promise rejects with `code: 2`.
+     *
+     * @returns Promise resolving to a `ConnectResult` containing the wallet
+     *          `address` and `chainId`.
+     *
+     * @example
+     * ```ts
+     * const { address, chainId } = await NitroMetamask.connect()
+     * ```
+     */
     connect(): Promise<ConnectResult>;
+    /**
+     * Request a `personal_sign` signature from the connected wallet.
+     *
+     * Must be called after a successful `connect()`. Opens MetaMask to prompt
+     * the user to sign the provided message.
+     *
+     * @param message - The plain-text message to sign.
+     * @returns Promise resolving to the hex-encoded signature string.
+     *
+     * @example
+     * ```ts
+     * const signature = await NitroMetamask.signMessage('Sign in to MyApp')
+     * ```
+     */
     signMessage(message: string): Promise<string>;
     /**
      * Connect to MetaMask (if not already connected) and sign a message containing nonce and expiration.
      * Returns the signature along with the address and chainId that were used to sign.
      *
      * @param nonce - A unique nonce for this signing request
-     * @param exp - Expiration timestamp (as bigint)
+     * @param exp - Expiration timestamp (as Int64)
      * @returns Promise resolving to ConnectSignResult containing signature, address, and chainId
      */
     connectSign(nonce: string, exp: Int64): Promise<ConnectSignResult>;

package/lib/typescript/src/specs/nitro-metamask.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nitro-metamask.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/nitro-metamask.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,4BAA4B,CAAA;AAE1E,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,KAAK,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,KAAK,CAAA;CACf;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;IACtF;;;;;;;;;OASG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1D,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,CAAA;IACjC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7C;;;;;;;OAOG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAClE;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACpC;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;CACpC"}
+{"version":3,"file":"nitro-metamask.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/nitro-metamask.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,4BAA4B,CAAA;AAE1E,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,KAAK,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,KAAK,CAAA;CACf;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY,CAAC;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAA;CAAE,CAAC;IACtF;;;;;;;;;OASG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1D;;;;;;;;;;;;;OAaG;IACH,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC,CAAA;IACjC;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7C;;;;;;;OAOG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAClE;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACpC;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;CACpC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@novastera-oss/nitro-metamask",
-  "version": "0.6.3",
+  "version": "0.7.2",
   "description": "Native mobile MetaMask wallet integration for React Native. Part of Novastera CRM/ERP platform ecosystem. Provides secure authentication and message signing for Web3 mobile applications.",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",
@@ -10,9 +10,9 @@
   "scripts": {
     "typecheck": "tsc --noEmit",
     "clean": "git clean -dfX",
+    "release": "semantic-release",
     "build": "npm run typecheck && bob build",
-    "codegen": "nitrogen --logLevel=\"debug\" && npm run build",
-    "build:ecies:all-abis": "cd example/android && ./gradlew :app:assembleRelease -PreactNativeArchitectures=arm64-v8a,armeabi-v7a,x86_64,x86 -PNitroMetamask_buildEciesFromSource=true --no-daemon --stacktrace"
+    "codegen": "nitrogen --logLevel=\"debug\" && npm run build"
   },
   "keywords": [
     "react-native",
@@ -48,6 +48,10 @@
     "android/proguard-rules.pro",
     "android/src",
     "android/src/main/jniLibs",
+    "android/src/main/java/io/metamask/**",
+    "android/src/main/aidl/**",
+    "ios/metamask-ios-sdk/**",
+    "ios/Frameworks/**",
     "ios/**/*.h",
     "ios/**/*.m",
     "ios/**/*.mm",
@@ -58,9 +62,7 @@
     "README.md",
     "rust/ecies-jni/Cargo.toml",
     "rust/ecies-jni/src",
-    "rust/ecies-jni/Cargo.lock",
-    "scripts/verify-16k-page-alignment.sh",
-    "scripts/verify-16k-page-alignment.py"
+    "rust/ecies-jni/Cargo.lock"
   ],
   "workspaces": [
     "example"
@@ -78,22 +80,29 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@jamesacarr/eslint-formatter-github-actions": "^0.2.0",
+    "@babel/core": "^7.29.0",
+    "@babel/preset-env": "^7.29.2",
+    "@babel/preset-typescript": "^7.28.5",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
     "@types/jest": "^29.5.12",
     "@types/react": "19.2.0",
-    "nitrogen": "0.35.5",
+    "babel-jest": "^30.3.0",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "jest": "^30.3.0",
+    "nitrogen": "^0.35.5",
     "react": "19.2.0",
     "react-native": "0.83",
-    "react-native-builder-bob": "^0.40.17",
+    "react-native-builder-bob": "^0.40.18",
     "react-native-nitro-modules": "0.35.5",
-    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "semantic-release": "^25.0.2",
     "typescript": "^5.8.3"
   },
   "peerDependencies": {
+    "@expo/config-plugins": "*",
     "react": "*",
     "react-native": "*",
-    "react-native-nitro-modules": "*",
-    "@expo/config-plugins": "*"
+    "react-native-nitro-modules": "*"
   },
   "eslintConfig": {
     "root": true,

package/react-native.config.js

@@ -13,6 +13,11 @@ module.exports = {
       android: {
         packageImportPath: 'import com.margelo.nitro.nitrometamask.NitroMetamaskPackage;',
         packageInstance: 'new NitroMetamaskPackage()',
+        // New Arch: do not register RN Codegen + app CMake `react_codegen_*` for this dep.
+        // Native code is built via this library’s Gradle+CMake+JNI (Nitrogen), packaged in the AAR;
+        // autolink is only for Java Package / Gradle project inclusion.
+        libraryName: null,
+        cmakeListsPath: null,
       },
     },
   },

package/rust/ecies-jni/Cargo.lock

@@ -82,12 +82,6 @@ version = "1.11.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1e748733b7cbc798e1434b6ac524f0c1ff2ab456fe201501e6497c8417a4fc33"
 
-[[package]]
-name = "cesu8"
-version = "1.1.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6d43a04d8753f35258c91f8ec639f792891f748a1edbd759cf1dcea3382ad83c"
-
 [[package]]
 name = "cfg-if"
 version = "1.0.4"
@@ -270,27 +264,32 @@ dependencies = [
 
 [[package]]
 name = "jni"
-version = "0.21.1"
+version = "0.22.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1a87aa2bb7d2af34197c04845522473242e1aa17c12f4935d5856491a7fb8c97"
+checksum = "5efd9a482cf3a427f00d6b35f14332adc7902ce91efb778580e180ff90fa3498"
 dependencies = [
- "cesu8",
  "cfg-if",
  "combine",
- "jni-sys 0.3.1",
+ "jni-macros",
+ "jni-sys",
  "log",
+ "simd_cesu8",
  "thiserror",
  "walkdir",
- "windows-sys 0.45.0",
+ "windows-link",
 ]
 
 [[package]]
-name = "jni-sys"
-version = "0.3.1"
+name = "jni-macros"
+version = "0.22.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "41a652e1f9b6e0275df1f15b32661cf0d4b78d4d87ddec5e0c3c20f097433258"
+checksum = "a00109accc170f0bdb141fed3e393c565b6f5e072365c3bd58f5b062591560a3"
 dependencies = [
- "jni-sys 0.4.1",
+ "proc-macro2",
+ "quote",
+ "rustc_version",
+ "simd_cesu8",
+ "syn",
 ]
 
 [[package]]
@@ -497,6 +496,15 @@ dependencies = [
  "bitflags",
 ]
 
+[[package]]
+name = "rustc_version"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cfcb3a22ef46e85b45de6ee7e79d063319ebb6594faafcf1c225ea92ab6e9b92"
+dependencies = [
+ "semver",
+]
+
 [[package]]
 name = "rustversion"
 version = "1.0.22"
@@ -518,6 +526,12 @@ version = "1.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
 
+[[package]]
+name = "semver"
+version = "1.0.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8a7852d02fc848982e0c167ef163aaff9cd91dc640ba85e263cb1ce46fae51cd"
+
 [[package]]
 name = "serde"
 version = "1.0.228"
@@ -559,6 +573,22 @@ dependencies = [
  "digest 0.10.7",
 ]
 
+[[package]]
+name = "simd_cesu8"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94f90157bb87cddf702797c5dadfa0be7d266cdf49e22da2fcaa32eff75b2c33"
+dependencies = [
+ "rustc_version",
+ "simdutf8",
+]
+
+[[package]]
+name = "simdutf8"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e3a9fe34e3e7a50316060351f37187a3f546bce95496156754b601a5fa71b76e"
+
 [[package]]
 name = "smallvec"
 version = "1.15.1"
@@ -584,18 +614,18 @@ dependencies = [
 
 [[package]]
 name = "thiserror"
-version = "1.0.69"
+version = "2.0.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b6aaf5339b578ea85b50e080feb250a3e8ae8cfcdff9a461c9ec2904bc923f52"
+checksum = "4288b5bcbc7920c07a1149a35cf9590a2aa808e0bc1eafaade0b80947865fbc4"
 dependencies = [
  "thiserror-impl",
 ]
 
 [[package]]
 name = "thiserror-impl"
-version = "1.0.69"
+version = "2.0.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4fee6c4efc90059e10f81e6d42c60a18f76588c3d74cb83a0b242a2b6c7504c1"
+checksum = "ebc4ee7f67670e9b64d05fa4253e753e016c6c95ff35b89b7941d6b856dec1d5"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -697,7 +727,7 @@ version = "0.1.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c2a7b1c03c876122aa43f3020e6c3c3ee5c05081c9a00739faf7503aeba10d22"
 dependencies = [
- "windows-sys 0.61.2",
+ "windows-sys",
 ]
 
 [[package]]
@@ -706,15 +736,6 @@ version = "0.2.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
 
-[[package]]
-name = "windows-sys"
-version = "0.45.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "75283be5efb2831d37ea142365f009c02ec203cd29a3ebecbc093d52315b66d0"
-dependencies = [
- "windows-targets",
-]
-
 [[package]]
 name = "windows-sys"
 version = "0.61.2"
@@ -723,60 +744,3 @@ checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
 dependencies = [
  "windows-link",
 ]
-
-[[package]]
-name = "windows-targets"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8e5180c00cd44c9b1c88adb3693291f1cd93605ded80c250a75d472756b4d071"
-dependencies = [
- "windows_aarch64_gnullvm",
- "windows_aarch64_msvc",
- "windows_i686_gnu",
- "windows_i686_msvc",
- "windows_x86_64_gnu",
- "windows_x86_64_gnullvm",
- "windows_x86_64_msvc",
-]
-
-[[package]]
-name = "windows_aarch64_gnullvm"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "597a5118570b68bc08d8d59125332c54f1ba9d9adeedeef5b99b02ba2b0698f8"
-
-[[package]]
-name = "windows_aarch64_msvc"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e08e8864a60f06ef0d0ff4ba04124db8b0fb3be5776a5cd47641e942e58c4d43"
-
-[[package]]
-name = "windows_i686_gnu"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c61d927d8da41da96a81f029489353e68739737d3beca43145c8afec9a31a84f"
-
-[[package]]
-name = "windows_i686_msvc"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "44d840b6ec649f480a41c8d80f9c65108b92d89345dd94027bfe06ac444d1060"
-
-[[package]]
-name = "windows_x86_64_gnu"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8de912b8b8feb55c064867cf047dda097f92d51efad5b491dfb98f6bbb70cb36"
-
-[[package]]
-name = "windows_x86_64_gnullvm"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "26d41b46a36d453748aedef1486d5c7a85db22e56aff34643984ea85514e94a3"
-
-[[package]]
-name = "windows_x86_64_msvc"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9aec5da331524158c6d1a4ac0ab1541149c0b9505fde06423b02f5ef0106b9f0"

package/rust/ecies-jni/Cargo.toml

@@ -10,7 +10,7 @@ crate-type = ["cdylib"]
 name = "ecies"
 
 [dependencies]
-jni = "0.21"
+jni = "0.22"
 # Match ecies.org / MetaMask stack (secp256k1, AES-256-GCM); pure Rust AES for simpler Android linking
 ecies = { version = "0.2.10", default-features = false, features = ["std", "aes-rust"] }
 hex = "0.4"