react-native-mfa-trustbuilder 0.1.0

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

@@ -0,0 +1,45 @@
+export type PinMode = 'none' | 'current' | 'new' | 'bio' | 'currentOrBio';
+export type PushAction = 'authenticate' | 'activate';
+export type KeyType = 'pin' | 'biokey';
+export interface InitConfig {
+    macId: string;
+    server?: string;
+    hostVersion?: string;
+    timeout?: number;
+    lang?: 'en' | 'fr';
+}
+export interface InitResult {
+    isActivated: boolean;
+    isBlocked: boolean;
+    error?: string;
+}
+export interface ServiceInfo {
+    name: string;
+    logoUrl: string;
+    isDisabled: boolean;
+}
+export interface PushInfo {
+    alias: string;
+    action: PushAction;
+    context: string;
+}
+export interface OtpResult {
+    otp: string;
+    remainingTime: number;
+}
+export interface SealResult {
+    seal: string;
+}
+export interface VersionInfo {
+    libraryVersion: string;
+    newVersionAvailable: string;
+    newVersionUrl: string;
+    majorVersionRequired: boolean;
+    shouldAskForMinorUpdate: boolean;
+}
+export interface PinModeResult {
+    pinMode: PinMode;
+    requiresPin: boolean;
+    requiresBio: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,cAAc,CAAC;AAE1E,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC;AAErD,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/package.json

@@ -0,0 +1,184 @@
+{
+  "name": "react-native-mfa-trustbuilder",
+  "version": "0.1.0",
+  "description": "Trustbuilder MFA SDK for React Native",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-mfa-trustbuilder-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version",
+    "web": "vite",
+    "build:web": "vite build"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "trustbuilder",
+    "mfa",
+    "inwebo",
+    "authentication",
+    "otp"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/skanderhk/react-native-mfa-trustbuilder.git"
+  },
+  "author": "skanderhk <skander.hkacem@gmail.com> (https://github.com/skanderhk)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/skanderhk/react-native-mfa-trustbuilder/issues"
+  },
+  "homepage": "https://github.com/skanderhk/react-native-mfa-trustbuilder#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^20.5.0",
+    "@eslint/compat": "^2.0.3",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "^10.0.1",
+    "@react-native/babel-preset": "0.73.21",
+    "@react-native/eslint-config": "0.85.0",
+    "@react-native/jest-preset": "0.85.0",
+    "@release-it/conventional-changelog": "^10.0.6",
+    "@types/jest": "^29.5.0",
+    "@types/react": "^18.2.6",
+    "commitlint": "^20.5.0",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-ft-flow": "^3.0.11",
+    "eslint-plugin-prettier": "^5.5.5",
+    "jest": "^29.7.0",
+    "lefthook": "^2.1.4",
+    "prettier": "^3.8.1",
+    "react": "18.2.0",
+    "react-native": "0.73.11",
+    "react-native-builder-bob": "^0.41.0",
+    "react-native-web": "~0.21.1",
+    "release-it": "^19.2.4",
+    "ts-jest": "^29.1.0",
+    "turbo": "^2.8.21",
+    "typescript": "^6.0.2"
+  },
+  "peerDependencies": {
+    "@react-native-firebase/app": ">=18.0.0",
+    "@react-native-firebase/messaging": ">=18.0.0",
+    "react": "*",
+    "react-native": "*"
+  },
+  "peerDependenciesMeta": {
+    "@react-native-firebase/app": {
+      "optional": true
+    },
+    "@react-native-firebase/messaging": {
+      "optional": true
+    }
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "RNTrustbuilderSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.trustbuilder"
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it",
+      "vite"
+    ],
+    "version": "0.62.0"
+  }
+}

package/src/NativeRNTrustbuilder.ts

