@jupitermetalabs/face-zk-sdk 0.3.4 → 0.3.7

package/dist/react-native/hooks/useWasmLoader.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Copyright 2026 JupiterMeta Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Hook for loading Plonky3 WASM resources
+ *
+ * Loads the WASM binary and worker HTML, converts them to base64
+ * for injection into WebView. Plonky3 STARKs don't require proving keys.
+ */
+export declare function useWasmLoader(): {
+    isLoading: boolean;
+    error: string | null;
+    isReady: boolean;
+    wasmData: {
+        wasmBase64: string;
+        workerHtml: string;
+    } | null;
+};

package/dist/react-native/hooks/useWasmLoader.js

@@ -0,0 +1,158 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useWasmLoader = useWasmLoader;
+const expo_asset_1 = require("expo-asset");
+const FileSystem = __importStar(require("expo-file-system/legacy"));
+const react_1 = require("react");
+const FaceZkSdk_1 = require("../../FaceZkSdk");
+const resolveModelUri_1 = require("../utils/resolveModelUri");
+/**
+ * Copyright 2026 JupiterMeta Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Hook for loading Plonky3 WASM resources
+ *
+ * Loads the WASM binary and worker HTML, converts them to base64
+ * for injection into WebView. Plonky3 STARKs don't require proving keys.
+ */
+function useWasmLoader() {
+    const [isLoading, setIsLoading] = (0, react_1.useState)(false);
+    const [error, setError] = (0, react_1.useState)(null);
+    const [isReady, setIsReady] = (0, react_1.useState)(false);
+    const [wasmData, setWasmData] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        let mounted = true;
+        async function loadWasmResources() {
+            try {
+                setIsLoading(true);
+                setError(null);
+                console.log('[useWasmLoader] Starting Plonky3 WASM load...');
+                let wasmLocalUri;
+                let workerLocalUri;
+                if (FaceZkSdk_1.FaceZkSdk.isInitialized()) {
+                    // ── SDK-configured WASM sources ────────────────────────
+                    const sdkConfig = FaceZkSdk_1.FaceZkSdk.getConfig();
+                    if (sdkConfig.models.wasm) {
+                        wasmLocalUri = await (0, resolveModelUri_1.resolveModelUri)(sdkConfig.models.wasm, undefined, sdkConfig.allowedDomains);
+                    }
+                    else {
+                        // No wasm override – use bundled fallback
+                        const wasmAsset = expo_asset_1.Asset.fromModule(require('../../assets/wasm/zk_face_wasm_bg.wasm'));
+                        await wasmAsset.downloadAsync();
+                        if (!wasmAsset.localUri)
+                            throw new Error('Failed to download bundled WASM asset');
+                        wasmLocalUri = wasmAsset.localUri;
+                    }
+                    if (sdkConfig.models.zkWorkerHtml) {
+                        workerLocalUri = await (0, resolveModelUri_1.resolveModelUri)(sdkConfig.models.zkWorkerHtml, undefined, sdkConfig.allowedDomains);
+                    }
+                    else {
+                        const workerAsset = expo_asset_1.Asset.fromModule(require('../../assets/zk-worker.html'));
+                        await workerAsset.downloadAsync();
+                        if (!workerAsset.localUri)
+                            throw new Error('Failed to download bundled worker HTML asset');
+                        workerLocalUri = workerAsset.localUri;
+                    }
+                }
+                else {
+                    // ── Bundled fallback (in-repo / monorepo usage) ────────
+                    const wasmAsset = expo_asset_1.Asset.fromModule(require('../../assets/wasm/zk_face_wasm_bg.wasm'));
+                    await wasmAsset.downloadAsync();
+                    console.log('[useWasmLoader] WASM asset downloaded:', wasmAsset.localUri);
+                    const workerAsset = expo_asset_1.Asset.fromModule(require('../../assets/zk-worker.html'));
+                    await workerAsset.downloadAsync();
+                    console.log('[useWasmLoader] Worker HTML downloaded:', workerAsset.localUri);
+                    if (!wasmAsset.localUri || !workerAsset.localUri) {
+                        throw new Error('Failed to download WASM assets');
+                    }
+                    wasmLocalUri = wasmAsset.localUri;
+                    workerLocalUri = workerAsset.localUri;
+                }
+                // Read WASM as base64 and clean it
+                let wasmBase64 = await FileSystem.readAsStringAsync(wasmLocalUri, {
+                    encoding: 'base64'
+                });
+                // Remove any whitespace/newlines that might cause atob failure
+                wasmBase64 = wasmBase64.replace(/\s/g, '');
+                console.log('[useWasmLoader] WASM base64 size:', wasmBase64.length);
+                // Read worker HTML
+                const workerHtml = await FileSystem.readAsStringAsync(workerLocalUri, {
+                    encoding: 'utf8'
+                });
+                console.log('[useWasmLoader] Worker HTML size:', workerHtml.length);
+                if (mounted) {
+                    setWasmData({
+                        wasmBase64,
+                        workerHtml
+                    });
+                    setIsReady(true);
+                    setIsLoading(false);
+                    console.log('[useWasmLoader] ✅ Plonky3 WASM ready');
+                }
+            }
+            catch (err) {
+                console.error('[useWasmLoader] Error loading WASM:', err);
+                if (mounted) {
+                    setError(err.message || 'Failed to load WASM resources');
+                    setIsLoading(false);
+                    setIsReady(false);
+                }
+            }
+        }
+        loadWasmResources();
+        return () => {
+            mounted = false;
+        };
+    }, []);
+    return {
+        isLoading,
+        error,
+        isReady,
+        wasmData
+    };
+}

