allprojects {
 repositories {
 //...
 maven {
 url "https://maven.pkg.github.com/Fourthline-com/FourthlineSDK-Android"
 credentials {
 username ""
 password getLocalProperty("github_token")
 }
 }
 }
}

allprojects {
 repositories {
 //...
 maven {
 url = URI("https://maven.pkg.github.com/Fourthline-com/FourthlineSDK-Android")
 credentials {
 username = ""
 password = getLocalProperty("github_token")
 }
 }
 }
}

//..
github_token=YOUR_ACCESS_TOKEN

dependencies {
 // ...
 def fourthlineSdkVersion = "%%LATEST_SDK_VERSION%%"
 implementation "com.fourthline:fourthline-sdk:$fourthlineSdkVersion"
}

dependencies {
 // ...
 val fourthlineSdkVersion = "%%LATEST_SDK_VERSION%%"
 implementation("com.fourthline:fourthline-sdk:$fourthlineSdkVersion")
}

 <dict>
 <key>com.apple.developer.nfc.readersession.formats</key>
 <array>
 <string>TAG</string>
 <string>PACE</string>
 </array>
 </dict>

//1. Install Carthage on your machine. See GitHub – [Carthage](https://github.com/Carthage/Carthage) <img src="https://files.readme.io/f7f4159-Open_new_tab.svg" align="left"/>.
//2. Ensure the Carthage version is at least **0.38**. If installed via HomeBrew, you can check this with the following command: `brew list --versions carthage`
//3. Add **Cartfile** to the root of your project (or extend an existing one):

github "Fourthline-com/FourthlineSDK-iOS" == version.to.integrate

//4. Open a terminal and in your project root folder, run `carthage update --platform iOS --use-xcframeworks`. 
//5. Authenticate in Fourthline's SDK repository using the credentials provided by your implementation manager.
//6. Go to the `Carthage/Build/iOS` folder, and then drag all the frameworks into the `Frameworks, libraries, and embedded content` section in Xcode. 
//7. Set the `Embed` value to `Embed & sign`.

//1. Install CocoaPods on your machine. See CocoaPods – [Installation](https://guides.cocoapods.org/using/getting-started.html) <img src="https://files.readme.io/f7f4159-Open_new_tab.svg" align="left"/>.
//2. Add **Podfile** to the root of your project (or extend an existing one):

source 'https://github.com/Fourthline-com/FourthlineSDK-iOS-Specs.git' # to add our private pod
source 'https://github.com/CocoaPods/Specs.git' # to add other public pods

$version = 'version.to.integrate'
use_frameworks!
platform :ios, '12.0'
target 'YourTargetName' do
 pod 'FourthlineSDK', $version
end

// Minimum version: v2.30.0
//1. In Xcode, go to **File** > **Add packages**.
//2. Enter the following URL: `https://github.com/Fourthline-com/FourthlineSDK-iOS`
//3. Select and import the following frameworks: `FourthlineCore`, `FourthlineVision`, `FourthlineNFC`, `FourthlineKYC`, `FourthlineSDK`.

// Initialize analytics by calling `FourthlineAnalytics.initialize(TENANT_ID, context)` when suitable, usually in `Application.onCreate()` using the `tenantId` provided by Fourthline.
try {
    FourthlineAnalytics.initialize(tenantId = "<tenantId provided by Fourthline>", context = applicationContext)
} catch (e: AnalyticsError) {
    when (e) {
        is AnalyticsError.DatadogNotImported -> TODO()
        is AnalyticsError.InvalidTenantId -> TODO()
    }
}

FourthlineAnalytics.setTrackingConsent(consent = TrackingConsent.GRANTED)

import FourthlineCore

// Initialize `FourthlineAnalytics` inside `application(_:didFinishLaunchingWithOptions:)` with the `tenantId` provided by Fourthline.

do {
  try FourthlineAnalytics.initialize(tenantId: "<tenantId provided by Fourthline>")
} catch let error as AnalyticsError {
  // Handle AnalyticsError
} catch {
  // Handle Error
}
 
// Set `TrackingConsent` to `.granted`
 FourthlineAnalytics.setTrackingConsent(consent: .granted)

import com.fourthline.analytics.AnalyticsObserver
import com.fourthline.analytics.FourthlineAnalytics

