TASK-1816943: Added support for startingFields for WKWebView based en…

core/build.gradle.kts

@@ -1,5 +1,6 @@
 plugins {
     alias(libs.plugins.kotlinMultiplatform)
+    alias(libs.plugins.kotlinSerialization)
     alias(libs.plugins.androidKotlinMultiplatformLibrary)
     alias(libs.plugins.composeMultiplatform)
     alias(libs.plugins.composeCompiler)

core/src/commonMain/kotlin/com/pega/constellation/sdk/kmp/core/ConstellationSdk.kt

@@ -24,6 +24,13 @@ interface ConstellationSdk {
      */
     fun createCase(caseClassName: String, startingFields: Map<String, Any> = emptyMap())
 
+    /**
+     * Opens an assignment with the given ID.
+     *
+     * @param assignmentId id of the assignment to be opened
+     */
+    fun openAssignment(assignmentId: String)
+
     companion object {
         /**
          * Allows to create [ConstellationSdk] object.

core/src/commonMain/kotlin/com/pega/constellation/sdk/kmp/core/ConstellationSdkAction.kt

@@ -0,0 +1,25 @@
+package com.pega.constellation.sdk.kmp.core
+
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+import kotlinx.serialization.json.JsonObject
+
+/**
+ * Represents various actions that can be performed using the Constellation SDK.
+ */
+@Serializable
+sealed class ConstellationSdkAction {
+
+    @Serializable
+    @SerialName("CreateCase")
+    data class CreateCase(
+        val caseClassName: String,
+        val startingFields: JsonObject? = null
+    ) : ConstellationSdkAction()
+
+    @Serializable
+    @SerialName("OpenAssignment")
+    data class OpenAssignment(
+        val assignmentId: String
+    ) : ConstellationSdkAction()
+}

core/src/commonMain/kotlin/com/pega/constellation/sdk/kmp/core/ConstellationSdkEngine.kt

@@ -1,5 +1,17 @@
 package com.pega.constellation.sdk.kmp.core
 
+import kotlinx.serialization.Serializable
+import kotlinx.serialization.json.Json
+
+@Serializable
+data class EngineConfiguration(
+    val url: String,
+    val version: String,
+    val action: ConstellationSdkAction,
+    val debuggable: Boolean
+) {
+    fun toJsonString(): String = Json.encodeToString(this)
+}
 
 /**
  * Constellation SDK Engine that orchestrates Pega application logic.
@@ -12,9 +24,9 @@ interface ConstellationSdkEngine {
     fun configure(config: ConstellationSdkConfig, handler: EngineEventHandler)
 
     /**
-     * Creates a case of the specified class name with the provided starting fields.
+     * Performs the specified action using the Constellation SDK.
      */
-    fun createCase(caseClassName: String, startingFields: Map<String, Any>)
+    fun performAction(action: ConstellationSdkAction)
 }
 
 /**

core/src/commonMain/kotlin/com/pega/constellation/sdk/kmp/core/internal/ConstellationSdkImpl.kt

@@ -1,5 +1,6 @@
 package com.pega.constellation.sdk.kmp.core.internal
 
+import com.pega.constellation.sdk.kmp.core.ConstellationSdkAction
 import com.pega.constellation.sdk.kmp.core.ConstellationSdk
 import com.pega.constellation.sdk.kmp.core.ConstellationSdk.State
 import com.pega.constellation.sdk.kmp.core.ConstellationSdkConfig
@@ -8,6 +9,7 @@ import com.pega.constellation.sdk.kmp.core.EngineEvent
 import com.pega.constellation.sdk.kmp.core.components.containers.RootContainerComponent
 import kotlinx.coroutines.flow.MutableStateFlow
 import kotlinx.coroutines.flow.asStateFlow
+import kotlinx.serialization.json.JsonObject
 
 internal class ConstellationSdkImpl(
     config: ConstellationSdkConfig,
@@ -23,7 +25,14 @@ internal class ConstellationSdkImpl(
     }
 
     override fun createCase(caseClassName: String, startingFields: Map<String, Any>) {
-        engine.createCase(caseClassName, startingFields)
+        engine.performAction(ConstellationSdkAction.CreateCase(
+            caseClassName,
+            startingFields.toJsonElement() as? JsonObject)
+        )
+    }
+
+    override fun openAssignment(assignmentId: String) {
+        engine.performAction(ConstellationSdkAction.OpenAssignment(assignmentId))
     }
 
     private fun onEngineEvent(event: EngineEvent) {

core/src/commonMain/kotlin/com/pega/constellation/sdk/kmp/core/internal/JsonHelper.kt

@@ -0,0 +1,45 @@
+package com.pega.constellation.sdk.kmp.core.internal
+
+import com.pega.constellation.sdk.kmp.core.Log
+import kotlinx.serialization.json.JsonArray
+import kotlinx.serialization.json.JsonElement
+import kotlinx.serialization.json.JsonObject
+import kotlinx.serialization.json.JsonPrimitive
+
+private const val TAG = "JsonHelper"
+
+fun Any.toJsonElement(): JsonElement? = when (this) {
+    is String -> JsonPrimitive(this)
+    is Int -> JsonPrimitive(this)
+    is Double -> JsonPrimitive(this)
+    is Float -> JsonPrimitive(this)
+    is Boolean -> JsonPrimitive(this)
+    is List<*> -> {
+        val jsonElements = this.mapNotNull {
+            it?.toJsonElement() ?: run {
+                val type = it?.let { it::class } ?: "null"
+                Log.w(TAG, "Unsupported type $type, cannot convert to JsonElement.")
+                null
+            }
+        }
+        JsonArray(jsonElements)
+    }
+    is Map<*, *> -> {
+        val map = this.entries.mapNotNull { (key, value) ->
+            (key as? String)?.let { k ->
+                value?.toJsonElement()?.let { v -> k to v }
+            } ?: run {
+                val keyType = key?.let { it::class } ?: "null"
+                val valueType = value?.let { it::class } ?: "null"
+                Log.w(TAG, "Unsupported key type <$keyType> or value type <$valueType>, cannot convert to JsonElement.")
+                null
+            }
+        }.toMap()
+        JsonObject(map)
+    }
+    else -> {
+        Log.w(TAG, "Unsupported type ${this::class}, cannot convert to JsonElement.")
+        null
+    }
+
+}

engine-mock/src/commonMain/kotlin/com/pega/constellation/sdk/kmp/engine/mock/MockSdkEngine.kt

@@ -1,5 +1,6 @@
 package com.pega.constellation.sdk.kmp.engine.mock
 
+import com.pega.constellation.sdk.kmp.core.ConstellationSdkAction
 import com.pega.constellation.sdk.kmp.core.ConstellationSdkConfig
 import com.pega.constellation.sdk.kmp.core.ConstellationSdkEngine
 import com.pega.constellation.sdk.kmp.core.EngineEvent
@@ -32,7 +33,7 @@ class MockSdkEngine : ConstellationSdkEngine {
         this.handler = handler
     }
 
-    override fun createCase(caseClassName: String, startingFields: Map<String, Any>) {
+    override fun performAction(action: ConstellationSdkAction) {
         handler.handle(EngineEvent.Loading)
         config.componentManager.configureComponents()
         handler.handle(EngineEvent.Ready)

engine-webview/src/androidMain/kotlin/com/pega/constellation/sdk/kmp/engine/webview/android/AndroidWebViewEngine.kt

@@ -6,8 +6,10 @@ import android.util.Log
 import android.webkit.WebView
 import android.webkit.WebView.setWebContentsDebuggingEnabled
 import android.webkit.WebViewClient
+import com.pega.constellation.sdk.kmp.core.ConstellationSdkAction
 import com.pega.constellation.sdk.kmp.core.ConstellationSdkConfig
 import com.pega.constellation.sdk.kmp.core.ConstellationSdkEngine
+import com.pega.constellation.sdk.kmp.core.EngineConfiguration
 import com.pega.constellation.sdk.kmp.core.EngineError
 import com.pega.constellation.sdk.kmp.core.EngineEvent
 import com.pega.constellation.sdk.kmp.core.EngineEventHandler
@@ -67,20 +69,21 @@ class AndroidWebViewEngine(
         this.webView = createWebView(webViewClient)
     }
 
-    override fun createCase(caseClassName: String, startingFields: Map<String, Any>) {
+    override fun performAction(action: ConstellationSdkAction) {
         handler.handle(EngineEvent.Loading)
-        webViewClient.onPageLoad = { onPageLoad(caseClassName, startingFields) }
+        webViewClient.onPageLoad = { onPageLoad(action) }
         webView.loadUrl(config.pegaUrl)
     }
 
-    private fun onPageLoad(caseClassName: String, startingFields: Map<String, Any>) {
+    private fun onPageLoad(action: ConstellationSdkAction) {
+        val configuration = EngineConfiguration(
+            url = config.pegaUrl,
+            version = config.pegaVersion,
+            action = action,
+            debuggable = config.debuggable
+        )
         evaluateInit(
-            sdkConfig = JSONObject().apply {
-                put("url", config.pegaUrl)
-                put("version", config.pegaVersion)
-                put("caseClassName", caseClassName)
-                put("startingFields", JSONObject(startingFields))
-            }.toString(),
+            sdkConfig = configuration.toJsonString(),
             scripts = componentManager.getCustomComponentDefinitions()
                 .filter { it.script != null }
                 .associate { it.type.type to it.script!!.assetPath(context) }

engine-webview/src/iosMain/kotlin/com/pega/constellation/sdk/kmp/engine/webview/ios/WKWebViewBasedEngine.kt

@@ -2,8 +2,10 @@ package com.pega.constellation.sdk.kmp.engine.webview.ios
 
 import PegaMobileWKWebViewTweaks.allowForHTTPSchemeHandlerRegistration
 import PegaMobileWKWebViewTweaks.applyTweaks
+import com.pega.constellation.sdk.kmp.core.ConstellationSdkAction
 import com.pega.constellation.sdk.kmp.core.ConstellationSdkConfig
 import com.pega.constellation.sdk.kmp.core.ConstellationSdkEngine
+import com.pega.constellation.sdk.kmp.core.EngineConfiguration
 import com.pega.constellation.sdk.kmp.core.EngineEvent
 import com.pega.constellation.sdk.kmp.core.EngineEventHandler
 import com.pega.constellation.sdk.kmp.core.Log
@@ -18,7 +20,6 @@ import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.SupervisorJob
 import kotlinx.coroutines.cancel
 import kotlinx.coroutines.launch
-import kotlinx.serialization.Serializable
 import kotlinx.serialization.builtins.MapSerializer
 import kotlinx.serialization.builtins.serializer
 import kotlinx.serialization.json.Json
@@ -41,20 +42,6 @@ data class ComponentEvent(
     val eventContent: String
 )
 
-@Serializable
-data class EngineConfiguration(
-    val url: String,
-    val version: String,
-    val caseClassName: String? = null,
-    val debuggable: Boolean
-) {
-
-    fun toJsonString(): String =
-        Json.encodeToString(this)
-            .replace("\n", " ")
-
-}
-
 @OptIn(ExperimentalForeignApi::class)
 class WKWebViewBasedEngine(
     val provider: ResourceProvider
@@ -98,10 +85,7 @@ class WKWebViewBasedEngine(
         this.resourceHandler.delegate = resourceProviderManager
     }
 
-    override fun createCase(
-        caseClassName: String,
-        startingFields: Map<String, Any>
-    ) {
+    override fun performAction(action: ConstellationSdkAction) {
         mainScope?.cancel()
         mainScope = CoroutineScope(Dispatchers.Main + SupervisorJob())
 
@@ -110,7 +94,7 @@ class WKWebViewBasedEngine(
         val engineConfig = EngineConfiguration(
             url = config.pegaUrl,
             version = config.pegaVersion,
-            caseClassName = caseClassName,
+            action = action,
             debuggable = config.debuggable
         )
 

samples/swiftui-components-app/UITest/Unit Tests/SDKWrapperTests.swift

@@ -37,6 +37,9 @@ final class SDKWrapperTests: XCTestCase {
 }
 
 private class MockedSDK: ConstellationSdk {
+    func openAssignment(assignmentId: String) {
+        XCTFail("not implemented")
+    }
 
     func createCase(caseClassName: String, startingFields: [String : Any]) {
         XCTFail("not implemented")

scripts/init/init.js

@@ -2,6 +2,7 @@ import { initPlatforms } from './init-platforms.js';
 import { initialRender } from './initial-render.js';
 import { bootstrap } from './bootstrap.js'
 import { createCase } from './create-case.js';
+import { openAssignment } from './open-assignment.js';
 import { getSdkComponentMap } from '../dxcomponents/mappings/sdk-component-map.js';
 import { bridge } from '../bridge/native-bridge.js';
 import { subscribeForEvents } from './init-events.js';
@@ -17,11 +18,20 @@ async function init(sdkConfig, componentsOverridesStr) {
     initPlatforms(componentsOverridesStr);
     const config = JSON.parse(sdkConfig);
     await bootstrap(config.url, config.version, onPCoreReady);
-    await createCase(config.caseClassName, config.startingFields);
+
+    if (config.action.type === "CreateCase") {
+      await createCase(config.action.caseClassName, config.action.startingFields);
+    } else if (config.action.type === "OpenAssignment") {
+      await openAssignment(config.action.assignmentId);
+    } else {
+      const errorMessage = "Unknown action type: " + config.action.type;
+      throw new Error(errorMessage);
+    }
+
     console.log(TAG, "Constellation SDK initialization completed");
     bridge.onReady();
   } catch (error) {
-    const errorMessage = "Constellation SDK initialization failed! " + (error?.message ?? "")
+    const errorMessage = "Constellation SDK initialization failed! " + (error?.message ?? "");
     console.error(errorMessage);
     bridge.onError("InitError", errorMessage);
   }

scripts/init/open-assignment.js

@@ -0,0 +1,9 @@
+export async function openAssignment(assignmentId) {
+
+  const options = {
+    pageName: 'pyEmbedAssignment'
+  };
+
+  console.log("[OpenAssignment]", "Opening assignment: " + assignmentId);
+  await PCore.getMashupApi().openAssignment(assignmentId, PCore.getConstants().APP.APP, options);
+}