@smileid/usesmileid 12.0.0-beta01 → 12.0.1

package/dist/metadata/captured_image_properties.js

@@ -0,0 +1,11 @@
+/**
+ * Fixed image properties for the captured artifacts, emitted as `*_image_color_depth` and
+ * `*_image_pixel_config`.
+ *
+ * These describe the submitted artifact — a baseline JPEG (3-channel RGB, no alpha) — not the
+ * 32-bit RGBA bitmap it decodes to in memory. Per-image byte sizes (`*_original_size` /
+ * `*_final_compressed_size`) are measured in the repository around the compression pass.
+ */
+export const CAPTURE_IMAGE_COLOR_DEPTH = 24;
+export const CAPTURE_IMAGE_PIXEL_CONFIG = "RGB_888";
+//# sourceMappingURL=captured_image_properties.js.map

package/dist/metadata/captured_image_properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captured_image_properties.js","sourceRoot":"","sources":["../../src/metadata/captured_image_properties.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAC5C,MAAM,CAAC,MAAM,0BAA0B,GAAG,SAAS,CAAC"}

package/dist/metadata/device_orientation_collector.d.ts

@@ -0,0 +1,17 @@
+export declare class DeviceOrientationCollector {
+    private subscription;
+    private positions;
+    private movements;
+    private startedAt;
+    private lastSampleMs;
+    /** Begins accelerometer sampling for a fresh capture session. No-op if running or unavailable. */
+    start(): void;
+    /** Stops sampling but preserves the collected data for the getters below. */
+    stop(): void;
+    private onSample;
+    /** Collected `"epochMs,x,y,z"` samples (empty when no capture ran). */
+    get devicePositions(): readonly string[];
+    /** Span of movement magnitude across the session; `null` when no samples were collected. */
+    get deviceMovementDetected(): number | null;
+}
+//# sourceMappingURL=device_orientation_collector.d.ts.map

package/dist/metadata/device_orientation_collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device_orientation_collector.d.ts","sourceRoot":"","sources":["../../src/metadata/device_orientation_collector.ts"],"names":[],"mappings":"AAqBA,qBAAa,0BAA0B;IACrC,OAAO,CAAC,YAAY,CAA0C;IAC9D,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAK;IAEzB,kGAAkG;IAClG,KAAK,IAAI,IAAI;IAcb,6EAA6E;IAC7E,IAAI,IAAI,IAAI;IAKZ,OAAO,CAAC,QAAQ;IAehB,uEAAuE;IACvE,IAAI,eAAe,IAAI,SAAS,MAAM,EAAE,CAEvC;IAED,4FAA4F;IAC5F,IAAI,sBAAsB,IAAI,MAAM,GAAG,IAAI,CAG1C;CACF"}

package/dist/metadata/device_orientation_collector.js

