@smileid/usesmileid 12.0.2 → 12.1.1

package/src/presentation/theme/use_use_smile_id_fonts.ts

@@ -1,71 +0,0 @@
-import { useEffect, useState } from "react";
-import { DM_SANS_FONT_NAMES } from "./theme";
-
-/**
- * Bundled DM Sans faces, keyed by the registered face name each
- * typography token references (see `DM_SANS_FONT_NAMES`).
- *
- * The `require` calls live inside a function (not at module scope) so
- * importing this module never touches the font assets — they are only
- * resolved when a flow actually mounts and loads fonts.
- */
-function bundledFontMap(): Record<string, number> {
-  return {
-    [DM_SANS_FONT_NAMES["400"]]:
-      require("../assets/fonts/DMSans-Regular.ttf") as number,
-    [DM_SANS_FONT_NAMES["500"]]:
-      require("../assets/fonts/DMSans-Medium.ttf") as number,
-    [DM_SANS_FONT_NAMES["600"]]:
-      require("../assets/fonts/DMSans-SemiBold.ttf") as number,
-    [DM_SANS_FONT_NAMES["700"]]:
-      require("../assets/fonts/DMSans-Bold.ttf") as number,
-    [DM_SANS_FONT_NAMES["800"]]:
-      require("../assets/fonts/DMSans-ExtraBold.ttf") as number,
-  };
-}
-
-/** Module-level so concurrent flows trigger a single load. */
-let loadPromise: Promise<void> | undefined;
-
-/**
- * Load the bundled DM Sans faces via `expo-font`. Idempotent — repeat
- * calls share one in-flight promise. Exported so partners who render
- * SDK components outside `<UseSmileIDFlow>` can preload the faces.
- */
-export function loadUseSmileIDFonts(): Promise<void> {
-  loadPromise ??= (async () => {
-    // Dynamic import keeps expo-font out of the static module graph for
-    // consumers (and tests) that never mount a flow.
-    const font = await import("expo-font");
-    await font.loadAsync(bundledFontMap());
-  })();
-  return loadPromise;
-}
-
-/**
- * Mounts the bundled DM Sans faces for the current app session.
- * Returns `true` once the faces are registered. Rendering does not
- * wait for the load — until registration completes the system font
- * renders at the same metrics, then text re-renders in DM Sans.
- */
-export function useUseSmileIDFonts(): boolean {
-  const [loaded, setLoaded] = useState(false);
-  useEffect(() => {
-    let cancelled = false;
-    loadUseSmileIDFonts()
-      .then(() => {
-        if (!cancelled) setLoaded(true);
-      })
-      .catch((error: unknown) => {
-        // Font registration must never block a verification flow — the
-        // UI falls back to the system font. Surface the cause for the
-        // integrator instead of failing silently.
-        const reason = error instanceof Error ? error.message : String(error);
-        console.warn(`UseSmileID: bundled fonts failed to load — ${reason}`);
-      });
-    return () => {
-      cancelled = true;
-    };
-  }, []);
-  return loaded;
-}

package/src/presentation/utils/__tests__/force_max_brightness.test.tsx

