@novastera-oss/nitro-metamask 0.2.7 → 0.3.3

package/package.json

@@ -1,20 +1,35 @@
 {
   "name": "@novastera-oss/nitro-metamask",
-  "version": "0.2.7",
-  "description": "nitro-metamask",
-  "main": "lib/index",
-  "module": "lib/index",
-  "types": "lib/index.d.ts",
+  "version": "0.3.3",
+  "description": "Novastera metamask authentication with native mobile libraries",
+  "main": "./lib/commonjs/index.js",
+  "module": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
   "react-native": "src/index",
   "source": "src/index",
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "clean": "git clean -dfX",
+    "release": "semantic-release",
+    "build": "npm run typecheck && bob build",
+    "codegen": "nitrogen --logLevel=\"debug\" && npm run build"
+  },
+  "keywords": [
+    "react-native",
+    "@novastera-oss/nitro-metamask",
+    "metamask",
+    "novastera"
+  ],
   "files": [
     "src",
     "react-native.config.js",
     "lib",
     "nitrogen",
+    "cpp",
+    "nitro.json",
     "android/build.gradle",
-    "android/gradle.properties",
     "android/fix-prefab.gradle",
+    "android/gradle.properties",
     "android/CMakeLists.txt",
     "android/src",
     "ios/**/*.h",
@@ -23,53 +38,40 @@
     "ios/**/*.cpp",
     "ios/**/*.swift",
     "app.plugin.js",
-    "nitro.json",
     "*.podspec",
     "README.md"
   ],
-  "scripts": {
-    "postinstall": "tsc || exit 0;",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf android/build node_modules/**/android/build lib",
-    "lint": "eslint \"**/*.{js,ts,tsx}\" --fix",
-    "lint-ci": "eslint \"**/*.{js,ts,tsx}\" -f @jamesacarr/github-actions",
-    "typescript": "tsc",
-    "specs": "tsc --noEmit false && nitrogen --logLevel=\"debug\""
-  },
-  "keywords": [
-    "react-native",
-    "nitro"
+  "workspaces": [
+    "example"
   ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/novastera/nitro-metamask"
-  },
-  "author": "Novastera <hassan@novastera.com>",
+  "repository": "https://github.com/darksorrow/@novastera-oss/nitro-metamask.git",
+  "author": "DarkSorrow",
   "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/novastera/nitro-metamask/issues"
-  },
-  "homepage": "https://novastera.com",
+  "bugs": "https://github.com/darksorrow/@novastera-oss/nitro-metamask/issues",
+  "homepage": "https://github.com/darksorrow/@novastera-oss/nitro-metamask#readme",
   "publishConfig": {
+    "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@react-native/eslint-config": "0.82.0",
-    "@types/react": "^19.1.03",
-    "eslint": "^9.39.0",
-    "eslint-config-prettier": "^10.1.0",
-    "eslint-plugin-prettier": "^5.2.1",
-    "nitrogen": "^0.32.0",
-    "prettier": "^3.3.3",
-    "react": "19.1.1",
-    "react-native": "0.82.0",
-    "react-native-nitro-modules": "^0.32.0",
+    "@jamesacarr/eslint-formatter-github-actions": "^0.2.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/jest": "^29.5.12",
+    "@types/react": "19.2.0",
+    "nitrogen": "0.32.0",
+    "react": "19.2.0",
+    "react-native": "0.83",
+    "react-native-builder-bob": "^0.40.17",
+    "react-native-nitro-modules": "0.32.0",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "semantic-release": "^25.0.2",
     "typescript": "^5.8.3"
   },
   "peerDependencies": {
     "react": "*",
     "react-native": "*",
-    "react-native-nitro-modules": "^0.32.0"
+    "react-native-nitro-modules": "*"
   },
   "eslintConfig": {
     "root": true,
@@ -104,5 +106,19 @@
     "trailingComma": "es5",
     "useTabs": false,
     "semi": false
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.json"
+        }
+      ]
+    ]
   }
 }

package/react-native.config.js