val observer = object : AnalyticsObserver {
    override fun log(event: String, attributes: Map<String, Any?>) {
        // Log the Fourthline event
    }
}

FourthlineAnalytics.setObserver(observer)

import FourthlineCore

let observer = AnalyticsManager()
FourthlineAnalytics.setObserver(observer) 

class AnalyticsManager: AnalyticsObserver {
  func log(event: String, attributes: [String: Codable]?) {
    // Log the Fourthline event
  }
}

import com.fourthline.orca.Orca
import com.fourthline.orca.workflow.WorkflowResults.*
import com.fourthline.orca.workflow.workflow

Orca.workflow(context, validationCode)
  .configure(config)
  .customize(customisationConfig)
  .addDelegate { results ->
    when(results){
      is IDV.Address -> TODO()
      is IDV.DeviceMetadata -> TODO()
      is IDV.Document -> TODO()
      is IDV.DocumentVideo -> TODO()
      is IDV.Nfc -> TODO()
      is IDV.Person -> TODO()
      is IDV.Selfie -> TODO()
      is IDV.SelfieVideo -> TODO()
    }
  }
  .present { result -> }

import FourthlineSDK

class MyClass {
  func launchOrca() {
    let configuration = WorkflowConfig(networkEnvironment: .mock)
    let validationCode = "xxxxxxxx"
    Orca.workflow(validationCode: validationCode)
      .configure(with: configuration)
      .addDelegate(self)
      .present { [weak self] result in
        switch result {
        case let .failure(error):
          self?.handleError(error)
        case .success:
          // User has successfully finished the workflow.
          break
        }
      }
  }
}

// MARK: - WorkflowDataDelegate
extension MyClass: WorkflowDataDelegate {
  func didUploadData(_ data: FourthlineSDK.WorkflowResults) {
    switch data {
    case let .idv(value: idvPart):
      switch idvPart {
      case let .document(document):
        print("Did upload Document")
      case let .documentVideo(video):
        print("Did upload Document Video")
      case let .selfie(selfie):
        print("Did upload Selfie")
      case let .selfieVideo(video):
        print("Did upload Selfie Video")
      case let .nfc(nfc):
        print("Did upload Nfc")
      case let .address(address):
        print("Did upload Address")
      case let .person(person):
        print("Did upload Person")
      case let .deviceMetadata(deviceMetadata):
        print("Did upload Device Metadata")
      }
    default:
      print("Handle Workflow data...")
    }
  }
}

context.deleteFourthlineFiles()

FourthlineFileManager.deleteFourthlineFiles(context);

FileManager.default.deleteFourthlineFiles()

<key>NSCameraUsageDescription</key>
<string>To verify your identity, please allow us to access your camera once only.</string>

 <dict>
 <key>com.apple.developer.nfc.readersession.formats</key>
 <array>
 <string>TAG</string>
 <string>PACE</string>
 </array>
 </dict>

<key>NFCReaderUsageDescription</key>
<string>Please enable NFC in order to read the chip from your document</string>

<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
<array>
 <string>A0000002471001</string>
 <string>A00000045645444C2D3031</string>
</array>

<key>NSMicrophoneUsageDescription</key>
<string>To verify your identity, please allow access to the microphone</string>

<key>NSLocationWhenInUseUsageDescription</key>
<string>To verify your identity, please allow access to your location.</string>

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>To verify your identity, please allow access to your location.</string>

<key>NSLocationTemporaryUsageDescriptionDictionary</key>
<dictionary>
	<key>FourthlineFullAuthorizationPurposeKey</key>
 <string>To verify your identity, your exact location is shared with us once only.</string>
</dictionary>

<key>UIAppFonts</key>
	<array>
		<string>Your-Font-Medium.ttf</string>
		<string>Your-Font-Regular.ttf</string>
	</array>

allprojects {
 repositories {
 //...
 maven {
 url = URI("https://maven.pkg.github.com/Fourthline-com/FourthlineSDK-Android")
 credentials {
 username = ""
 password = property("fourthlineGithubToken").toString()
 }
 }
 }
}

<key>NSCameraUsageDescription</key>
<string>To verify your identity, please allow us to access your camera once only.</string>

<key>NFCReaderUsageDescription</key>
<string>Please enable NFC in order to read the chip from your document</string>

<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
<array>
 <string>A0000002471001</string>
 <string>A00000045645444C2D3031</string>
