@digia-engage/core 2.0.3 → 2.2.0

package/android/bin/src/main/java/com/digia/engage/rn/DigiaModule.kt

@@ -0,0 +1,309 @@
+/**
+ * DigiaModule
+ *
+ * React Native NativeModule that bridges the Digia Engage Android SDK.
+ *
+ * Exposed methods (callable from JS via NativeModules.DigiaEngageModule):
+ *
+ * initialize(apiKey, environment, logLevel, baseUrl): Promise<void> register(): void
+ * setCurrentScreen(name): void triggerCampaign(id, content, cepContext): void
+ * triggerCampaignById(campaignId): void invalidateCampaign(campaignId): void
+ *
+ * Architecture ──────────── The RN bridge mirrors the native Digia.initialize / Digia.register /
+ * Digia.setCurrentScreen flow exactly. An internal [RNEventBridgePlugin] is the single native
+ * DigiaCEPPlugin registered via Digia.register().
+ *
+ * When the SDK calls plugin.setup(delegate), the bridge stores that delegate reference. JS plugins
+ * that need to push campaigns into the Compose overlay call triggerCampaign / invalidateCampaign
+ * which forward to delegate.onCampaignTriggered / delegate.onCampaignInvalidated.
+ *
+ * Overlay lifecycle events (impressed / clicked / dismissed) are forwarded from the native
+ * plugin.notifyEvent() to JS via DeviceEventEmitter so that pure-JS CEP plugins (e.g.
+ * DigiaMoEngagePlugin) can report analytics.
+ */
+package com.digia.engage.rn
+
+import androidx.lifecycle.LifecycleOwner
+import androidx.lifecycle.ViewModelStoreOwner
+import androidx.lifecycle.setViewTreeLifecycleOwner
+import androidx.lifecycle.setViewTreeViewModelStoreOwner
+import androidx.savedstate.SavedStateRegistryOwner
+import androidx.savedstate.setViewTreeSavedStateRegistryOwner
+import com.digia.engage.DiagnosticReport
+import com.digia.engage.Digia
+import com.digia.engage.DigiaCEPDelegate
+import com.digia.engage.DigiaCEPPlugin
+import com.digia.engage.DigiaConfig
+import com.digia.engage.DigiaEnvironment
+import com.digia.engage.DigiaExperienceEvent
+import com.digia.engage.DigiaHostView
+import com.digia.engage.DigiaLogLevel
+import com.digia.engage.InAppPayload
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReactContextBaseJavaModule
+import com.facebook.react.bridge.ReactMethod
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.bridge.UiThreadUtil
+import com.facebook.react.modules.core.DeviceEventManagerModule
+
+internal class DigiaModule(
+        private val reactContext: ReactApplicationContext,
+) : ReactContextBaseJavaModule(reactContext) {
+
+    private val rnPlugin = RNEventBridgePlugin(reactContext)
+
+    override fun getName(): String = MODULE_NAME
+
+    // ─── initialize ───────────────────────────────────────────────────────────
+
+    @ReactMethod
+    fun initialize(
+            apiKey: String,
+            environment: String,
+            logLevel: String,
+            baseUrl: String?,
+            fontFamily: String?,
+            promise: Promise
+    ) {
+        try {
+            val cleanBaseUrl =
+                    baseUrl.trim().trimEnd('/').removeSuffix("/api/v1").takeIf { it.isNotBlank() }
+            val config =
+                    DigiaConfig(
+                            apiKey = apiKey,
+                            baseUrl = cleanBaseUrl,
+                            environment =
+                                    when (environment.lowercase()) {
+                                        "sandbox" -> DigiaEnvironment.SANDBOX
+                                        else -> DigiaEnvironment.PRODUCTION
+                                    },
+                            logLevel =
+                                    when (logLevel.lowercase()) {
+                                        "verbose" -> DigiaLogLevel.VERBOSE
+                                        "none" -> DigiaLogLevel.NONE
+                                        else -> DigiaLogLevel.ERROR
+                                    },
+                            baseUrl = baseUrl?.takeIf { it.isNotBlank() },
+                            fontFamily = fontFamily?.takeIf { it.isNotBlank() },
+                    )
+            Digia.initialize(reactContext.applicationContext, config)
+
+            UiThreadUtil.runOnUiThread {
+                // Mount the Compose overlay ABOVE the ReactRootView via addContentView().
+                // This keeps it outside Fabric's shadow tree entirely so Fabric hit-testing
+                // never sees it. Touch pass-through is handled by DigiaHostView.dispatchTouchEvent
+                // returning false at the native Android level — which works correctly at this
+                // level of the hierarchy, unlike inside Fabric where pointerEvents="none" on
+                // non-ReactViewGroup views is not respected during shadow-tree hit-testing.
+                mountDigiaHost()
+                promise.resolve(null)
+            }
+        } catch (e: Exception) {
+            promise.reject("DIGIA_INIT_ERROR", e.message ?: "Initialisation failed", e)
+        }
+    }
+
+    // ─── register ─────────────────────────────────────────────────────────────
+
+    /**
+     * Registers [RNEventBridgePlugin] with the native Digia SDK.
+     *
+     * This is bridge infrastructure — not a user-facing CEP plugin. Called once by the JS
+     * `Digia.register()` wrapper on the first plugin registration so that
+     * [RNEventBridgePlugin.delegate] is populated before any triggerCampaign / invalidateCampaign
+     * calls arrive from JS.
+     */
+    @ReactMethod
+    fun registerBridge() {
+        Digia.register(rnPlugin)
+    }
+
+    // ─── setCurrentScreen ─────────────────────────────────────────────────────
+
+    @ReactMethod
+    fun setCurrentScreen(name: String) {
+        Digia.setCurrentScreen(name)
+    }
+
+    // ─── triggerCampaign ──────────────────────────────────────────────────────
+
+    /**
+     * Forwards a campaign payload to the native DigiaCEPDelegate.
+     *
+     * This is called by the JS DigiaDelegate.onCampaignTriggered() implementation when a JS CEP
+     * plugin (e.g. DigiaMoEngagePlugin) delivers a campaign. The delegate routes it into the
+     * Compose overlay for rendering.
+     */
+    @ReactMethod
+    fun triggerCampaign(id: String, content: ReadableMap, cepContext: ReadableMap) {
+        val delegate = rnPlugin.delegate ?: return
+        delegate.onCampaignTriggered(
+                InAppPayload(
+                        id = id,
+                        content = content.toHashMap().toMap(),
+                        cepContext = cepContext.toHashMap().toMap(),
+                )
+        )
+    }
+
+    /** Triggers a fetched Digia campaign directly by campaign id/key. */
+    @ReactMethod
+    fun triggerCampaignById(campaignId: String) {
+        Digia.triggerCampaign(campaignId)
+    }
+
+    // ─── invalidateCampaign ───────────────────────────────────────────────────
+
+    /** Forwards a campaign invalidation to the native DigiaCEPDelegate. */
+    @ReactMethod
+    fun invalidateCampaign(campaignId: String) {
+        rnPlugin.delegate?.onCampaignInvalidated(campaignId)
+    }
+
+    // ─── Anchor registration ──────────────────────────────────────────────────
+
+    @ReactMethod
+    fun registerAnchor(key: String, x: Int, y: Int, width: Int, height: Int) {
+        Digia.registerAnchor(key, x, y, width, height)
+    }
+
+    @ReactMethod
+    fun unregisterAnchor(key: String) {
+        Digia.unregisterAnchor(key)
+    }
+
+    @ReactMethod
+    fun getRegisteredComponents(promise: Promise) {
+        promise.resolve(Arguments.createArray())
+    }
+
+    // ─── Internal: mount the Compose overlay host ─────────────────────────────
+
+    private fun mountDigiaHost() {
+        val activity =
+                reactContext.currentActivity
+                        ?: run {
+                            android.util.Log.w(
+                                    "DigiaHost",
+                                    "[mountDigiaHost] no current activity — skipping"
+                            )
+                            return
+                        }
+
+        val contentRoot = activity.window.decorView.findViewWithTag<DigiaHostView>(DIGIA_HOST_TAG)
+        if (contentRoot != null) {
+            android.util.Log.d(
+                    "DigiaHost",
+                    "[mountDigiaHost] already mounted (tag found) — skipping"
+            )
+            return
+        }
+
+        android.util.Log.d("DigiaHost", "[mountDigiaHost] mounting native overlay on DecorView")
+
+        // Mount on the DecorView (not content area) so the overlay covers the full screen
+        // including status bar and navigation bar. This also ensures the Compose Popup's
+        // canvas y=0 aligns with the absolute screen y=0, matching getLocationOnScreen()
+        // coordinates used by DigiaAnchorView.
+        val decorView =
+                activity.window.decorView as? android.view.ViewGroup
+                        ?: run {
+                            android.util.Log.w(
+                                    "DigiaHost",
+                                    "[mountDigiaHost] decorView not a ViewGroup — skipping"
+                            )
+                            return
+                        }
+
+        val composeView =
+                DigiaHostView(activity).apply {
+                    tag = DIGIA_HOST_TAG
+                    if (activity is LifecycleOwner) setViewTreeLifecycleOwner(activity)
+                    if (activity is ViewModelStoreOwner) setViewTreeViewModelStoreOwner(activity)
+                    if (activity is SavedStateRegistryOwner)
+                            setViewTreeSavedStateRegistryOwner(activity)
+                }
+
+        decorView.addView(
+                composeView,
+                android.view.ViewGroup.LayoutParams(
+                        android.view.ViewGroup.LayoutParams.MATCH_PARENT,
+                        android.view.ViewGroup.LayoutParams.MATCH_PARENT,
+                ),
+        )
+        android.util.Log.d(
+                "DigiaHost",
+                "[mountDigiaHost] done — DecorView child count: ${decorView.childCount}"
+        )
+    }
+
+    companion object {
+        const val MODULE_NAME = "DigiaEngageModule"
+        private const val DIGIA_HOST_TAG = "digia_host_compose_view"
+    }
+}
+
+/**
+ * RNEventBridgePlugin
+ *
+ * The single native DigiaCEPPlugin used in React Native.
+ *
+ * When Digia.register(rnPlugin) is called, the SDK calls setup(delegate) which gives us the
+ * DigiaCEPDelegate reference. This delegate is used by triggerCampaign / invalidateCampaign bridge
+ * methods to push campaigns into the native rendering engine.
+ *
+ * Overlay lifecycle events (impressed / clicked / dismissed) received via notifyEvent() are emitted
+ * to JS as DeviceEventEmitter events so that JS CEP plugins can report analytics back to their
+ * platform.
+ */
+internal class RNEventBridgePlugin(
+        private val reactContext: ReactApplicationContext,
+) : DigiaCEPPlugin {
+
+    override val identifier: String = "rn-event-bridge"
+
+    /** Delegate received from the SDK via setup(). Used by DigiaModule bridge methods. */
+    var delegate: DigiaCEPDelegate? = null
+        private set
+
+    private fun emit(event: String, params: com.facebook.react.bridge.WritableMap) {
+        if (reactContext.hasActiveReactInstance()) {
+            reactContext
+                    .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+                    .emit(event, params)
+        }
+    }
+
+    override fun setup(delegate: DigiaCEPDelegate) {
+        this.delegate = delegate
+    }
+
+    override fun forwardScreen(name: String) {
+        /* forwarded by Digia.setCurrentScreen() on the native side */
+    }
+
+    override fun notifyEvent(event: DigiaExperienceEvent, payload: InAppPayload) {
+        val params =
+                Arguments.createMap().apply {
+                    putString("campaignId", payload.id)
+                    when (event) {
+                        is DigiaExperienceEvent.Impressed -> putString("type", "impressed")
+                        is DigiaExperienceEvent.Clicked -> {
+                            putString("type", "clicked")
+                            event.elementId?.let { putString("elementId", it) }
+                        }
+                        is DigiaExperienceEvent.Dismissed -> putString("type", "dismissed")
+                    }
+                }
+        emit("digiaEngageEvent", params)
+    }
+
+    override fun teardown() {
+        delegate = null
+    }
+
+    override fun healthCheck(): DiagnosticReport =
+            DiagnosticReport(isHealthy = true, metadata = mapOf("identifier" to identifier))
+}

