Added fallbacks logic for No-Codes with previous major.

config/detekt/baseline.xml

@@ -6,6 +6,7 @@
     <ID>ComplexMethod:ScreenPresenter.kt$ScreenPresenter$override fun onWebViewMessageReceived(message: String)</ID>
     <ID>ComplexMethod:ScreenPresenter.kt$ScreenPresenter$override fun shouldOverrideUrlLoading(url: String?): Boolean</ID>
     <ID>ComplexMethod:ScreenPresenter.kt$ScreenPresenter$private fun mapProductInfo(product: QProduct): Map&lt;String, Any?&gt;</ID>
+    <ID>ComplexMethod:ScreenServiceImpl.kt$ScreenServiceImpl$private suspend fun executeWithFallback( requestProvider: () -&gt; Request, fallbackProvider: suspend () -&gt; NoCodeScreen?, errorContext: String, methodName: String ): NoCodeScreen</ID>
     <ID>ComplexMethod:errors.kt$internal fun BillingError.toQonversionError(): QonversionError</ID>
     <ID>ConstructorParameterNaming:Environment.kt$Environment$@Json(name = "app_version") val app_version: String</ID>
     <ID>EmptyCatchBlock:AdvertisingProvider.kt$AdvertisingProvider.AdvertisingConnection${ }</ID>
@@ -208,6 +209,7 @@
     <ID>NestedBlockDepth:ActionMapper.kt$ActionMapper$override fun fromMap(data: Map&lt;*, *&gt;): QAction</ID>
     <ID>NestedBlockDepth:ApiErrorMapper.kt$ApiErrorMapper$fun &lt;T&gt; getErrorFromResponse(value: Response&lt;T&gt;): QonversionError</ID>
     <ID>NestedBlockDepth:ScreenPresenter.kt$ScreenPresenter$private fun mapProductInfo(product: QProduct): Map&lt;String, Any?&gt;</ID>
+    <ID>NestedBlockDepth:ScreenServiceImpl.kt$ScreenServiceImpl$private suspend fun executeWithFallback( requestProvider: () -&gt; Request, fallbackProvider: suspend () -&gt; NoCodeScreen?, errorContext: String, methodName: String ): NoCodeScreen</ID>
     <ID>NewLineAtEndOfFile:ApiHelperTest.kt$com.qonversion.android.sdk.internal.api.ApiHelperTest.kt</ID>
     <ID>NewLineAtEndOfFile:AppRequestTest.kt$com.qonversion.android.sdk.internal.requests.AppRequestTest.kt</ID>
     <ID>NewLineAtEndOfFile:AutomationsEventMapperTest.kt$com.qonversion.android.sdk.automations.internal.AutomationsEventMapperTest.kt</ID>
@@ -264,6 +266,7 @@
     <ID>NoWildcardImports:io.qonversion.sample.HomeFragment.kt:33</ID>
     <ID>ReturnCount:AutomationsEventMapper.kt$AutomationsEventMapper$fun getEventFromRemoteMessage(messageData: Map&lt;String, String&gt;): AutomationsEvent?</ID>
     <ID>ReturnCount:BillingClientWrapper.kt$BillingClientWrapper$override fun makePurchase( activity: Activity, product: QProduct, offerId: String?, applyOffer: Boolean?, updatePurchaseInfo: UpdatePurchaseInfo?, onFailed: (error: BillingError) -&gt; Unit )</ID>
+    <ID>ReturnCount:ErrorUtils.kt$ErrorUtils$ fun isServerError(error: Exception): Boolean</ID>
     <ID>ReturnCount:ExceptionHandler.kt$ExceptionHandler$private fun isQonversionException(exception: Throwable): Boolean</ID>
     <ID>ReturnCount:QExceptionManager.kt$QExceptionManager$private fun getContentOfCrashReport(filename: String): CrashRequest.ExceptionInfo?</ID>
     <ID>ReturnCount:QProductCenterManager.kt$QProductCenterManager$@Synchronized private fun executeProductsBlocks(loadStoreProductsError: QonversionError? = null)</ID>