@@ -0,0 +1,66 @@
+import { loadExpoSensors, } from "./optional_native_modules";
+/**
+ * Samples the accelerometer during capture for two metadata signals:
+ * - `device_positions`: `"epochMs,x,y,z"` samples throttled to ~15 Hz, capped at
+ *   {@link MAX_DURATION_MS} to bound payload size.
+ * - `device_movement_detected`: the span (max − min) of movement magnitude
+ *   (`|‖accel‖ − gravity|`, in g) across the session, or `null` when no samples ran.
+ *
+ * The `expo-sensors` subscription lives only between {@link start} and {@link stop}
+ * (tied to the capture screen lifecycle). When `expo-sensors` isn't installed the
+ * collector silently no-ops and the keys are omitted.
+ */
+const SAMPLE_INTERVAL_MS = Math.floor(1000 / 15);
+const MAX_DURATION_MS = 90 * 1000;
+// expo-sensors reports acceleration in g; gravity is ~1 g (v11 parity value).
+const GRAVITY = 0.981;
+export class DeviceOrientationCollector {
+    subscription = null;
+    positions = [];
+    movements = [];
+    startedAt = 0;
+    lastSampleMs = 0;
+    /** Begins accelerometer sampling for a fresh capture session. No-op if running or unavailable. */
+    start() {
+        if (this.subscription)
+            return;
+        const sensors = loadExpoSensors();
+        if (!sensors)
+            return;
+        this.positions = [];
+        this.movements = [];
+        this.startedAt = Date.now();
+        this.lastSampleMs = 0;
+        sensors.Accelerometer.setUpdateInterval(SAMPLE_INTERVAL_MS);
+        this.subscription = sensors.Accelerometer.addListener((data) => this.onSample(data));
+    }
+    /** Stops sampling but preserves the collected data for the getters below. */
+    stop() {
+        this.subscription?.remove();
+        this.subscription = null;
+    }
+    onSample(data) {
+        const now = Date.now();
+        if (now - this.startedAt > MAX_DURATION_MS) {
+            this.stop();
+            return;
+        }
+        if (now - this.lastSampleMs < SAMPLE_INTERVAL_MS)
+            return;
+        this.lastSampleMs = now;
+        this.positions.push(`${now},${data.x},${data.y},${data.z}`);
+        const magnitude = Math.sqrt(data.x * data.x + data.y * data.y + data.z * data.z);
+        this.movements.push(Math.abs(magnitude - GRAVITY));
+    }
+    /** Collected `"epochMs,x,y,z"` samples (empty when no capture ran). */
+    get devicePositions() {
+        return this.positions;
+    }
+    /** Span of movement magnitude across the session; `null` when no samples were collected. */
+    get deviceMovementDetected() {
+        if (this.movements.length === 0)
+            return null;
+        return Math.max(...this.movements) - Math.min(...this.movements);
+    }
+}
+//# sourceMappingURL=device_orientation_collector.js.map

package/dist/metadata/device_orientation_collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device_orientation_collector.js","sourceRoot":"","sources":["../../src/metadata/device_orientation_collector.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAEhB,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;;;;GAUG;AACH,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;AACjD,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,CAAC;AAClC,8EAA8E;AAC9E,MAAM,OAAO,GAAG,KAAK,CAAC;AAEtB,MAAM,OAAO,0BAA0B;IAC7B,YAAY,GAAqC,IAAI,CAAC;IACtD,SAAS,GAAa,EAAE,CAAC;IACzB,SAAS,GAAa,EAAE,CAAC;IACzB,SAAS,GAAG,CAAC,CAAC;IACd,YAAY,GAAG,CAAC,CAAC;IAEzB,kGAAkG;IAClG,KAAK;QACH,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO;QAC9B,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;QAClC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;QAC5D,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CAC7D,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CACpB,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,IAAI;QACF,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;QAC5B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAEO,QAAQ,CAAC,IAAyC;QACxD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,GAAG,eAAe,EAAE,CAAC;YAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QACD,IAAI,GAAG,GAAG,IAAI,CAAC,YAAY,GAAG,kBAAkB;YAAE,OAAO;QACzD,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC;QACxB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CACzB,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CACpD,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,uEAAuE;IACvE,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,4FAA4F;IAC5F,IAAI,sBAAsB;QACxB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC;CACF"}

package/dist/metadata/geolocation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Coarse last-known location, emitted as the `geolocation` metadata (JSON-object string).
+ *
+ * `accuracy` is `precise` (<20 m), `approximate` (<100 m), or `unknown`; `source` is `gps`.
+ */
+export interface Geolocation {
+    readonly latitude: number;
+    readonly longitude: number;
+    readonly accuracy: string;
+    readonly source: string;
+}
+/**
+ * Resolves the last-known location for the `geolocation` metadata — only when a location
+ * permission is **already** granted. The SDK never requests it (uses
+ * `getForegroundPermissionsAsync`, not `requestForegroundPermissionsAsync`), so this never
+ * prompts. Returns `null` when permission is absent, no cached fix exists, or `expo-location`
+ * isn't installed.
+ */
+export declare function resolveGeolocation(): Promise<Geolocation | null>;
+//# sourceMappingURL=geolocation.d.ts.map

