SDKS-3917 Journey Module Design and Prototype

Author: witrisna

external-idp/build.gradle.kts

@@ -32,6 +32,7 @@ dependencies {
     implementation(project(":foundation:davinci-plugin"))
     implementation(project(":foundation:journey-plugin"))
     implementation(libs.ktor.client.core)
+    implementation(libs.androidx.startup.runtime)
 
     //Make it optional for developer
     compileOnly(libs.googleid)

external-idp/src/main/AndroidManifest.xml

@@ -6,7 +6,8 @@
   ~ of the MIT license. See the LICENSE file for details.
   -->
 
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
 
     <application>
         <provider
@@ -16,10 +17,15 @@
             android:exported="false"/>
 
         <provider
-            android:name=".journey.IdpCallbackRegistry"
-            android:authorities="${applicationId}.Registry"
-            android:enabled="true"
-            android:exported="false"/>
+            android:name="androidx.startup.InitializationProvider"
+            android:authorities="${applicationId}.androidx-startup"
+            android:exported="false"
+            tools:node="merge">
+            <meta-data
+                android:name="com.pingidentity.idp.journey.CallbackInitializer"
+                android:value="androidx.startup" />
+        </provider>
+
 
         <!-- Facebook Login -->
         <activity android:name=".facebook.FacebookActivity"

external-idp/src/main/kotlin/com/pingidentity/idp/journey/CallbackInitializer.kt

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2025 Ping Identity Corporation. All rights reserved.
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+package com.pingidentity.idp.journey
+
+import android.content.Context
+import androidx.startup.Initializer
+import com.pingidentity.journey.plugin.CallbackRegistry
+
+/**
+ * This class is responsible for registering callbacks in the application.
+ * It extends the Initializer interface, which means it is part of the initialization process of the application.
+ */
+class CallbackInitializer : Initializer<CallbackRegistry> {
+
+    override fun create(context: Context): CallbackRegistry {
+        CallbackRegistry.register("IdPCallback", ::IdpCallback)
+        CallbackRegistry.register("SelectIdPCallback", ::SelectIdpCallback)
+        return CallbackRegistry
+    }
+
+    override fun dependencies(): List<Class<out Initializer<*>>> {
+        return emptyList()
+    }
+}

external-idp/src/main/kotlin/com/pingidentity/idp/journey/IdpCallback.kt

@@ -40,7 +40,7 @@ class IdpCallback : AbstractCallback(), JourneyAware, RequestInterceptor {
 
     override lateinit var journey: Journey
 
-    override fun onAttribute(name: String, value: JsonElement) {
+    override fun init(name: String, value: JsonElement) {
         when (name) {
             "provider" -> this.provider = value.jsonPrimitive.content
             "clientId" -> this.clientId = value.jsonPrimitive.content
@@ -53,7 +53,7 @@ class IdpCallback : AbstractCallback(), JourneyAware, RequestInterceptor {
         }
     }
 
-    override fun asJson() = input(result.token, tokenType)
+    override fun payload() = input(result.token, tokenType)
 
     /**
      * Overrides the request with the resume request if initialized, else return the input request.

external-idp/src/main/kotlin/com/pingidentity/idp/journey/IdpCallbackRegistry.kt

@@ -25,7 +25,7 @@ class SelectIdpCallback : AbstractCallback() {
 
     var value: String= ""
 
-    override fun onAttribute(name: String, value: JsonElement) {
+    override fun init(name: String, value: JsonElement) {
         when (name) {
             "providers" -> {
                 providers = value.jsonArray.map {
@@ -35,7 +35,7 @@ class SelectIdpCallback : AbstractCallback() {
         }
     }
 
-    override fun asJson(): JsonObject {
+    override fun payload(): JsonObject {
         return input(value)
     }
 

external-idp/src/main/kotlin/com/pingidentity/idp/journey/SelectIdpCallback.kt

@@ -15,4 +15,8 @@ plugins {
 
 android {
     namespace = "com.pingidentity.android"
+}
+
+dependencies {
+    implementation(libs.androidx.startup.runtime)
 }

foundation/android/build.gradle.kts

@@ -6,17 +6,22 @@
   ~ of the MIT license. See the LICENSE file for details.
   -->
 
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
 
     <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
     <uses-permission android:name="android.permission.INTERNET" />
 
     <application>
         <provider
-            android:name=".InitializeProvider"
-            android:authorities="${applicationId}.initializeProvider"
-            android:enabled="true"
-            android:exported="false"/>
+            android:name="androidx.startup.InitializationProvider"
+            android:authorities="${applicationId}.androidx-startup"
+            android:exported="false"
+            tools:node="merge">
+            <meta-data
+                android:name="com.pingidentity.android.ContextInitializer"
+                android:value="androidx.startup" />
+        </provider>
     </application>
 
 </manifest>

foundation/android/src/main/AndroidManifest.xml

@@ -0,0 +1,27 @@
+/*
+ * Copyright (c) 2025 Ping Identity Corporation. All rights reserved.
+ *
+ * This software may be modified and distributed under the terms
+ * of the MIT license. See the LICENSE file for details.
+ */
+
+package com.pingidentity.android
+
+import android.content.Context
+import androidx.startup.Initializer
+
+/**
+ * This class is responsible for initializing the ContextProvider in the application.
+ * It extends the Initializer interface, which means it is part of the initialization process of the application.
+ */
+class ContextInitializer : Initializer<ContextProvider> {
+
+    override fun create(context: Context): ContextProvider {
+        ContextProvider.init(context)
+        return ContextProvider
+    }
+
+    override fun dependencies(): List<Class<out Initializer<*>>> {
+        return emptyList()
+    }
+}