react-native-mfa-trustbuilder 0.1.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 skanderhk
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,202 @@
+# react-native-mfa-trustbuilder
+
+Trustbuilder MFA SDK for React Native. Provides multi-factor authentication capabilities including activation, OTP generation, biometric authentication, push notifications, and transaction sealing.
+
+## Installation
+
+```sh
+npm install react-native-mfa-trustbuilder
+```
+
+### iOS
+
+```sh
+cd ios && pod install
+```
+
+### Android
+
+No additional steps required.
+
+## Usage
+
+```ts
+import { trustbuilder, TrustbuilderError } from 'react-native-mfa-trustbuilder';
+
+// Initialize (call once at app startup)
+const result = trustbuilder.initialize({
+  macId: 'your_maccess_id',
+  server: 'https://www.myinwebo.com',
+  hostVersion: 'my-app-1.0.0',
+});
+
+// Restore saved state
+const storedData = trustbuilder.getStorageData();
+if (storedData) {
+  trustbuilder.setStorageData(storedData);
+}
+
+// Check activation status
+if (trustbuilder.isActivated()) {
+  // Generate online OTP
+  const { otp, remainingTime } = await trustbuilder.generateOnlineOtp('1234');
+}
+```
+
+## API Reference
+
+### Initialization
+
+#### `initialize(config: InitConfig): InitResult`
+
+Initialize the Trustbuilder SDK.
+
+```ts
+trustbuilder.initialize({
+  macId: 'your_maccess_id', // Required
+  server: 'https://www.myinwebo.com', // Default
+  hostVersion: 'my-app-1.0.0', // Default: 'react-native-mfa-trustbuilder-0.1.0'
+  timeout: 60000, // Default: 60000ms
+  lang: 'en', // 'en' | 'fr', Default: 'en'
+});
+```
+
+### Activation
+
+#### `activationStart(code: string): Promise<void>`
+
+Start the device activation process.
+
+#### `activationFinalize(code: string, pin: string, name: string): Promise<void>`
+
+Finalize device activation.
+
+#### `activate(code: string, pin: string, name: string): Promise<void>`
+
+Convenience method that calls both start and finalize.
+
+### Unlock / Reset
+
+#### `reset(code: string, pin: string): Promise<void>`
+
+Unlock a blocked device with an unlock code.
+
+### Synchronization
+
+#### `synchronize(pin: string): Promise<void>`
+
+Synchronize device state with Trustbuilder servers.
+
+### PIN Management
+
+#### `updatePin(newPin: string, currentPin: string): Promise<void>`
+
+Update the user's PIN code.
+
+### Biometrics
+
+#### `registerBiokey(biokey: string, pin: string): Promise<void>`
+
+Register a biometric key.
+
+#### `resetBiokeys(pin: string): Promise<void>`
+
+Reset all registered biometric keys.
+
+### OTP Generation
+
+#### `generateOnlineOtp(pin: string, serviceIndex?: number, keyType?: KeyType): Promise<OtpResult>`
+
+Generate an OTP via server call.
+
+#### `generateOfflineOtp(pin: string, serviceId?: number): Promise<OtpResult>`
+
+Generate an OTP locally without network.
+
+### Push Notifications
+
+#### `registerForPush(pushId: string): Promise<void>`
+
+Register device for push notifications.
+
+#### `getPushInfo(): PushInfo | null`
+
+Check for pending push notification.
+
+#### `onPushReceived(listener: (pushInfo: PushInfo) => void): () => void`
+
+Subscribe to push notification events.
+
+### Sealing
+
+#### `generateOnlineSeal(pin: string, sealData: string, serviceIndex?: number, keyType?: KeyType): Promise<SealResult>`
+
+Generate an online seal.
+
+#### `generateOfflineSeal(pin: string, sealData: string, serviceId?: number): Promise<SealResult>`
+
+Generate an offline seal.
+
+### Utility
+
+#### `isActivated(): boolean`
+
+Check if device is activated.
+
+#### `isBlocked(): boolean`
+
+Check if device is blocked.
+
+#### `getServiceInfo(index?: number): ServiceInfo`
+
+Get service information.
+
+#### `getVersionInfo(): VersionInfo`
+
+Get SDK version information.
+
+#### `saveStorageIfNeeded(): void`
+
+Save internal state if it has changed. Call after each operation.
+
+## Error Handling
+
+All methods throw `TrustbuilderError` on failure:
+
+```ts
+try {
+  await trustbuilder.generateOnlineOtp('1234');
+} catch (error) {
+  if (error instanceof TrustbuilderError) {
+    console.log(error.code); // Numeric error code
+    console.log(error.codeName); // e.g., 'NETWORK', 'CODE', 'ACCESS'
+    console.log(error.message); // Human-readable message
+  }
+}
+```
+
+### Error Codes
+
+| Code | Name           | Description                        |
+| ---- | -------------- | ---------------------------------- |
+| 0    | OK             | No error                           |
+| 1    | NETWORK        | Network or server unreachable      |
+| 2    | CODE           | Activation code is incorrect       |
+| 3    | SN             | Syntax error                       |
+| 4    | ACCESS         | Access refused                     |
+| 5    | VERSION        | Version error                      |
+| 7    | BLOCKED        | Account is blocked                 |
+| 14   | FORBIDDEN      | Forbidden operation                |
+| 15   | PINREFUSED     | Bad PIN format                     |
+| 16   | TIMEOUT        | Timeout expired                    |
+| 26   | BIOKEY         | Device locked due to biokey errors |
+| 27   | DESYNCHRONIZED | Device desynchronized              |
+| 999  | OTHER          | Unknown error                      |
+
+## Contributing
+
+See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
+
+## License
+
+MIT

