@digia-engage/core 1.0.0-beta.1

package/lib/typescript/Digia.d.ts

@@ -0,0 +1,62 @@
+/**
+ * High-level Digia Engage SDK wrapper.
+ *
+ * Usage
+ * ──────
+ * ```ts
+ * import { Digia } from '@digia/engage-react-native';
+ *
+ * // In your App entry point (e.g. App.tsx):
+ * await Digia.initialize({ apiKey: 'YOUR_API_KEY' });
+ *
+ * // Whenever your navigation screen changes:
+ * Digia.setCurrentScreen('Home');
+ *
+ * ```
+ */
+import type { DigiaConfig, DigiaDelegate, DigiaPlugin, InAppPayload } from './types';
+declare class DigiaClass implements DigiaDelegate {
+    private readonly _plugins;
+    private _nativeBridgeWired;
+    /**
+     * Initialise the Digia Engage SDK.
+     *
+     * Must be called once before anything else – ideally as early as possible
+     * in your application lifecycle (start of `App.tsx`).
+     */
+    initialize(config: DigiaConfig): Promise<void>;
+    /**
+     * Register a CEP plugin with the Digia SDK.
+     *
+     * On the first call this also wires the internal RNEventBridgePlugin with
+     * the native Android SDK so it holds the DigiaCEPDelegate reference needed
+     * to show overlays and emit lifecycle events back to JS. This is transparent
+     * bridge plumbing — you never interact with RNEventBridgePlugin directly.
+     *
+     * ```ts
+     * import { DigiaMoEngagePlugin } from '@digia/moengage-plugin';
+     *
+     * await Digia.initialize({ apiKey: 'YOUR_KEY' });
+     * Digia.register(new DigiaMoEngagePlugin({ moEngage: MoEngage }));
+     * ```
+     */
+    register(plugin: DigiaPlugin): void;
+    /**
+     * Unregister a previously registered plugin.
+     * Calls plugin.teardown() internally.
+     */
+    unregister(pluginOrId: DigiaPlugin | string): void;
+    /**
+     * Notify the SDK of the currently active screen name.
+     *
+     * Wire this up to your navigation library's screen-change listener
+     * (e.g. React Navigation focus events or `useNavigationContainerRef`).
+     * All registered plugins will have forwardScreen() called automatically.
+     */
+    setCurrentScreen(name: string): void;
+    onCampaignTriggered(payload: InAppPayload): void;
+    onCampaignInvalidated(campaignId: string): void;
+}
+export declare const Digia: DigiaClass;
+export {};
+//# sourceMappingURL=Digia.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Digia.d.ts","sourceRoot":"","sources":["../../src/Digia.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAErF,cAAM,UAAW,YAAW,aAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAG3D,OAAO,CAAC,kBAAkB,CAAS;IAEnC;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpD;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAcnC;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAMlD;;;;;;OAMG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IASpC,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIhD,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAIlD;AAED,eAAO,MAAM,KAAK,YAAmB,CAAC"}

package/lib/typescript/DigiaHostView.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 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.
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+import React from 'react';
+import { type StyleProp, type ViewStyle } from 'react-native';
+interface DigiaHostViewProps {
+    style?: StyleProp<ViewStyle>;
+}
+export declare function DigiaHostView({ style }: DigiaHostViewProps): React.JSX.Element | null;
+export {};
+//# sourceMappingURL=DigiaHostView.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DigiaHostView.d.ts","sourceRoot":"","sources":["../../src/DigiaHostView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAIH,KAAK,SAAS,EACd,KAAK,SAAS,EACjB,MAAM,cAAc,CAAC;AAEtB,UAAU,kBAAkB;IACxB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAChC;AAgBD,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,EAAE,kBAAkB,4BAc1D"}

package/lib/typescript/DigiaSlotView.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 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.
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+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>;
+}
+export declare function DigiaSlotView({ placementKey, style }: DigiaSlotViewProps): React.JSX.Element | null;
+export {};
+//# sourceMappingURL=DigiaSlotView.d.ts.map

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