package/android/bin/src/main/java/com/digia/engage/rn/DigiaPackage.kt

@@ -0,0 +1,70 @@
+/**
+ * DigiaPackage
+ *
+ * Registers the Digia Engage native module and view managers with React Native.
+ *
+ * Extends TurboReactPackage so the package works transparently on both Old Architecture (bridge)
+ * and New Architecture (TurboModules / JSI).
+ *
+ * Why is this needed? ──────────────────── React Native's auto-linker reads react-native.config.js,
+ * which declares `packageInstance: 'new DigiaPackage()'`. At host-app compile time, RN injects this
+ * into the generated `PackageList`, making our native module and view managers available to JS
+ * without any manual MainApplication edits.
+ *
+ * JS: NativeModules.DigiaEngageModule ──► DigiaModule.kt JS:
+ * requireNativeComponent('DigiaHostView') ──► DigiaViewManager.kt JS:
+ * requireNativeComponent('DigiaSlotView') ──► DigiaSlotViewManager.kt
+ */
+package com.digia.engage.rn
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import com.facebook.react.uimanager.ViewManager
+
+class DigiaPackage : BaseReactPackage() {
+
+    // ─── Native Modules ───────────────────────────────────────────────────────
+
+    /**
+     * Called by New Architecture (TurboModules) to instantiate the module by name. Old Architecture
+     * continues to use createNativeModules() which TurboReactPackage implements internally by
+     * delegating to this method via getReactModuleInfoProvider.
+     */
+    override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? =
+            when (name) {
+                DigiaModule.MODULE_NAME -> DigiaModule(reactContext)
+                else -> null
+            }
+
+    /**
+     * Metadata table: tells the RN runtime which modules this package provides and whether they
+     * should be treated as TurboModules (New Architecture).
+     */
+    override fun getReactModuleInfoProvider(): ReactModuleInfoProvider = ReactModuleInfoProvider {
+        mapOf(
+                DigiaModule.MODULE_NAME to
+                        ReactModuleInfo(
+                                /* name */ DigiaModule.MODULE_NAME,
+                                /* className */ DigiaModule.MODULE_NAME,
+                                /* canOverrideExistingModule */ false,
+                                /* needsEagerInit */ false,
+                                /* isCxxModule */ false,
+                                /* isTurboModule */ false,
+                        ),
+        )
+    }
+
+    // ─── View Managers ────────────────────────────────────────────────────────
+
+    override fun createViewManagers(
+            reactContext: ReactApplicationContext,
+    ): List<ViewManager<*, *>> =
+            listOf(
+                    DigiaViewManager(),
+                    DigiaSlotViewManager(),
+                    DigiaAnchorViewManager(),
+            )
+}