package/Trustbuilder.podspec

@@ -0,0 +1,29 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "Trustbuilder"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => "13.4" }
+  s.source       = { :git => "https://github.com/skanderhk/react-native-mfa-trustbuilder.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
+  s.private_header_files = "ios/**/*.h"
+
+  s.vendored_libraries = "ios/libs/*.a"
+
+  s.preserve_paths = "ios/iw.h"
+
+  s.pod_target_xcconfig = {
+    "HEADER_SEARCH_PATHS" => '"$(PODS_TARGET_SRCROOT)/ios"',
+    "OTHER_LDFLAGS" => "-lsqlite3 -lz",
+  }
+
+  install_modules_dependencies(s)
+end

package/android/build.gradle

@@ -0,0 +1,74 @@
+buildscript {
+  ext.Trustbuilder = [
+    kotlinVersion: "2.0.21",
+    minSdkVersion: 24,
+    compileSdkVersion: 36,
+    targetSdkVersion: 36
+  ]
+
+  ext.getExtOrDefault = { prop ->
+    if (rootProject.ext.has(prop)) {
+      return rootProject.ext.get(prop)
+    }
+
+    return Trustbuilder[prop]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+android {
+  namespace "com.trustbuilder"
+
+  compileSdkVersion getExtOrDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrDefault("minSdkVersion")
+    targetSdkVersion getExtOrDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+    debug {
+      minifyEnabled false
+    }
+  }
+
+  lint {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation files('libs/iwlib-mac-0.2.17.jar')
+
+  implementation "androidx.security:security-crypto:1.1.0-alpha06"
+  implementation "androidx.preference:preference-ktx:1.2.1"
+}

package/android/proguard-rules.pro

@@ -0,0 +1,2 @@
+-keep class com.inwebo.iwlib.** { *; }
+-dontwarn com.inwebo.iwlib.**

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/trustbuilder/SimpleWebServiceCall.kt

@@ -0,0 +1,40 @@
+package com.trustbuilder
+
+import android.util.Log
+import com.inwebo.iwlib.WebServiceCall
+import java.io.BufferedReader
+import java.io.InputStreamReader
+import java.net.HttpURLConnection
+import java.net.URL
+
+class SimpleWebServiceCall : WebServiceCall {
+    companion object {
+        private const val TAG = "SimpleWebServiceCall"
+    }
+
+    override fun WebServiceCall(url: String?, timeout: Long): String? {
+        Log.d(TAG, "WebServiceCall: $url, timeout=$timeout")
+        return try {
+            val connection = URL(url).openConnection() as HttpURLConnection
+            connection.requestMethod = "GET"
+            connection.connectTimeout = timeout.toInt()
+            connection.readTimeout = timeout.toInt()
+            
+            val responseCode = connection.responseCode
+            Log.d(TAG, "Response code: $responseCode")
+            
+            if (responseCode == HttpURLConnection.HTTP_OK) {
+                val reader = BufferedReader(InputStreamReader(connection.inputStream))
+                val response = reader.use { it.readText() }
+                Log.d(TAG, "Response length: ${response.length}")
+                response
+            } else {
+                Log.e(TAG, "HTTP error: $responseCode")
+                ""
+            }
+        } catch (e: Exception) {
+            Log.e(TAG, "Network error: ${e.message}", e)
+            ""
+        }
+    }
+}