package/dist/metadata/geolocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geolocation.d.ts","sourceRoot":"","sources":["../../src/metadata/geolocation.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AASD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAiBtE"}

package/dist/metadata/geolocation.js

@@ -0,0 +1,40 @@
+import { loadExpoLocation } from "./optional_native_modules";
+function classifyAccuracy(meters) {
+    if (meters === null || meters <= 0)
+        return "unknown";
+    if (meters < 20)
+        return "precise";
+    if (meters < 100)
+        return "approximate";
+    return "unknown";
+}
+/**
+ * Resolves the last-known location for the `geolocation` metadata — only when a location
+ * permission is **already** granted. The SDK never requests it (uses
+ * `getForegroundPermissionsAsync`, not `requestForegroundPermissionsAsync`), so this never
+ * prompts. Returns `null` when permission is absent, no cached fix exists, or `expo-location`
+ * isn't installed.
+ */
+export async function resolveGeolocation() {
+    const location = loadExpoLocation();
+    if (!location)
+        return null;
+    try {
+        const permission = await location.getForegroundPermissionsAsync();
+        if (!permission.granted)
+            return null;
+        const position = await location.getLastKnownPositionAsync();
+        if (!position)
+            return null;
+        return {
+            latitude: position.coords.latitude,
+            longitude: position.coords.longitude,
+            accuracy: classifyAccuracy(position.coords.accuracy),
+            source: "gps",
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=geolocation.js.map

package/dist/metadata/geolocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geolocation.js","sourceRoot":"","sources":["../../src/metadata/geolocation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAc7D,SAAS,gBAAgB,CAAC,MAAqB;IAC7C,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACrD,IAAI,MAAM,GAAG,EAAE;QAAE,OAAO,SAAS,CAAC;IAClC,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,aAAa,CAAC;IACvC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,6BAA6B,EAAE,CAAC;QAClE,IAAI,CAAC,UAAU,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,yBAAyB,EAAE,CAAC;QAC5D,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,OAAO;YACL,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;YAClC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS;YACpC,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC;YACpD,MAAM,EAAE,KAAK;SACd,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/metadata/metadata_configuration_mappers.d.ts

@@ -0,0 +1,47 @@
+import type { FlowConfiguration } from "../presentation/flow/config/flow_configuration";
+import { type BuilderConfiguration } from "./builder_configuration";
+import { type ModelConfiguration } from "./model_configuration";
+import type { MetadataEntry } from "./use_smile_id_metadata";
+/**
+ * Projects the resolved [FlowConfiguration] into the request-metadata
+ * configuration objects, so the telemetry layer never needs a parallel copy of
+ * the partner's choices.
+ *
+ * Fields that do not apply to the assembled flow report their accurate "absent"
+ * value (`false`, or `autocapture_default` for the capture mode) rather than
+ * being omitted, so the object always carries the full schema.
+ * `consent_icon_dimensions` is always `null`: the consent icon is a `ReactNode`
+ * with no measurable pixel size at configuration time.
+ */
+export declare function flowConfigurationToBuilderConfiguration(configuration: FlowConfiguration): BuilderConfiguration;
+/**
+ * Describes the face and document models backing this flow.
+ *
+ * The face model is resolved from the registered selfie analyzer factory key;
+ * the document model reports the native no-op fallback, since the React Native
+ * document detector is not selectable from JS.
+ */
+export declare function flowConfigurationToModelConfiguration(configuration: FlowConfiguration): ModelConfiguration;
+/**
+ * The `builder_configuration_object` + `model_configuration_object` wire
+ * entries, encoded as JSON-string values so the metadata payload stays a flat
+ * `{name, value}` array.
+ */
+export declare function configurationMetadataEntries(configuration: FlowConfiguration): MetadataEntry[];
+type SelfieLivenessTelemetry = {
+    readonly activeLivenessType: string;
+    readonly activeLivenessVersion: string;
+    readonly selfieImageOrigin: string;
+} | {
+    readonly activeLivenessType: null;
+    readonly activeLivenessVersion: null;
+    readonly selfieImageOrigin: null;
+};
+/**
+ * Flow-derived selfie liveness telemetry. All-`null` for flows without a selfie
+ * capture; otherwise the active-liveness check, the version, and the lens the
+ * selfie came from (the selfie SDK has no gallery path).
+ */
+export declare function flowConfigurationToSelfieLivenessTelemetry(configuration: FlowConfiguration): SelfieLivenessTelemetry;
+export {};
+//# sourceMappingURL=metadata_configuration_mappers.d.ts.map

package/dist/metadata/metadata_configuration_mappers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata_configuration_mappers.d.ts","sourceRoot":"","sources":["../../src/metadata/metadata_configuration_mappers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AAKxF,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,kBAAkB,EAIxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,wBAAgB,uCAAuC,CACrD,aAAa,EAAE,iBAAiB,GAC/B,oBAAoB,CA2DtB;AAED;;;;;;GAMG;AACH,wBAAgB,qCAAqC,CACnD,aAAa,EAAE,iBAAiB,GAC/B,kBAAkB,CAMpB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,aAAa,EAAE,iBAAiB,GAC/B,aAAa,EAAE,CAiCjB;AAED,KAAK,uBAAuB,GACxB;IACE,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC,GACD;IACE,QAAQ,CAAC,kBAAkB,EAAE,IAAI,CAAC;IAClC,QAAQ,CAAC,qBAAqB,EAAE,IAAI,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,IAAI,CAAC;CAClC,CAAC;AAEN;;;;GAIG;AACH,wBAAgB,0CAA0C,CACxD,aAAa,EAAE,iBAAiB,GAC/B,uBAAuB,CAuBzB"}

package/dist/metadata/metadata_configuration_mappers.js

@@ -0,0 +1,178 @@
+import { GlobalPrivacyControl } from "../core/models/global_privacy_control";
+import { AnalyzerFactoryKey } from "@smileid/usesmileid_bridge";
+import { CaptureType } from "../core/models/ml_config";
+import { autoCaptureWireValue } from "../core/models/document_capture_mode";
+import { builderConfigurationToJson, } from "./builder_configuration";
+import { MODEL_DESCRIPTOR_UNKNOWN, ModelProvider, modelConfigurationToJson, } from "./model_configuration";
+/**
+ * Projects the resolved [FlowConfiguration] into the request-metadata
+ * configuration objects, so the telemetry layer never needs a parallel copy of
+ * the partner's choices.
+ *
+ * Fields that do not apply to the assembled flow report their accurate "absent"
+ * value (`false`, or `autocapture_default` for the capture mode) rather than
+ * being omitted, so the object always carries the full schema.
+ * `consent_icon_dimensions` is always `null`: the consent icon is a `ReactNode`
+ * with no measurable pixel size at configuration time.
+ */
+export function flowConfigurationToBuilderConfiguration(configuration) {
+    const steps = configuration.screens.steps;
+    let consent;
+    const captures = [];
+    let instructionsUsed = false;
+    let previewUsed = false;
+    let processingUsed = false;
+    for (const step of steps) {
+        switch (step.kind) {
+            case "consent":
+                consent = step.config;
+                break;
+            case "instructions":
+                instructionsUsed = true;
+                break;
+            case "capture":
+                captures.push(step.config);
+                break;
+            case "preview":
+                previewUsed = true;
+                break;
+            case "processing":
+                processingUsed = true;
+                break;
+        }
+    }
+    const selfie = captures.find((capture) => capture.selfieConfig)?.selfieConfig;
+    const document = captures.find((capture) => capture.documentConfig)?.documentConfig;
+    const hasSelfieCapture = selfie !== undefined ||
+        captures.some((capture) => capture.captureType === CaptureType.selfie);
+    const hasDocumentCapture = document !== undefined ||
+        captures.some((capture) => capture.captureType === CaptureType.document);
+    return {
+        consentScreenUsed: consent !== undefined,
+        consentIconProvided: consent?.partnerIcon != null,
+        // A React Native consent icon is a ReactNode with no measurable pixel size.
+        consentIconDimensions: null,
+        consentAttributionShown: consent?.showAttribution ?? false,
+        instructionsScreenUsed: instructionsUsed,
+        selfiePreviewEnabled: previewUsed && hasSelfieCapture,
+        documentPreviewEnabled: previewUsed && hasDocumentCapture,
+        // No processing screen means the flow captures without submitting to the API.
+        submissionSkipped: !processingUsed,
+        allowAgentMode: selfie?.allowAgentMode ?? false,
+        enhancedLivenessEnabled: selfie?.enableEnhancedLiveness ?? false,
+        autoCaptureEnabled: autoCaptureWireValue(document?.captureMode),
+        allowGalleryUpload: document?.allowGalleryUpload ?? false,
+        captureBothSides: document?.captureBothSides ?? false,
+        allowSkipBack: document?.allowSkipBack ?? false,
+        globalPrivacyControl: configuration.config?.globalPrivacyControl ?? GlobalPrivacyControl.OptOut,
+    };
+}
+/**
+ * Describes the face and document models backing this flow.
+ *
+ * The face model is resolved from the registered selfie analyzer factory key;
+ * the document model reports the native no-op fallback, since the React Native
+ * document detector is not selectable from JS.
+ */
+export function flowConfigurationToModelConfiguration(configuration) {
+    const faceKey = configuration.ml?.analyzers.selfieConfig?.analyzerFactoryKey;
+    return {
+        faceModel: faceDescriptorOf(faceKey),
+        documentModel: NOOP_DOCUMENT_DESCRIPTOR,
+    };
+}
+/**
+ * The `builder_configuration_object` + `model_configuration_object` wire
+ * entries, encoded as JSON-string values so the metadata payload stays a flat
+ * `{name, value}` array.
+ */
+export function configurationMetadataEntries(configuration) {
+    const entries = [
+        {
+            name: "builder_configuration_object",
+            value: JSON.stringify(builderConfigurationToJson(flowConfigurationToBuilderConfiguration(configuration))),
+        },
+        {
+            name: "model_configuration_object",
+            value: JSON.stringify(modelConfigurationToJson(flowConfigurationToModelConfiguration(configuration))),
+        },
+    ];
+    // Flow-derived selfie liveness telemetry — appended only for selfie flows.
+    const liveness = flowConfigurationToSelfieLivenessTelemetry(configuration);
+    if (liveness.activeLivenessType !== null) {
+        entries.push({ name: "active_liveness_type", value: liveness.activeLivenessType }, {
+            name: "active_liveness_version",
+            value: liveness.activeLivenessVersion,
+        }, { name: "selfie_image_origin", value: liveness.selfieImageOrigin });
+    }
+    return entries;
+}
+/**
+ * Flow-derived selfie liveness telemetry. All-`null` for flows without a selfie
+ * 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) {
+    let selfie;
+    let hasSelfieCapture = false;
+    for (const step of configuration.screens.steps) {
+        if (step.kind === "capture") {
+            selfie ??= step.config.selfieConfig;
+            if (step.config.captureType === CaptureType.selfie) {
+                hasSelfieCapture = true;
+            }
+        }
+    }
+    if (!hasSelfieCapture && selfie === undefined) {
+        return {
+            activeLivenessType: null,
+            activeLivenessVersion: null,
+            selfieImageOrigin: null,
+        };
+    }
+    return {
+        activeLivenessType: activeLivenessTypeOf(selfie),
+        activeLivenessVersion: "2.0.0",
+        selfieImageOrigin: selfieImageOriginOf(selfie),
+    };
+}
+function activeLivenessTypeOf(selfie) {
+    return selfie?.enableEnhancedLiveness ? "head_pose" : "smile";
+}
+function selfieImageOriginOf(selfie) {
+    return selfie?.allowAgentMode ? "back_camera" : "front_camera";
+}
+function faceDescriptorOf(key) {
+    switch (key) {
+        case AnalyzerFactoryKey.MLKitFace:
+            return {
+                provider: ModelProvider.Google,
+                name: "play-services-mlkit-face-detection",
+                version: "17.1.0",
+                bundled: false,
+            };
+        case AnalyzerFactoryKey.HuaweiFace:
+            return {
+                provider: ModelProvider.Huawei,
+                name: "ml-computer-vision-face",
+                version: "3.18.1.300",
+                bundled: false,
+            };
+        case AnalyzerFactoryKey.VisionFace:
+            return {
+                provider: ModelProvider.Apple,
+                name: "vision_face_detector",
+                version: "system",
+                bundled: true,
+            };
+        default:
+            return MODEL_DESCRIPTOR_UNKNOWN;
+    }
+}
+const NOOP_DOCUMENT_DESCRIPTOR = {
+    provider: ModelProvider.Smile,
+    name: "noop_document_detector",
+    version: "12.0.1",
+    bundled: true,
+};
+//# sourceMappingURL=metadata_configuration_mappers.js.map

package/dist/metadata/metadata_configuration_mappers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata_configuration_mappers.js","sourceRoot":"","sources":["../../src/metadata/metadata_configuration_mappers.ts"],"names":[],"mappings":"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"}

package/dist/metadata/model_configuration.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Client-side detection-model metadata appended to a job request as the
+ * `model_configuration_object` entry, so the server can attribute face /
+ * document detection behaviour to a concrete component and version during
+ * fraud analysis.
+ *
+ * `ModelProvider` is a stable lowercase wire token; `apple` covers detectors
+ * backed by Apple's Vision framework on iOS. New providers are additive.
+ */
+export declare const ModelProvider: {
+    readonly Google: "google";
+    readonly Huawei: "huawei";
+    readonly Smile: "smile";
+    readonly Apple: "apple";
+    readonly Custom: "custom";
+};
+export type ModelProvider = (typeof ModelProvider)[keyof typeof ModelProvider];
+export type ModelDescriptor = {
+    readonly provider: ModelProvider;
+    /** Human-readable model identifier (e.g. the native artefact id). */
+    readonly name: string;
+    /** The model / framework version in use on the device. */
+    readonly version: string;
+    /** `true` when the model ships with the app / OS, `false` when downloaded on demand. */
+    readonly bundled: boolean;
+};
+/**
+ * Placeholder used when the active model for a capture type cannot be
+ * resolved, so the `model_configuration_object` always carries both
+ * `face_model` and `document_model` rather than omitting a side.
+ */
+export declare const MODEL_DESCRIPTOR_UNKNOWN: ModelDescriptor;
+export type ModelConfiguration = {
+    readonly faceModel: ModelDescriptor;
+    readonly documentModel: ModelDescriptor;
+};
+/** Serialises a [ModelDescriptor] to its snake_case wire object. */
+export declare function modelDescriptorToJson(descriptor: ModelDescriptor): Record<string, unknown>;
+/** Serialises a [ModelConfiguration] to its snake_case wire object. */
+export declare function modelConfigurationToJson(configuration: ModelConfiguration): Record<string, unknown>;
+//# sourceMappingURL=model_configuration.d.ts.map

package/dist/metadata/model_configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model_configuration.d.ts","sourceRoot":"","sources":["../../src/metadata/model_configuration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,eAKrC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC;CACzC,CAAC;AAEF,oEAAoE;AACpE,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,eAAe,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED,uEAAuE;AACvE,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,kBAAkB,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB"}

package/dist/metadata/model_configuration.js

@@ -0,0 +1,44 @@
+/**
+ * Client-side detection-model metadata appended to a job request as the
+ * `model_configuration_object` entry, so the server can attribute face /
+ * document detection behaviour to a concrete component and version during
+ * fraud analysis.
+ *
+ * `ModelProvider` is a stable lowercase wire token; `apple` covers detectors
+ * backed by Apple's Vision framework on iOS. New providers are additive.
+ */
+export const ModelProvider = {
+    Google: "google",
+    Huawei: "huawei",
+    Smile: "smile",
+    Apple: "apple",
+    Custom: "custom",
+};
+/**
+ * Placeholder used when the active model for a capture type cannot be
+ * resolved, so the `model_configuration_object` always carries both
+ * `face_model` and `document_model` rather than omitting a side.
+ */
+export const MODEL_DESCRIPTOR_UNKNOWN = Object.freeze({
+    provider: ModelProvider.Custom,
+    name: "unknown",
+    version: "unknown",
+    bundled: false,
+});
+/** Serialises a [ModelDescriptor] to its snake_case wire object. */
+export function modelDescriptorToJson(descriptor) {
+    return {
+        provider: descriptor.provider,
+        name: descriptor.name,
+        version: descriptor.version,
+        bundled: descriptor.bundled,
+    };
+}
+/** Serialises a [ModelConfiguration] to its snake_case wire object. */
+export function modelConfigurationToJson(configuration) {
+    return {
+        face_model: modelDescriptorToJson(configuration.faceModel),
+        document_model: modelDescriptorToJson(configuration.documentModel),
+    };
+}
+//# sourceMappingURL=model_configuration.js.map

package/dist/metadata/model_configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model_configuration.js","sourceRoot":"","sources":["../../src/metadata/model_configuration.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;CACR,CAAC;AAcX;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAoB,MAAM,CAAC,MAAM,CAAC;IACrE,QAAQ,EAAE,aAAa,CAAC,MAAM;IAC9B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,KAAK;CACf,CAAC,CAAC;AAOH,oEAAoE;AACpE,MAAM,UAAU,qBAAqB,CACnC,UAA2B;IAE3B,OAAO;QACL,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,OAAO,EAAE,UAAU,CAAC,OAAO;KAC5B,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,wBAAwB,CACtC,aAAiC;IAEjC,OAAO;QACL,UAAU,EAAE,qBAAqB,CAAC,aAAa,CAAC,SAAS,CAAC;QAC1D,cAAc,EAAE,qBAAqB,CAAC,aAAa,CAAC,aAAa,CAAC;KACnE,CAAC;AACJ,CAAC"}

package/dist/metadata/optional_native_modules.d.ts

@@ -1,7 +1,8 @@
 /**
- * Lazy bridges to optional `expo-device` / `expo-network` peer deps.
- * Both are declared `optional: true` in `peerDependenciesMeta` so
- * partners who don't need richer metadata don't pay the install cost.
+ * Lazy bridges to optional `expo-device` / `expo-network` / `expo-battery` /
+ * `expo-cellular` peer deps. All are declared `optional: true` in
+ * `peerDependenciesMeta` so partners who don't need richer metadata don't pay
+ * the install cost.
  *
  * **Pattern:** dynamic `require()` wrapped in `try/catch`. Metro
  * tolerates the missing-module case without failing the build —
@@ -18,6 +19,10 @@ type DeviceModule = {
     readonly brand?: string | null;
     readonly supportedCpuArchitectures?: readonly string[] | null;
     readonly totalMemory?: number | null;
+    readonly designName?: string | null;
+    readonly productName?: string | null;
+    readonly osBuildFingerprint?: string | null;
+    readonly modelId?: string | null;
 };
 type NetworkModule = {
     getNetworkStateAsync(): Promise<{
@@ -27,6 +32,44 @@ type NetworkModule = {
     }>;
     getIpAddressAsync?(): Promise<string>;
 };
+type BatteryModule = {
+    getBatteryStateAsync(): Promise<number>;
+};
+type CellularModule = {
+    readonly carrier?: string | null;
+};
+type AsyncStorageModule = {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+};
+/** Subscription returned by `Accelerometer.addListener`. */
+export type AccelerometerSubscription = {
+    remove(): void;
+};
+/** Minimal `expo-sensors` surface used for device_positions / device_movement_detected. */
+type SensorsModule = {
+    Accelerometer: {
+        setUpdateInterval(intervalMs: number): void;
+        addListener(listener: (data: {
+            x: number;
+            y: number;
+            z: number;
+        }) => void): AccelerometerSubscription;
+    };
+};
+/** Minimal `expo-location` surface used for the geolocation metadata. */
+type LocationModule = {
+    getForegroundPermissionsAsync(): Promise<{
+        granted: boolean;
+    }>;
+    getLastKnownPositionAsync(): Promise<{
+        coords: {
+            latitude: number;
+            longitude: number;
+            accuracy: number | null;
+        };
+    } | null>;
+};
 /**
  * Load `expo-device`'s native module once, cached for the process
  * lifetime. Returns `null` if the native module isn't linked into
@@ -79,6 +122,39 @@ export declare function loadExpoDevice(): DeviceModule | null;
  * fire-and-forget and falls back to empty defaults until it settles.
  */
 export declare function loadExpoNetwork(): NetworkModule | null;
+/**
+ * Load `expo-battery`'s native module once, cached for the process lifetime.
+ * Returns `null` when the native module isn't linked (graceful degradation).
+ * Mirrors [loadExpoDevice] — pulls the raw `ExpoBattery` native module via
+ * `expo-modules-core`'s non-throwing `requireOptionalNativeModule`.
+ */
+export declare function loadExpoBattery(): BatteryModule | null;
+/**
+ * Load `expo-cellular`'s native module once, cached for the process lifetime.
+ * Returns `null` when the native module isn't linked (graceful degradation).
+ * The raw `ExpoCellular` module exposes the `carrier` name constant directly.
+ */
+export declare function loadExpoCellular(): CellularModule | null;
+/**
+ * Load `@react-native-async-storage/async-storage` once, cached for the process
+ * lifetime. Returns `null` when the package isn't installed (graceful
+ * degradation). Unlike the expo modules, async-storage's JS entry does not throw
+ * at import when the native side is missing, so a plain `require` (wrapped in
+ * try/catch for the not-installed case) is sufficient; per-call native errors
+ * are handled by the caller. Backed by Android `SharedPreferences` /
+ * iOS `NSUserDefaults`.
+ */
+export declare function loadAsyncStorage(): AsyncStorageModule | null;
+/**
+ * Load `expo-sensors` for accelerometer sampling. Returns `null` when the peer
+ * dep isn't installed/linked (graceful degradation — device_positions omitted).
+ */
+export declare function loadExpoSensors(): SensorsModule | null;
+/**
+ * Load `expo-location` for the geolocation metadata. Returns `null` when the
+ * peer dep isn't installed/linked (graceful degradation — geolocation omitted).
+ */
+export declare function loadExpoLocation(): LocationModule | null;
 /** Test-only seam — clears the module cache so tests can re-evaluate. */
 export declare function _resetOptionalModulesForTesting(): void;
 export {};

package/dist/metadata/optional_native_modules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"optional_native_modules.d.ts","sourceRoot":"","sources":["../../src/metadata/optional_native_modules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,yBAAyB,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAC9D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,oBAAoB,IAAI,OAAO,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QACtC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;KAC/C,CAAC,CAAC;IACH,iBAAiB,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACvC,CAAC;AAKF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,IAAI,YAAY,GAAG,IAAI,CAapD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,IAAI,aAAa,GAAG,IAAI,CAatD;AAED,yEAAyE;AACzE,wBAAgB,+BAA+B,IAAI,IAAI,CAGtD"}
+{"version":3,"file":"optional_native_modules.d.ts","sourceRoot":"","sources":["../../src/metadata/optional_native_modules.ts"],"names":[],"mappings":"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"}