package/android/bin/src/main/java/com/digia/engage/rn/DigiaSlotViewManager.kt

@@ -0,0 +1,183 @@
+package com.digia.engage.rn
+
+import android.content.Context
+import android.view.View
+import android.view.ViewTreeObserver
+import android.widget.FrameLayout
+import androidx.lifecycle.LifecycleOwner
+import androidx.lifecycle.ViewModelStoreOwner
+import androidx.lifecycle.setViewTreeLifecycleOwner
+import androidx.lifecycle.setViewTreeViewModelStoreOwner
+import androidx.savedstate.SavedStateRegistryOwner
+import androidx.savedstate.setViewTreeSavedStateRegistryOwner
+import com.digia.engage.DigiaSlotView
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableMap
+import com.facebook.react.uimanager.SimpleViewManager
+import com.facebook.react.uimanager.ThemedReactContext
+import com.facebook.react.uimanager.UIManagerHelper
+import com.facebook.react.uimanager.annotations.ReactProp
+import com.facebook.react.uimanager.events.Event
+import java.util.concurrent.atomic.AtomicInteger
+
+// ── ContentSizeChangeEvent ────────────────────────────────────────────────────
+
+private class ContentSizeChangeEvent(
+    surfaceId: Int,
+    viewTag: Int,
+    private val heightDp: Double,
+    private val widthDp: Double,
+) : Event<ContentSizeChangeEvent>(surfaceId, viewTag) {
+    override fun getEventName(): String = "onContentSizeChange"
+    override fun getEventData(): WritableMap =
+        Arguments.createMap().apply {
+            putDouble("height", heightDp)
+            putDouble("width", widthDp)
+        }
+}
+
+// ── DigiaSlotContainerView ────────────────────────────────────────────────────
+
+// Plain FrameLayout wrapper: Fabric can measure it before window attachment.
+// The inner DigiaSlotView (ComposeView) is created lazily in onAttachedToWindow.
+internal class DigiaSlotContainerView(context: Context) : FrameLayout(context) {
+
+    var rnContext: ThemedReactContext? = null
+
+    private var _slotView: DigiaSlotView? = null
+    private val lastReportedHeightPx = AtomicInteger(-1)
+
+    var placementKey: String = ""
+        set(value) {
+            field = value
+            val slot = _slotView ?: return
+            slot.placementKey = value
+            lastReportedHeightPx.set(-1)
+            // Defer measure so the slot has a non-zero width. Do NOT call requestLayout() here —
+            // it sets PFLAG_FORCE_LAYOUT on the container and RN bypasses a full traversal,
+            // causing subsequent Compose requestLayout() calls to be swallowed.
+            post { measureAndDispatch() }
+            postDelayed({
+                lastReportedHeightPx.set(-1)
+                measureAndDispatch()
+            }, DELAYED_MEASURE_MS)
+        }
+
+    private val globalLayoutListener = ViewTreeObserver.OnGlobalLayoutListener {
+        measureAndDispatch()
+    }
+
+    // preDrawListener catches Compose content changes that globalLayoutListener misses in RN's
+    // layout model: Compose's invalidate() propagates to ViewRootImpl even when requestLayout()
+    // is blocked by PFLAG_FORCE_LAYOUT.
+    private val preDrawListener = ViewTreeObserver.OnPreDrawListener {
+        measureAndDispatch()
+        true
+    }
+
+    override fun onAttachedToWindow() {
+        super.onAttachedToWindow()
+        if (_slotView == null) createSlotView()
+        viewTreeObserver.addOnGlobalLayoutListener(globalLayoutListener)
+        viewTreeObserver.addOnPreDrawListener(preDrawListener)
+        post { measureAndDispatch() }
+        // Retry: catches campaigns that arrive slightly after mount.
+        postDelayed({
+            if (lastReportedHeightPx.get() <= 0) {
+                lastReportedHeightPx.set(-1)
+                measureAndDispatch()
+            }
+        }, DELAYED_MEASURE_MS)
+    }
+
+    override fun onDetachedFromWindow() {
+        viewTreeObserver.removeOnGlobalLayoutListener(globalLayoutListener)
+        viewTreeObserver.removeOnPreDrawListener(preDrawListener)
+        super.onDetachedFromWindow()
+        lastReportedHeightPx.set(-1)
+    }
+
+    // Defer measureAndDispatch to avoid re-measuring during Compose's composition phase,
+    // which crashes with "pending composition has not been applied".
+    override fun requestLayout() {
+        super.requestLayout()
+        post { measureAndDispatch() }
+    }
+
+    private fun createSlotView() {
+        val themedCtx = context as? ThemedReactContext
+        val activityCtx: Context = themedCtx?.currentActivity ?: context
+
+        val slot = DigiaSlotView(activityCtx)
+
+        val activity = themedCtx?.currentActivity
+        if (activity is LifecycleOwner) slot.setViewTreeLifecycleOwner(activity)
+        if (activity is ViewModelStoreOwner) slot.setViewTreeViewModelStoreOwner(activity)
+        if (activity is SavedStateRegistryOwner) slot.setViewTreeSavedStateRegistryOwner(activity)
+
+        slot.placementKey = placementKey
+        slot.layoutParams = LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT)
+        slot.addOnLayoutChangeListener { _: View, l: Int, _: Int, r: Int, _: Int,
+                                         _: Int, _: Int, _: Int, _: Int ->
+            if (r - l > 0) measureAndDispatch()
+        }
+
+        addView(slot)
+        _slotView = slot
+    }
+
+    fun measureAndDispatch() {
+        val slot = _slotView ?: return
+        val ctx = rnContext ?: return
+        val viewWidth = width
+        if (viewWidth <= 0) return
+
+        val widthSpec = MeasureSpec.makeMeasureSpec(viewWidth, MeasureSpec.EXACTLY)
+        val heightSpec = MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED)
+        slot.measure(widthSpec, heightSpec)
+        val intrinsicHeightPx = slot.measuredHeight
+
+        if (intrinsicHeightPx == lastReportedHeightPx.get()) return
+        lastReportedHeightPx.set(intrinsicHeightPx)
+
+        val density = resources.displayMetrics.density
+        val heightDp = intrinsicHeightPx / density
+
+        val dispatcher = UIManagerHelper.getEventDispatcherForReactTag(ctx, id) ?: return
+        val surfaceId = UIManagerHelper.getSurfaceId(this)
+        dispatcher.dispatchEvent(ContentSizeChangeEvent(surfaceId, id, heightDp.toDouble(), 0.0))
+    }
+
+    companion object {
+        private const val DELAYED_MEASURE_MS = 300L
+    }
+}
+
+// ── DigiaSlotViewManager ──────────────────────────────────────────────────────
+
+internal class DigiaSlotViewManager : SimpleViewManager<DigiaSlotContainerView>() {
+
+    override fun getName(): String = VIEW_NAME
+
+    override fun getExportedCustomDirectEventTypeConstants(): Map<String, Any> =
+        mapOf("onContentSizeChange" to mapOf("registrationName" to "onContentSizeChange"))
+
+    override fun createViewInstance(context: ThemedReactContext): DigiaSlotContainerView {
+        val container = DigiaSlotContainerView(context)
+        container.rnContext = context
+        container.layoutParams = FrameLayout.LayoutParams(
+            FrameLayout.LayoutParams.MATCH_PARENT,
+            FrameLayout.LayoutParams.MATCH_PARENT,
+        )
+        return container
+    }
+
+    @ReactProp(name = "placementKey")
+    fun setPlacementKey(view: DigiaSlotContainerView, placementKey: String?) {
+        view.placementKey = placementKey.orEmpty()
+    }
+
+    companion object {
+        const val VIEW_NAME = "DigiaSlotView"
+    }
+}

