@microblink/blinkid-react-native 7.2.0 → 7.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (100) hide show
  1. package/android/.gradle/8.9/checksums/checksums.lock +0 -0
  2. package/android/.gradle/8.9/checksums/md5-checksums.bin +0 -0
  3. package/android/.gradle/8.9/checksums/sha1-checksums.bin +0 -0
  4. package/android/.gradle/8.9/fileHashes/fileHashes.lock +0 -0
  5. package/android/.gradle/buildOutputCleanup/buildOutputCleanup.lock +0 -0
  6. package/android/.gradle/buildOutputCleanup/cache.properties +1 -1
  7. package/android/build.gradle +1 -1
  8. package/android/src/main/java/com/microblink/blinkid/reactnative/BlinkIdDeserializationUtilities.kt +2 -1
  9. package/android/src/main/java/com/microblink/blinkid/reactnative/BlinkIdSerializationUtilities.kt +21 -3
  10. package/android/src/main/java/com/microblink/blinkid/reactnative/BlinkidReactNativeModule.kt +14 -2
  11. package/ios/BlinkIdDeserializationUtilities.swift +3 -0
  12. package/ios/BlinkIdSerializationUtilities.swift +151 -53
  13. package/ios/BlinkidReactNativeModule.swift +22 -3
  14. package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/BlinkID +0 -0
  15. package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/Headers/BlinkID-Swift.h +24563 -16979
  16. package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/Info.plist +0 -0
  17. package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios.abi.json +14027 -608
  18. package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios.private.swiftinterface +462 -14
  19. package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios.swiftdoc +0 -0
  20. package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios.swiftinterface +462 -14
  21. package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/PrivateHeaders/SwiftCxxBridge.hpp +1 -0
  22. package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/_CodeSignature/CodeResources +17 -17
  23. package/ios/Frameworks/BlinkID.xcframework/ios-arm64/BlinkID.framework/conan.xcconfig +3 -3
  24. package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/BlinkID +0 -0
  25. package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Headers/BlinkID-Swift.h +49697 -34548
  26. package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Info.plist +0 -0
  27. package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios-simulator.abi.json +14027 -608
  28. package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface +462 -14
  29. package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios-simulator.swiftdoc +0 -0
  30. package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/arm64-apple-ios-simulator.swiftinterface +462 -14
  31. package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/x86_64-apple-ios-simulator.abi.json +14027 -608
  32. package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface +462 -14
  33. package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/x86_64-apple-ios-simulator.swiftdoc +0 -0
  34. package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/Modules/BlinkID.swiftmodule/x86_64-apple-ios-simulator.swiftinterface +462 -14
  35. package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/PrivateHeaders/SwiftCxxBridge.hpp +1 -0
  36. package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/_CodeSignature/CodeResources +27 -27
  37. package/ios/Frameworks/BlinkID.xcframework/ios-arm64_x86_64-simulator/BlinkID.framework/conan.xcconfig +3 -3
  38. package/ios/Frameworks/BlinkIDUX.xcframework/Info.plist +5 -5
  39. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/BlinkIDUX +0 -0
  40. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/Assets.car +0 -0
  41. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/Info.plist +0 -0
  42. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/hr.lproj/Localizable.strings +0 -0
  43. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/Info.plist +0 -0
  44. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios.abi.json +708 -193
  45. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios.package.swiftinterface +28 -41
  46. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios.private.swiftinterface +28 -41
  47. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios.swiftdoc +0 -0
  48. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios.swiftinterface +28 -41
  49. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/BlinkIDUX +0 -0
  50. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/Assets.car +0 -0
  51. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/Info.plist +0 -0
  52. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/_CodeSignature/CodeDirectory +0 -0
  53. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/_CodeSignature/CodeRequirements-1 +0 -0
  54. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/_CodeSignature/CodeResources +6 -6
  55. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/BlinkIDUX_BlinkIDUX.bundle/hr.lproj/Localizable.strings +0 -0
  56. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Info.plist +0 -0
  57. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios-simulator.abi.json +708 -193
  58. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios-simulator.package.swiftinterface +28 -41
  59. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios-simulator.private.swiftinterface +28 -41
  60. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios-simulator.swiftdoc +0 -0
  61. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/arm64-apple-ios-simulator.swiftinterface +28 -41
  62. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/x86_64-apple-ios-simulator.abi.json +708 -193
  63. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/x86_64-apple-ios-simulator.package.swiftinterface +28 -41
  64. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/x86_64-apple-ios-simulator.private.swiftinterface +28 -41
  65. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/x86_64-apple-ios-simulator.swiftdoc +0 -0
  66. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/Modules/BlinkIDUX.swiftmodule/x86_64-apple-ios-simulator.swiftinterface +28 -41
  67. package/ios/Frameworks/BlinkIDUX.xcframework/ios-arm64_x86_64-simulator/BlinkIDUX.framework/_CodeSignature/CodeResources +1 -1
  68. package/lib/module/NativeBlinkidReactNative.js +4 -4
  69. package/lib/module/NativeBlinkidReactNative.js.map +1 -1
  70. package/lib/module/blinkIdResult.js +34 -1
  71. package/lib/module/blinkIdResult.js.map +1 -1
  72. package/lib/module/blinkIdSettings.js +272 -259
  73. package/lib/module/blinkIdSettings.js.map +1 -1
  74. package/lib/module/blinkIdUtilities.js +2 -2
  75. package/lib/module/index.js +19 -19
  76. package/lib/module/index.js.map +1 -1
  77. package/lib/module/types.js +30 -9
  78. package/lib/module/types.js.map +1 -1
  79. package/lib/typescript/src/NativeBlinkidReactNative.d.ts +1 -1
  80. package/lib/typescript/src/NativeBlinkidReactNative.d.ts.map +1 -1
  81. package/lib/typescript/src/blinkIdResult.d.ts +16 -1
  82. package/lib/typescript/src/blinkIdResult.d.ts.map +1 -1
  83. package/lib/typescript/src/blinkIdSettings.d.ts +193 -181
  84. package/lib/typescript/src/blinkIdSettings.d.ts.map +1 -1
  85. package/lib/typescript/src/index.d.ts +6 -6
  86. package/lib/typescript/src/index.d.ts.map +1 -1
  87. package/lib/typescript/src/types.d.ts +20 -1
  88. package/lib/typescript/src/types.d.ts.map +1 -1
  89. package/package.json +1 -1
  90. package/src/NativeBlinkidReactNative.ts +25 -15
  91. package/src/blinkIdResult.ts +74 -74
  92. package/src/blinkIdSettings.ts +264 -250
  93. package/src/blinkIdUtilities.ts +4 -4
  94. package/src/index.tsx +56 -34
  95. package/src/types.ts +647 -688
  96. package/ios/Frameworks/BlinkIDUX.xcframework/_CodeSignature/CodeDirectory +0 -0
  97. package/ios/Frameworks/BlinkIDUX.xcframework/_CodeSignature/CodeRequirements +0 -0
  98. package/ios/Frameworks/BlinkIDUX.xcframework/_CodeSignature/CodeRequirements-1 +0 -0
  99. package/ios/Frameworks/BlinkIDUX.xcframework/_CodeSignature/CodeResources +0 -1575
  100. package/ios/Frameworks/BlinkIDUX.xcframework/_CodeSignature/CodeSignature +0 -0