@@ -10,7 +10,10 @@ module.exports = {
       /**
        * @type {import('@react-native-community/cli-types').AndroidDependencyParams}
        */
-      android: {},
+      android: {
+        packageImportPath: 'import com.margelo.nitro.nitrometamask.NitroMetamaskPackage;',
+        packageInstance: 'new NitroMetamaskPackage()',
+      },
     },
   },
 }

package/src/index.ts

@@ -1,8 +1,17 @@
 import { NitroModules } from 'react-native-nitro-modules'
+import type { NitroMetamask as NitroMetamaskSpec, ConnectResult } from './specs/nitro-metamask.nitro'
 
-import type { ConnectResult, MetamaskConnector } from './MetamaskConnector.nitro'
+/**
+ * NitroMetamask - MetaMask connector for React Native
+ * 
+ * @example
+ * ```ts
+ * import { NitroMetamask } from '@novastera-oss/nitro-metamask'
+ * 
+ * const result = await NitroMetamask.connect()
+ * const signature = await NitroMetamask.signMessage('Hello')
+ * ```
+ */
+export const NitroMetamask = NitroModules.createHybridObject<NitroMetamaskSpec>('NitroMetamask')
 
-export const metamaskConnector =
-  NitroModules.createHybridObject<MetamaskConnector>('MetamaskConnector')
-
-export type { ConnectResult, MetamaskConnector }
+export type { ConnectResult, NitroMetamaskSpec }

package/src/specs/nitro-metamask.nitro.ts

@@ -0,0 +1,21 @@
+import { type HybridObject } from 'react-native-nitro-modules'
+
+export interface ConnectResult {
+  address: string
+  chainId: number
+}
+
+export interface NitroMetamask extends HybridObject<{ ios: 'swift', android: 'kotlin' }> {
+  /**
+   * Configure the dapp URL for MetaMask SDK validation.
+   * This URL is only used for SDK validation - the deep link return is handled automatically via AndroidManifest.xml.
+   * 
+   * @param dappUrl - A valid HTTP/HTTPS URL (e.g., "https://yourdomain.com"). 
+   *                  If not provided, defaults to "https://novastera.com".
+   *                  This is separate from the deep link scheme which is auto-detected from your manifest.
+   */
+  configure(dappUrl?: string): void
+  connect(): Promise<ConnectResult>
+  signMessage(message: string): Promise<string>
+  connectSign(nonce: string, exp: bigint): Promise<string>
+}

package/android/src/main/java/com/margelo/nitro/nitrometamask/HybridMetamaskConnector.kt

