react-native-tediwave-biometric-verifier 0.1.3

package/LICENSE

@@ -0,0 +1,9 @@
+Proprietary Code License
+
+Copyright (c) 2026 Tediwave, all rights reserved
+
+This software and all associated documentation files, hereinafter referred to as the "Software", are the exclusive, proprietary intellectual property of Tediwave, meaning that no license, permission, or right of use is granted to any person, company, or third-party entity obtaining a copy of this material
+
+You are strictly prohibited from copying, modifying, merging, publishing, distributing, sublicensing, selling, or reverse-engineering any part of this software workspace, as all ownership, exploitation, and distribution privileges remain entirely, unconditionally reserved by the authors
+
+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, MEANING THAT IN NO EVENT SHALL THE AUTHORS, COPYRIGHT HOLDERS, OR NATIVE OWNERS 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 OF THIS REPOSITORY

package/README.md

@@ -0,0 +1,85 @@
+## Tediwave Biometric Verifier (Headless SDK)
+
+This SDK provides headless biometric verification capabilities for React Native apps. It focuses on processing, liveness and optional identity verification, and session management — without imposing any UI. Your application is responsible for rendering camera views, overlays, instructions, progress bars, and retry flows.
+
+Key responsibilities:
+
+- Camera processing (frame processor to wire into your camera)
+- Face detection and face quality metrics
+- Challenge generation and validation
+- Liveness verification
+- Optional identity verification (when a reference image is provided)
+- Anti-spoofing checks
+- Voice guidance (configurable)
+- Session management and result payloads
+
+Installation
+
+```sh
+npm install react-native-tediwave-biometric-verifier
+```
+
+Quick Start (headless)
+
+```tsx
+import React from 'react';
+import { Camera, useCameraDevice } from 'react-native-vision-camera';
+import {
+  BiometricCamera,
+  useBiometricEngine,
+} from 'react-native-tediwave-biometric-verifier';
+
+export default function MyVerifierScreen() {
+  const device = useCameraDevice('front');
+  const {
+    frameProcessor,
+    frameProcessorFps,
+    status,
+    verificationStatus,
+    currentChallenge,
+    progress,
+    startVerification,
+    pauseVerification,
+    resumeVerification,
+    finishVerification,
+    faceQuality,
+    completedChallenges,
+    totalChallenges,
+    setLiveImage,
+    onResult,
+  } = useBiometricEngine({ apiKey: 'MY_KEY', autoStart: false });
+
+  React.useEffect(() => {
+    startVerification();
+  }, [startVerification]);
+
+  return (
+    <BiometricCamera
+      device={device}
+      isActive
+      frameProcessor={frameProcessor}
+      frameProcessorFps={frameProcessorFps ?? 1}
+      style={{ flex: 1 }}
+    >
+      {/* Render your custom UI overlays here using the headless state above */}
+    </BiometricCamera>
+  );
+}
+```
+
+Primary exports
+
+- `useBiometricEngine(config)`: Headless hook returning state, control methods, frameProcessor and results.
+- `BiometricCamera`: Lightweight camera wrapper that forwards props to `react-native-vision-camera` and accepts a `frameProcessor`.
+
+Documentation
+
+- See the `example/` folder for full integration examples demonstrating custom UIs, retries and identity mode.
+
+Migration notes
+
+- The SDK removed built-in UI components. Move any in-app UI into your application and consume the headless hook and camera component to drive UI state.
+
+License
+
+MIT

package/TediwaveBiometricVerifier.podspec