@@ -1,20 +1,20 @@
1
1
  import {
2
- DetectionLevel,
3
- AnonymizationMode,
4
- ScanningMode,
5
- DocumentRules,
6
- DocumentAnonymizationSettings,
7
- RecognitionModeFilter
8
- } from './types'
2
+ DetectionLevel,
3
+ AnonymizationMode,
4
+ ScanningMode,
5
+ DocumentRules,
6
+ DocumentAnonymizationSettings,
7
+ RecognitionModeFilter,
8
+ } from "./types";
9
9
 
10
10
  /**
11
11
  * Settings for the initialization of the BlinkID SDK.
12
- *
12
+ *
13
13
  */
14
14
  export class BlinkIdSdkSettings {
15
15
  /**
16
16
  * License key for the native SDK.
17
- *
17
+ *
18
18
  */
19
19
  licenseKey: string;
20
20
 
@@ -26,23 +26,23 @@ export class BlinkIdSdkSettings {
26
26
  /**
27
27
  * Whether resources required for on-device image processing should be downloaded and cached
28
28
  * on first initialization of the SDK.
29
- *
29
+ *
30
30
  * If set to false, you need to package all the required
31
31
  * resources in your application's assets.
32
- *
32
+ *
33
33
  */
34
34
  downloadResources?: boolean;
35
35
 
36
36
  /**
37
37
  * If resources are to be downloaded, the following is the URL where the resources are hosted.
38
- *
38
+ *
39
39
  * URL: `"https://models.cdn.microblink.com/resources"`
40
40
  */
41
41
  resourceDownloadUrl?: string;
42
42
 
43
43
  /**
44
44
  * Local folder name where resources will be downloaded and cached.
45
- *
45
+ *
46
46
  * If resources are being downloaded, this defines the name of the folder within your
47
47
  * application's cache folder where resources will be cached.
48
48
  */
@@ -50,28 +50,42 @@ export class BlinkIdSdkSettings {
50
50
 
51
51
  /**
52
52
  * If resources downloading is disabled, this defines the bundle of your app where the resources reside.
53
- *
53
+ *
54
54
  */
55
55
  bundleURL?: string;
56
56
 
57
57
  /**
58
58
  * Timeout settings for resource downloads.
59
- *
60
- */
59
+ *
60
+ */
61
61
  resourceRequestTimeout?: number;
62
+ /**
63
+ * Set a custom HTTPS URL to be used as a proxy for Ping and license checks.
64
+ * The proxy URL will be applied only if the license has the appropriate rights.
65
+ *
66
+ * The URL must use the HTTPS protocol. Example: https://your-proxy.com/
67
+ *
68
+ * If this value is defined, SDK initialization will not be successful in the following cases:
69
+ * - if the URL does not use HTTPS or if the URL is invalid
70
+ * - if the license does not allow proxy usage
71
+ *
72
+ */
73
+ microblinkProxyURL?: string;
62
74
 
63
75
  /**
64
- *
65
- * Settings for the initialization of the BlinkID SDK.
66
- */
76
+ *
77
+ * Settings for the initialization of the BlinkID SDK.
78
+ */
67
79
  constructor(
68
- licenseKey: string,
69
- licensee?: string,
70
- downloadResources?: boolean,
80
+ licenseKey: string,
81
+ licensee?: string,
82
+ downloadResources?: boolean,
71
83
  resourceDownloadUrl?: string,
72
84
  resourceLocalFolder?: string,
73
85
  bundleURL?: string,
74
- resourceRequestTimeout?: number) {
86
+ resourceRequestTimeout?: number,
87
+ microblinkProxyURL?: string
88
+ ) {
75
89
  this.licenseKey = licenseKey;
76
90
  this.licensee = licensee;
77
91
  this.downloadResources = downloadResources;
@@ -79,12 +93,13 @@ export class BlinkIdSdkSettings {
79
93
  this.resourceLocalFolder = resourceLocalFolder;
80
94
  this.bundleURL = bundleURL;
81
95
  this.resourceRequestTimeout = resourceRequestTimeout;
96
+ this.microblinkProxyURL = microblinkProxyURL;
82
97
  }
83
98
  }
84
99
 
85
100
  /**
86
101
  * Represents the configuration settings for a scanning session.
87
- *
102
+ *
88
103
  * This class holds the settings related to the resources initialization,
89
104
  * scanning mode, and specific scanning configurations that define how the scanning
90
105
  * session should behave.
@@ -92,31 +107,31 @@ export class BlinkIdSdkSettings {
92
107
  export class BlinkIdSessionSettings {
93
108
  /**
94
109
  * The scanning mode to be used during the scanning session.
95
- *
110
+ *
96
111
  * Specifies whether the scanning is for a single side of a document or multiple
97
112
  * sides, as defined in {@link ScanningMode}. The default is set to `automatic`, which
98
113
  * automatically determines the number of sides to scan.
99
- *
114
+ *
100
115
  */
101
116
  scanningMode: ScanningMode;
102
117
 
103
- /**
118
+ /**
104
119
  * The specific scanning settings for the scanning session.
105
120
  *
106
121
  * Defines various parameters that control the scanning process.
107
- */
122
+ */
108
123
  scanningSettings: BlinkIdScanningSettings;
109
124
 
110
- /**
125
+ /**
111
126
  * Duration in seconds before scanning step times out and is cancelled.
112
- *
127
+ *
113
128
  * If less than zero, scanning will not time out.
114
129
  * Defaults to 15000 (miliseconds)
115
- */
130
+ */
116
131
  stepTimeoutDuration: number;
117
132
 
118
- /**
119
- *
133
+ /**
134
+ *
120
135
  * Represents the configuration settings for a scanning session.
121
136
  *
122
137
  * This class holds the settings related to the resources initialization,
@@ -132,282 +147,282 @@ export class BlinkIdSessionSettings {
132
147
 
133
148
  /**
134
149
  * Represents the configurable settings for scanning a document.
135
- *
150
+ *
136
151
  * This class defines various parameters and policies related to the scanning
137
152
  * process, including image quality handling, data extraction and anonymization,
138
153
  * along with options for frame processing and image extraction.
139
- *
140
- * */
154
+ *
155
+ * */
141
156
  export class BlinkIdScanningSettings {
142
157
  /**
143
158
  * The level of blur detection in the document image.
144
- *
159
+ *
145
160
  * Defines the severity of blur detected in the document image, as defined
146
161
  * in [DetectionLevel]. Values range from `off` (detection NotAvailable) to higher
147
162
  * levels of blur detection.
148
- *
163
+ *
149
164
  * `low` – less sensitive to blur; if something is detected as blur, it is almost certainly actual blur,
150
165
  * but some amount of blur may not be detected at all.
151
166
  * `high` – highly sensitive to blur; it may detect as blur even something that only resembles blur.
152
- *
153
- * Default: {@link DetectionLevel.Mid}
154
- * */
155
- blurDetectionLevel: DetectionLevel;
156
-
157
- /**
158
- * Indicates whether images with blur in the document image should be skipped.
159
- *
160
- * A value of `true` means images with detected blur will be excluded from further processing to prevent blurred images from being used
161
- * - If blurDetectionLevel = `off` - blurred images will be processed
162
- * - If blur is detected `ProcessingStatus` will be `ImagePreprocessingFailed` and blur will be reported in the `ProcessResult`
163
- * A value of `false` means images with detected blur will not be excluded from further processing
164
- * - If blurDetectionLevel != `off` - even if blur is detected, the image will be processed and blur will be reported in the `ProcessResult`.
165
- *
166
- * Default: `true`
167
- */
168
- skipImagesWithBlur: boolean
167
+ *
168
+ * Default: {@link DetectionLevel.Mid}
169
+ * */
170
+ blurDetectionLevel: DetectionLevel;
169
171
 
170
- /**
171
- * The level of glare detection in the document image.
172
- *
173
- * Defines the severity of glare detected in the document image, as defined in [DetectionLevel].
174
- * Values range from `off` (detection NotAvailable) to higher levels of glare detection.
175
- * `low` less sensitive to glare; if something is detected as glare, it is almost certainly actual glare,
176
- * but some amount of glare may not be detected at all.
177
- * `high` highly sensitive to glare; it may detect as glare even something that only resembles glare.
178
- *
179
- * Default: {@link DetectionLevel.Mid}
172
+ /**
173
+ * Indicates whether images with blur in the document image should be skipped.
174
+ *
175
+ * A value of `true` means images with detected blur will be excluded from further processing to prevent blurred images from being used
176
+ * - If blurDetectionLevel = `off` - blurred images will be processed
177
+ * - If blur is detected `ProcessingStatus` will be `ImagePreprocessingFailed` and blur will be reported in the `ProcessResult`
178
+ * A value of `false` means images with detected blur will not be excluded from further processing
179
+ * - If blurDetectionLevel != `off` - even if blur is detected, the image will be processed and blur will be reported in the `ProcessResult`.
180
+ *
181
+ * Default: `true`
182
+ */
183
+ skipImagesWithBlur: boolean;
184
+
185
+ /**
186
+ * The level of glare detection in the document image.
187
+ *
188
+ * Defines the severity of glare detected in the document image, as defined in [DetectionLevel].
189
+ * Values range from `off` (detection NotAvailable) to higher levels of glare detection.
190
+ * `low` – less sensitive to glare; if something is detected as glare, it is almost certainly actual glare,
191
+ * but some amount of glare may not be detected at all.
192
+ * `high` – highly sensitive to glare; it may detect as glare even something that only resembles glare.
193
+ *
194
+ * Default: {@link DetectionLevel.Mid}
180
195
  */
181
196
  glareDetectionLevel: DetectionLevel;
182
197
 
183
198
  /**
184
- * Indicates whether images with glare in the document image should be skipped.
185
- *
186
- * A value of `true` means images with detected glare will be excluded from further processing to prevent glared images from being used
187
- * - If glareDetectionLevel = `off` - glared images will be processed
188
- * - If glare is detected `ProcessingStatus` will be `ImagePreprocessingFailed` and glare will be reported in the `ProcessResult`
189
- * A value of `false` means images with detected glare will not be excluded from further processing
190
- * - If glareDetectionLevel != `off` - even if glare is detected, the image will be processed and glare will be reported in the `ProcessResult`
191
- *
192
- * Default: `true`
193
- */
199
+ * Indicates whether images with glare in the document image should be skipped.
200
+ *
201
+ * A value of `true` means images with detected glare will be excluded from further processing to prevent glared images from being used
202
+ * - If glareDetectionLevel = `off` - glared images will be processed
203
+ * - If glare is detected `ProcessingStatus` will be `ImagePreprocessingFailed` and glare will be reported in the `ProcessResult`
204
+ * A value of `false` means images with detected glare will not be excluded from further processing
205
+ * - If glareDetectionLevel != `off` - even if glare is detected, the image will be processed and glare will be reported in the `ProcessResult`
206
+ *
207
+ * Default: `true`
208
+ */
194
209
  skipImagesWithGlare: boolean;
195
210
 
196
211
  /**
197
- * The level of allowed detected tilt of the document in the image.
198
- *
199
- * Defines the severity of allowed detected tilt of the document in the image, as defined in [DetectionLevel].
200
- * Values range from `off` (detection NotAvailable) to higher levels of allowed tilt.
201
- * `low` – less sensitive to tilt.
202
- * `high` – highly sensitive to tilt.
203
- *
204
- * Default: {@link DetectionLevel.off}
212
+ * The level of allowed detected tilt of the document in the image.
213
+ *
214
+ * Defines the severity of allowed detected tilt of the document in the image, as defined in [DetectionLevel].
215
+ * Values range from `off` (detection NotAvailable) to higher levels of allowed tilt.
216
+ * `low` – less sensitive to tilt.
217
+ * `high` – highly sensitive to tilt.
218
+ *
219
+ * Default: {@link DetectionLevel.off}
205
220
  */
206
221
  tiltDetectionLevel: DetectionLevel;
207
222
 
208
223
  /**
209
- * Indicates whether images with inadequate lighting conditions should be rejected.
210
- *
211
- * Inadequate lighting conditions are represented as either `TooBright` or `TooDark` document images,
212
- * as defined in the `ImageAnalysisLightingStatus` enum.
213
- * A value of `true` means images with inadequate lighting conditions will be excluded from further processing to prevent images with
214
- * inadequate lighting from being used
215
- * - If inadequate light conditions are detected `ProcessingStatus` will be `ImagePreprocessingFailed` and lighting status will be
216
- * reported in the `ProcessResult`.
217
- *
218
- * Default: `true`
224
+ * Indicates whether images with inadequate lighting conditions should be rejected.
225
+ *
226
+ * Inadequate lighting conditions are represented as either `TooBright` or `TooDark` document images,
227
+ * as defined in the `ImageAnalysisLightingStatus` enum.
228
+ * A value of `true` means images with inadequate lighting conditions will be excluded from further processing to prevent images with
229
+ * inadequate lighting from being used
230
+ * - If inadequate light conditions are detected `ProcessingStatus` will be `ImagePreprocessingFailed` and lighting status will be
231
+ * reported in the `ProcessResult`.
232
+ *
233
+ * Default: `true`
219
234
  */
220
235
  skipImagesWithInadequateLightingConditions: boolean;
221
236
 
222
- /**
223
- * Indicates whether images occluded by hand should be rejected.
224
- *
225
- * A value of `true` means images occluded by hand will be excluded from further processing to prevent occluded images from being used
226
- * - If hand occlusion is detected `ProcessingStatus` will be `ImagePreprocessingFailed` and hand occlusion status will be reported
227
- * in the `ProcessResult`
228
- * This setting is applicable only if `scanCroppedDocumentImage` = false.
229
- *
230
- * Default: `true`
237
+ /**
238
+ * Indicates whether images occluded by hand should be rejected.
239
+ *
240
+ * A value of `true` means images occluded by hand will be excluded from further processing to prevent occluded images from being used
241
+ * - If hand occlusion is detected `ProcessingStatus` will be `ImagePreprocessingFailed` and hand occlusion status will be reported
242
+ * in the `ProcessResult`
243
+ * This setting is applicable only if `scanCroppedDocumentImage` = false.
244
+ *
245
+ * Default: `true`
231
246
  */
232
247
  skipImagesOccludedByHand: boolean;
233
248
 
234
- /**
235
- * Indicates whether the aggregation of data from multiple images is enabled.
236
- *
237
- * Disabling this setting will yield higher-quality captured images, but it may slow down the scanning process due to the additional
238
- * effort required to find the optimal image.
239
- * Enabling this setting will simplify the extraction process, but the extracted data will be aggregated from multiple images instead
240
- * of being sourced from a single image.
241
- * This only applies to images from Video input image source - for images from Photo source, setting will be ignored.
242
- *
243
- * Default: `true`
249
+ /**
250
+ * Indicates whether the aggregation of data from multiple images is enabled.
251
+ *
252
+ * Disabling this setting will yield higher-quality captured images, but it may slow down the scanning process due to the additional
253
+ * effort required to find the optimal image.
254
+ * Enabling this setting will simplify the extraction process, but the extracted data will be aggregated from multiple images instead
255
+ * of being sourced from a single image.
256
+ * This only applies to images from Video input image source - for images from Photo source, setting will be ignored.
257
+ *
258
+ * Default: `true`
244
259
  */
245
260
  combineResultsFromMultipleInputImages: boolean;
246
261
 
247
262
  /**
248
- * Enables barcode recognition to proceed even if the initial VIZ extraction fails.
249
- *
250
- * If the barcode recognition is successful, recognition will still end in a valid state.
251
- * This setting is applicable only to images from Photo source.
252
- * For multi-side scanning, it is permitted only for the back side.
253
- *
254
- * Default: `false`
263
+ * Enables barcode recognition to proceed even if the initial VIZ extraction fails.
264
+ *
265
+ * If the barcode recognition is successful, recognition will still end in a valid state.
266
+ * This setting is applicable only to images from Photo source.
267
+ * For multi-side scanning, it is permitted only for the back side.
268
+ *
269
+ * Default: `false`
255
270
  */
256
271
  enableBarcodeScanOnly: boolean;
257
272
 
258
- /**
259
- * Defines custom rules for specific document class.
260
- *
261
- * When defining [DocumentRules], [DocumentFilter] is optionally set to specify the document to which the rule applies, and a `fields` with
262
- * the appropriate `alphabetType` should be specified as mandatory for that document.
263
- * If a `fields` is set to a field that is optional for that document or does not exist on it, all fields on the document become optional.
264
- * If a `fields` is set to a field with an incorrect alphabetType, all fields on the document become optional.
265
- * If a `fields` is set to a field that doesn’t exist in the internal rules, that rule is ignored.
266
- * When adding multiple `fields`, any field that does not match our rules is ignored. Only fields that comply with our rules are set as mandatory.
267
- * If the documentFilter fields `country`, `region`, or `type` are set to `null`, all supported values for those fields will be considered.
268
- * For example, if `country = null`, the rule will apply to all supported countries in BlinkID.
269
- *
270
- * By default, document fields are validated using internal rules that define mandatory fields for the scanned document class. This setting allows
271
- * users to narrow down our internal rules on mandatory fields. All undefined fields will become optional. It is not possible to mark fields as
272
- * mandatory if they cannot theoretically appear on the document.
273
- * The more detailed document filter will have priority over the other.
274
- *
275
- * See {@link DocumentRules} for more detailed information.
273
+ /**
274
+ * Defines custom rules for specific document class.
275
+ *
276
+ * When defining [DocumentRules], [DocumentFilter] is optionally set to specify the document to which the rule applies, and a `fields` with
277
+ * the appropriate `alphabetType` should be specified as mandatory for that document.
278
+ * If a `fields` is set to a field that is optional for that document or does not exist on it, all fields on the document become optional.
279
+ * If a `fields` is set to a field with an incorrect alphabetType, all fields on the document become optional.
280
+ * If a `fields` is set to a field that doesn’t exist in the internal rules, that rule is ignored.
281
+ * When adding multiple `fields`, any field that does not match our rules is ignored. Only fields that comply with our rules are set as mandatory.
282
+ * If the documentFilter fields `country`, `region`, or `type` are set to `null`, all supported values for those fields will be considered.
283
+ * For example, if `country = null`, the rule will apply to all supported countries in BlinkID.
284
+ *
285
+ * By default, document fields are validated using internal rules that define mandatory fields for the scanned document class. This setting allows
286
+ * users to narrow down our internal rules on mandatory fields. All undefined fields will become optional. It is not possible to mark fields as
287
+ * mandatory if they cannot theoretically appear on the document.
288
+ * The more detailed document filter will have priority over the other.
289
+ *
290
+ * See {@link DocumentRules} for more detailed information.
276
291
  */
277
292
  customDocumentRules?: DocumentRules[];
278
293
 
279
- /**
280
- * The mode of anonymization applied to the document.
281
- *
282
- * Redact specific fields based on requirements or laws regarding a specific document.
283
- * Data can be redacted from the image, the result or both.
284
- *
285
- * Default: {@link AnonymizationMode.fullResult}
294
+ /**
295
+ * The mode of anonymization applied to the document.
296
+ *
297
+ * Redact specific fields based on requirements or laws regarding a specific document.
298
+ * Data can be redacted from the image, the result or both.
299
+ *
300
+ * Default: {@link AnonymizationMode.fullResult}
286
301
  */
287
302
  anonymizationMode: AnonymizationMode;
288
303
 
289
- /**
290
- * Redact fields for specific document class.
291
- *
292
- * Fields specified by requirements or laws for a specific document will be redacted regardless of this setting.
293
- * Based on anonymizationMode setting, data will be redacted from the image, the result or both.
294
- *
295
- * See {@link DocumentAnonymizationSettings} for more information.
304
+ /**
305
+ * Redact fields for specific document class.
306
+ *
307
+ * Fields specified by requirements or laws for a specific document will be redacted regardless of this setting.
308
+ * Based on anonymizationMode setting, data will be redacted from the image, the result or both.
309
+ *
310
+ * See {@link DocumentAnonymizationSettings} for more information.
296
311
  */
297
312
  customDocumentAnonymizationSettings?: DocumentAnonymizationSettings[];
298
- /**
299
- * Indicates whether input images should be returned.
300
- *
301
- * Save the input images at the moment of the data extraction or timeout.
302
- * This significantly increases memory consumption. The scanning performance is not affected.
303
- *
304
- * Default: `false`
313
+ /**
314
+ * Indicates whether input images should be returned.
315
+ *
316
+ * Save the input images at the moment of the data extraction or timeout.
317
+ * This significantly increases memory consumption. The scanning performance is not affected.
318
+ *
319
+ * Default: `false`
305
320
  */
306
321
  returnInputImages: boolean;
307
322
 
308
- /**
309
- * Process only cropped document images.
310
- * Requires the input image to consist solely of the cropped document image with perspective correction applied.
311
- * This only applies to images from Photo input image source - for images from Video input image source, setting will be ignored.
312
- *
313
- * Default: `false`
323
+ /**
324
+ * Process only cropped document images.
325
+ * Requires the input image to consist solely of the cropped document image with perspective correction applied.
326
+ * This only applies to images from Photo input image source - for images from Video input image source, setting will be ignored.
327
+ *
328
+ * Default: `false`
314
329
  */
315
330
  scanCroppedDocumentImage: boolean;
316
331
 
317
- /**
318
- * The filter for recognition modes.
319
- *
320
- * Specifies which recognition modes are enabled during the scanning process, with a default value of true to enable all modes.
321
- * [RecognitionModeFilter] is used to enable/disable recognition of specific document groups.
322
- *
323
- * This setting is experimental and it will be removed in upcoming releases.
324
- *
325
- * By default all modes are enabled (set to `true`).
332
+ /**
333
+ * The filter for recognition modes.
334
+ *
335
+ * Specifies which recognition modes are enabled during the scanning process, with a default value of true to enable all modes.
336
+ * [RecognitionModeFilter] is used to enable/disable recognition of specific document groups.
337
+ *
338
+ * This setting is experimental and it will be removed in upcoming releases.
339
+ *
340
+ * By default all modes are enabled (set to `true`).
326
341
  */
327
342
  recognitionModeFilter: RecognitionModeFilter;
328
343
 
329
- /**
330
- * Indicates whether character validation is enabled.
331
- *
332
- * Allow only results containing expected characters for a given field.
333
- * Each field is validated against a set of rules.
334
- * All fields have to be successfully validated in order to successfully scan a document.
335
- * Setting is used to improve scanning accuracy.
336
- * If set to `true`, when an invalid character is detected `ProcessingStatus.InvalidCharactersFound` is returned.
337
- *
338
- * Default: `true`
344
+ /**
345
+ * Indicates whether character validation is enabled.
346
+ *
347
+ * Allow only results containing expected characters for a given field.
348
+ * Each field is validated against a set of rules.
349
+ * All fields have to be successfully validated in order to successfully scan a document.
350
+ * Setting is used to improve scanning accuracy.
351
+ * If set to `true`, when an invalid character is detected `ProcessingStatus.InvalidCharactersFound` is returned.
352
+ *
353
+ * Default: `true`
339
354
  */
340
355
  enableCharacterValidation: boolean;
341
356
 
342
- /**
343
- * Defines the minimum required margin (in percentage) between the edge of the input image and the document.
344
- *
345
- * The setting is applicable only when using images from Video source.
346
- * The setting is not applicable if `scanCroppedDocumentImage = true` (it will be ignored).
347
- * This setting is implemented to comply with regulations in certain countries that mandate documents
348
- * to be stored with adequate margins in the image.
349
- *
350
- * Default: `0.02` (also recommended value)
357
+ /**
358
+ * Defines the minimum required margin (in percentage) between the edge of the input image and the document.
359
+ *
360
+ * The setting is applicable only when using images from Video source.
361
+ * The setting is not applicable if `scanCroppedDocumentImage = true` (it will be ignored).
362
+ * This setting is implemented to comply with regulations in certain countries that mandate documents
363
+ * to be stored with adequate margins in the image.
364
+ *
365
+ * Default: `0.02` (also recommended value)
351
366
  */
352
367
  inputImageMargin: number;
353
368
 
354
- /**
355
- * Indicates whether backside of unsupported document should be scanned also.
356
- *
357
- * By default, back side of the document will not be scanned if only the front side is supported for a specific
358
- * document.
359
- *
360
- * Default: `false`
369
+ /**
370
+ * Indicates whether backside of unsupported document should be scanned also.
371
+ *
372
+ * By default, back side of the document will not be scanned if only the front side is supported for a specific
373
+ * document.
374
+ *
375
+ * Default: `false`
361
376
  */
362
377
  scanUnsupportedBack: boolean;
363
378
 
364
- /**
365
- * Indicates whether scanning can continue to the next side despite an uncertain front-side scan.
366
- *
367
- * This only applies to images from Photo input image source - for images from Video source, setting will be
368
- * ignored.
369
- *
370
- * Default: `false`
371
- */
379
+ /**
380
+ * Indicates whether scanning can continue to the next side despite an uncertain front-side scan.
381
+ *
382
+ * This only applies to images from Photo input image source - for images from Video source, setting will be
383
+ * ignored.
384
+ *
385
+ * Default: `false`
386
+ */
372
387
  allowUncertainFrontSideScan: boolean;
373
388
 
374
- /**
375
- * The maximum allowed mismatches per field during data matching.
376
- *
377
- * Configures the maximum number of characters per field that can be inconsistent during data matching.
378
- * By defualt, no mismatches are allowed.
379
- *
380
- * Default: `0`
381
- */
389
+ /**
390
+ * The maximum allowed mismatches per field during data matching.
391
+ *
392
+ * Configures the maximum number of characters per field that can be inconsistent during data matching.
393
+ * By defualt, no mismatches are allowed.
394
+ *
395
+ * Default: `0`
396
+ */
382
397
  maxAllowedMismatchesPerField: number;
383
398
 
384
- /**
385
- * Indicates whether only the passport data page should be scanned.
386
- *
387
- * Scan only the data page ( page containing MRZ ) of the passport.
388
- * If set to `false`, it will be required to scan the second page of certain passports.
389
- *
390
- * Default: `true`
399
+ /**
400
+ * Indicates whether only the passport data page should be scanned.
401
+ *
402
+ * Scan only the data page ( page containing MRZ ) of the passport.
403
+ * If set to `false`, it will be required to scan the second page of certain passports.
404
+ *
405
+ * Default: `true`
391
406
  */
392
407
  scanPassportDataPageOnly: boolean;
393
408
 
394
- /**
395
- * Configures the image processing settings during the scanning process.
396
- *
397
- * Allows customization of cropped image handling, such as dotsPerInch, extensions, and
398
- * whether images should be returned for the document, face or signature regions.
399
- *
400
- * See {@link CroppedImageSettings} for more information.
409
+ /**
410
+ * Configures the image processing settings during the scanning process.
411
+ *
412
+ * Allows customization of cropped image handling, such as dotsPerInch, extensions, and
413
+ * whether images should be returned for the document, face or signature regions.
414
+ *
415
+ * See {@link CroppedImageSettings} for more information.
401
416
  */
402
417
  croppedImageSettings: CroppedImageSettings;
403
418
 
404
- /**
405
- * Represents the configurable settings for scanning a document.
406
- *
407
- * This class defines various parameters and policies related to the scanning
408
- * process, including image quality handling, data extraction and anonymization,
409
- * along with options for frame processing and image extraction.
410
- */
419
+ /**
420
+ * Represents the configurable settings for scanning a document.
421
+ *
422
+ * This class defines various parameters and policies related to the scanning
423
+ * process, including image quality handling, data extraction and anonymization,
424
+ * along with options for frame processing and image extraction.
425
+ */
411
426
  constructor() {
412
427
  this.blurDetectionLevel = DetectionLevel.Mid;
413
428
  this.skipImagesWithBlur = true;
@@ -435,22 +450,21 @@ export class BlinkIdScanningSettings {
435
450
  /**
436
451
  * Allows customization of various aspects of the UI
437
452
  * used during the scanning process.
438
- *
453
+ *
439
454
  */
440
455
  export class BlinkIdUiSettings {
441
-
442
456
  /**
443
457
  * A boolean indicating whether to show a help button
444
458
  * and enable help screens during the scanning session.
445
- *
459
+ *
446
460
  * Default: `true`
447
461
  */
448
- showHelpButton: boolean
462
+ showHelpButton: boolean;
449
463
 
450
464
  /**
451
465
  * A boolean indicating whether to show an onboarding dialog
452
466
  * at the beginning of the scanning session.
453
- *
467
+ *
454
468
  * Default: `true`
455
469
  */
456
470
  showOnboardingDialog: boolean;
@@ -463,47 +477,47 @@ export class BlinkIdUiSettings {
463
477
 
464
478
  /**
465
479
  * Represents the image cropping settings.
466
- *
480
+ *
467
481
  */
468
482
  export class CroppedImageSettings {
469
483
  /**
470
484
  * The DPI value for the cropped image.
471
- *
485
+ *
472
486
  * Default: `250`
473
487
  */
474
488
  dotsPerInch: number;
475
489
 
476
490
  /**
477
491
  * The extension factor for the cropped image.
478
- *
492
+ *
479
493
  * Default: `0`
480
494
  */
481
495
  extensionFactor: number;
482
496
 
483
497
  /**
484
498
  * Indicates whether the document image should be returned.
485
- *
499
+ *
486
500
  * Default: `false`
487
501
  */
488
502
  returnDocumentImage: boolean;
489
503
 
490
504
  /**
491
505
  * Indicates whether the face image should be returned.
492
- *
506
+ *
493
507
  * Default: `false`
494
508
  */
495
509
  returnFaceImage: boolean;
496
510
 
497
511
  /**
498
512
  * Indicates whether the signature image should be returned.
499
- *
513
+ *
500
514
  * Default: `false`
501
515
  */
502
- returnSignatureImage: boolean
516
+ returnSignatureImage: boolean;
503
517
 
504
518
  /**
505
519
  * Represents the image cropping settings.
506
- *
520
+ *
507
521
  */
508
522
  constructor() {
509
523
  this.dotsPerInch = 250;
@@ -512,4 +526,4 @@ export class CroppedImageSettings {
512
526
  this.returnFaceImage = false;
513
527
  this.returnSignatureImage = false;
514
528
  }
515
- }
529
+ }