@digia-engage/core 2.0.0 → 2.0.2

package/README.md

@@ -1,6 +1,7 @@
 # @digia-engage/core
 
-React Native SDK for **Digia Engage** – renders native Android (Jetpack Compose) and iOS campaign UI (bottom sheets, dialogs, inline banners, tooltips, spotlights) inside React Native applications.
+React Native bridge for the **Digia Engage SDK** — renders in-app experiences
+(tooltips, spotlights, carousels, surveys) inside React Native applications.
 
 > **Platform support**
 > | Platform | Status |
@@ -8,11 +9,42 @@ React Native SDK for **Digia Engage** – renders native Android (Jetpack Compos
 > | Android | ✅ Full support |
 > | iOS | ✅ Guide overlays (JS renderer); native bridge (surveys, inline) |
 
+---
+
+## How it works
+
+Guide campaigns (tooltip / spotlight) are rendered entirely in **JavaScript** by
+`DigiaProvider.tsx` using `@floating-ui/core` for anchor positioning. Surveys
+and inline carousels are forwarded to the **native Android/iOS SDK** via the
+bridge for Compose/SwiftUI rendering.
+
+```
+CEP plugin (e.g. CleverTap)
+  │
+  ▼
+Digia.onCampaignTriggered(payload)
+  │
+  ├─ campaign_type === 'guide'   → DigiaGuideController → DigiaProvider.tsx (JS)
+  │                                                        TooltipOverlay / SpotlightOverlay
+  │
+  ├─ campaign_type === 'inline'  → nativeDigiaModule.triggerCampaign()
+  │                                Android: DigiaSlot composable → VWCarousel
+  │
+  └─ campaign_type === 'survey'  → nativeDigiaModule.triggerCampaign()
+                                   Android: SurveyRenderer composable
+```
+
+---
+
+## Installation
+
 ```sh
 npm install @digia-engage/core
+# or
+yarn add @digia-engage/core
 ```
 
-React Native CLI auto-linking handles the rest. Rebuild the native app after installing:
+React Native CLI auto-linking handles the rest. Rebuild the native app:
 
 ```sh
 npx react-native run-android
@@ -50,7 +82,8 @@ await Digia.initialize({
 
 ### 2 — Mount `<DigiaHost />`
 
-Place `<DigiaHost />` at the root of your component tree. It renders the JS-side guide/tooltip/spotlight overlays via a `Modal`.
+Place `<DigiaHost />` at the root of your component tree. It renders the
+JS-side guide/tooltip/spotlight overlays via a `Modal`.
 
 ```tsx
 // app/_layout.tsx (Expo Router) or App.tsx
@@ -211,8 +244,8 @@ react-native/src/
   DigiaSlotView.tsx         Native slot view wrapper; auto-sizes to content height
   DigiaHostView.tsx         Low-level native overlay host (transparent, pointer-events none)
   NativeDigiaEngage.ts      Codegen native module spec (TurboModule)
-  actionHandler.ts          Action execution — deep link, open URL, next/prev/dismiss;
-                            onAction override; cold-start queue
+  actionHandler.ts          Action execution — deep link, open URL, next/prev/dismiss,
+                            fire_event; onAction override; cold-start queue
   defaultInAppBrowser.ts    Lazily loads react-native-inappbrowser-reborn
   templateTypes.ts          TypeScript types for TooltipConfig, SpotlightConfig,
                             CarouselConfig, SurveyTemplateConfig

package/android/build.gradle

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

package/android/local.properties

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

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

@@ -1,65 +1,89 @@
 package com.digia.engage.rn
 
-import android.graphics.Color
-import android.graphics.Outline
+import android.content.Context
 import android.view.View
-import android.view.ViewOutlineProvider
+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.DigiaAnchorView
+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 DigiaAnchorViewManager : ViewGroupManager<DigiaAnchorView>() {
+internal class DigiaAnchorContainerView(context: Context) : FrameLayout(context) {
 
-    override fun getName(): String = VIEW_NAME
+    var anchorKey: String = ""
 
-    override fun createViewInstance(context: ThemedReactContext): DigiaAnchorView {
-        val activityContext = context.currentActivity ?: context
-        val view = DigiaAnchorView(activityContext)
+    private val globalLayoutListener = ViewTreeObserver.OnGlobalLayoutListener { reportPosition() }
 
-        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)
+    override fun onAttachedToWindow() {
+        super.onAttachedToWindow()
+        viewTreeObserver.addOnGlobalLayoutListener(globalLayoutListener)
+        reportPosition()
+    }
 
-        view.layoutParams = FrameLayout.LayoutParams(
-            FrameLayout.LayoutParams.WRAP_CONTENT,
-            FrameLayout.LayoutParams.WRAP_CONTENT,
-        )
-        // Prevent the FrameLayout background from leaking white in spotlight corners.
-        view.setBackgroundColor(Color.TRANSPARENT)
-        return view
+    override fun onDetachedFromWindow() {
+        viewTreeObserver.removeOnGlobalLayoutListener(globalLayoutListener)
+        if (anchorKey.isNotBlank()) Digia.unregisterAnchor(anchorKey)
+        super.onDetachedFromWindow()
     }
 
-    @ReactProp(name = "anchorKey")
-    fun setAnchorKey(view: DigiaAnchorView, anchorKey: String?) {
-        view.anchorKey = anchorKey.orEmpty()
+    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)
 
-    @ReactProp(name = "cornerRadius", defaultFloat = 0f)
-    fun setCornerRadius(view: DigiaAnchorView, cornerRadius: Float) {
-        val px = cornerRadius * view.resources.displayMetrics.density
-        view.spotlightCornerRadius = px
-        if (px > 0f) {
-            view.outlineProvider = object : ViewOutlineProvider() {
-                override fun getOutline(v: View, outline: Outline) {
-                    outline.setRoundRect(0, 0, v.width, v.height, px)
-                }
-            }
-            view.clipToOutline = true
-        } else {
-            view.clipToOutline = false
-            view.outlineProvider = ViewOutlineProvider.BOUNDS
+    // 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/ios/DigiaAnchorViewManager.swift

@@ -1,43 +1,67 @@
+/**
+ * DigiaAnchorViewManager
+ *
+ * iOS RCTViewManager that vends DigiaAnchorContainerUIView — a UIView wrapper
+ * that automatically tracks its screen-coordinate frame and registers it with
+ * AnchorRegistry whenever it lays out or moves to a new window.
+ *
+ * This mirrors Android's DigiaAnchorViewManager / DigiaAnchorContainerView.
+ */
+
+import Foundation
 import React
 import UIKit
 import DigiaEngage
 
-@objc(DigiaAnchorView)
-final class DigiaAnchorViewManager: RCTViewManager {
-
-    override static func requiresMainQueueSetup() -> Bool { true }
-
-    override func view() -> UIView! {
-        return DigiaAnchorUIView()
-    }
-
-    @objc func setAnchorKey(_ anchorKey: String, forView view: DigiaAnchorUIView) {
-        view.anchorKey = anchorKey
-    }
-}
+// MARK: - DigiaAnchorContainerUIView
 
-// MARK: - DigiaAnchorUIView
+@objc(DigiaAnchorContainerUIView)
+final class DigiaAnchorContainerUIView: UIView {
 
-final class DigiaAnchorUIView: UIView {
-
-    var anchorKey: String = "" {
+    @objc var anchorKey: String = "" {
         didSet {
-            guard anchorKey != oldValue else { return }
-            if !oldValue.isEmpty {
-                AnchorRegistry.shared.unregister(key: oldValue)
-            }
-            if !anchorKey.isEmpty, window != nil {
-                AnchorRegistry.shared.register(key: anchorKey, view: self)
+            if !oldValue.isEmpty && oldValue != anchorKey {
+                Task { @MainActor in AnchorRegistry.shared.unregister(key: oldValue) }
             }
+            reportPosition()
         }
     }
 
+    override func layoutSubviews() {
+        super.layoutSubviews()
+        reportPosition()
+    }
+
     override func didMoveToWindow() {
         super.didMoveToWindow()
-        if window != nil, !anchorKey.isEmpty {
-            AnchorRegistry.shared.register(key: anchorKey, view: self)
-        } else if window == nil, !anchorKey.isEmpty {
-            AnchorRegistry.shared.unregister(key: anchorKey)
+        if window == nil {
+            guard !anchorKey.isEmpty else { return }
+            let key = anchorKey
+            Task { @MainActor in AnchorRegistry.shared.unregister(key: key) }
+        } else {
+            reportPosition()
+        }
+    }
+
+    private func reportPosition() {
+        guard !anchorKey.isEmpty, window != nil else { return }
+        // convert(bounds, to: nil) gives frame in window coordinates (UIKit points)
+        let rectInWindow = convert(bounds, to: nil)
+        let key = anchorKey
+        Task { @MainActor in
+            AnchorRegistry.shared.register(key: key, rect: rectInWindow)
         }
     }
 }
+
+// MARK: - DigiaAnchorViewManager
+
+@objc(DigiaAnchorView)
+final class DigiaAnchorViewManager: RCTViewManager {
+
+    override static func requiresMainQueueSetup() -> Bool { true }
+
+    override func view() -> UIView! {
+        DigiaAnchorContainerUIView()
+    }
+}

package/ios/DigiaEngageModule.m

@@ -40,13 +40,13 @@ RCT_EXTERN_METHOD(triggerCampaign:(NSString *)id
 
 RCT_EXTERN_METHOD(invalidateCampaign:(NSString *)campaignId)
 
-RCT_EXTERN_METHOD(showAnchoredOverlay:(NSString *)id
-                  content:(NSDictionary *)content
-                  cepContext:(NSDictionary *)cepContext
-                  anchorX:(double)anchorX
-                  anchorY:(double)anchorY
-                  anchorWidth:(double)anchorWidth
-                  anchorHeight:(double)anchorHeight)
+RCT_EXTERN_METHOD(registerAnchor:(NSString *)key
+                  x:(double)x
+                  y:(double)y
+                  width:(double)width
+                  height:(double)height)
+
+RCT_EXTERN_METHOD(unregisterAnchor:(NSString *)key)
 
 @end
 
@@ -64,7 +64,3 @@ RCT_EXPORT_VIEW_PROPERTY(onContentSizeChange, RCTDirectEventBlock)
 @interface RCT_EXTERN_MODULE(DigiaAnchorView, RCTViewManager)
 RCT_EXPORT_VIEW_PROPERTY(anchorKey, NSString)
 @end
-
-@interface RCT_EXTERN_MODULE(DigiaAnchorView, RCTViewManager)
-RCT_EXPORT_VIEW_PROPERTY(anchorKey, NSString)
-@end

package/ios/DigiaModule.swift

@@ -1,3 +1,4 @@
+import DigiaEngage
 /**
  * DigiaModule
  *
@@ -30,7 +31,6 @@ import Foundation
 import React
 import SwiftUI
 import UIKit
-import DigiaEngage
 
 @objc(DigiaEngageModule)
 final class DigiaModule: RCTEventEmitter {
@@ -69,19 +69,22 @@ final class DigiaModule: RCTEventEmitter {
         resolve: @escaping RCTPromiseResolveBlock,
         reject: @escaping RCTPromiseRejectBlock
     ) {
-        let envValue: DigiaEnvironment = environment.lowercased() == "sandbox" ? .sandbox : .production
+        let envValue: DigiaEnvironment =
+            environment.lowercased() == "sandbox" ? .sandbox : .production
         let logLevelValue: DigiaLogLevel
         switch logLevel.lowercased() {
         case "verbose": logLevelValue = .verbose
-        case "none":    logLevelValue = .none
-        default:        logLevelValue = .error
+        case "none": logLevelValue = .none
+        default: logLevelValue = .error
         }
 
         let config = DigiaConfig(
             apiKey: projectId,
             logLevel: logLevelValue,
             environment: envValue,
-            developerConfig: baseUrl.flatMap { $0.isEmpty ? nil : DigiaDeveloperConfig(baseURL: $0) },
+            developerConfig: baseUrl.flatMap {
+                $0.isEmpty ? nil : DigiaDeveloperConfig(baseURL: $0)
+            },
             fontFamily: fontFamily.flatMap { $0.isEmpty ? nil : $0 }
         )
 
@@ -156,37 +159,28 @@ final class DigiaModule: RCTEventEmitter {
     }
 
     // ────────────────────────────────────────────────────────────────────────
-    // MARK: - showAnchoredOverlay
+    // MARK: - registerAnchor / unregisterAnchor
 
-    /// Shows SHOW_TOOLTIP or SHOW_SPOTLIGHT anchored to coordinates measured in JS.
-    /// anchorX/Y/Width/Height are screen-pixel values from measureInWindow().
+    /// Registers a UI element as an anchor point for Guide experiences.
+    /// JS sends physical pixels; convert to UIKit points using screen scale.
     @objc
-    func showAnchoredOverlay(
-        _ id: String,
-        content contentMap: NSDictionary,
-        cepContext cepContextMap: NSDictionary,
-        anchorX: Double,
-        anchorY: Double,
-        anchorWidth: Double,
-        anchorHeight: Double
-    ) {
-        let mutable = NSMutableDictionary(dictionary: contentMap)
-        // Pack anchor coords into the args sub-dict so buildInAppPayloadContent
-        // captures them as JSONValue entries in InAppPayloadContent.args.
-        var argsDict = (mutable["args"] as? [String: Any]) ?? [:]
-        argsDict["_anchorX"] = anchorX
-        argsDict["_anchorY"] = anchorY
-        argsDict["_anchorWidth"] = anchorWidth
-        argsDict["_anchorHeight"] = anchorHeight
-        mutable["args"] = argsDict
-
-        let content = buildInAppPayloadContent(from: mutable)
-        let cepContext = (cepContextMap as? [String: String]) ?? [:]
-        let payload = InAppPayload(id: id, content: content, cepContext: cepContext)
+    func registerAnchor(_ key: String, x: Double, y: Double, width: Double, height: Double) {
+        let scale = UIScreen.main.scale
+        let rect = CGRect(
+            x: CGFloat(x) / scale,
+            y: CGFloat(y) / scale,
+            width: CGFloat(width) / scale,
+            height: CGFloat(height) / scale
+        )
+        Task { @MainActor in
+            AnchorRegistry.shared.register(key: key, rect: rect)
+        }
+    }
 
+    @objc
+    func unregisterAnchor(_ key: String) {
         Task { @MainActor in
-            guard let delegate = self.rnPlugin.delegate else { return }
-            delegate.onCampaignTriggered(payload)
+            AnchorRegistry.shared.unregister(key: key)
         }
     }
 
@@ -199,44 +193,34 @@ final class DigiaModule: RCTEventEmitter {
     @MainActor
     private func mountDigiaHost() {
         // Locate the key window's root view controller.
-        guard let rootVC = UIApplication.shared
-            .connectedScenes
-            .compactMap({ ($0 as? UIWindowScene)?.keyWindow })
-            .first?
-            .rootViewController else { return }
+        guard
+            let rootVC = UIApplication.shared
+                .connectedScenes
+                .compactMap({ ($0 as? UIWindowScene)?.keyWindow })
+                .first?
+                .rootViewController
+        else { return }
 
         // Guard against double-mounting (e.g. fast-refresh).
         let mountTag = 0xD19140
         if rootVC.view.viewWithTag(mountTag) != nil { return }
 
-        // Container with passthrough hitTest — lets tooltip card taps reach SwiftUI
-        // while all other touches fall through to React Native content.
-        let container = DigiaPassthroughHostView()
-        container.tag = mountTag
-        container.translatesAutoresizingMaskIntoConstraints = false
-        container.backgroundColor = .clear
-
         let hc = UIHostingController(rootView: DigiaHostWrapperView())
+        hc.view.tag = mountTag
         hc.view.translatesAutoresizingMaskIntoConstraints = false
         hc.view.backgroundColor = .clear
-
-        container.hostingView = hc.view
+        // Pass touches through to React Native content below.
+        hc.view.isUserInteractionEnabled = false
 
         rootVC.addChild(hc)
-        container.addSubview(hc.view)
+        rootVC.view.addSubview(hc.view)
         hc.didMove(toParent: rootVC)
 
-        rootVC.view.addSubview(container)
-
         NSLayoutConstraint.activate([
-            container.leadingAnchor.constraint(equalTo: rootVC.view.leadingAnchor),
-            container.trailingAnchor.constraint(equalTo: rootVC.view.trailingAnchor),
-            container.topAnchor.constraint(equalTo: rootVC.view.topAnchor),
-            container.bottomAnchor.constraint(equalTo: rootVC.view.bottomAnchor),
-            hc.view.leadingAnchor.constraint(equalTo: container.leadingAnchor),
-            hc.view.trailingAnchor.constraint(equalTo: container.trailingAnchor),
-            hc.view.topAnchor.constraint(equalTo: container.topAnchor),
-            hc.view.bottomAnchor.constraint(equalTo: container.bottomAnchor),
+            hc.view.leadingAnchor.constraint(equalTo: rootVC.view.leadingAnchor),
+            hc.view.trailingAnchor.constraint(equalTo: rootVC.view.trailingAnchor),
+            hc.view.topAnchor.constraint(equalTo: rootVC.view.topAnchor),
+            hc.view.bottomAnchor.constraint(equalTo: rootVC.view.bottomAnchor),
         ])
     }
 
@@ -244,23 +228,23 @@ final class DigiaModule: RCTEventEmitter {
     // MARK: - Private helpers
 
     private func buildInAppPayloadContent(from map: NSDictionary) -> InAppPayloadContent {
-        let pk      = map["placementKey"]  as? String
-        let title   = map["title"]         as? String
-        let text    = map["text"]          as? String
-        let viewId  = map["viewId"]        as? String
-        let command = map["command"]       as? String
-        let screenId = map["screenId"]     as? String
+        let pk = map["placementKey"] as? String
+        let title = map["title"] as? String
+        let text = map["text"] as? String
+        let viewId = map["viewId"] as? String
+        let command = map["command"] as? String
+        let screenId = map["screenId"] as? String
         var type = (map["type"] as? String)?.trimmingCharacters(in: .whitespacesAndNewlines) ?? ""
         if type.isEmpty {
-            type = (pk?.trimmingCharacters(in: .whitespacesAndNewlines) ?? "").isEmpty ? "dialog" : "inline"
+            type =
+                (pk?.trimmingCharacters(in: .whitespacesAndNewlines) ?? "").isEmpty
+                ? "dialog" : "inline"
         }
         let args: [String: JSONValue] = {
             guard let raw = map["args"] as? [String: Any] else { return [:] }
             return raw.compactMapValues { JSONValue(rawValue: $0) }
         }()
 
-        let anchorKey = map["anchorKey"] as? String
-
         return InAppPayloadContent(
             type: type,
             placementKey: pk,
@@ -269,36 +253,19 @@ final class DigiaModule: RCTEventEmitter {
             viewId: viewId,
             command: command,
             args: args,
-            screenId: screenId,
-            anchorKey: anchorKey
+            screenId: screenId
         )
     }
 }
 
-// MARK: - DigiaPassthroughHostView
-
-/// Container that delegates hitTest to the SwiftUI hosting view.
-/// When SwiftUI renders nothing interactive (no overlay), hitTest returns nil
-/// so touches fall through to React Native. When an overlay is visible,
-/// taps on it are consumed by SwiftUI.
-private final class DigiaPassthroughHostView: UIView {
-    weak var hostingView: UIView?
-
-    override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
-        guard let hv = hostingView else { return nil }
-        let converted = convert(point, to: hv)
-        return hv.hitTest(converted, with: event)
-    }
-}
-
 // MARK: - JSONValue convenience init from Any
-private extension JSONValue {
-    init?(rawValue: Any) {
+extension JSONValue {
+    fileprivate init?(rawValue: Any) {
         switch rawValue {
-        case let s as String:  self = .string(s)
-        case let b as Bool:    self = .bool(b)
-        case let i as Int:     self = .int(i)
-        case let d as Double:  self = .double(d)
+        case let s as String: self = .string(s)
+        case let b as Bool: self = .bool(b)
+        case let i as Int: self = .int(i)
+        case let d as Double: self = .double(d)
         case let arr as [Any]:
             self = .array(arr.compactMap { JSONValue(rawValue: $0) })
         case let dict as [String: Any]:

package/lib/commonjs/Digia.js

@@ -67,7 +67,8 @@ class DigiaClass {
     _actionHandler.digiaActionHandler.configure({
       onAction: config.onAction,
       routeViaSystemLinking: config.linking?.routeViaSystemLinking ?? true,
-      inAppBrowser: config.linking?.inAppBrowser
+      inAppBrowser: config.linking?.inAppBrowser,
+      onFireEvent: (eventName, properties, context) => this._fireCustomEvent(eventName, properties, context)
     });
     try {
       await _NativeDigiaEngage.nativeDigiaModule.initialize(config.projectId, environment, logLevel, config.baseUrl, config.fontFamily);
@@ -245,6 +246,17 @@ class DigiaClass {
     if (this._engageSubscription) return;
     this._engageSubscription = _reactNative.DeviceEventEmitter.addListener('digiaEngageEvent', data => this._forwardExperienceEvent(data));
   }
+  _fireCustomEvent(eventName, properties, context) {
+    const payload = context ? this._activePayloads.get(context.campaign_id) : null;
+    if (payload) {
+      const event = {
+        type: 'clicked',
+        elementId: eventName
+      };
+      this._plugins.forEach(plugin => plugin.notifyEvent(event, payload));
+    }
+    // TODO: record custom event to Digia analytics endpoint when available
+  }
   _forwardExperienceEvent(data) {
     const payload = this._activePayloads.get(data.campaignId);
     if (!payload) return;
@@ -535,7 +547,7 @@ class DigiaClass {
   _log(message) {
     if (this._logLevel !== 'verbose') return;
     // eslint-disable-next-line no-console
-    // console.log(`[Digia] ${message}`);
+    console.log(`[Digia] ${message}`);
   }
 }
 const Digia = exports.Digia = new DigiaClass();