@smileid/usesmileid 12.0.0 → 12.0.2

package/dist/testing/scenario_loader.js

@@ -0,0 +1,64 @@
+/**
+ * Emission vocabulary of the shared `e2e-scenarios` schema (`schema.json` in
+ * every repo's scenario folder). A step whose `emit` is outside this set is a
+ * drift bug — the loader rejects it rather than letting the fake silently treat
+ * it as "no detection".
+ */
+const KNOWN_EMITS = new Set([
+    "noFace",
+    "faceTooFar",
+    "faceCentered",
+    "headTurnLeft",
+    "headTurnRight",
+    "headTurnUp",
+    "satisfied",
+    "noDocument",
+    "documentFound",
+    "documentUnstable",
+]);
+const CAPTURE_TYPES = new Set(["selfie", "document"]);
+/**
+ * Validates a parsed shared-scenario JSON object and returns the typed
+ * [ScriptedScenario]. Kept I/O-free (takes an already-parsed object) so the
+ * `@smileid/usesmileid/testing` subpath stays environment-agnostic — the caller
+ * owns how the JSON is read. Throws with a specific message on any shape drift
+ * so a malformed or vocabulary-drifted script fails loudly at load time instead
+ * of producing a misleading capture sequence.
+ */
+export function parseScriptedScenario(raw) {
+    if (typeof raw !== "object" || raw === null) {
+        throw new Error("scenario must be a JSON object");
+    }
+    const record = raw;
+    const name = record.name;
+    if (typeof name !== "string" || name.length === 0) {
+        throw new Error("scenario.name must be a non-empty string");
+    }
+    const captureType = record.captureType;
+    if (typeof captureType !== "string" || !CAPTURE_TYPES.has(captureType)) {
+        throw new Error(`scenario.captureType must be one of ${[...CAPTURE_TYPES].join(", ")}, got ${String(captureType)}`);
+    }
+    if (!Array.isArray(record.steps) || record.steps.length === 0) {
+        throw new Error(`scenario.steps must be a non-empty array in ${name}`);
+    }
+    const steps = record.steps.map((step, index) => {
+        if (typeof step !== "object" || step === null) {
+            throw new Error(`scenario.steps[${index}] must be an object in ${name}`);
+        }
+        const stepRecord = step;
+        const emit = stepRecord.emit;
+        if (typeof emit !== "string" || !KNOWN_EMITS.has(emit)) {
+            throw new Error(`scenario.steps[${index}].emit "${String(emit)}" is not a known emission in ${name}`);
+        }
+        const holdFrames = stepRecord.holdFrames;
+        if (holdFrames !== undefined &&
+            (typeof holdFrames !== "number" ||
+                !Number.isInteger(holdFrames) ||
+                holdFrames < 1)) {
+            throw new Error(`scenario.steps[${index}].holdFrames must be a positive integer in ${name}`);
+        }
+        return holdFrames === undefined ? { emit } : { emit, holdFrames };
+    });
+    return { name, captureType, steps };
+}
+//# sourceMappingURL=scenario_loader.js.map

package/dist/testing/scenario_loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario_loader.js","sourceRoot":"","sources":["../../src/testing/scenario_loader.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC;IAC/C,QAAQ;IACR,YAAY;IACZ,cAAc;IACd,cAAc;IACd,eAAe;IACf,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,eAAe;IACf,kBAAkB;CACnB,CAAC,CAAC;AAEH,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAE3E;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,MAAM,GAAG,GAA8B,CAAC;IAE9C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACvC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CACb,uCAAuC,CAAC,GAAG,aAAa,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,WAAW,CAAC,EAAE,CACnG,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,KAAK,GAA2B,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACrE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,kBAAkB,KAAK,0BAA0B,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,MAAM,UAAU,GAAG,IAA+B,CAAC;QACnD,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;QAC7B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CACb,kBAAkB,KAAK,WAAW,MAAM,CAAC,IAAI,CAAC,gCAAgC,IAAI,EAAE,CACrF,CAAC;QACJ,CAAC;QACD,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;QACzC,IACE,UAAU,KAAK,SAAS;YACxB,CAAC,OAAO,UAAU,KAAK,QAAQ;gBAC7B,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC;gBAC7B,UAAU,GAAG,CAAC,CAAC,EACjB,CAAC;YACD,MAAM,IAAI,KAAK,CACb,kBAAkB,KAAK,8CAA8C,IAAI,EAAE,CAC5E,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACtC,CAAC"}

package/dist/testing/scripted_scan_results.d.ts

@@ -0,0 +1,17 @@
+import type { FaceScanResult } from "@smileid/usesmileid_bridge";
+import type { ScriptedScenario } from "./fake_face_analyzer";
+/**
+ * Turns a shared E2E scenario into the `FaceScanResult` sequence a capture
+ * screen receives frame-by-frame, so a headless test can replay the shared
+ * script through the frame stream's `onResult` seam (per-frame detection is a
+ * native frame-processor concern; pixels never reach JS).
+ *
+ * `noFace` → `initial`; `faceTooFar` / `faceCentered` → `found`; the terminal
+ * `satisfied` → one `finished` result carrying a `selfie` event plus
+ * [livenessCount] `liveness` events at opaque `file://` URLs the screen never
+ * reads. Exported only behind the `@smileid/usesmileid/testing` subpath.
+ */
+export declare function scriptedFaceScanResults(scenario: ScriptedScenario, options?: {
+    readonly livenessCount?: number;
+}): FaceScanResult[];
+//# sourceMappingURL=scripted_scan_results.d.ts.map

