@digia-engage/core 1.0.0-beta.1

package/DigiaEngageReactNative.podspec

@@ -0,0 +1,21 @@
+Pod::Spec.new do |s|
+  s.name             = 'DigiaEngageReactNative'
+  s.version          = '0.1.0'
+  s.summary          = 'React Native bridge for the Digia Engage SDK (Android Compose UI).'
+  s.description      = <<-DESC
+    Provides a React Native bridge that surfaces the Digia Engage Android
+    Compose UI SDK inside React Native applications.  iOS support is stubbed
+    and will be added in a future release.
+  DESC
+
+  s.homepage         = 'https://github.com/Digia-Technology-Private-Limited/digia_engage'
+  s.license          = { :type => 'MIT', :file => '../LICENSE' }
+  s.author           = { 'Digia Technology Private Limited' => '' }
+  s.source           = { :git => 'https://github.com/Digia-Technology-Private-Limited/digia_engage.git', :tag => s.version.to_s }
+
+  s.ios.deployment_target = '13.0'
+
+  s.source_files = 'ios/**/*.{h,m,mm,swift}'
+
+  s.dependency 'React-Core'
+end

package/README.md

@@ -0,0 +1,277 @@
+# @digia/engage-react-native
+
+React Native bridge for the **Digia Engage SDK** – renders native Android
+Jetpack Compose UI (dialogs, bottom-sheets) inside React Native applications.
+
+> **Platform support**
+> | Platform | Status |
+> |---|---|
+> | Android | ✅ Full support |
+> | iOS | 🚧 Stub (no-op – coming soon) |
+
+---
+
+## How it works
+
+The Digia Engage Android SDK is built entirely with Jetpack Compose. In a
+pure-Android app you wrap your content with the `DigiaHost { }` composable; it
+then manages campaign-driven overlays (dialogs, bottom sheets) on top of your
+content.
+
+In a React Native app we cannot embed a Composable directly in the JS tree, so
+the bridge uses two complementary mechanisms:
+
+```
+┌─────────────────────────────────────────┐
+│  Android Activity (ReactActivity)       │
+│                                         │
+│  ┌─────────────────────────────────┐    │
+│  │  Android content FrameLayout    │    │
+│  │                                 │    │
+│  │  ┌─────────────────────────┐    │    │
+│  │  │  React Native RootView  │    │    │
+│  │  │  (your JS UI)           │    │    │
+│  │  └─────────────────────────┘    │    │
+│  │                                 │    │
+│  │  ┌─────────────────────────┐    │    │
+│  │  │  DigiaHostComposeView   │    │    │
+│  │  │  (AbstractComposeView)  │    │    │
+│  │  │  hosts DigiaHost { }   │    │    │
+│  │  │  ← transparent, no     │    │    │
+│  │  │    touch interception  │    │    │
+│  │  └─────────────────────────┘    │    │
+│  └─────────────────────────────────┘    │
+│                                         │
+│  ┌──────────────────────────────────┐   │
+│  │  Compose Dialog window (overlay) │   │
+│  │  Triggered by CEP campaign       │   │
+│  └──────────────────────────────────┘   │
+└─────────────────────────────────────────┘
+```
+
+1. **`Digia.initialize()`** initialises the SDK and calls `addContentView()`
+   to attach a transparent `DigiaHostComposeView` on top of the React Native
+   view hierarchy.  This is the anchor for the Compose composition.
+
+2. **`DigiaHost { }`** inside the `ComposeView` manages `DialogManager` and
+   `BottomSheetManager`.  When a CEP plugin triggers a campaign, Compose
+   renders a `Dialog` or `ModalBottomSheet` – these are **separate Android
+   windows** that appear on top of everything, including React Native content.
+
+3. **`<DigiaHostView>`** is an optional React Native component you can place in
+   your component tree (e.g. as `StyleSheet.absoluteFill`) if you prefer a
+   declarative, component-based mount point instead of the auto-mount.
+
+---
+
+## Installation
+
+```sh
+# npm
+npm install @digia/engage-react-native
+
+# yarn
+yarn add @digia/engage-react-native
+```
+
+React Native CLI auto-linking handles the rest.  Rebuild the native app:
+
+```sh
+npx react-native build-android
+# or
+cd android && ./gradlew assembleDebug
+```
+
+### Android – host app dependencies
+
+Your app's `android/app/build.gradle` must declare the Digia Engage AAR
+(or include it via your local Maven / private registry):
+
+```groovy
+dependencies {
+    implementation 'com.digia:digia-ui:1.0.0-beta-1'
+}
+```
+
+If you are working inside the monorepo and building locally, add the `:digia-ui`
+project instead:
+
+```groovy
+implementation(project(':digia-ui'))
+```
+
+### iOS
+
+iOS is a no-op stub.  All methods resolve immediately without error.
+
+---
+
+## Usage
+
+### 1 – Initialise the SDK
+
+Call `Digia.initialize()` once, as early as possible (e.g. the top of
+`App.tsx`):
+
+```tsx
+import React, { useEffect } from 'react';
+import { NavigationContainer } from '@react-navigation/native';
+import { Digia } from '@digia/engage-react-native';
+
+export default function App() {
+  useEffect(() => {
+    Digia.initialize({
+      apiKey: 'YOUR_DIGIA_API_KEY',
+      environment: 'production', // or 'sandbox'
+      logLevel: 'error',
+    });
+  }, []);
+
+  return <NavigationContainer>{/* … */}</NavigationContainer>;
+}
+```
+
+`initialize()` returns a `Promise<void>` and automatically attaches the Compose
+overlay host to the Activity.  You do **not** need to add `<DigiaHostView>`
+unless you want an explicit component-based mount point.
+
+### 2 – Track screen changes
+
+Wire `setCurrentScreen()` to your navigation state so the SDK can trigger
+campaigns based on the active screen:
+
+```tsx
+import { useNavigationContainerRef } from '@react-navigation/native';
+import { Digia } from '@digia/engage-react-native';
+
+// Inside your App component:
+const navRef = useNavigationContainerRef();
+
+<NavigationContainer
+  ref={navRef}
+  onStateChange={() => {
+    const currentRoute = navRef.getCurrentRoute();
+    if (currentRoute) {
+      Digia.setCurrentScreen(currentRoute.name);
+    }
+  }}
+>
+```
+
+### 3 – Open the Digia UI navigation flow (Android)
+
+Launch the full-screen Compose navigation activity managed by the Digia DSL
+configuration:
+
+```tsx
+import { Digia } from '@digia/engage-react-native';
+
+function MyScreen() {
+  return (
+    <Button
+      title="Open Digia Experience"
+      onPress={() =>
+        Digia.openNavigation({
+          startPageId: 'onboarding',
+          pageArgs: { userId: '123' },
+        })
+      }
+    />
+  );
+}
+```
+
+### 4 – (Optional) Declarative overlay mount via `<DigiaHostView>`
+
+If you prefer an explicit React component instead of the auto-mount, skip the
+`initialize()` auto-mount and place `<DigiaHostView>` at the root of your
+component tree:
+
+```tsx
+import React from 'react';
+import { StyleSheet, View } from 'react-native';
+import { DigiaHostView } from '@digia/engage-react-native';
+
+export default function App() {
+  return (
+    <View style={styles.root}>
+      {/* DigiaHostView must be above all other content in z-order */}
+      <DigiaHostView style={StyleSheet.absoluteFill} />
+
+      {/* Your navigation / content here */}
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({ root: { flex: 1 } });
+```
+
+---
+
+## API Reference
+
+### `Digia`
+
+| Method | Signature | Description |
+|---|---|---|
+| `initialize` | `(config: DigiaConfig) => Promise<void>` | Initialise the SDK and mount the Compose overlay host. |
+| `setCurrentScreen` | `(name: string) => void` | Notify the SDK of the current screen. |
+| `openNavigation` | `(options?: DigiaNavigationOptions) => void` | Launch the full-screen Digia UI navigation activity. |
+
+### `DigiaConfig`
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| `apiKey` | `string` | — | **Required.** Your Digia project API key. |
+| `environment` | `'production' \| 'sandbox'` | `'production'` | Target environment. |
+| `logLevel` | `'none' \| 'error' \| 'verbose'` | `'error'` | Log verbosity. |
+
+### `DigiaNavigationOptions`
+
+| Prop | Type | Description |
+|---|---|---|
+| `startPageId` | `string?` | DSL page ID to start from. |
+| `pageArgs` | `Record<string, string>?` | Key/value args forwarded to the start page. |
+
+### `<DigiaHostView>`
+
+A transparent React Native view that hosts the Compose overlay anchor.
+
+| Prop | Type | Description |
+|---|---|---|
+| `style` | `ViewStyle?` | Custom style (defaults to `absoluteFill` behaviour). |
+
+---
+
+## Architecture overview
+
+```
+react-native/
+├── src/
+│   ├── index.ts                  ← Public API exports
+│   ├── types.ts                  ← TypeScript interfaces
+│   ├── Digia.ts                  ← High-level JS SDK wrapper
+│   ├── NativeDigiaModule.ts      ← Low-level native module binding
+│   └── DigiaHostView.tsx         ← <DigiaHostView> React component
+│
+├── android/
+│   ├── build.gradle              ← Android library build config
+│   └── src/main/java/com/digia/engage/rn/
+│       ├── DigiaPackage.kt       ← ReactPackage (registers module + view)
+│       ├── DigiaModule.kt        ← NativeModule (initialize, setCurrentScreen, openNavigation)
+│       ├── DigiaViewManager.kt   ← ViewManager for <DigiaHostView>
+│       └── DigiaHostComposeView.kt ← AbstractComposeView hosting DigiaHost { }
+│
+├── ios/
+│   └── DigiaEngageModule.m       ← iOS no-op stub
+│
+├── DigiaEngageReactNative.podspec
+├── react-native.config.js        ← Auto-linking config
+└── package.json
+```
+
+---
+
+## License
+
+MIT © Digia Technology Private Limited

