@trustchex/react-native-sdk 1.493.1 → 1.494.0

package/lib/module/Shared/Components/DiagnosticReportButton.js

@@ -1,19 +1,20 @@
 "use strict";
 
-import React, { useState } from 'react';
-import { Alert } from 'react-native';
+import React, { useRef, useState } from 'react';
+import { ActivityIndicator, Alert, Modal, StyleSheet, Text, TouchableOpacity, View } from 'react-native';
 import { useTranslation } from 'react-i18next';
 import StyledButton from "./StyledButton.js";
 import { sendDiagnosticReport } from "../Libs/sendDiagnosticReport.js";
 import { SDK_VERSION } from "../../version.js";
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 /**
  * "Report a scanning issue" button for the result screen.
  *
- * Shows a brief notice describing what will be shared (acting as the user's
- * consent step), then uploads the diagnostic bundle (technical signals +
- * scanned data + captured images) to the backend, encrypted in transit and at
- * rest. Operators view and download the reports from the dashboard.
+ * Uploads the diagnostic bundle to the backend (proof-of-work authenticated,
+ * encrypted in transit + at rest). The PoW solve is the only slow step, so while
+ * sending we show a NON-DISMISSIBLE modal overlay with progress — the user can't
+ * dismiss it accidentally (tap-outside / Android-back do nothing), but can
+ * explicitly Cancel, which aborts the solve. A thank-you shows on success.
  *
  * Hidden when there's no session/baseUrl to upload to (e.g. before init).
  */