package/dist/testing/scripted_scan_results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripted_scan_results.d.ts","sourceRoot":"","sources":["../../src/testing/scripted_scan_results.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,GAAE;IAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GAChD,cAAc,EAAE,CAuBlB"}

package/dist/testing/scripted_scan_results.js

@@ -0,0 +1,52 @@
+import { CaptureReadyEventKind, UseSmileIDScanStateType, } from "@smileid/usesmileid_bridge";
+/**
+ * Turns a shared E2E scenario into the `FaceScanResult` sequence a capture
+ * screen receives frame-by-frame, so a headless test can replay the shared
+ * script through the frame stream's `onResult` seam (per-frame detection is a
+ * native frame-processor concern; pixels never reach JS).
+ *
+ * `noFace` → `initial`; `faceTooFar` / `faceCentered` → `found`; the terminal
+ * `satisfied` → one `finished` result carrying a `selfie` event plus
+ * [livenessCount] `liveness` events at opaque `file://` URLs the screen never
+ * reads. Exported only behind the `@smileid/usesmileid/testing` subpath.
+ */
+export function scriptedFaceScanResults(scenario, options = {}) {
+    const livenessCount = options.livenessCount ?? 2;
+    const output = { faces: [], brightness: 128 };
+    const results = [];
+    for (const step of scenario.steps) {
+        if (step.emit === "satisfied") {
+            results.push({
+                output,
+                state: { type: UseSmileIDScanStateType.Finished },
+                capturedEvents: captureEvents(livenessCount),
+            });
+            return results;
+        }
+        const type = step.emit === "noFace"
+            ? UseSmileIDScanStateType.Initial
+            : UseSmileIDScanStateType.Found;
+        for (let frame = 0; frame < (step.holdFrames ?? 1); frame++) {
+            results.push({ output, state: { type }, capturedEvents: [] });
+        }
+    }
+    return results;
+}
+function captureEvents(livenessCount) {
+    const events = [
+        {
+            kind: CaptureReadyEventKind.Selfie,
+            captureIndex: 0,
+            url: "file://selfie-0.jpg",
+        },
+    ];
+    for (let index = 1; index <= livenessCount; index++) {
+        events.push({
+            kind: CaptureReadyEventKind.Liveness,
+            captureIndex: index,
+            url: `file://liveness-${index}.jpg`,
+        });
+    }
+    return events;
+}
+//# sourceMappingURL=scripted_scan_results.js.map

package/dist/testing/scripted_scan_results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripted_scan_results.js","sourceRoot":"","sources":["../../src/testing/scripted_scan_results.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AAOpC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAA0B,EAC1B,UAA+C,EAAE;IAEjD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC;IACjD,MAAM,MAAM,GAA6B,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IACxE,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC;gBACX,MAAM;gBACN,KAAK,EAAE,EAAE,IAAI,EAAE,uBAAuB,CAAC,QAAQ,EAAE;gBACjD,cAAc,EAAE,aAAa,CAAC,aAAa,CAAC;aAC7C,CAAC,CAAC;YACH,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,MAAM,IAAI,GACR,IAAI,CAAC,IAAI,KAAK,QAAQ;YACpB,CAAC,CAAC,uBAAuB,CAAC,OAAO;YACjC,CAAC,CAAC,uBAAuB,CAAC,KAAK,CAAC;QACpC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YAC5D,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CAAC,aAAqB;IAC1C,MAAM,MAAM,GAAwB;QAClC;YACE,IAAI,EAAE,qBAAqB,CAAC,MAAM;YAClC,YAAY,EAAE,CAAC;YACf,GAAG,EAAE,qBAAqB;SAC3B;KACF,CAAC;IACF,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,aAAa,EAAE,KAAK,EAAE,EAAE,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,qBAAqB,CAAC,QAAQ;YACpC,YAAY,EAAE,KAAK;YACnB,GAAG,EAAE,mBAAmB,KAAK,MAAM;SACpC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smileid/usesmileid",
-  "version": "12.0.0",
+  "version": "12.0.2",
   "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": {
@@ -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,9 +49,10 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "axios": "^1.16.1",
-    "@smileid/usesmileid_bridge": "12.0.0",
-    "@smileid/usesmileid_platform_interface": "12.0.0"
+    "axios": "^1.18.1",
+    "zod": "^4.4.3",
+    "@smileid/usesmileid_platform_interface": "12.0.2",
+    "@smileid/usesmileid_bridge": "12.0.2"
   },
   "peerDependencies": {
     "@react-native-async-storage/async-storage": ">=1.21.0",

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

@@ -119,6 +119,28 @@ export const Appearance = {
   addChangeListener: () => ({ remove: () => {} }),
 };
 
+const appStateListeners = new Set<(state: string) => void>();
+
+export const AppState: {
+  currentState: string;
+  addEventListener: (
+    type: string,
+    listener: (state: string) => void,
+  ) => { remove: () => void };
+  emit: (state: string) => void;
+} = {
+  currentState: "active",
+  addEventListener: (_type, listener) => {
+    appStateListeners.add(listener);
+    return { remove: () => appStateListeners.delete(listener) };
+  },
+  // Test-only hook — no `AppState.emit` exists in React Native.
+  emit: (state) => {
+    AppState.currentState = state;
+    for (const listener of appStateListeners) listener(state);
+  },
+};
+
 export const Linking = {
   openURL: (_url: string) => Promise.resolve(),
   canOpenURL: (_url: string) => Promise.resolve(true),

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