@@ -1,237 +0,0 @@
-import { describe, it, expect, beforeEach, vi } from "vitest";
-import { create as createRenderer, act } from "react-test-renderer";
-import * as Brightness from "expo-brightness";
-import * as KeepAwake from "expo-keep-awake";
-import { ForceMaxBrightness } from "../force_max_brightness";
-
-/**
- * Lifecycle tests for the `ForceMaxBrightness` component:
- *   - On mount: snapshot original brightness, set target (default 1)
- *   - On unmount: restore the original brightness
- *   - Activate keep-awake on mount; deactivate on unmount
- *   - `enabled={false}` is a no-op
- *
- * Mocks for `expo-brightness` and `expo-keep-awake` are installed in
- * `setup_react_native.ts` — tests reset call history per-block.
- */
-
-const mockedGetBrightness = vi.mocked(Brightness.getBrightnessAsync);
-const mockedSetBrightness = vi.mocked(Brightness.setBrightnessAsync);
-const mockedActivateKeepAwake = vi.mocked(KeepAwake.activateKeepAwakeAsync);
-const mockedDeactivateKeepAwake = vi.mocked(KeepAwake.deactivateKeepAwake);
-
-async function flushPromises(): Promise<void> {
-  // The mount closure chains `await getBrightnessAsync() → await
-  // setBrightnessAsync() → await activateKeepAwakeAsync()`. Flushing a few
-  // microtask cycles drains all three awaits before assertions.
-  await Promise.resolve();
-  await Promise.resolve();
-  await Promise.resolve();
-}
-
-describe("ForceMaxBrightness", () => {
-  beforeEach(async () => {
-    // Drain any cleanup microtask a prior test's unmount queued (the
-    // sequenced restore runs after `mountPromise` settles) so its calls land
-    // before — not after — we reset the spies below.
-    await flushPromises();
-    mockedGetBrightness.mockReset();
-    mockedGetBrightness.mockResolvedValue(0.42);
-    mockedSetBrightness.mockReset();
-    mockedSetBrightness.mockResolvedValue(undefined);
-    mockedActivateKeepAwake.mockReset();
-    mockedActivateKeepAwake.mockResolvedValue(undefined);
-    mockedDeactivateKeepAwake.mockReset();
-  });
-
-  it("is a no-op when enabled is false", async () => {
-    let tree!: ReturnType<typeof createRenderer>;
-    act(() => {
-      tree = createRenderer(<ForceMaxBrightness enabled={false} />);
-    });
-    await act(async () => {
-      await flushPromises();
-    });
-
-    expect(mockedGetBrightness).not.toHaveBeenCalled();
-    expect(mockedSetBrightness).not.toHaveBeenCalled();
-    expect(mockedActivateKeepAwake).not.toHaveBeenCalled();
-
-    await act(async () => {
-      tree.unmount();
-      await flushPromises();
-    });
-  });
-
-  it("snapshots original brightness then writes the default target on mount", async () => {
-    let tree!: ReturnType<typeof createRenderer>;
-    act(() => {
-      tree = createRenderer(<ForceMaxBrightness />);
-    });
-    await act(async () => {
-      await flushPromises();
-    });
-
-    expect(mockedGetBrightness).toHaveBeenCalledTimes(1);
-    expect(mockedSetBrightness).toHaveBeenCalledTimes(1);
-    // Default target is 1 (max).
-    expect(mockedSetBrightness).toHaveBeenCalledWith(1);
-    expect(mockedActivateKeepAwake).toHaveBeenCalledTimes(1);
-
-    await act(async () => {
-      tree.unmount();
-      await flushPromises();
-    });
-  });
-
-  it("clamps an over-1 target down to 1.0", async () => {
-    let tree!: ReturnType<typeof createRenderer>;
-    act(() => {
-      tree = createRenderer(<ForceMaxBrightness brightness={2} />);
-    });
-    await act(async () => {
-      await flushPromises();
-    });
-
-    expect(mockedSetBrightness).toHaveBeenCalledWith(1);
-    tree.unmount();
-  });
-
-  it("clamps a negative or NaN target up to 0", async () => {
-    let tree!: ReturnType<typeof createRenderer>;
-    act(() => {
-      tree = createRenderer(<ForceMaxBrightness brightness={-0.4} />);
-    });
-    await act(async () => {
-      await flushPromises();
-    });
-    expect(mockedSetBrightness).toHaveBeenCalledWith(0);
-
-    tree.unmount();
-
-    mockedSetBrightness.mockClear();
-    mockedGetBrightness.mockResolvedValue(0.42);
-    act(() => {
-      tree = createRenderer(<ForceMaxBrightness brightness={Number.NaN} />);
-    });
-    await act(async () => {
-      await flushPromises();
-    });
-    expect(mockedSetBrightness).toHaveBeenCalledWith(0);
-
-    tree.unmount();
-  });
-
-  it("restores the original brightness on unmount", async () => {
-    mockedGetBrightness.mockResolvedValue(0.37);
-    let tree!: ReturnType<typeof createRenderer>;
-    act(() => {
-      tree = createRenderer(<ForceMaxBrightness />);
-    });
-    await act(async () => {
-      await flushPromises();
-    });
-
-    // Set target was 1; clear the mock so we can assert the restore call.
-    mockedSetBrightness.mockClear();
-
-    await act(async () => {
-      tree.unmount();
-      await flushPromises();
-    });
-
-    expect(mockedSetBrightness).toHaveBeenCalledTimes(1);
-    expect(mockedSetBrightness).toHaveBeenCalledWith(0.37);
-  });
-
-  it("deactivates keep-awake on unmount with the same tag used on activate", async () => {
-    let tree!: ReturnType<typeof createRenderer>;
-    act(() => {
-      tree = createRenderer(<ForceMaxBrightness />);
-    });
-    await act(async () => {
-      await flushPromises();
-    });
-
-    const activateTag = mockedActivateKeepAwake.mock.calls[0]?.[0];
-    expect(typeof activateTag).toBe("string");
-
-    await act(async () => {
-      tree.unmount();
-      await flushPromises();
-    });
-
-    expect(mockedDeactivateKeepAwake).toHaveBeenCalledTimes(1);
-    expect(mockedDeactivateKeepAwake).toHaveBeenCalledWith(activateTag);
-  });
-
-  it("does not throw or call setBrightness when getBrightnessAsync rejects", async () => {
-    mockedGetBrightness.mockRejectedValueOnce(new Error("simulator denied"));
-    let tree!: ReturnType<typeof createRenderer>;
-    act(() => {
-      tree = createRenderer(<ForceMaxBrightness />);
-    });
-    await act(async () => {
-      await flushPromises();
-    });
-
-    // Even when the read fails, the component still attempts the write
-    // (degraded UX > flow-breaking failure).
-    expect(mockedSetBrightness).toHaveBeenCalledWith(1);
-
-    // Restore is skipped because the original was never captured.
-    mockedSetBrightness.mockClear();
-    await act(async () => {
-      tree.unmount();
-      await flushPromises();
-    });
-    expect(mockedSetBrightness).not.toHaveBeenCalled();
-  });
-
-  it("sequences the cleanup restore after the in-flight mount read settles", async () => {
-    // Concrete scenario: a fast unmount (within ~16 ms) while the
-    // mount's `getBrightnessAsync()` is still in flight. The race
-    // fix has two contracts:
-    //
-    //   1. Mount writes are skipped post-cancel (we don't pin
-    //      brightness at the target when the user already left).
-    //   2. The cleanup-restore waits for `originalBrightness` to be
-    //      captured. Without sequencing, the cleanup-then closure
-    //      would observe `originalBrightness === null` and skip
-    //      the restore — leaving brightness at whatever value the
-    //      mount wrote (or unchanged), instead of the user's
-    //      original level.
-    let resolveMountRead!: (value: number) => void;
-    mockedGetBrightness.mockReturnValueOnce(
-      new Promise<number>((resolve) => {
-        resolveMountRead = resolve;
-      }),
-    );
-
-    let tree!: ReturnType<typeof createRenderer>;
-    act(() => {
-      tree = createRenderer(<ForceMaxBrightness />);
-    });
-
-    // Unmount before the mount-time read settles. The cleanup is
-    // queued behind the mount promise.
-    await act(async () => {
-      tree.unmount();
-    });
-    expect(mockedSetBrightness).not.toHaveBeenCalled();
-
-    // Resolve the read. The mount chain captures original = 0.21,
-    // sees `cancelled = true` and bails before the target write.
-    // Then mountPromise resolves and the cleanup-then closure
-    // restores the captured original.
-    await act(async () => {
-      resolveMountRead(0.21);
-      await flushPromises();
-    });
-
-    const calls = mockedSetBrightness.mock.calls.map((c) => c[0]);
-    // Exactly one call: the cleanup-side restore. Target write was
-    // correctly skipped after cancel.
-    expect(calls).toEqual([0.21]);
-  });
-});

