@digia-engage/core 1.0.0-beta.4 → 1.0.0-beta.6

package/lib/typescript/DigiaSlotView.d.ts

@@ -1,49 +1,13 @@
 /**
  * DigiaSlotView
  *
- * A React Native view that renders inline campaign content (banners, cards,
- * widgets) at a specific placement position inside your screen layout.
- *
- * On Android this mounts a Jetpack Compose `DigiaSlot` composable that
- * observes the slot payload for the given placement key and renders the
- * matching campaign component. On iOS it is a transparent no-op.
- *
- * ─── Usage ───────────────────────────────────────────────────────────────────
- * ```tsx
- * import { DigiaSlotView } from '@digia/engage-react-native';
- *
- * // Fixed height (you control the space)
- * <DigiaSlotView
- *   placementKey="hero_banner"
- *   style={{ width: '100%', height: 200 }}
- * />
- *
- * // Inside a scroll view
- * <ScrollView>
- *   <ProductList />
- *   <DigiaSlotView
- *     placementKey="pdp_mid_banner"
- *     style={{ width: '100%', height: 120 }}
- *   />
- *   <RelatedProducts />
- * </ScrollView>
- * ```
- *
- * The `placementKey` must match the key the marketer selects when creating
- * inline content on the Digia dashboard. The view collapses to nothing when
- * no campaign is active for that key.
- *
- * ─── Sizing ──────────────────────────────────────────────────────────────────
- * React Native's layout system controls the dimensions of this view.
- * Provide an explicit `height` (or flex) via the `style` prop so that the
- * native Compose layer has space to render. When no campaign is active the
- * Compose `DigiaSlot` renders nothing inside that space.
- * ─────────────────────────────────────────────────────────────────────────────
+ * Renders inline campaign content at a placement position.
+ * Auto-sizes to match native content height via `onContentSizeChange`;
+ * pass an explicit `height` in `style` to fix the size instead.
  */
 import React from 'react';
 import { type StyleProp, type ViewStyle } from 'react-native';
 interface DigiaSlotViewProps {
-    /** Placement key that links this view to a Digia dashboard slot. */
     placementKey: string;
     style?: StyleProp<ViewStyle>;
 }