</array>

<key>NSMicrophoneUsageDescription</key>
<string>To verify your identity, please allow access to the microphone</string>

<key>NSLocationWhenInUseUsageDescription</key>
<string>To verify your identity, please allow access to your location.</string>

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>To verify your identity, please allow access to your location.</string>

<key>NSLocationTemporaryUsageDescriptionDictionary</key>
<dictionary>
	<key>FourthlineFullAuthorizationPurposeKey</key>
 <string>To verify your identity, your exact location is shared with us once only.</string>
</dictionary>

<key>UIAppFonts</key>
	<array>
		<string>Your-Font-Medium.ttf</string>
		<string>Your-Font-Regular.ttf</string>
	</array>

allprojects {
 repositories {
 //...
 maven {
 url = URI("https://maven.pkg.github.com/Fourthline-com/FourthlineSDK-Android")
 credentials {
 username = ""
 password = property("fourthlineGithubToken").toString()
 }
 }
 }
}

<key>NSCameraUsageDescription</key>
<string>To verify your identity, please allow us to access your camera once only.</string>

<key>NFCReaderUsageDescription</key>
<string>Please enable NFC in order to read the chip from your document</string>

<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
<array>
 <string>A0000002471001</string>
 <string>A00000045645444C2D3031</string>
</array>

<key>NSMicrophoneUsageDescription</key>
<string>To verify your identity, please allow access to the microphone</string>

<key>NSLocationWhenInUseUsageDescription</key>
<string>To verify your identity, please allow access to your location.</string>

<key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
<string>To verify your identity, please allow access to your location.</string>

<key>NSLocationTemporaryUsageDescriptionDictionary</key>
<dictionary>
	<key>FourthlineFullAuthorizationPurposeKey</key>
 <string>To verify your identity, your exact location is shared with us once only.</string>
</dictionary>

<key>UIAppFonts</key>
	<array>
		<string>Your-Font-Medium.ttf</string>
		<string>Your-Font-Regular.ttf</string>
	</array>

dependencies:
 ...
 fourthline_plugin:
 git:
 url: [email protected]:fourthline-com/fourthline_flutter.git
 version: ^1.0.0

{
  "trackingConsent": string
}

{
  "errorCode": number,
  "errorDescription": string
}

{
  "tenantId": string
}

{
  "errorCode": number,
  "errorDescription": string
}

var config = `{
 "tenantId": "fl-xxxxxxxx"
 }`;

Fourthline.initializeAnalytics(
    config,
    function() {
        // Analytics successfully initialized
        // No further action required
    },
    function(error) {
        // Extract and process the information received in JSON error string format
        var jsonError = JSON.parse(error);
        // ...
    }
);

var trackingConsentConfig = `{
 "trackingConsent": "granted"
 }`;

Fourthline.setTrackingConsent(
   trackingConsentConfig,
    function() {
        // Tracking consent successfully updated
        // No further action required
    },
    function(error) {
        // Extract and process the information received in JSON error string format
        var jsonError = JSON.parse(error);
        // ...
    }
);

try {
  String config = '{"tenantId": "Ten-xxxxxxxFL"}';
  await _fourthlinePlugin.initializeAnalytics(config) ??
          "Could not initialize analytics";
  // Analytics successfully initialized
  // No further action required
} on PlatformException catch (e) {
	String? message = e.message;
 	 switch (e.code) {
    case "0":
      print('Error invalid tenant Id: $message');
      break;
  	}
};

try {
  String config = '{"trackingConsent": "granted"}';
  await _fourthlinePlugin.setTrackingConsent(config) ??
          "Could not set tracking consent";
  // Tracking consent successfully updated
  // No further action required
} on PlatformException catch (e) {
  // Extract and process the information from the error
};

// Instance variable defined in your Dart class
final _fourthlinePlugin = Fourthline();

import { NativeModules } from 'react-native'

var config = `{
 "tenantId": "fl-xxxxxxxx"
 }`;

NativeModules.Fourthline.initializeAnalytics(config)
    .then(() => {
        // Analytics successfully initialized
        // No further action required
    })
    .catch((error) => {
        // Extract and process the information received in JSON error string format
        var jsonError = JSON.parse(error.message);
        // ...
    });
    
var trackingConsentConfig = `{
 "trackingConsent": "granted"
 }`;
 