@@ -287,6 +290,7 @@
     <ID>SwallowedException:EnvironmentProvider.kt$EnvironmentProvider$catch (throwable: Throwable) { UNKNOWN }</ID>
     <ID>SwallowedException:ExceptionHandler.kt$ExceptionHandler$catch (e: Exception) { "" }</ID>
     <ID>SwallowedException:FacebookAttribution.kt$FacebookAttribution$catch (e: Exception) { null }</ID>
+    <ID>SwallowedException:FallbackUtils.kt$FallbackUtils$catch (e: Exception) { false }</ID>
     <ID>SwallowedException:PurchasesCache.kt$PurchasesCache$catch (e: IOException) { setOf() }</ID>
     <ID>SwallowedException:QAutomationsManager.kt$QAutomationsManager$catch (e: JSONException) { null }</ID>
     <ID>SwallowedException:ScreenFragment.kt$ScreenFragment$catch (e: ActivityNotFoundException) { logger.error("Couldn't find any Activity to handle the Intent with deeplink $url") automationsManager.automationsDidFailExecuting(actionResult) }</ID>
@@ -298,11 +302,14 @@
     <ID>SwallowedException:ScreenPresenter.kt$ScreenPresenter$catch (e: Exception) { logger.error("ScreenPresenter -&gt; failed to open the screen with id $screenId") }</ID>
     <ID>SwallowedException:SharedPreferencesCache.kt$SharedPreferencesCache$catch (e: IOException) { null }</ID>
     <ID>ThrowingExceptionsWithoutMessageOrCause:AdvertisingProvider.kt$AdvertisingProvider.AdvertisingConnection$IllegalStateException()</ID>
+    <ID>ThrowsCount:ScreenServiceImpl.kt$ScreenServiceImpl$private suspend fun executeWithFallback( requestProvider: () -&gt; Request, fallbackProvider: suspend () -&gt; NoCodeScreen?, errorContext: String, methodName: String ): NoCodeScreen</ID>
     <ID>TooGenericExceptionCaught:AdvertisingProvider.kt$AdvertisingProvider$e: Exception</ID>
     <ID>TooGenericExceptionCaught:EnvironmentProvider.kt$EnvironmentProvider$throwable: Throwable</ID>
     <ID>TooGenericExceptionCaught:ExceptionHandler.kt$ExceptionHandler$cause: Exception</ID>
     <ID>TooGenericExceptionCaught:ExceptionHandler.kt$ExceptionHandler$e: Exception</ID>
     <ID>TooGenericExceptionCaught:FacebookAttribution.kt$FacebookAttribution$e: Exception</ID>
+    <ID>TooGenericExceptionCaught:FallbackServiceImpl.kt$FallbackServiceImpl$e: Exception</ID>
+    <ID>TooGenericExceptionCaught:FallbackUtils.kt$FallbackUtils$e: Exception</ID>
     <ID>TooGenericExceptionCaught:JsonSerializer.kt$JsonSerializer$cause: NullPointerException</ID>
     <ID>TooGenericExceptionCaught:NetworkClientImpl.kt$NetworkClientImpl$cause: Exception</ID>
     <ID>TooGenericExceptionCaught:QAutomationsManager.kt$QAutomationsManager$e: Exception</ID>
@@ -311,6 +318,8 @@
     <ID>TooGenericExceptionCaught:ScreenControllerImpl.kt$ScreenControllerImpl$e: Exception</ID>
     <ID>TooGenericExceptionCaught:ScreenFragment.kt$ScreenFragment$e: Exception</ID>
     <ID>TooGenericExceptionCaught:ScreenPresenter.kt$ScreenPresenter$e: Exception</ID>
+    <ID>TooGenericExceptionCaught:ScreenServiceImpl.kt$ScreenServiceImpl$e: Exception</ID>
+    <ID>TooGenericExceptionCaught:ScreenServiceImpl.kt$ScreenServiceImpl$fallbackError: Exception</ID>
     <ID>TooManyFunctions:Api.kt$Api</ID>
     <ID>TooManyFunctions:AppComponent.kt$AppComponent</ID>
     <ID>TooManyFunctions:BillingClientWrapper.kt$BillingClientWrapper : BillingClientWrapperBaseIBillingClientWrapper</ID>

