anyline-ocr-react-native-module 42.2.0 → 43.0.0

package/ios/ALPluginHelper.m

@@ -1,85 +1,73 @@
-//
-//  ALPluginHelper.m
-//  Anyline React-Native Example
-//
-//  Created by Daniel Albertini on 30.10.18.
-//
-
 #import "ALPluginHelper.h"
+#import "ALNFCScanViewController.h" // because NFC-specific code is there
+#import <Anyline/Anyline.h>
+#import <objc/runtime.h>
 
-@implementation ALPluginHelper
-
-#pragma mark - String convertions
+// Predefined domain for errors from most AppKit and Foundation APIs.
+NSErrorDomain const ALFlutterDomain = @"ALFlutterDomain";
 
-+ (NSString *)barcodeFormatFromString:(NSString *)barcodeFormat {
-    return (barcodeFormat == nil && barcodeFormat.length == 0) ? @"unkown" : barcodeFormat;
-}
+@implementation ALPluginHelper
 
-+ (ALScanMode)scanModeFromString:(NSString *)scanMode {
-    NSDictionary<NSString *, NSNumber *> *scanModes = [ALPluginHelper scanModesDict];
-    
-    return [scanModes[scanMode] integerValue];
-}
+#pragma mark - Launch Anyline
 
-+ (NSString *)stringFromScanMode:(ALScanMode)scanMode {
-    NSDictionary<NSString *, NSNumber *> *scanModes = [ALPluginHelper scanModesDict];
++ (void)startScan:(NSDictionary *)config finished:(ALPluginCallback)callback {
     
-    return [scanModes allKeysForObject:@(scanMode)][0];
-}
-
-+ (NSString *)stringForOutline:(ALSquare *)square {
-    return [NSString stringWithFormat:@"outline : { upLeft : { x : %f, y : %f }, upRight : { x : %f, y : %f }, downRight : { x : %f, y : %f }, downLeft : { x : %f, y : %f } }",square.upLeft.x,square.upLeft.y,square.upRight.x,square.upRight.y,square.downRight.x,square.downRight.y,square.downLeft.x,square.downLeft.y];
-}
-
-+ (NSDictionary<NSString *, NSNumber *> *)scanModesDict {
-    static NSDictionary<NSString *, NSNumber *> * scanModes = nil;
+    NSDictionary *pluginConf = config;
     
-    static dispatch_once_t onceToken;
-    dispatch_once(&onceToken, ^{
-        scanModes = @{
-                      @"AUTO_ANALOG_DIGITAL_METER" : @(ALAutoAnalogDigitalMeter),
-                      @"DIAL_METER" : @(ALDialMeter),
-                      @"ANALOG_METER" : @(ALAnalogMeter),
-                      @"BARCODE" : @(ALMeterBarcode),
-                      @"SERIAL_NUMBER" : @(ALSerialNumber),
-                      @"DOT_MATRIX_METER" : @(ALDotMatrixMeter),
-                      @"DIGITAL_METER" : @(ALDigitalMeter),
-                      @"HEAT_METER_4" : @(ALHeatMeter4),
-                      @"HEAT_METER_5" : @(ALHeatMeter5),
-                      @"HEAT_METER_6" : @(ALHeatMeter6),
-                      };
-    });
+    NSString *licenseKey = [config objectForKey:@"licenseKey"];
     
-    return scanModes;
-}
-
-+ (NSString *)barcodeFormatForNativeString:(NSString *)barcodeType {
+    [[UIApplication sharedApplication] keyWindow].rootViewController.modalPresentationStyle = UIModalPresentationFullScreen;
     
-    static NSDictionary<NSString *, NSString *> * barcodeFormats = nil;
+    NSDictionary *optionsDict = [config objectForKey:@"options"];
+    ALJSONUIConfiguration *jsonUIConf = [[ALJSONUIConfiguration alloc] initWithDictionary:optionsDict];
     
-    static dispatch_once_t onceToken;
-    dispatch_once(&onceToken, ^{
-#pragma clang diagnostic push
-#pragma clang diagnostic ignored "-Wdeprecated-declarations"
-        barcodeFormats = @{
-                           @"AVMetadataObjectTypeUPCECode" : kCodeTypeUPCE,
-                           @"AVMetadataObjectTypeCode39Code" : kCodeTypeCode39,
-                           @"AVMetadataObjectTypeCode39Mod43Code" : kCodeTypeCode39,
-                           @"AVMetadataObjectTypeEAN13Code" : kCodeTypeEAN13,
-                           @"AVMetadataObjectTypeEAN8Code" : kCodeTypeEAN8,
-                           @"AVMetadataObjectTypeCode93Code" : kCodeTypeCode93,
-                           @"AVMetadataObjectTypeCode128Code" : kCodeTypeCode128,
-                           @"AVMetadataObjectTypePDF417Code" : kCodeTypePDF417,
-                           @"AVMetadataObjectTypeQRCode" : kCodeTypeQR,
-                           @"AVMetadataObjectTypeAztecCode" : kCodeTypeAztec,
-                           @"AVMetadataObjectTypeInterleaved2of5Code" : kCodeTypeITF,
-                           @"AVMetadataObjectTypeITF14Code" : kCodeTypeITF,
-                           @"AVMetadataObjectTypeDataMatrixCode" : kCodeTypeDataMatrix,
-                           };
-#pragma clang diagnostic pop
-    });
+    BOOL isNFC = [optionsDict[@"enableNFCWithMRZ"] boolValue];
     
-    return barcodeFormats[barcodeType];
+    if (isNFC) {
+        if (@available(iOS 13.0, *)) {
+            
+            if (![ALNFCDetector readingAvailable]) {
+                callback(nil, @"NFC passport reading is not supported on this device or app.");
+                return;
+            }
+            
+            ALNFCScanViewController *nfcScanViewController = [[ALNFCScanViewController alloc] initWithLicensekey:licenseKey
+                                                                                                   configuration:pluginConf
+                                                                                                        uiConfig:jsonUIConf
+                                                                                                        finished:callback];            
+            if (nfcScanViewController != nil) {
+                [nfcScanViewController setModalPresentationStyle:UIModalPresentationFullScreen];
+                [[[UIApplication sharedApplication] keyWindow].rootViewController presentViewController:nfcScanViewController
+                                                                                               animated:YES
+                                                                                             completion:nil];
+            }
+        } else {
+            callback(nil, @"NFC passport reading is only supported on iOS 13 and later.");
+            return;
+        }
+    } else {
+        ALPluginScanViewController *pluginScanViewController = [[ALPluginScanViewController alloc] initWithLicensekey:licenseKey
+                                                                                                        configuration:pluginConf
+                                                                                                      uiConfiguration:jsonUIConf
+                                                                                                             finished:callback];
+        
+        // TODO: should remove these extras
+        if ([pluginConf valueForKey:@"quality"]){
+            pluginScanViewController.quality = [[pluginConf valueForKey:@"quality"] integerValue];
+        }
+        
+        if ([pluginConf valueForKey:@"cropAndTransformErrorMessage"]) {
+            NSString *str = [pluginConf objectForKey:@"cropAndTransformErrorMessage"];
+            pluginScanViewController.cropAndTransformErrorMessage = str;
+        }
+
+        if (pluginScanViewController) {
+            [pluginScanViewController setModalPresentationStyle:UIModalPresentationFullScreen];
+            [[[UIApplication sharedApplication] keyWindow].rootViewController presentViewController:pluginScanViewController
+                                                                                           animated:YES
+                                                                                         completion:nil];
+        }
+    }
 }
 
 #pragma mark - Filesystem handling
@@ -89,30 +77,30 @@
 }
 
 + (NSString *)saveImageToFileSystem:(UIImage *)image compressionQuality:(CGFloat)compressionQuality {
-    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES);
-    NSString *basePath = ([paths count] > 0) ? [paths objectAtIndex:0] : nil;
-    
-    
+    NSString *basePath = [self applicationCachePath];
     NSData *binaryImageData = UIImageJPEGRepresentation(image, compressionQuality);
     NSString *uuid = [NSUUID UUID].UUIDString;
     NSString *imagePath = [NSString stringWithFormat:@"%@.jpg",uuid];