package/android/build.gradle

@@ -0,0 +1,82 @@
+/**
+ * Android Gradle build file for the @digia/engage-react-native library module.
+ *
+ * This module is a thin bridge layer that:
+ *   • Depends on the Digia Engage Android AAR (digia-ui)
+ *   • Depends on the React Native SDK
+ *   • Exposes a ReactPackage (DigiaPackage) that registers the native module
+ *     and native view to React Native's bridge
+ *
+ * The Compose runtime/tooling dependencies are inherited transitively from
+ * the digia-ui AAR via `api` declarations; we only add what is needed for
+ * the bridge code itself.
+ */
+
+plugins {
+    id 'com.android.library'
+    id 'org.jetbrains.kotlin.android'
+    id 'org.jetbrains.kotlin.plugin.compose'
+    id 'com.facebook.react'
+}
+
+android {
+    compileSdk 35
+    namespace 'com.digia.engage.rn'
+
+    defaultConfig {
+        minSdk 24
+        targetSdk 35
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+
+    kotlinOptions {
+        jvmTarget = '17'
+    }
+
+    buildFeatures {
+        compose true
+    }
+
+    sourceSets {
+        main {
+            java.srcDirs += 'src/main/java'
+        }
+    }
+}
+
+dependencies {
+    // Digia Engage Android library (published to Maven Local)
+    implementation 'com.digia:digia-engage:1.0.0-beta.6'
+
+    // ── React Native ─────────────────────────────────────────────────────────
+    // React Native is provided by the host app; mark as compileOnly so it is
+    // NOT bundled into this library.
+    compileOnly "com.facebook.react:react-android"
+
+    // ── Jetpack Compose ───────────────────────────────────────────────────────
+    // Compose UI is transitively provided by digia-ui; we only need the
+    // platform BOM for version alignment.
+    implementation platform('androidx.compose:compose-bom:2023.03.00')
+
+    // UI tooling annotations (used by AbstractComposeView / preview)
+    implementation 'androidx.compose.ui:ui'
+
+    // Lifecycle: ViewTreeLifecycleOwner / setViewTreeLifecycleOwner
+    implementation 'androidx.lifecycle:lifecycle-runtime-ktx:2.6.2'
+
+    // SavedState: setViewTreeSavedStateRegistryOwner
+    implementation 'androidx.savedstate:savedstate-ktx:1.2.1'
+
+    // Activity: ComponentActivity needed for lifecycle owner detection
+    implementation 'androidx.activity:activity-compose:1.7.2'
+}

package/android/gradlew

@@ -0,0 +1,185 @@
+#!/usr/bin/env sh
+
+#
+# Copyright 2015 the original author or authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+##############################################################################
+##
+##  Gradle start up script for UN*X
+##
+##############################################################################
+
+# Attempt to set APP_HOME
+# Resolve links: $0 may be a link
+PRG="$0"
+# Need this for relative symlinks.
+while [ -h "$PRG" ] ; do
+    ls=`ls -ld "$PRG"`
+    link=`expr "$ls" : '.*-> \(.*\)$'`
+    if expr "$link" : '/.*' > /dev/null; then
+        PRG="$link"
+    else
+        PRG=`dirname "$PRG"`"/$link"
+    fi
+done
+SAVED="`pwd`"
+cd "`dirname \"$PRG\"`/" >/dev/null
+APP_HOME="`pwd -P`"
+cd "$SAVED" >/dev/null
+
+APP_NAME="Gradle"
+APP_BASE_NAME=`basename "$0"`
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD="maximum"
+
+warn () {
+    echo "$*"
+}
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+}
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "`uname`" in
+  CYGWIN* )
+    cygwin=true
+    ;;
+  Darwin* )
+    darwin=true
+    ;;
+  MINGW* )
+    msys=true
+    ;;
+  NONSTOP* )
+    nonstop=true
+    ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD="$JAVA_HOME/jre/sh/java"
+    else
+        JAVACMD="$JAVA_HOME/bin/java"
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD="java"
+    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
+    MAX_FD_LIMIT=`ulimit -H -n`
+    if [ $? -eq 0 ] ; then
+        if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
+            MAX_FD="$MAX_FD_LIMIT"
+        fi
+        ulimit -n $MAX_FD
+        if [ $? -ne 0 ] ; then
+            warn "Could not set maximum file descriptor limit: $MAX_FD"
+        fi
+    else
+        warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
+    fi
+fi
+
+# For Darwin, add options to specify how the application appears in the dock
+if $darwin; then
+    GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
+fi
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
+    APP_HOME=`cygpath --path --mixed "$APP_HOME"`
+    CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
+
+    JAVACMD=`cygpath --unix "$JAVACMD"`
+
+    # We build the pattern for arguments to be converted via cygpath
+    ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
+    SEP=""
+    for dir in $ROOTDIRSRAW ; do
+        ROOTDIRS="$ROOTDIRS$SEP$dir"
+        SEP="|"
+    done
+    OURCYGPATTERN="(^($ROOTDIRS))"
+    # Add a user-defined pattern to the cygpath arguments
+    if [ "$GRADLE_CYGPATTERN" != "" ] ; then
+        OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
+    fi
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    i=0
+    for arg in "$@" ; do
+        CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
+        CHECK2=`echo "$arg"|egrep -c "^-"`                                 ### Determine if an option
+
+        if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then                    ### Added a condition
+            eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
+        else
+            eval `echo args$i`="\"$arg\""
+        fi
+        i=`expr $i + 1`
+    done
+    case $i in
+        0) set -- ;;
+        1) set -- "$args0" ;;
+        2) set -- "$args0" "$args1" ;;
+        3) set -- "$args0" "$args1" "$args2" ;;
+        4) set -- "$args0" "$args1" "$args2" "$args3" ;;
+        5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
+        6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
+        7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
+        8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
+        9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+    esac
+fi
+
+# Escape application args
+save () {
+    for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
+    echo " "
+}
+APP_ARGS=`save "$@"`
+
+# Collect all arguments for the java command, following the shell quoting and substitution rules
+eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
+
+exec "$JAVACMD" "$@"

package/android/gradlew.bat

@@ -0,0 +1,89 @@
+@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/settings.gradle

@@ -0,0 +1,33 @@
+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 {
+        google()
+        mavenCentral()
+        mavenLocal()
+        maven { url 'https://jitpack.io' }
+    }
+    versionCatalogs {
+        libs {
+            from(files("../../android/gradle/libs.versions.toml"))
+        }
+    }
+}
+
+rootProject.name = "digia-engage-rn"
+include ':digia-engage-rn'
+project(':digia-engage-rn').projectDir = file('.')

package/android/src/main/AndroidManifest.xml

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