@smileid/usesmileid 12.0.1 → 12.1.0

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

@@ -1,193 +0,0 @@
-import { describe, expect, it } from "vitest";
-
-import {
-  UseSmileIDMetadata,
-  type UseSmileIDMetadataFields,
-} from "../use_smile_id_metadata";
-import goldenFixture from "./metadata_golden_fixture.json";
-
-/**
- * Golden check that a fully-populated `UseSmileIDMetadata` emits the device-context payload with the
- * right value shapes, and that a default snapshot emits only the always-present keys.
- *
- * Capture-telemetry / document-origin / config-object keys ride as flow-manager `extraEntries`
- * (verified in `document_flow_navigation.test.ts`); this suite covers the field-based device-context
- * keys, using the same inputs/expected values as the sibling Android / iOS / Flutter golden suites.
- */
-describe("metadata payload (golden, device-context fields)", () => {
-  function fullyPopulated(): UseSmileIDMetadataFields {
-    return {
-      sdkVersion: "12.0.1",
-      sdk: "react-native-expo",
-      deviceOs: "Android 14",
-      deviceModel: "Google Pixel 8",
-      appName: "TestApp",
-      sessionId: "session-123",
-      clientIp: "192.168.1.5",
-      networkConnection: "wifi",
-      carrierInfo: "MTN",
-      proxy: true,
-      timezone: "Africa/Lagos",
-      locale: "en_NG",
-      screenResolution: "1080x2400",
-      memoryInfoMb: 7777,
-      deviceOrientation: "portrait",
-      systemArchitecture: "arm64-v8a",
-      numberOfCameras: 3,
-      hostApplication: "TestApp v1.2",
-      proximitySensor: true,
-      securityPolicyVersion: "12.0.0",
-      sdkConfigSource: "sdk_config",
-      imageWidth: 480,
-      imageHeight: 640,
-      livenessImageWidth: 320,
-      livenessImageHeight: 240,
-      timezoneOffsetMinutes: 60,
-      buildBrand: "Google",
-      buildDevice: "husky",
-      buildFingerprint: "google/husky:14",
-      buildProduct: "husky",
-      buildHardware: "husky",
-      buildSource: "com.android.vending",
-      packageName: "com.partner.app",
-      fingerprint: "android-id-123",
-      localTimeOfEnrolment: "2026-06-24T10:00:00.000+03:00",
-      batteryStatus: 0,
-      vpn: false,
-      certificateDigest: ["AA:BB", "CC:DD"],
-      wrapperName: "react_native_expo",
-      wrapperVersion: "12.0.1",
-      sdkLaunchCount: 5,
-      geolocation: {
-        latitude: 1.5,
-        longitude: -2.5,
-        accuracy: "precise",
-        source: "gps",
-      },
-      privileges: '{"1":"100010","8":"100100"}',
-    };
-  }
-
-  function entriesOf(fields: UseSmileIDMetadataFields): Map<string, string> {
-    return new Map(
-      new UseSmileIDMetadata(fields).toEntries().map((e) => [e.name, e.value]),
-    );
-  }
-
-  // Field-based device-context keys the fully-populated payload must emit.
-  const expectedKeys = [
-    "sdk_version",
-    "sdk",
-    "device_os",
-    "device_model",
-    "app_name",
-    "session_id",
-    "proxy",
-    "proximity_sensor",
-    "sdk_config_source",
-    "client_ip",
-    "network_connection",
-    "carrier_info",
-    "timezone",
-    "locale",
-    "screen_resolution",
-    "device_orientation",
-    "system_architecture",
-    "host_application",
-    "security_policy_version",
-    "selfie_image_dimensions",
-    "liveness_image_dimensions",
-    "timezone_offset",
-    "memory_info",
-    "number_of_cameras",
-    "build_brand",
-    "build_device",
-    "build_fingerprint",
-    "build_product",
-    "build_hardware",
-    "build_source",
-    "package_name",
-    "fingerprint",
-    "local_time_of_enrolment",
-    "battery_status",
-    "vpn",
-    "certificate_digest",
-    "wrapper_name",
-    "wrapper_version",
-    "sdk_launch_count",
-    "geolocation",
-    "privileges",
-  ];
-
-  it("emits every expected device-context key", () => {
-    const map = entriesOf(fullyPopulated());
-    for (const key of expectedKeys) {
-      expect(map.has(key), `missing key: ${key}`).toBe(true);
-    }
-  });
-
-  it("emits scalar + meaningful-falsey + JSON-shaped values correctly", () => {
-    const map = entriesOf(fullyPopulated());
-    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");
-    expect(map.get("wrapper_name")).toBe("react_native_expo");
-    expect(map.get("privileges")).toBe('{"1":"100010","8":"100100"}'); // verbatim
-    expect(map.get("vpn")).toBe("false"); // false is meaningful
-    expect(map.get("fingerprint")).toBe("android-id-123");
-    expect(map.get("package_name")).toBe("com.partner.app");
-    expect(JSON.parse(map.get("certificate_digest")!)).toEqual([
-      "AA:BB",
-      "CC:DD",
-    ]);
-    expect(JSON.parse(map.get("geolocation")!).accuracy).toBe("precise");
-  });
-
-  it("matches the cross-SDK parity fixture values", () => {
-    const map = entriesOf(fullyPopulated());
-    for (const [key, value] of Object.entries(goldenFixture.expected)) {
-      expect(map.get(key), `cross-SDK parity mismatch for ${key}`).toBe(value);
-    }
-  });
-
-  it("default snapshot emits only the always-present keys", () => {
-    const minimal: UseSmileIDMetadataFields = {
-      sdkVersion: "12.0.1",
-      sdk: "react-native-expo",
-      deviceOs: "Android 14",
-      deviceModel: "",
-      appName: "App",
-      sessionId: "s",
-      clientIp: "",
-      networkConnection: "",
-      carrierInfo: "",
-      timezone: "",
-      locale: "",
-      screenResolution: "",
-      memoryInfoMb: 0,
-      deviceOrientation: "",
-      systemArchitecture: "",
-      numberOfCameras: 0,
-      hostApplication: "",
-      securityPolicyVersion: "",
-      sdkConfigSource: "default",
-      imageWidth: 0,
-      imageHeight: 0,
-      livenessImageWidth: 0,
-      livenessImageHeight: 0,
-    };
-    const keys = new Set(entriesOf(minimal).keys());
-    // device_model is "" here so it omits; the rest of the required identity keys + source.
-    expect(keys.has("sdk_version")).toBe(true);
-    expect(keys.has("sdk_config_source")).toBe(true);
-    // Never-measured booleans → omitted rather than an inaccurate false.
-    expect(keys.has("proxy")).toBe(false);
-    expect(keys.has("proximity_sensor")).toBe(false);
-    // Optionals absent → omitted.
-    expect(keys.has("build_brand")).toBe(false);
-    expect(keys.has("geolocation")).toBe(false);
-    expect(keys.has("privileges")).toBe(false);
-    expect(keys.has("battery_status")).toBe(false);
-  });
-});

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