-    
     NSString *fullPath = [basePath stringByAppendingPathComponent:imagePath];
     [binaryImageData writeToFile:fullPath atomically:YES];
-    
     return fullPath;
 }
 
++ (NSString *)applicationCachePath {
+    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES);
+    return ([paths count] > 0) ? [paths objectAtIndex:0] : nil;
+}
+
 #pragma mark - UI helpers
 
 + (UILabel *)createLabelForView:(UIView *)view {
     
     UILabel *scannedLabel = [[UILabel alloc] initWithFrame:CGRectMake(0, 0, view.frame.size.width, 44)];
-    scannedLabel.center = CGPointMake(view.center.x, view.center.y+166);
-    
+    scannedLabel.center = CGPointMake(view.center.x, view.center.y + 166);
     scannedLabel.alpha = 0.0;
-    scannedLabel.font = [UIFont fontWithName:@"HelveticaNeue" size:33];
+    scannedLabel.font = [UIFont fontWithName:@"HelveticaNeue" size:32];
     scannedLabel.textColor = [UIColor whiteColor];
+    scannedLabel.numberOfLines = 0;
     scannedLabel.textAlignment = NSTextAlignmentCenter;
     
     [view addSubview:scannedLabel];
@@ -121,16 +109,28 @@
 }
 
 + (UISegmentedControl *)createSegmentForViewController:(UIViewController *)viewController