@@ -27,9 +28,36 @@ const DiagnosticReportButton = ({
     t
   } = useTranslation();
   const [sending, setSending] = useState(false);
+  const [progress, setProgress] = useState(0);
+  // Ref so the running solve sees cancellation immediately (no stale closure).
+  const cancelledRef = useRef(false);
   if (!baseUrl || !sessionId) {
     return null;
   }
+  const doSend = async () => {
+    cancelledRef.current = false;
+    setProgress(0);
+    setSending(true);
+    try {
+      const {
+        uploaded,
+        cancelled
+      } = await sendDiagnosticReport({
+        baseUrl,
+        sessionId,
+        scan,
+        sdkVersion: SDK_VERSION,
+        images,
+        onPowProgress: setProgress,
+        shouldCancel: () => cancelledRef.current
+      });
+      setSending(false);
+      if (cancelled) return; // user cancelled — no alert
+      Alert.alert(uploaded ? t('diagnosticReport.sentTitle') : t('diagnosticReport.failedTitle'), uploaded ? t('diagnosticReport.sentBody') : t('diagnosticReport.failedBody'));
+    } catch {
+      setSending(false);
+    }
+  };
   const onPress = () => {
     if (sending) return;
     Alert.alert(t('diagnosticReport.noticeTitle'), t('diagnosticReport.noticeBody'), [{
@@ -37,30 +65,91 @@ const DiagnosticReportButton = ({
       style: 'cancel'
     }, {
       text: t('diagnosticReport.continue'),
-      onPress: async () => {
-        setSending(true);
-        try {
-          const {
-            uploaded
-          } = await sendDiagnosticReport({
-            baseUrl,
-            sessionId,
-            scan,
-            sdkVersion: SDK_VERSION,
-            images
-          });
-          Alert.alert(uploaded ? t('diagnosticReport.sentTitle') : t('diagnosticReport.failedTitle'), uploaded ? t('diagnosticReport.sentBody') : t('diagnosticReport.failedBody'));
-        } finally {
-          setSending(false);
-        }
-      }
+      onPress: doSend
     }]);
   };
-  return /*#__PURE__*/_jsx(StyledButton, {
-    mode: "outlined",
-    onPress: onPress,
-    disabled: sending,
-    children: t('diagnosticReport.button')
+  const pct = Math.round(progress * 100);
+  return /*#__PURE__*/_jsxs(_Fragment, {
+    children: [/*#__PURE__*/_jsx(StyledButton, {
+      mode: "outlined",
+      onPress: onPress,
+      children: t('diagnosticReport.button')
+    }), /*#__PURE__*/_jsx(Modal, {
+      visible: sending,
+      transparent: true,
+      animationType: "fade"
+      // Block accidental dismissal: Android hardware-back does nothing while
+      // sending. There is no tap-outside-to-close (we render our own backdrop).
+      ,
+      onRequestClose: () => {},
+      children: /*#__PURE__*/_jsx(View, {
+        style: styles.backdrop,
+        children: /*#__PURE__*/_jsxs(View, {
+          style: styles.card,
+          children: [/*#__PURE__*/_jsx(ActivityIndicator, {
+            size: "large"
+          }), /*#__PURE__*/_jsx(Text, {
+            style: styles.title,
+            children: t('diagnosticReport.sending')
+          }), /*#__PURE__*/_jsx(Text, {
+            style: styles.progress,
+            children: pct > 0 ? t('diagnosticReport.sendingProgress', {
+              pct
+            }) : t('diagnosticReport.sendingPreparing')
+          }), /*#__PURE__*/_jsx(TouchableOpacity, {
+            accessibilityRole: "button",
+            style: styles.cancelBtn,
+            onPress: () => {
+              cancelledRef.current = true;
+            },
+            children: /*#__PURE__*/_jsx(Text, {
+              style: styles.cancelText,
+              children: t('diagnosticReport.cancel')
+            })
+          })]
+        })
+      })
+    })]
   });
 };
+const styles = StyleSheet.create({
+  backdrop: {
+    flex: 1,
+    backgroundColor: 'rgba(0,0,0,0.45)',
+    alignItems: 'center',
+    justifyContent: 'center',
+    padding: 24
+  },
+  card: {
+    width: '100%',
+    maxWidth: 320,
+    backgroundColor: 'white',
+    borderRadius: 16,
+    paddingVertical: 24,
+    paddingHorizontal: 20,
+    alignItems: 'center',
+    gap: 12
+  },
+  title: {
+    fontSize: 16,
+    fontWeight: '600',
+    color: '#111827',
+    textAlign: 'center'
+  },
+  progress: {
+    fontSize: 14,
+    color: '#6B7280',
+    textAlign: 'center'
+  },
+  cancelBtn: {
+    marginTop: 8,
+    paddingVertical: 10,
+    paddingHorizontal: 24
+  },
+  cancelText: {
+    fontSize: 15,
+    fontWeight: '600',
+    color: '#DC2626'
+  }
+});
 export default DiagnosticReportButton;

package/lib/module/Shared/Components/NavigationManager.js

@@ -8,6 +8,7 @@ import { useTranslation } from 'react-i18next';
 import i18n from "../../Translation/index.js";
 import StyledButton from "./StyledButton.js";
 import { analyticsService } from "../Services/AnalyticsService.js";
+import { diagnostics } from "../Libs/diagnostics.js";
 
 // Navigation lock - use a ref-like pattern so unmounting resets state.
 // The module-level object is shared across all instances but the
@@ -56,11 +57,22 @@ const NavigationManager = /*#__PURE__*/forwardRef(({
     }
     const currentStepIndex = workflowSteps?.findIndex(step => step.id ? step.id === currentWorkFlowStep?.id : step.type === currentWorkFlowStep?.type) ?? -1;
     const nextStep = workflowSteps && currentStepIndex < workflowSteps.length ? workflowSteps[currentStepIndex + 1] : null;
+
+    // Diagnostics: advancing past the current step means it completed. Record
+    // its outcome (success — the user moved on) and start-time the next step,
+    // so the report captures the WHOLE flow, not just the NFC read.
+    const now = Date.now();
+    if (currentWorkFlowStep?.type) {
+      diagnostics.stepEnded(currentWorkFlowStep.type, 'success', now);
+    }
     if (!nextStep) {
       appContext.currentWorkflowStep = undefined;
       return routes.RESULT;
     }
     appContext.currentWorkflowStep = nextStep;
+    if (nextStep.type) {
+      diagnostics.stepStarted(nextStep.type, now);
+    }
     if (nextStep.type === 'CONTRACT_ACCEPTANCE') {
       return routes.DYNAMIC_ROUTES.CONTRACT_ACCEPTANCE;
     }

package/lib/module/Shared/Libs/diagnosticPow.js

@@ -29,9 +29,11 @@ const leadingZeroBits = bytes => {
 };
 
 /**
- * Solve the PoW for a challenge. Returns the solution nonce as a string.
- * Bounded by `maxIterations` so a pathological difficulty can't hang the app;
- * returns null if unsolved within the bound.
+ * Solve the PoW for a challenge (synchronous). Returns the solution nonce as a
+ * string. Bounded by `maxIterations` so a pathological difficulty can't hang the
+ * app; returns null if unsolved within the bound.
+ *
+ * Prefer `solvePowAsync` on the UI thread — this blocks until solved.
  */
 export const solvePow = (challenge, difficulty, maxIterations = 8_000_000) => {
   for (let i = 0; i < maxIterations; i++) {
@@ -42,4 +44,55 @@ export const solvePow = (challenge, difficulty, maxIterations = 8_000_000) => {
     }
   }
   return null;
+};
+
+/** Thrown by solvePowAsync / sendDiagnosticReport when the user cancels. */
+export class PowCancelledError extends Error {
+  constructor() {
+    super('Proof-of-work cancelled');
+    this.name = 'PowCancelledError';
+  }
+}
+/**
+ * Async, UI-friendly PoW solver. Hashes in small chunks and yields to the event
+ * loop between chunks so the JS thread (and the UI) stays responsive instead of
+ * freezing during the solve. Reports coarse progress (0..1, best-effort against
+ * the expected work for the difficulty) via `onProgress`, and aborts (throwing
+ * PowCancelledError) when `shouldCancel` returns true.
+ *
+ * Returns the solution nonce, or null if unsolved within `maxIterations`.
+ */
+export const solvePowAsync = async (challenge, difficulty, options = {}) => {
+  const {
+    onProgress,
+    shouldCancel,
+    maxIterations = 8_000_000,
+    // Hash a large chunk between yields: the per-yield setTimeout(0) round-trip
+    // on Hermes costs ~ms, so yielding every 2k hashes dominated wall-clock.
+    // 25k keeps the UI responsive + cancel snappy (a chunk is a few tens of ms)
+    // while spending almost all time hashing, not bouncing through the event loop.
+    chunkSize = 25_000
+  } = options;
+  // Expected hashes ≈ 2^difficulty; used only to render a smooth-ish bar.
+  const expected = Math.max(1, Math.pow(2, difficulty));
+  // Encode the fixed "challenge." prefix once; per iteration we only encode the
+  // small varying nonce and concat, instead of re-UTF-8-encoding the whole
+  // string (the challenge is 32+ chars) on every hash.
+  const prefix = Buffer.from(`${challenge}.`, 'utf-8');
+  for (let i = 0; i < maxIterations; i++) {
+    const digest = sha256(Buffer.concat([prefix, Buffer.from(i.toString(), 'utf-8')]));
+    if (leadingZeroBits(digest) >= difficulty) {
+      onProgress?.(1);
+      return i.toString();
+    }
+    if (i % chunkSize === chunkSize - 1) {
+      if (shouldCancel?.()) {
+        throw new PowCancelledError();
+      }
+      onProgress?.(Math.min(0.99, i / expected));
+      // Yield so React can paint the progress and the UI stays responsive.
+      await new Promise(resolve => setTimeout(resolve, 0));
+    }
+  }
+  return null;
 };

package/lib/module/Shared/Libs/diagnosticReport.js

@@ -114,6 +114,9 @@ export const buildDiagnosticReport = params => {
       buildNumber: device.buildNumber
     },
     device,
+    // Whole-flow, per-step record (contract → document → eID → liveness →
+    // consent → video). Diagnostics are NOT just the NFC read.
+    steps: diag.steps,
     scan: {
       documentType: scan.documentType ?? diag.documentType ?? null,
       dataSource: scan.dataSource ?? diag.dataSource ?? null,
@@ -145,7 +148,11 @@ export const buildDiagnosticReport = params => {
   const nfcCode = nfcErrorCode(nfc.errorCategory, failingSw);
   const nfcLine = nfc.attempted ? `${nfc.authProtocol}${nfc.paceFellBackToBac ? '→BAC' : ''} · ${nfc.succeeded ? 'success' : `failed at ${nfc.failureStep ?? '?'} (${nfc.errorCategory ?? 'error'}) [${nfcCode}]`}` : 'not attempted';
   const checksLine = checkDigits ? Object.entries(checkDigits).map(([k, v]) => `${k}:${v}`).join(' ') : 'n/a';
-  const body = ['TRUSTCHEX SCAN REPORT', `Device: ${device.brand} ${device.model} · ${device.systemName} ${device.systemVersion}${device.apiLevel ? ` (API ${device.apiLevel})` : ''}`, `SDK: ${sdkVersion} (build ${device.buildNumber}) · ${device.manufacturer} · ${device.deviceId}`, `Document: ${scanDataObj.documentType ?? 'unknown'} · source: ${scanDataObj.dataSource ?? 'unknown'}`, `MRZ: ${diag.mrz.reachedStable ? 'stable' : 'NOT stable'} after ${diag.mrz.framesProcessed} frames · checks: ${checksLine}`, `Camera: ${diag.camera.frames} frames · brightness ${diag.camera.avgBrightness} (low:${yesNo(diag.camera.hadLowBrightness)} blur:${yesNo(diag.camera.hadBlurryFrames)})`, `NFC: ${nfcLine}`, sessionId ? `Session: ${sessionId}` : '', '', 'Describe the issue here:', '', '', '— Full diagnostics and document images are attached. Please review before sending; do not edit the attachments. —'].filter(Boolean).join('\n');
+
+  // Compact per-step line, e.g. "Steps: CONTRACT_ACCEPTANCE:success
+  // IDENTITY_DOCUMENT_SCAN:success LIVENESS_CHECK:failed".
+  const stepsLine = diag.steps.length ? diag.steps.map(s => `${s.step}:${s.outcome}`).join(' ') : 'none recorded';
+  const body = ['TRUSTCHEX SCAN REPORT', `Device: ${device.brand} ${device.model} · ${device.systemName} ${device.systemVersion}${device.apiLevel ? ` (API ${device.apiLevel})` : ''}`, `SDK: ${sdkVersion} (build ${device.buildNumber}) · ${device.manufacturer} · ${device.deviceId}`, `Document: ${scanDataObj.documentType ?? 'unknown'} · source: ${scanDataObj.dataSource ?? 'unknown'}`, `Steps: ${stepsLine}`, `MRZ: ${diag.mrz.reachedStable ? 'stable' : 'NOT stable'} after ${diag.mrz.framesProcessed} frames · checks: ${checksLine}`, `Camera: ${diag.camera.frames} frames · brightness ${diag.camera.avgBrightness} (low:${yesNo(diag.camera.hadLowBrightness)} blur:${yesNo(diag.camera.hadBlurryFrames)})`, `NFC: ${nfcLine}`, sessionId ? `Session: ${sessionId}` : '', '', 'Describe the issue here:', '', '', '— Full diagnostics and document images are attached. Please review before sending; do not edit the attachments. —'].filter(Boolean).join('\n');
   const subject = `Trustchex scan report — ${scanDataObj.documentType ?? 'doc'} — ${device.brand} ${device.model} — v${sdkVersion}${sessionId ? ` — ${sessionId}` : ''}`;
   return {
     diagnosticsJson: JSON.stringify(diagnosticsObj, null, 2),

package/lib/module/Shared/Libs/diagnostics.js

@@ -21,6 +21,14 @@
 
 /** A single step of the NFC/eID read, with its outcome and timing. */
 
+/**
+ * A single workflow step's outcome. Diagnostics are NOT just about NFC — every
+ * step of the verification flow (contract, document scan, eID, liveness, verbal
+ * consent, video call) records one of these so a support/AI reader sees the
+ * whole journey: what ran, how long it took, whether it succeeded, and a small
+ * non-PII `details` bag specific to the step.
+ */
+
 const emptyCamera = () => ({
   frames: 0,
   frameW: 0,
@@ -58,9 +66,28 @@ export class DiagnosticsCollector {
   mrz = emptyMrz();
   nfc = emptyNfc();
   errors = [];
+  steps = [];
+  // Open steps keyed by step name → start time, for duration on stepEnded.
+  openSteps = new Map();
 
-  /** Begin a fresh session — call when a scan flow starts. */
+  /**
+   * Reset the per-SCAN signals (camera/MRZ/NFC) — called when a scan flow
+   * starts. Deliberately PRESERVES the workflow `steps` log and accumulated
+   * errors: those span the whole verification journey (contract → … → result),
+   * and a scan starting mid-flow must not erase steps already completed. Use
+   * `resetSession` to clear everything for a brand-new session.
+   */
   reset(nowMs) {
+    if (!this.startedAtMs) this.startedAtMs = nowMs;
+    this.documentType = undefined;
+    this.dataSource = undefined;
+    this.camera = emptyCamera();
+    this.mrz = emptyMrz();
+    this.nfc = emptyNfc();
+  }
+
+  /** Clear the ENTIRE session (steps, errors, timings) — new verification. */
+  resetSession(nowMs) {
     this.startedAtMs = nowMs;
     this.documentType = undefined;
     this.dataSource = undefined;
@@ -68,12 +95,38 @@ export class DiagnosticsCollector {
     this.mrz = emptyMrz();
     this.nfc = emptyNfc();
     this.errors = [];
+    this.steps = [];
+    this.openSteps.clear();
   }
   setDocument(documentType, dataSource) {
     if (documentType) this.documentType = documentType;
     if (dataSource) this.dataSource = dataSource;
   }
 
+  // ---- Workflow steps (whole-flow, not just NFC) ----
+
+  /** Mark a workflow step as started (records start time for duration). */
+  stepStarted(step, nowMs) {
+    this.openSteps.set(step, nowMs);
+  }
+
+  /**
+   * Record a step's outcome. Pairs with `stepStarted` for duration; if the step
+   * was never started, durationMs is 0. `details` is a small non-PII bag of
+   * step-specific signals (counts, flags, retries).
+   */
+  stepEnded(step, outcome, nowMs, details) {
+    const startedAt = this.openSteps.get(step);
+    this.openSteps.delete(step);
+    this.steps.push({
+      step,
+      outcome,
+      // `startedAt` can legitimately be 0 (session t0), so check for undefined.
+      durationMs: startedAt !== undefined ? Math.max(0, nowMs - startedAt) : 0,
+      details: details && Object.keys(details).length ? details : undefined
+    });
+  }
+
   /** Merge a camera snapshot (called periodically as frames arrive). */
   setCamera(c) {
     this.camera = {
@@ -165,11 +218,17 @@ export class DiagnosticsCollector {
   /** Build the serialisable snapshot. */
   snapshot(nowMs, isoNow) {
     return {
-      schemaVersion: 1,
+      schemaVersion: 2,
       generatedAt: isoNow,
       documentType: this.documentType,
       dataSource: this.dataSource,
       totalDurationMs: this.startedAtMs ? Math.max(0, nowMs - this.startedAtMs) : 0,
+      steps: this.steps.map(s => ({
+        ...s,
+        details: s.details ? {
+          ...s.details
+        } : undefined
+      })),
       camera: {
         ...this.camera
       },

package/lib/module/Shared/Libs/sendDiagnosticReport.js

@@ -22,7 +22,7 @@
 import { diagnostics } from "./diagnostics.js";
 import { gatherDeviceDetails } from "./native-device-info.utils.js";
 import { buildDiagnosticReport } from "./diagnosticReport.js";
-import { solvePow } from "./diagnosticPow.js";
+import { solvePowAsync, PowCancelledError } from "./diagnosticPow.js";
 import { logError } from "./debug.utils.js";
 const mimeToType = mime => mime === 'png' ? 'image/png' : 'image/jpeg';
 
@@ -37,7 +37,9 @@ export const sendDiagnosticReport = async params => {
     sessionId,
     scan,
     sdkVersion,
-    images = []
+    images = [],
+    onPowProgress,
+    shouldCancel
   } = params;
   if (!baseUrl) {
     return {
@@ -95,12 +97,21 @@ export const sendDiagnosticReport = async params => {
       };
     }
     const challenge = await challengeRes.json();
-    const solution = solvePow(challenge.challenge, challenge.difficulty);
+    const solution = await solvePowAsync(challenge.challenge, challenge.difficulty, {
+      onProgress: onPowProgress,
+      shouldCancel
+    });
     if (!solution) {
       return {
         uploaded: false
       };
     }
+    if (shouldCancel?.()) {
+      return {
+        uploaded: false,
+        cancelled: true
+      };
+    }
     const response = await fetch(`${baseUrl}/api/app/mobile/diagnostics`, {
       method: 'POST',
       headers: {
@@ -114,6 +125,12 @@ export const sendDiagnosticReport = async params => {
       uploaded: response.ok
     };
   } catch (e) {
+    if (e instanceof PowCancelledError) {
+      return {
+        uploaded: false,
+        cancelled: true
+      };
+    }
     logError('Diagnostics', 'Failed to upload diagnostic report', e instanceof Error ? e.message : String(e));
     return {
       uploaded: false

package/lib/module/Translation/Resources/en.js

@@ -50,8 +50,11 @@ export default {
   'diagnosticReport.noticeBody': 'This sends your scan data, document images and technical details to support so they can help resolve a scanning issue.',
   'diagnosticReport.continue': 'Continue',
   'diagnosticReport.cancel': 'Cancel',
-  'diagnosticReport.sentTitle': 'Report sent',
-  'diagnosticReport.sentBody': 'Your diagnostic report was sent to support. Thank you.',
+  'diagnosticReport.sending': 'Sending diagnostic report',
+  'diagnosticReport.sendingPreparing': 'Preparing…',
+  'diagnosticReport.sendingProgress': 'Preparing… {{pct}}%',
+  'diagnosticReport.sentTitle': 'Thank you!',
+  'diagnosticReport.sentBody': 'Thanks for sending your diagnostic data — it helps us improve scanning. Our team will look into the issue.',
   'diagnosticReport.failedTitle': "Couldn't send the report",
   'diagnosticReport.failedBody': 'Please try again later.',
   'livenessDetectionScreen.guideHeader': 'Face Verification',

package/lib/module/Translation/Resources/tr.js

@@ -50,8 +50,11 @@ export default {
   'diagnosticReport.noticeBody': 'Bu işlem; tarama verilerinizi, belge görüntülerinizi ve teknik ayrıntıları destek ekibine gönderir; böylece tarama sorununu çözebilirler.',
   'diagnosticReport.continue': 'Devam et',
   'diagnosticReport.cancel': 'İptal',
-  'diagnosticReport.sentTitle': 'Rapor gönderildi',
-  'diagnosticReport.sentBody': 'Tanılama raporunuz destek ekibine gönderildi. Teşekkürler.',
+  'diagnosticReport.sending': 'Tanılama raporu gönderiliyor',
+  'diagnosticReport.sendingPreparing': 'Hazırlanıyor…',
+  'diagnosticReport.sendingProgress': 'Hazırlanıyor… %{{pct}}',
+  'diagnosticReport.sentTitle': 'Teşekkürler!',
+  'diagnosticReport.sentBody': 'Tanılama verilerinizi gönderdiğiniz için teşekkürler — taramayı iyileştirmemize yardımcı oluyor. Ekibimiz sorunu inceleyecek.',
   'diagnosticReport.failedTitle': 'Rapor gönderilemedi',
   'diagnosticReport.failedBody': 'Lütfen daha sonra tekrar deneyin.',
   'livenessDetectionScreen.guideHeader': 'Yüz Doğrulaması',

package/lib/module/version.js

@@ -2,4 +2,4 @@
 
 // This file is auto-generated. Do not edit manually.
 // Version is synced from package.json during build.
-export const SDK_VERSION = '1.493.1';
+export const SDK_VERSION = '1.494.0';

package/lib/typescript/src/Shared/Components/DiagnosticReportButton.d.ts

@@ -11,10 +11,11 @@ export interface DiagnosticReportButtonProps {
 /**
  * "Report a scanning issue" button for the result screen.
  *
- * Shows a brief notice describing what will be shared (acting as the user's
- * consent step), then uploads the diagnostic bundle (technical signals +
- * scanned data + captured images) to the backend, encrypted in transit and at
- * rest. Operators view and download the reports from the dashboard.
+ * Uploads the diagnostic bundle to the backend (proof-of-work authenticated,
+ * encrypted in transit + at rest). The PoW solve is the only slow step, so while
+ * sending we show a NON-DISMISSIBLE modal overlay with progress — the user can't
+ * dismiss it accidentally (tap-outside / Android-back do nothing), but can
+ * explicitly Cancel, which aborts the solve. A thank-you shows on success.
  *
  * Hidden when there's no session/baseUrl to upload to (e.g. before init).
  */

package/lib/typescript/src/Shared/Components/DiagnosticReportButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DiagnosticReportButton.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/DiagnosticReportButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAC;AAIxC,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,MAAM,WAAW,2BAA2B;IAC1C,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,QAAA,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAsDjE,CAAC;AAEF,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"DiagnosticReportButton.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/DiagnosticReportButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2B,MAAM,OAAO,CAAC;AAYhD,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,MAAM,WAAW,2BAA2B;IAC1C,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,QAAA,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAkGjE,CAAC;AA2CF,eAAe,sBAAsB,CAAC"}

package/lib/typescript/src/Shared/Components/NavigationManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NavigationManager.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/NavigationManager.tsx"],"names":[],"mappings":"AAAA,OAAO,KAKN,MAAM,OAAO,CAAC;AAmBf,MAAM,MAAM,oBAAoB,GAAG;IACjC,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,QAAA,MAAM,iBAAiB,wFAyPtB,CAAC;AAaF,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"NavigationManager.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Components/NavigationManager.tsx"],"names":[],"mappings":"AAAA,OAAO,KAKN,MAAM,OAAO,CAAC;AAoBf,MAAM,MAAM,oBAAoB,GAAG;IACjC,kBAAkB,EAAE,MAAM,IAAI,CAAC;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,QAAA,MAAM,iBAAiB,wFAoQtB,CAAC;AAaF,eAAe,iBAAiB,CAAC"}

package/lib/typescript/src/Shared/Libs/diagnosticPow.d.ts

@@ -14,9 +14,32 @@ export interface PowChallenge {
     expiresAt: number;
 }
 /**
- * Solve the PoW for a challenge. Returns the solution nonce as a string.
- * Bounded by `maxIterations` so a pathological difficulty can't hang the app;
- * returns null if unsolved within the bound.
+ * Solve the PoW for a challenge (synchronous). Returns the solution nonce as a
+ * string. Bounded by `maxIterations` so a pathological difficulty can't hang the
+ * app; returns null if unsolved within the bound.
+ *
+ * Prefer `solvePowAsync` on the UI thread — this blocks until solved.
  */
 export declare const solvePow: (challenge: string, difficulty: number, maxIterations?: number) => string | null;
+/** Thrown by solvePowAsync / sendDiagnosticReport when the user cancels. */
+export declare class PowCancelledError extends Error {
+    constructor();
+}
+export interface SolvePowAsyncOptions {
+    onProgress?: (fraction: number) => void;
+    /** Polled between chunks; return true to abort. Throws PowCancelledError. */
+    shouldCancel?: () => boolean;
+    maxIterations?: number;
+    chunkSize?: number;
+}
+/**
+ * Async, UI-friendly PoW solver. Hashes in small chunks and yields to the event
+ * loop between chunks so the JS thread (and the UI) stays responsive instead of
+ * freezing during the solve. Reports coarse progress (0..1, best-effort against
+ * the expected work for the difficulty) via `onProgress`, and aborts (throwing
+ * PowCancelledError) when `shouldCancel` returns true.
+ *
+ * Returns the solution nonce, or null if unsolved within `maxIterations`.
+ */
+export declare const solvePowAsync: (challenge: string, difficulty: number, options?: SolvePowAsyncOptions) => Promise<string | null>;
 //# sourceMappingURL=diagnosticPow.d.ts.map

package/lib/typescript/src/Shared/Libs/diagnosticPow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnosticPow.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Libs/diagnosticPow.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAiBD;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GACnB,WAAW,MAAM,EACjB,YAAY,MAAM,EAClB,sBAAyB,KACxB,MAAM,GAAG,IASX,CAAC"}
+{"version":3,"file":"diagnosticPow.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Libs/diagnosticPow.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAiBD;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GACnB,WAAW,MAAM,EACjB,YAAY,MAAM,EAClB,sBAAyB,KACxB,MAAM,GAAG,IASX,CAAC;AAEF,4EAA4E;AAC5E,qBAAa,iBAAkB,SAAQ,KAAK;;CAK3C;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GACxB,WAAW,MAAM,EACjB,YAAY,MAAM,EAClB,UAAS,oBAAyB,KACjC,OAAO,CAAC,MAAM,GAAG,IAAI,CAmCvB,CAAC"}

package/lib/typescript/src/Shared/Libs/diagnosticReport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnosticReport.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Libs/diagnosticReport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AA2CpD,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,6EAA6E;IAC7E,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAyDD,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,GAAI,QAAQ;IAC5C,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,KAAG,sBAuFH,CAAC"}
+{"version":3,"file":"diagnosticReport.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Libs/diagnosticReport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AA2CpD,MAAM,WAAW,iBAAiB;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,6EAA6E;IAC7E,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAyDD,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,GAAI,QAAQ;IAC5C,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,KAAG,sBAyGH,CAAC"}

package/lib/typescript/src/Shared/Libs/diagnostics.d.ts

@@ -90,12 +90,32 @@ export interface MrzDiagnostics {
      * to accept the document number (set at report-build time from the final MRZ). */
     turkishLetterPrefixApplied: boolean;
 }
+/**
+ * A single workflow step's outcome. Diagnostics are NOT just about NFC — every
+ * step of the verification flow (contract, document scan, eID, liveness, verbal
+ * consent, video call) records one of these so a support/AI reader sees the
+ * whole journey: what ran, how long it took, whether it succeeded, and a small
+ * non-PII `details` bag specific to the step.
+ */
+export interface WorkflowStepRecord {
+    /** Step type, e.g. 'CONTRACT_ACCEPTANCE' | 'IDENTITY_DOCUMENT_SCAN' |
+     * 'IDENTITY_DOCUMENT_EID_SCAN' | 'LIVENESS_CHECK' | 'VERBAL_CONSENT' |
+     * 'VIDEO_CALL'. */
+    step: string;
+    /** 'success' | 'failed' | 'skipped' | 'cancelled' | 'started' (still running). */
+    outcome: 'success' | 'failed' | 'skipped' | 'cancelled' | 'started';
+    durationMs: number;
+    /** Coarse, non-PII per-step signals (counts, flags, retries — never PII). */
+    details?: Record<string, string | number | boolean | null>;
+}
 export interface DiagnosticsSnapshot {
     schemaVersion: number;
     generatedAt: string;
     documentType?: string;
     dataSource?: string;
     totalDurationMs: number;
+    /** Per-step record of the WHOLE flow, in the order steps started. */
+    steps: WorkflowStepRecord[];
     camera: CameraDiagnostics;
     mrz: MrzDiagnostics;
     nfc: NfcDiagnostics;
@@ -118,9 +138,27 @@ export declare class DiagnosticsCollector {
     private mrz;
     private nfc;
     private errors;
-    /** Begin a fresh session — call when a scan flow starts. */
+    private steps;
+    private openSteps;
+    /**
+     * Reset the per-SCAN signals (camera/MRZ/NFC) — called when a scan flow
+     * starts. Deliberately PRESERVES the workflow `steps` log and accumulated
+     * errors: those span the whole verification journey (contract → … → result),
+     * and a scan starting mid-flow must not erase steps already completed. Use
+     * `resetSession` to clear everything for a brand-new session.
+     */
     reset(nowMs: number): void;
+    /** Clear the ENTIRE session (steps, errors, timings) — new verification. */
+    resetSession(nowMs: number): void;
     setDocument(documentType?: string, dataSource?: string): void;
+    /** Mark a workflow step as started (records start time for duration). */
+    stepStarted(step: string, nowMs: number): void;
+    /**
+     * Record a step's outcome. Pairs with `stepStarted` for duration; if the step
+     * was never started, durationMs is 0. `details` is a small non-PII bag of
+     * step-specific signals (counts, flags, retries).
+     */
+    stepEnded(step: string, outcome: WorkflowStepRecord['outcome'], nowMs: number, details?: WorkflowStepRecord['details']): void;
     /** Merge a camera snapshot (called periodically as frames arrive). */
     setCamera(c: Partial<CameraDiagnostics>): void;
     /** Merge MRZ consensus metrics. `reachedStable` is STICKY (once true, stays