@smileid/usesmileid 12.0.0 → 12.0.1

package/src/metadata/__tests__/metadata_configuration_mappers.test.ts

@@ -12,6 +12,7 @@ import {
   ModelProvider,
   MODEL_DESCRIPTOR_UNKNOWN,
 } from "../model_configuration";
+import { GlobalPrivacyControl } from "../../core/models/global_privacy_control";
 import {
   flowConfigurationToBuilderConfiguration,
   flowConfigurationToModelConfiguration,
@@ -201,6 +202,21 @@ describe("flowConfigurationToSelfieLivenessTelemetry", () => {
     expect(telemetry.activeLivenessType).toBe("head_pose");
   });
 
+  it("reports back_camera in agent mode", () => {
+    const telemetry = flowConfigurationToSelfieLivenessTelemetry(
+      flow((screens) =>
+        screens.capture((capture) => {
+          capture.captureType = CaptureType.selfie;
+          capture.selfie((selfie) => {
+            selfie.allowAgentMode = true;
+          });
+        }),
+      ),
+    );
+    expect(telemetry.selfieImageOrigin).toBe("back_camera");
+    expect(telemetry.activeLivenessType).toBe("smile");
+  });
+
   it("is all-null for a document-only flow", () => {
     const telemetry = flowConfigurationToSelfieLivenessTelemetry(
       flow((screens) =>
@@ -212,4 +228,27 @@ describe("flowConfigurationToSelfieLivenessTelemetry", () => {
     expect(telemetry.activeLivenessType).toBeNull();
     expect(telemetry.selfieImageOrigin).toBeNull();
   });
+
+  it("global privacy control lands in the configuration metadata", () => {
+    // Default posture: a snapshot without a config block reports the
+    // opt-out baseline.
+    expect(
+      flowConfigurationToBuilderConfiguration(flow(() => {}))
+        .globalPrivacyControl,
+    ).toBe("opt-out");
+
+    // Explicit legacy posture flows through the config snapshot.
+    const optIn: FlowConfiguration = {
+      ...flow(() => {}),
+      config: {
+        enableCrashReporting: true,
+        enableDebugMode: false,
+        allowOfflineMode: false,
+        globalPrivacyControl: GlobalPrivacyControl.OptIn,
+      },
+    };
+    expect(
+      flowConfigurationToBuilderConfiguration(optIn).globalPrivacyControl,
+    ).toBe("opt-in");
+  });
 });

package/src/metadata/__tests__/metadata_configuration_objects.test.ts

@@ -25,6 +25,7 @@ const builderConfiguration: BuilderConfiguration = {
   allowGalleryUpload: true,
   captureBothSides: true,
   allowSkipBack: false,
+  globalPrivacyControl: "opt-out",
 };
 
 const modelConfiguration: ModelConfiguration = {
@@ -37,7 +38,7 @@ const modelConfiguration: ModelConfiguration = {
   documentModel: {
     provider: ModelProvider.Smile,
     name: "noop_document_detector",
-    version: "12.0.0",
+    version: "12.0.1",
     bundled: true,
   },
 };

package/src/metadata/__tests__/metadata_device_context.test.ts

@@ -9,7 +9,7 @@ function fields(
   overrides: Partial<UseSmileIDMetadataFields> = {},
 ): UseSmileIDMetadataFields {
   return {
-    sdkVersion: "12.0.0",
+    sdkVersion: "12.0.1",
     sdk: "react-native-expo",
     deviceOs: "Android 14",
     deviceModel: "",
@@ -89,10 +89,10 @@ describe("device-context keys (62-key parity)", () => {
   it("emits wrapper identity when present and omits it when blank", () => {
     const populated = fields({
       wrapperName: "react_native_expo",
-      wrapperVersion: "12.0.0",
+      wrapperVersion: "12.0.1",
     });
     expect(value("wrapper_name", populated)).toBe("react_native_expo");
-    expect(value("wrapper_version", populated)).toBe("12.0.0");
+    expect(value("wrapper_version", populated)).toBe("12.0.1");
 
     const names = new UseSmileIDMetadata(fields())
       .toEntries()

package/src/metadata/__tests__/metadata_device_os_android.test.ts

@@ -0,0 +1,18 @@
+import { describe, expect, it, vi } from "vitest";
+
+vi.mock("react-native", () => ({
+  Platform: { OS: "android", Version: 31, constants: { Release: "12" } },
+  Dimensions: {
+    get: () => ({ width: 1080, height: 2400, scale: 3 }),
+  },
+}));
+
+import { UseSmileIDMetadataFactory } from "../use_smile_id_metadata_factory";
+
+describe("device_os on Android", () => {
+  it("reports the release version, not the API level", () => {
+    const factory = new UseSmileIDMetadataFactory();
+
+    expect(factory.make().toFields().deviceOs).toBe("Android 12");
+  });
+});

package/src/metadata/__tests__/metadata_golden_fixture.json

@@ -1,7 +1,7 @@
 {
   "_comment": "Shared cross-SDK golden parity vectors. These metadata keys must serialise to the EXACT same wire value on Android, iOS, Flutter, and React Native for the standard fully-populated golden snapshot. Each SDK's metadata-payload golden test asserts its payload contains every entry below verbatim. Maintained manually — keep the four copies (android/ios/flutter/react-native-expo test dirs) in sync.",
   "expected": {
-    "sdk_version": "12.0.0",
+    "sdk_version": "12.0.1",
     "proxy": "true",
     "proximity_sensor": "true",
     "sdk_config_source": "sdk_config",

package/src/metadata/__tests__/metadata_payload_golden.test.ts

@@ -17,7 +17,7 @@ import goldenFixture from "./metadata_golden_fixture.json";
 describe("metadata payload (golden, device-context fields)", () => {
   function fullyPopulated(): UseSmileIDMetadataFields {
     return {
-      sdkVersion: "12.0.0",
+      sdkVersion: "12.0.1",
       sdk: "react-native-expo",
       deviceOs: "Android 14",
       deviceModel: "Google Pixel 8",
@@ -56,7 +56,7 @@ describe("metadata payload (golden, device-context fields)", () => {
       vpn: false,
       certificateDigest: ["AA:BB", "CC:DD"],
       wrapperName: "react_native_expo",
-      wrapperVersion: "12.0.0",
+      wrapperVersion: "12.0.1",
       sdkLaunchCount: 5,
       geolocation: {
         latitude: 1.5,
@@ -128,7 +128,7 @@ describe("metadata payload (golden, device-context fields)", () => {
 
   it("emits scalar + meaningful-falsey + JSON-shaped values correctly", () => {
     const map = entriesOf(fullyPopulated());
-    expect(map.get("sdk_version")).toBe("12.0.0");
+    expect(map.get("sdk_version")).toBe("12.0.1");
     expect(map.get("proxy")).toBe("true");
     expect(map.get("battery_status")).toBe("0"); // 0 is meaningful
     expect(map.get("sdk_config_source")).toBe("sdk_config");
@@ -153,7 +153,7 @@ describe("metadata payload (golden, device-context fields)", () => {
 
   it("default snapshot emits only the always-present keys", () => {
     const minimal: UseSmileIDMetadataFields = {
-      sdkVersion: "12.0.0",
+      sdkVersion: "12.0.1",
       sdk: "react-native-expo",
       deviceOs: "Android 14",
       deviceModel: "",

package/src/metadata/__tests__/use_smile_id_metadata.test.ts

@@ -23,7 +23,7 @@ import { SdkConfigSource } from "../../data/model/sdk_config_source";
 // survive `toEntries()` from this fixture are the truly-always-present ones
 // (SDK constants, sessionId, sdk_config_source).
 const baseFields: UseSmileIDMetadataFields = Object.freeze({
-  sdkVersion: "12.0.0",
+  sdkVersion: "12.0.1",
   sdk: "react-native-expo",
   deviceOs: "",
   deviceModel: "",

package/src/metadata/builder_configuration.ts

@@ -32,6 +32,11 @@ export type BuilderConfiguration = {
   readonly allowGalleryUpload: boolean;
   readonly captureBothSides: boolean;
   readonly allowSkipBack: boolean;
+  /**
+   * Partner-declared GPC posture ("opt-out" / "opt-in") — the consent
+   * layout every session ran under.
+   */
+  readonly globalPrivacyControl: string;
 };
 
 /**
@@ -59,5 +64,6 @@ export function builderConfigurationToJson(
     allow_gallery_upload: configuration.allowGalleryUpload,
     capture_both_sides: configuration.captureBothSides,
     allow_skip_back: configuration.allowSkipBack,
+    global_privacy_control: configuration.globalPrivacyControl,
   };
 }

package/src/metadata/metadata_configuration_mappers.ts

@@ -1,3 +1,4 @@
+import { GlobalPrivacyControl } from "../core/models/global_privacy_control";
 import { AnalyzerFactoryKey } from "@smileid/usesmileid_bridge";
 
 import { CaptureType } from "../core/models/ml_config";
@@ -89,6 +90,8 @@ export function flowConfigurationToBuilderConfiguration(
     allowGalleryUpload: document?.allowGalleryUpload ?? false,
     captureBothSides: document?.captureBothSides ?? false,
     allowSkipBack: document?.allowSkipBack ?? false,
+    globalPrivacyControl:
+      configuration.config?.globalPrivacyControl ?? GlobalPrivacyControl.OptOut,
   };
 }
 
@@ -165,14 +168,13 @@ type SelfieLivenessTelemetry =
 
 /**
  * Flow-derived selfie liveness telemetry. All-`null` for flows without a selfie
- * capture; otherwise the active-liveness check (`head_pose` when enhanced
- * liveness is on, else `smile`), the version, and the selfie origin (always
- * `front_camera` — the selfie SDK has no gallery path).
+ * capture; otherwise the active-liveness check, the version, and the lens the
+ * selfie came from (the selfie SDK has no gallery path).
  */
 export function flowConfigurationToSelfieLivenessTelemetry(
   configuration: FlowConfiguration,
 ): SelfieLivenessTelemetry {
-  let selfie: { enableEnhancedLiveness: boolean } | undefined;
+  let selfie: SelfieLivenessSource;
   let hasSelfieCapture = false;
   for (const step of configuration.screens.steps) {
     if (step.kind === "capture") {
@@ -190,12 +192,24 @@ export function flowConfigurationToSelfieLivenessTelemetry(
     };
   }
   return {
-    activeLivenessType: selfie?.enableEnhancedLiveness ? "head_pose" : "smile",
+    activeLivenessType: activeLivenessTypeOf(selfie),
     activeLivenessVersion: "2.0.0",
-    selfieImageOrigin: "front_camera",
+    selfieImageOrigin: selfieImageOriginOf(selfie),
   };
 }
 
+type SelfieLivenessSource =
+  | { enableEnhancedLiveness: boolean; allowAgentMode?: boolean }
+  | undefined;
+
+function activeLivenessTypeOf(selfie: SelfieLivenessSource): string {
+  return selfie?.enableEnhancedLiveness ? "head_pose" : "smile";
+}
+
+function selfieImageOriginOf(selfie: SelfieLivenessSource): string {
+  return selfie?.allowAgentMode ? "back_camera" : "front_camera";
+}
+
 function faceDescriptorOf(
   key: AnalyzerFactoryKey | undefined,
 ): ModelDescriptor {
@@ -229,6 +243,6 @@ function faceDescriptorOf(
 const NOOP_DOCUMENT_DESCRIPTOR: ModelDescriptor = {
   provider: ModelProvider.Smile,
   name: "noop_document_detector",
-  version: "12.0.0",
+  version: "12.0.1",
   bundled: true,
 };

package/src/metadata/use_smile_id_metadata_factory.ts

@@ -61,7 +61,7 @@ import { CameraDefaults } from "../camera/camera_defaults";
 
 // Beta release version reported to the backend as `sdk_version`. Keep in sync
 // with the `version` field across the published package.json files.
-const SDK_VERSION = "12.0.0";
+const SDK_VERSION = "12.0.1";
 // The security-policy axis is versioned independently of the SDK release tag,
 // so it stays at the base `12.0.0` (not the prerelease tag).
 const SECURITY_POLICY_VERSION = "12.0.0";
@@ -468,20 +468,31 @@ export class UseSmileIDMetadataFactory implements MetadataProvider {
 // --- field resolvers --------------------------------------------------------
 
 function resolveDeviceOs(): string {
-  // Human-readable string with platform name + version. Examples:
-  //   "iOS 17.4"
-  //   "Android 14"
+  // `"iOS 17.4"` / `"Android 12"` — the shape the native EXIF tagger stamps.
   const platform =
     Platform.OS === "ios"
       ? "iOS"
       : Platform.OS === "android"
         ? "Android"
         : Platform.OS;
-  const version =
-    typeof Platform.Version !== "undefined" ? String(Platform.Version) : "";
+  const version = resolveOsVersion();
   return version ? `${platform} ${version}` : platform;
 }
 
+function resolveOsVersion(): string {
+  if (Platform.OS === "android") {
+    const release = (
+      Platform.constants as { Release?: string | number } | undefined
+    )?.Release;
+    if (release !== undefined && release !== null && `${release}` !== "") {
+      return `${release}`;
+    }
+  }
+  return typeof Platform.Version !== "undefined"
+    ? String(Platform.Version)
+    : "";
+}
+
 function resolveLocalTimeOfEnrolment(): string {
   try {
     return new Date().toISOString();