-                                                config:(ALJsonUIConfiguration *)config
-                                              scanMode:(ALScanMode)scanMode {
+                                                config:(ALJSONUIConfiguration *)config
+                                       initialScanMode:(NSString *)initialScanMode {
     UISegmentedControl *segment = [[UISegmentedControl alloc] initWithItems:config.segmentTitles];
-    
-    segment.tintColor = config.segmentTintColor;
+
+    // This doesn't appear to be changing the color
+    // segment.tintColor = ...
+
+    segment.backgroundColor = [UIColor colorWithWhite:1 alpha:0.6];
+    if (@available(iOS 13.0, *)) {
+        segment.selectedSegmentTintColor = config.segmentTintColor;
+    }
+
     segment.hidden = YES;
     
-    NSInteger index = [config.segmentModes indexOfObject:[ALPluginHelper stringFromScanMode:scanMode]];
+    NSUInteger index = [config.segmentModes indexOfObject:initialScanMode];
+    if (index == NSNotFound) {
+        return nil;
+    }
+    
     [segment setSelectedSegmentIndex:index];
     
+    // has a warning here but is okay as long as the target implements this selector.
     [segment addTarget:viewController action:@selector(segmentChange:) forControlEvents:UIControlEventValueChanged];
     
     [viewController.view addSubview:segment];
@@ -139,13 +139,16 @@
 }
 
 + (UIButton *)createButtonForViewController:(UIViewController *)viewController
-                                     config:(ALJsonUIConfiguration *)config {
+                                     config:(ALJSONUIConfiguration *)config {
     
     UIButton *doneButton = [UIButton buttonWithType:UIButtonTypeCustom];
-    [doneButton setTitle:config.buttonDoneTitle
-                forState:UIControlStateNormal];
+    [doneButton setTitle:config.buttonDoneTitle forState:UIControlStateNormal];
+    
+    // NOTE: there'll be a warning here from Xcode but just have to make sure
+    // doneButtonPressed: is a valid selector in the target
+    [doneButton addTarget:viewController action:@selector(doneButtonPressed:)
+         forControlEvents:UIControlEventTouchUpInside];
     
-    [doneButton addTarget:viewController action:@selector(doneButtonPressed:) forControlEvents:UIControlEventTouchUpInside];
     [viewController.view addSubview:doneButton];
     
     [ALPluginHelper updateButtonPosition:doneButton
@@ -161,35 +164,31 @@
     roundedView.textLabel.text = @"";
     roundedView.alpha = 0;
     [viewController.view addSubview:roundedView];
-    
     return roundedView;
 }
 
-+ (void)updateButtonPosition:(UIButton *)button
-           withConfiguration:(ALJsonUIConfiguration *)conf
++ (void)updateButtonPosition:(UIButton *)button withConfiguration:(ALJSONUIConfiguration *)config
                       onView:(UIView *)view {
     
-    button.titleLabel.font = [UIFont fontWithName:conf.buttonDoneFontName size:conf.buttonDoneFontSize];
-    [button setTitleColor:conf.buttonDoneTextColor forState:UIControlStateNormal];
-    [button setTitleColor:conf.buttonDoneTextColorHighlighted forState:UIControlStateHighlighted];
+    button.titleLabel.font = [UIFont fontWithName:config.buttonDoneFontName size:config.buttonDoneFontSize];
+    [button setTitleColor:config.buttonDoneTextColor forState:UIControlStateNormal];
+    [button setTitleColor:config.buttonDoneTextColorHighlighted forState:UIControlStateHighlighted];
+    button.contentEdgeInsets = UIEdgeInsetsMake(6, 10, 6, 10);
     
-    button.backgroundColor = conf.buttonDoneBackgroundColor;
+    
+    button.backgroundColor = config.buttonDoneBackgroundColor;
     button.translatesAutoresizingMaskIntoConstraints = NO;
-    button.layer.cornerRadius = conf.buttonDoneCornerRadius;
     
-    switch (conf.buttonType) {
-        case ALButtonTypeFullWidth:
-            // Width constraint
-            [view addConstraint:[NSLayoutConstraint constraintWithItem:button
-                                                             attribute:NSLayoutAttributeWidth
-                                                             relatedBy:NSLayoutRelationEqual
-                                                                toItem:view
-                                                             attribute:NSLayoutAttributeWidth
-                                                            multiplier:1.0
-                                                              constant:0]];
+    // corner radius is overridden to 0 when "full-width" type is used
+    button.layer.cornerRadius = config.buttonDoneCornerRadius;
+    
+    switch (config.buttonType) {
+        case ALButtonTypeFullWidth: // "FULLWIDTH"
+            [view addConstraint:[button.leftAnchor constraintEqualToAnchor:view.leftAnchor constant:0]];
+            [view addConstraint:[button.rightAnchor constraintEqualToAnchor:view.rightAnchor constant:0]];
+            button.layer.cornerRadius = 0;
             break;
-            
-        case ALButtonTypeRect:
+        case ALButtonTypeRect: // "RECT"
             [button sizeToFit];
             break;
             
@@ -197,7 +196,7 @@
             break;
     }
     
-    switch (conf.buttonDoneXAlignment) {
+    switch (config.buttonDoneXAlignment) {
         case ALButtonXAlignmentCenter:
             [view addConstraint:[NSLayoutConstraint constraintWithItem:button
                                                              attribute:NSLayoutAttributeCenterX
@@ -205,7 +204,7 @@
                                                                 toItem:view
                                                              attribute:NSLayoutAttributeCenterX
                                                             multiplier:1.0
-                                                              constant:conf.buttonDoneXPositionOffset]];
+                                                              constant:config.buttonDoneXPositionOffset]];
             break;
         case ALButtonXAlignmentLeft:
             [view addConstraint:[NSLayoutConstraint constraintWithItem:button
@@ -214,7 +213,7 @@
                                                                 toItem:view
                                                              attribute:NSLayoutAttributeLeft
                                                             multiplier:1.0
-                                                              constant:MAX(conf.buttonDoneXPositionOffset,0)]];
+                                                              constant:MAX(config.buttonDoneXPositionOffset, 0)]];
             break;
         case ALButtonXAlignmentRight:
             [view addConstraint:[NSLayoutConstraint constraintWithItem:button
@@ -223,14 +222,14 @@
                                                                 toItem:view
                                                              attribute:NSLayoutAttributeRight
                                                             multiplier:1.0
-                                                              constant:MIN(conf.buttonDoneXPositionOffset,0)]];
+                                                              constant:MIN(config.buttonDoneXPositionOffset, 0)]];
             break;
             
         default:
             break;
     }
     
-    switch (conf.buttonDoneYAlignment) {
+    switch (config.buttonDoneYAlignment) {
         case ALButtonYAlignmentTop:
             // Align Top
             [view addConstraint:[NSLayoutConstraint constraintWithItem:button
@@ -239,7 +238,7 @@
                                                                 toItem:view
                                                              attribute:NSLayoutAttributeTop
                                                             multiplier:1.0
-                                                              constant:MAX(conf.buttonDoneYPositionOffset,0)]];
+                                                              constant:MAX(config.buttonDoneYPositionOffset, 0)]];
             break;
         case ALButtonYAlignmentBottom:
             // Align Bottom
@@ -249,18 +248,14 @@
                                                                 toItem:view
                                                              attribute:NSLayoutAttributeBottom
                                                             multiplier:1.0
-                                                              constant:MIN(conf.buttonDoneYPositionOffset,0)]];
+                                                              constant:MIN(config.buttonDoneYPositionOffset, 0)]];
             
             break;
         case ALButtonYAlignmentCenter:
             // Center vertically
