@trustchex/react-native-sdk 1.478.7 → 1.481.1

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

@@ -9,6 +9,20 @@ export interface MRZFrameInput {
      * focus-weighted voting beats unweighted.
      */
     weight?: number;
+    /**
+     * Optional OCR confidence for this frame, in [0, 1] — e.g. ML Kit's mean
+     * per-symbol confidence over the MRZ characters (Android bundled library only;
+     * iOS ML Kit exposes no symbol confidence). When present it MULTIPLIES `weight`,
+     * so a frame the recognizer was unsure about contributes proportionally fewer
+     * votes than a confident one of the same sharpness. This is the per-frame form
+     * of confidence-weighted voting: it can't misalign cells (unlike threading
+     * per-column confidence through the column-shifting line reconstruction), yet
+     * still lets confident frames dominate look-alike ties (A↔4, S↔5, B↔8).
+     *
+     * A confidence floor is applied so a single near-zero frame is down-weighted
+     * but never fully silenced (it may still hold the only vote for some cell).
+     */
+    confidence?: number;
 }
 export interface MRZConsensus {
     /** Best consensus MRZ (newline-joined fixed-width lines), or null if none yet. */
@@ -22,6 +36,18 @@ export interface MRZConsensus {
      * last `stabilityTarget` contributing frames. Callers should advance only then.
      */
     stable: boolean;
+    /**
+     * How many consecutive contributing frames the current (valid) consensus has
+     * stayed unchanged. Diagnostic: convergence speed across devices.
+     */
+    stableStreak: number;
+    /**
+     * Smallest winning vote margin across all CONTESTED cells of the best format
+     * (cells where >1 distinct char was voted). Higher = more confident reading;
+     * a low value at acceptance means a look-alike was barely resolved. Infinity
+     * when no cell is contested (a perfectly clean read). Diagnostic only.
+     */
+    minContestedMargin: number;
 }
 export interface MRZFrameAggregatorOptions {
     /**
@@ -89,6 +115,13 @@ export declare class MRZFrameAggregator {
      * is what turns "looks valid this frame" into "the camera agrees across frames".
      */
     private consensusIsConfident;
+    /**
+     * Smallest winning vote margin across all CONTESTED cells (where >1 distinct
+     * char was voted). Returns Infinity when no cell is contested. Used both to
+     * gate confidence and to surface a diagnostic of how narrowly a look-alike was
+     * resolved at acceptance.
+     */
+    private minContestedMargin;
     /** Read out the winning character per cell for a format. */
     private consensusLines;
     /** Best consensus across all formats seen, validated with check digits. */

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

@@ -1 +1 @@
-{"version":3,"file":"mrzFrameAggregator.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Libs/mrzFrameAggregator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAkCvD,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,+EAA+E;IAC/E,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACvC,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAkFD;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAInC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,YAAY,CAAK;IAEzB,OAAO,CAAC,cAAc,CAAK;gBAEf,OAAO,GAAE,yBAA8B;IAMnD,KAAK,IAAI,IAAI;IAQb;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IA0B5B,iCAAiC;IACjC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,OAAO,CAAC,WAAW;IAUnB;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY;IAuC5C,+EAA+E;IAC/E,OAAO,CAAC,KAAK;IAab;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,oBAAoB;IAe5B,4DAA4D;IAC5D,OAAO,CAAC,cAAc;IA8BtB,2EAA2E;IAC3E,gBAAgB,IAAI,YAAY;CA4DjC;AAED,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"mrzFrameAggregator.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Libs/mrzFrameAggregator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAkCvD,MAAM,WAAW,aAAa;IAC5B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AASD,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,+EAA+E;IAC/E,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACvC,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAkFD;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAInC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,YAAY,CAAK;IAEzB,OAAO,CAAC,cAAc,CAAK;gBAEf,OAAO,GAAE,yBAA8B;IAMnD,KAAK,IAAI,IAAI;IAQb;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IA0B5B,iCAAiC;IACjC,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,OAAO,CAAC,WAAW;IAUnB;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY;IA+C5C,+EAA+E;IAC/E,OAAO,CAAC,KAAK;IAab;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAiB1B,4DAA4D;IAC5D,OAAO,CAAC,cAAc;IA8BtB,2EAA2E;IAC3E,gBAAgB,IAAI,YAAY;CAiEjC;AAED,eAAe,kBAAkB,CAAC"}

package/lib/typescript/src/Shared/Libs/native-device-info.utils.d.ts

@@ -1,3 +1,36 @@
+/**
+ * Full, non-PII device details for the support diagnostic report. Device-
+ * specific scanning/NFC issues correlate with hardware, OS level, memory and
+ * NFC capability, so we capture a broad-but-safe set. Excludes anything that
+ * identifies a person (uniqueId is a per-install vendor id, not PII, and is kept
+ * only for correlating repeat reports from the same device).
+ */
+export interface DeviceDetails {
+    platform: string;
+    systemName: string;
+    systemVersion: string;
+    apiLevel?: number;
+    brand: string;
+    manufacturer: string;
+    model: string;
+    deviceId: string;
+    deviceType: string;
+    isTablet: boolean;
+    isEmulator: boolean;
+    hasNotch: boolean;
+    totalMemoryMB?: number;
+    usedMemoryMB?: number;
+    totalDiskMB?: number;
+    freeDiskMB?: number;
+    batteryLevel?: number;
+    appVersion: string;
+    buildNumber: string;
+    bundleId: string;
+    fontScale?: number;
+    installerPackage?: string;
+}
+/** Gather the full non-PII device profile for a diagnostic report. */
+export declare const gatherDeviceDetails: () => Promise<DeviceDetails>;
 export declare const NativeDeviceInfo: {
     generateHumanReadableIdentifier: () => Promise<string>;
 };

package/lib/typescript/src/Shared/Libs/native-device-info.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-device-info.utils.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Libs/native-device-info.utils.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB;2CACgB,OAAO,CAAC,MAAM,CAAC;CAe3D,CAAC;AAEF,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"native-device-info.utils.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Libs/native-device-info.utils.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA8BD,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,QAAa,OAAO,CAAC,aAAa,CAqDjE,CAAC;AAEF,eAAO,MAAM,gBAAgB;2CACgB,OAAO,CAAC,MAAM,CAAC;CAe3D,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

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

@@ -0,0 +1,30 @@
+import { type ScanDataForReport } from './diagnosticReport';
+/**
+ * Whether diagnostic sharing is available (i.e. `react-native-share` is
+ * installed in the host app). The result-screen button hides itself when false.
+ */
+export declare const isDiagnosticSharingAvailable: () => boolean;
+export interface DiagnosticImage {
+    /** Stable file name without extension, e.g. "mrz-side". */
+    name: string;
+    base64: string;
+    mime: 'jpg' | 'png';
+}
+export interface SendDiagnosticParams {
+    scan: ScanDataForReport;
+    sdkVersion: string;
+    sessionId?: string;
+    /** base64 images to attach (MRZ side / front / face / NFC chip face). */
+    images?: DiagnosticImage[];
+}
+export interface SendResult {
+    shared: boolean;
+    /** True when the user dismissed the share sheet (not an error). */
+    dismissed?: boolean;
+}
+/**
+ * Build the report, stage attachments, and present the share sheet. Returns
+ * { shared } — false on error, with `dismissed` set when the user cancelled.
+ */
+export declare const sendDiagnosticReport: (params: SendDiagnosticParams) => Promise<SendResult>;
+//# sourceMappingURL=sendDiagnosticReport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sendDiagnosticReport.d.ts","sourceRoot":"","sources":["../../../../../src/Shared/Libs/sendDiagnosticReport.ts"],"names":[],"mappings":"AAqBA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAyB5B;;;GAGG;AACH,eAAO,MAAM,4BAA4B,QAAO,OAA8B,CAAC;AAE/E,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAcD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,oBAAoB,KAC3B,OAAO,CAAC,UAAU,CAsEpB,CAAC"}

package/lib/typescript/src/Translation/Resources/en.d.ts

@@ -43,6 +43,11 @@ declare const _default: {
     'resultScreen.demoVerbalConsentTitle': string;
     'resultScreen.demoVerbalConsentText': string;
     'resultScreen.demoStartOver': string;
+    'diagnosticReport.button': string;
+    'diagnosticReport.noticeTitle': string;
+    'diagnosticReport.noticeBody': string;
+    'diagnosticReport.continue': string;
+    'diagnosticReport.cancel': string;
     'livenessDetectionScreen.guideHeader': string;
     'livenessDetectionScreen.guideText': string;
     'livenessDetectionScreen.guidePoint1': string;

package/lib/typescript/src/Translation/Resources/en.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../../../src/Translation/Resources/en.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBA0PE"}
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../../../../src/Translation/Resources/en.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAgQE"}

package/lib/typescript/src/Translation/Resources/tr.d.ts

@@ -43,6 +43,11 @@ declare const _default: {
     'resultScreen.demoVerbalConsentTitle': string;
     'resultScreen.demoVerbalConsentText': string;
     'resultScreen.demoStartOver': string;
+    'diagnosticReport.button': string;
+    'diagnosticReport.noticeTitle': string;
+    'diagnosticReport.noticeBody': string;
+    'diagnosticReport.continue': string;
+    'diagnosticReport.cancel': string;
     'livenessDetectionScreen.guideHeader': string;
     'livenessDetectionScreen.guideText': string;
     'livenessDetectionScreen.guidePoint1': string;

package/lib/typescript/src/Translation/Resources/tr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tr.d.ts","sourceRoot":"","sources":["../../../../../src/Translation/Resources/tr.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBA6PE"}
+{"version":3,"file":"tr.d.ts","sourceRoot":"","sources":["../../../../../src/Translation/Resources/tr.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAmQE"}

package/lib/typescript/src/Trustchex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Trustchex.d.ts","sourceRoot":"","sources":["../../../src/Trustchex.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAC;AAKpE,OAAO,gCAAgC,CAAC;AAgCxC,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACrE;AASD,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAgOvC,CAAC;AAWF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"Trustchex.d.ts","sourceRoot":"","sources":["../../../src/Trustchex.tsx"],"names":[],"mappings":"AAAA,OAAO,KAMN,MAAM,OAAO,CAAC;AAKf,OAAO,gCAAgC,CAAC;AAgCxC,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACrE;AASD,QAAA,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAiPvC,CAAC;AAWF,eAAe,SAAS,CAAC"}

package/lib/typescript/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "1.478.7";
+export declare const SDK_VERSION = "1.481.1";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trustchex/react-native-sdk",
-  "version": "1.478.7",
+  "version": "1.481.1",
   "description": "Trustchex mobile app react native SDK for android or ios devices",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -169,6 +169,7 @@
     "react-native-nfc-manager": ">=3.16.2",
     "react-native-safe-area-context": ">=5.5.2",
     "react-native-screens": ">=4.18.0",
+    "react-native-share": ">=12.0.0",
     "react-native-sse": ">=1.1.0",
     "react-native-svg": ">=15.12.0",
     "react-native-tts": ">=4.1.1",
@@ -216,6 +217,9 @@
     "react-native-screens": {
       "optional": false
     },
+    "react-native-share": {
+      "optional": true
+    },
     "react-native-sse": {
       "optional": false
     },

package/src/Screens/Static/ResultScreen.tsx

@@ -39,7 +39,32 @@ import { Video as VideoCompressor } from 'react-native-compressor';
 import { encryptWithAes, getSessionKey } from '../../Shared/Libs/crypto.utils';
 import Video from 'react-native-video';
 import StyledButton from '../../Shared/Components/StyledButton';
+import DiagnosticReportButton from '../../Shared/Components/DiagnosticReportButton';
+import type { DiagnosticImage } from '../../Shared/Libs/sendDiagnosticReport';
 import NativeDeviceInfo from '../../Shared/Libs/native-device-info.utils';
+
+/**
+ * Collect the captured document/face images (base64) as attachments for a
+ * diagnostic report. On an ID card the BACK image is the MRZ side; on a passport
+ * the front carries the MRZ. The NFC chip face arrives as `faceImage` with its
+ * own mime type, which may be png.
+ */
+const collectDiagnosticImages = (
+  doc?: ScannedIdentityDocument
+): DiagnosticImage[] => {
+  if (!doc) return [];
+  const out: DiagnosticImage[] = [];
+  const push = (name: string, b64?: string, mime: 'jpg' | 'png' = 'jpg') => {
+    if (b64 && b64 !== '') out.push({ name, base64: b64, mime });
+  };
+  push('mrz-side', doc.backImage);
+  push('front', doc.frontImage);
+  const faceMime = doc.faceImageMimeType === 'image/png' ? 'png' : 'jpg';
+  push('face', doc.faceImage, faceMime);
+  push('secondary-face', doc.secondaryFaceImage);
+  push('hologram', doc.hologramImage);
+  return out;
+};
 import {
   trackError,
   trackFunnelStep,
@@ -1045,7 +1070,7 @@ const ResultScreen = () => {
                 )}
               </View>
             </ScrollView>
-            <View style={{ paddingBottom: insets.bottom }}>
+            <View style={[styles.footer, { paddingBottom: insets.bottom + 20 }]}>
               <StyledButton
                 mode="contained"
                 onPress={() => {
@@ -1055,6 +1080,26 @@ const ResultScreen = () => {
               >
                 {t('resultScreen.demoStartOver')}
               </StyledButton>
+              <DiagnosticReportButton
+                sessionId={appContext.identificationInfo?.sessionId}
+                scan={{
+                  documentType:
+                    appContext.identificationInfo?.scannedDocument
+                      ?.documentType,
+                  dataSource:
+                    appContext.identificationInfo?.scannedDocument?.dataSource,
+                  mrzText:
+                    appContext.identificationInfo?.scannedDocument?.mrzText,
+                  mrzFields:
+                    appContext.identificationInfo?.scannedDocument?.mrzFields,
+                  barcodeValue:
+                    appContext.identificationInfo?.scannedDocument
+                      ?.barcodeValue,
+                }}
+                images={collectDiagnosticImages(
+                  appContext.identificationInfo?.scannedDocument
+                )}
+              />
             </View>
           </>
         ) : (

package/src/Shared/Components/DiagnosticReportButton.tsx

@@ -0,0 +1,77 @@
+import React, { useState } from 'react';
+import { Alert } from 'react-native';
+import { useTranslation } from 'react-i18next';
+import StyledButton from './StyledButton';
+import {
+  sendDiagnosticReport,
+  isDiagnosticSharingAvailable,
+  type DiagnosticImage,
+} from '../Libs/sendDiagnosticReport';
+import type { ScanDataForReport } from '../Libs/diagnosticReport';
+import { SDK_VERSION } from '../../version';
+
+export interface DiagnosticReportButtonProps {
+  scan: ScanDataForReport;
+  sessionId?: string;
+  images?: DiagnosticImage[];
+}
+
+/**
+ * "Report a scanning issue" button for the result screen.
+ *
+ * Shows a brief notice describing what will be shared (the draft itself is the
+ * user's review/consent step), then opens the OS share sheet — the user picks
+ * email / WhatsApp / Drive / etc. and sends the diagnostic bundle to support.
+ * Self-contained so the result screen only needs to render it with the scan
+ * data + captured images.
+ */
+const DiagnosticReportButton: React.FC<DiagnosticReportButtonProps> = ({
+  scan,
+  sessionId,
+  images,
+}) => {
+  const { t } = useTranslation();
+  const [sending, setSending] = useState(false);
+
+  // `react-native-share` is optional — hide the button entirely when the host
+  // app hasn't installed it, so apps that don't want diagnostics see no UI.
+  if (!isDiagnosticSharingAvailable()) {
+    return null;
+  }
+
+  const onPress = () => {
+    if (sending) return;
+    // Brief notice — the share draft is the actual review/consent step.
+    Alert.alert(
+      t('diagnosticReport.noticeTitle'),
+      t('diagnosticReport.noticeBody'),
+      [
+        { text: t('diagnosticReport.cancel'), style: 'cancel' },
+        {
+          text: t('diagnosticReport.continue'),
+          onPress: async () => {
+            setSending(true);
+            try {
+              await sendDiagnosticReport({
+                scan,
+                sdkVersion: SDK_VERSION,
+                sessionId,
+                images,
+              });
+            } finally {
+              setSending(false);
+            }
+          },
+        },
+      ]
+    );
+  };
+
+  return (
+    <StyledButton mode="outlined" onPress={onPress} disabled={sending}>
+      {t('diagnosticReport.button')}
+    </StyledButton>
+  );
+};
+
+export default DiagnosticReportButton;