@@ -0,0 +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"}

package/lib/typescript/NativeDigiaModule.d.ts

@@ -0,0 +1,45 @@
+/**
+ * NativeDigiaModule
+ *
+ * Low-level TurboModule binding to the native Digia Engage module.
+ *
+ * The module is resolved lazily on first use (not at import time) so that
+ * module evaluation before native initialisation doesn't throw.
+ * Resolution order:
+ *   1. TurboModuleRegistry.get()   — New Architecture / JSI path
+ *   2. NativeModules               — bridge interop layer (RN 0.73+ New Arch
+ *                                    with isTurboModule: false in ReactModuleInfo)
+ *   3. null                        — non-Android environments; methods no-op
+ *
+ * Prefer using the high-level `Digia` singleton from `index.ts`.
+ */
+import type { TurboModule } from 'react-native';
+/**
+ * Codegen spec — drives Android/iOS TurboModule generation.
+ *
+ * Rules for codegen compatibility:
+ * • File must be named `Native*.ts` (already satisfied).
+ * • All method parameter types must be scalar, Promise, Object, or Array.
+ * • `Object` maps to ReadableMap on Android, NSDictionary on iOS.
+ */
+export interface Spec extends TurboModule {
+    /** Initialise the SDK. Call once before anything else. */
+    initialize(apiKey: string, environment: string, logLevel: string): Promise<void>;
+    /**
+     * Wire the internal RNEventBridgePlugin with the native SDK.
+     * Called automatically by Digia.register() on first plugin registration.
+     * Never call this directly.
+     */
+    registerBridge(): void;
+    /** Notify the SDK of the currently visible screen. */
+    setCurrentScreen(name: string): void;
+    /**
+     * Forward a campaign payload from a JS CEP plugin into the native
+     * rendering engine via the DigiaCEPDelegate.
+     */
+    triggerCampaign(id: string, content: Object, cepContext: Object): void;
+    /** Invalidate / dismiss a campaign by its ID. */
+    invalidateCampaign(campaignId: string): void;
+}
+export declare const nativeDigiaModule: Spec;
+//# sourceMappingURL=NativeDigiaModule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NativeDigiaModule.d.ts","sourceRoot":"","sources":["../../src/NativeDigiaModule.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"}

