@smileid/usesmileid 12.0.0-beta01 → 12.0.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@smileid/usesmileid",
-  "version": "12.0.0-beta01",
-  "description": "UseSmileID v12 — public-facing React Native (Expo) SDK. DSL builder, theme tokens, flow types, and screen surface mirroring the Flutter `usesmileid` and Android/iOS `UseSmileID` packages.",
+  "version": "12.0.1",
+  "description": "Official Smile ID React Native (Expo) SDK for identity verification: selfie capture, liveness checks, and document verification powered by on-device ML.",
   "homepage": "https://usesmileid.com",
   "repository": {
     "type": "git",
@@ -33,6 +33,12 @@
       "react-native": "./src/index.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "react-native": "./src/testing/index.ts",
+      "import": "./dist/testing/index.js",
+      "require": "./dist/testing/index.js"
     }
   },
   "files": [
@@ -43,13 +49,17 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "axios": "^1.16.1",
-    "@smileid/usesmileid_bridge": "12.0.0-beta01",
-    "@smileid/usesmileid_platform_interface": "12.0.0-beta01"
+    "axios": "^1.18.1",
+    "zod": "^4.4.3",
+    "@smileid/usesmileid_bridge": "12.0.1",
+    "@smileid/usesmileid_platform_interface": "12.0.1"
   },
   "peerDependencies": {
+    "@react-native-async-storage/async-storage": ">=1.21.0",
     "expo": ">=56.0.0",
+    "expo-battery": ">=56.0.0",
     "expo-brightness": ">=56.0.0",
+    "expo-cellular": ">=56.0.0",
     "expo-device": ">=56.0.0",
     "expo-file-system": ">=56.0.0",
     "expo-font": ">=56.0.0",
@@ -57,9 +67,11 @@
     "expo-image-manipulator": ">=56.0.0",
     "expo-image-picker": ">=56.0.0",
     "expo-keep-awake": ">=56.0.0",
+    "expo-location": ">=56.0.0",
     "expo-modules-core": ">=56.0.0",
     "expo-network": ">=56.0.0",
     "expo-screen-orientation": ">=56.0.0",
+    "expo-sensors": ">=56.0.0",
     "lottie-react-native": ">=7.3.0",
     "react": ">=19.2.0",
     "react-native": ">=0.83.0",
@@ -72,11 +84,26 @@
     "react-native-worklets-core": ">=1.6.0"
   },
   "peerDependenciesMeta": {
+    "@react-native-async-storage/async-storage": {
+      "optional": true
+    },
+    "expo-battery": {
+      "optional": true
+    },
+    "expo-cellular": {
+      "optional": true
+    },
     "expo-device": {
       "optional": true
     },
     "expo-network": {
       "optional": true
+    },
+    "expo-location": {
+      "optional": true
+    },
+    "expo-sensors": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -90,6 +117,7 @@
     "expo-keep-awake": "~56.0.3",
     "expo-modules-core": "^56.0.15",
     "expo-screen-orientation": "~56.0.5",
+    "jpeg-js": "^0.4.4",
     "lottie-react-native": "~7.3.8",
     "react": "19.2.3",
     "react-native": "^0.85.3",
@@ -100,8 +128,7 @@
     "typescript": "^6.0.3"
   },
   "publishConfig": {
-    "access": "public",
-    "provenance": false
+    "access": "public"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",

package/src/__tests__/dsl.test.ts

@@ -1,3 +1,4 @@
+import { GlobalPrivacyControl } from "../core/models/global_privacy_control";
 import { describe, expect, it, vi } from "vitest";
 import { AnalyzerFactoryKey } from "@smileid/usesmileid_bridge";
 import type {
@@ -146,6 +147,28 @@ describe("useSmileIDBuilder — closure-based DSL", () => {
   });
 
   describe("config block", () => {
+    it("global privacy control defaults to opt-out", () => {
+      const config = buildOk((b) => {
+        withMinimalScreens(b);
+        b.config(() => {});
+      });
+      expect(config.config?.globalPrivacyControl).toBe(
+        GlobalPrivacyControl.OptOut,
+      );
+    });
+
+    it("global privacy control opt-in flows from the config block", () => {
+      const config = buildOk((b) => {
+        withMinimalScreens(b);
+        b.config((c) => {
+          c.globalPrivacyControl = GlobalPrivacyControl.OptIn;
+        });
+      });
+      expect(config.config?.globalPrivacyControl).toBe(
+        GlobalPrivacyControl.OptIn,
+      );
+    });
+
     it("captures enableCrashReporting through the closure", () => {
       const config = buildOk((b) => {
         withMinimalScreens(b);
@@ -385,9 +408,9 @@ describe("useSmileIDBuilder — closure-based DSL", () => {
         b.screens((screens) => {
           screens.capture((cap) => {
             cap.captureType = CaptureType.selfie;
+            // Mutually exclusive, so the closure is exercised one flag at a time.
             cap.selfie((sel) => {
               sel.allowAgentMode = true;
-              sel.enableEnhancedLiveness = true;
             });
           });
         });
@@ -396,9 +419,36 @@ describe("useSmileIDBuilder — closure-based DSL", () => {
       expect(captureStep?.kind).toBe("capture");
       if (captureStep?.kind === "capture") {
         expect(captureStep.config.selfieConfig?.allowAgentMode).toBe(true);
+        expect(captureStep.config.selfieConfig?.enableEnhancedLiveness).toBe(
+          false,
+        );
+      }
+    });
+
+    it("capture(...) plumbs enableEnhancedLiveness through the selfie closure", () => {
+      const config = buildOk((b) => {
+        b.ml((m) => {
+          m.analyzers((a) => {
+            a.forCaptureType(CaptureType.selfie, (face) =>
+              face.add(stubFaceAnalyzer),
+            );
+          });
+        });
+        b.screens((screens) => {
+          screens.capture((cap) => {
+            cap.captureType = CaptureType.selfie;
+            cap.selfie((sel) => {
+              sel.enableEnhancedLiveness = true;
+            });
+          });
+        });
+      });
+      const captureStep = config.screens.steps[0];
+      if (captureStep?.kind === "capture") {
         expect(captureStep.config.selfieConfig?.enableEnhancedLiveness).toBe(
           true,
         );
+        expect(captureStep.config.selfieConfig?.allowAgentMode).toBe(false);
       }
     });
   });

package/src/__tests__/react_native_mock.tsx

@@ -99,6 +99,14 @@ export const I18nManager = { isRTL: false };
 
 export const useColorScheme = (): "light" | "dark" | null => "light";
 
+// Portrait window by default — the capture screen reads this for its
+// iOS preview-remount key (`cameraOrientationKey`); tests don't assert on
+// the key, so a stable portrait size just lets the component render.
+export const useWindowDimensions = (): { width: number; height: number } => ({
+  width: 390,
+  height: 844,
+});
+
 export const Platform = {
   OS: "ios" as const,
   select<T>(spec: { ios?: T; android?: T; default?: T }): T | undefined {

package/src/__tests__/setup_react_native.ts

@@ -102,14 +102,26 @@ vi.mock("react-native-safe-area-context", () => {
 // permission so the capture screen renders the preview branch in
 // tests. Tests that exercise the undetermined / denied branches
 // reset the mock per-test via `vi.mocked(useCameraPermission)`.
+// Stand-in for `CameraRef.takePhoto`, so tests can drive the manual shutter.
+// Reset per test by the shared `vi.clearAllMocks()`/`resetAllMocks()` hooks.
+export const mockedTakePhoto = vi.fn(async () => ({
+  path: "/tmp/manual-shutter.jpg",
+  width: 1600,
+  height: 1200,
+}));
+
 vi.mock("react-native-vision-camera", () => {
-  function Camera(
+  const Camera = React.forwardRef(function Camera(
     props: AnyProps & {
       device?: unknown;
       isActive?: boolean;
       photo?: boolean;
     },
+    ref: React.Ref<unknown>,
   ) {
+    // The screen reaches `takePhoto` through this ref; without it the manual
+    // shutter handler bails on a null camera and can't be tested.
+    React.useImperativeHandle(ref, () => ({ takePhoto: mockedTakePhoto }), []);
     return React.createElement("Camera", {
       testID: props.testID,
       style: props.style,
@@ -117,7 +129,7 @@ vi.mock("react-native-vision-camera", () => {
       isActive: props.isActive,
       photo: props.photo,
     });
-  }
+  });
   const fakeDevice = {
     id: "test-front",
     position: "front",
@@ -237,6 +249,9 @@ vi.mock("expo-screen-orientation", () => ({
   lockAsync: vi.fn(async (_lock: number) => {}),
   unlockAsync: vi.fn(async () => {}),
   getOrientationAsync: vi.fn(async () => 1),
+  // Defaults to a permissive host build; the lock preflight's unsupported
+  // path is opted into per-test.
+  supportsOrientationLockAsync: vi.fn(async (_lock: number) => true),
 }));
 
 // `expo-image-picker` backs the document gallery-upload control. Defaults to