@@ -1,430 +0,0 @@
-import { describe, expect, it, vi, beforeEach } from "vitest";
-
-vi.mock("react-native", () => ({
-  Platform: { OS: "ios", Version: "17.4" },
-  Dimensions: {
-    get: (kind: "screen" | "window") =>
-      kind === "screen"
-        ? { width: 390, height: 844, scale: 3 }
-        : { width: 390, height: 844, scale: 3 },
-  },
-}));
-
-import {
-  UseSmileIDMetadata,
-  type UseSmileIDMetadataFields,
-} from "../use_smile_id_metadata";
-import { UseSmileIDMetadataFactory } from "../use_smile_id_metadata_factory";
-import type { SdkConfig } from "../../data/model/sdk_config";
-import { SdkConfigSource } from "../../data/model/sdk_config_source";
-
-// Minimum baseline — every conditional field empty / zero and the measured
-// booleans (proxy, proximitySensor) left undefined. The only fields that
-// 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.1",
-  sdk: "react-native-expo",
-  deviceOs: "",
-  deviceModel: "",
-  appName: "",
-  sessionId: "abc-123",
-  clientIp: "",
-  networkConnection: "",
-  carrierInfo: "",
-  timezone: "",
-  locale: "",
-  screenResolution: "",
-  memoryInfoMb: 0,
-  deviceOrientation: "",
-  systemArchitecture: "",
-  numberOfCameras: 0,
-  hostApplication: "",
-  securityPolicyVersion: "12.0.0",
-  // sdk_config provenance — always-present (non-empty by construction).
-  sdkConfigSource: SdkConfigSource.defaultSource,
-  // Dimensions — zero in baseline fixture → omitted from entries.
-  imageWidth: 0,
-  imageHeight: 0,
-  livenessImageWidth: 0,
-  livenessImageHeight: 0,
-});
-
-describe("UseSmileIDMetadata.toEntries — standardized multipart wire format", () => {
-  it("always emits the always-present fields, including device_os / device_model / app_name even when empty", () => {
-    // `device_os`, `device_model`, and `app_name` are part of the
-    // always-present field set: they are emitted unconditionally (even
-    // when empty), alongside the SDK constants and the session UUID.
-    // `sdk_config_source` is also always-present. The measured booleans
-    // (proxy, proximity_sensor) are undefined in the baseline → omitted.
-    const meta = new UseSmileIDMetadata(baseFields);
-    const names = meta.toEntries().map((e) => e.name);
-    expect(names).toEqual([
-      "sdk_version",
-      "sdk",
-      "device_os",
-      "device_model",
-      "app_name",
-      "session_id",
-      "security_policy_version",
-      "sdk_config_source",
-    ]);
-  });
-
-  it("emits device_os / device_model / app_name when populated", () => {
-    // Same fields that drop on empty must appear when populated —
-    // exact placement preserved (between `sdk` and `session_id`).
-    const meta = new UseSmileIDMetadata({
-      ...baseFields,
-      deviceOs: "iOS 17.4",
-      deviceModel: "Apple iPhone",
-      appName: "AcmeApp",
-    });
-    const names = meta.toEntries().map((e) => e.name);
-    expect(names).toEqual([
-      "sdk_version",
-      "sdk",
-      "device_os",
-      "device_model",
-      "app_name",
-      "session_id",
-      "security_policy_version",
-      "sdk_config_source",
-    ]);
-  });
-
-  it("omits empty conditional strings (concrete scenario: emulator with no carrier)", () => {
-    const meta = new UseSmileIDMetadata({
-      ...baseFields,
-      timezone: "",
-      locale: "",
-      carrierInfo: "",
-    });
-    const names = meta.toEntries().map((e) => e.name);
-    expect(names).not.toContain("timezone");
-    expect(names).not.toContain("locale");
-    expect(names).not.toContain("carrier_info");
-  });
-
-  it("omits zero-valued conditional integers (memory_info, number_of_cameras)", () => {
-    // Concrete scenario: RN can't read `memory_info` without
-    // `expo-device` so the default is 0. The wire format must NOT
-    // ship `memory_info: 0` — it should be absent. Pin the contract.
-    const meta = new UseSmileIDMetadata({
-      ...baseFields,
-      memoryInfoMb: 0,
-      numberOfCameras: 0,
-    });
-    const names = meta.toEntries().map((e) => e.name);
-    expect(names).not.toContain("memory_info");
-    expect(names).not.toContain("number_of_cameras");
-  });
-
-  it("emits non-empty conditionals between the identity block and the trailer", () => {
-    const meta = new UseSmileIDMetadata({
-      ...baseFields,
-      // Populate the upper-conditional triple so the canonical
-      // "fully populated" order shows.
-      deviceOs: "iOS 17.4",
-      deviceModel: "Apple iPhone",
-      appName: "AcmeApp",
-      timezone: "America/New_York",
-      locale: "en-US",
-      memoryInfoMb: 4096,
-      numberOfCameras: 2,
-    });
-    const names = meta.toEntries().map((e) => e.name);
-    expect(names).toEqual([
-      "sdk_version",
-      "sdk",
-      "device_os",
-      "device_model",
-      "app_name",
-      "session_id",
-      "timezone",
-      "locale",
-      "memory_info",
-      "number_of_cameras",
-      "security_policy_version",
-      "sdk_config_source",
-    ]);
-  });
-
-  it('stringifies booleans as "true" / "false" (wire-format contract)', () => {
-    // Concrete scenario: a JSON parser receiving native bool would
-    // need a different schema than other entries. The wire contract
-    // is `value: string` for every entry; booleans are stringified.
-    const meta = new UseSmileIDMetadata({
-      ...baseFields,
-      proxy: true,
-      proximitySensor: false,
-    });
-    const entries = meta.toEntries();
-    expect(entries.find((e) => e.name === "proxy")).toEqual({
-      name: "proxy",
-      value: "true",
-    });
-    expect(entries.find((e) => e.name === "proximity_sensor")).toEqual({
-      name: "proximity_sensor",
-      value: "false",
-    });
-  });
-
-  it("returns a frozen array — partners can`t mutate the snapshot", () => {
-    const meta = new UseSmileIDMetadata(baseFields);
-    const entries = meta.toEntries();
-    expect(Object.isFrozen(entries)).toBe(true);
-  });
-});
-
-describe("UseSmileIDMetadataFactory", () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
-  it("caches sessionId across make() calls — one session per factory", () => {
-    // Concrete scenario: a flow makes auth → submit → status calls in
-    // sequence. All three must carry the SAME session_id so partner
-    // analytics can correlate them.
-    const factory = new UseSmileIDMetadataFactory();
-    const a = factory.make().toFields().sessionId;
-    const b = factory.make().toFields().sessionId;
-    expect(a).toBe(b);
-    expect(a).toMatch(/[0-9a-f-]{8,}/);
-  });
-
-  it("mints a new sessionId for a new factory instance", () => {
-    const f1 = new UseSmileIDMetadataFactory();
-    const f2 = new UseSmileIDMetadataFactory();
-    expect(f1.make().toFields().sessionId).not.toBe(
-      f2.make().toFields().sessionId,
-    );
-  });
-
-  it("resolves device_os from Platform.OS + Platform.Version", () => {
-    const factory = new UseSmileIDMetadataFactory();
-    expect(factory.make().toFields().deviceOs).toBe("iOS 17.4");
-  });
-
-  it('always emits sdk = "react-native-expo" — matches the auth header `smileid-source-sdk`', () => {
-    // Concrete scenario: partner analytics groups submissions by
-    // SDK identifier. Drift on this value would split the RN bucket
-    // across multiple identifiers (e.g. metadata says `react_native`
-    // while the auth header says `react-native-expo` — same fleet,
-    // two buckets).
-    const factory = new UseSmileIDMetadataFactory();
-    expect(factory.make().toFields().sdk).toBe("react-native-expo");
-  });
-
-  it("resolves screen_resolution as physical pixels with the × separator", () => {
-    // Format: `<w> × <h>` with the U+00D7 multiplication sign
-    // (not ASCII `x`). Pin so a future refactor doesn't accidentally
-    // use ASCII.
-    const factory = new UseSmileIDMetadataFactory();
-    expect(factory.make().toFields().screenResolution).toBe("1170 × 2532");
-  });
-
-  it("resolves device_orientation from Dimensions(window) aspect", () => {
-    const factory = new UseSmileIDMetadataFactory();
-    expect(factory.make().toFields().deviceOrientation).toBe("Portrait");
-  });
-
-  it("passes appName / hostApplication through from constructor options", () => {
-    const factory = new UseSmileIDMetadataFactory({
-      appName: "AcmeApp",
-      hostApplication: "AcmeApp v2.0.1",
-    });
-    const f = factory.make().toFields();
-    expect(f.appName).toBe("AcmeApp");
-    expect(f.hostApplication).toBe("AcmeApp v2.0.1");
-  });
-
-  it("produces a wire-format array that drops empty / zero fields", () => {
-    // End-to-end: the factory's defaults leave several fields empty
-    // (no native-bridge access). Those must NOT appear in the wire
-    // payload. Concrete scenario: a partner running RN inside an
-    // emulator would otherwise send a payload with empty
-    // `device_model`, `host_application`, `client_ip`, etc.
-    const factory = new UseSmileIDMetadataFactory();
-    const names = factory
-      .make()
-      .toEntries()
-      .map((e) => e.name);
-    expect(names).not.toContain("client_ip");
-    expect(names).not.toContain("network_connection");
-    expect(names).not.toContain("carrier_info");
-    expect(names).not.toContain("memory_info");
-    expect(names).not.toContain("number_of_cameras");
-    expect(names).not.toContain("host_application");
-    // device_os / device_model / app_name are always-present and emitted
-    // even at their empty factory defaults.
-    expect(names).toContain("device_os");
-    expect(names).toContain("device_model");
-    expect(names).toContain("app_name");
-    // sdk_config_source is always-present (non-empty string by construction).
-    expect(names).toContain("sdk_config_source");
-    // Selfie + liveness dimensions are emitted as "WxH" when both sides > 0.
-    // Factory defaults to 480 × 640 so they appear without an sdkConfig override.
-    expect(names).toContain("selfie_image_dimensions");
-    expect(names).toContain("liveness_image_dimensions");
-  });
-});
-
-describe("UseSmileIDMetadata.toEntries — device-integrity fields", () => {
-  const valueByName = (meta: UseSmileIDMetadata): Record<string, string> =>
-    Object.fromEntries(meta.toEntries().map((e) => [e.name, e.value]));
-
-  it("omits every attestation field before the warm-up resolves", () => {
-    const names = new UseSmileIDMetadata(baseFields)
-      .toEntries()
-      .map((e) => e.name);
-    expect(names).not.toContain("supports_hardware_attestation");
-    expect(names).not.toContain("attestation_certificate_chain");
-    expect(names).not.toContain("supports_app_attest");
-  });
-
-  it("emits supports_hardware_attestation as the security-level integer", () => {
-    // StrongBox-backed key → KeyInfo.getSecurityLevel() === 2.
-    const values = valueByName(
-      new UseSmileIDMetadata({
-        ...baseFields,
-        hardwareAttestationSecurityLevel: 2,
-      }),
-    );
-    expect(values.supports_hardware_attestation).toBe("2");
-  });
-
-  it("emits security level -2 (unknown) for an unsupported device", () => {
-    const values = valueByName(
-      new UseSmileIDMetadata({
-        ...baseFields,
-        hardwareAttestationSecurityLevel: -2,
-      }),
-    );
-    expect(values.supports_hardware_attestation).toBe("-2");
-  });
-
-  it("serialises the certificate chain as a JSON-array string", () => {
-    const values = valueByName(
-      new UseSmileIDMetadata({
-        ...baseFields,
-        hardwareAttestationSecurityLevel: 1,
-        attestationCertificateChain: ["certA", "certB"],
-      }),
-    );
-    expect(values.attestation_certificate_chain).toBe('["certA","certB"]');
-  });
-
-  it("omits the certificate chain when empty even if level present", () => {
-    const names = new UseSmileIDMetadata({
-      ...baseFields,
-      hardwareAttestationSecurityLevel: 0,
-      attestationCertificateChain: [],
-    })
-      .toEntries()
-      .map((e) => e.name);
-    expect(names).toContain("supports_hardware_attestation");
-    expect(names).not.toContain("attestation_certificate_chain");
-  });
-
-  it("emits supports_app_attest as a boolean string", () => {
-    expect(
-      valueByName(
-        new UseSmileIDMetadata({ ...baseFields, supportsAppAttest: true }),
-      ).supports_app_attest,
-    ).toBe("true");
-    expect(
-      valueByName(
-        new UseSmileIDMetadata({ ...baseFields, supportsAppAttest: false }),
-      ).supports_app_attest,
-    ).toBe("false");
-  });
-});
-
-describe("UseSmileIDMetadata.toEntries — sdk_config provenance", () => {
-  const valueByName = (meta: UseSmileIDMetadata): Record<string, string> =>
-    Object.fromEntries(meta.toEntries().map((e) => [e.name, e.value]));
-
-  it("always emits sdk_config_source — the backend gates its dimension-consistency check on this", () => {
-    const names = new UseSmileIDMetadata(baseFields)
-      .toEntries()
-      .map((e) => e.name);
-    expect(names).toContain("sdk_config_source");
-  });
-
-  it('emits sdk_config_source = "default" from the baseline fixture', () => {
-    expect(
-      valueByName(new UseSmileIDMetadata(baseFields)).sdk_config_source,
-    ).toBe("default");
-  });
-
-  it('emits sdk_config_source = "sdk_config" when the field is set', () => {
-    const meta = new UseSmileIDMetadata({
-      ...baseFields,
-      sdkConfigSource: SdkConfigSource.sdkConfig,
-      imageWidth: 640,
-      imageHeight: 480,
-    });
-    expect(valueByName(meta).sdk_config_source).toBe("sdk_config");
-  });
-
-  it("emits selfie_image_dimensions as WxH when both sides > 0", () => {
-    const values = valueByName(
-      new UseSmileIDMetadata({
-        ...baseFields,
-        sdkConfigSource: SdkConfigSource.sdkConfig,
-        imageWidth: 640,
-        imageHeight: 480,
-      }),
-    );
-    expect(values["selfie_image_dimensions"]).toBe("640x480");
-  });
-
-  it("omits selfie_image_dimensions when a side is zero (fallback to SDK defaults not set)", () => {
-    // baseFields has imageWidth: 0 / imageHeight: 0 — the "WxH" key must be absent
-    // from the wire payload so the server doesn't see an explicit zero.
-    const names = new UseSmileIDMetadata(baseFields)
-      .toEntries()
-      .map((e) => e.name);
-    expect(names).not.toContain("selfie_image_dimensions");
-  });
-});
-
-describe("UseSmileIDMetadataFactory — sdk_config provenance", () => {
-  it('defaults to sdk_config_source = "default" when make() is called without sdkConfig', () => {
-    const factory = new UseSmileIDMetadataFactory();
-    const fields = factory.make().toFields();
-    expect(fields.sdkConfigSource).toBe(SdkConfigSource.defaultSource);
-  });
-
-  it("defaults image_width / image_height to the SDK defaults (480 × 640) when make() has no sdkConfig", () => {
-    const factory = new UseSmileIDMetadataFactory();
-    const fields = factory.make().toFields();
-    // SDK defaults: 480 × 640 — the canonical selfie capture size.
-    expect(fields.imageWidth).toBe(480);
-    expect(fields.imageHeight).toBe(640);
-  });
-
-  it('emits sdk_config_source = "sdk_config" when sdkConfig is supplied with valid selfie dimensions', () => {
-    const factory = new UseSmileIDMetadataFactory();
-    const sdkConfig: SdkConfig = {
-      selfie: { width: 640, height: 480 },
-    };
-    const fields = factory.make(sdkConfig).toFields();
-    expect(fields.sdkConfigSource).toBe(SdkConfigSource.sdkConfig);
-    expect(fields.imageWidth).toBe(640);
-    expect(fields.imageHeight).toBe(480);
-  });
-
-  it('emits sdk_config_source = "sdk_config" and falls back to defaults when pair rule fails', () => {
-    // Pair rule: both width AND height must be > 0; width-only fails.
-    // sdkConfig is still defined so source = "sdk_config", but dims fall back.
-    const factory = new UseSmileIDMetadataFactory();
-    const sdkConfig: SdkConfig = { selfie: { width: 640 } };
-    const fields = factory.make(sdkConfig).toFields();
-    expect(fields.sdkConfigSource).toBe(SdkConfigSource.sdkConfig);
-    // SDK default dimensions should apply when pair rule fails.
-    expect(fields.imageWidth).toBe(480);
-    expect(fields.imageHeight).toBe(640);
-  });
-});