@@ -1,126 +0,0 @@
-package com.margelo.nitro.nitrometamask
-
-import com.margelo.nitro.core.Promise
-import io.metamask.androidsdk.Ethereum
-import io.metamask.androidsdk.Result
-import io.metamask.androidsdk.DappMetadata
-import io.metamask.androidsdk.SDKOptions
-import io.metamask.androidsdk.EthereumRequest
-import io.metamask.androidsdk.EthereumMethod
-import kotlinx.coroutines.suspendCancellableCoroutine
-import kotlin.coroutines.resume
-
-class HybridMetamaskConnector : HybridMetamaskConnectorSpec() {
-    // Initialize Ethereum SDK with Context, DappMetadata, and SDKOptions
-    // Based on: https://github.com/MetaMask/metamask-android-sdk
-    // Using MetamaskContextHolder for Context access (Nitro doesn't provide Context APIs)
-    // This pattern matches how other Nitro modules handle Context (VisionCamera, MMKV, etc.)
-    private val ethereum: Ethereum by lazy {
-        val context = MetamaskContextHolder.get()
-        
-        val dappMetadata = DappMetadata(
-            name = "Nitro MetaMask Connector",
-            url = "https://novastera.com"
-        )
-        // SDKOptions constructor requires infuraAPIKey and readonlyRPCMap parameters
-        // They can be null for basic usage without Infura or custom RPC
-        val sdkOptions = SDKOptions(
-            infuraAPIKey = null,
-            readonlyRPCMap = null
-        )
-        
-        Ethereum(context, dappMetadata, sdkOptions)
-    }
-
-    override fun connect(): Promise<ConnectResult> {
-        // Use Promise.async with coroutines for best practice in Nitro modules
-        // Reference: https://nitro.margelo.com/docs/types/promises
-        return Promise.async {
-            // Convert callback-based connect() to suspend function using suspendCancellableCoroutine
-            // This handles cancellation properly when JS GC disposes the promise
-            val result = suspendCancellableCoroutine<Result> { continuation ->
-                ethereum.connect { callbackResult ->
-                    if (continuation.isActive) {
-                        continuation.resume(callbackResult)
-                    }
-                }
-            }
-            
-            when (result) {
-                is Result.Success.Item -> {
-                    // After successful connection, get account info from SDK
-                    val address = ethereum.selectedAddress
-                        ?: throw IllegalStateException("MetaMask SDK returned no address after connection")
-                    val chainIdString = ethereum.chainId
-                        ?: throw IllegalStateException("MetaMask SDK returned no chainId after connection")
-                    
-                    // Parse chainId from hex string (e.g., "0x1") or decimal string to number
-                    // Nitro requires chainId to be Double (number in TS maps to Double in Kotlin)
-                    val chainId = try {
-                        val chainIdInt = if (chainIdString.startsWith("0x") || chainIdString.startsWith("0X")) {
-                            chainIdString.substring(2).toLong(16).toInt()
-                        } else {
-                            chainIdString.toLong().toInt()
-                        }
-                        chainIdInt.toDouble()
-                    } catch (e: NumberFormatException) {
-                        throw IllegalStateException("Invalid chainId format: $chainIdString")
-                    }
-                    
-                    ConnectResult(
-                        address = address,
-                        chainId = chainId
-                    )
-                }
-                is Result.Error -> {
-                    throw Exception(result.error.message ?: "Failed to connect to MetaMask")
-                }
-                else -> {
-                    throw IllegalStateException("Unexpected result type from MetaMask connect")
-                }
-            }
-        }
-    }
-
-    override fun signMessage(message: String): Promise<String> {
-        // Use Promise.async with coroutines for best practice in Nitro modules
-        // Reference: https://nitro.margelo.com/docs/types/promises
-        return Promise.async {
-            // Use direct signMessage() method (requires connection first via connect())
-            // This is more explicit and predictable than connectSign() which forces connection
-            // Based on SDK docs: ethereum.signMessage() requires address and message
-            val address = ethereum.selectedAddress
-                ?: throw IllegalStateException("No connected account. Call connect() first.")
-            
-            // Create EthereumRequest for personal_sign
-            val request = EthereumRequest(
-                method = EthereumMethod.PERSONAL_SIGN.value,
-                params = listOf(address, message)
-            )
-            
-            // Convert callback-based sendRequest() to suspend function
-            val result = suspendCancellableCoroutine<Result> { continuation ->
-                ethereum.sendRequest(request) { callbackResult ->
-                    if (continuation.isActive) {
-                        continuation.resume(callbackResult)
-                    }
-                }
-            }
-            
-            when (result) {
-                is Result.Success.Item -> {
-                    // Extract signature from result
-                    result.value as? String
-                        ?: throw IllegalStateException("Invalid signature response format")
-                }
-                is Result.Error -> {
-                    throw Exception(result.error.message ?: "Failed to sign message")
-                }
-                else -> {
-                    throw IllegalStateException("Unexpected result type from MetaMask signMessage")
-                }
-            }
-        }
-    }
-}
-

package/ios/HybridMetamaskConnector.swift

