@smileid/usesmileid 12.0.2 → 12.1.0

package/src/presentation/flow/screen/__tests__/orchestrated_processing_screen.test.tsx

@@ -1,338 +0,0 @@
-import { describe, it, expect, vi, beforeEach } from "vitest";
-import * as React from "react";
-import { create as createRenderer, act } from "react-test-renderer";
-
-// `vi.mock` is hoisted above the imports, so anything its factory closes over
-// must be created with `vi.hoisted` or it is still in the TDZ when the factory
-// runs.
-const { screenProps } = vi.hoisted(() => ({
-  screenProps: { current: {} as Record<string, unknown> },
-}));
-
-// Stand in for the leaf screen so these tests exercise the orchestration
-// (submission kick-off, state mapping, exit routing) rather than re-testing
-// the processing UI, which has its own component suite.
-vi.mock("../../../screen/use_smile_id_processing_screen", () => ({
-  UseSmileIDProcessingScreen: (props: Record<string, unknown>) => {
-    screenProps.current = props;
-    return null;
-  },
-}));
-
-import { OrchestratedProcessingScreen } from "../orchestrated_processing_screen";
-import { FlowNavigationProvider } from "../../flow_navigation_context";
-import {
-  NetworkServerException,
-  NetworkTransportException,
-  NetworkUnknownException,
-  ProcessingCancelledException,
-} from "../../../../core/exception";
-import { JobType } from "../../../../core/models/job_type";
-import { ProcessingConfigBuilder } from "../../dsl/builder/screens_builder";
-import type { FlowNavigationManager } from "../../flow_navigation_manager";
-import type { JobSubmissionState } from "../../job_submission_state";
-
-type Fn = ReturnType<typeof vi.fn>;
-
-type FakeManager = FlowNavigationManager & {
-  beginSubmissionIfNeeded: Fn;
-  retrySubmission: Fn;
-  navigateToNext: Fn;
-  exit: Fn;
-};
-
-type ManagerOverrides = {
-  readonly jobType?: number;
-  readonly submissionState?: JobSubmissionState;
-  readonly frontDocumentPath?: string;
-  readonly selfiePath?: string;
-  readonly documentFrameAspectRatio?: number;
-};
-
-function makeManager(overrides: ManagerOverrides = {}): FakeManager {
-  return {
-    beginSubmissionIfNeeded: vi.fn(),
-    retrySubmission: vi.fn(),
-    navigateToNext: vi.fn(),
-    navigateBack: vi.fn(),
-    exit: vi.fn(),
-    jobSubmissionState: overrides.submissionState ?? { kind: "notAttempted" },
-    documentFrameAspectRatio: overrides.documentFrameAspectRatio,
-    captured: {
-      ...(overrides.frontDocumentPath !== undefined
-        ? { frontDocumentPath: overrides.frontDocumentPath }
-        : {}),
-      ...(overrides.selfiePath !== undefined
-        ? { selfiePath: overrides.selfiePath }
-        : {}),
-    },
-    configuration: {
-      network:
-        overrides.jobType !== undefined
-          ? { config: { jobType: overrides.jobType } }
-          : undefined,
-    },
-  } as unknown as FakeManager;
-}
-
-function makeConfiguration(
-  overrides: Partial<ProcessingConfigBuilder> = {},
-): ProcessingConfigBuilder {
-  return Object.assign(new ProcessingConfigBuilder(), overrides);
-}
-
-function renderWith(
-  manager: FlowNavigationManager,
-  configuration: ProcessingConfigBuilder = makeConfiguration(),
-) {
-  act(() => {
-    createRenderer(
-      <FlowNavigationProvider manager={manager}>
-        <OrchestratedProcessingScreen configuration={configuration} />
-      </FlowNavigationProvider>,
-    );
-  });
-}
-
-beforeEach(() => {
-  screenProps.current = {};
-});
-
-describe("OrchestratedProcessingScreen — submission lifecycle", () => {
-  it("kicks off submission exactly once on mount", () => {
-    const manager = makeManager();
-    renderWith(manager);
-
-    expect(manager.beginSubmissionIfNeeded).toHaveBeenCalledTimes(1);
-  });
-
-  it("retry re-fires submission rather than navigating", () => {
-    const manager = makeManager({
-      submissionState: { kind: "failure", error: new Error("network down") },
-    });
-    renderWith(manager);
-
-    (screenProps.current.onRetry as () => void)();
-
-    expect(manager.retrySubmission).toHaveBeenCalledTimes(1);
-    expect(manager.navigateToNext).not.toHaveBeenCalled();
-  });
-
-  it("continue advances the flow", () => {
-    const manager = makeManager();
-    renderWith(manager);
-
-    (screenProps.current.onContinue as () => void)();
-
-    expect(manager.navigateToNext).toHaveBeenCalledTimes(1);
-  });
-
-  it("exit ends the flow with a typed ProcessingCancelledException", () => {
-    const manager = makeManager();
-    renderWith(manager);
-
-    (screenProps.current.onExit as () => void)();
-
-    const [[reason]] = manager.exit.mock.calls as [
-      [{ kind: string; error: unknown }],
-    ];
-    expect(reason.kind).toBe("failed");
-    expect(reason.error).toBeInstanceOf(ProcessingCancelledException);
-    expect(manager.navigateToNext).not.toHaveBeenCalled();
-  });
-
-  it("exit after a failed submission delivers that failure, not a cancellation", () => {
-    const submissionError = new Error("401 — invalid API key");
-    const manager = makeManager({
-      submissionState: { kind: "failure", error: submissionError },
-    });
-    renderWith(manager);
-
-    (screenProps.current.onExit as () => void)();
-
-    const [[reason]] = manager.exit.mock.calls as [
-      [{ kind: string; error: unknown }],
-    ];
-    expect(reason.kind).toBe("failed");
-    expect(reason.error).toBe(submissionError);
-  });
-
-  it("exit while the job is still in flight is a cancellation", () => {
-    const manager = makeManager({ submissionState: { kind: "loading" } });
-    renderWith(manager);
-
-    (screenProps.current.onExit as () => void)();
-
-    const [[reason]] = manager.exit.mock.calls as [
-      [{ kind: string; error: unknown }],
-    ];
-    expect(reason.error).toBeInstanceOf(ProcessingCancelledException);
-  });
-});
-
-describe("OrchestratedProcessingScreen — submission state mapping", () => {
-  it("shows loading during the pre-submission window so the card is never empty", () => {
-    renderWith(makeManager({ submissionState: { kind: "notAttempted" } }));
-    expect(screenProps.current.state).toEqual({ kind: "loading" });
-  });
-
-  it("shows loading while the job is in flight", () => {
-    renderWith(makeManager({ submissionState: { kind: "loading" } }));
-    expect(screenProps.current.state).toEqual({ kind: "loading" });
-  });
-
-  it("surfaces the server's message on success", () => {
-    renderWith(
-      makeManager({
-        submissionState: {
-          kind: "success",
-          response: {
-            userId: "user-1",
-            jobId: "job-1",
-            status: "approved",
-            message: "Job approved",
-          },
-        },
-      }),
-    );
-
-    expect(screenProps.current.state).toEqual({
-      kind: "success",
-      message: "Job approved",
-    });
-  });
-
-  it("surfaces the server's own text on a server failure", () => {
-    renderWith(
-      makeManager({
-        submissionState: {
-          kind: "failure",
-          error: new NetworkServerException({
-            statusCode: 401,
-            message: "Invalid token",
-          }),
-        },
-      }),
-    );
-
-    expect(screenProps.current.state).toEqual({
-      kind: "failed",
-      errorMessage: "Invalid token",
-    });
-  });
-
-  it("shows the no-connection copy on a transport failure", () => {
-    renderWith(
-      makeManager({
-        submissionState: {
-          kind: "failure",
-          error: new NetworkTransportException({ cause: new Error("ECONNREFUSED") }),
-        },
-      }),
-    );
-
-    expect(screenProps.current.state).toEqual({
-      kind: "failed",
-      errorMessage: "No internet connection.",
-    });
-  });
-
-  it("shows the generic copy for unknown network failures", () => {
-    renderWith(
-      makeManager({
-        submissionState: {
-          kind: "failure",
-          error: new NetworkUnknownException({
-            cause: new Error("ENOENT /data/user/0/…/selfie.jpg"),
-          }),
-        },
-      }),
-    );
-
-    expect(screenProps.current.state).toEqual({
-      kind: "failed",
-      errorMessage: "Something went wrong. Try again.",
-    });
-  });
-
-  it("surfaces the error message on other failures", () => {
-    renderWith(
-      makeManager({
-        submissionState: { kind: "failure", error: new Error("upload failed") },
-      }),
-    );
-
-    expect(screenProps.current.state).toEqual({
-      kind: "failed",
-      errorMessage: "upload failed",
-    });
-  });
-});
-
-describe("OrchestratedProcessingScreen — artifact rendering", () => {
-  it("renders the captured front document for a document job", () => {
-    renderWith(
-      makeManager({
-        jobType: JobType.documentVerification,
-        frontDocumentPath: "file:///front.jpg",
-        documentFrameAspectRatio: 1.586,
-      }),
-    );
-
-    expect(screenProps.current.documentImageUri).toBe("file:///front.jpg");
-    expect(screenProps.current.documentAspectRatio).toBeCloseTo(1.586, 5);
-    expect(screenProps.current.showFaceOval).toBe(true);
-  });
-
-  it("omits the document aspect ratio when the manager has none", () => {
-    renderWith(
-      makeManager({
-        jobType: JobType.documentVerification,
-        frontDocumentPath: "file:///front.jpg",
-      }),
-    );
-
-    expect(screenProps.current.documentImageUri).toBe("file:///front.jpg");
-    expect("documentAspectRatio" in screenProps.current).toBe(false);
-  });
-
-  it("ignores a captured document on a selfie-only job", () => {
-    renderWith(
-      makeManager({
-        jobType: JobType.smartSelfieEnrollment,
-        frontDocumentPath: "file:///front.jpg",
-        selfiePath: "file:///selfie.jpg",
-      }),
-    );
-
-    expect("documentImageUri" in screenProps.current).toBe(false);
-    expect(screenProps.current.capturedSelfiePath).toBe("file:///selfie.jpg");
-    expect(screenProps.current.showFaceOval).toBe(true);
-  });
-
-  it("hides the face oval for a job that captures neither", () => {
-    renderWith(makeManager({ jobType: JobType.enhancedKyc }));
-
-    expect(screenProps.current.showFaceOval).toBe(false);
-    expect("capturedSelfiePath" in screenProps.current).toBe(false);
-  });
-
-  it("treats a flow with no network config as the unknown job type", () => {
-    renderWith(makeManager());
-
-    expect(screenProps.current.showFaceOval).toBe(false);
-  });
-
-  it("forwards the partner's progress and attribution switches", () => {
-    renderWith(
-      makeManager(),
-      makeConfiguration({
-        showProgressPercentage: false,
-        showAttribution: false,
-      }),
-    );
-
-    expect(screenProps.current.showProgressPercentage).toBe(false);
-    expect(screenProps.current.showAttribution).toBe(false);
-  });
-});