package/src/presentation/utils/__tests__/locale_utils.test.ts

@@ -1,78 +0,0 @@
-import { describe, expect, it } from "vitest";
-
-import {
-  GlobalPrivacyControl,
-  globalPrivacyControlFromWire,
-  GLOBAL_PRIVACY_CONTROL_WIRE_KEY,
-} from "../../../core/models/global_privacy_control";
-import { getDefaultConsentState, isDeviceLocaleInEU } from "../locale_utils";
-
-describe("locale_utils", () => {
-  it("EU locale (de-DE) is recognised as EU and default consent is false", () => {
-    expect(isDeviceLocaleInEU("de-DE")).toBe(true);
-    expect(getDefaultConsentState(GlobalPrivacyControl.OptIn, "de-DE")).toBe(
-      false,
-    );
-  });
-
-  it("non-EU locale (en-US) is not EU and default consent is true", () => {
-    expect(isDeviceLocaleInEU("en-US")).toBe(false);
-    expect(getDefaultConsentState(GlobalPrivacyControl.OptIn, "en-US")).toBe(
-      true,
-    );
-  });
-
-  it("EU locale (fr-FR) is recognised as EU and default consent is false", () => {
-    expect(isDeviceLocaleInEU("fr-FR")).toBe(true);
-    expect(getDefaultConsentState(GlobalPrivacyControl.OptIn, "fr-FR")).toBe(
-      false,
-    );
-  });
-
-  it("non-EU locale (en-NG) is not EU and default consent is true", () => {
-    expect(isDeviceLocaleInEU("en-NG")).toBe(false);
-    expect(getDefaultConsentState(GlobalPrivacyControl.OptIn, "en-NG")).toBe(
-      true,
-    );
-  });
-
-  it("bare language tag with no region falls back to non-EU", () => {
-    // `"fr"` has no region segment — the BCP-47 split returns
-    // undefined for the country, which never matches the EU set.
-    expect(isDeviceLocaleInEU("fr")).toBe(false);
-    expect(getDefaultConsentState(GlobalPrivacyControl.OptIn, "fr")).toBe(true);
-  });
-
-  it("empty locale string falls back to non-EU", () => {
-    expect(isDeviceLocaleInEU("")).toBe(false);
-    expect(getDefaultConsentState("")).toBe(true);
-  });
-
-  describe("global privacy control", () => {
-    it("default posture forces opt-out even for EU locales", () => {
-      expect(getDefaultConsentState()).toBe(true);
-      expect(getDefaultConsentState(GlobalPrivacyControl.OptOut, "de-DE")).toBe(
-        true,
-      );
-      expect(getDefaultConsentState(GlobalPrivacyControl.OptOut, "en-NG")).toBe(
-        true,
-      );
-    });
-
-    it("parses wire values and defaults unknowns to opt-out", () => {
-      expect(globalPrivacyControlFromWire("opt-out")).toBe(
-        GlobalPrivacyControl.OptOut,
-      );
-      expect(globalPrivacyControlFromWire("opt-in")).toBe(
-        GlobalPrivacyControl.OptIn,
-      );
-      expect(globalPrivacyControlFromWire(null)).toBe(
-        GlobalPrivacyControl.OptOut,
-      );
-      expect(globalPrivacyControlFromWire("user_settings")).toBe(
-        GlobalPrivacyControl.OptOut,
-      );
-      expect(GLOBAL_PRIVACY_CONTROL_WIRE_KEY).toBe("global_privacy_control");
-    });
-  });
-});