NativeModules.Fourthline.setTrackingConsent(trackingConsentConfig)
    .then(() => {
        // Tracking consent successfully updated
        // No further action required
    })
    .catch((error) => {
        // Extract and process the information received in JSON error string format
        var jsonError = JSON.parse(error.message);
        // ...
    });
    

Fourthline.setAnalyticsObserver(
    function(eventData) {
        // Handle eventData
    }
);

import 'package:flutter/services.dart';
import 'package:fourthline/fourthline.dart';

class _ExampleWidgetState extends State<ExampleWidget> {
  StreamSubscription<dynamic>? _eventSubscription;

  @override
  void initState() {
    super.initState();

    // Start observing analytics events
    await _fourthlinePlugin.setAnalyticsObserver() ?? "Could not set analytics observer";
    
    // Start listening to the event channel
    _eventSubscription = Fourthline.analyticsEventChannel
        .receiveBroadcastStream()
        .listen(_handleAnalyticsEvent, onError: null);

  }

  @override
  void dispose() {
    // Clean up the listener when the widget is disposed
    _eventSubscription?.cancel();

    // Stop observing analytics events
    await _fourthlinePlugin.removeAnalyticsObserver() ?? "Could not remove analytics observer";

    super.dispose();
  }

  void _handleAnalyticsEvent(dynamic data) {
    // Handle the custom event
    print('Received event: $data');
  }

  // ... rest of your widget
}

import { NativeEventEmitter, NativeModules } from 'react-native'

const analyticsManagerEmitter = new NativeEventEmitter(NativeModules.Fourthline);

// Subscribe
analyticsEventListener = analyticsManagerEmitter.addListener(
      'fourthlineAnalytics',
       (eventJson) => {
         // Handle the Fourthline event
    });

// Unsubscribe
analyticsEventListener.remove();
NativeModules.Fourthline.removeListener('fourthlineAnalytics');

{
  "event": string,
  "attributes": Object
}

{
 "configuration": WorkflowConfiguration,
 "customization": WorkflowCustomization
}

{
 "networkEnvironment": NetworkEnvironment, // To test a workflow locally use .mock, and to test workflow networking use .sandbox
 "validationCode": string, // Returned in the Create SDK session response
}

{
 "flavor": string
}

var config = `{
 "configuration": {
 "validationCode": "123456",
 "networkEnvironment": "sandbox"
 },
 "customization": {
 "flavor": {
 "colors": ${orcaColors},
 "fonts": ${orcaFonts},
 "localization": ${orcaLocalization},
 "layouts": ${orcaLayout}
 }
 }
}`;

Fourthline.startWorkflow(config,
 function(msg) {
 // Client has successfully completed the workflow
 // No further action required
 },
 function(error) {
 // Extract and process the information received in JSON error string format
 var jsonError = JSON.parse(error.message);
 }
);

String config = """{
 "configuration": {
 "validationCode": "123456",
 "networkEnvironment": "sandbox"
 },
 "customization": {
 "flavor": {
 "colors": $orcaColors,
 "fonts": $orcaFonts,
 "localization": $orcaLocalization,
 "layouts": $orcaLayout
 }
 }
}
""";

try {
 String result = await _fourthlinePlugin.startWorkflow(config) ?? "";
 // Client has successfully completed the workflow
 } on Exception catch (e) {
 // Extract and process the information from the error
 String? message = e.message;
 switch (e.code) {
 case "803":
 print('User canceled $message');
 break;
 case "1000":
 print('Client rejected');
 break;
 }
 };
);

var config = `{
 "configuration": {
 "validationCode": "123456",
 "networkEnvironment": "sandbox"
 },
 "customization": {
 "flavor": {
 "colors": ${orcaColors},
 "fonts": ${orcaFonts},
 "localization": ${orcaLocalization},
 "layouts": ${orcaLayout}
 }
 }
}`;

NativeModules.Fourthline.startWorkflow(config)
	.then((msg) => {
 // Client has successfully completed the workflow
 // No further action required
	})
	.catch((error) => {
		// Extract and process the information received in JSON error string format
		var jsonError = JSON.parse(error.message);
	});

{
 "errorCode": number,
 "errorDescription": string
}

Fourthline.setWorkflowDataObserver(
 function(dataJson) {
 // Handle dataJson
 }
);

// Remove observer
Fourthline.removeWorkflowDataObserver();

