diff --git a/build.gradle.kts b/build.gradle.kts
index 048ef9c..b02a05d 100644
--- a/build.gradle.kts
+++ b/build.gradle.kts
@@ -1,7 +1,8 @@
 
 plugins {
-    id("com.android.application") version "8.3.2" apply false
-    id("org.jetbrains.kotlin.android") version "1.9.25" apply false
+    id("com.android.application") version "8.9.0" apply false
+    id("org.jetbrains.kotlin.android") version "2.2.21" apply false
+    id( "org.jetbrains.kotlin.plugin.compose") version "2.2.21" apply false
 }
 
 tasks.register("clean", Delete::class.java) {
diff --git a/example_app/build.gradle b/example_app/build.gradle
index 4b872a1..eea6000 100644
--- a/example_app/build.gradle
+++ b/example_app/build.gradle
@@ -2,6 +2,7 @@
 plugins {
     id("com.android.application")
     id("org.jetbrains.kotlin.android")
+    id( "org.jetbrains.kotlin.plugin.compose")
 }
 
 android {
@@ -54,7 +55,7 @@ dependencies {
     implementation("androidx.constraintlayout:constraintlayout:2.1.4")
 
 
-    def sdkVersion = "7.1.2"
+    def sdkVersion = "8.0.0.49-STAGING-SNAPSHOT"
 
     implementation("io.scanbot:scanbot-barcode-scanner-sdk:$sdkVersion")
     implementation("io.scanbot:rtu-ui-v2-barcode:$sdkVersion")
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/Application.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/Application.kt
index 98f5642..d0a818d 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/Application.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/Application.kt
@@ -2,7 +2,6 @@ package io.scanbot.example.sdk.barcode
 
 import android.app.Application
 import io.scanbot.sap.IScanbotSDKLicenseErrorHandler
-import io.scanbot.sap.SdkFeature
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDKInitializer
 import io.scanbot.sdk.pdf.PdfImagesExtractor
@@ -26,11 +25,9 @@ class ExampleApplication : Application() {
             .withLogging(true)
             // TODO 2/2: Enable the Scanbot Barcode SDK license key
             //.license(this, licenseKey)
-            .licenceErrorHandler(IScanbotSDKLicenseErrorHandler { status, feature, statusMessage ->
+            .licenseErrorHandler (IScanbotSDKLicenseErrorHandler { status, feature, statusMessage ->
                 LoggerProvider.logger.d("ExampleApplication", "+++> License status: ${status.name}. Status message: $statusMessage")
-                if (feature != SdkFeature.NoSdkFeature) {
-                    LoggerProvider.logger.d("ExampleApplication", "+++> Feature not available: ${feature.name}")
-                }
+                LoggerProvider.logger.d("ExampleApplication", "+++> Feature not available: ${feature.name}")
             })
             .pdfImagesExtractorType(PdfImagesExtractor.Type.PDFIUM) // select PDFium or default android pdf library to extract barcode image
             // Uncomment to switch back to the legacy camera approach in Ready-To-Use UI screens
@@ -43,7 +40,7 @@ class ExampleApplication : Application() {
         val licenseInfo = ScanbotBarcodeScannerSDK(this).licenseInfo
         LoggerProvider.logger.d("ExampleApplication", "License status: ${licenseInfo.status}")
         LoggerProvider.logger.d("ExampleApplication", "License isValid: ${licenseInfo.isValid}")
-        LoggerProvider.logger.d("ExampleApplication", "License expirationDate: ${licenseInfo.expirationDate}")
+        LoggerProvider.logger.d("ExampleApplication", "License expirationDate: ${licenseInfo.expirationDateString}")
     }
 }
 
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/ArOverlayUseCaseSnippet.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/ArOverlayUseCaseSnippet.kt
index b50d9b7..c076a18 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/ArOverlayUseCaseSnippet.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/ArOverlayUseCaseSnippet.kt
@@ -12,6 +12,7 @@ package io.scanbot.example.sdk.barcode.doc_code_snippet
 // TODO: add URLs here
 
 // @Tag("Configuring RTU UI v2 Barcode AR overlay snippet")
+import io.scanbot.sdk.barcode.BarcodeFormatCommonConfiguration
 import io.scanbot.sdk.barcode.BarcodeFormats
 import io.scanbot.sdk.ui_v2.barcode.configuration.BarcodeScannerConfiguration
 import io.scanbot.sdk.ui_v2.barcode.configuration.BarcodeScannerScreenConfiguration
@@ -39,7 +40,7 @@ fun arOverlayUseCaseSnippet() {
         }
 
         // Set an array of accepted barcode types.
-        this.scannerConfiguration.barcodeFormats = BarcodeFormats.common
+        this.scannerConfiguration.barcodeFormatConfigurations = listOf(BarcodeFormatCommonConfiguration(formats = BarcodeFormats.common))
 
         // Configure other parameters as needed.
     }
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeAdvancedConfigSnippet.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeAdvancedConfigSnippet.kt
index 835b9c0..b1cb99f 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeAdvancedConfigSnippet.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeAdvancedConfigSnippet.kt
@@ -32,7 +32,7 @@ import java.util.EnumSet
 
 fun barcodeScannerWithAdvancedConfigSnippet(context: Context) {
     // @Tag("Advanced configuring Barcode Scanner")
-    val barcodeScanner = ScanbotBarcodeScannerSDK(context).createBarcodeScanner()
+    val barcodeScanner = ScanbotBarcodeScannerSDK(context).createBarcodeScanner().getOrThrow()
 
     var configs = mutableListOf<BarcodeFormatConfigurationBase>()
 
@@ -133,7 +133,7 @@ fun barcodeFormatIndividualSimplifiedConfigurationSnippet(context: Context) {
 
 fun barcodeParsersConfigurationSnippet(context: Context) {
     // @Tag("Configuring parsers in Barcode Scanner")
-    val barcodeScanner = ScanbotBarcodeScannerSDK(context).createBarcodeScanner()
+    val barcodeScanner = ScanbotBarcodeScannerSDK(context).createBarcodeScanner().getOrThrow()
 
     var configs = mutableListOf<BarcodeFormatConfigurationBase>()
 
@@ -149,7 +149,7 @@ fun barcodeParsersConfigurationSnippet(context: Context) {
 
 fun barcodeRegexpConfigurationSnippet(context: Context) {
     // @Tag("Configuring regexp in Barcode Scanner")
-    val barcodeScanner = ScanbotBarcodeScannerSDK(context).createBarcodeScanner()
+    val barcodeScanner = ScanbotBarcodeScannerSDK(context).createBarcodeScanner().getOrThrow()
 
     var configs = mutableListOf<BarcodeFormatConfigurationBase>()
     val baseConfig = BarcodeFormatCommonConfiguration.default().copy(
@@ -176,7 +176,7 @@ fun barcodeRegexpConfigurationSnippet(context: Context) {
 
 fun barcodeTinyBarcodeConfigurationSnippet(context: Context) {
     // @Tag("Configuring tiny barcodes in Barcode Scanner")
-    val barcodeScanner = ScanbotBarcodeScannerSDK(context).createBarcodeScanner()
+    val barcodeScanner = ScanbotBarcodeScannerSDK(context).createBarcodeScanner().getOrThrow()
 
     barcodeScanner.setConfiguration(barcodeScanner.copyCurrentConfiguration().apply {
         // Example of adding a specific configuration for parsed documents
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeResultHandlingSnippet.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeResultHandlingSnippet.kt
index 8163574..3512ae4 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeResultHandlingSnippet.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeResultHandlingSnippet.kt
@@ -24,11 +24,12 @@ import io.scanbot.sdk.barcode.entity.SEPA
 import io.scanbot.sdk.barcode.entity.SwissQR
 import io.scanbot.sdk.barcode.entity.VCard
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
+import io.scanbot.sdk.image.ImageRef
 
-fun handlingResult(bitmap: Bitmap, context: Context) {
+fun handlingResult(imageRef: ImageRef, context: Context) {
     // @Tag("Handling the Result")
-    val barcodeScanner = ScanbotBarcodeScannerSDK(context).createBarcodeScanner()
-    val result = barcodeScanner.scanFromBitmap(bitmap, 0)
+    val barcodeScanner = ScanbotBarcodeScannerSDK(context).createBarcodeScanner().getOrThrow()
+    val result = barcodeScanner.run(imageRef).getOrNull()
     result?.barcodes?.forEach { barcodeItem ->
         // Handle the detected barcode(s) from result
         val barcodeText = barcodeItem.text
@@ -42,10 +43,10 @@ fun handlingResult(bitmap: Bitmap, context: Context) {
     // @EndTag("Handling the Result")
 }
 
-fun handlingParsedDocumentsResult(bitmap: Bitmap, context: Context) {
+fun handlingParsedDocumentsResult(imageRef: ImageRef,  context: Context) {
     // @Tag("Handling the parsed document result")
-    val barcodeScanner = ScanbotBarcodeScannerSDK(context).createBarcodeScanner()
-    val result = barcodeScanner.scanFromBitmap(bitmap, 0)
+    val barcodeScanner = ScanbotBarcodeScannerSDK(context).createBarcodeScanner().getOrThrow()
+    val result = barcodeScanner.run(imageRef).getOrNull()
     result?.barcodes?.forEach { barcodeItem ->
         barcodeItem.extractedDocument?.let { document ->
             when (document.type.name) {
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeScannerClassicUiSnippet.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeScannerClassicUiSnippet.kt
index d012854..d253593 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeScannerClassicUiSnippet.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeScannerClassicUiSnippet.kt
@@ -13,6 +13,7 @@ package io.scanbot.example.sdk.barcode.doc_code_snippet
 
 import android.os.Bundle
 import androidx.appcompat.app.AppCompatActivity
+import io.scanbot.common.onSuccess
 import io.scanbot.example.sdk.barcode.R
 import io.scanbot.sdk.barcode.BarcodeFormats
 import io.scanbot.sdk.barcode.BarcodeItem
@@ -22,8 +23,8 @@ import io.scanbot.sdk.barcode.ui.IBarcodeScannerViewCallback
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 import io.scanbot.sdk.camera.CameraModule
 import io.scanbot.sdk.camera.CaptureInfo
-import io.scanbot.sdk.camera.FrameHandlerResult
-import io.scanbot.sdk.common.AspectRatio
+import io.scanbot.sdk.geometry.AspectRatio
+import io.scanbot.sdk.image.ImageRef
 
 class BarcodeScannerClassicUiSnippetActivity : AppCompatActivity() {
 
@@ -35,7 +36,7 @@ class BarcodeScannerClassicUiSnippetActivity : AppCompatActivity() {
 
         // @Tag("Barcode Classic UI view snippet")
         barcodeScannerView = findViewById<BarcodeScannerView>(R.id.barcode_scanner_view)!!
-        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner()
+        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner().getOrThrow()
 
         // modify config as needed
         barcodeScanner.setConfiguration(
@@ -51,24 +52,27 @@ class BarcodeScannerClassicUiSnippetActivity : AppCompatActivity() {
         barcodeScannerView.apply {
             initCamera()
             initScanningBehavior(barcodeScanner,
-                { result ->
-                    if (result is FrameHandlerResult.Success) {
+                { result, frame ->
+                    result.onSuccess {
                         // process the scanned result here
                         // handleSuccess(result)
                     }
                     false
                 },
                 object : IBarcodeScannerViewCallback {
-                    override fun onCameraOpen() {
-                        // barcodeScannerView.viewController.useFlash(flashEnabled)
-                    }
-
-                    override fun onPictureTaken(image: ByteArray, captureInfo: CaptureInfo) {
+                    override fun onPictureTaken(
+                        image: ImageRef,
+                        captureInfo: CaptureInfo
+                    ) {
                         // process the full size images taken by BarcodeAutoSnappingController here
                         // to enable auto snapping use the following command:
                         // barcodeScannerView.viewController.autoSnappingEnabled = true
                     }
 
+                    override fun onCameraOpen() {
+                        // barcodeScannerView.viewController.useFlash(flashEnabled)
+                    }
+
                     override fun onSelectionOverlayBarcodeClicked(barcodeItem: BarcodeItem) {
                         // handle the barcode item selection here
                     }
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeScannerScanOnImageSnippet.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeScannerScanOnImageSnippet.kt
index 3308ce2..e53d32b 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeScannerScanOnImageSnippet.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeScannerScanOnImageSnippet.kt
@@ -17,6 +17,7 @@ import android.widget.Toast
 import io.scanbot.sdk.barcode.BarcodeScanner
 import io.scanbot.sdk.barcode.BarcodeScannerResult
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
+import io.scanbot.sdk.image.ImageRef
 
 fun scanOnImageSnippet(context: Context) {
     // @Tag("Creating the Scanner")
@@ -29,11 +30,11 @@ fun scanOnImageSnippet(context: Context) {
 fun processImageSnippet(
     sdk: ScanbotBarcodeScannerSDK,
     barcodeDetector: BarcodeScanner,
-    bitmap: Bitmap
+    imageRef: ImageRef
 ) {
     if (!sdk.licenseInfo.isValid) { return; }
 
-    val result = barcodeDetector.scanFromBitmap(bitmap, 0)
+    val result = barcodeDetector.run(imageRef).getOrThrow()
     // handle the detected barcode(s) from result
 }
 // @EndTag("Scanning from Bitmap")
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeSimpleConfigSnippet.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeSimpleConfigSnippet.kt
index 9d4c0f2..82294df 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeSimpleConfigSnippet.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/BarcodeSimpleConfigSnippet.kt
@@ -19,7 +19,7 @@ import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 
 fun barcodeScannerWithSimpleConfigSnippet(context: Context) {
     // @Tag("Simple configuring Barcode Scanner")
-    val barcodeScanner = ScanbotBarcodeScannerSDK(context).createBarcodeScanner()
+    val barcodeScanner = ScanbotBarcodeScannerSDK(context).createBarcodeScanner().getOrThrow()
 
     barcodeScanner.setConfiguration(
         barcodeScanner.copyCurrentConfiguration().apply {
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/FindAndPickUseCaseSnippet.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/FindAndPickUseCaseSnippet.kt
index 954fd85..725c9ce 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/FindAndPickUseCaseSnippet.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/FindAndPickUseCaseSnippet.kt
@@ -12,6 +12,7 @@ package io.scanbot.example.sdk.barcode.doc_code_snippet
 // TODO: add URLs here
 
 // @Tag("Configuring RTU UI v2 Barcode find and pick use case snippet")
+import io.scanbot.sdk.barcode.BarcodeFormatCommonConfiguration
 import io.scanbot.sdk.barcode.BarcodeFormats
 import io.scanbot.sdk.ui_v2.barcode.configuration.BarcodeScannerScreenConfiguration
 import io.scanbot.sdk.ui_v2.barcode.configuration.BarcodeUseCase
@@ -66,7 +67,7 @@ fun findAndPickModeUseCaseSnippet() {
         }
 
         // Set an array of accepted barcode types.
-        this.scannerConfiguration.barcodeFormats = BarcodeFormats.common
+        this.scannerConfiguration.barcodeFormatConfigurations = listOf(BarcodeFormatCommonConfiguration(formats = BarcodeFormats.common))
 
         // Configure other parameters as needed.
     }
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/ManualBarcodeDataParsingSnippet.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/ManualBarcodeDataParsingSnippet.kt
index 124d439..49bafa3 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/ManualBarcodeDataParsingSnippet.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/ManualBarcodeDataParsingSnippet.kt
@@ -16,6 +16,6 @@ import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 
 fun manualBarcodeDataParsing(context: Context, barcodeString: String) {
     val scanbotSDK = ScanbotBarcodeScannerSDK(context);
-    scanbotSDK.createBarcodeDocumentParser().parseDocument(barcodeString)
+    scanbotSDK.createBarcodeDocumentParser().getOrNull()?.parse(barcodeString)
 }
 
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/MultipleScanningCountUseCaseSnippet.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/MultipleScanningCountUseCaseSnippet.kt
new file mode 100644
index 0000000..71f141c
--- /dev/null
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/MultipleScanningCountUseCaseSnippet.kt
@@ -0,0 +1,59 @@
+package io.scanbot.example.sdk.barcode.doc_code_snippet
+
+/*
+    NOTE: this snippet of code is to be used only as a part of the website documentation.
+    This code is not intended for any use outside of the support of documentation by Scanbot SDK GmbH employees.
+*/
+
+// NOTE for maintainers: whenever changing this code,
+// ensure that links using it are still pointing to valid lines!
+// Pay attention to imports adding/removal/sorting!
+// Page URLs using this code:
+// TODO: add URLs here
+
+// @Tag("Configuring RTU UI v2 Barcode multiple scanning use case snippet")
+import io.scanbot.sdk.barcode.BarcodeFormatCommonConfiguration
+import io.scanbot.sdk.barcode.BarcodeFormats
+import io.scanbot.sdk.ui_v2.barcode.configuration.BarcodeScannerScreenConfiguration
+import io.scanbot.sdk.ui_v2.barcode.configuration.CollapsedVisibleHeight
+import io.scanbot.sdk.ui_v2.barcode.configuration.MultipleBarcodesScanningMode
+import io.scanbot.sdk.ui_v2.barcode.configuration.MultipleScanningMode
+import io.scanbot.sdk.ui_v2.barcode.configuration.SheetMode
+import io.scanbot.sdk.ui_v2.common.ScanbotColor
+
+fun multipleScanningCountUseCaseSnippet() {
+    // Create the default configuration object.
+    val config = BarcodeScannerScreenConfiguration().apply {
+        // Configure parameters (use explicit `this.` receiver for better code completion):
+
+        // Initialize the use case for multiple scanning.
+        this.useCase = MultipleScanningMode().apply {
+            // Set the counting mode.
+            this.mode = MultipleBarcodesScanningMode.COUNTING
+
+            // Set the sheet mode for the barcodes preview.
+            this.sheet.mode = SheetMode.COLLAPSED_SHEET
+
+            // Set the height for the collapsed sheet.
+            this.sheet.collapsedVisibleHeight = CollapsedVisibleHeight.LARGE
+
+            // Enable manual count change.
+            this.sheetContent.manualCountChangeEnabled = true
+
+            // Set the delay before same barcode counting repeat.
+            this.countingRepeatDelay = 1000
+
+            // Configure the submit button.
+            this.sheetContent.submitButton.text = "Submit"
+            this.sheetContent.submitButton.foreground.color = ScanbotColor("#000000")
+
+            // Configure other parameters, pertaining to multiple-scanning mode as needed.
+        }
+
+        // Set an array of accepted barcode types.
+        this.scannerConfiguration.barcodeFormatConfigurations = listOf(BarcodeFormatCommonConfiguration(formats = BarcodeFormats.common))
+
+        // Configure other parameters as needed.
+    }
+}
+// @EndTag("Configuring RTU UI v2 Barcode multiple scanning use case snippet")
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/MultipleScanningUseCaseSnippet.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/MultipleScanningUseCaseSnippet.kt
index b3a2cf5..212d5e5 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/MultipleScanningUseCaseSnippet.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/MultipleScanningUseCaseSnippet.kt
@@ -12,6 +12,7 @@ package io.scanbot.example.sdk.barcode.doc_code_snippet
 // TODO: add URLs here
 
 // @Tag("Configuring RTU UI v2 Barcode multiple scanning use case snippet")
+import io.scanbot.sdk.barcode.BarcodeFormatCommonConfiguration
 import io.scanbot.sdk.barcode.BarcodeFormats
 import io.scanbot.sdk.ui_v2.barcode.configuration.BarcodeScannerScreenConfiguration
 import io.scanbot.sdk.ui_v2.barcode.configuration.CollapsedVisibleHeight
@@ -28,7 +29,7 @@ fun multipleScanningUseCaseSnippet() {
         // Initialize the use case for multiple scanning.
         this.useCase = MultipleScanningMode().apply {
             // Set the counting mode.
-            this.mode = MultipleBarcodesScanningMode.COUNTING
+            this.mode = MultipleBarcodesScanningMode.UNIQUE
 
             // Set the sheet mode for the barcodes preview.
             this.sheet.mode = SheetMode.COLLAPSED_SHEET
@@ -50,7 +51,7 @@ fun multipleScanningUseCaseSnippet() {
         }
 
         // Set an array of accepted barcode types.
-        this.scannerConfiguration.barcodeFormats = BarcodeFormats.common
+        this.scannerConfiguration.barcodeFormatConfigurations = listOf(BarcodeFormatCommonConfiguration(formats = BarcodeFormats.common))
 
         // Configure other parameters as needed.
     }
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/SingleScanningUseCaseSnippet.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/SingleScanningUseCaseSnippet.kt
index df90591..6806410 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/SingleScanningUseCaseSnippet.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/SingleScanningUseCaseSnippet.kt
@@ -12,6 +12,7 @@ package io.scanbot.example.sdk.barcode.doc_code_snippet
 // TODO: add URLs here
 
 // @Tag("Configuring RTU UI v2 Barcode single scan use case snippet")
+import io.scanbot.sdk.barcode.BarcodeFormatCommonConfiguration
 import io.scanbot.sdk.barcode.BarcodeFormats
 import io.scanbot.sdk.ui_v2.barcode.configuration.BarcodeScannerScreenConfiguration
 import io.scanbot.sdk.ui_v2.barcode.configuration.SingleScanningMode
@@ -53,7 +54,7 @@ fun singleScanningUseCaseSnippet() {
         }
 
         // Set an array of accepted barcode types.
-        this.scannerConfiguration.barcodeFormats = BarcodeFormats.common
+        this.scannerConfiguration.barcodeFormatConfigurations = listOf(BarcodeFormatCommonConfiguration(formats = BarcodeFormats.common))
 
         // Configure other parameters as needed.
     }
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/ViewFinderSnippet.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/ViewFinderSnippet.kt
index 7baf4ab..1295910 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/ViewFinderSnippet.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/ViewFinderSnippet.kt
@@ -19,7 +19,7 @@ import android.widget.Toast
 import androidx.activity.result.ActivityResultLauncher
 // @Tag("Add imports for RTU UI v2 activity")
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDKInitializer
-import io.scanbot.sdk.common.AspectRatio
+import io.scanbot.sdk.geometry.AspectRatio
 import io.scanbot.sdk.ui_v2.barcode.BarcodeScannerActivity
 import io.scanbot.sdk.ui_v2.barcode.configuration.BarcodeScannerScreenConfiguration
 import io.scanbot.sdk.ui_v2.common.FinderStyle
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/detailed_setup_guide/LicenseHandlingSnippets.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/detailed_setup_guide/LicenseHandlingSnippets.kt
index 4309eac..ac40efe 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/detailed_setup_guide/LicenseHandlingSnippets.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/detailed_setup_guide/LicenseHandlingSnippets.kt
@@ -4,10 +4,10 @@ import android.app.Application
 import androidx.appcompat.app.AppCompatActivity
 import io.scanbot.example.*
 import io.scanbot.sap.*
-import io.scanbot.sap.Status.*
 import io.scanbot.sdk.*
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDKInitializer
+import io.scanbot.sdk.licensing.LicenseStatus
 import io.scanbot.sdk.util.log.*
 
 /*
@@ -40,22 +40,27 @@ fun handleLicenseStatusSnippet(application: Application) {
     // @Tag("Handle License Status")
     val licenseInfo = ScanbotBarcodeScannerSDKInitializer()
             .license(application, "YOUR_SCANBOT_SDK_LICENSE_KEY")
-            .licenceErrorHandler(IScanbotSDKLicenseErrorHandler { status, feature, message ->
-                LoggerProvider.logger.d("ScanbotSDK", "license status:${status.name}, message: $message")
+            .licenseErrorHandler { status, feature, message ->
+                LoggerProvider.logger.d(
+                    "ScanbotSDK",
+                    "license status:${status.name}, message: $message"
+                )
                 when (status) {
-                    StatusFailureNotSet,
-                    StatusFailureCorrupted,
-                    StatusFailureWrongOS,
-                    StatusFailureAppIDMismatch,
-                    StatusFailureExpired -> {
+                    LicenseStatus.OKAY -> {}
+                    LicenseStatus.TRIAL -> {}
+                    LicenseStatus.OKAY_EXPIRING_SOON -> {}
+                    LicenseStatus.FAILURE_NOT_SET,
+                    LicenseStatus.FAILURE_CORRUPTED,
+                    LicenseStatus.FAILURE_WRONG_OS,
+                    LicenseStatus.FAILURE_APP_ID_MISMATCH,
+                    LicenseStatus.FAILURE_EXPIRED,
+                    LicenseStatus.FAILURE_SERVER,
+                    LicenseStatus.FAILURE_VERSION,
+                    LicenseStatus.FAILURE_INACTIVE -> {
                         // license is completely invalid
                     }
-                    StatusOkay,
-                    StatusTrial -> {
-
-                    }
                 }
-            })
-            .initialize(application)
+            }
+        .initialize(application)
     // @EndTag("Handle License Status")
 }
\ No newline at end of file
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/usecases/LicenseHandlingSnippets.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/usecases/LicenseHandlingSnippets.kt
index 3919f63..cc735a6 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/usecases/LicenseHandlingSnippets.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/usecases/LicenseHandlingSnippets.kt
@@ -3,15 +3,9 @@ package io.scanbot.example.sdk.barcode.doc_code_snippet.usecases
 import android.app.Application
 import android.content.Context
 import io.scanbot.sap.IScanbotSDKLicenseErrorHandler
-import io.scanbot.sap.Status.StatusFailureAppIDMismatch
-import io.scanbot.sap.Status.StatusFailureCorrupted
-import io.scanbot.sap.Status.StatusFailureExpired
-import io.scanbot.sap.Status.StatusFailureNotSet
-import io.scanbot.sap.Status.StatusFailureWrongOS
-import io.scanbot.sap.Status.StatusOkay
-import io.scanbot.sap.Status.StatusTrial
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDKInitializer
+import io.scanbot.sdk.licensing.LicenseStatus
 import io.scanbot.sdk.util.log.LoggerProvider
 
 fun checkingLicenseStatusSnippet(context: Context) {
@@ -19,7 +13,10 @@ fun checkingLicenseStatusSnippet(context: Context) {
     val licenseInfo = ScanbotBarcodeScannerSDK(context).licenseInfo
     LoggerProvider.logger.d("ExampleApplication", "License status: ${licenseInfo.status}")
     LoggerProvider.logger.d("ExampleApplication", "License isValid: ${licenseInfo.isValid}")
-    LoggerProvider.logger.d("ExampleApplication", "License message: ${licenseInfo.licenseStatusMessage}")
+    LoggerProvider.logger.d(
+        "ExampleApplication",
+        "License message: ${licenseInfo.licenseStatusMessage}"
+    )
 
     if (licenseInfo.isValid) {
         // Making your call into ScanbotSDK API is now safe.
@@ -30,21 +27,26 @@ fun checkingLicenseStatusSnippet(context: Context) {
 fun licenseErrorHandlingSnippet(application: Application) {
     val licenseInfo = ScanbotBarcodeScannerSDKInitializer()
         .license(application, "YOUR_SCANBOT_SDK_LICENSE_KEY")
-        .licenceErrorHandler(IScanbotSDKLicenseErrorHandler { status, feature, message ->
-            LoggerProvider.logger.d("ScanbotSDK", "license status:${status.name}, message: $message")
+        .licenseErrorHandler { status, feature, message ->
+            LoggerProvider.logger.d(
+                "ScanbotSDK",
+                "license status:${status.name}, message: $message"
+            )
             when (status) {
-                StatusFailureNotSet,
-                StatusFailureCorrupted,
-                StatusFailureWrongOS,
-                StatusFailureAppIDMismatch,
-                StatusFailureExpired -> {
+                LicenseStatus.OKAY -> {}
+                LicenseStatus.TRIAL -> {}
+                LicenseStatus.OKAY_EXPIRING_SOON -> {}
+                LicenseStatus.FAILURE_NOT_SET,
+                LicenseStatus.FAILURE_CORRUPTED,
+                LicenseStatus.FAILURE_WRONG_OS,
+                LicenseStatus.FAILURE_APP_ID_MISMATCH,
+                LicenseStatus.FAILURE_EXPIRED,
+                LicenseStatus.FAILURE_SERVER,
+                LicenseStatus.FAILURE_VERSION,
+                LicenseStatus.FAILURE_INACTIVE -> {
                     // license is completely invalid
                 }
-                StatusOkay,
-                StatusTrial -> {
-
-                }
             }
-        })
+        }
         .initialize(application)
 }
\ No newline at end of file
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/usecases/ScanAndCountSnippets.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/usecases/ScanAndCountSnippets.kt
index d13cb7f..85d8f54 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/usecases/ScanAndCountSnippets.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/doc_code_snippet/usecases/ScanAndCountSnippets.kt
@@ -11,7 +11,7 @@ fun scanAndCountClassicUiSnippet(barcodeCounterView: BarcodeScanAndCountView, co
     // @Tag("Scan And Count Classic UI")
     barcodeCounterView.initCamera()
     val scanbotSDK = ScanbotBarcodeScannerSDK(context)
-    val barcodeDetector = scanbotSDK.createBarcodeScanner()
+    val barcodeDetector = scanbotSDK.createBarcodeScanner().getOrThrow()
 
     barcodeCounterView.initScanningBehavior(
         barcodeDetector,
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeDocumentParserDemoActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeDocumentParserDemoActivity.kt
index e8a3b6c..0fc0000 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeDocumentParserDemoActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeDocumentParserDemoActivity.kt
@@ -6,7 +6,7 @@ import android.widget.TextView
 import androidx.appcompat.app.AppCompatActivity
 import io.scanbot.example.sdk.barcode.R
 import io.scanbot.example.sdk.barcode.ui.util.applyEdgeToEdge
-import io.scanbot.sdk.barcode.document.BarcodeDocumentParser
+import io.scanbot.sdk.barcode.BarcodeDocumentParser
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 
 class BarcodeDocumentParserDemoActivity : AppCompatActivity() {
@@ -18,12 +18,12 @@ class BarcodeDocumentParserDemoActivity : AppCompatActivity() {
         setContentView(R.layout.activity_barcode_document_parser)
         applyEdgeToEdge(this.findViewById(R.id.root_view))
 
-        barcodeDocumentParser = ScanbotBarcodeScannerSDK(this).createBarcodeDocumentParser()
+        barcodeDocumentParser = ScanbotBarcodeScannerSDK(this).createBarcodeDocumentParser().getOrThrow()
         val inputView = findViewById<TextView>(R.id.barcode_document_input)
         val outputView = findViewById<TextView>(R.id.barcode_document_output)
         findViewById<Button>(R.id.barcode_document_button).setOnClickListener {
             val input = inputView.text.toString()
-            val parseDocument = barcodeDocumentParser.parseDocument(input)
+            val parseDocument = barcodeDocumentParser.parse(input)
             outputView.text = parseDocument.toString()
         }
     }
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeResultActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeResultActivity.kt
index 5d70747..371f78d 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeResultActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeResultActivity.kt
@@ -55,7 +55,7 @@ class BarcodeResultActivity : AppCompatActivity() {
                 itemViewBinding.docText.text = item.barcode.textWithExtension
                 if (item.barcode.sourceImage != null) {
                     itemViewBinding.image.visibility = View.VISIBLE
-                    itemViewBinding.image.setImageBitmap(item.barcode.sourceImage?.toBitmap())
+                    itemViewBinding.image.setImageBitmap(item.barcode.sourceImage?.toBitmap()?.getOrNull())
                 }
                 itemViewBinding.root.setOnClickListener {
                     val intent = Intent(this, DetailedItemDataActivity::class.java)
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeScanAndCountViewActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeScanAndCountViewActivity.kt
index 56345b5..9ddce83 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeScanAndCountViewActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeScanAndCountViewActivity.kt
@@ -49,7 +49,7 @@ class BarcodeScanAndCountViewActivity : AppCompatActivity() {
         nextButton = findViewById(R.id.nextButton)
         snapResult = findViewById(R.id.snapped_message)
 
-        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner()
+        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner().getOrThrow()
         barcodeScanner.setConfiguration(barcodeScanner.copyCurrentConfiguration().apply {
             setBarcodeFormats(BarcodeTypeRepository.selectedTypes.toList())
         })
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeScannerViewActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeScannerViewActivity.kt
index 49c1a12..48a1ed2 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeScannerViewActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BarcodeScannerViewActivity.kt
@@ -15,8 +15,12 @@ import androidx.core.app.ActivityCompat
 import androidx.core.content.ContextCompat
 import androidx.core.view.WindowCompat
 import androidx.core.view.isVisible
+import io.scanbot.common.Result
+import io.scanbot.common.onFailure
+import io.scanbot.common.onSuccess
 import io.scanbot.example.sdk.barcode.R
 import io.scanbot.example.sdk.barcode.model.BarcodeTypeRepository
+import io.scanbot.example.sdk.barcode.ui.usecases.ExampleUtils
 import io.scanbot.example.sdk.barcode.ui.util.applyEdgeToEdge
 import io.scanbot.sdk.barcode.BarcodeItem
 import io.scanbot.sdk.barcode.BarcodeScannerResult
@@ -27,7 +31,7 @@ import io.scanbot.sdk.barcode.ui.BarcodeScannerView
 import io.scanbot.sdk.barcode.ui.IBarcodeScannerViewCallback
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 import io.scanbot.sdk.camera.CaptureInfo
-import io.scanbot.sdk.camera.FrameHandlerResult
+import io.scanbot.sdk.image.ImageRef
 
 class BarcodeScannerViewActivity : AppCompatActivity() {
     private lateinit var barcodeScannerView: BarcodeScannerView
@@ -46,7 +50,7 @@ class BarcodeScannerViewActivity : AppCompatActivity() {
         barcodeScannerView = findViewById(R.id.barcode_scanner_view)
         resultView = findViewById(R.id.result)
 
-        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner()
+        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner().getOrThrow()
         barcodeScanner.setConfiguration(barcodeScanner.copyCurrentConfiguration().apply {
             setBarcodeFormats(BarcodeTypeRepository.selectedTypes.toList())
         })
@@ -54,18 +58,21 @@ class BarcodeScannerViewActivity : AppCompatActivity() {
             initCamera()
             initScanningBehavior(
                 barcodeScanner,
-                { result ->
-                    if (result is FrameHandlerResult.Success) {
-                        handleSuccess(result)
-                    } else {
-                        barcodeScannerView.post {
-                            Toast.makeText(
-                                this@BarcodeScannerViewActivity,
-                                "License has expired!",
-                                Toast.LENGTH_LONG
-                            ).show()
+                { result, frame ->
+                    result.onSuccess { barcode ->
+                        handleSuccess(barcode)
+                    }.onFailure {
+                        when (it) {
+                            is Result.InvalidLicenseError -> {
+                                ExampleUtils.showLicenseExpiredToastAndExit(this@BarcodeScannerViewActivity)
+                            }
+
+                            else -> {
+                                // handle other errors
+                            }
                         }
                     }
+
                     false
                 },
                 object : IBarcodeScannerViewCallback {
@@ -73,7 +80,7 @@ class BarcodeScannerViewActivity : AppCompatActivity() {
                         barcodeScannerView.viewController.useFlash(flashEnabled)
                     }
 
-                    override fun onPictureTaken(image: ByteArray, captureInfo: CaptureInfo) {
+                    override fun onPictureTaken(image: ImageRef, captureInfo: CaptureInfo) {
                         // we don't need full size pictures in this example
                     }
 
@@ -138,14 +145,12 @@ class BarcodeScannerViewActivity : AppCompatActivity() {
         barcodeScannerView.viewController.onPause()
     }
 
-    private fun handleSuccess(result: FrameHandlerResult.Success<BarcodeScannerResult?>) {
-        result.value?.let {
-            // TODO: uncomment if you wish to proceed to the result screen automatically
-            // BarcodeResultRepository.barcodeResultBundle = BarcodeResultBundle(it)
-            // val intent = Intent(this, BarcodeResultActivity::class.java)
-            // startActivity(intent)
-            // finish()
-        }
+    private fun handleSuccess(result: BarcodeScannerResult) {
+        // TODO: uncomment if you wish to proceed to the result screen automatically
+        // BarcodeResultRepository.barcodeResultBundle = BarcodeResultBundle(it)
+        // val intent = Intent(this, BarcodeResultActivity::class.java)
+        // startActivity(intent)
+        // finish()
     }
 
     companion object {
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BatchQRScanActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BatchQRScanActivity.kt
index 363b45f..a4bd1a9 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BatchQRScanActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/BatchQRScanActivity.kt
@@ -15,17 +15,20 @@ import androidx.core.content.ContextCompat
 import androidx.core.view.WindowCompat
 import androidx.recyclerview.widget.LinearLayoutManager
 import androidx.recyclerview.widget.RecyclerView
+import io.scanbot.common.Result
+import io.scanbot.common.onFailure
+import io.scanbot.common.onSuccess
 import io.scanbot.example.sdk.barcode.R
 import io.scanbot.example.sdk.barcode.model.BarcodeTypeRepository
+import io.scanbot.example.sdk.barcode.ui.usecases.ExampleUtils
 import io.scanbot.example.sdk.barcode.ui.util.applyEdgeToEdge
-import io.scanbot.sdk.SdkLicenseError
 import io.scanbot.sdk.barcode.BarcodeItem
 import io.scanbot.sdk.barcode.BarcodeScannerFrameHandler
 import io.scanbot.sdk.barcode.BarcodeScannerResult
 import io.scanbot.sdk.barcode.setBarcodeFormats
 import io.scanbot.sdk.barcode.textWithExtension
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
-import io.scanbot.sdk.camera.FrameHandlerResult
+import io.scanbot.sdk.camera.FrameHandler
 import io.scanbot.sdk.camera.ScanbotCameraView
 import io.scanbot.sdk.ui.camera.ScanbotCameraXView
 
@@ -62,7 +65,7 @@ class BatchQRScanActivity : AppCompatActivity(), BarcodeScannerFrameHandler.Resu
             }, 300)
         }
 
-        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner()
+        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner().getOrThrow()
 
         barcodeScannerFrameHandler = BarcodeScannerFrameHandler.attach(
             cameraView,
@@ -97,24 +100,24 @@ class BatchQRScanActivity : AppCompatActivity(), BarcodeScannerFrameHandler.Resu
         super.onPause()
     }
 
-    private fun handleSuccess(result: FrameHandlerResult.Success<BarcodeScannerResult?>) {
-        result.value?.let {
-            cameraView.post {
-                resultAdapter.addBarcodeItems(it.barcodes)
-            }
+    private fun handleSuccess(result: BarcodeScannerResult) {
+        cameraView.post {
+            resultAdapter.addBarcodeItems(result.barcodes)
         }
     }
 
-    override fun handle(result: FrameHandlerResult<BarcodeScannerResult?, SdkLicenseError>): Boolean {
-        if (result is FrameHandlerResult.Success) {
-            handleSuccess(result)
-        } else {
-            cameraView.post {
-                Toast.makeText(
-                    this,
-                    "License has expired!",
-                    Toast.LENGTH_LONG
-                ).show()
+    override fun handle(result: Result<BarcodeScannerResult>, frame: FrameHandler.Frame): Boolean {
+        result.onSuccess {
+            handleSuccess(it)
+        }.onFailure {
+            when (it) {
+                is Result.InvalidLicenseError -> {
+                    ExampleUtils.showLicenseExpiredToastAndExit(this@BatchQRScanActivity)
+                }
+
+                else -> {
+                    // handle other errors
+                }
             }
         }
         return false
@@ -160,7 +163,7 @@ class ResultAdapter(val layoutInflater: LayoutInflater) :
         } else {
             holder.image.visibility = View.VISIBLE
         }
-        holder.image.setImageBitmap(item.sourceImage?.toBitmap())
+        holder.image.setImageBitmap(item.sourceImage?.toBitmap()?.getOrNull())
     }
 
     override fun getItemCount(): Int = items.size
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/MainActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/MainActivity.kt
index 8a1c0f6..f12746e 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/MainActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/MainActivity.kt
@@ -1,9 +1,11 @@
 package io.scanbot.example.sdk.barcode.ui
 
 import android.app.Activity
+import android.content.ContentResolver
 import android.content.Intent
 import android.graphics.Bitmap
 import android.graphics.BitmapFactory
+import android.net.Uri
 import android.os.Bundle
 import android.provider.MediaStore
 import android.view.LayoutInflater
@@ -22,7 +24,8 @@ import io.scanbot.example.sdk.barcode.ui.dialog.ErrorFragment
 import io.scanbot.example.sdk.barcode.ui.usecases.ExampleUtils
 import io.scanbot.example.sdk.barcode.ui.usecases.UseCasesActivity
 import io.scanbot.example.sdk.barcode.ui.util.applyEdgeToEdge
-import io.scanbot.sap.Status
+import io.scanbot.sdk.barcode.BarcodeFormatCommonConfiguration
+import io.scanbot.sdk.barcode.BarcodeFormatGs1CompositeConfiguration
 import io.scanbot.sdk.barcode.BarcodeFormats
 import io.scanbot.sdk.barcode.BarcodeItem
 import io.scanbot.sdk.barcode.BarcodeScanner
@@ -30,6 +33,8 @@ import io.scanbot.sdk.barcode.Gs1Handling
 import io.scanbot.sdk.barcode.setBarcodeFormats
 import io.scanbot.sdk.barcode.textWithExtension
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
+import io.scanbot.sdk.image.ImageRef
+import io.scanbot.sdk.licensing.LicenseStatus
 import io.scanbot.sdk.ui_v2.barcode.BarcodeScannerActivity
 import io.scanbot.sdk.ui_v2.barcode.common.mappers.BarcodeMappedDataExtension
 import io.scanbot.sdk.ui_v2.barcode.common.mappers.getName
@@ -63,10 +68,10 @@ class MainActivity : AppCompatActivity() {
 
         applyEdgeToEdge(this.findViewById(R.id.root_view))
 
-        barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner()
+        barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner().getOrThrow()
 
         binding.warningView.isVisible =
-            ScanbotBarcodeScannerSDK(this).licenseInfo.status == Status.StatusTrial
+            ScanbotBarcodeScannerSDK(this).licenseInfo.status == LicenseStatus.TRIAL
 
         binding.qrDemo.setOnClickListener {
             val intent = Intent(applicationContext, QRScanCameraViewActivity::class.java)
@@ -91,8 +96,10 @@ class MainActivity : AppCompatActivity() {
         binding.rtuUi.setOnClickListener {
             val barcodeCameraConfiguration = BarcodeScannerScreenConfiguration().apply {
                 this.scannerConfiguration.apply {
-                    this.barcodeFormats = BarcodeTypeRepository.selectedTypes.toList()
-                    this.gs1Handling = Gs1Handling.DECODE_FULL
+                    this.barcodeFormatConfigurations = listOf(
+                        BarcodeFormatCommonConfiguration(formats = BarcodeTypeRepository.selectedTypes.toList()),
+                        BarcodeFormatGs1CompositeConfiguration(gs1Handling = Gs1Handling.DECODE_FULL)
+                    )
                 }
                 this.useCase = SingleScanningMode().apply {
 //                    this.confirmationSheetEnabled = false
@@ -104,9 +111,9 @@ class MainActivity : AppCompatActivity() {
 
         binding.rtuUiSelectionOverlay.setOnClickListener {
             val barcodeCameraConfiguration = BarcodeScannerScreenConfiguration().apply {
-               this.useCase = BarcodeUseCase.singleScanningMode().apply {
-                   this.arOverlay.visible = true
-               }
+                this.useCase = BarcodeUseCase.singleScanningMode().apply {
+                    this.arOverlay.visible = true
+                }
             }
             // tweak other behaviour as needed
             barcodeResultLauncher.launch(barcodeCameraConfiguration)
@@ -115,7 +122,8 @@ class MainActivity : AppCompatActivity() {
         binding.rtuUiBatchMode.setOnClickListener {
             val barcodeCameraConfiguration = BarcodeScannerScreenConfiguration().apply {
                 this.scannerConfiguration.apply {
-                    this.barcodeFormats = BarcodeTypeRepository.selectedTypes.toList()
+                    this.barcodeFormatConfigurations =
+                        listOf(BarcodeFormatCommonConfiguration(formats = BarcodeTypeRepository.selectedTypes.toList()))
                 }
                 this.useCase = MultipleScanningMode().apply {
                     this.mode = MultipleBarcodesScanningMode.COUNTING
@@ -203,7 +211,8 @@ class MainActivity : AppCompatActivity() {
                 }
 
                 // Set an array of accepted barcode types.
-                this.scannerConfiguration.barcodeFormats = BarcodeFormats.common
+                this.scannerConfiguration.barcodeFormatConfigurations =
+                    listOf(BarcodeFormatCommonConfiguration(formats = BarcodeFormats.common))
 
                 this.userGuidance.title.text =
                     "Please align the QR-/Barcode in the frame above to scan it."
@@ -277,17 +286,19 @@ class MainActivity : AppCompatActivity() {
                     showLicenseDialog()
                 } else {
                     processImageGalleryResult(activityResult.data!!)?.let { bitmap ->
-                        barcodeScanner.setConfiguration(barcodeScanner.copyCurrentConfiguration().apply {
-                            setBarcodeFormats(BarcodeTypeRepository.selectedTypes.toList())
-                        })
-                        val result = barcodeScanner.scanFromBitmap(bitmap, 0)
+                        barcodeScanner.setConfiguration(
+                            barcodeScanner.copyCurrentConfiguration().apply {
+                                setBarcodeFormats(BarcodeTypeRepository.selectedTypes.toList())
+                            })
+                        val result = barcodeScanner.run(bitmap).getOrNull()
 
                         BarcodeResultRepository.barcodeResultBundle =
-                            result?.let { v1Result ->
+                            result?.let { scannerResult ->
                                 val result = BarcodeScannerUiResult(
-                                   items = v1Result.barcodes.map { it.toV2(1) }
+                                    items = scannerResult.barcodes.map { it.toV2(1) }
                                 )
-                                BarcodeResultBundle(result, null, null) }
+                                BarcodeResultBundle(result, null, null)
+                            }
 
                         startActivity(Intent(this, BarcodeResultActivity::class.java))
                     }
@@ -311,17 +322,22 @@ class MainActivity : AppCompatActivity() {
                         val images =
                             pdfImagesExtractor.imageUrlsFromPdf(file, outputDir, prefix = "image")
 
-                        barcodeScanner.setConfiguration(barcodeScanner.copyCurrentConfiguration().apply {
-                            setBarcodeFormats(BarcodeTypeRepository.selectedTypes.toList())
-                        })
+                        barcodeScanner.setConfiguration(
+                            barcodeScanner.copyCurrentConfiguration().apply {
+                                setBarcodeFormats(BarcodeTypeRepository.selectedTypes.toList())
+                            })
                         images.map { uri ->
-                            val bitmap = BitmapFactory.decodeFile(uri.path)
-                            val result = barcodeScanner.scanFromBitmap(bitmap, 0)
+                            val image = imageRefFromContent(uri, contentResolver)
+                                ?: return@map emptyList<BarcodeItem>()
+                            val result = barcodeScanner.run(image).getOrNull()
                             // set the last scanned result as the final result
                             result?.barcodes ?: emptyList()
                         }.let {
                             BarcodeResultRepository.barcodeResultBundle =
-                                BarcodeResultBundle(BarcodeScannerUiResult(items = it.flatten().map { it.toV2(1) }), null, null)
+                                BarcodeResultBundle(
+                                    BarcodeScannerUiResult(
+                                        items = it.flatten().map { it.toV2(1) }), null, null
+                                )
                         }
 
                         startActivity(Intent(this, BarcodeResultActivity::class.java))
@@ -337,16 +353,29 @@ class MainActivity : AppCompatActivity() {
         }
     }
 
-    private fun processImageGalleryResult(data: Intent): Bitmap? {
+    private fun processImageGalleryResult(data: Intent): ImageRef? {
         val imageUri = data.data
-        var bitmap: Bitmap? = null
+        var image: ImageRef? = null
         if (imageUri != null) {
             try {
-                bitmap = MediaStore.Images.Media.getBitmap(contentResolver, imageUri)
+                image = imageRefFromContent(imageUri, contentResolver)
+
             } catch (e: IOException) {
+
             }
         }
-        return bitmap
+        return image
+    }
+
+    private fun imageRefFromContent(
+        imageUri: Uri,
+        contentResolver: ContentResolver,
+    ): ImageRef? {
+        var image: ImageRef? = null
+        contentResolver.openInputStream(imageUri)?.use {
+            image = ImageRef.fromInputStream(it)
+        }
+        return image
     }
 
     private fun processPdfGalleryResult(data: Intent): File? {
@@ -366,3 +395,4 @@ class MainActivity : AppCompatActivity() {
         return null
     }
 }
+
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/QRScanCameraViewActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/QRScanCameraViewActivity.kt
index 2c01794..51dc58c 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/QRScanCameraViewActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/QRScanCameraViewActivity.kt
@@ -14,21 +14,25 @@ import androidx.appcompat.app.AppCompatActivity
 import androidx.core.app.ActivityCompat
 import androidx.core.content.ContextCompat
 import androidx.core.view.WindowCompat
+import io.scanbot.common.Result
+import io.scanbot.common.onFailure
+import io.scanbot.common.onSuccess
 import io.scanbot.example.sdk.barcode.R
 import io.scanbot.example.sdk.barcode.model.BarcodeResultBundle
 import io.scanbot.example.sdk.barcode.model.BarcodeResultRepository
 import io.scanbot.example.sdk.barcode.model.BarcodeTypeRepository
+import io.scanbot.example.sdk.barcode.ui.usecases.ExampleUtils
 import io.scanbot.example.sdk.barcode.ui.util.applyEdgeToEdge
-import io.scanbot.sdk.SdkLicenseError
 import io.scanbot.sdk.barcode.BarcodeAutoSnappingController
 import io.scanbot.sdk.barcode.BarcodeScannerFrameHandler
 import io.scanbot.sdk.barcode.BarcodeScannerResult
 import io.scanbot.sdk.barcode.setBarcodeFormats
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 import io.scanbot.sdk.camera.CaptureInfo
-import io.scanbot.sdk.camera.FrameHandlerResult
+import io.scanbot.sdk.camera.FrameHandler
 import io.scanbot.sdk.camera.PictureCallback
 import io.scanbot.sdk.camera.ScanbotCameraView
+import io.scanbot.sdk.image.ImageRef
 import io.scanbot.sdk.ui.camera.ScanbotCameraXView
 import io.scanbot.sdk.ui_v2.barcode.common.mappers.toV2
 import io.scanbot.sdk.ui_v2.barcode.configuration.BarcodeScannerUiResult
@@ -64,7 +68,7 @@ class QRScanCameraViewActivity : AppCompatActivity(), BarcodeScannerFrameHandler
             }, 300)
         }
 
-        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner()
+        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner().getOrThrow()
 
         barcodeScannerFrameHandler = BarcodeScannerFrameHandler.attach(
             cameraView,
@@ -82,7 +86,7 @@ class QRScanCameraViewActivity : AppCompatActivity(), BarcodeScannerFrameHandler
             BarcodeAutoSnappingController.attach(cameraView, barcodeScannerFrameHandler!!)
         barcodeAutoSnappingController.setSensitivity(1f)
         cameraView.addPictureCallback(object : PictureCallback() {
-            override fun onPictureTaken(image: ByteArray, captureInfo: CaptureInfo) {
+            override fun onPictureTaken(image: ImageRef, captureInfo: CaptureInfo) {
                 processPictureTaken(image, captureInfo.imageOrientation)
             }
         })
@@ -90,27 +94,34 @@ class QRScanCameraViewActivity : AppCompatActivity(), BarcodeScannerFrameHandler
 
     override fun onResume() {
         super.onResume()
-        if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) {
+        if (ContextCompat.checkSelfPermission(
+                this,
+                Manifest.permission.CAMERA
+            ) != PackageManager.PERMISSION_GRANTED
+        ) {
             // Use onActivityResult to handle permission rejection
-            ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.CAMERA), REQUEST_PERMISSION_CODE)
+            ActivityCompat.requestPermissions(
+                this,
+                arrayOf(Manifest.permission.CAMERA),
+                REQUEST_PERMISSION_CODE
+            )
         }
     }
 
-    private fun handleSuccess(result: FrameHandlerResult.Success<BarcodeScannerResult?>) {
-        result.value?.let {
-            BarcodeResultRepository.barcodeResultBundle = BarcodeResultBundle(
-                BarcodeScannerUiResult(items = it.barcodes.map { it.toV2(1) }),
-                imagePath = null,
-                previewPath = null,
-            )
-            val intent = Intent(this, BarcodeResultActivity::class.java)
-            startActivity(intent)
-            finish()
-        }
+    private fun handleSuccess(result: BarcodeScannerResult) {
+        BarcodeResultRepository.barcodeResultBundle = BarcodeResultBundle(
+            BarcodeScannerUiResult(items = result.barcodes.map { it.toV2(1) }),
+            imagePath = null,
+            previewPath = null,
+        )
+        val intent = Intent(this, BarcodeResultActivity::class.java)
+        startActivity(intent)
+        finish()
+
     }
 
-    fun processPictureTaken(image: ByteArray, imageOrientation: Int) {
-        val bitmap = BitmapFactory.decodeByteArray(image, 0, image.size)
+    fun processPictureTaken(image: ImageRef, imageOrientation: Int) {
+        val bitmap = image.toBitmap().getOrNull() ?: return
 
         val matrix = Matrix()
         matrix.setRotate(imageOrientation.toFloat(), bitmap.width / 2f, bitmap.height / 2f)
@@ -124,18 +135,24 @@ class QRScanCameraViewActivity : AppCompatActivity(), BarcodeScannerFrameHandler
         }
     }
 
-    override fun handle(result: FrameHandlerResult<BarcodeScannerResult?, SdkLicenseError>): Boolean {
-        if (result is FrameHandlerResult.Success) {
-            handleSuccess(result)
-        } else {
-            cameraView.post {
-                Toast.makeText(
-                    this,
-                    "License has expired!",
-                    Toast.LENGTH_LONG
-                ).show()
+    override fun handle(
+        result: Result<BarcodeScannerResult>,
+        frame: FrameHandler.Frame
+    ): Boolean {
+        result.onSuccess {
+            handleSuccess(it)
+        }.onFailure {
+            when (it) {
+                is Result.InvalidLicenseError -> {
+                    ExampleUtils.showLicenseExpiredToastAndExit(this@QRScanCameraViewActivity)
+                }
+
+                else -> {
+                    // handle other errors
+                }
             }
         }
+
         return false
     }
 
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_FindAndPickActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_FindAndPickActivity.kt
index c75f252..e562baf 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_FindAndPickActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_FindAndPickActivity.kt
@@ -6,6 +6,9 @@ import android.os.Bundle
 import androidx.appcompat.app.AppCompatActivity
 import androidx.core.app.ActivityCompat
 import androidx.core.content.ContextCompat
+import io.scanbot.common.Result
+import io.scanbot.common.onFailure
+import io.scanbot.common.onSuccess
 import io.scanbot.example.sdk.barcode.R
 import io.scanbot.example.sdk.barcode.ui.util.applyEdgeToEdge
 import io.scanbot.sdk.barcode.BarcodeFormat
@@ -16,7 +19,7 @@ import io.scanbot.sdk.barcode.ui.BarcodeScannerView
 import io.scanbot.sdk.barcode.ui.IBarcodeScannerViewCallback
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 import io.scanbot.sdk.camera.CaptureInfo
-import io.scanbot.sdk.camera.FrameHandlerResult
+import io.scanbot.sdk.image.ImageRef
 
 class AR_FindAndPickActivity : AppCompatActivity() {
     private lateinit var barcodeScannerView: BarcodeScannerView
@@ -28,7 +31,7 @@ class AR_FindAndPickActivity : AppCompatActivity() {
 
         barcodeScannerView = findViewById(R.id.barcode_scanner_view)
 
-        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner()
+        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner().getOrThrow()
         barcodeScanner.setConfiguration(
             barcodeScanner.copyCurrentConfiguration().apply {
                 // Specify the barcode format you want to scan
@@ -38,20 +41,28 @@ class AR_FindAndPickActivity : AppCompatActivity() {
 
         barcodeScannerView.apply {
             initCamera()
-            initScanningBehavior(barcodeScanner, { result ->
-                if (result is FrameHandlerResult.Success) {
-// IMPORTANT FOR THIS EXAMPLE:
+            initScanningBehavior(barcodeScanner, { result, frame ->
+                result.onSuccess {
+                    // IMPORTANT FOR THIS EXAMPLE:
                     // We keep this part empty as we process barcodes only when the barcode was tapped on AR overlay layer
 // END OF IMPORTANT FOR THIS EXAMPLE:
-                } else {
-                    ExampleUtils.showLicenseExpiredToastAndExit(this@AR_FindAndPickActivity)
+                }.onFailure {
+                    when (it) {
+                        is Result.InvalidLicenseError -> {
+                            ExampleUtils.showLicenseExpiredToastAndExit(this@AR_FindAndPickActivity)
+                        }
+
+                        else -> {
+                            // handle other errors
+                        }
+                    }
                 }
                 false
             }, object : IBarcodeScannerViewCallback {
                 override fun onCameraOpen() {
                 }
 
-                override fun onPictureTaken(image: ByteArray, captureInfo: CaptureInfo) {
+                override fun onPictureTaken(image: ImageRef, captureInfo: CaptureInfo) {
                     // we don't need full size pictures in this example
                 }
 
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_MultiScanActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_MultiScanActivity.kt
index 7f552f6..580db4f 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_MultiScanActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_MultiScanActivity.kt
@@ -8,6 +8,9 @@ import androidx.core.app.ActivityCompat
 import androidx.core.content.ContextCompat
 import androidx.recyclerview.widget.LinearLayoutManager
 import androidx.recyclerview.widget.RecyclerView
+import io.scanbot.common.Result
+import io.scanbot.common.onFailure
+import io.scanbot.common.onSuccess
 import io.scanbot.example.sdk.barcode.R
 import io.scanbot.example.sdk.barcode.ui.usecases.adapter.BarcodeItemAdapter
 import io.scanbot.example.sdk.barcode.ui.util.applyEdgeToEdge
@@ -19,12 +22,12 @@ import io.scanbot.sdk.barcode.ui.BarcodeScannerView
 import io.scanbot.sdk.barcode.ui.IBarcodeScannerViewCallback
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 import io.scanbot.sdk.camera.CaptureInfo
-import io.scanbot.sdk.camera.FrameHandlerResult
+import io.scanbot.sdk.image.ImageRef
 
 class AR_MultiScanActivity : AppCompatActivity() {
     private lateinit var barcodeScannerView: BarcodeScannerView
 
-// IMPORTANT FOR THIS EXAMPLE:
+    // IMPORTANT FOR THIS EXAMPLE:
     private val resultAdapter by lazy { BarcodeItemAdapter() }
     private lateinit var resultView: RecyclerView
 // END OF IMPORTANT FOR THIS EXAMPLE:
@@ -36,7 +39,7 @@ class AR_MultiScanActivity : AppCompatActivity() {
 
         barcodeScannerView = findViewById(R.id.barcode_scanner_view)
 
-        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner()
+        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner().getOrThrow()
         barcodeScanner.setConfiguration(
             barcodeScanner.copyCurrentConfiguration().apply {
                 // Specify the barcode format you want to scan
@@ -46,10 +49,10 @@ class AR_MultiScanActivity : AppCompatActivity() {
 
         barcodeScannerView.apply {
             initCamera()
-            initScanningBehavior(barcodeScanner, { result ->
-                if (result is FrameHandlerResult.Success) {
-                    handleSuccess(result)
-                } else {
+            initScanningBehavior(barcodeScanner, { result, frame ->
+                result.onSuccess {
+                    handleSuccess(it)
+                }.onFailure {
                     ExampleUtils.showLicenseExpiredToastAndExit(this@AR_MultiScanActivity)
                 }
                 false
@@ -57,7 +60,7 @@ class AR_MultiScanActivity : AppCompatActivity() {
                 override fun onCameraOpen() {
                 }
 
-                override fun onPictureTaken(image: ByteArray, captureInfo: CaptureInfo) {
+                override fun onPictureTaken(image: ImageRef, captureInfo: CaptureInfo) {
                     // we don't need full size pictures in this example
                 }
 
@@ -111,25 +114,31 @@ class AR_MultiScanActivity : AppCompatActivity() {
         resultView.adapter = resultAdapter
     }
 
-    private fun handleSuccess(result: FrameHandlerResult.Success<BarcodeScannerResult?>) {
-        result.value?.let {
-// IMPORTANT FOR THIS EXAMPLE:
-            // We need to add the barcode items to the adapter on the main thread
-            barcodeScannerView.post {
-                resultAdapter.addBarcodeItems(it.barcodes)
-                resultView.scrollToPosition(0)
-            }
-// END OF IMPORTANT FOR THIS EXAMPLE:        }
+    private fun handleSuccess(result: BarcodeScannerResult) {
+        // IMPORTANT FOR THIS EXAMPLE:
+        // We need to add the barcode items to the adapter on the main thread
+        barcodeScannerView.post {
+            resultAdapter.addBarcodeItems(result.barcodes)
+            resultView.scrollToPosition(0)
         }
+        // END OF IMPORTANT FOR THIS EXAMPLE:
     }
 
     override fun onResume() {
         super.onResume()
         barcodeScannerView.viewController.onResume()
 
-        if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) {
+        if (ContextCompat.checkSelfPermission(
+                this,
+                Manifest.permission.CAMERA
+            ) != PackageManager.PERMISSION_GRANTED
+        ) {
             // Use onActivityResult to handle permission rejection
-            ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.CAMERA), REQUEST_PERMISSION_CODE)
+            ActivityCompat.requestPermissions(
+                this,
+                arrayOf(Manifest.permission.CAMERA),
+                REQUEST_PERMISSION_CODE
+            )
         }
     }
 
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_ScanAndCountActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_ScanAndCountActivity.kt
index 7072109..51899ed 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_ScanAndCountActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_ScanAndCountActivity.kt
@@ -27,7 +27,7 @@ class AR_ScanAndCountActivity : AppCompatActivity() {
 
         barcodeScanAndCountView = findViewById(R.id.barcode_scanner_view)
 
-        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner()
+        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner().getOrThrow()
         barcodeScanner.setConfiguration(
             barcodeScanner.copyCurrentConfiguration().apply {
                 // Specify the barcode format you want to scan
@@ -46,14 +46,14 @@ class AR_ScanAndCountActivity : AppCompatActivity() {
                 }
 
                 override fun onScanAndCountFinished(barcodes: List<BarcodeItem>) {
-// IMPORTANT FOR THIS EXAMPLE:
+                    // IMPORTANT FOR THIS EXAMPLE:
                     // Counted barcodes from all scans (Barcode -> Count)
                     val barcodesFromAllScans = barcodeScanAndCountView.countedBarcodes
                     Toast.makeText(context, "Found barcodes now: ${barcodes.size}\n" +
                             "Total different barcodes: ${barcodesFromAllScans.size}", Toast.LENGTH_LONG).show()
                     // You may process the calculated barcodes here
                     // For example, you may show them in a list
-// END OF IMPORTANT FOR THIS EXAMPLE
+                    // END OF IMPORTANT FOR THIS EXAMPLE
                 }
 
                 override fun onScanAndCountStarted() {
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_SelectScanActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_SelectScanActivity.kt
index 8b62d96..c418e85 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_SelectScanActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/AR_SelectScanActivity.kt
@@ -8,6 +8,9 @@ import androidx.core.app.ActivityCompat
 import androidx.core.content.ContextCompat
 import androidx.recyclerview.widget.LinearLayoutManager
 import androidx.recyclerview.widget.RecyclerView
+import io.scanbot.common.Result
+import io.scanbot.common.onFailure
+import io.scanbot.common.onSuccess
 import io.scanbot.example.sdk.barcode.R
 import io.scanbot.example.sdk.barcode.ui.usecases.adapter.BarcodeItemAdapter
 import io.scanbot.example.sdk.barcode.ui.util.applyEdgeToEdge
@@ -19,7 +22,7 @@ import io.scanbot.sdk.barcode.ui.BarcodeScannerView
 import io.scanbot.sdk.barcode.ui.IBarcodeScannerViewCallback
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 import io.scanbot.sdk.camera.CaptureInfo
-import io.scanbot.sdk.camera.FrameHandlerResult
+import io.scanbot.sdk.image.ImageRef
 
 class AR_SelectScanActivity : AppCompatActivity() {
     private lateinit var barcodeScannerView: BarcodeScannerView
@@ -36,7 +39,7 @@ class AR_SelectScanActivity : AppCompatActivity() {
 
         barcodeScannerView = findViewById(R.id.barcode_scanner_view)
 
-        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner()
+        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner().getOrThrow()
         barcodeScanner.setConfiguration(
             barcodeScanner.copyCurrentConfiguration().apply {
                 // Specify the barcode format you want to scan
@@ -47,20 +50,29 @@ class AR_SelectScanActivity : AppCompatActivity() {
         // @Tag("AR-SelectScan")
         barcodeScannerView.apply {
             initCamera()
-            initScanningBehavior(barcodeScanner, { result ->
-                if (result is FrameHandlerResult.Success) {
-// IMPORTANT FOR THIS EXAMPLE:
+            initScanningBehavior(barcodeScanner, { result, frame ->
+                result.onSuccess {
+                    // IMPORTANT FOR THIS EXAMPLE:
                     // We keep this part empty as we process barcodes only when the barcode was tapped on AR overlay layer
-// END OF IMPORTANT FOR THIS EXAMPLE:
-                } else {
-                    ExampleUtils.showLicenseExpiredToastAndExit(this@AR_SelectScanActivity)
+                    // END OF IMPORTANT FOR THIS EXAMPLE:
+                }.onFailure {
+                    when (it) {
+                        is Result.InvalidLicenseError -> {
+                            ExampleUtils.showLicenseExpiredToastAndExit(this@AR_SelectScanActivity)
+                        }
+
+                        else -> {
+                            // handle other errors
+                        }
+                    }
                 }
+
                 false
             }, object : IBarcodeScannerViewCallback {
                 override fun onCameraOpen() {
                 }
 
-                override fun onPictureTaken(image: ByteArray, captureInfo: CaptureInfo) {
+                override fun onPictureTaken(image: ImageRef, captureInfo: CaptureInfo) {
                     // we don't need full size pictures in this example
                 }
 
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/BatchScanningActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/BatchScanningActivity.kt
index b18c692..ac3a992 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/BatchScanningActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/BatchScanningActivity.kt
@@ -8,6 +8,9 @@ import androidx.core.app.ActivityCompat
 import androidx.core.content.ContextCompat
 import androidx.recyclerview.widget.LinearLayoutManager
 import androidx.recyclerview.widget.RecyclerView
+import io.scanbot.common.Result
+import io.scanbot.common.onFailure
+import io.scanbot.common.onSuccess
 import io.scanbot.example.sdk.barcode.R
 import io.scanbot.example.sdk.barcode.ui.usecases.adapter.BarcodeItemAdapter
 import io.scanbot.example.sdk.barcode.ui.util.applyEdgeToEdge
@@ -17,12 +20,12 @@ import io.scanbot.sdk.barcode.ui.BarcodeScannerView
 import io.scanbot.sdk.barcode.ui.IBarcodeScannerViewCallback
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 import io.scanbot.sdk.camera.CaptureInfo
-import io.scanbot.sdk.camera.FrameHandlerResult
+import io.scanbot.sdk.image.ImageRef
 
 class BatchScanningActivity : AppCompatActivity() {
     private lateinit var barcodeScannerView: BarcodeScannerView
 
-// IMPORTANT FOR THIS EXAMPLE:
+    // IMPORTANT FOR THIS EXAMPLE:
     private val resultAdapter by lazy { BarcodeItemAdapter() }
     private lateinit var resultView: RecyclerView
 // END OF IMPORTANT FOR THIS EXAMPLE:
@@ -34,7 +37,7 @@ class BatchScanningActivity : AppCompatActivity() {
 
         barcodeScannerView = findViewById(R.id.barcode_scanner_view)
 
-        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner()
+        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner().getOrThrow()
         barcodeScanner.setConfiguration(
             barcodeScanner.copyCurrentConfiguration().apply {
                 // Specify the barcode format you want to scan
@@ -44,18 +47,27 @@ class BatchScanningActivity : AppCompatActivity() {
 
         barcodeScannerView.apply {
             initCamera()
-            initScanningBehavior(barcodeScanner, { result ->
-                if (result is FrameHandlerResult.Success) {
-                    handleSuccess(result)
-                } else {
-                    ExampleUtils.showLicenseExpiredToastAndExit(this@BatchScanningActivity)
+            initScanningBehavior(barcodeScanner, { result, frame ->
+                result.onSuccess {
+                    handleSuccess(it)
+                }.onFailure {
+                    when (it) {
+                        is Result.InvalidLicenseError -> {
+                            ExampleUtils.showLicenseExpiredToastAndExit(this@BatchScanningActivity)
+                        }
+
+                        else -> {
+                            // handle other errors
+                        }
+                    }
                 }
+
                 false
             }, object : IBarcodeScannerViewCallback {
                 override fun onCameraOpen() {
                 }
 
-                override fun onPictureTaken(image: ByteArray, captureInfo: CaptureInfo) {
+                override fun onPictureTaken(image: ImageRef, captureInfo: CaptureInfo) {
                     // we don't need full size pictures in this example
                 }
 
@@ -76,13 +88,11 @@ class BatchScanningActivity : AppCompatActivity() {
     }
 
     // @Tag("Handle results")
-    private fun handleSuccess(result: FrameHandlerResult.Success<BarcodeScannerResult?>) {
-        result.value?.let {
-            // We need to add the barcode items to the adapter on the main thread
-            barcodeScannerView.post {
-                resultAdapter.addBarcodeItems(it.barcodes)
-                resultView.scrollToPosition(0)
-            }
+    private fun handleSuccess(result: BarcodeScannerResult) {
+        // We need to add the barcode items to the adapter on the main thread
+        barcodeScannerView.post {
+            resultAdapter.addBarcodeItems(result.barcodes)
+            resultView.scrollToPosition(0)
         }
     }
     // @EndTag("Handle results")
@@ -91,9 +101,17 @@ class BatchScanningActivity : AppCompatActivity() {
         super.onResume()
         barcodeScannerView.viewController.onResume()
 
-        if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) {
+        if (ContextCompat.checkSelfPermission(
+                this,
+                Manifest.permission.CAMERA
+            ) != PackageManager.PERMISSION_GRANTED
+        ) {
             // Use onActivityResult to handle permission rejection
-            ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.CAMERA), REQUEST_PERMISSION_CODE)
+            ActivityCompat.requestPermissions(
+                this,
+                arrayOf(Manifest.permission.CAMERA),
+                REQUEST_PERMISSION_CODE
+            )
         }
     }
 
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/DetectionOnTheImageActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/DetectionOnTheImageActivity.kt
index 9424907..b367750 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/DetectionOnTheImageActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/DetectionOnTheImageActivity.kt
@@ -19,6 +19,7 @@ import io.scanbot.example.sdk.barcode.ui.usecases.adapter.BarcodeItemAdapter
 import io.scanbot.example.sdk.barcode.ui.util.applyEdgeToEdge
 import io.scanbot.sdk.barcode.BarcodeScanner
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
+import io.scanbot.sdk.image.ImageRef
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
 
@@ -40,7 +41,7 @@ class DetectionOnTheImageActivity : AppCompatActivity() {
         scanbotBarcodeScannerSDK = ScanbotBarcodeScannerSDK(this)
 
         // Create a barcode scanner instance
-        val barcodeScanner = scanbotBarcodeScannerSDK.createBarcodeScanner()
+        val barcodeScanner = scanbotBarcodeScannerSDK.createBarcodeScanner().getOrThrow()
         barcodeScanner.setConfiguration(
             barcodeScanner.copyCurrentConfiguration().apply {
                 // Specify the barcode format you want to scan
@@ -60,7 +61,7 @@ class DetectionOnTheImageActivity : AppCompatActivity() {
             // Process the selected image on a background thread
             lifecycleScope.launch(Dispatchers.Default) {
                 resultEntity?.let { bitmap ->
-                    processImage(barcodeScanner, bitmap)
+                    processImage(barcodeScanner, ImageRef.fromBitmap(bitmap))
                 }
             }
         }
@@ -74,13 +75,13 @@ class DetectionOnTheImageActivity : AppCompatActivity() {
     // @Tag("Import and process image")
     private fun processImage(
         barcodeScanner: BarcodeScanner,
-        bitmap: Bitmap
+        imageRef: ImageRef
     ) {
         if (!scanbotBarcodeScannerSDK.licenseInfo.isValid) {
             ExampleUtils.showLicenseExpiredToastAndExit(this@DetectionOnTheImageActivity)
             return
         }
-        barcodeScanner.scanFromBitmap(bitmap, 0)?.let {
+        barcodeScanner.run(imageRef).getOrNull()?.let { // Can be handled better with onSuccess/onFailure. See ResultApi examples
             runOnUiThread {
                 resultAdapter.setBarcodeItems(it.barcodes)
             }
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/DistantBarcodeActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/DistantBarcodeActivity.kt
index 9dc3053..36b4c98 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/DistantBarcodeActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/DistantBarcodeActivity.kt
@@ -6,6 +6,8 @@ import android.os.Bundle
 import androidx.appcompat.app.AppCompatActivity
 import androidx.core.app.ActivityCompat
 import androidx.core.content.ContextCompat
+import io.scanbot.common.onFailure
+import io.scanbot.common.onSuccess
 import io.scanbot.example.sdk.barcode.R
 import io.scanbot.example.sdk.barcode.ui.util.applyEdgeToEdge
 import io.scanbot.sdk.barcode.BarcodeItem
@@ -14,7 +16,7 @@ import io.scanbot.sdk.barcode.ui.BarcodeScannerView
 import io.scanbot.sdk.barcode.ui.IBarcodeScannerViewCallback
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 import io.scanbot.sdk.camera.CaptureInfo
-import io.scanbot.sdk.camera.FrameHandlerResult
+import io.scanbot.sdk.image.ImageRef
 
 class DistantBarcodeActivity : AppCompatActivity() {
     private lateinit var barcodeScannerView: BarcodeScannerView
@@ -26,7 +28,7 @@ class DistantBarcodeActivity : AppCompatActivity() {
 
         barcodeScannerView = findViewById(R.id.barcode_scanner_view)
 
-        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner()
+        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner().getOrThrow()
         barcodeScanner.setConfiguration(
             barcodeScanner.copyCurrentConfiguration().apply {
                 // Specify the barcode format you want to scan
@@ -36,11 +38,21 @@ class DistantBarcodeActivity : AppCompatActivity() {
 
         barcodeScannerView.apply {
             initCamera()
-            initScanningBehavior(barcodeScanner, { result ->
-                if (result is FrameHandlerResult.Success) {
-                    handleSuccess(result)
-                } else {
-                    ExampleUtils.showLicenseExpiredToastAndExit(this@DistantBarcodeActivity)
+            initScanningBehavior(barcodeScanner, { result, frame ->
+                result.onSuccess {
+                    handleSuccess(it)
+                }.onFailure {
+                    when (it) {
+                        is io.scanbot.common.Result.InvalidLicenseError -> {
+                            io.scanbot.example.sdk.barcode.ui.usecases.ExampleUtils.showLicenseExpiredToastAndExit(
+                                this@DistantBarcodeActivity
+                            )
+                        }
+
+                        else -> {
+                            // handle other errors
+                        }
+                    }
                 }
                 false
             }, object : IBarcodeScannerViewCallback {
@@ -51,7 +63,7 @@ class DistantBarcodeActivity : AppCompatActivity() {
                     // @EndTag("Scanning distant barcodes")
                 }
 
-                override fun onPictureTaken(image: ByteArray, captureInfo: CaptureInfo) {
+                override fun onPictureTaken(image: ImageRef, captureInfo: CaptureInfo) {
                     // we don't need full size pictures in this example
                 }
 
@@ -62,12 +74,11 @@ class DistantBarcodeActivity : AppCompatActivity() {
         }
     }
 
-    private fun handleSuccess(result: FrameHandlerResult.Success<BarcodeScannerResult?>) {
-        result.value?.let {
+    private fun handleSuccess(result: BarcodeScannerResult) {
             barcodeScannerView.viewController.isFrameProcessingEnabled = false
             runOnUiThread {
                 ExampleUtils.showBarcodeResult(
-                    this@DistantBarcodeActivity, it
+                    this@DistantBarcodeActivity, result
                 ) { barcodeScannerView.viewController.isFrameProcessingEnabled = true }
             }
             // You may also finish the scanning and proceed to the separate result screen
@@ -75,16 +86,23 @@ class DistantBarcodeActivity : AppCompatActivity() {
             // val intent = Intent()
             // intent.putExtra("BARCODES_ARG", barcodeItems.toTypedArray())
             // finish()
-        }
     }
 
     override fun onResume() {
         super.onResume()
         barcodeScannerView.viewController.onResume()
 
-        if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) {
+        if (ContextCompat.checkSelfPermission(
+                this,
+                Manifest.permission.CAMERA
+            ) != PackageManager.PERMISSION_GRANTED
+        ) {
             // Use onActivityResult to handle permission rejection
-            ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.CAMERA), REQUEST_PERMISSION_CODE)
+            ActivityCompat.requestPermissions(
+                this,
+                arrayOf(Manifest.permission.CAMERA),
+                REQUEST_PERMISSION_CODE
+            )
         }
     }
 
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/MultipleBarcodeActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/MultipleBarcodeActivity.kt
index 0a89db4..8345bb7 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/MultipleBarcodeActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/MultipleBarcodeActivity.kt
@@ -8,6 +8,8 @@ import androidx.core.app.ActivityCompat
 import androidx.core.content.ContextCompat
 import androidx.recyclerview.widget.LinearLayoutManager
 import androidx.recyclerview.widget.RecyclerView
+import io.scanbot.common.onFailure
+import io.scanbot.common.onSuccess
 import io.scanbot.example.sdk.barcode.R
 import io.scanbot.example.sdk.barcode.ui.usecases.adapter.BarcodeItemAdapter
 import io.scanbot.example.sdk.barcode.ui.util.applyEdgeToEdge
@@ -17,12 +19,12 @@ import io.scanbot.sdk.barcode.ui.BarcodeScannerView
 import io.scanbot.sdk.barcode.ui.IBarcodeScannerViewCallback
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 import io.scanbot.sdk.camera.CaptureInfo
-import io.scanbot.sdk.camera.FrameHandlerResult
+import io.scanbot.sdk.image.ImageRef
 
 class MultipleBarcodeActivity : AppCompatActivity() {
     private lateinit var barcodeScannerView: BarcodeScannerView
 
-// IMPORTANT FOR THIS EXAMPLE:
+    // IMPORTANT FOR THIS EXAMPLE:
     private val resultAdapter by lazy { BarcodeItemAdapter() }
     private lateinit var resultView: RecyclerView
 // END OF IMPORTANT FOR THIS EXAMPLE:
@@ -34,7 +36,7 @@ class MultipleBarcodeActivity : AppCompatActivity() {
 
         barcodeScannerView = findViewById(R.id.barcode_scanner_view)
 
-        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner()
+        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner().getOrThrow()
         barcodeScanner.setConfiguration(
             barcodeScanner.copyCurrentConfiguration().apply {
                 // Specify the barcode format you want to scan
@@ -44,18 +46,28 @@ class MultipleBarcodeActivity : AppCompatActivity() {
 
         barcodeScannerView.apply {
             initCamera()
-            initScanningBehavior(barcodeScanner, { result ->
-                if (result is FrameHandlerResult.Success) {
-                    handleSuccess(result)
-                } else {
-                    ExampleUtils.showLicenseExpiredToastAndExit(this@MultipleBarcodeActivity)
+            initScanningBehavior(barcodeScanner, { result, frame ->
+                result.onSuccess {
+                    handleSuccess(it)
+                }.onFailure {
+                    when (it) {
+                        is io.scanbot.common.Result.InvalidLicenseError -> {
+                            io.scanbot.example.sdk.barcode.ui.usecases.ExampleUtils.showLicenseExpiredToastAndExit(
+                                this@MultipleBarcodeActivity
+                            )
+                        }
+
+                        else -> {
+                            // handle other errors
+                        }
+                    }
                 }
                 false
             }, object : IBarcodeScannerViewCallback {
                 override fun onCameraOpen() {
                 }
 
-                override fun onPictureTaken(image: ByteArray, captureInfo: CaptureInfo) {
+                override fun onPictureTaken(image: ImageRef, captureInfo: CaptureInfo) {
                     // we don't need full size pictures in this example
                 }
 
@@ -79,13 +91,11 @@ class MultipleBarcodeActivity : AppCompatActivity() {
     }
 
     // @Tag("Handle results")
-    private fun handleSuccess(result: FrameHandlerResult.Success<BarcodeScannerResult?>) {
-        result.value?.let {
-            // We need to add the barcode items to the adapter on the main thread
-            barcodeScannerView.post {
-                resultAdapter.addBarcodeItems(it.barcodes)
-                resultView.scrollToPosition(0)
-            }
+    private fun handleSuccess(result: BarcodeScannerResult) {
+        // We need to add the barcode items to the adapter on the main thread
+        barcodeScannerView.post {
+            resultAdapter.addBarcodeItems(result.barcodes)
+            resultView.scrollToPosition(0)
         }
     }
     // @EndTag("Handle results")
@@ -94,9 +104,17 @@ class MultipleBarcodeActivity : AppCompatActivity() {
         super.onResume()
         barcodeScannerView.viewController.onResume()
 
-        if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) {
+        if (ContextCompat.checkSelfPermission(
+                this,
+                Manifest.permission.CAMERA
+            ) != PackageManager.PERMISSION_GRANTED
+        ) {
             // Use onActivityResult to handle permission rejection
-            ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.CAMERA), REQUEST_PERMISSION_CODE)
+            ActivityCompat.requestPermissions(
+                this,
+                arrayOf(Manifest.permission.CAMERA),
+                REQUEST_PERMISSION_CODE
+            )
         }
     }
 
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/ResultDialogFragment.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/ResultDialogFragment.kt
index 55ca3af..fd78987 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/ResultDialogFragment.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/ResultDialogFragment.kt
@@ -48,7 +48,7 @@ class ResultDialogFragment : BottomSheetDialogFragment() {
 
         arguments?.let { args ->
             args.getParcelable<BarcodeItem>(ARG_BARCODE_ITEM)?.let { barcodeItem ->
-                imageView.setImageBitmap(barcodeItem.sourceImage?.toBitmap())
+                imageView.setImageBitmap(barcodeItem.sourceImage?.toBitmap()?.getOrNull())
                 textView.text = barcodeItem.text
             }
         }
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/SingleBarcodeActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/SingleBarcodeActivity.kt
index a57ec46..5de097a 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/SingleBarcodeActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/SingleBarcodeActivity.kt
@@ -7,6 +7,8 @@ import android.widget.Button
 import androidx.appcompat.app.AppCompatActivity
 import androidx.core.app.ActivityCompat
 import androidx.core.content.ContextCompat
+import io.scanbot.common.onFailure
+import io.scanbot.common.onSuccess
 import io.scanbot.example.sdk.barcode.R
 import io.scanbot.example.sdk.barcode.ui.util.applyEdgeToEdge
 import io.scanbot.sdk.barcode.BarcodeItem
@@ -15,7 +17,7 @@ import io.scanbot.sdk.barcode.ui.BarcodeScannerView
 import io.scanbot.sdk.barcode.ui.IBarcodeScannerViewCallback
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 import io.scanbot.sdk.camera.CaptureInfo
-import io.scanbot.sdk.camera.FrameHandlerResult
+import io.scanbot.sdk.image.ImageRef
 
 class SingleBarcodeActivity : AppCompatActivity() {
 
@@ -29,8 +31,8 @@ class SingleBarcodeActivity : AppCompatActivity() {
 
         barcodeScannerView = findViewById(R.id.barcode_scanner_view)
 
-        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner()
-barcodeScanner.setConfiguration(
+        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner().getOrThrow()
+        barcodeScanner.setConfiguration(
             barcodeScanner.copyCurrentConfiguration().apply {
                 // Specify the barcode format you want to scan
                 // setBarcodeFormats(listOf(BarcodeFormat.QR_CODE))
@@ -40,11 +42,21 @@ barcodeScanner.setConfiguration(
         // @Tag("Scanning single barcode")
         barcodeScannerView.apply {
             initCamera()
-            initScanningBehavior(barcodeScanner, { result ->
-                if (result is FrameHandlerResult.Success) {
-                    handleSuccess(result)
-                } else {
-                    ExampleUtils.showLicenseExpiredToastAndExit(this@SingleBarcodeActivity)
+            initScanningBehavior(barcodeScanner, { result, frame ->
+                result.onSuccess {
+                    handleSuccess(it)
+                }.onFailure {
+                    when (it) {
+                        is io.scanbot.common.Result.InvalidLicenseError -> {
+                            io.scanbot.example.sdk.barcode.ui.usecases.ExampleUtils.showLicenseExpiredToastAndExit(
+                                this@SingleBarcodeActivity
+                            )
+                        }
+
+                        else -> {
+                            // handle other errors
+                        }
+                    }
                 }
                 false
             }, object : IBarcodeScannerViewCallback {
@@ -52,7 +64,7 @@ barcodeScanner.setConfiguration(
                     barcodeScannerView.viewController.useFlash(flashEnabled)
                 }
 
-                override fun onPictureTaken(image: ByteArray, captureInfo: CaptureInfo) {
+                override fun onPictureTaken(image: ImageRef, captureInfo: CaptureInfo) {
                     // we don't need full size pictures in this example
                 }
 
@@ -70,29 +82,35 @@ barcodeScanner.setConfiguration(
         }
     }
 
-    private fun handleSuccess(result: FrameHandlerResult.Success<BarcodeScannerResult?>) {
-        result.value?.let {
-            barcodeScannerView.viewController.isFrameProcessingEnabled = false
-            runOnUiThread {
-                ExampleUtils.showBarcodeResult(
-                    this@SingleBarcodeActivity, it
-                ) { barcodeScannerView.viewController.isFrameProcessingEnabled = true }
-            }
-            // You may also finish the scanning and proceed to the separate result screen
-            // val barcodeItems = it.barcodeItems
-            // val intent = Intent()
-            // intent.putExtra("BARCODES_ARG", barcodeItems.toTypedArray())
-            // finish()
+    private fun handleSuccess(result: BarcodeScannerResult) {
+        barcodeScannerView.viewController.isFrameProcessingEnabled = false
+        runOnUiThread {
+            ExampleUtils.showBarcodeResult(
+                this@SingleBarcodeActivity, result
+            ) { barcodeScannerView.viewController.isFrameProcessingEnabled = true }
         }
+        // You may also finish the scanning and proceed to the separate result screen
+        // val barcodeItems = it.barcodeItems
+        // val intent = Intent()
+        // intent.putExtra("BARCODES_ARG", barcodeItems.toTypedArray())
+        // finish()
     }
 
     override fun onResume() {
         super.onResume()
         barcodeScannerView.viewController.onResume()
 
-        if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) {
+        if (ContextCompat.checkSelfPermission(
+                this,
+                Manifest.permission.CAMERA
+            ) != PackageManager.PERMISSION_GRANTED
+        ) {
             // Use onActivityResult to handle permission rejection
-            ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.CAMERA), REQUEST_PERMISSION_CODE)
+            ActivityCompat.requestPermissions(
+                this,
+                arrayOf(Manifest.permission.CAMERA),
+                REQUEST_PERMISSION_CODE
+            )
         }
     }
 
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/TinyBarcodeActivity.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/TinyBarcodeActivity.kt
index bf3eebb..11e1d40 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/TinyBarcodeActivity.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/TinyBarcodeActivity.kt
@@ -6,6 +6,8 @@ import android.os.Bundle
 import androidx.appcompat.app.AppCompatActivity
 import androidx.core.app.ActivityCompat
 import androidx.core.content.ContextCompat
+import io.scanbot.common.onFailure
+import io.scanbot.common.onSuccess
 import io.scanbot.example.sdk.barcode.R
 import io.scanbot.example.sdk.barcode.ui.util.applyEdgeToEdge
 import io.scanbot.sdk.barcode.BarcodeItem
@@ -14,7 +16,7 @@ import io.scanbot.sdk.barcode.ui.BarcodeScannerView
 import io.scanbot.sdk.barcode.ui.IBarcodeScannerViewCallback
 import io.scanbot.sdk.barcode_scanner.ScanbotBarcodeScannerSDK
 import io.scanbot.sdk.camera.CaptureInfo
-import io.scanbot.sdk.camera.FrameHandlerResult
+import io.scanbot.sdk.image.ImageRef
 
 class TinyBarcodeActivity : AppCompatActivity() {
     private lateinit var barcodeScannerView: BarcodeScannerView
@@ -26,7 +28,7 @@ class TinyBarcodeActivity : AppCompatActivity() {
 
         barcodeScannerView = findViewById(R.id.barcode_scanner_view)
 
-        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner()
+        val barcodeScanner = ScanbotBarcodeScannerSDK(this).createBarcodeScanner().getOrThrow()
         barcodeScanner.setConfiguration(
             barcodeScanner.copyCurrentConfiguration().apply {
                 // Specify the barcode format you want to scan
@@ -36,18 +38,28 @@ class TinyBarcodeActivity : AppCompatActivity() {
 
         barcodeScannerView.apply {
             initCamera()
-            initScanningBehavior(barcodeScanner, { result ->
-                if (result is FrameHandlerResult.Success) {
-                    handleSuccess(result)
-                } else {
-                    ExampleUtils.showLicenseExpiredToastAndExit(this@TinyBarcodeActivity)
+            initScanningBehavior(barcodeScanner, { result, frame ->
+                result.onSuccess {
+                    handleSuccess(it)
+                }.onFailure {
+                    when (it) {
+                        is io.scanbot.common.Result.InvalidLicenseError -> {
+                            io.scanbot.example.sdk.barcode.ui.usecases.ExampleUtils.showLicenseExpiredToastAndExit(
+                                this@TinyBarcodeActivity
+                            )
+                        }
+
+                        else -> {
+                            // handle other errors
+                        }
+                    }
                 }
                 false
             }, object : IBarcodeScannerViewCallback {
                 override fun onCameraOpen() {
                 }
 
-                override fun onPictureTaken(image: ByteArray, captureInfo: CaptureInfo) {
+                override fun onPictureTaken(image: ImageRef, captureInfo: CaptureInfo) {
                     // we don't need full size pictures in this example
                 }
 
@@ -64,29 +76,35 @@ class TinyBarcodeActivity : AppCompatActivity() {
         // @EndTag("Scanning tiny barcodes")
     }
 
-    private fun handleSuccess(result: FrameHandlerResult.Success<BarcodeScannerResult?>) {
-        result.value?.let {
-            barcodeScannerView.viewController.isFrameProcessingEnabled = false
-            runOnUiThread {
-                ExampleUtils.showBarcodeResult(
-                    this@TinyBarcodeActivity, it
-                ) { barcodeScannerView.viewController.isFrameProcessingEnabled = true }
-            }
-            // You may also finish the scanning and proceed to the separate result screen
-            // val barcodeItems = it.barcodeItems
-            // val intent = Intent()
-            // intent.putExtra("BARCODES_ARG", barcodeItems.toTypedArray())
-            // finish()
+    private fun handleSuccess(result: BarcodeScannerResult) {
+        barcodeScannerView.viewController.isFrameProcessingEnabled = false
+        runOnUiThread {
+            ExampleUtils.showBarcodeResult(
+                this@TinyBarcodeActivity, result
+            ) { barcodeScannerView.viewController.isFrameProcessingEnabled = true }
         }
+        // You may also finish the scanning and proceed to the separate result screen
+        // val barcodeItems = it.barcodeItems
+        // val intent = Intent()
+        // intent.putExtra("BARCODES_ARG", barcodeItems.toTypedArray())
+        // finish()
     }
 
     override fun onResume() {
         super.onResume()
         barcodeScannerView.viewController.onResume()
 
-        if (ContextCompat.checkSelfPermission(this, Manifest.permission.CAMERA) != PackageManager.PERMISSION_GRANTED) {
+        if (ContextCompat.checkSelfPermission(
+                this,
+                Manifest.permission.CAMERA
+            ) != PackageManager.PERMISSION_GRANTED
+        ) {
             // Use onActivityResult to handle permission rejection
-            ActivityCompat.requestPermissions(this, arrayOf(Manifest.permission.CAMERA), REQUEST_PERMISSION_CODE)
+            ActivityCompat.requestPermissions(
+                this,
+                arrayOf(Manifest.permission.CAMERA),
+                REQUEST_PERMISSION_CODE
+            )
         }
     }
 
diff --git a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/adapter/BarcodeItemAdapter.kt b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/adapter/BarcodeItemAdapter.kt
index 5c90d72..2f67d67 100644
--- a/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/adapter/BarcodeItemAdapter.kt
+++ b/example_app/src/main/java/io/scanbot/example/sdk/barcode/ui/usecases/adapter/BarcodeItemAdapter.kt
@@ -27,7 +27,7 @@ class BarcodeItemAdapter : RecyclerView.Adapter<BarcodeItemAdapter.BarcodeViewHo
         val item = items.get(position)
         holder.text.text = item.textWithExtension
         holder.barcodeType.text = item.format.name
-        holder.image.setImageBitmap(item.sourceImage?.toBitmap())
+        holder.image.setImageBitmap(item.sourceImage?.toBitmap()?.getOrNull())
     }
 
     fun addBarcodeItems(items: List<BarcodeItem>) {
diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index ed48bc8..d870dcb 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -3,4 +3,4 @@ distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.6-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.13-bin.zip