package/src/presentation/utils/force_max_brightness.tsx

@@ -1,113 +0,0 @@
-import { useEffect } from "react";
-import { getBrightnessAsync, setBrightnessAsync } from "expo-brightness";
-import { activateKeepAwakeAsync, deactivateKeepAwake } from "expo-keep-awake";
-
-export interface ForceMaxBrightnessProps {
-  /** Target brightness in the range 0.0–1.0. Defaults to 1.0 (max). */
-  readonly brightness?: number;
-  /**
-   * When false the component is a no-op. Defaults to true. Every capture
-   * screen (selfie and document) mounts this enabled so the preview always
-   * runs at full brightness with the screen kept awake for the duration of
-   * the capture.
-   */
-  readonly enabled?: boolean;
-}
-
-/**
- * Forces the device screen brightness to a target value (default 1.0) for as
- * long as this component is mounted, restoring the user's original brightness
- * when it unmounts. Also keeps the screen awake so a long capture session
- * doesn't slip into auto-lock mid-flow.
- *
- * Rendered for its lifecycle side effect only (returns `null`), matching the
- * Android `ForceMaxBrightness` composable and Flutter `ForceMaxBrightness`
- * widget.
- *
- * Why brightness control is part of the capture surface: the ML pipeline tunes
- * its luminance thresholds (`LOW_LIGHT` overlay state, exposure scoring) for a
- * screen running at full brightness. A user who walks into the flow with
- * brightness at 20 % triggers spurious low-light feedback even when the ambient
- * lighting is adequate. Lifting brightness on the capture screen keeps the
- * model's input distribution aligned with the calibration set.
- *
- * Implementation:
- *   - `expo-brightness` provides `getBrightnessAsync` / `setBrightnessAsync`.
- *     The original value is captured on mount and the target is applied
- *     immediately. On cleanup we restore the original.
- *   - `expo-keep-awake`'s `activateKeepAwakeAsync` / `deactivateKeepAwake` keep
- *     the screen on.
- *   - Errors are swallowed silently because the consequence of a brightness
- *     call failing is degraded UX (slightly dimmer preview), not a
- *     flow-breaking bug. Routing them through Sentry would spam partners on
- *     simulators where the API isn't available.
- *   - The cleanup-side restore is sequenced *after* the in-flight mount write
- *     completes. Concrete scenario this guards: a fast unmount (within ~16 ms —
- *     partner navigates away during a transient state) where the cleanup's
- *     restore would otherwise race the late mount write, leaving brightness
- *     pinned at `target` instead of the user's original level.
- */
-export function ForceMaxBrightness({
-  brightness = 1,
-  enabled = true,
-}: ForceMaxBrightnessProps): null {
-  useEffect(() => {
-    if (!enabled) return;
-    const target = clamp01(brightness);
-    let cancelled = false;
-    let originalBrightness: number | null = null;
-    let keepAwakeActivated = false;
-    const keepAwakeTag = "usesmileid-capture";
-
-    const mountPromise: Promise<void> = (async () => {
-      try {
-        originalBrightness = await getBrightnessAsync();
-      } catch {
-        // Read failed (e.g. iOS simulator) — proceed with the
-        // write so the capture preview still gets a brighter
-        // surface, accepting that we can't restore on unmount.
-        originalBrightness = null;
-      }
-      if (cancelled) return;
-      try {
-        await setBrightnessAsync(target);
-      } catch {
-        // Write failed — degraded UX but not flow-breaking.
-      }
-      if (cancelled) return;
-      try {
-        await activateKeepAwakeAsync(keepAwakeTag);
-        if (!cancelled) keepAwakeActivated = true;
-      } catch {
-        // Same rationale as brightness write.
-      }
-    })();
-
-    return () => {
-      cancelled = true;
-      void mountPromise.then(() => {
-        if (originalBrightness !== null) {
-          void setBrightnessAsync(clamp01(originalBrightness)).catch(() => {
-            /* restore-on-cleanup is best-effort */
-          });
-        }
-        if (keepAwakeActivated) {
-          try {
-            deactivateKeepAwake(keepAwakeTag);
-          } catch {
-            /* deactivate is best-effort */
-          }
-        }
-      });
-    };
-  }, [brightness, enabled]);
-
-  return null;
-}
-
-function clamp01(value: number): number {
-  if (Number.isNaN(value)) return 0;
-  if (value < 0) return 0;
-  if (value > 1) return 1;
-  return value;
-}

