@smileid/usesmileid 12.0.0 → 12.0.1

package/dist/presentation/utils/locale_utils.js

@@ -1,3 +1,4 @@
+import { GlobalPrivacyControl } from "../../core/models/global_privacy_control";
 const EU_COUNTRY_CODES = new Set([
     "AT",
     "BE",
@@ -55,12 +56,19 @@ export function isDeviceLocaleInEU(locale = getDeviceLocale()) {
     return country !== undefined && EU_COUNTRY_CODES.has(country);
 }
 /**
- * Returns the default consent checkbox state based on the device locale.
+ * Returns the default consent checkbox state for the partner-declared
+ * `GlobalPrivacyControl` posture.
  *
- * - EU locales: unticked (`false`) to comply with GDPR opt-in.
- * - Non-EU locales: ticked (`true`).
+ * - `GlobalPrivacyControl.OptOut` (default): ticked (`true`) universally —
+ *   the opt-out layout is enforced for every session and the device region
+ *   is never consulted.
+ * - `GlobalPrivacyControl.OptIn`: legacy regional mechanics — EU locales
+ *   start unticked (`false`, explicit opt-in per GDPR), everywhere else
+ *   starts ticked (`true`).
  */
-export function getDefaultConsentState(locale = getDeviceLocale()) {
-    return !isDeviceLocaleInEU(locale);
+export function getDefaultConsentState(globalPrivacyControl = GlobalPrivacyControl.OptOut, locale = getDeviceLocale()) {
+    return globalPrivacyControl === GlobalPrivacyControl.OptOut
+        ? true
+        : !isDeviceLocaleInEU(locale);
 }
 //# sourceMappingURL=locale_utils.js.map

package/dist/presentation/utils/locale_utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"locale_utils.js","sourceRoot":"","sources":["../../../src/presentation/utils/locale_utils.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IACpD,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;CACL,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAiB,eAAe,EAAE;IAElC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IACpD,OAAO,OAAO,KAAK,SAAS,IAAI,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAAiB,eAAe,EAAE;IAElC,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"locale_utils.js","sourceRoot":"","sources":["../../../src/presentation/utils/locale_utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAChF,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IACpD,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;CACL,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAiB,eAAe,EAAE;IAElC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IACpD,OAAO,OAAO,KAAK,SAAS,IAAI,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CACpC,uBAA6C,oBAAoB,CAAC,MAAM,EACxE,SAAiB,eAAe,EAAE;IAElC,OAAO,oBAAoB,KAAK,oBAAoB,CAAC,MAAM;QACzD,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/dist/testing/fake_face_analyzer.d.ts

@@ -0,0 +1,43 @@
+import type { FaceAnalyzer } from "@smileid/usesmileid_platform_interface";
+import { AnalyzerFactoryKey } from "@smileid/usesmileid_bridge";
+/**
+ * Deterministic fake face analyzer for scripted-scenario E2E runs. Exported
+ * only behind the `@smileid/usesmileid/testing` subpath so it cannot leak into
+ * partner production bundles.
+ *
+ * Per-frame detection runs in the provider's native frame-processor plugin
+ * (pixels never cross into JS), so `frameProcessorPluginName` points at a
+ * plugin that does not exist — the capture screen surfaces that as its
+ * camera-unavailable state. This fake covers the DSL registration seam and the
+ * capture-free flows; capture progression is driven via `onResult` instead.
+ */
+export interface ScriptedScenarioStep {
+    readonly emit: string;
+    readonly holdFrames?: number;
+}
+export interface ScriptedScenario {
+    readonly name: string;
+    readonly captureType: string;
+    readonly steps: readonly ScriptedScenarioStep[];
+}
+export declare class FakeFaceAnalyzer implements FaceAnalyzer {
+    private readonly scenario;
+    readonly kind: "face";
+    readonly key: AnalyzerFactoryKey;
+    readonly frameProcessorPluginName = "e2e-fake-face";
+    configureCallCount: number;
+    resetCallCount: number;
+    flushCallCount: number;
+    closeCallCount: number;
+    private stepIndex;
+    private framesLeftInStep;
+    constructor(scenario: ScriptedScenario);
+    /** Frame-by-frame cursor; the final step repeats indefinitely. */
+    nextEmit(): string;
+    configure(): Promise<void>;
+    reset(): Promise<void>;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+}
+export declare function makeFakeFaceAnalyzer(scenario: ScriptedScenario): FakeFaceAnalyzer;
+//# sourceMappingURL=fake_face_analyzer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fake_face_analyzer.d.ts","sourceRoot":"","sources":["../../src/testing/fake_face_analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACjD;AAED,qBAAa,gBAAiB,YAAW,YAAY;IAavC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAZrC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAChC,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAgC;IAChE,QAAQ,CAAC,wBAAwB,mBAAmB;IAEpD,kBAAkB,SAAK;IACvB,cAAc,SAAK;IACnB,cAAc,SAAK;IACnB,cAAc,SAAK;IAEnB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,gBAAgB,CAAS;gBAEJ,QAAQ,EAAE,gBAAgB;IAIvD,kEAAkE;IAClE,QAAQ,IAAI,MAAM;IAalB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAK1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAIvB;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,gBAAgB,GACzB,gBAAgB,CAElB"}

package/dist/testing/fake_face_analyzer.js

@@ -0,0 +1,52 @@
+import { AnalyzerFactoryKey } from "@smileid/usesmileid_bridge";
+export class FakeFaceAnalyzer {
+    scenario;
+    kind = "face";
+    key = AnalyzerFactoryKey.MLKitFace;
+    frameProcessorPluginName = "e2e-fake-face";
+    configureCallCount = 0;
+    resetCallCount = 0;
+    flushCallCount = 0;
+    closeCallCount = 0;
+    stepIndex = 0;
+    framesLeftInStep;
+    constructor(scenario) {
+        this.scenario = scenario;
+        this.framesLeftInStep = scenario.steps[0]?.holdFrames ?? 1;
+    }
+    /** Frame-by-frame cursor; the final step repeats indefinitely. */
+    nextEmit() {
+        const steps = this.scenario.steps;
+        const step = steps[this.stepIndex];
+        if (step === undefined)
+            return "noFace";
+        if (this.stepIndex === steps.length - 1)
+            return step.emit;
+        this.framesLeftInStep -= 1;
+        if (this.framesLeftInStep <= 0) {
+            this.stepIndex += 1;
+            this.framesLeftInStep = steps[this.stepIndex]?.holdFrames ?? 1;
+        }
+        return step.emit;
+    }
+    configure() {
+        this.configureCallCount += 1;
+        return Promise.resolve();
+    }
+    reset() {
+        this.resetCallCount += 1;
+        return Promise.resolve();
+    }
+    flush() {
+        this.flushCallCount += 1;
+        return Promise.resolve();
+    }
+    close() {
+        this.closeCallCount += 1;
+        return Promise.resolve();
+    }
+}
+export function makeFakeFaceAnalyzer(scenario) {
+    return new FakeFaceAnalyzer(scenario);
+}
+//# sourceMappingURL=fake_face_analyzer.js.map

package/dist/testing/fake_face_analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake_face_analyzer.js","sourceRoot":"","sources":["../../src/testing/fake_face_analyzer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAwBhE,MAAM,OAAO,gBAAgB;IAaE;IAZpB,IAAI,GAAG,MAAe,CAAC;IACvB,GAAG,GAAuB,kBAAkB,CAAC,SAAS,CAAC;IACvD,wBAAwB,GAAG,eAAe,CAAC;IAEpD,kBAAkB,GAAG,CAAC,CAAC;IACvB,cAAc,GAAG,CAAC,CAAC;IACnB,cAAc,GAAG,CAAC,CAAC;IACnB,cAAc,GAAG,CAAC,CAAC;IAEX,SAAS,GAAG,CAAC,CAAC;IACd,gBAAgB,CAAS;IAEjC,YAA6B,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;QACrD,IAAI,CAAC,gBAAgB,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,kEAAkE;IAClE,QAAQ;QACN,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QACxC,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC;QAC1D,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,gBAAgB,IAAI,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;YACpB,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,SAAS;QACP,IAAI,CAAC,kBAAkB,IAAI,CAAC,CAAC;QAC7B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QACzB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QACzB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QACzB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAClC,QAA0B;IAE1B,OAAO,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC"}

package/dist/testing/index.d.ts

@@ -0,0 +1,5 @@
+export { FakeFaceAnalyzer, makeFakeFaceAnalyzer, type ScriptedScenario, type ScriptedScenarioStep, } from "./fake_face_analyzer";
+export { scriptedFaceScanResults } from "./scripted_scan_results";
+export { parseScriptedScenario } from "./scenario_loader";
+export { type ScenarioExpectations, parseScenarioExpectations, expectSubsetInOrder, } from "./scenario_expectations";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EACL,KAAK,oBAAoB,EACzB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,7 @@
+// Test-support entry — exported behind the `@smileid/usesmileid/testing`
+// subpath only. Nothing here may be re-exported from the main index.
+export { FakeFaceAnalyzer, makeFakeFaceAnalyzer, } from "./fake_face_analyzer";
+export { scriptedFaceScanResults } from "./scripted_scan_results";
+export { parseScriptedScenario } from "./scenario_loader";
+export { parseScenarioExpectations, expectSubsetInOrder, } from "./scenario_expectations";
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,qEAAqE;AACrE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,GAGrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAEL,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC"}

package/dist/testing/scenario_expectations.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Capture-scoped expectations from the shared `e2e-scenarios` schema's `expected`
+ * block (screen + analytics-event names, terminal state). Framework-agnostic (no
+ * vitest/jest import) so a partner app's own e2e runner can reuse it.
+ */
+export interface ScenarioExpectations {
+    /** Ordered `screen_viewed` sequence for the canonical consent-first flow. */
+    readonly screens: readonly string[];
+    /** Ordered analytics event types that must fire (subset-in-order). */
+    readonly events: readonly string[];
+    /** How the capture session ends. */
+    readonly terminal?: "submitted" | "timeout" | "unsatisfied";
+}
+/**
+ * Extracts and validates the `expected` block from an already-parsed shared
+ * scenario JSON object. Returns empty screen/event arrays when the block is
+ * absent (older scenarios), and throws on a malformed block so drift fails
+ * loudly rather than silently weakening the contract.
+ */
+export declare function parseScenarioExpectations(raw: unknown): ScenarioExpectations;
+/**
+ * Asserts that every element of [expected] appears in [recorded] in the same
+ * relative order (a minimal ordered-subset match — unlisted items may
+ * interleave, exact-match is deliberately NOT required). Throws a descriptive
+ * Error on failure so it works under any test runner.
+ */
+export declare function expectSubsetInOrder(recorded: readonly string[], expected: readonly string[], label?: string): void;
+//# sourceMappingURL=scenario_expectations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scenario_expectations.d.ts","sourceRoot":"","sources":["../../src/testing/scenario_expectations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;CAC7D;AAQD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,CA4B5E;AAUD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,KAAK,SAAa,GACjB,IAAI,CAYN"}

package/dist/testing/scenario_expectations.js

@@ -0,0 +1,65 @@
+const TERMINALS = new Set([
+    "submitted",
+    "timeout",
+    "unsatisfied",
+]);
+/**
+ * Extracts and validates the `expected` block from an already-parsed shared
+ * scenario JSON object. Returns empty screen/event arrays when the block is
+ * absent (older scenarios), and throws on a malformed block so drift fails
+ * loudly rather than silently weakening the contract.
+ */
+export function parseScenarioExpectations(raw) {
+    if (typeof raw !== "object" || raw === null) {
+        throw new Error("scenario must be a JSON object");
+    }
+    const expected = raw.expected;
+    if (expected === undefined) {
+        return { screens: [], events: [] };
+    }
+    if (typeof expected !== "object" || expected === null) {
+        throw new Error("scenario.expected must be an object when present");
+    }
+    const record = expected;
+    const screens = readStringArray(record.screens, "scenario.expected.screens");
+    const events = readStringArray(record.events, "scenario.expected.events");
+    const terminal = record.terminal;
+    if (terminal === undefined) {
+        return { screens, events };
+    }
+    if (typeof terminal !== "string" || !TERMINALS.has(terminal)) {
+        throw new Error(`scenario.expected.terminal must be one of ${[...TERMINALS].join(", ")}, got ${String(terminal)}`);
+    }
+    return {
+        screens,
+        events,
+        terminal: terminal,
+    };
+}
+function readStringArray(value, label) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) {
+        throw new Error(`${label} must be an array of strings`);
+    }
+    return value;
+}
+/**
+ * Asserts that every element of [expected] appears in [recorded] in the same
+ * relative order (a minimal ordered-subset match — unlisted items may
+ * interleave, exact-match is deliberately NOT required). Throws a descriptive
+ * Error on failure so it works under any test runner.
+ */
+export function expectSubsetInOrder(recorded, expected, label = "sequence") {
+    let cursor = 0;
+    for (const item of recorded) {
+        if (cursor < expected.length && item === expected[cursor])
+            cursor += 1;
+    }
+    if (cursor !== expected.length) {
+        throw new Error(`${label}: expected [${expected
+            .slice(cursor)
+            .join(", ")}] to appear in order within [${recorded.join(", ")}]`);
+    }
+}
+//# sourceMappingURL=scenario_expectations.js.map

package/dist/testing/scenario_expectations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario_expectations.js","sourceRoot":"","sources":["../../src/testing/scenario_expectations.ts"],"names":[],"mappings":"AAcA,MAAM,SAAS,GAAwB,IAAI,GAAG,CAAC;IAC7C,WAAW;IACX,SAAS;IACT,aAAa;CACd,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAY;IACpD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,QAAQ,GAAI,GAA+B,CAAC,QAAQ,CAAC;IAC3D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,MAAM,GAAG,QAAmC,CAAC;IACnD,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,OAAO,EAAE,2BAA2B,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC7B,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CACb,6CAA6C,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,QAAQ,CAAC,EAAE,CAClG,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO;QACP,MAAM;QACN,QAAQ,EAAE,QAAmD;KAC9D,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc,EAAE,KAAa;IACpD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;QAC5E,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,8BAA8B,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,KAAiB,CAAC;AAC3B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAA2B,EAC3B,QAA2B,EAC3B,KAAK,GAAG,UAAU;IAElB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,MAAM,GAAG,QAAQ,CAAC,MAAM,IAAI,IAAI,KAAK,QAAQ,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,eAAe,QAAQ;aAC5B,KAAK,CAAC,MAAM,CAAC;aACb,IAAI,CAAC,IAAI,CAAC,gCAAgC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACpE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/testing/scenario_loader.d.ts

@@ -0,0 +1,11 @@
+import type { ScriptedScenario } from "./fake_face_analyzer";
+/**
+ * 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 declare function parseScriptedScenario(raw: unknown): ScriptedScenario;
+//# sourceMappingURL=scenario_loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scenario_loader.d.ts","sourceRoot":"","sources":["../../src/testing/scenario_loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,sBAAsB,CAAC;AAuB9B;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAgDpE"}

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.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": {
@@ -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_bridge": "12.0.1",
+    "@smileid/usesmileid_platform_interface": "12.0.1"
   },
   "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__/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