package/lib/typescript/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @digia/engage-react-native
+ *
+ * React Native bridge for the Digia Engage SDK.
+ *
+ * The SDK surfaces Digia Compose UI inside React Native via:
+ *   • `Digia`          – SDK lifecycle (initialize, setCurrentScreen)
+ *   • `DigiaHostView`  – Transparent native overlay view that hosts Compose dialogs/
+ *                        bottom-sheets managed by the Digia CEP engine.
+ */
+export { Digia } from './Digia';
+export { DigiaHostView } from './DigiaHostView';
+export { DigiaSlotView } from './DigiaSlotView';
+export type { DigiaConfig, DigiaDelegate, DigiaPlugin, InAppPayload } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/lib/typescript/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Payload delivered to the Digia rendering engine for a CEP campaign.
+ *
+ * Mirrors InAppPayload on Android / Flutter.
+ */
+export interface InAppPayload {
+    /** Unique campaign ID from the CEP platform. */
+    id: string;
+    /** Marketer-authored content map (JSON-serialisable). */
+    content: Record<string, unknown>;
+    /** CEP-platform metadata, e.g. { campaignId, campaignName }. */
+    cepContext: Record<string, unknown>;
+}
+/**
+ * Delegate passed by the Digia SDK to each registered plugin via setup().
+ *
+ * Mirrors DigiaCEPDelegate on Android / Flutter.
+ * Call these instead of touching Digia directly from inside a plugin.
+ */
+export interface DigiaDelegate {
+    /** Deliver a campaign payload into the Digia rendering engine. */
+    onCampaignTriggered(payload: InAppPayload): void;
+    /** Invalidate / dismiss a campaign by its ID. */
+    onCampaignInvalidated(campaignId: string): void;
+}
+/**
+ * Interface that every Digia CEP plugin must implement.
+ *
+ * Mirrors DigiaCEPPlugin on Android / Flutter.
+ * Register plugins via `Digia.register(plugin)` — do NOT call setup() directly.
+ */
+export interface DigiaPlugin {
+    readonly identifier: string;
+    /** Called by Digia.register() — do not call manually. */
+    setup(delegate: DigiaDelegate): void;
+    /** Called by Digia.setCurrentScreen() — do not call manually. */
+    forwardScreen(name: string): void;
+    /** Called by Digia.unregister() or when tearing down the app. */
+    teardown(): void;
+}
+/**
+ * Configuration for initialising the Digia Engage SDK.
+ */
+export interface DigiaConfig {
+    /** The API key provided by Digia. */
+    apiKey: string;
+    /**
+     * The target environment.
+     * @default 'production'
+     */
+    environment?: 'production' | 'sandbox';
+    /**
+     * Log verbosity.
+     * @default 'error'
+     */
+    logLevel?: 'none' | 'error' | 'verbose';
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@digia-engage/core",
+  "version": "1.0.0-beta.1",
+  "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"
+    }
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "*.podspec",
+    "!lib/typescript/example",
+    "!android/.gradle",
+    "!android/build",
+    "!android/example",
+    "!ios/build",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "build": "bob build",
+    "prepare": "bob build"
+  },
+  "keywords": [
+    "react-native",
+    "digia",
+    "engage",
+    "compose",
+    "android",
+    "native"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Digia-Technology-Private-Limited/digia_engage.git",
+    "directory": "react-native"
+  },
+  "author": "Digia Technology Private Limited",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "devDependencies": {
+    "@react-native/eslint-config": "^0.73.0",
+    "@types/react": "^18.2.0",
+    "@types/react-native": "^0.73.0",
+    "eslint": "^8.51.0",
+    "react": "18.2.0",
+    "react-native": "0.73.0",
+    "react-native-builder-bob": "^0.23.0",
+    "typescript": "^5.2.0"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "DigiaEngageSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.digia.engage.rn"
+    }
+  }
+}

package/src/Digia.ts