package/src/presentation/utils/locale_utils.ts

@@ -1,80 +0,0 @@
-import { GlobalPrivacyControl } from "../../core/models/global_privacy_control";
-const EU_COUNTRY_CODES: ReadonlySet<string> = new Set([
-  "AT",
-  "BE",
-  "BG",
-  "HR",
-  "CY",
-  "CZ",
-  "DK",
-  "EE",
-  "FI",
-  "FR",
-  "DE",
-  "GR",
-  "HU",
-  "IE",
-  "IT",
-  "LV",
-  "LT",
-  "LU",
-  "MT",
-  "NL",
-  "PL",
-  "PT",
-  "RO",
-  "SK",
-  "SI",
-  "ES",
-  "SE",
-]);
-
-/**
- * Returns the device's resolved BCP-47 locale tag (e.g. `"en-US"`).
- *
- * Uses the JS engine's `Intl` resolved options, which on Hermes
- * (Expo SDK 51+, with `enableHermesLocaleAPI` enabled by default) and
- * JSC reflects the system locale. Returns an empty string if `Intl`
- * is unavailable — callers then treat the locale as non-EU.
- */
-export function getDeviceLocale(): string {
-  try {
-    return Intl.DateTimeFormat().resolvedOptions().locale;
-  } catch {
-    return "";
-  }
-}
-
-/**
- * Returns `true` if the device's locale country is an EU member state.
- *
- * Accepts a BCP-47 tag (`"en-US"`, `"fr-FR"`, or bare `"fr"`). Bare
- * language tags with no region resolve to non-EU because the country
- * cannot be determined.
- */
-export function isDeviceLocaleInEU(
-  locale: string = getDeviceLocale(),
-): boolean {
-  const country = locale.split("-")[1]?.toUpperCase();
-  return country !== undefined && EU_COUNTRY_CODES.has(country);
-}
-
-/**
- * Returns the default consent checkbox state for the partner-declared
- * `GlobalPrivacyControl` posture.
- *
- * - `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(
-  globalPrivacyControl: GlobalPrivacyControl = GlobalPrivacyControl.OptOut,
-  locale: string = getDeviceLocale(),
-): boolean {
-  return globalPrivacyControl === GlobalPrivacyControl.OptOut
-    ? true
-    : !isDeviceLocaleInEU(locale);
-}

package/src/presentation/utils/use_reduced_motion.ts

@@ -1,26 +0,0 @@
-import { useEffect, useState } from "react";
-import { AccessibilityInfo } from "react-native";
-
-/** System reduced-motion preference — initial value plus later changes. */
-export function useReducedMotion(): boolean {
-  const [reducedMotion, setReducedMotion] = useState(false);
-  useEffect(() => {
-    let cancelled = false;
-    AccessibilityInfo.isReduceMotionEnabled()
-      .then((enabled) => {
-        if (!cancelled) setReducedMotion(enabled);
-      })
-      // Platform query failed — keep the motion-on default rather than
-      // surfacing an unhandled rejection.
-      .catch(() => undefined);
-    const subscription = AccessibilityInfo.addEventListener(
-      "reduceMotionChanged",
-      (enabled) => setReducedMotion(enabled),
-    );
-    return () => {
-      cancelled = true;
-      subscription.remove();
-    };
-  }, []);
-  return reducedMotion;
-}