@@ -1,97 +0,0 @@
-import NitroModules
-import MetaMaskSDK
-import Foundation
-
-final class HybridMetamaskConnector: HybridMetamaskConnectorSpec {
-  private let sdk = MetaMaskSDK.shared
-
-  func connect() -> Promise<ConnectResult> {
-    // Use Promise.async with Swift async/await for best practice in Nitro modules
-    // Reference: https://nitro.margelo.com/docs/types/promises
-    return Promise.async {
-      // Based on MetaMask iOS SDK docs: let connectResult = await metamaskSDK.connect()
-      // Reference: https://github.com/MetaMask/metamask-ios-sdk
-      let connectResult = try await self.sdk.connect()
-      
-      switch connectResult {
-      case .success:
-        // After successful connection, get account info from SDK
-        // Note: sdk.account is a String (address), not an object
-        // Reference: https://raw.githubusercontent.com/MetaMask/metamask-ios-sdk/924d91bb3e98a5383c3082d6d5ba3ddac9e1c565/README.md
-        guard let address = self.sdk.account, !address.isEmpty else {
-          throw NSError(
-            domain: "MetamaskConnector",
-            code: -1,
-            userInfo: [NSLocalizedDescriptionKey: "MetaMask SDK returned no address after connection"]
-          )
-        }
-        
-        // Parse chainId from hex string (e.g., "0x1") to number
-        // Nitro requires chainId to be a number, not a string, for type safety
-        guard
-          let chainIdHex = self.sdk.chainId,
-          !chainIdHex.isEmpty,
-          let chainIdInt = Int(chainIdHex.replacingOccurrences(of: "0x", with: ""), radix: 16)
-        else {
-          throw NSError(
-            domain: "MetamaskConnector",
-            code: -1,
-            userInfo: [NSLocalizedDescriptionKey: "Invalid chainId format"]
-          )
-        }
-        
-        return ConnectResult(
-          address: address,
-          chainId: Double(chainIdInt)
-        )
-        
-      case .failure(let error):
-        throw error
-      }
-    }
-  }
-
-  func signMessage(message: String) -> Promise<String> {
-    // Use Promise.async with Swift async/await for best practice in Nitro modules
-    // Reference: https://nitro.margelo.com/docs/types/promises
-    return Promise.async {
-      // Use explicit sign() method (requires connection first via connect())
-      // This is more explicit and predictable than connectAndSign() which forces connection
-      // Nitro encourages explicit object state, not convenience shortcuts
-      guard let account = self.sdk.account, !account.isEmpty else {
-        throw NSError(
-          domain: "MetamaskConnector",
-          code: -1,
-          userInfo: [NSLocalizedDescriptionKey: "No connected account. Call connect() first."]
-        )
-      }
-      
-      // Create EthereumRequest for personal_sign
-      // Based on MetaMask iOS SDK docs: params are [account, message]
-      // Reference: https://raw.githubusercontent.com/MetaMask/metamask-ios-sdk/924d91bb3e98a5383c3082d6d5ba3ddac9e1c565/README.md
-      let params: [String] = [account, message]
-      let request = EthereumRequest(
-        method: .personalSign,
-        params: params
-      )
-      
-      // Make the request using the SDK's async request method
-      let result = try await self.sdk.request(request)
-      
-      // Extract signature from response
-      // The signature should be a hex-encoded string (0x-prefixed)
-      if let signature = result as? String {
-        return signature
-      } else if let dict = result as? [String: Any], let sig = dict["signature"] as? String ?? dict["result"] as? String {
-        return sig
-      } else {
-        throw NSError(
-          domain: "MetamaskConnector",
-          code: -1,
-          userInfo: [NSLocalizedDescriptionKey: "Invalid signature response format"]
-        )
-      }
-    }
-  }
-}
-

package/lib/MetamaskConnector.nitro.d.ts

@@ -1,12 +0,0 @@
-import type { HybridObject } from 'react-native-nitro-modules';
-export interface ConnectResult {
-    address: string;
-    chainId: number;
-}
-export interface MetamaskConnector extends HybridObject<{
-    ios: 'swift';
-    android: 'kotlin';
-}> {
-    connect(): Promise<ConnectResult>;
-    signMessage(message: string): Promise<string>;
-}

package/lib/MetamaskConnector.nitro.js

@@ -1 +0,0 @@
-export {};

package/lib/index.d.ts

@@ -1,3 +0,0 @@
-import type { ConnectResult, MetamaskConnector } from './MetamaskConnector.nitro';
-export declare const metamaskConnector: MetamaskConnector;
-export type { ConnectResult, MetamaskConnector };

package/lib/index.js