@@ -0,0 +1,104 @@
+/**
+ * High-level Digia Engage SDK wrapper.
+ *
+ * Usage
+ * ──────
+ * ```ts
+ * import { Digia } from '@digia/engage-react-native';
+ *
+ * // In your App entry point (e.g. App.tsx):
+ * await Digia.initialize({ apiKey: 'YOUR_API_KEY' });
+ *
+ * // Whenever your navigation screen changes:
+ * Digia.setCurrentScreen('Home');
+ *
+ * ```
+ */
+
+import { nativeDigiaModule } from './NativeDigiaModule';
+import type { DigiaConfig, DigiaDelegate, 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;
+
+    /**
+     * Initialise the Digia Engage SDK.
+     *
+     * Must be called once before anything else – ideally as early as possible
+     * in your application lifecycle (start of `App.tsx`).
+     */
+    async initialize(config: DigiaConfig): Promise<void> {
+        const environment = config.environment ?? 'production';
+        const logLevel = config.logLevel ?? 'error';
+        await nativeDigiaModule.initialize(config.apiKey, environment, logLevel);
+    }
+
+    /**
+     * Register a CEP plugin with the Digia SDK.
+     *
+     * On the first call this also wires the internal RNEventBridgePlugin with
+     * the native Android SDK so it holds the DigiaCEPDelegate reference needed
+     * to show overlays and emit lifecycle events back to JS. This is transparent
+     * bridge plumbing — you never interact with RNEventBridgePlugin directly.
+     *
+     * ```ts
+     * import { DigiaMoEngagePlugin } from '@digia/moengage-plugin';
+     *
+     * await Digia.initialize({ apiKey: 'YOUR_KEY' });
+     * Digia.register(new DigiaMoEngagePlugin({ moEngage: MoEngage }));
+     * ```
+     */
+    register(plugin: DigiaPlugin): void {
+        if (this._plugins.has(plugin.identifier)) {
+            this._plugins.get(plugin.identifier)!.teardown();
+        }
+        // Wire the native bridge plugin once, before the first plugin's setup()
+        // so the delegate is ready when JS campaigns start flowing.
+        if (!this._nativeBridgeWired) {
+            nativeDigiaModule.registerBridge();
+            this._nativeBridgeWired = true;
+        }
+        plugin.setup(this);
+        this._plugins.set(plugin.identifier, plugin);
+    }
+
+    /**
+     * Unregister a previously registered plugin.
+     * Calls plugin.teardown() internally.
+     */
+    unregister(pluginOrId: DigiaPlugin | string): void {
+        const id = typeof pluginOrId === 'string' ? pluginOrId : pluginOrId.identifier;
+        this._plugins.get(id)?.teardown();
+        this._plugins.delete(id);
+    }
+
+    /**
+     * Notify the SDK of the currently active screen name.
+     *
+     * Wire this up to your navigation library's screen-change listener
+     * (e.g. React Navigation focus events or `useNavigationContainerRef`).
+     * All registered plugins will have forwardScreen() called automatically.
+     */
+    setCurrentScreen(name: string): void {
+        nativeDigiaModule.setCurrentScreen(name);
+        this._plugins.forEach((plugin) => plugin.forwardScreen(name));
+    }
+
+    // ── DigiaDelegate ────────────────────────────────────────────────────────
+    // Mirrors DigiaCEPDelegate on Android.
+    // Forwards to the native DigiaCEPDelegate via the bridge.
+
+    onCampaignTriggered(payload: InAppPayload): void {
+        nativeDigiaModule.triggerCampaign(payload.id, payload.content, payload.cepContext);
+    }
+
+    onCampaignInvalidated(campaignId: string): void {
+        nativeDigiaModule.invalidateCampaign(campaignId);
+    }
+
+}
+
+export const Digia = new DigiaClass();

package/src/DigiaHostView.tsx

@@ -0,0 +1,83 @@
+/**
+ * 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.
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+
+import React from 'react';
+import {
+    Platform,
+    StyleSheet,
+    requireNativeComponent,
+    type StyleProp,
+    type ViewStyle,
+} from 'react-native';
+
+interface DigiaHostViewProps {
+    style?: StyleProp<ViewStyle>;
+}
+
+// requireNativeComponent expects a plain ViewStyle, not StyleProp.
+interface NativeDigiaHostViewProps {
+    style?: ViewStyle;
+}
+
+// Fabric (New Architecture) resolves view configs lazily — no UIManager
+// guard needed. requireNativeComponent is called unconditionally on Android.
+const NativeDigiaHostView =
+    Platform.OS === 'android'
+        ? 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.
+        return (
+            <NativeDigiaHostView
+                style={StyleSheet.flatten([styles.host, 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

@@ -0,0 +1,79 @@
+/**
+ * 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.
+ * ─────────────────────────────────────────────────────────────────────────────
+ */
+
+import React from 'react';
+import {
+    Platform,
+    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.
+const NativeDigiaSlotView =
+    Platform.OS === 'android'
+        ? requireNativeComponent<DigiaSlotViewProps>('DigiaSlotView')
+        : null;
+
+// ── DigiaSlotView ─────────────────────────────────────────────────────────────
+
+export function DigiaSlotView({ placementKey, style }: DigiaSlotViewProps) {
+    if (Platform.OS === 'android' && NativeDigiaSlotView) {
+        return (
+            <NativeDigiaSlotView
+                placementKey={placementKey}
+                style={style}
+            />
+        );
+    }
+
+    // iOS / other platforms: not yet implemented — render nothing.
+    return null;
+}