package/src/presentation/flow/screen/helpers/__tests__/face_session_config.test.ts

@@ -1,115 +0,0 @@
-import { describe, expect, it } from "vitest";
-import type { FaceConfig } from "@smileid/usesmileid_bridge";
-import { EnhancedSmartSelfieConfig } from "@smileid/usesmileid_bridge";
-import { resolveFaceSessionConfig } from "../face_session_config";
-import type { SdkConfig } from "../../../../../data/model/sdk_config";
-
-const baseConfig: FaceConfig = {
-  analyzerFactoryKey: "mlkit-face",
-  selfieCaptureTimeout: 100_000,
-  numSamples: 8,
-  sampleInterval: 350,
-};
-
-describe("resolveFaceSessionConfig", () => {
-  it("keeps the profile-driven numSamples on the standard path", () => {
-    const resolved = resolveFaceSessionConfig(baseConfig, false);
-    expect(resolved.numSamples).toBe(8);
-    expect(resolved.enableEnhancedLiveness).toBe(false);
-  });
-
-  it("forces numSamples to the hold-still count under Enhanced Smart Selfie", () => {
-    // The native session adds the head-turn stills on top of numSamples.
-    const resolved = resolveFaceSessionConfig(baseConfig, true);
-    expect(resolved.numSamples).toBe(
-      EnhancedSmartSelfieConfig.HOLD_STILL_SAMPLE_COUNT,
-    );
-    expect(resolved.enableEnhancedLiveness).toBe(true);
-  });
-
-  it("preserves every other field of the base config", () => {
-    const resolved = resolveFaceSessionConfig(baseConfig, true);
-    expect(resolved.analyzerFactoryKey).toBe("mlkit-face");
-    expect(resolved.selfieCaptureTimeout).toBe(100_000);
-    expect(resolved.sampleInterval).toBe(350);
-  });
-
-  it("does not mutate the base config", () => {
-    resolveFaceSessionConfig(baseConfig, true);
-    expect(baseConfig.numSamples).toBe(8);
-    expect(baseConfig.enableEnhancedLiveness).toBeUndefined();
-  });
-});
-
-describe("resolveFaceSessionConfig — sdk_config overrides", () => {
-  const sdkConfig: SdkConfig = {
-    selfie: { width: 640, height: 480, quality: 90 },
-    liveness: { width: 320, height: 240, quality: 70 },
-    livenessImageCount: 5,
-  };
-
-  it("applies selfie dimensions from sdk_config", () => {
-    const resolved = resolveFaceSessionConfig(baseConfig, false, sdkConfig);
-    expect(resolved.selfieImageWidth).toBe(640);
-    expect(resolved.selfieImageHeight).toBe(480);
-  });
-
-  it("applies selfie JPEG quality from sdk_config", () => {
-    const resolved = resolveFaceSessionConfig(baseConfig, false, sdkConfig);
-    expect(resolved.selfieJpegQuality).toBe(90);
-  });
-
-  it("applies liveness dimensions from sdk_config", () => {
-    const resolved = resolveFaceSessionConfig(baseConfig, false, sdkConfig);
-    expect(resolved.livenessImageWidth).toBe(320);
-    expect(resolved.livenessImageHeight).toBe(240);
-  });
-
-  it("applies liveness JPEG quality from sdk_config", () => {
-    const resolved = resolveFaceSessionConfig(baseConfig, false, sdkConfig);
-    expect(resolved.livenessJpegQuality).toBe(70);
-  });
-
-  it("applies livenessImageCount as numSamples (+1) when not ESS", () => {
-    // livenessImageCount: 5 → numSamples = 6
-    const resolved = resolveFaceSessionConfig(baseConfig, false, sdkConfig);
-    expect(resolved.numSamples).toBe(6);
-  });
-
-  it("suppresses livenessImageCount override under Enhanced Smart Selfie", () => {
-    // ESS manages its own capture count — the sdk_config override must
-    // not bleed through and change numSamples.
-    const resolved = resolveFaceSessionConfig(baseConfig, true, sdkConfig);
-    expect(resolved.numSamples).toBe(
-      EnhancedSmartSelfieConfig.HOLD_STILL_SAMPLE_COUNT,
-    );
-  });
-
-  it("omits selfie dimension fields when the pair rule fails (width-only)", () => {
-    const halfConfig: SdkConfig = { selfie: { width: 640 } };
-    const resolved = resolveFaceSessionConfig(baseConfig, false, halfConfig);
-    expect(resolved.selfieImageWidth).toBeUndefined();
-    expect(resolved.selfieImageHeight).toBeUndefined();
-  });
-
-  it("falls back to base numSamples when livenessImageCount is absent", () => {
-    const noCount: SdkConfig = { selfie: { quality: 85 } };
-    const resolved = resolveFaceSessionConfig(baseConfig, false, noCount);
-    // Base config has numSamples: 8 — should be preserved.
-    expect(resolved.numSamples).toBe(8);
-  });
-
-  it("does not set dimension fields when sdk_config is undefined", () => {
-    const resolved = resolveFaceSessionConfig(baseConfig, false, undefined);
-    expect(resolved.selfieImageWidth).toBeUndefined();
-    expect(resolved.selfieImageHeight).toBeUndefined();
-    expect(resolved.livenessImageWidth).toBeUndefined();
-    expect(resolved.livenessImageHeight).toBeUndefined();
-  });
-
-  it("does not mutate the base config when sdk_config is supplied", () => {
-    resolveFaceSessionConfig(baseConfig, false, sdkConfig);
-    expect(baseConfig.numSamples).toBe(8);
-    expect(baseConfig.selfieImageWidth).toBeUndefined();
-  });
-});