@@ -1,2 +0,0 @@
-import { NitroModules } from 'react-native-nitro-modules';
-export const metamaskConnector = NitroModules.createHybridObject('MetamaskConnector');

package/lib/specs/Example.nitro.js

@@ -1,2 +0,0 @@
-"use strict";
-// TODO: Export specs that extend HybridObject<...> here

package/nitrogen/generated/ios/swift/HybridMetamaskConnectorSpec.swift

@@ -1,57 +0,0 @@
-///
-/// HybridMetamaskConnectorSpec.swift
-/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
-/// https://github.com/mrousavy/nitro
-/// Copyright © 2026 Marc Rousavy @ Margelo
-///
-
-import Foundation
-import NitroModules
-
-/// See ``HybridMetamaskConnectorSpec``
-public protocol HybridMetamaskConnectorSpec_protocol: HybridObject {
-  // Properties
-  
-
-  // Methods
-  func connect() throws -> Promise<ConnectResult>
-  func signMessage(message: String) throws -> Promise<String>
-}
-
-public extension HybridMetamaskConnectorSpec_protocol {
-  /// Default implementation of ``HybridObject.toString``
-  func toString() -> String {
-    return "[HybridObject MetamaskConnector]"
-  }
-}
-
-/// See ``HybridMetamaskConnectorSpec``
-open class HybridMetamaskConnectorSpec_base {
-  private weak var cxxWrapper: HybridMetamaskConnectorSpec_cxx? = nil
-  public init() { }
-  public func getCxxWrapper() -> HybridMetamaskConnectorSpec_cxx {
-  #if DEBUG
-    guard self is HybridMetamaskConnectorSpec else {
-      fatalError("`self` is not a `HybridMetamaskConnectorSpec`! Did you accidentally inherit from `HybridMetamaskConnectorSpec_base` instead of `HybridMetamaskConnectorSpec`?")
-    }
-  #endif
-    if let cxxWrapper = self.cxxWrapper {
-      return cxxWrapper
-    } else {
-      let cxxWrapper = HybridMetamaskConnectorSpec_cxx(self as! HybridMetamaskConnectorSpec)
-      self.cxxWrapper = cxxWrapper
-      return cxxWrapper
-    }
-  }
-}
-
-/**
- * A Swift base-protocol representing the MetamaskConnector HybridObject.
- * Implement this protocol to create Swift-based instances of MetamaskConnector.
- * ```swift
- * class HybridMetamaskConnector : HybridMetamaskConnectorSpec {
- *   // ...
- * }
- * ```
- */
-public typealias HybridMetamaskConnectorSpec = HybridMetamaskConnectorSpec_protocol & HybridMetamaskConnectorSpec_base

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

@@ -1,22 +0,0 @@
-///
-/// HybridMetamaskConnectorSpec.cpp
-/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
-/// https://github.com/mrousavy/nitro
-/// Copyright © 2026 Marc Rousavy @ Margelo
-///
-
-#include "HybridMetamaskConnectorSpec.hpp"
-
-namespace margelo::nitro::nitrometamask {
-
-  void HybridMetamaskConnectorSpec::loadHybridMethods() {
-    // load base methods/properties
-    HybridObject::loadHybridMethods();
-    // load custom methods/properties
-    registerHybrids(this, [](Prototype& prototype) {
-      prototype.registerHybridMethod("connect", &HybridMetamaskConnectorSpec::connect);
-      prototype.registerHybridMethod("signMessage", &HybridMetamaskConnectorSpec::signMessage);
-    });
-  }
-
-} // namespace margelo::nitro::nitrometamask

package/src/MetamaskConnector.nitro.ts

@@ -1,13 +0,0 @@
-import type { HybridObject } from 'react-native-nitro-modules'
-
-export interface ConnectResult {
-  address: string
-  chainId: number
-}
-
-export interface MetamaskConnector
-  extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
-  connect(): Promise<ConnectResult>
-  signMessage(message: string): Promise<string>
-}
-

package/src/specs/Example.nitro.ts

@@ -1 +0,0 @@
-// TODO: Export specs that extend HybridObject<...> here