package/dist/react-native/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Copyright 2026 JupiterMeta Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type SdkDependencies } from "./dependencies";
+import type { FaceZkConfig } from "../config/types";
+export { clearModelCache, resolveModelUri } from "./utils/resolveModelUri";
+export { modelInitialisationChecks, type ModelReadinessResult, type ModelKey, } from "./utils/modelInitialisationChecks";
+/**
+ * Bootstraps the Face+ZK SDK and prepares local dependency injection within a React Native application.
+ *
+ * You must call this function at the very root of your application lifecycle (e.g., in `App.tsx` or `index.js`) before attempting to mount any SDK UI flows or headless hooks.
+ *
+ * **Initialization Context:** Unlike non-React contexts, React Native needs explicit dependency injection to handle native File System access and WebView bridging. This unified setup replaces the deprecated two-step initialization process and registers the `defaultSdkDependencies` globally.
+ *
+ * @param {FaceZkConfig} config - The global SDK configuration, including model CDN URLs and threshold limits.
+ * @param {SdkDependencies} [deps] - Optional override to inject custom Platform Adapters (e.g., custom WebViews for debugging).
+ * @returns {Promise<void>} Resolves when the core singleton is ready.
+ *
+ * @example
+ * await initializeSdk({
+ *   models: { cdnBaseUrl: 'https://cdn.mycompany.com/zk' }
+ * });
+ */
+export declare function initializeSdk(config: FaceZkConfig, deps?: SdkDependencies): Promise<void>;
+/**
+ * Reset the SDK and clear any cached model files.
+ * Use this instead of `FaceZkSdk.reset()` in React Native apps.
+ */
+export declare function resetSdk(): Promise<void>;
+export type { FaceZkConfig, FaceZkModelsConfig, FaceZkFeaturesConfig, FaceZkSetupConfig, ModelSource, } from "../config/types";
+export type { FaceZkTheme, FaceZkStrings, } from "../core/types";
+export type { FloatVector, Pose, LivenessCheckId, ReferenceId, ReferenceTemplate, ReferenceTemplateInput, LiveImageInfo, LiveCaptureResult, LivenessCheckResult, LivenessResult, FaceMatchResult, ZkProofSummary, SdkErrorCode, SdkError, VerificationOutcome, LivenessConfig, ZkProofEngine, ZkConfig, StorageAdapter, ReferenceStorageRecord, ProofStorageRecord, SdkLogger, FaceZkRuntimeConfig, VerificationOptions, EnrollmentOptions, ZkProofOptions, VerificationStage, UiConfig, } from "../core/types";
+export { l2SquaredDistance, l2SquaredToPercentage, computeFaceMatchResult, } from "../core/matching";
+export type { LivenessProvider, ImageDataProvider, } from "../core/verification-core";
+export type { FaceEmbeddingProvider } from "../core/enrollment-core";
+export { initializeSdkDependencies, getSdkDependencies, areSdkDependenciesInitialized, clearSdkDependencies, type SdkDependencies, } from "./dependencies";
+export { ReferenceEnrollmentFlow, type ReferenceEnrollmentFlowProps, } from "./ui/ReferenceEnrollmentFlow";
+export { FaceZkVerificationFlow, type FaceZkVerificationFlowProps, } from "./ui/FaceZkVerificationFlow";
+export { OnnxRuntimeWebView, OnnxRuntimeBridge, } from "./components/OnnxRuntimeWebView";
+export { faceRecognitionService } from "./services/FaceRecognition";
+export { createFaceEmbeddingProvider, defaultFaceEmbeddingProvider, } from "./adapters/faceEmbeddingProvider";
+export { createLivenessResultFromWebView, createWebViewLivenessProvider, createLivenessProvider, createZkFaceAuthLivenessProvider, type LivenessProviderConfig, type ZkFaceAuthLivenessService, } from "./adapters/livenessProvider";
+export { createDefaultImageDataProvider, defaultImageDataProvider, } from "./adapters/imageDataProvider";
+export { createZkProofEngineWebView, initializeZkProofEngine, isZkProofBridgeReady, getZkProofBridgeStatusMessage, } from "./adapters/zkProofEngine-webview";
+export { createDefaultStorageAdapter, defaultStorageAdapter, getAllReferenceIds, getAllProofIds, clearAllStorage, } from "../storage/defaultStorageAdapter";
+export { createReferenceFromImage, } from "../core/enrollment-core";
+export { verifyOnly, verifyWithProof, type VerifyCallOptions, } from "../core/verification-core";
+export { generateZkProofOnly, generateAndPersistZkProof, } from "../core/zk-core";
+export { getDefaultSdkDependencies } from "./dependencies";