import 'package:flutter/services.dart';
import 'package:fourthline/fourthline.dart';

class _ExampleWidgetState extends State<ExampleWidget> {
 StreamSubscription<dynamic>? _workflowDataSubscription;

 @override
 void initState() {
 super.initState();

 // Start listening to the event channel
 _workflowDataSubscription = Fourthline.workflowDataEventChannel
 .receiveBroadcastStream()
 .listen(_handleWorkflowDataEvent, onError: null);

	// Start a workflow
 }

 @override
 void dispose() {
 // Clean up the listener when the widget is disposed
 _workflowDataSubscription?.cancel();

 super.dispose();
 }
 
 void _startWorkflow() {
 String config = """{
 "configuration": {
 "validationCode": "IDV",
 "networkEnvironment": "mock"
 }
 }
 """;
 try {
 String result = await _fourthlinePlugin.startWorkflow(config) ?? "";
 } on Exception catch (e) {
 showAlertDialog("Error", e.toString());
 };
 }

 void _handleWorkflowDataEvent(dynamic data) {
 // Handle the data upload event
 print('Uploaded data: $data');
 }
}

import { NativeEventEmitter, NativeModules } from 'react-native'
const eventManagerEmitter = new NativeEventEmitter(NativeModules.Fourthline);
// Subscribe
workflowDataListener = eventManagerEmitter(
      ‘fourthlineWorkflowData’,
       (dataJson) => {
         // handle the workflow data...
    });
// Unsubscribe
workflowDataListener.remove();
NativeModules.Fourthline.removeListener('fourthlineWorkflowData');

"idv":{
  "document":{
    "type":"string",
    "number":"string",
    "issueDate":"string", // Optional, format YYYY-MM-DD
    "expirationDate":"string", // Optional, format YYYY-MM-DD
    "images":[
      {
        "image":"string",
        "fileSide":"string",
        "isAngled":"boolean",
        "timestamp":"string", // Optional, format "YYYY-MM-dd'T'HH:mm:ssZZZZZ"
        "location":{
          "latitude":"number",
          "longitude":"number"
        }
      }
    ]
  }
}

"idv":{
  "documentVideo":{
    "url":"string",
    "duration":"string", // Default / extended
    "location":{ // Optional
      "latitude":"number",
      "longitude":"number"
    }
  }
}

"idv":{
  "selfie":{
    "image":"string",
    "timestamp":"string", // Optional
    "location":{ // Optional
      "latitude":"number",
      "longitude":"number"
    }
  }
}

"idv":{
  "selfieVideo":{
    "url":"string",
    "duration":"string", // Default / extended
    "location":{ // Optional
      "latitude":"number",
      "longitude":"number"
    }
  }
}

"idv":{
  "nfc":{
    "image":"string", // Optional
    "timestamp":"string",
    "location":{ // Optional
      "latitude":"number",
      "longitude":"number"
    },
    "mrz":"string",
    "dataGroups":[ // Optional
      {
        "groupNumber":"Int",
        "data":"string"
      }
    ]
  }
}

"idv":{
  "address":{
    "street":"string",
    "streetNumber":"Int",
    "streetNumberSuffix":"string", // Optional
    "postalCode":"string",
    "city":"string",
    "countryCode":"string",
    "region":"string" // Optional
  }
}

"idv":{
  "person":{
    "firstName":"string",
    "middleName":"string", // Optional
    "lastName":"string",
    "gender":"string",
    "nationalityCode":"string",
    "birthCountryCode":"string", // Optional
    "birthPlace":"string", // Optional
    "birthDate":"string" // Format YYYY-MM-DD
  }
}

"idv":{
  "deviceMetadata":{
    "model":"string",
    "sdkVersion":"string",
    "osVersion":"string",
    "language":"string",
    "osCompromised":"string",
    "location":{ // Optional
      "latitude":"number",
      "longitude":"number"
    }
  }
}

Fourthline.deleteFourthlineFiles(
 function() {
 // Fourthline files deleted
 }
);

await _fourthlinePlugin.deleteFourthlineFiles();

// Instance variable defined in your Dart class
final _fourthlinePlugin = Fourthline();

import { NativeModules } from 'react-native'

NativeModules.Fourthline.deleteFourthlineFiles().then(() => {
 	// Fourthline files deleted
 });