@digia-engage/core 2.3.2 → 2.4.0

package/lib/typescript/types.d.ts

@@ -1,15 +1,19 @@
 /**
- * Payload delivered to the Digia rendering engine for a CEP campaign.
+ * The translation contract between a CEP plugin and Digia's rendering engine.
  *
- * Mirrors InAppPayload on Android / Flutter.
+ * Plugin authors map their CEP's native callback into this struct.
+ * Mirrors CEPTriggerPayload on Android / Flutter — Digia core never imports
+ * CleverTap, MoEngage, or WebEngage types directly.
  */
-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>;
+export interface CEPTriggerPayload {
+    /** The CEP's own identifier for this campaign instance. Opaque to Digia — passed through for analytics correlation. */
+    cepCampaignId: string;
+    /** Additional metadata the CEP passes through (UTM params, user segment, CEP-specific tracking fields). Forwarded as-is in ExperienceEvents. */
+    cepMetadata: Record<string, unknown>;
+    /** The coupling key linking this CEP campaign to a Digia campaign. Used to look up the matching campaign in the store. */
+    campaignKey: string;
+    /** Optional runtime variables to interpolate into the campaign config. Keys must match variable placeholders in the Digia dashboard. */
+    variables?: Record<string, string>;
 }
 export type CampaignType = 'nudge' | 'guide' | 'inline' | 'survey';
 /** The experience became visible to the user. */