@@ -0,0 +1,20 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "TediwaveBiometricVerifier"
+  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 }
+  s.source       = { :git => "https://github.com/Tediwave/tediwave-biometric-verifier.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
+  s.private_header_files = "ios/**/*.h"
+
+  install_modules_dependencies(s)
+end

package/android/build.gradle

@@ -0,0 +1,67 @@
+buildscript {
+  ext.TediwaveBiometricVerifier = [
+    kotlinVersion: "2.0.21",
+    minSdkVersion: 24,
+    compileSdkVersion: 36,
+    targetSdkVersion: 36
+  ]
+
+  ext.getExtOrDefault = { prop ->
+    if (rootProject.ext.has(prop)) {
+      return rootProject.ext.get(prop)
+    }
+
+    return TediwaveBiometricVerifier[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.tediwavebiometricverifier"
+
+  compileSdkVersion getExtOrDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrDefault("minSdkVersion")
+    targetSdkVersion getExtOrDefault("targetSdkVersion")
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lint {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+}

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/tediwavebiometricverifier/TediwaveBiometricVerifierModule.kt

@@ -0,0 +1,15 @@
+package com.tediwavebiometricverifier
+
+import com.facebook.react.bridge.ReactApplicationContext
+
+class TediwaveBiometricVerifierModule(reactContext: ReactApplicationContext) :
+  NativeTediwaveBiometricVerifierSpec(reactContext) {
+
+  override fun multiply(a: Double, b: Double): Double {
+    return a * b
+  }
+
+  companion object {
+    const val NAME = NativeTediwaveBiometricVerifierSpec.NAME
+  }
+}

package/android/src/main/java/com/tediwavebiometricverifier/TediwaveBiometricVerifierPackage.kt

@@ -0,0 +1,31 @@
+package com.tediwavebiometricverifier
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import java.util.HashMap
+
+class TediwaveBiometricVerifierPackage : BaseReactPackage() {
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+    return if (name == TediwaveBiometricVerifierModule.NAME) {
+      TediwaveBiometricVerifierModule(reactContext)
+    } else {
+      null
+    }
+  }
+
+  override fun getReactModuleInfoProvider() = ReactModuleInfoProvider {
+    mapOf(
+      TediwaveBiometricVerifierModule.NAME to ReactModuleInfo(
+        name = TediwaveBiometricVerifierModule.NAME,
+        className = TediwaveBiometricVerifierModule.NAME,
+        canOverrideExistingModule = false,
+        needsEagerInit = false,
+        isCxxModule = false,
+        isTurboModule = true
+      )
+    )
+  }
+}

package/ios/TediwaveBiometricVerifier.h

@@ -0,0 +1,5 @@
+#import <TediwaveBiometricVerifierSpec/TediwaveBiometricVerifierSpec.h>
+
+@interface TediwaveBiometricVerifier : NSObject <NativeTediwaveBiometricVerifierSpec>
+
+@end

package/ios/TediwaveBiometricVerifier.mm

@@ -0,0 +1,21 @@
+#import "TediwaveBiometricVerifier.h"
+
+@implementation TediwaveBiometricVerifier
+- (NSNumber *)multiply:(double)a b:(double)b {
+    NSNumber *result = @(a * b);
+
+    return result;
+}
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+    return std::make_shared<facebook::react::NativeTediwaveBiometricVerifierSpecJSI>(params);
+}
+
++ (NSString *)moduleName
+{
+  return @"TediwaveBiometricVerifier";
+}
+
+@end

package/lib/module/BiometricCamera.js

@@ -0,0 +1,30 @@
+"use strict";
+
+import React from 'react';
+import { View } from 'react-native';
+import { Camera } from 'react-native-vision-camera';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function BiometricCamera({
+  style,
+  isActive = true,
+  frameProcessor,
+  frameProcessorFps = 1,
+  children,
+  ...cameraProps
+}) {
+  const CameraAny = Camera;
+  return /*#__PURE__*/_jsxs(View, {
+    style: style,
+    children: [/*#__PURE__*/_jsx(CameraAny, {
+      ...cameraProps,
+      isActive: isActive,
+      frameProcessor: frameProcessor,
+      frameProcessorFps: frameProcessorFps,
+      style: {
+        flex: 1
+      }
+    }), children]
+  });
+}
+export default BiometricCamera;
+//# sourceMappingURL=BiometricCamera.js.map

package/lib/module/BiometricCamera.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","View","Camera","jsx","_jsx","jsxs","_jsxs","BiometricCamera","style","isActive","frameProcessor","frameProcessorFps","children","cameraProps","CameraAny","flex"],"sourceRoot":"..\\..\\src","sources":["BiometricCamera.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,IAAI,QAAQ,cAAc;AAEnC,SAASC,MAAM,QAAQ,4BAA4B;AAAC,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAYpD,OAAO,SAASC,eAAeA,CAAC;EAC9BC,KAAK;EACLC,QAAQ,GAAG,IAAI;EACfC,cAAc;EACdC,iBAAiB,GAAG,CAAC;EACrBC,QAAQ;EACR,GAAGC;AACiB,CAAC,EAAE;EACvB,MAAMC,SAAc,GAAGZ,MAAM;EAC7B,oBACEI,KAAA,CAACL,IAAI;IAACO,KAAK,EAAEA,KAAM;IAAAI,QAAA,gBACjBR,IAAA,CAACU,SAAS;MAAA,GACJD,WAAW;MACfJ,QAAQ,EAAEA,QAAS;MACnBC,cAAc,EAAEA,cAAe;MAC/BC,iBAAiB,EAAEA,iBAAkB;MACrCH,KAAK,EAAE;QAAEO,IAAI,EAAE;MAAE;IAAE,CACpB,CAAC,EACDH,QAAQ;EAAA,CACL,CAAC;AAEX;AAEA,eAAeL,eAAe","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,6 @@
+"use strict";
+
+import { useBiometricEngine } from "./useBiometricEngine.js";
+import { BiometricCamera } from "./BiometricCamera.js";
+export { useBiometricEngine, BiometricCamera };
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useBiometricEngine","BiometricCamera"],"sourceRoot":"..\\..\\src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,yBAAyB;AAC5D,SAASC,eAAe,QAAQ,sBAAuB;AAEvD,SAASD,kBAAkB,EAAEC,eAAe","ignoreList":[]}

package/lib/module/logger.js

@@ -0,0 +1,38 @@
+"use strict";
+
+const LEVEL_ORDER = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3
+};
+
+// Use globalThis to avoid depending on Node's `process` type in the build
+let CURRENT_LEVEL = globalThis.process?.env?.LOG_LEVEL || 'debug';
+function shouldLog(level) {
+  return LEVEL_ORDER[level] >= LEVEL_ORDER[CURRENT_LEVEL] || CURRENT_LEVEL === 'debug';
+}
+function formatMessage(level, tag, message) {
+  const ts = new Date().toISOString();
+  const payload = typeof message === 'string' ? message : JSON.stringify(message);
+  return `[${ts}] [${level.toUpperCase()}] [${tag}] ${payload}`;
+}
+export const logger = {
+  setLevel(l) {
+    CURRENT_LEVEL = l;
+  },
+  debug(tag, msg) {
+    if (shouldLog('debug')) console.debug(formatMessage('debug', tag, msg));
+  },
+  info(tag, msg) {
+    if (shouldLog('info')) console.info(formatMessage('info', tag, msg));
+  },
+  warn(tag, msg) {
+    if (shouldLog('warn')) console.warn(formatMessage('warn', tag, msg));
+  },
+  error(tag, msg) {
+    if (shouldLog('error')) console.error(formatMessage('error', tag, msg));
+  }
+};
+export default logger;
+//# sourceMappingURL=logger.js.map

package/lib/module/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["LEVEL_ORDER","debug","info","warn","error","CURRENT_LEVEL","globalThis","process","env","LOG_LEVEL","shouldLog","level","formatMessage","tag","message","ts","Date","toISOString","payload","JSON","stringify","toUpperCase","logger","setLevel","l","msg","console"],"sourceRoot":"..\\..\\src","sources":["logger.ts"],"mappings":";;AAEA,MAAMA,WAAqC,GAAG;EAC5CC,KAAK,EAAE,CAAC;EACRC,IAAI,EAAE,CAAC;EACPC,IAAI,EAAE,CAAC;EACPC,KAAK,EAAE;AACT,CAAC;;AAED;AACA,IAAIC,aAAuB,GACvBC,UAAU,CAASC,OAAO,EAAEC,GAAG,EAAEC,SAAS,IAAiB,OAAO;AAEtE,SAASC,SAASA,CAACC,KAAe,EAAE;EAClC,OACEX,WAAW,CAACW,KAAK,CAAC,IAAIX,WAAW,CAACK,aAAa,CAAC,IAChDA,aAAa,KAAK,OAAO;AAE7B;AAEA,SAASO,aAAaA,CAACD,KAAe,EAAEE,GAAW,EAAEC,OAAgB,EAAE;EACrE,MAAMC,EAAE,GAAG,IAAIC,IAAI,CAAC,CAAC,CAACC,WAAW,CAAC,CAAC;EACnC,MAAMC,OAAO,GACX,OAAOJ,OAAO,KAAK,QAAQ,GAAGA,OAAO,GAAGK,IAAI,CAACC,SAAS,CAACN,OAAO,CAAC;EACjE,OAAO,IAAIC,EAAE,MAAMJ,KAAK,CAACU,WAAW,CAAC,CAAC,MAAMR,GAAG,KAAKK,OAAO,EAAE;AAC/D;AAEA,OAAO,MAAMI,MAAM,GAAG;EACpBC,QAAQA,CAACC,CAAW,EAAE;IACpBnB,aAAa,GAAGmB,CAAC;EACnB,CAAC;EACDvB,KAAKA,CAACY,GAAW,EAAEY,GAAY,EAAE;IAC/B,IAAIf,SAAS,CAAC,OAAO,CAAC,EAAEgB,OAAO,CAACzB,KAAK,CAACW,aAAa,CAAC,OAAO,EAAEC,GAAG,EAAEY,GAAG,CAAC,CAAC;EACzE,CAAC;EACDvB,IAAIA,CAACW,GAAW,EAAEY,GAAY,EAAE;IAC9B,IAAIf,SAAS,CAAC,MAAM,CAAC,EAAEgB,OAAO,CAACxB,IAAI,CAACU,aAAa,CAAC,MAAM,EAAEC,GAAG,EAAEY,GAAG,CAAC,CAAC;EACtE,CAAC;EACDtB,IAAIA,CAACU,GAAW,EAAEY,GAAY,EAAE;IAC9B,IAAIf,SAAS,CAAC,MAAM,CAAC,EAAEgB,OAAO,CAACvB,IAAI,CAACS,aAAa,CAAC,MAAM,EAAEC,GAAG,EAAEY,GAAG,CAAC,CAAC;EACtE,CAAC;EACDrB,KAAKA,CAACS,GAAW,EAAEY,GAAY,EAAE;IAC/B,IAAIf,SAAS,CAAC,OAAO,CAAC,EAAEgB,OAAO,CAACtB,KAAK,CAACQ,aAAa,CAAC,OAAO,EAAEC,GAAG,EAAEY,GAAG,CAAC,CAAC;EACzE;AACF,CAAC;AAED,eAAeH,MAAM","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}