package/src/metadata/builder_configuration.ts

@@ -1,69 +0,0 @@
-/**
- * Snapshot of the partner's structural SDK configuration, derived from the
- * flow they assembled through the Builder DSL and appended to a job request as
- * the `builder_configuration_object` entry. Lets the server correlate fraud
- * signals with how the SDK was set up.
- *
- * Build instances with `flowConfigurationToBuilderConfiguration`.
- */
-
-/**
- * Intrinsic pixel dimensions of the partner-supplied consent icon. On React
- * Native the consent icon is a `ReactNode` with no measurable pixel size at
- * configuration time, so this is currently always reported as `null`.
- */
-export type ConsentIconDimensions = {
-  readonly width: number;
-  readonly height: number;
-};
-
-export type BuilderConfiguration = {
-  readonly consentScreenUsed: boolean;
-  readonly consentIconProvided: boolean;
-  readonly consentIconDimensions: ConsentIconDimensions | null;
-  readonly consentAttributionShown: boolean;
-  readonly instructionsScreenUsed: boolean;
-  readonly selfiePreviewEnabled: boolean;
-  readonly documentPreviewEnabled: boolean;
-  readonly submissionSkipped: boolean;
-  readonly allowAgentMode: boolean;
-  readonly enhancedLivenessEnabled: boolean;
-  readonly autoCaptureEnabled: string;
-  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;
-};
-
-/**
- * Serialises a [BuilderConfiguration] to its snake_case wire object, emitting
- * `consent_icon_dimensions` as explicit `null` when no dimensions are available.
- */
-export function builderConfigurationToJson(
-  configuration: BuilderConfiguration,
-): Record<string, unknown> {
-  const dimensions = configuration.consentIconDimensions;
-  return {
-    consent_screen_used: configuration.consentScreenUsed,
-    consent_icon_provided: configuration.consentIconProvided,
-    consent_icon_dimensions: dimensions
-      ? { width: dimensions.width, height: dimensions.height }
-      : null,
-    consent_attribution_shown: configuration.consentAttributionShown,
-    instructions_screen_used: configuration.instructionsScreenUsed,
-    selfie_preview_enabled: configuration.selfiePreviewEnabled,
-    document_preview_enabled: configuration.documentPreviewEnabled,
-    submission_skipped: configuration.submissionSkipped,
-    allow_agent_mode: configuration.allowAgentMode,
-    enhanced_liveness_enabled: configuration.enhancedLivenessEnabled,
-    auto_capture_enabled: configuration.autoCaptureEnabled,
-    allow_gallery_upload: configuration.allowGalleryUpload,
-    capture_both_sides: configuration.captureBothSides,
-    allow_skip_back: configuration.allowSkipBack,
-    global_privacy_control: configuration.globalPrivacyControl,
-  };
-}