nocodes/build.gradle

@@ -37,6 +37,13 @@ android {
         viewBinding true
         buildConfig true
     }
+    sourceSets {
+        main {
+            assets {
+                srcDirs 'src/main/assets', 'src/main/assets/fallbacks'
+            }
+        }
+    }
 }
 
 ext {

nocodes/src/main/java/io/qonversion/nocodes/NoCodesConfig.kt

@@ -48,6 +48,7 @@ class NoCodesConfig internal constructor(
         private var proxyUrl: String? = null
         private var logLevel = LogLevel.Info
         private var logTag = DEFAULT_LOG_TAG
+        private var customFallbackFileName: String? = null
 
         /**
          * Provide a delegate to be notified about the no-code screens events.
@@ -112,6 +113,18 @@ class NoCodesConfig internal constructor(
             this.logTag = logTag
         }
 
+        /**
+         * Set a custom fallback file name for offline scenarios.
+         * This file should be placed in the assets folder and will be used when network is unavailable.
+         * If not set, the default file name "nocodes_fallbacks.json" will be used.
+         *
+         * @param fileName the custom fallback file name.
+         * @return builder instance for chain calls.
+         */
+        fun setCustomFallbackFileName(fileName: String): Builder = apply {
+            this.customFallbackFileName = fileName
+        }
+
         /**
          * Generate [NoCodesConfig] instance with all the provided configurations.
          * This method also validates some of the provided data.
@@ -124,7 +137,7 @@ class NoCodesConfig internal constructor(
                 throw IllegalStateException("Project key is empty")
             }
 
-            val primaryConfig = PrimaryConfig(projectKey)
+            val primaryConfig = PrimaryConfig(projectKey, customFallbackFileName = customFallbackFileName)
             val networkConfig = NetworkConfig(proxyUrl)
             val loggerConfig = LoggerConfig(logLevel, logTag)
 

nocodes/src/main/java/io/qonversion/nocodes/internal/common/FallbackConstants.kt

@@ -0,0 +1,5 @@
+package io.qonversion.nocodes.internal.common
+
+object FallbackConstants {
+    const val DEFAULT_FILE_NAME = "nocodes_fallbacks.json"
+}

nocodes/src/main/java/io/qonversion/nocodes/internal/common/TimeoutConstants.kt

@@ -0,0 +1,6 @@
+package io.qonversion.nocodes.internal.common
+
+object TimeoutConstants {
+    const val FALLBACK_AVAILABLE_TIMEOUT = 5_000L
+    const val DEFAULT_TIMEOUT = 20_000L
+}

nocodes/src/main/java/io/qonversion/nocodes/internal/di/DependenciesAssembly.kt

@@ -43,14 +43,20 @@ internal class DependenciesAssembly(
             val mappersAssembly = MappersAssemblyImpl()
             val storageAssembly = StorageAssemblyImpl(application)
             val networkAssembly =
-                NetworkAssemblyImpl(internalConfig, mappersAssembly, storageAssembly, miscAssembly)
-            val servicesAssembly = ServicesAssemblyImpl(mappersAssembly, networkAssembly, miscAssembly)
+                NetworkAssemblyImpl(application, internalConfig, mappersAssembly, storageAssembly, miscAssembly)
+            val servicesAssembly = ServicesAssemblyImpl(
+                application,
+                mappersAssembly,
+                networkAssembly,
+                miscAssembly,
+                internalConfig.primaryConfig.effectiveFallbackFileName
+            )
             val controllersAssembly = ControllersAssemblyImpl(
+                application,
                 servicesAssembly,
                 miscAssembly,
                 mappersAssembly,
-                internalConfig,
-                application
+                internalConfig
             )
 
             instance = DependenciesAssembly(

nocodes/src/main/java/io/qonversion/nocodes/internal/di/controllers/ControllersAssemblyImpl.kt

@@ -11,11 +11,11 @@ import io.qonversion.nocodes.internal.screen.view.ScreenContract
 import io.qonversion.nocodes.internal.screen.view.ScreenPresenter
 
 internal class ControllersAssemblyImpl(
+    private val appContext: Context,
     private val servicesAssembly: ServicesAssembly,
     private val miscAssembly: MiscAssembly,
     private val mappersAssembly: MappersAssembly,
-    private val internalConfig: InternalConfig,
-    private val appContext: Context
+    private val internalConfig: InternalConfig
 ) : ControllersAssembly {
 
     override fun screenController(): ScreenController {

nocodes/src/main/java/io/qonversion/nocodes/internal/di/network/NetworkAssemblyImpl.kt

@@ -1,5 +1,6 @@
 package io.qonversion.nocodes.internal.di.network
 
+import android.content.Context
 import io.qonversion.nocodes.internal.common.API_URL
 import io.qonversion.nocodes.internal.di.mappers.MappersAssembly
 import io.qonversion.nocodes.internal.di.misc.MiscAssembly
@@ -14,15 +15,20 @@ import io.qonversion.nocodes.internal.networkLayer.networkClient.NetworkClient
 import io.qonversion.nocodes.internal.networkLayer.networkClient.NetworkClientImpl
 import io.qonversion.nocodes.internal.networkLayer.requestConfigurator.RequestConfigurator
 import io.qonversion.nocodes.internal.networkLayer.requestConfigurator.RequestConfiguratorImpl
+import io.qonversion.nocodes.internal.utils.FallbackUtils
 
 internal class NetworkAssemblyImpl(
+    private val context: Context,
     private val internalConfig: InternalConfig,
     private val mappersAssembly: MappersAssembly,
     private val storageAssembly: StorageAssembly,
     private val miscAssembly: MiscAssembly
 ) : NetworkAssembly {
 
-    override fun networkClient(): NetworkClient = NetworkClientImpl(miscAssembly.jsonSerializer())
+    override fun networkClient(): NetworkClient = NetworkClientImpl(
+        miscAssembly.jsonSerializer(),
+        isFallbackAvailable = isFallbackActuallyAvailable()
+    )
 
     override fun requestConfigurator(): RequestConfigurator = RequestConfiguratorImpl(
         headerBuilder(),
@@ -50,4 +56,11 @@ internal class NetworkAssemblyImpl(
             retryPolicy
         )
     }
+
+    private fun isFallbackActuallyAvailable(): Boolean {
+        return FallbackUtils.isFallbackFileAvailable(
+            internalConfig.primaryConfig.effectiveFallbackFileName,
+            context
+        )
+    }
 }

nocodes/src/main/java/io/qonversion/nocodes/internal/di/services/ServicesAssembly.kt

@@ -1,8 +1,11 @@
 package io.qonversion.nocodes.internal.di.services
 
+import io.qonversion.nocodes.internal.screen.service.FallbackService
 import io.qonversion.nocodes.internal.screen.service.ScreenService
 
 internal interface ServicesAssembly {
 
     fun screenService(): ScreenService
+
+    fun fallbackService(): FallbackService?
 }

nocodes/src/main/java/io/qonversion/nocodes/internal/di/services/ServicesAssemblyImpl.kt

@@ -1,22 +1,43 @@
 package io.qonversion.nocodes.internal.di.services
 
+import android.content.Context
 import io.qonversion.nocodes.internal.di.mappers.MappersAssembly
 import io.qonversion.nocodes.internal.di.misc.MiscAssembly
 import io.qonversion.nocodes.internal.di.network.NetworkAssembly
+import io.qonversion.nocodes.internal.screen.service.FallbackService
+import io.qonversion.nocodes.internal.screen.service.FallbackServiceImpl
 import io.qonversion.nocodes.internal.screen.service.ScreenService
 import io.qonversion.nocodes.internal.screen.service.ScreenServiceImpl
+import io.qonversion.nocodes.internal.utils.FallbackUtils
 
 internal class ServicesAssemblyImpl(
+    private val context: Context,
     private val mappersAssembly: MappersAssembly,
     private val networkAssembly: NetworkAssembly,
-    private val miscAssembly: MiscAssembly
+    private val miscAssembly: MiscAssembly,
+    private val effectiveFallbackFileName: String
 ) : ServicesAssembly {
 
     override fun screenService(): ScreenService {
         return ScreenServiceImpl(
             networkAssembly.requestConfigurator(),
             networkAssembly.exponentialApiInteractor(),
             mappersAssembly.screenMapper(),
+            fallbackService(),
+            miscAssembly.logger()
+        )
+    }
+
+    override fun fallbackService(): FallbackService? {
+        // Check if fallback file is available
+        if (!FallbackUtils.isFallbackFileAvailable(effectiveFallbackFileName, context)) {
+            return null
+        }
+
+        return FallbackServiceImpl(
+            context,
+            effectiveFallbackFileName,
+            mappersAssembly.screenMapper(),
             miscAssembly.logger()
         )
     }

nocodes/src/main/java/io/qonversion/nocodes/internal/dto/config/PrimaryConfig.kt

@@ -1,8 +1,13 @@
 package io.qonversion.nocodes.internal.dto.config
 
 import io.qonversion.nocodes.BuildConfig
+import io.qonversion.nocodes.internal.common.FallbackConstants
 
 internal data class PrimaryConfig(
     val projectKey: String,
-    val sdkVersion: String = BuildConfig.VERSION_NAME
-)
+    val sdkVersion: String = BuildConfig.VERSION_NAME,
+    val customFallbackFileName: String? = null
+) {
+    val effectiveFallbackFileName: String
+        get() = customFallbackFileName ?: FallbackConstants.DEFAULT_FILE_NAME
+}

nocodes/src/main/java/io/qonversion/nocodes/internal/networkLayer/networkClient/NetworkClientImpl.kt

@@ -3,6 +3,7 @@ package io.qonversion.nocodes.internal.networkLayer.networkClient
 import io.qonversion.nocodes.error.ErrorCode
 import io.qonversion.nocodes.error.NoCodesException
 import io.qonversion.nocodes.internal.common.serializers.Serializer
+import io.qonversion.nocodes.internal.common.TimeoutConstants
 import io.qonversion.nocodes.internal.networkLayer.dto.RawResponse
 import io.qonversion.nocodes.internal.networkLayer.dto.Request
 import io.qonversion.nocodes.internal.networkLayer.utils.isInternalServerErrorHttpCode
@@ -23,7 +24,8 @@ import java.net.URL
 private const val NETWORK_ENCODING = "utf-8"
 
 internal class NetworkClientImpl(
-    private val serializer: Serializer
+    private val serializer: Serializer,
+    private val isFallbackAvailable: Boolean = false
 ) : NetworkClient {
     override suspend fun execute(request: Request): RawResponse {
         return withContext(Dispatchers.IO) {
@@ -56,7 +58,19 @@ internal class NetworkClientImpl(
 
     internal fun connect(url: URL): HttpURLConnection {
         return try {
-            url.openConnection() as HttpURLConnection
+            val connection = url.openConnection() as HttpURLConnection
+
+            // Set smart timeout based on fallback availability
+            val timeout = if (isFallbackAvailable) {
+                TimeoutConstants.FALLBACK_AVAILABLE_TIMEOUT
+            } else {
+                TimeoutConstants.DEFAULT_TIMEOUT
+            }
+
+            connection.connectTimeout = timeout.toInt()
+            connection.readTimeout = timeout.toInt()
+
+            connection
         } catch (cause: Exception) {
             throw if (cause is IOException || cause is ClassCastException || cause is NullPointerException) {
                 NoCodesException(

nocodes/src/main/java/io/qonversion/nocodes/internal/screen/service/FallbackService.kt

@@ -0,0 +1,8 @@
+package io.qonversion.nocodes.internal.screen.service
+
+import io.qonversion.nocodes.internal.dto.NoCodeScreen
+
+internal interface FallbackService {
+    suspend fun loadScreen(contextKey: String): NoCodeScreen?
+    suspend fun loadScreenById(screenId: String): NoCodeScreen?
+}