package/src/presentation/flow/screen/helpers/face_session_config.ts

@@ -1,77 +0,0 @@
-import type { FaceConfig } from "@smileid/usesmileid_bridge";
-import { enhancedSmartSelfieNumSamples } from "@smileid/usesmileid_bridge";
-import type { SdkConfig } from "../../../../data/model/sdk_config";
-import { numSamplesOverride } from "../../../../data/model/sdk_config";
-import {
-  resolveDimensions,
-  resolveJpegQuality,
-} from "../../../../data/model/sdk_config_capture";
-
-/**
- * Merge the screen-level Enhanced Smart Selfie flag and any decoded
- * `sdk_config` settings into the registry-built base config.
- *
- * Applied overrides (when `sdkConfig` is present):
- *   - Selfie capture dimensions (`selfieImageWidth` / `selfieImageHeight`):
- *     pair-fallback rule — both must be present and `> 0`.
- *   - Selfie JPEG quality (`selfieJpegQuality`): integer `1..100`.
- *   - Liveness capture dimensions (`livenessImageWidth` / `livenessImageHeight`):
- *     same pair rule.
- *   - Liveness JPEG quality (`livenessJpegQuality`): integer `1..100`.
- *   - `numSamples` from `livenessImageCount + 1`: suppressed when ESS is
- *     active (head-turn manages its own count). Falls back to the base
- *     config's `numSamples` (set from `ScanPerformanceProfile`) when the
- *     claim is absent or invalid.
- *
- * `faceConfigSchema` re-applies the ESS frame-count pin at every
- * `configure()` boundary, so direct `analyzer.configure()` callers are
- * equally safe; applying the pin here keeps the orchestrator's resolved
- * config honest for logging and tests.
- */
-export function resolveFaceSessionConfig(
-  baseConfig: FaceConfig,
-  enableEnhancedLiveness: boolean,
-  sdkConfig?: SdkConfig,
-): FaceConfig {
-  const selfieDims = resolveDimensions(sdkConfig?.selfie);
-  const livenessDims = resolveDimensions(sdkConfig?.liveness);
-  const selfieQuality = resolveJpegQuality(sdkConfig?.selfie);
-  const livenessQuality = resolveJpegQuality(sdkConfig?.liveness);
-
-  // Suppress the liveness-count override when ESS is active — the
-  // head-turn flow manages its own capture count internally.
-  const resolvedNumSamples =
-    (!enableEnhancedLiveness ? numSamplesOverride(sdkConfig) : undefined) ??
-    baseConfig.numSamples;
-
-  return enhancedSmartSelfieNumSamples({
-    ...baseConfig,
-    enableEnhancedLiveness,
-    // Selfie dimensions — spread only when the pair resolves.
-    ...(selfieDims !== undefined
-      ? {
-          selfieImageWidth: selfieDims.width,
-          selfieImageHeight: selfieDims.height,
-        }
-      : {}),
-    // Selfie JPEG quality — spread only when the value is in range.
-    ...(selfieQuality !== undefined
-      ? { selfieJpegQuality: selfieQuality }
-      : {}),
-    // Liveness dimensions — spread only when the pair resolves.
-    ...(livenessDims !== undefined
-      ? {
-          livenessImageWidth: livenessDims.width,
-          livenessImageHeight: livenessDims.height,
-        }
-      : {}),
-    // Liveness JPEG quality — spread only when the value is in range.
-    ...(livenessQuality !== undefined
-      ? { livenessJpegQuality: livenessQuality }
-      : {}),
-    // numSamples from sdk_config (suppressed for ESS; falls back to profile).
-    ...(resolvedNumSamples !== undefined
-      ? { numSamples: resolvedNumSamples }
-      : {}),
-  });
-}