@@ -0,0 +1,117 @@
+import { TurboModuleRegistry, type TurboModule } from 'react-native';
+
+export type PinMode = 'none' | 'current' | 'new' | 'bio' | 'currentOrBio';
+
+export type PushAction = 'authenticate' | 'activate';
+
+export interface InitConfig {
+  macId: string;
+  server?: string;
+  hostVersion?: string;
+  timeout?: number;
+  lang?: 'en' | 'fr';
+}
+
+export interface InitResult {
+  isActivated: boolean;
+  isBlocked: boolean;
+}
+
+export interface ServiceInfo {
+  name: string;
+  logoUrl: string;
+  isDisabled: boolean;
+}
+
+export interface PushInfo {
+  alias: string;
+  action: PushAction;
+  context: string;
+}
+
+export interface OtpResult {
+  otp: string;
+  remainingTime: number;
+}
+
+export interface SealResult {
+  seal: string;
+}
+
+export interface VersionInfo {
+  libraryVersion: string;
+  newVersionAvailable: string;
+  newVersionUrl: string;
+  majorVersionRequired: boolean;
+  shouldAskForMinorUpdate: boolean;
+}
+
+export interface Spec extends TurboModule {
+  addListener(eventName: string): void;
+  removeListeners(count: number): void;
+
+  initialize(config: string): string;
+  setStorageData(data: string): boolean;
+  getStorageData(): string;
+  storageDataChanged(): boolean;
+
+  isActivated(): boolean;
+  isBlocked(): boolean;
+  mustUpgrade(): boolean;
+
+  activationStart(code: string): string;
+  activationFinalize(code: string, pin: string, name: string): string;
+
+  resetStart(code: string): string;
+  resetFinalize(code: string, pin: string): string;
+
+  synchronizeStart(): string;
+  synchronizeFinalize(pin: string): string;
+
+  pwdUpdateStart(): string;
+  pwdUpdateFinalize(newPin: string, currentPin: string): string;
+
+  setBiokeyStart(): string;
+  setBiokeyFinalize(biokey: string, pin: string): string;
+
+  unsetBiokeysStart(): string;
+  unsetBiokeysFinalize(pin: string): string;
+
+  onlineOtpStart(serviceIndex: number): string;
+  onlineOtpFinalize(serviceIndex: number, pin: string, keyType: number): string;
+  otpAnswerOtp(): string;
+
+  otpShouldSynchronize(serviceId: number): boolean;
+  otpModeQuery(serviceId: number): boolean;
+  otpGenerate(pin: string): string;
+  displayTime(): number;
+
+  setDeviceOS(deviceOS: string): void;
+  pushRegistrationStart(): string;
+  pushRegistrationFinalize(pushId: string): string;
+  checkPush(): string;
+  pushAlias(): string;
+  pushAction(): string;
+  pushContext(): string;
+
+  onlineSealStart(serviceIndex: number): string;
+  onlineSealFinalize(
+    serviceIndex: number,
+    pin: string,
+    keyType: number,
+    sealData: string
+  ): string;
+  sealAnswerOtp(): string;
+  sealShouldSynchronize(serviceId: number): boolean;
+  sealModeQuery(serviceId: number): boolean;
+  sealGenerate(pin: string, sealData: string): string;
+
+  serviceNb(): number;
+  serviceName(index: number): string;
+  serviceLogo(index: number): string;
+  serviceDisabled(index: number): boolean;
+
+  getVersionInfo(): string;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('RNTrustbuilder');

package/src/errors.ts

@@ -0,0 +1,72 @@
+export enum TrustbuilderErrorCode {
+  OK = 0,
+  NETWORK = 1,
+  CODE = 2,
+  SN = 3,
+  ACCESS = 4,
+  VERSION = 5,
+  BLOCKED = 7,
+  STATE = 8,
+  NODEVICE = 9,
+  NOCA = 10,
+  NOSRV = 11,
+  PINREUSED = 12,
+  SYNCHROFAILED = 13,
+  FORBIDDEN = 14,
+  PINREFUSED = 15,
+  TIMEOUT = 16,
+  BIOKEY = 26,
+  DESYNCHRONIZED = 27,
+  OTHER = 999,
+}
+
+const ERROR_MESSAGES: Record<number, string> = {
+  [TrustbuilderErrorCode.OK]: 'No error',
+  [TrustbuilderErrorCode.NETWORK]: 'Network or server unreachable',
+  [TrustbuilderErrorCode.CODE]: 'The activation code is incorrect',
+  [TrustbuilderErrorCode.SN]: 'One argument does not have the right syntax',
+  [TrustbuilderErrorCode.ACCESS]: 'Access refused',
+  [TrustbuilderErrorCode.VERSION]:
+    'Version error, user must upgrade the device',
+  [TrustbuilderErrorCode.BLOCKED]: 'Account is blocked',
+  [TrustbuilderErrorCode.STATE]: 'Internal state not correct',
+  [TrustbuilderErrorCode.NODEVICE]: 'Device is disabled or unknown',
+  [TrustbuilderErrorCode.NOCA]:
+    'User must activate helium or Desktop Token before achieving this operation',
+  [TrustbuilderErrorCode.NOSRV]: 'No service is available',
+  [TrustbuilderErrorCode.PINREUSED]: 'The new password equals the previous one',
+  [TrustbuilderErrorCode.SYNCHROFAILED]:
+    'The operation succeeded but synchronization failed',
+  [TrustbuilderErrorCode.FORBIDDEN]:
+    'Forbidden operation (due to activated/blocked/upgradable state)',
+  [TrustbuilderErrorCode.PINREFUSED]: 'The password is refused (bad format)',
+  [TrustbuilderErrorCode.TIMEOUT]: 'Timeout expired',
+  [TrustbuilderErrorCode.BIOKEY]: 'Device is locked due to biokey errors',
+  [TrustbuilderErrorCode.DESYNCHRONIZED]: 'Device desynchronized',
+  [TrustbuilderErrorCode.OTHER]: 'Unknown error',
+};
+
+export class TrustbuilderError extends Error {
+  public readonly code: TrustbuilderErrorCode;
+  public readonly codeName: string;
+
+  constructor(code: number, message?: string) {
+    const errorCode = code as TrustbuilderErrorCode;
+    const defaultMessage =
+      ERROR_MESSAGES[errorCode] || `Unknown error code: ${code}`;
+    super(message || defaultMessage);
+    this.name = 'TrustbuilderError';
+    this.code = errorCode;
+    this.codeName = TrustbuilderErrorCode[errorCode] || 'UNKNOWN';
+  }
+}
+
+export function assertOk(resultCode: number): void {
+  if (resultCode !== TrustbuilderErrorCode.OK) {
+    throw new TrustbuilderError(resultCode);
+  }
+}
+
+export function parseResult(resultCode: number): void {
+  assertOk(resultCode);
+}