package/dist/react-native/index.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * Copyright 2026 JupiterMeta Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultSdkDependencies = exports.generateAndPersistZkProof = exports.generateZkProofOnly = exports.verifyWithProof = exports.verifyOnly = exports.createReferenceFromImage = exports.clearAllStorage = exports.getAllProofIds = exports.getAllReferenceIds = exports.defaultStorageAdapter = exports.createDefaultStorageAdapter = exports.getZkProofBridgeStatusMessage = exports.isZkProofBridgeReady = exports.initializeZkProofEngine = exports.createZkProofEngineWebView = exports.defaultImageDataProvider = exports.createDefaultImageDataProvider = exports.createZkFaceAuthLivenessProvider = exports.createLivenessProvider = exports.createWebViewLivenessProvider = exports.createLivenessResultFromWebView = exports.defaultFaceEmbeddingProvider = exports.createFaceEmbeddingProvider = exports.faceRecognitionService = exports.OnnxRuntimeBridge = exports.OnnxRuntimeWebView = exports.FaceZkVerificationFlow = exports.ReferenceEnrollmentFlow = exports.clearSdkDependencies = exports.areSdkDependenciesInitialized = exports.getSdkDependencies = exports.initializeSdkDependencies = exports.computeFaceMatchResult = exports.l2SquaredToPercentage = exports.l2SquaredDistance = exports.modelInitialisationChecks = exports.resolveModelUri = exports.clearModelCache = void 0;
+exports.initializeSdk = initializeSdk;
+exports.resetSdk = resetSdk;
+/**
+ * Face+ZK SDK – React Native Exports
+ *
+ * Entry point for React Native-specific components and adapters.
+ * Includes UI flows and platform-specific implementations.
+ *
+ * For core (headless) functionality, import from '@jupitermetalabs/face-zk-sdk'
+ */
+// ============================================================================
+// SDK Initialization (re-exported for convenience)
+// ============================================================================
+const FaceZkSdk_1 = require("../FaceZkSdk");
+const resolveModelUri_1 = require("./utils/resolveModelUri");
+const dependencies_1 = require("./dependencies");
+// FaceZkSdk class is intentionally NOT re-exported here.
+// React Native apps should use initializeSdk() and resetSdk() below,
+// which wire up RN-specific dependencies (file system, model cache) before
+// calling FaceZkSdk.init(). Bypassing that step causes model loading to fail.
+var resolveModelUri_2 = require("./utils/resolveModelUri");
+Object.defineProperty(exports, "clearModelCache", { enumerable: true, get: function () { return resolveModelUri_2.clearModelCache; } });
+Object.defineProperty(exports, "resolveModelUri", { enumerable: true, get: function () { return resolveModelUri_2.resolveModelUri; } });
+var modelInitialisationChecks_1 = require("./utils/modelInitialisationChecks");
+Object.defineProperty(exports, "modelInitialisationChecks", { enumerable: true, get: function () { return modelInitialisationChecks_1.modelInitialisationChecks; } });
+/**
+ * Bootstraps the Face+ZK SDK and prepares local dependency injection within a React Native application.
+ *
+ * You must call this function at the very root of your application lifecycle (e.g., in `App.tsx` or `index.js`) before attempting to mount any SDK UI flows or headless hooks.
+ *
+ * **Initialization Context:** Unlike non-React contexts, React Native needs explicit dependency injection to handle native File System access and WebView bridging. This unified setup replaces the deprecated two-step initialization process and registers the `defaultSdkDependencies` globally.
+ *
+ * @param {FaceZkConfig} config - The global SDK configuration, including model CDN URLs and threshold limits.
+ * @param {SdkDependencies} [deps] - Optional override to inject custom Platform Adapters (e.g., custom WebViews for debugging).
+ * @returns {Promise<void>} Resolves when the core singleton is ready.
+ *
+ * @example
+ * await initializeSdk({
+ *   models: { cdnBaseUrl: 'https://cdn.mycompany.com/zk' }
+ * });
+ */
+async function initializeSdk(config, deps = (0, dependencies_1.getDefaultSdkDependencies)()) {
+    (0, dependencies_1.initializeSdkDependencies)(deps);
+    await FaceZkSdk_1.FaceZkSdk.init(config);
+}
+/**
+ * Reset the SDK and clear any cached model files.
+ * Use this instead of `FaceZkSdk.reset()` in React Native apps.
+ */
+async function resetSdk() {
+    FaceZkSdk_1.FaceZkSdk.reset();
+    await (0, resolveModelUri_1.clearModelCache)();
+}
+var matching_1 = require("../core/matching");
+Object.defineProperty(exports, "l2SquaredDistance", { enumerable: true, get: function () { return matching_1.l2SquaredDistance; } });
+Object.defineProperty(exports, "l2SquaredToPercentage", { enumerable: true, get: function () { return matching_1.l2SquaredToPercentage; } });
+Object.defineProperty(exports, "computeFaceMatchResult", { enumerable: true, get: function () { return matching_1.computeFaceMatchResult; } });
+// ============================================================================
+// Dependency Injection
+// ============================================================================
+var dependencies_2 = require("./dependencies");
+Object.defineProperty(exports, "initializeSdkDependencies", { enumerable: true, get: function () { return dependencies_2.initializeSdkDependencies; } });
+Object.defineProperty(exports, "getSdkDependencies", { enumerable: true, get: function () { return dependencies_2.getSdkDependencies; } });
+Object.defineProperty(exports, "areSdkDependenciesInitialized", { enumerable: true, get: function () { return dependencies_2.areSdkDependenciesInitialized; } });
+Object.defineProperty(exports, "clearSdkDependencies", { enumerable: true, get: function () { return dependencies_2.clearSdkDependencies; } });
+// ============================================================================
+// React Native UI Flows
+// ============================================================================
+var ReferenceEnrollmentFlow_1 = require("./ui/ReferenceEnrollmentFlow");
+Object.defineProperty(exports, "ReferenceEnrollmentFlow", { enumerable: true, get: function () { return ReferenceEnrollmentFlow_1.ReferenceEnrollmentFlow; } });
+var FaceZkVerificationFlow_1 = require("./ui/FaceZkVerificationFlow");
+Object.defineProperty(exports, "FaceZkVerificationFlow", { enumerable: true, get: function () { return FaceZkVerificationFlow_1.FaceZkVerificationFlow; } });
+// ============================================================================
+// React Native Components (default implementations)
+// ============================================================================
+var OnnxRuntimeWebView_1 = require("./components/OnnxRuntimeWebView");
+Object.defineProperty(exports, "OnnxRuntimeWebView", { enumerable: true, get: function () { return OnnxRuntimeWebView_1.OnnxRuntimeWebView; } });
+Object.defineProperty(exports, "OnnxRuntimeBridge", { enumerable: true, get: function () { return OnnxRuntimeWebView_1.OnnxRuntimeBridge; } });
+var FaceRecognition_1 = require("./services/FaceRecognition");
+Object.defineProperty(exports, "faceRecognitionService", { enumerable: true, get: function () { return FaceRecognition_1.faceRecognitionService; } });
+// ============================================================================
+// React Native Adapters
+// ============================================================================
+// Face Embedding
+var faceEmbeddingProvider_1 = require("./adapters/faceEmbeddingProvider");
+Object.defineProperty(exports, "createFaceEmbeddingProvider", { enumerable: true, get: function () { return faceEmbeddingProvider_1.createFaceEmbeddingProvider; } });
+Object.defineProperty(exports, "defaultFaceEmbeddingProvider", { enumerable: true, get: function () { return faceEmbeddingProvider_1.defaultFaceEmbeddingProvider; } });
+// Liveness
+var livenessProvider_1 = require("./adapters/livenessProvider");
+Object.defineProperty(exports, "createLivenessResultFromWebView", { enumerable: true, get: function () { return livenessProvider_1.createLivenessResultFromWebView; } });
+Object.defineProperty(exports, "createWebViewLivenessProvider", { enumerable: true, get: function () { return livenessProvider_1.createWebViewLivenessProvider; } });
+Object.defineProperty(exports, "createLivenessProvider", { enumerable: true, get: function () { return livenessProvider_1.createLivenessProvider; } });
+Object.defineProperty(exports, "createZkFaceAuthLivenessProvider", { enumerable: true, get: function () { return livenessProvider_1.createZkFaceAuthLivenessProvider; } });
+// Image Data
+var imageDataProvider_1 = require("./adapters/imageDataProvider");
+Object.defineProperty(exports, "createDefaultImageDataProvider", { enumerable: true, get: function () { return imageDataProvider_1.createDefaultImageDataProvider; } });
+Object.defineProperty(exports, "defaultImageDataProvider", { enumerable: true, get: function () { return imageDataProvider_1.defaultImageDataProvider; } });
+// ZK Proof Engine
+var zkProofEngine_webview_1 = require("./adapters/zkProofEngine-webview");
+Object.defineProperty(exports, "createZkProofEngineWebView", { enumerable: true, get: function () { return zkProofEngine_webview_1.createZkProofEngineWebView; } });
+Object.defineProperty(exports, "initializeZkProofEngine", { enumerable: true, get: function () { return zkProofEngine_webview_1.initializeZkProofEngine; } });
+Object.defineProperty(exports, "isZkProofBridgeReady", { enumerable: true, get: function () { return zkProofEngine_webview_1.isZkProofBridgeReady; } });
+Object.defineProperty(exports, "getZkProofBridgeStatusMessage", { enumerable: true, get: function () { return zkProofEngine_webview_1.getZkProofBridgeStatusMessage; } });
+// Storage
+var defaultStorageAdapter_1 = require("../storage/defaultStorageAdapter");
+Object.defineProperty(exports, "createDefaultStorageAdapter", { enumerable: true, get: function () { return defaultStorageAdapter_1.createDefaultStorageAdapter; } });
+Object.defineProperty(exports, "defaultStorageAdapter", { enumerable: true, get: function () { return defaultStorageAdapter_1.defaultStorageAdapter; } });
+Object.defineProperty(exports, "getAllReferenceIds", { enumerable: true, get: function () { return defaultStorageAdapter_1.getAllReferenceIds; } });
+Object.defineProperty(exports, "getAllProofIds", { enumerable: true, get: function () { return defaultStorageAdapter_1.getAllProofIds; } });
+Object.defineProperty(exports, "clearAllStorage", { enumerable: true, get: function () { return defaultStorageAdapter_1.clearAllStorage; } });
+// ============================================================================
+// Headless Core Functions (re-exported for React Native consumers)
+// ============================================================================
+var enrollment_core_1 = require("../core/enrollment-core");
+Object.defineProperty(exports, "createReferenceFromImage", { enumerable: true, get: function () { return enrollment_core_1.createReferenceFromImage; } });
+var verification_core_1 = require("../core/verification-core");
+Object.defineProperty(exports, "verifyOnly", { enumerable: true, get: function () { return verification_core_1.verifyOnly; } });
+Object.defineProperty(exports, "verifyWithProof", { enumerable: true, get: function () { return verification_core_1.verifyWithProof; } });
+var zk_core_1 = require("../core/zk-core");
+Object.defineProperty(exports, "generateZkProofOnly", { enumerable: true, get: function () { return zk_core_1.generateZkProofOnly; } });
+Object.defineProperty(exports, "generateAndPersistZkProof", { enumerable: true, get: function () { return zk_core_1.generateAndPersistZkProof; } });
+// ============================================================================
+// Default Dependencies
+// ============================================================================
+var dependencies_3 = require("./dependencies");
+Object.defineProperty(exports, "getDefaultSdkDependencies", { enumerable: true, get: function () { return dependencies_3.getDefaultSdkDependencies; } });