-            [view addConstraint:[NSLayoutConstraint constraintWithItem:button
-                                                             attribute:NSLayoutAttributeCenterY
-                                                             relatedBy:NSLayoutRelationEqual
-                                                                toItem:view
-                                                             attribute:NSLayoutAttributeCenterY
-                                                            multiplier:1.0
-                                                              constant:conf.buttonDoneYPositionOffset]];
+            [view addConstraint:
+                 [button.centerYAnchor constraintEqualToAnchor:view.centerYAnchor constant:config.buttonDoneYPositionOffset]
+            ];
             break;
             
         default:
@@ -268,431 +263,115 @@
     }
 }
 
-#pragma mark - Create Result Dictionaries
-
-+ (NSDictionary *)dictionaryForBarcodeResults:(NSMutableArray<NSDictionary *> *)detectedBarcodes
-                                  barcodeType:(NSString *)barcodeType
-                                   scanResult:(NSString *)scanResult {
-    for (NSMutableDictionary<NSString *, NSString *> *barcode in detectedBarcodes) {
-        if ([[barcode objectForKey:@"value"] isEqualToString:scanResult]) {
-            return nil;
-        }
-    }
-    
-    NSMutableDictionary *barcode = [NSMutableDictionary dictionaryWithCapacity:2];
-    
-    barcode[@"value"] = scanResult;
-    barcode[@"format"] = [ALPluginHelper barcodeFormatForNativeString:barcodeType];
-    
-    return barcode;
-}
-
-+ (NSDictionary *)dictionaryForMeterResult:(ALMeterResult *)scanResult
-                          detectedBarcodes:(NSMutableArray<NSDictionary *> *)detectedBarcodes
-                                   outline:(ALSquare *)outline
-                                   quality:(NSInteger)quality {
-    CGFloat dividedCompRate = (CGFloat)quality/100;
-    
-    NSMutableDictionary *dictResult = [NSMutableDictionary dictionaryWithCapacity:4];
-    
-    switch (scanResult.scanMode) {
-        case ALDigitalMeter:
-            [dictResult setObject:@"Digital Meter" forKey:@"meterType"];
-            break;
-        case ALDialMeter:
-            [dictResult setObject:@"Dial Meter" forKey:@"meterType"];
-            break;
-        case ALHeatMeter4:
-        case ALHeatMeter5:
-        case ALHeatMeter6:
-            [dictResult setObject:@"Heat Meter" forKey:@"meterType"];
-            break;
-        case ALSerialNumber:
-            [dictResult setObject:@"Serial Number" forKey:@"meterType"];
-            break;
-        default:
-            [dictResult setObject:@"Electric Meter" forKey:@"meterType"];
-            break;
-    }
-    
-    [dictResult setObject:[ALPluginHelper stringFromScanMode:scanResult.scanMode] forKey:@"scanMode"];
-    
-    [dictResult setObject:scanResult.result forKey:@"reading"];
-    
-    NSString *imagePath = [ALPluginHelper saveImageToFileSystem:scanResult.image compressionQuality:dividedCompRate];
-    
-    [dictResult setValue:imagePath forKey:@"imagePath"];
-    
-    NSString *fullImagePath = [ALPluginHelper saveImageToFileSystem:scanResult.fullImage compressionQuality:dividedCompRate];
-    
-    [dictResult setValue:fullImagePath forKey:@"fullImagePath"];
-    
-    if (detectedBarcodes && detectedBarcodes.count != 0) {
-        [dictResult setObject:detectedBarcodes forKey:@"detectedBarcodes"];
-    }
-    
-    [dictResult setValue:@(scanResult.confidence) forKey:@"confidence"];
-    [dictResult setValue:[ALPluginHelper stringForOutline:outline] forKey:@"outline"];
-    
-    return dictResult;
+#pragma mark - Date Parsing Utils
+//
+//+ (NSString *)stringForDate:(NSDate *)date {
+//    if (!date) {
+//        return nil;
+//    }
+//    
+//    NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
+//    [dateFormatter setTimeZone:[NSTimeZone timeZoneWithAbbreviation:@"UTC+0:00"]];
+//    [dateFormatter setDateFormat:@"EEE MMM d hh:mm:ss ZZZZ yyyy"];
+//    
+//    //Date will be formatted to string - e.g.: "Fri Jan 11 12:00:00 GMT+0:00 1980"
+//    NSString *dateString = [dateFormatter stringFromDate:date];
+//    
+//    return dateString;
+//}
+
+// MARK: Utilities
+
++ (void)showErrorAlertWithTitle:(NSString *)title
+                        message:(NSString *)message
+       presentingViewController:(UIViewController *)presentingViewController {
+
+    UIAlertController *alertController = [UIAlertController alertControllerWithTitle:title
+                                                                             message:message
+                                                                      preferredStyle:UIAlertControllerStyleAlert];
+    UIAlertAction *dismissAction = [UIAlertAction actionWithTitle:@"OK" style:UIAlertActionStyleCancel handler:nil];
+    [alertController addAction:dismissAction];
+    [presentingViewController presentViewController:alertController animated:YES completion:nil];
 }
 
-+ (NSDictionary *)dictionaryForIDResult:(ALIDResult *)scanResult
-                       detectedBarcodes:(NSMutableArray<NSDictionary *> *)detectedBarcodes
-                                outline:(ALSquare *)outline
-                                quality:(NSInteger)quality {
-    CGFloat dividedCompRate = (CGFloat)quality/100;
-    
-    NSMutableDictionary *dictResult = [[NSMutableDictionary alloc] init];
-    
-    NSString *imagePath = [self saveImageToFileSystem:scanResult.image compressionQuality:dividedCompRate];
-    
-    NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
-    [formatter setDateFormat:@"yyyy.MM.dd"];
-    
-    if ([scanResult.result isKindOfClass:[ALUniversalIDIdentification class]]) {
-        ALUniversalIDIdentification *identification = (ALUniversalIDIdentification *)scanResult.result;
-        
-        [[identification fieldNames] enumerateObjectsUsingBlock:^(NSString *fieldName, NSUInteger idx, BOOL *stop) {
-            [dictResult setValue:[identification valueForField:fieldName] forKey:fieldName];
-        }];
-    }
-    
-    if ([scanResult.result isKindOfClass:[ALMRZIdentification class]]) {
-        ALMRZIdentification *mrzIdentification = (ALMRZIdentification *)scanResult.result;
-        NSMutableArray<NSString *> *keys=[@[
-                                            @"surname",
-                                            @"givenNames",
-                                            @"dateOfBirth",
-                                            @"dateOfExpiry",
-                                            @"documentNumber",
-                                            @"documentType",
-                                            @"issuingCountryCode",
-                                            @"nationalityCountryCode",
-                                            @"sex",
-                                            @"personalNumber",
-                                            @"optionalData",
-                                            @"mrzString",
-                                            @"checkDigitDateOfExpiry",
-                                            @"checkDigitDocumentNumber",
-                                            @"checkDigitDateOfBirth",
-                                            @"checkDigitFinal",
-                                            @"checkDigitPersonalNumber",
-                                            @"allCheckDigitsValid"
-                                            ] mutableCopy];
-        dictResult = [[scanResult.result dictionaryWithValuesForKeys:keys] mutableCopy];
-        //there's no confidence for allCheckDigitsValid
-        [keys removeObject:@"allCheckDigitsValid"];
-        NSMutableDictionary *confidences=[[[scanResult.result fieldConfidences]
-                                           dictionaryWithValuesForKeys:keys] mutableCopy];
-        
-        //VIZ Fields
-        if ([mrzIdentification vizGivenNames] && [mrzIdentification vizGivenNames].length > 0) {
-            [dictResult setValue:mrzIdentification.vizGivenNames forKey:@"vizGivenNames"];
-        }
-        [confidences setValue:@(mrzIdentification.fieldConfidences.vizGivenNames) forKey:@"vizGivenNames"];
-        
-        if ([mrzIdentification vizSurname] && [mrzIdentification vizSurname].length > 0) {
-            [dictResult setValue:mrzIdentification.vizSurname forKey:@"vizSurname"];
-        }
-        [confidences setValue:@(mrzIdentification.fieldConfidences.vizSurname) forKey:@"vizSurname"];
-        
-        if ([mrzIdentification vizAddress] && [mrzIdentification vizAddress].length > 0) {
-            [dictResult setValue:mrzIdentification.vizAddress forKey:@"vizAddress"];
-        }
-        [confidences setValue:@(mrzIdentification.fieldConfidences.vizAddress) forKey:@"vizAddress"];
-        
-        if ([mrzIdentification vizDateOfBirth] && [mrzIdentification vizDateOfBirth].length > 0) {
-            [dictResult setValue:mrzIdentification.vizDateOfBirth forKey:@"vizDateOfBirth"];
-            [dictResult setValue:[ALPluginHelper stringForDate:mrzIdentification.vizDateOfBirthObject] forKey:@"vizDateOfBirthObject"];
-        }
-        [confidences setValue:@(mrzIdentification.fieldConfidences.vizDateOfBirth) forKey:@"vizDateOfBirth"];
-        
-        if ([mrzIdentification vizDateOfExpiry] && [mrzIdentification vizDateOfExpiry].length > 0) {
-            [dictResult setValue:mrzIdentification.vizDateOfExpiry forKey:@"vizDateOfExpiry"];
-            [dictResult setValue:[ALPluginHelper stringForDate:mrzIdentification.vizDateOfExpiryObject] forKey:@"vizDateOfExpiryObject"];
-        }
-        [confidences setValue:@(mrzIdentification.fieldConfidences.vizDateOfExpiry) forKey:@"vizDateOfExpiry"];
-        
-        if ([mrzIdentification vizDateOfIssue] && [mrzIdentification vizDateOfIssue].length > 0) {
-            [dictResult setValue:mrzIdentification.vizDateOfIssue forKey:@"vizDateOfIssue"];
-            [dictResult setValue:[ALPluginHelper stringForDate:mrzIdentification.vizDateOfIssueObject] forKey:@"vizDateOfIssueObject"];
-        }
-        [confidences setValue:@(mrzIdentification.fieldConfidences.vizDateOfIssue) forKey:@"vizDateOfIssue"];
-        
-        [dictResult setValue:[ALPluginHelper stringForDate:[scanResult.result dayOfBirthDateObject]] forKey:@"dateOfBirthObject"];
-        [dictResult setValue:[ALPluginHelper stringForDate:[scanResult.result dateOfExpiryObject]] forKey:@"dateOfExpiryObject"];
-        [dictResult setValue:confidences forKey:@"fieldConfidences"];
++ (BOOL)showErrorAlertIfNeeded:(NSError *)error pluginCallback:(ALPluginCallback)callback {
+    if (!error) {
+        return NO;
     }
-    
-    [dictResult setValue:imagePath forKey:@"imagePath"];
-    
-    NSString *fullImagePath = [ALPluginHelper saveImageToFileSystem:scanResult.fullImage compressionQuality:dividedCompRate];
-    [dictResult setValue:fullImagePath forKey:@"fullImagePath"];
-    
-    [dictResult setValue:@(scanResult.confidence) forKey:@"confidence"];
-    [dictResult setValue:[self stringForOutline:outline] forKey:@"outline"];
-    
-    return dictResult;
-}
 
+    UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"Could not start scanning"
+                                                                   message:error.localizedDescription
+                                                            preferredStyle:UIAlertControllerStyleAlert];
 
-+ (NSDictionary *)dictionaryForNFCResult:(ALNFCResult *)scanResult
-                                 quality:(NSInteger)quality API_AVAILABLE(ios(13)) {
-    CGFloat dividedCompRate = (CGFloat)quality/100;
-    
-    NSMutableDictionary *dictResult = [[NSMutableDictionary alloc] init];
-    
-    
-    //DataGroup1
-    NSMutableDictionary *dictResultDataGroup1 = [[NSMutableDictionary alloc] init];
-    
-    [dictResultDataGroup1 setValue:[ALPluginHelper stringForDate:scanResult.dataGroup1.dateOfBirth] forKey:@"dateOfBirth"];
-    [dictResultDataGroup1 setValue:[ALPluginHelper stringForDate:scanResult.dataGroup1.dateOfExpiry] forKey:@"dateOfExpiry"];
-    [dictResultDataGroup1 setValue:scanResult.dataGroup1.documentNumber forKey:@"documentNumber"];
-    [dictResultDataGroup1 setValue:scanResult.dataGroup1.documentType forKey:@"documentType"];
-    [dictResultDataGroup1 setValue:scanResult.dataGroup1.firstName forKey:@"firstName"];
-    [dictResultDataGroup1 setValue:scanResult.dataGroup1.gender forKey:@"gender"];
-    [dictResultDataGroup1 setValue:scanResult.dataGroup1.issuingStateCode forKey:@"issuingStateCode"];
-    [dictResultDataGroup1 setValue:scanResult.dataGroup1.lastName forKey:@"lastName"];
-    [dictResultDataGroup1 setValue:scanResult.dataGroup1.nationality forKey:@"nationality"];
-    
-    [dictResult setObject:dictResultDataGroup1 forKey:@"dataGroup1"];
-    
-    
-    //DataGroup2 (= Image)
-    NSMutableDictionary *dictResultDataGroup2 = [[NSMutableDictionary alloc] initWithCapacity:1];
-    NSString *imagePath = [self saveImageToFileSystem:scanResult.dataGroup2.faceImage compressionQuality:dividedCompRate];
-    [dictResultDataGroup2 setValue:imagePath forKey:@"imagePath"];
-    
-    [dictResult setObject:dictResultDataGroup2 forKey:@"dataGroup2"];
-    
-    //SOB
-    NSMutableDictionary *dictResultSOB = [[NSMutableDictionary alloc] init];
-    
-    [dictResultSOB setValue:scanResult.sod.issuerCertificationAuthority forKey:@"issuerCertificationAuthority"];
-    [dictResultSOB setValue:scanResult.sod.issuerCountry forKey:@"issuerCountry"];
-    [dictResultSOB setValue:scanResult.sod.issuerOrganization forKey:@"issuerOrganization"];
-    [dictResultSOB setValue:scanResult.sod.issuerOrganizationalUnit forKey:@"issuerOrganizationalUnit"];
-    [dictResultSOB setValue:scanResult.sod.ldsHashAlgorithm forKey:@"ldsHashAlgorithm"];
-    [dictResultSOB setValue:scanResult.sod.signatureAlgorithm forKey:@"signatureAlgorithm"];
-    [dictResultSOB setValue:scanResult.sod.validFromString forKey:@"validFromString"];
-    [dictResultSOB setValue:scanResult.sod.validUntilString forKey:@"validUntilString"];
-    
-    [dictResult setObject:dictResultSOB forKey:@"sob"];
-    
-    return dictResult;
-}
-
+    UIAlertAction *action = [UIAlertAction actionWithTitle:@"Ok"
+                                                     style:UIAlertActionStyleDefault
+                                                   handler:^(UIAlertAction * _Nonnull action) {
 
-+ (NSDictionary *)dictionaryForOCRResult:(ALOCRResult *)scanResult
-                        detectedBarcodes:(NSMutableArray<NSDictionary *> *)detectedBarcodes
-                                 outline:(ALSquare *)outline
-                                 quality:(NSInteger)quality {
-    CGFloat dividedCompRate = (CGFloat)quality/100;
-    
-    NSMutableDictionary *dictResult = [NSMutableDictionary dictionaryWithCapacity:4];
-    
-    [dictResult setObject:scanResult.result forKey:@"text"];
-    
-    NSString *imagePath = [ALPluginHelper saveImageToFileSystem:scanResult.image compressionQuality:dividedCompRate];
-    
-    [dictResult setValue:imagePath forKey:@"imagePath"];
-    
-    NSString *fullImagePath = [ALPluginHelper saveImageToFileSystem:scanResult.fullImage compressionQuality:dividedCompRate];
-    [dictResult setValue:fullImagePath forKey:@"fullImagePath"];
-    
-    [dictResult setValue:[ALPluginHelper stringForOutline:outline] forKey:@"outline"];
-    
-    if (detectedBarcodes && detectedBarcodes.count != 0) {
-        [dictResult setObject:detectedBarcodes forKey:@"detectedBarcodes"];
-    }
-    
-    return dictResult;
-}
+        [[UIApplication sharedApplication].keyWindow.rootViewController
+         dismissViewControllerAnimated:YES completion:^{
+            callback(nil, @"Canceled");
+        }];
+    }];
 
-+ (NSDictionary *)dictionaryForBarcodeResult:(ALBarcodeResult *)scanResult
-                                     outline:(ALSquare *)outline
-                                     quality:(NSInteger)quality {
-    CGFloat dividedCompRate = (CGFloat)quality/100;
-    
-    NSMutableDictionary *dictResult = [NSMutableDictionary dictionaryWithCapacity:2];
-    
-    NSMutableArray *barcodeArray = [[NSMutableArray alloc] init];
-    
-    
-    for(ALBarcode *barcode in scanResult.result) {
-        NSMutableDictionary *barcodeDictionary = @{ @"value":barcode.value,
-                                                    @"barcodeFormat": [ALPluginHelper barcodeFormatFromString:barcode.barcodeFormat]}.mutableCopy;
-        if (barcode.parsedPDF417 != nil) {
-            NSString *newValueWithPDF417 = [NSString stringWithFormat:@"{\"rawPDF417\" : \"%@\", \"parsedPDF417\" : \"%@\"}", barcode.value, [barcode.parsedPDF417[kPDF417ParsedBody] description]];
-            [barcodeDictionary setValue:newValueWithPDF417 forKey:@"value"];
-        }
-        [barcodeArray addObject:barcodeDictionary];
-    }
-    
-    [dictResult setValue:barcodeArray forKey:@"barcodes"];
-    
-    NSString *imagePath = [ALPluginHelper saveImageToFileSystem:scanResult.image compressionQuality:dividedCompRate];
-    
-    [dictResult setValue:imagePath forKey:@"imagePath"];
-    
-    NSString *fullImagePath = [ALPluginHelper saveImageToFileSystem:scanResult.fullImage compressionQuality:dividedCompRate];
-    [dictResult setValue:fullImagePath forKey:@"fullImagePath"];
-    
-    [dictResult setValue:@(scanResult.confidence) forKey:@"confidence"];
-    [dictResult setValue:[ALPluginHelper stringForOutline:outline] forKey:@"outline"];
-    
-    return dictResult;
+    [alert addAction:action];
+    [[UIApplication sharedApplication].keyWindow.rootViewController presentViewController:alert
+                                                                                 animated:YES
+                                                                               completion:NULL];
+    return YES;
 }
 
-+ (NSDictionary *)dictionaryForLicensePlateResult:(ALLicensePlateResult *)scanResult
-                                 detectedBarcodes:(NSMutableArray<NSDictionary *> *)detectedBarcodes
-                                          outline:(ALSquare *)outline
-                                          quality:(NSInteger)quality {
-    CGFloat dividedCompRate = (CGFloat)quality/100;
-    // Get the imagepath from result
-    NSString *imagePath = [ALPluginHelper saveImageToFileSystem:scanResult.image compressionQuality:dividedCompRate];
-    
-    //Create the result Object
-    NSMutableDictionary *dictResult = [NSMutableDictionary dictionaryWithCapacity:5];
-    [dictResult setValue:scanResult.country forKey:@"country"];
-    [dictResult setValue:scanResult.area forKey:@"area"];
-    [dictResult setValue:scanResult.result forKey:@"licensePlate"];
-    [dictResult setValue:[ALPluginHelper stringForOutline:outline] forKey:@"outline"];
-    [dictResult setValue:@(scanResult.confidence) forKey:@"confidence"];
-    [dictResult setValue:imagePath forKey:@"imagePath"];
-    
-    NSString *fullImagePath = [ALPluginHelper saveImageToFileSystem:scanResult.fullImage compressionQuality:dividedCompRate];
-    [dictResult setValue:fullImagePath forKey:@"fullImagePath"];
-    
-    if (detectedBarcodes && detectedBarcodes.count != 0) {
-        [dictResult setObject:detectedBarcodes forKey:@"detectedBarcodes"];
-    }
-    
-    return dictResult;
++ (NSError *)errorWithMessage:(NSString *)message {
+    return [NSError errorWithDomain:ALFlutterDomain code:1000 userInfo:@{ NSLocalizedDescriptionKey: message }];
 }
 
-+ (NSDictionary *)dictionaryForTransformedImage:(UIImage *)transformedImage
-                                      fullFrame:(UIImage *)fullFrame
-                                        quality:(NSInteger)quality
-                               detectedBarcodes:(NSMutableArray<NSDictionary *> *)detectedBarcodes
-                                        outline:(ALSquare *)outline {
-    NSMutableDictionary *dictResult = [NSMutableDictionary dictionaryWithCapacity:4];
-    
-    CGFloat dividedCompRate = (CGFloat)quality/100;
-    NSString *imagePath = [ALPluginHelper saveImageToFileSystem:transformedImage compressionQuality:dividedCompRate];
-    NSString *fullImagePath = [ALPluginHelper saveImageToFileSystem:fullFrame compressionQuality:dividedCompRate];
-    NSString *outlineString = [ALPluginHelper stringForOutline:outline];
-    
-    
-    [dictResult setValue:imagePath forKey:@"imagePath"];
-    [dictResult setValue:fullImagePath forKey:@"fullImagePath"];
-    [dictResult setValue:outlineString forKey:@"outline"];
-    
-    if (detectedBarcodes && detectedBarcodes.count != 0) {
-        [dictResult setObject:detectedBarcodes forKey:@"detectedBarcodes"];
-    }
-    
-    return dictResult;
-}
+// MARK: - Date Utils
 
-+ (NSDictionary *)dictionaryForCompositeResult:(ALCompositeResult *)scanResult
-                              detectedBarcodes:(NSMutableArray<NSDictionary *> *)detectedBarcodes
-                                       quality:(NSInteger)quality {
-    
-    
-    NSMutableDictionary *dictResult = [[NSMutableDictionary alloc] init];
-    
-    for (NSString *pluginID in [scanResult.result allKeys]) {
-        
-        NSDictionary *singleResultDict = [ALPluginHelper dictForResult:[scanResult.result objectForKey:pluginID]
-                                                      detectedBarcodes:detectedBarcodes
-                                                               quality:quality];
-        
-        [dictResult setObject:singleResultDict forKey:pluginID];
-        
-    }
-    return dictResult;
++ (NSDate *)formattedStringToDate:(NSString *)formattedStr {
+    // From this: "Sun Apr 12 00:00:00 UTC 1977" to this: "04/12/1977"
+    NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
+    [dateFormatter setTimeZone:[NSTimeZone timeZoneWithAbbreviation:@"GMT+0:00"]];
+    dateFormatter.dateFormat = @"E MMM d HH:mm:ss zzz yyyy";
+    NSDate *d = [dateFormatter dateFromString:formattedStr];
+    return d;
 }
 
-+ (NSDictionary *)dictionaryForTireResult:(ALTireResult *)scanResult
-                                  quality:(NSInteger)quality {
-    CGFloat dividedCompRate = (CGFloat)quality/100;
-    
-    NSMutableDictionary *dictResult = [NSMutableDictionary dictionaryWithCapacity:4];
-    
-    [dictResult setObject:scanResult.result forKey:@"text"];
-    
-    NSString *imagePath = [ALPluginHelper saveImageToFileSystem:scanResult.image compressionQuality:dividedCompRate];
-    
-    [dictResult setValue:imagePath forKey:@"imagePath"];
-    
-    NSString *fullImagePath = [ALPluginHelper saveImageToFileSystem:scanResult.fullImage compressionQuality:dividedCompRate];
-    [dictResult setValue:fullImagePath forKey:@"fullImagePath"];
-    [dictResult setValue:@(scanResult.confidence) forKey:@"confidence"];
-    [dictResult setValue:scanResult.pluginID forKey:@"pluginID"];
-    return dictResult;
++ (NSString *)stringForDate:(NSDate *)date {
+    NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
+    [dateFormatter setTimeZone:[NSTimeZone timeZoneWithAbbreviation:@"GMT+0:00"]];
+    dateFormatter.dateStyle = NSDateFormatterMediumStyle;
+    dateFormatter.timeStyle = NSDateFormatterNoStyle;
+    return [dateFormatter stringFromDate:date];
 }
 
-+ (NSDictionary *)dictForResult:(ALScanResult *)result
-               detectedBarcodes:(NSMutableArray<NSDictionary *> *)detectedBarcodes
-                        quality:(NSInteger)quality {
-    if ([result isKindOfClass:[ALMeterResult class]]) {
-        return [ALPluginHelper dictionaryForMeterResult:(ALMeterResult *)result
-                                       detectedBarcodes:detectedBarcodes
-                                                outline:[[ALSquare alloc] init]
-                                                quality:quality];
-        
-    } else if ([result isKindOfClass:[ALLicensePlateResult class]]) {
-        return [ALPluginHelper dictionaryForLicensePlateResult:(ALLicensePlateResult *)result
-                                              detectedBarcodes:detectedBarcodes
-                                                       outline:[[ALSquare alloc] init]
-                                                       quality:quality];
-    } else if ([result isKindOfClass:[ALIDResult class]]) {
-        return [ALPluginHelper dictionaryForIDResult:(ALIDResult *)result
-                                    detectedBarcodes:detectedBarcodes
-                                             outline:[[ALSquare alloc] init]
-                                             quality:quality];
-        
-    } else if ([result isKindOfClass:[ALBarcodeResult class]]) {
-        return [ALPluginHelper dictionaryForBarcodeResult:(ALBarcodeResult *)result
-                                                  outline:[[ALSquare alloc] init]
-                                                  quality:quality];
-        
-    } else if ([result isKindOfClass:[ALOCRResult class]]) {
-        return [ALPluginHelper dictionaryForOCRResult:(ALOCRResult *)result
-                                     detectedBarcodes:detectedBarcodes
-                                              outline:[[ALSquare alloc] init]
-                                              quality:quality];
-        
-    } else if ([result.result isKindOfClass:[UIImage class]]) {
-        return [ALPluginHelper dictionaryForTransformedImage:(UIImage *)result.result
-                                                   fullFrame:result.fullImage
-                                                     quality:quality
-                                            detectedBarcodes:detectedBarcodes
-                                                     outline:[[ALSquare alloc] init]];
-        
+// MARK: - Plugin Reflection
+
+// return the ALPluginConfig property whose name ends with 'Config', is nonnull, AND which has a `scanMode` property
++ (NSString * _Nullable)confPropKeyWithScanModeForPluginConfig:(ALPluginConfig *)pluginConfig {
+    unsigned int count;
+    Ivar *ivars = class_copyIvarList(ALPluginConfig.class, &count);
+    for (int i = 0; i < count; i++) {
+        const char *ivarName = ivar_getName(((Ivar * _Nonnull)ivars)[i]);
+        NSString *key = [NSString stringWithCString:(const char * _Nonnull)ivarName encoding:NSUTF8StringEncoding];
+        key = [key stringByTrimmingCharactersInSet:NSCharacterSet.punctuationCharacterSet];
+
+        // Looking for "Config" at the end of the property name.
+        NSRange range = [key rangeOfString:@"Config"];
+        if (range.location == NSNotFound) { continue; }
+        if (range.location + @"Config".length == key.length) {
+            id obj;
+            if ((obj = [pluginConfig valueForKey:key])) { // config property is non-null
+                // one last check: does the value associated with this key have a scanMode property (that is a string type)?
+                if ([obj respondsToSelector:NSSelectorFromString(@"scanMode")]) {
+                    return key; // this key is valid for self.pluginConfig, obj is the object tied to this key
+                }
+                // the rest wouldn't meet the requirements, so don't bother with them.
+                return nil;
+            }
+        }
     }
-    
+    free(ivars);
     return nil;
 }
 
-#pragma mark - Date Parsing Utils
-
-+ (NSString *)stringForDate:(NSDate *)date {
-    if (!date) {
-        return nil;
-    }
-    
-    NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];
-    [dateFormatter setTimeZone:[NSTimeZone timeZoneWithAbbreviation:@"UTC+0:00"]];
-    [dateFormatter setDateFormat:@"EEE MMM d hh:mm:ss ZZZZ yyyy"];
-    
-    //Date will be formatted to string - e.g.: "Fri Jan 11 12:00:00 GMT+0:00 1980"
-    NSString *dateString = [dateFormatter stringFromDate:date];
-    
-    return dateString;
-}
 
 @end