@@ -98,7 +102,7 @@ export type GuideLifecycleEvent = {
  */
 export interface DigiaDelegate {
     /** Deliver a campaign payload into the Digia rendering engine. */
-    onCampaignTriggered(payload: InAppPayload): void | Promise<void>;
+    onCampaignTriggered(payload: CEPTriggerPayload): void | Promise<void>;
     /** Invalidate / dismiss a campaign by its ID. */
     onCampaignInvalidated(campaignId: string): void;
 }
@@ -117,7 +121,7 @@ export interface DigiaPlugin {
      * (impressed / clicked / dismissed). Plugins use this to report
      * analytics back to their CEP platform.
      */
-    notifyEvent(event: DigiaExperienceEvent, payload: InAppPayload): void;
+    notifyEvent(event: DigiaExperienceEvent, payload: CEPTriggerPayload): void;
     /**
      * Called by the Digia SDK to record a named analytics event with properties.
      * Implement this to forward Digia lifecycle events (e.g. "Digia Experience Viewed")
@@ -193,8 +197,8 @@ export interface FrequencyEvalResult {
  * Configuration for initialising the Digia Engage SDK.
  */
 export interface DigiaConfig {
-    /** The Engage project ID — sent as x-digia-project-id on all SDK requests. */
-    projectId: string;
+    /** The Engage API key — sent as x-digia-project-id on all SDK requests. */
+    apiKey: string;
     /**
      * Base URL for the Digia API.
      * Defaults to the production API root, or the Engage sandbox root when

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digia-engage/core",
-  "version": "2.3.2",
+  "version": "2.4.0",
   "description": "React Native bridge for Digia Engage – renders native Android Compose UI inside React Native apps",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -45,18 +45,17 @@
   "author": "Digia Technology Private Limited",
   "license": "BUSL-1.1",
   "dependencies": {
+    "@floating-ui/core": "^1.0.0",
     "@react-native-async-storage/async-storage": "^2.1.2",
-    "react-native-uuid": "^2.0.3",
-    "@edwardloopez/react-native-coachmark": "^0.5.3",
-    "@floating-ui/core": "^1.0.0"
+    "react-native-svg": "^15.15.5",
+    "react-native-uuid": "^2.0.3"
   },
   "devDependencies": {
-    "@react-native/eslint-config": "^0.73.0",
-    "@types/react": "^18.2.0",
-    "@types/react-native": "^0.73.0",
+    "@react-native/eslint-config": "^0.83.0",
+    "@types/react": "^19.0.0",
     "eslint": "^8.51.0",
-    "react": "18.2.0",
-    "react-native": "0.73.0",
+    "react": "19.2.0",
+    "react-native": "0.83.0",
     "react-native-builder-bob": "^0.23.0",
     "typescript": "^5.2.0"
   },

package/src/Digia.ts

@@ -7,7 +7,7 @@
  * import { Digia } from '@digia/engage-react-native';
  *
  * // In your App entry point (e.g. App.tsx):
- * await Digia.initialize({ projectId: 'YOUR_PROJECT_ID' });
+ * await Digia.initialize({ apiKey: 'YOUR_API_KEY' });
  *
  * // Whenever your navigation screen changes:
  * Digia.setCurrentScreen('Home');
@@ -19,6 +19,7 @@ import { DeviceEventEmitter } from 'react-native';
 import { nativeDigiaModule } from './NativeDigiaEngage';
 import { digiaHealthReporter, HealthEventType } from './DigiaHealthReporter';
 import { digiaGuideController } from './DigiaGuideController';
+import { digiaAnchorRegistry } from './digiaAnchorRegistry';
 import { parseVariableMap } from './interpolate';
 import { digiaActionHandler } from './actionHandler';
 import uuid from 'react-native-uuid';
@@ -26,6 +27,7 @@ import { frequencyStore } from './frequencyStore';
 import { evaluate, hasPolicy, isSessionPolicy } from './frequencyEvaluator';
 import type {
     ActionContext,
+    CEPTriggerPayload,
     CampaignType,
     DigiaConfig,
     DigiaDelegate,
@@ -34,7 +36,6 @@ import type {
     FrequencyPolicy,
     FrequencyState,
     GuideLifecycleEvent,
-    InAppPayload,
 } from './types';
 import type { TemplateConfig } from './templateTypes';
 
@@ -56,11 +57,11 @@ class DigiaClass implements DigiaDelegate {
     // 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>();
+    // Cache of triggered payloads keyed by cepCampaignId, used to reconstruct
+    // the full CEPTriggerPayload when overlay lifecycle events arrive from native.
+    private readonly _activePayloads = new Map<string, CEPTriggerPayload>();
     private _engageSubscription: { remove(): void } | null = null;
-    private _projectId = '';
+    private _apiKey = '';
     private _deviceId = '';
     private _apiBaseUrl = '';
     private _logLevel: DigiaConfig['logLevel'] = 'error';
@@ -78,11 +79,12 @@ class DigiaClass implements DigiaDelegate {
     async initialize(config: DigiaConfig): Promise<void> {
         const environment = config.environment ?? 'production';
         const logLevel = config.logLevel ?? 'error';
-        this._projectId = config.projectId;
+        this._apiKey = config.apiKey;
         this._apiBaseUrl = this._resolveApiBaseUrl(config);
         this._logLevel = logLevel;
         this._fontFamily = config.fontFamily?.trim() || undefined;
-        digiaHealthReporter.init(config.projectId, this._apiBaseUrl);
+        this._log(`Digia SDK initializing | apiKey=${config.apiKey.slice(0, 8)}… env=${environment}`);
+        digiaHealthReporter.init(config.apiKey, this._apiBaseUrl);
 
         digiaActionHandler.configure({
             onAction: config.onAction,
@@ -93,16 +95,16 @@ class DigiaClass implements DigiaDelegate {
         });
 
         try {
-            await nativeDigiaModule.initialize(config.projectId, environment, logLevel, config.baseUrl, config.fontFamily);
+            await nativeDigiaModule.initialize(config.apiKey, environment, logLevel, config.baseUrl, config.fontFamily);
         } catch (e) {
-            // Health-event reporting is currently disabled.
-            // digiaHealthReporter.report(HealthEventType.fetch_failed, { error_code: 0, platform: 'react_native' });
+            this._error(`Digia SDK native init failed: ${e instanceof Error ? e.message : String(e)}`);
             throw e;
         }
 
         this._deviceId = await this._loadOrCreateDeviceId();
-        await frequencyStore.checkProjectId(config.projectId);
+        await frequencyStore.checkApiKey(config.apiKey);
         await this._refreshCampaignStore();
+        this._log(`Digia SDK ready | campaigns=${this._campaignsByKey.size}`);
     }
 
     /**
@@ -116,13 +118,16 @@ class DigiaClass implements DigiaDelegate {
      * ```ts
      * import { DigiaMoEngagePlugin } from '@digia/moengage-plugin';
      *
-     * await Digia.initialize({ projectId: 'YOUR_PROJECT_ID' });
+     * await Digia.initialize({ apiKey: 'YOUR_API_KEY' });
      * Digia.register(new DigiaMoEngagePlugin({ moEngage: MoEngage }));
      * ```
      */
     register(plugin: DigiaPlugin): void {
         if (this._plugins.has(plugin.identifier)) {
+            this._log(`Plugin replaced: ${plugin.identifier}`);
             this._plugins.get(plugin.identifier)!.teardown();
+        } else {
+            this._log(`Plugin registered: ${plugin.identifier}`);
         }
         // Wire the native bridge plugin once, before the first plugin's setup()
         // so the delegate is ready when JS campaigns start flowing.
@@ -154,6 +159,7 @@ class DigiaClass implements DigiaDelegate {
      * All registered plugins will have forwardScreen() called automatically.
      */
     setCurrentScreen(name: string): void {
+        this._log(`Screen: ${name}`);
         this._currentScreen = name;
         nativeDigiaModule.setCurrentScreen(name);
         this._plugins.forEach((plugin) => plugin.forwardScreen(name));
@@ -169,6 +175,22 @@ class DigiaClass implements DigiaDelegate {
         this._registeredAnchorKeys.delete(anchorKey);
     }
 
+    /**
+     * Associate a known user ID with subsequent analytics events.
+     * Call after login; rotates the analytics session automatically.
+     */
+    setUserId(userId: string): void {
+        nativeDigiaModule.setUserId(userId);
+    }
+
+    /**
+     * Clear the user ID (e.g. on logout).
+     * Subsequent events are attributed to the anonymous ID and a new session.
+     */
+    clearUserId(): void {
+        nativeDigiaModule.clearUserId();
+    }
+
     /**
      * Global font family configured via {@link initialize}, or `undefined` when
      * none was set. Used by the JS-rendered guide overlays (tooltip/spotlight)
@@ -183,86 +205,101 @@ class DigiaClass implements DigiaDelegate {
     // Mirrors DigiaCEPDelegate on Android.
     // Forwards to the native DigiaCEPDelegate via the bridge.
 
-    async onCampaignTriggered(payload: InAppPayload): Promise<void> {
+    async onCampaignTriggered(payload: CEPTriggerPayload): Promise<void> {
         if (!this._nativeBridgeWired) {
-            digiaHealthReporter.report(HealthEventType.plugin_not_registered, { campaign_key: payload.id });
+            digiaHealthReporter.report(HealthEventType.plugin_not_registered, { campaign_key: payload.campaignKey });
         }
 
-        const campaignKey = this._extractCampaignKey(payload);
-        this._log(`onCampaignTriggered payloadId=${payload.id} extractedKey=${campaignKey} knownKeys=[${[...this._campaignsByKey.keys()].join(', ')}]`);
+        const { cepCampaignId, campaignKey, variables, cepMetadata } = payload;
+        this._log(`onCampaignTriggered cepCampaignId=${cepCampaignId} campaignKey=${campaignKey} knownKeys=[${[...this._campaignsByKey.keys()].join(', ')}]`);
 
-        if (campaignKey) {
-            const campaign = this._campaignsByKey.get(campaignKey);
-
-            if (campaign && hasPolicy(campaign.frequency)) {
-                const policy = campaign.frequency!;
-                const isSession = isSessionPolicy(policy);
-                const state = await this._getFrequencyState(campaignKey, isSession);
-                const result = evaluate(policy, state, Date.now());
-                if (!result.allow) {
-                    this._log(`frequency_capped campaign_key=${campaignKey} reason=${result.reason}`);
-                    return;
-                }
-            }
+        const campaign = this._campaignsByKey.get(campaignKey);
 
-            if (campaign?.campaign_type === 'inline' || campaign?.campaign_type === 'survey') {
-                this._log(`${campaign.campaign_type} campaign triggered campaign_key=${campaignKey}, forwarding to native`);
-                this._activePayloads.set(payload.id, payload);
-                if (campaign.campaign_type === 'inline') {
-                    this._emitSlotWidth(campaign);
-                }
-                nativeDigiaModule.triggerCampaign(payload.id, payload.content, payload.cepContext);
+        if (campaign && hasPolicy(campaign.frequency)) {
+            const policy = campaign.frequency!;
+            const isSession = isSessionPolicy(policy);
+            const state = await this._getFrequencyState(campaignKey, isSession);
+            const result = evaluate(policy, state, Date.now());
+            if (!result.allow) {
+                this._log(`frequency_capped campaign_key=${campaignKey} reason=${result.reason}`);
                 return;
             }
+        }
 
-            if (campaign?.campaign_type === 'guide') {
-                const config = this._parseTemplateConfig(campaign);
-                if (
-                    !config ||
-                    (config.templateType !== 'tooltip' && config.templateType !== 'spotlight') ||
-                    config.steps.length === 0
-                ) {
-                    digiaHealthReporter.report(HealthEventType.anchor_not_on_screen, {
-                        campaign_key: campaignKey,
-                        reason: 'guide_campaign_has_no_steps',
-                    });
-                    return;
-                }
+        // Synthesise the content map expected by the native bridge.
+        const bridgeContent: Record<string, unknown> = { digia_campaign_key: campaignKey };
+        if (variables) bridgeContent.variables = variables;
 
-                this._activePayloads.set(payload.id, payload);
-                const digiaId = campaign._id ?? campaign.id ?? campaignKey;
-                const mounted = digiaGuideController.start({
-                    payloadId: payload.id,
-                    campaignKey,
-                    campaignId: digiaId,
-                    variables: this._extractVariables(payload),
-                    config,
-                    onExperienceEvent: (event) => this._onGuideLifecycleEvent(event, payload.id, campaignKey, digiaId),
-                });
+        if (campaign?.campaign_type === 'inline' || campaign?.campaign_type === 'survey') {
+            this._log(`${campaign.campaign_type} campaign triggered campaign_key=${campaignKey}, forwarding to native`);
+            this._activePayloads.set(cepCampaignId, payload);
+            if (campaign.campaign_type === 'inline') {
+                this._emitSlotWidth(campaign);
+            }
+            nativeDigiaModule.triggerCampaign(cepCampaignId, bridgeContent, cepMetadata);
+            return;
+        }
 
-                this._log(`guide trigger campaign_key=${campaignKey} mounted=${mounted}`);
-                if (!mounted) {
-                    digiaHealthReporter.report(HealthEventType.host_not_mounted, {
-                        campaign_key: campaignKey,
-                        payload_id: payload.id,
-                    });
-                }
+        if (campaign?.campaign_type === 'guide') {
+            const config = this._parseTemplateConfig(campaign);
+            if (
+                !config ||
+                (config.templateType !== 'tooltip' && config.templateType !== 'spotlight') ||
+                config.steps.length === 0
+            ) {
+                digiaHealthReporter.report(HealthEventType.anchor_not_on_screen, {
+                    campaign_key: campaignKey,
+                    reason: 'guide_campaign_has_no_steps',
+                });
                 return;
             }
 
-            if (!campaign) {
-                this._log(`campaign_key_mismatch: no campaign found for key="${campaignKey}"`);
-                digiaHealthReporter.report(HealthEventType.campaign_key_mismatch, {
+            const firstAnchorKey = config.steps[0].anchorKey;
+            if (!digiaAnchorRegistry.isRegistered(firstAnchorKey)) {
+                // eslint-disable-next-line no-console
+                console.warn(`[Digia] campaign dropped — anchor_key "${firstAnchorKey}" is not registered on this screen (campaign_key=${campaignKey})`);
+                digiaHealthReporter.report(HealthEventType.anchor_not_on_screen, {
                     campaign_key: campaignKey,
-                    payload_id: payload.id,
-                    available_campaign_keys: [...this._campaignsByKey.keys()],
+                    reason: 'anchor_key_not_registered',
+                    anchor_key: firstAnchorKey,
                 });
                 return;
             }
+
+            this._activePayloads.set(cepCampaignId, payload);
+            const digiaId = campaign._id ?? campaign.id ?? campaignKey;
+            const mounted = digiaGuideController.start({
+                payloadId: cepCampaignId,
+                campaignKey,
+                campaignId: digiaId,
+                variables,
+                config,
+                onExperienceEvent: (event) => this._onGuideLifecycleEvent(event, cepCampaignId, campaignKey, digiaId),
+            });
+
+            this._log(`guide trigger campaign_key=${campaignKey} mounted=${mounted}`);
+            if (!mounted) {
+                this._log(`event controller failed to mount guide campaign_key=${campaignKey}`);
+                digiaHealthReporter.report(HealthEventType.host_not_mounted, {
+                    campaign_key: campaignKey,
+                    payload_id: cepCampaignId,
+                });
+            }
+            return;
         }
 
-        this._activePayloads.set(payload.id, payload);
-        nativeDigiaModule.triggerCampaign(payload.id, payload.content, payload.cepContext);
+        if (!campaign) {
+            this._log(`campaign_key_mismatch: no campaign found for key="${campaignKey}"`);
+            digiaHealthReporter.report(HealthEventType.campaign_key_mismatch, {
+                campaign_key: campaignKey,
+                payload_id: cepCampaignId,
+                available_campaign_keys: [...this._campaignsByKey.keys()],
+            });
+            return;
+        }
+
+        this._activePayloads.set(cepCampaignId, payload);
+        nativeDigiaModule.triggerCampaign(cepCampaignId, bridgeContent, cepMetadata);
     }
 
     onCampaignInvalidated(campaignId: string): void {
@@ -292,7 +329,7 @@ class DigiaClass implements DigiaDelegate {
 
     private _fireCustomEvent(
         eventName: string,
-        properties?: Record<string, unknown>,
+        _properties?: Record<string, unknown>,
         context?: ActionContext,
     ): void {
         const payload = context ? this._activePayloads.get(context.campaign_id) : null;
@@ -306,24 +343,25 @@ class DigiaClass implements DigiaDelegate {
     private _forwardExperienceEvent(
         data: { campaignId: string; type: string; elementId?: string },
     ): void {
+        console.log(`[Digia] received overlay event from native: campaignId=${data.campaignId} type=${data.type} elementId=${data.elementId}`);
         const payload = this._activePayloads.get(data.campaignId);
         if (!payload) return;
 
-        const campaignKey = this._extractCampaignKey(payload);
+        const { campaignKey } = payload;
 
         let event: DigiaExperienceEvent;
         switch (data.type) {
             case 'impressed':
                 event = { type: 'impressed' };
-                if (campaignKey) void this._bumpFrequencyImpression(campaignKey);
+                void this._bumpFrequencyImpression(campaignKey);
                 break;
             case 'clicked':
                 event = { type: 'clicked', elementId: data.elementId };
-                if (campaignKey) void this._applyStopOn(campaignKey, 'click');
+                void this._applyStopOn(campaignKey, 'click');
                 break;
             case 'dismissed':
                 event = { type: 'dismissed' };
-                if (campaignKey) void this._applyStopOn(campaignKey, 'dismiss');
+                void this._applyStopOn(campaignKey, 'dismiss');
                 this._activePayloads.delete(data.campaignId);
                 break;
             default:
@@ -339,10 +377,21 @@ class DigiaClass implements DigiaDelegate {
         campaignKey: string,
         campaignId: string,
     ): void {
+        console.log(`[Digia] guide lifecycle event: type=${event.type} step=${event.stepIndex + 1}/${event.stepTotal} anchorKey=${event.anchorKey} displayStyle=${event.displayStyle} campaignKey=${campaignKey}`);
         const eventName = this._guideEventName(event.type);
         const properties = this._buildGuideProperties(event, campaignId, campaignKey);
         this._plugins.forEach((p) => p.track?.(eventName, properties));
 
+        // Forward main experience events to native analytics.
+        // step_* and completed events are guide-specific and have no native equivalent.
+        if (event.type === 'viewed') {
+            nativeDigiaModule.trackEvent('impressed', campaignId, campaignKey, 'guide', null);
+        } else if (event.type === 'clicked') {
+            nativeDigiaModule.trackEvent('clicked', campaignId, campaignKey, 'guide', event.elementId ?? null);
+        } else if (event.type === 'dismissed') {
+            nativeDigiaModule.trackEvent('dismissed', campaignId, campaignKey, 'guide', null);
+        }
+
         if (event.type === 'viewed') {
             void this._bumpFrequencyImpression(campaignKey);
         }
@@ -442,7 +491,7 @@ class DigiaClass implements DigiaDelegate {
             this._log(`loaded ${campaigns.length} campaign(s): [${[...this._campaignsByKey.keys()].join(', ')}]`);
         } catch (e) {
             const reason = e instanceof Error ? e.message : String(e);
-            this._log(`getCampaigns FAILED: ${reason}`);
+            this._error(`Campaign fetch failed: ${reason} — check your apiKey and network connectivity`);
             digiaHealthReporter.report(HealthEventType.fetch_failed, {
                 error_code: 0,
                 platform: 'react_native',
@@ -456,7 +505,7 @@ class DigiaClass implements DigiaDelegate {
             method: 'POST',
             headers: {
                 'Content-Type': 'application/json',
-                'x-digia-project-id': this._projectId,
+                'x-digia-project-id': this._apiKey,
                 'x-digia-device-id': this._deviceId,
             },
             body: JSON.stringify(body),
@@ -506,39 +555,6 @@ class DigiaClass implements DigiaDelegate {
         }
     }
 
-    private _extractCampaignKey(payload: InAppPayload): string | null {
-        const fromContent = this._extractString(payload.content, 'digia_campaign_key', 'digiaKey', 'campaign_key', 'campaignKey');
-        if (fromContent) return fromContent;
-
-        const args = payload.content.args;
-        if (args && typeof args === 'object' && !Array.isArray(args)) {
-            const fromArgs = this._extractString(args as Record<string, unknown>, 'digia_campaign_key', 'digiaKey', 'campaign_key', 'campaignKey');
-            if (fromArgs) return fromArgs;
-        }
-
-        if (this._campaignsByKey.has(payload.id)) return payload.id;
-        return null;
-    }
-
-    private _extractVariables(payload: InAppPayload): Record<string, string> | undefined {
-        const fromContent = parseVariableMap(payload.content.variables);
-        if (fromContent) return fromContent;
-
-        const args = payload.content.args;
-        if (args && typeof args === 'object' && !Array.isArray(args)) {
-            return parseVariableMap((args as Record<string, unknown>).variables);
-        }
-        return undefined;
-    }
-
-    private _extractString(data: Record<string, unknown>, ...keys: string[]): string | null {
-        for (const key of keys) {
-            const value = data[key];
-            if (typeof value === 'string' && value.trim()) return value.trim();
-        }
-        return null;
-    }
-
     private _parseTemplateConfig(campaign: SdkCampaign): TemplateConfig | null {
         const c = campaign as unknown as Record<string, unknown>;
         const raw = c.templateConfig as Record<string, unknown> | undefined;
@@ -622,6 +638,18 @@ class DigiaClass implements DigiaDelegate {
         console.log(`[Digia] ${message}`);
     }
 
+    private _warn(message: string): void {
+        if (this._logLevel === 'none') return;
+        // eslint-disable-next-line no-console
+        console.warn(`[Digia] ${message}`);
+    }
+
+    private _error(message: string): void {
+        if (this._logLevel === 'none') return;
+        // eslint-disable-next-line no-console
+        console.error(`[Digia] ${message}`);
+    }
+
 }
 
 export const Digia = new DigiaClass();

package/src/DigiaAnchorView.tsx

@@ -47,7 +47,12 @@ export const DigiaAnchorView = forwardRef<DigiaAnchorViewRef, Props>(
         const measure = useCallback(() => {
             if (!canMeasure.current) return;
             viewRef.current?.measure((_x, _y, width, height, pageX, pageY) => {
-                if (width === 0 && height === 0) return;
+                if (width === 0 && height === 0) {
+                    // Publish 0×0 so overlay subscribers can detect a collapsed/hidden
+                    // anchor and cancel the campaign rather than hanging indefinitely.
+                    digiaAnchorRegistry.setLayout(anchorKey, { pageX, pageY, width: 0, height: 0 });
+                    return;
+                }
                 nativeDigiaModule.registerAnchor(anchorKey, Math.round(pageX), Math.round(pageY), Math.round(width), Math.round(height));
                 digiaAnchorRegistry.setLayout(anchorKey, { pageX, pageY, width, height });
             });