package/dist/react-native/services/FaceRecognition.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Copyright 2026 JupiterMeta Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { OnnxRuntimeBridge } from "../components/OnnxRuntimeWebView";
+import { Point } from "../utils/faceAlignment";
+type DetectionBox = {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    score: number;
+    landmarks: Point[];
+};
+type DetectionStatus = "ok" | "no_face" | "multiple_faces" | "error";
+export interface FaceProcessResult {
+    status: DetectionStatus;
+    embedding?: number[];
+    box?: DetectionBox;
+    pose?: {
+        yaw: number;
+        pitch: number;
+        roll: number;
+    };
+    message?: string;
+    gender?: "Male" | "Female" | "Unknown";
+    age?: number;
+}
+/**
+ * Unified Face Recognition Service for iOS and Android
+ * Uses ONNX Runtime Web in WebView for cross-platform compatibility
+ * Models: buffalo_sc (SCRFD detection + MobileFaceNet recognition)
+ */
+export declare class FaceRecognitionService {
+    private bridge;
+    private modelsLoaded;
+    setBridge(bridge: OnnxRuntimeBridge): void;
+    isBridgeSet(): boolean;
+    loadModels(): Promise<void>;
+    processImageForEmbedding(imageUri: string): Promise<FaceProcessResult>;
+    getEmbeddings(imageUri: string): Promise<number[] | null>;
+    /**
+     * Process a pre-cropped reference image without face detection.
+     * This skips bounding box detection and directly extracts the embedding.
+     * Use this for small, already-cropped document photos to preserve quality.
+     */
+    processPreCroppedImage(imageUri: string): Promise<FaceProcessResult>;
+    private preprocessImage;
+    private parseDetectionOutput;
+    private applyNMS;
+    private calculateIOU;
+    private expandBox;
+    private normalizeEmbedding;
+    /**
+     * Converts a CHW tensor from ArcFace normalization [-1, 1] back to raw pixel
+     * values [0, 255] as expected by the genderage model (scalefactor=1, mean=0).
+     * ArcFace: v = (pixel - 127.5) / 128.0  →  pixel = v * 128.0 + 127.5
+     */
+    private renormalizeForGenderAge;
+    /**
+     * Replicates the Python yakhyo/facial-analysis center-crop for genderage:
+     *   scale = 96 / (max(w, h) * 1.5)   ← 1.5× padding around the face
+     *   SimilarityTransform(scale, translate_to_center)
+     *   cv2.warpAffine → 96×96, borderValue=0
+     *   blobFromImage scalefactor=1, mean=0, swapRB=True → [0, 255] RGB
+     *
+     * Crops directly from the normalized 640×640 tensor and denormalizes.
+     */
+    private cropFaceForGenderAge;
+    /**
+     * Resizes a CHW normalized float32 tensor using bilinear interpolation
+     */
+    private resizeTensorCHW;
+    /**
+     * Estimate Pose (Yaw, Pitch, Roll) from 5 landmarks (SCRFD)
+     * Landmarks: [LeftEye, RightEye, Nose, LeftMouth, RightMouth]
+     */
+    private estimatePoseFromLandmarks;
+}
+export declare const faceRecognitionService: FaceRecognitionService;
+export {};