package/android/bin/src/main/java/com/digia/engage/rn/DigiaViewManager.kt

@@ -0,0 +1,64 @@
+/**
+ * DigiaViewManager
+ *
+ * React Native ViewManager that exposes `DigiaHostView` (from the Digia Android SDK) as the native
+ * view behind the JS `<DigiaHostView>` component.
+ *
+ * The view hosts the `DigiaHost` composable which manages dialog and bottom-sheet overlays driven
+ * by Digia CEP plugins.
+ */
+package com.digia.engage.rn
+
+import android.content.Context
+import android.widget.FrameLayout
+import androidx.lifecycle.LifecycleOwner
+import androidx.lifecycle.ViewModelStoreOwner
+import androidx.lifecycle.setViewTreeLifecycleOwner
+import androidx.lifecycle.setViewTreeViewModelStoreOwner
+import androidx.savedstate.SavedStateRegistryOwner
+import androidx.savedstate.setViewTreeSavedStateRegistryOwner
+import com.digia.engage.DigiaHostView
+import com.facebook.react.uimanager.SimpleViewManager
+import com.facebook.react.uimanager.ThemedReactContext
+
+internal class DigiaViewManager : SimpleViewManager<DigiaHostView>() {
+
+    override fun getName(): String = VIEW_NAME
+
+    override fun createViewInstance(context: ThemedReactContext): DigiaHostView {
+        // Prefer the current Activity as the context provider so that the Compose
+        // runtime can access a proper LifecycleOwner / ViewModelStoreOwner.
+        val activityContext: Context = context.currentActivity ?: context
+
+        val view = DigiaHostView(activityContext)
+
+        // Explicitly wire the Android Architecture Component owners so that the
+        // Compose runtime (which uses ViewTree* APIs) works correctly regardless
+        // of React Native's internal view hierarchy wiring.
+        val activity = context.currentActivity
+        if (activity is LifecycleOwner) {
+            view.setViewTreeLifecycleOwner(activity)
+        }
+        if (activity is ViewModelStoreOwner) {
+            view.setViewTreeViewModelStoreOwner(activity)
+        }
+        if (activity is SavedStateRegistryOwner) {
+            view.setViewTreeSavedStateRegistryOwner(activity)
+        }
+
+        // React Native controls sizing via its layout system; fill whatever space
+        // the JS stylesheet allocates (typically StyleSheet.absoluteFill).
+        view.layoutParams =
+                FrameLayout.LayoutParams(
+                        FrameLayout.LayoutParams.MATCH_PARENT,
+                        FrameLayout.LayoutParams.MATCH_PARENT,
+                )
+
+        android.util.Log.d("DigiaHost", "[DigiaViewManager] RN-side NativeDigiaHostView instance created (id=${view.id})")
+        return view
+    }
+
+    companion object {
+        const val VIEW_NAME = "DigiaHostView"
+    }
+}

package/android/build.gradle

@@ -71,7 +71,7 @@ android {
 
 dependencies {
     // Digia Engage Android library
-    implementation 'tech.digia:engage:2.0.0'
+    implementation 'tech.digia:engage:2.1.0'
 
     // ── React Native ─────────────────────────────────────────────────────────
     // React Native is provided by the host app; mark as compileOnly so it is