package/lib/typescript/DigiaSlotView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DigiaSlotView.d.ts","sourceRoot":"","sources":["../../src/DigiaSlotView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAGH,KAAK,SAAS,EACd,KAAK,SAAS,EACjB,MAAM,cAAc,CAAC;AAEtB,UAAU,kBAAkB;IACxB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAChC;AAWD,wBAAgB,aAAa,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,kBAAkB,4BAYxE"}
+{"version":3,"file":"DigiaSlotView.d.ts","sourceRoot":"","sources":["../../src/DigiaSlotView.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAgC,MAAM,OAAO,CAAC;AACrD,OAAO,EAIH,KAAK,SAAS,EACd,KAAK,SAAS,EACjB,MAAM,cAAc,CAAC;AAEtB,UAAU,kBAAkB;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAChC;AAYD,wBAAgB,aAAa,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,kBAAkB,4BAuCxE"}

package/lib/typescript/NativeDigiaEngage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeDigiaEngage.d.ts","sourceRoot":"","sources":["../../src/NativeDigiaEngage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD;;;;;;;GAOG;AACH,MAAM,WAAW,IAAK,SAAQ,WAAW;IACrC,0DAA0D;IAC1D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjF;;;;OAIG;IACH,cAAc,IAAI,IAAI,CAAC;IAEvB,sDAAsD;IACtD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC;;;OAGG;IACH,eAAe,CACX,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACnB,IAAI,CAAC;IAER,iDAAiD;IACjD,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAChD;AAwBD,eAAO,MAAM,iBAAiB,EAAE,IAS/B,CAAC"}
+{"version":3,"file":"NativeDigiaEngage.d.ts","sourceRoot":"","sources":["../../src/NativeDigiaEngage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD;;;;;;;GAOG;AACH,MAAM,WAAW,IAAK,SAAQ,WAAW;IACrC,0DAA0D;IAC1D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjF;;;;OAIG;IACH,cAAc,IAAI,IAAI,CAAC;IAEvB,sDAAsD;IACtD,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC;;;OAGG;IACH,eAAe,CACX,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACnB,IAAI,CAAC;IAER,iDAAiD;IACjD,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAEhD;AAwBD,eAAO,MAAM,iBAAiB,EAAE,IAS/B,CAAC"}

package/lib/typescript/index.d.ts

@@ -11,5 +11,5 @@
 export { Digia } from './Digia';
 export { DigiaHostView } from './DigiaHostView';
 export { DigiaSlotView } from './DigiaSlotView';
-export type { DigiaConfig, DigiaDelegate, DigiaPlugin, InAppPayload } from './types';
+export type { DigiaConfig, DigiaDelegate, DigiaExperienceEvent, DigiaPlugin, InAppPayload } from './types';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,oBAAoB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/lib/typescript/types.d.ts

@@ -11,6 +11,21 @@ export interface InAppPayload {
     /** CEP-platform metadata, e.g. { campaignId, campaignName }. */
     cepContext: Record<string, unknown>;
 }
+/** The experience became visible to the user. */
+export interface ExperienceImpressed {
+    readonly type: 'impressed';
+}
+/** The user interacted with an actionable element. */
+export interface ExperienceClicked {
+    readonly type: 'clicked';
+    readonly elementId?: string;
+}
+/** The experience was dismissed — by the user or programmatically. */
+export interface ExperienceDismissed {
+    readonly type: 'dismissed';
+}
+/** Discriminated union of all experience event types. */
+export type DigiaExperienceEvent = ExperienceImpressed | ExperienceClicked | ExperienceDismissed;
 /**
  * Delegate passed by the Digia SDK to each registered plugin via setup().
  *
@@ -33,6 +48,12 @@ export interface DigiaPlugin {
     readonly identifier: string;
     /** Called by Digia.register() — do not call manually. */
     setup(delegate: DigiaDelegate): void;
+    /**
+     * Called by the Digia SDK when the overlay fires a lifecycle event
+     * (impressed / clicked / dismissed). Plugins use this to report
+     * analytics back to their CEP platform.
+     */
+    notifyEvent(event: DigiaExperienceEvent, payload: InAppPayload): void;
     /** Called by Digia.setCurrentScreen() — do not call manually. */
     forwardScreen(name: string): void;
     /** Called by Digia.unregister() or when tearing down the app. */

package/lib/typescript/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC1B,kEAAkE;IAClE,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACjD,iDAAiD;IACjD,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACnD;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,KAAK,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,iEAAiE;IACjE,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,iEAAiE;IACjE,QAAQ,IAAI,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAC3C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAID,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC9B;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC9B;AAED,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAC1B,mBAAmB,GACnB,iBAAiB,GACjB,mBAAmB,CAAC;AAE1B;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC1B,kEAAkE;IAClE,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACjD,iDAAiD;IACjD,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACnD;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,KAAK,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACtE,iEAAiE;IACjE,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,iEAAiE;IACjE,QAAQ,IAAI,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IACvC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAC3C"}

package/package.json

@@ -1,19 +1,12 @@
 {
   "name": "@digia-engage/core",
-  "version": "1.0.0-beta.4",
+  "version": "1.0.0-beta.6",
   "description": "React Native bridge for Digia Engage – renders native Android Compose UI inside React Native apps",
-  "main": "lib/commonjs/index",
-  "module": "lib/module/index",
-  "types": "lib/typescript/index.d.ts",
-  "react-native": "src/index",
-  "source": "src/index",
-  "exports": {
-    ".": {
-      "import": "./lib/module/index.js",
-      "require": "./lib/commonjs/index.js",
-      "types": "./lib/typescript/index.d.ts"
-    }
-  },
+  "main": "src/index.ts",
+  "module": "src/index.ts",
+  "types": "src/index.ts",
+  "react-native": "src/index.ts",
+  "source": "src/index.ts",
   "files": [
     "src",
     "lib",
@@ -31,7 +24,7 @@
   ],
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "lint": "eslint \"src/**/*.{js,ts,tsx}\"",
     "build": "bob build",
     "prepare": "bob build"
   },
@@ -50,10 +43,7 @@
   },
   "author": "Digia Technology Private Limited",
   "license": "MIT",
-  "peerDependencies": {
-    "react": "*",
-    "react-native": "*"
-  },
+  "peerDependencies": {},
   "devDependencies": {
     "@react-native/eslint-config": "^0.73.0",
     "@types/react": "^18.2.0",

package/src/Digia.ts

@@ -15,14 +15,25 @@
  * ```
  */
 
+import { DeviceEventEmitter } from 'react-native';
 import { nativeDigiaModule } from './NativeDigiaEngage';
-import type { DigiaConfig, DigiaDelegate, DigiaPlugin, InAppPayload } from './types';
+import type {
+    DigiaConfig,
+    DigiaDelegate,
+    DigiaExperienceEvent,
+    DigiaPlugin,
+    InAppPayload,
+} from './types';
 
 class DigiaClass implements DigiaDelegate {
     private readonly _plugins = new Map<string, DigiaPlugin>();
     // Tracks whether the native bridge plugin (RNEventBridgePlugin) has been
     // wired to the native SDK. Done once on the first Digia.register() call.
     private _nativeBridgeWired = false;
+    // Cache of triggered payloads keyed by campaign ID, used to reconstruct
+    // the full InAppPayload when overlay lifecycle events arrive from native.
+    private readonly _activePayloads = new Map<string, InAppPayload>();
+    private _engageSubscription: { remove(): void } | null = null;
 
     /**
      * Initialise the Digia Engage SDK.
@@ -59,6 +70,7 @@ class DigiaClass implements DigiaDelegate {
         // so the delegate is ready when JS campaigns start flowing.
         if (!this._nativeBridgeWired) {
             nativeDigiaModule.registerBridge();
+            this._startEngageListener();
             this._nativeBridgeWired = true;
         }
         plugin.setup(this);
@@ -87,18 +99,65 @@ class DigiaClass implements DigiaDelegate {
         this._plugins.forEach((plugin) => plugin.forwardScreen(name));
     }
 
+
     // ── DigiaDelegate ────────────────────────────────────────────────────────
     // Mirrors DigiaCEPDelegate on Android.
     // Forwards to the native DigiaCEPDelegate via the bridge.
 
     onCampaignTriggered(payload: InAppPayload): void {
+        this._activePayloads.set(payload.id, payload);
         nativeDigiaModule.triggerCampaign(payload.id, payload.content, payload.cepContext);
     }
 
     onCampaignInvalidated(campaignId: string): void {
+        this._activePayloads.delete(campaignId);
         nativeDigiaModule.invalidateCampaign(campaignId);
     }
 
+    // ── Overlay event forwarding ─────────────────────────────────────────────
+
+    /**
+     * Subscribes to `digiaOverlayEvent` emitted by the native
+     * RNEventBridgePlugin when the Compose overlay fires a lifecycle event
+     * (impressed / clicked / dismissed).
+     *
+     * Each event is forwarded to every registered plugin's notifyEvent() so
+     * that CEP plugins (e.g. WebEngagePlugin) can report analytics.
+     */
+    private _startEngageListener(): void {
+        if (this._engageSubscription) return;
+        this._engageSubscription = DeviceEventEmitter.addListener(
+            'digiaEngageEvent',
+            (data: { campaignId: string; type: string; elementId?: string }) =>
+                this._forwardExperienceEvent(data),
+        );
+    }
+
+    private _forwardExperienceEvent(
+        data: { campaignId: string; type: string; elementId?: string },
+    ): void {
+        const payload = this._activePayloads.get(data.campaignId);
+        if (!payload) return;
+
+        let event: DigiaExperienceEvent;
+        switch (data.type) {
+            case 'impressed':
+                event = { type: 'impressed' };
+                break;
+            case 'clicked':
+                event = { type: 'clicked', elementId: data.elementId };
+                break;
+            case 'dismissed':
+                event = { type: 'dismissed' };
+                this._activePayloads.delete(data.campaignId);
+                break;
+            default:
+                return;
+        }
+
+        this._plugins.forEach((plugin) => plugin.notifyEvent(event, payload));
+    }
+
 }
 
 export const Digia = new DigiaClass();

package/src/DigiaHostView.tsx

@@ -1,34 +1,8 @@
 /**
  * DigiaHostView
  *
- * A transparent React Native view that attaches the Digia Android Compose
- * overlay layer (dialogs, bottom sheets) on top of your app's content.
- *
- * ─── Usage ───────────────────────────────────────────────────────────────────
- * Place `<DigiaHostView>` at the **root** of your component tree so that
- * Digia dialogs and bottom sheets can stack on top of all your content.
- *
- * ```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 style={StyleSheet.absoluteFill} />
- *       {/ * your navigation / app content here * /}
- *     </View>
- *   );
- * }
- *
- * const styles = StyleSheet.create({ root: { flex: 1 } });
- * ```
- *
- * On Android this mounts a Jetpack Compose `DigiaHost` composable that
- * manages dialog + bottom-sheet presentation triggered by CEP plugins.
- * On iOS the view is a transparent no-op until iOS support is implemented.
- * ─────────────────────────────────────────────────────────────────────────────
+ * Transparent full-screen overlay that hosts Digia dialogs and bottom sheets.
+ * Place at the root of your component tree so overlays stack above all content.
  */
 
 import React from 'react';
@@ -44,40 +18,25 @@ interface DigiaHostViewProps {
     style?: StyleProp<ViewStyle>;
 }
 
-// requireNativeComponent expects a plain ViewStyle, not StyleProp.
 interface NativeDigiaHostViewProps {
     style?: ViewStyle;
+    pointerEvents?: 'auto' | 'none' | 'box-none' | 'box-only';
 }
 
-// Fabric (New Architecture) resolves view configs lazily — no UIManager
-// guard needed. requireNativeComponent is called unconditionally on Android.
 const NativeDigiaHostView =
-    Platform.OS === 'android'
+    Platform.OS === 'android' || Platform.OS === 'ios'
         ? requireNativeComponent<NativeDigiaHostViewProps>('DigiaHostView')
         : null;
 
-// ── DigiaHostView ─────────────────────────────────────────────────────────────
-
 export function DigiaHostView({ style }: DigiaHostViewProps) {
-    if (Platform.OS === 'android' && NativeDigiaHostView) {
-        // The native Compose DigiaHost renders dialogs / bottom sheets that
-        // float above the view hierarchy on their own — the host view only
-        // needs to be mounted in the tree, not take up any screen space.
+    if ((Platform.OS === 'android' || Platform.OS === 'ios') && NativeDigiaHostView) {
         return (
             <NativeDigiaHostView
-                style={StyleSheet.flatten([styles.host, style])}
+                pointerEvents="none"
+                style={StyleSheet.flatten([StyleSheet.absoluteFillObject, style])}
             />
         );
     }
 
-    // iOS / other platforms: no-op, nothing to mount.
     return null;
 }
-
-const styles = StyleSheet.create({
-    host: {
-        width: 0,
-        height: 0,
-        overflow: 'hidden',
-    },
-});

package/src/DigiaSlotView.tsx

@@ -1,79 +1,72 @@
 /**
  * DigiaSlotView
  *
- * A React Native view that renders inline campaign content (banners, cards,
- * widgets) at a specific placement position inside your screen layout.
- *
- * On Android this mounts a Jetpack Compose `DigiaSlot` composable that
- * observes the slot payload for the given placement key and renders the
- * matching campaign component. On iOS it is a transparent no-op.
- *
- * ─── Usage ───────────────────────────────────────────────────────────────────
- * ```tsx
- * import { DigiaSlotView } from '@digia/engage-react-native';
- *
- * // Fixed height (you control the space)
- * <DigiaSlotView
- *   placementKey="hero_banner"
- *   style={{ width: '100%', height: 200 }}
- * />
- *
- * // Inside a scroll view
- * <ScrollView>
- *   <ProductList />
- *   <DigiaSlotView
- *     placementKey="pdp_mid_banner"
- *     style={{ width: '100%', height: 120 }}
- *   />
- *   <RelatedProducts />
- * </ScrollView>
- * ```
- *
- * The `placementKey` must match the key the marketer selects when creating
- * inline content on the Digia dashboard. The view collapses to nothing when
- * no campaign is active for that key.
- *
- * ─── Sizing ──────────────────────────────────────────────────────────────────
- * React Native's layout system controls the dimensions of this view.
- * Provide an explicit `height` (or flex) via the `style` prop so that the
- * native Compose layer has space to render. When no campaign is active the
- * Compose `DigiaSlot` renders nothing inside that space.
- * ─────────────────────────────────────────────────────────────────────────────
+ * Renders inline campaign content at a placement position.
+ * Auto-sizes to match native content height via `onContentSizeChange`;
+ * pass an explicit `height` in `style` to fix the size instead.
  */
 
-import React from 'react';
+import React, { useCallback, useState } from 'react';
 import {
     Platform,
+    StyleSheet,
     requireNativeComponent,
     type StyleProp,
     type ViewStyle,
 } from 'react-native';
 
 interface DigiaSlotViewProps {
-    /** Placement key that links this view to a Digia dashboard slot. */
     placementKey: string;
     style?: StyleProp<ViewStyle>;
 }
 
-// Fabric (New Architecture) resolves view configs lazily — no UIManager
-// guard needed. requireNativeComponent is called unconditionally on Android.
+interface NativeDigiaSlotViewProps extends DigiaSlotViewProps {
+    onContentSizeChange?: (event: { nativeEvent: { height: number } }) => void;
+    collapsable?: boolean;
+}
+
 const NativeDigiaSlotView =
-    Platform.OS === 'android'
-        ? requireNativeComponent<DigiaSlotViewProps>('DigiaSlotView')
+    Platform.OS === 'android' || Platform.OS === 'ios'
+        ? requireNativeComponent<NativeDigiaSlotViewProps>('DigiaSlotView')
         : null;
 
-// ── DigiaSlotView ─────────────────────────────────────────────────────────────
-
 export function DigiaSlotView({ placementKey, style }: DigiaSlotViewProps) {
-    if (Platform.OS === 'android' && NativeDigiaSlotView) {
+    const [contentHeight, setContentHeight] = useState(0);
+
+    const onContentSizeChange = useCallback(
+        (event: { nativeEvent: { height: number } }) => {
+            const h = event.nativeEvent.height ?? 0;
+            setContentHeight(Math.max(0, h));
+        },
+        [],
+    );
+
+    if ((Platform.OS === 'android' || Platform.OS === 'ios') && NativeDigiaSlotView) {
+        const flatStyle = StyleSheet.flatten(style) || {};
+        const hasExplicitHeight = flatStyle.height !== undefined;
+
+        if (hasExplicitHeight) {
+            return (
+                <NativeDigiaSlotView
+                    placementKey={placementKey}
+                    style={[{ width: '100%' }, style]}
+                    {...(Platform.OS === 'android' ? { collapsable: false } : {})}
+                />
+            );
+        }
+
+        // 1dp bootstrap ensures a real layout pass before any campaign arrives.
+        const bootstrapHeight = Math.max(contentHeight, 1);
+
         return (
             <NativeDigiaSlotView
                 placementKey={placementKey}
-                style={style}
+                style={[{ width: '100%', height: bootstrapHeight }, style]}
+                onContentSizeChange={onContentSizeChange}
+                {...(Platform.OS === 'android' ? { collapsable: false } : {})}
             />
         );
     }
 
-    // iOS / other platforms: not yet implemented — render nothing.
     return null;
 }

package/src/NativeDigiaEngage.ts

@@ -50,6 +50,7 @@ export interface Spec extends TurboModule {
 
     /** Invalidate / dismiss a campaign by its ID. */
     invalidateCampaign(campaignId: string): void;
+
 }
 
 // Try TurboModuleRegistry first (New Architecture / JSI).

package/src/index.ts

@@ -12,4 +12,4 @@
 export { Digia } from './Digia';
 export { DigiaHostView } from './DigiaHostView';
 export { DigiaSlotView } from './DigiaSlotView';
-export type { DigiaConfig, DigiaDelegate, DigiaPlugin, InAppPayload } from './types';
+export type { DigiaConfig, DigiaDelegate, DigiaExperienceEvent, DigiaPlugin, InAppPayload } from './types';

package/src/types.ts

@@ -12,6 +12,30 @@ export interface InAppPayload {
     cepContext: Record<string, unknown>;
 }
 
+// ─── Experience events ────────────────────────────────────────────────────────
+
+/** The experience became visible to the user. */
+export interface ExperienceImpressed {
+    readonly type: 'impressed';
+}
+
+/** The user interacted with an actionable element. */
+export interface ExperienceClicked {
+    readonly type: 'clicked';
+    readonly elementId?: string;
+}
+
+/** The experience was dismissed — by the user or programmatically. */
+export interface ExperienceDismissed {
+    readonly type: 'dismissed';
+}
+
+/** Discriminated union of all experience event types. */
+export type DigiaExperienceEvent =
+    | ExperienceImpressed
+    | ExperienceClicked
+    | ExperienceDismissed;
+
 /**
  * Delegate passed by the Digia SDK to each registered plugin via setup().
  *
@@ -35,6 +59,12 @@ export interface DigiaPlugin {
     readonly identifier: string;
     /** Called by Digia.register() — do not call manually. */
     setup(delegate: DigiaDelegate): void;
+    /**
+     * Called by the Digia SDK when the overlay fires a lifecycle event
+     * (impressed / clicked / dismissed). Plugins use this to report
+     * analytics back to their CEP platform.
+     */
+    notifyEvent(event: DigiaExperienceEvent, payload: InAppPayload): void;
     /** Called by Digia.setCurrentScreen() — do not call manually. */
     forwardScreen(name: string): void;
     /** Called by Digia.unregister() or when tearing down the app. */