package/src/testing/__tests__/fake_face_analyzer.test.ts

@@ -1,42 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { makeFakeFaceAnalyzer } from "../fake_face_analyzer";
-
-const scenario = {
-  name: "selfie-happy-path",
-  captureType: "selfie",
-  steps: [
-    { emit: "noFace", holdFrames: 2 },
-    { emit: "faceCentered", holdFrames: 3 },
-    { emit: "satisfied" },
-  ],
-} as const;
-
-describe("FakeFaceAnalyzer", () => {
-  it("replays holdFrames per step and repeats the final step indefinitely", () => {
-    const fake = makeFakeFaceAnalyzer(scenario);
-    const emits = Array.from({ length: 9 }, () => fake.nextEmit());
-    expect(emits).toEqual([
-      "noFace",
-      "noFace",
-      "faceCentered",
-      "faceCentered",
-      "faceCentered",
-      "satisfied",
-      "satisfied",
-      "satisfied",
-      "satisfied",
-    ]);
-  });
-
-  it("records the JS lifecycle calls", async () => {
-    const fake = makeFakeFaceAnalyzer(scenario);
-    await fake.configure();
-    await fake.reset();
-    await fake.flush();
-    await fake.close();
-    expect(fake.configureCallCount).toBe(1);
-    expect(fake.resetCallCount).toBe(1);
-    expect(fake.flushCallCount).toBe(1);
-    expect(fake.closeCallCount).toBe(1);
-  });
-});