@digia-engage/core 2.2.1 → 2.3.1

package/android/bin/gradlew.bat

@@ -1,89 +0,0 @@
-@rem
-@rem Copyright 2015 the original author or authors.
-@rem
-@rem Licensed under the Apache License, Version 2.0 (the "License");
-@rem you may not use this file except in compliance with the License.
-@rem You may obtain a copy of the License at
-@rem
-@rem      https://www.apache.org/licenses/LICENSE-2.0
-@rem
-@rem Unless required by applicable law or agreed to in writing, software
-@rem distributed under the License is distributed on an "AS IS" BASIS,
-@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-@rem See the License for the specific language governing permissions and
-@rem limitations under the License.
-@rem
-
-@if "%DEBUG%" == "" @echo off
-@rem ##########################################################################
-@rem
-@rem  Gradle startup script for Windows
-@rem
-@rem ##########################################################################
-
-@rem Set local scope for the variables with windows NT shell
-if "%OS%"=="Windows_NT" setlocal
-
-set DIRNAME=%~dp0
-if "%DIRNAME%" == "" set DIRNAME=.
-set APP_BASE_NAME=%~n0
-set APP_HOME=%DIRNAME%
-
-@rem Resolve any "." and ".." in APP_HOME to make it shorter.
-for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
-
-@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
-set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
-
-@rem Find java.exe
-if defined JAVA_HOME goto findJavaFromJavaHome
-
-set JAVA_EXE=java.exe
-%JAVA_EXE% -version >NUL 2>&1
-if "%ERRORLEVEL%" == "0" goto execute
-
-echo.
-echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
-echo.
-echo Please set the JAVA_HOME variable in your environment to match the
-echo location of your Java installation.
-
-goto fail
-
-:findJavaFromJavaHome
-set JAVA_HOME=%JAVA_HOME:"=%
-set JAVA_EXE=%JAVA_HOME%/bin/java.exe
-
-if exist "%JAVA_EXE%" goto execute
-
-echo.
-echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
-echo.
-echo Please set the JAVA_HOME variable in your environment to match the
-echo location of your Java installation.
-
-goto fail
-
-:execute
-@rem Setup the command line
-
-set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
-
-
-@rem Execute Gradle
-"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
-
-:end
-@rem End local scope for the variables with windows NT shell
-if "%ERRORLEVEL%"=="0" goto mainEnd
-
-:fail
-rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
-rem the _cmd.exe /c_ return code!
-if  not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
-exit /b 1
-
-:mainEnd
-if "%OS%"=="Windows_NT" endlocal
-
-:omega

package/android/bin/local.properties

@@ -1 +0,0 @@
-sdk.dir=/Users/ram/Library/Android/sdk

package/android/bin/settings.gradle

@@ -1,25 +0,0 @@
-pluginManagement {
-    plugins {
-        id 'com.android.library' version '8.11.2'
-        id 'com.android.application' version '8.11.2'
-        id 'org.jetbrains.kotlin.android' version '2.1.0'
-        id 'org.jetbrains.kotlin.plugin.compose' version '2.1.0'
-        id 'org.jetbrains.kotlin.plugin.serialization' version '2.1.0'
-    }
-    repositories {
-        google()
-        mavenCentral()
-        gradlePluginPortal()
-    }
-}
-
-dependencyResolutionManagement {
-    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
-    repositories {
-        mavenLocal()
-        google()
-        mavenCentral()
-    }
-}
-
-rootProject.name = "digia-engage-rn"

package/android/bin/src/main/AndroidManifest.xml

@@ -1,2 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<manifest xmlns:android="http://schemas.android.com/apk/res/android" />

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

@@ -1,90 +0,0 @@
-package com.digia.engage.rn
-
-import android.content.Context
-import android.view.View
-import android.view.ViewTreeObserver
-import android.widget.FrameLayout
-import com.digia.engage.Digia
-import com.facebook.react.uimanager.ThemedReactContext
-import com.facebook.react.uimanager.ViewGroupManager
-import com.facebook.react.uimanager.annotations.ReactProp
-
-internal class DigiaAnchorContainerView(context: Context) : FrameLayout(context) {
-
-    var anchorKey: String = ""
-
-    private val globalLayoutListener = ViewTreeObserver.OnGlobalLayoutListener { reportPosition() }
-
-    override fun onAttachedToWindow() {
-        super.onAttachedToWindow()
-        viewTreeObserver.addOnGlobalLayoutListener(globalLayoutListener)
-        reportPosition()
-    }
-
-    override fun onDetachedFromWindow() {
-        viewTreeObserver.removeOnGlobalLayoutListener(globalLayoutListener)
-        if (anchorKey.isNotBlank()) Digia.unregisterAnchor(anchorKey)
-        super.onDetachedFromWindow()
-    }
-
-    private fun reportPosition() {
-        val key = anchorKey.takeIf { it.isNotBlank() } ?: return
-        // React Native (Fabric) may not call layout() on this FrameLayout wrapper,
-        // so this.width/height can be 0. Derive dimensions from the first child instead.
-        val targetView: android.view.View = if (childCount > 0) getChildAt(0) else this
-        val w = targetView.width
-        val h = targetView.height
-        if (w == 0 || h == 0) return // not measured yet — wait for next layout pass
-        val loc = IntArray(2)
-        targetView.getLocationOnScreen(loc)
-        android.util.Log.d(
-                "Digia",
-                "[DigiaAnchorView] registerAnchor key='$key' x=${loc[0]} y=${loc[1]} w=$w h=$h"
-        )
-        Digia.registerAnchor(key, loc[0], loc[1], w, h)
-        Digia.registerAnchorView(key, targetView)
-    }
-}
-
-// ViewGroupManager (not SimpleViewManager) because Fabric calls getViewGroupManager()
-// on any view that hosts RN children — DigiaAnchorView wraps the anchor target element.
-internal class DigiaAnchorViewManager : ViewGroupManager<DigiaAnchorContainerView>() {
-
-    override fun getName(): String = VIEW_NAME
-
-    override fun createViewInstance(context: ThemedReactContext) = DigiaAnchorContainerView(context)
-
-    // Use updateProperties instead of @ReactProp to be compatible with both
-    // Old Architecture (Paper) and New Architecture (Fabric) without codegen.
-    override fun updateProperties(
-            viewToUpdate: DigiaAnchorContainerView,
-            props: com.facebook.react.uimanager.ReactStylesDiffMap,
-    ) {
-        super.updateProperties(viewToUpdate, props)
-        if (props.hasKey("anchorKey")) {
-            viewToUpdate.anchorKey = props.getString("anchorKey") ?: ""
-        }
-    }
-
-    @com.facebook.react.uimanager.annotations.ReactProp(name = "anchorKey")
-    fun setAnchorKey(view: DigiaAnchorContainerView, key: String?) {
-        view.anchorKey = key.orEmpty()
-    }
-
-    override fun addView(parent: DigiaAnchorContainerView, child: View, index: Int) {
-        parent.addView(child, index)
-    }
-
-    override fun getChildCount(parent: DigiaAnchorContainerView): Int = parent.childCount
-
-    override fun getChildAt(parent: DigiaAnchorContainerView, index: Int): View =
-            parent.getChildAt(index)
-
-    override fun removeViewAt(parent: DigiaAnchorContainerView, index: Int) {
-        parent.removeViewAt(index)
-    }
-
-    companion object {
-        const val VIEW_NAME = "DigiaAnchorView"
-    }
-}

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

@@ -1,309 +0,0 @@
-/**
- * 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

@@ -1,70 +0,0 @@
-/**
- * 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(),
-            )
-}