@digia-engage/core 1.1.1 → 2.0.0-rc.2

package/lib/commonjs/frequencyEvaluator.js

@@ -0,0 +1,70 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isSessionPolicy = exports.hasPolicy = exports.evaluate = void 0;
+const WINDOW_MS = {
+  day: 86_400_000,
+  week: 7 * 86_400_000,
+  month: 30 * 86_400_000
+};
+const isSessionPolicy = policy => policy.max_per_window?.window === 'session';
+
+/**
+ * Pure eligibility function. No side effects.
+ *
+ * Semantics for max_per_window { count, window }:
+ *   - "count" shows are allowed, measured from first_shown_at.
+ *   - Once the window duration has elapsed since first_shown_at, permanently blocked (reason: 'window').
+ *   - Once shown_count >= count, permanently blocked (reason: 'max_total').
+ *   - 'session' window is checked by the caller via in-memory state — same logic applies.
+ */
+exports.isSessionPolicy = isSessionPolicy;
+const evaluate = (policy, state, now) => {
+  if (!state) return {
+    allow: true,
+    reason: null
+  };
+  if (state.stopped_at !== null) {
+    return {
+      allow: false,
+      reason: 'stopped'
+    };
+  }
+  if (policy.max_total !== null && state.shown_count >= policy.max_total) {
+    return {
+      allow: false,
+      reason: 'max_total'
+    };
+  }
+  if (policy.max_per_window !== null) {
+    const {
+      count,
+      window: win
+    } = policy.max_per_window;
+    const windowMs = WINDOW_MS[win];
+    if (windowMs !== undefined && state.first_shown_at !== null) {
+      if (now - state.first_shown_at > windowMs) {
+        return {
+          allow: false,
+          reason: 'window'
+        };
+      }
+    }
+    if (state.shown_count >= count) {
+      return {
+        allow: false,
+        reason: 'max_total'
+      };
+    }
+  }
+  return {
+    allow: true,
+    reason: null
+  };
+};
+exports.evaluate = evaluate;
+const hasPolicy = policy => policy !== null && policy !== undefined && (policy.max_total !== null || policy.max_per_window !== null || policy.stop_on !== null);
+exports.hasPolicy = hasPolicy;
+//# sourceMappingURL=frequencyEvaluator.js.map

package/lib/commonjs/frequencyEvaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["WINDOW_MS","day","week","month","isSessionPolicy","policy","max_per_window","window","exports","evaluate","state","now","allow","reason","stopped_at","max_total","shown_count","count","win","windowMs","undefined","first_shown_at","hasPolicy","stop_on"],"sourceRoot":"../../src","sources":["frequencyEvaluator.ts"],"mappings":";;;;;;AAEA,MAAMA,SAAiC,GAAG;EACtCC,GAAG,EAAI,UAAU;EACjBC,IAAI,EAAG,CAAC,GAAG,UAAU;EACrBC,KAAK,EAAE,EAAE,GAAG;AAChB,CAAC;AAEM,MAAMC,eAAe,GAAIC,MAAuB,IACnDA,MAAM,CAACC,cAAc,EAAEC,MAAM,KAAK,SAAS;;AAE/C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AARAC,OAAA,CAAAJ,eAAA,GAAAA,eAAA;AASO,MAAMK,QAAQ,GAAGA,CACpBJ,MAAuB,EACvBK,KAA4B,EAC5BC,GAAW,KACW;EACtB,IAAI,CAACD,KAAK,EAAE,OAAO;IAAEE,KAAK,EAAE,IAAI;IAAEC,MAAM,EAAE;EAAK,CAAC;EAEhD,IAAIH,KAAK,CAACI,UAAU,KAAK,IAAI,EAAE;IAC3B,OAAO;MAAEF,KAAK,EAAE,KAAK;MAAEC,MAAM,EAAE;IAAU,CAAC;EAC9C;EAEA,IAAIR,MAAM,CAACU,SAAS,KAAK,IAAI,IAAIL,KAAK,CAACM,WAAW,IAAIX,MAAM,CAACU,SAAS,EAAE;IACpE,OAAO;MAAEH,KAAK,EAAE,KAAK;MAAEC,MAAM,EAAE;IAAY,CAAC;EAChD;EAEA,IAAIR,MAAM,CAACC,cAAc,KAAK,IAAI,EAAE;IAChC,MAAM;MAAEW,KAAK;MAAEV,MAAM,EAAEW;IAAI,CAAC,GAAGb,MAAM,CAACC,cAAc;IACpD,MAAMa,QAAQ,GAAGnB,SAAS,CAACkB,GAAG,CAAC;IAE/B,IAAIC,QAAQ,KAAKC,SAAS,IAAIV,KAAK,CAACW,cAAc,KAAK,IAAI,EAAE;MACzD,IAAIV,GAAG,GAAGD,KAAK,CAACW,cAAc,GAAGF,QAAQ,EAAE;QACvC,OAAO;UAAEP,KAAK,EAAE,KAAK;UAAEC,MAAM,EAAE;QAAS,CAAC;MAC7C;IACJ;IAEA,IAAIH,KAAK,CAACM,WAAW,IAAIC,KAAK,EAAE;MAC5B,OAAO;QAAEL,KAAK,EAAE,KAAK;QAAEC,MAAM,EAAE;MAAY,CAAC;IAChD;EACJ;EAEA,OAAO;IAAED,KAAK,EAAE,IAAI;IAAEC,MAAM,EAAE;EAAK,CAAC;AACxC,CAAC;AAACL,OAAA,CAAAC,QAAA,GAAAA,QAAA;AAEK,MAAMa,SAAS,GAAIjB,MAA0C,IAChEA,MAAM,KAAK,IAAI,IACfA,MAAM,KAAKe,SAAS,KACnBf,MAAM,CAACU,SAAS,KAAK,IAAI,IAAIV,MAAM,CAACC,cAAc,KAAK,IAAI,IAAID,MAAM,CAACkB,OAAO,KAAK,IAAI,CAAC;AAACf,OAAA,CAAAc,SAAA,GAAAA,SAAA","ignoreList":[]}

package/lib/commonjs/frequencyStore.js

@@ -0,0 +1,70 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.frequencyStore = void 0;
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const STORE_META_KEY = 'digia:freq:__meta__';
+let _storage = null;
+const _loadStorage = () => {
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const mod = require('@react-native-async-storage/async-storage');
+    return mod.default ?? mod;
+  } catch {
+    console.warn('[Digia] AsyncStorage unavailable — frequency state is in-memory only (resets on app restart)');
+    return null;
+  }
+};
+const getStorage = () => {
+  if (_storage === undefined) {
+    _storage = _loadStorage();
+  }
+  return _storage;
+};
+const _sessionStore = new Map();
+const storeKey = campaignKey => `digia:freq:${campaignKey}`;
+const frequencyStore = exports.frequencyStore = {
+  async checkProjectId(projectId) {
+    const storage = getStorage();
+    if (!storage) return;
+    try {
+      const stored = await storage.getItem(STORE_META_KEY);
+      const meta = stored ? JSON.parse(stored) : null;
+      if (meta && meta.projectId !== projectId) {
+        const keys = await storage.getAllKeys();
+        const digiaKeys = keys.filter(k => k.startsWith('digia:freq:'));
+        if (digiaKeys.length > 0) await storage.multiRemove([...digiaKeys]);
+      }
+      await storage.setItem(STORE_META_KEY, JSON.stringify({
+        projectId
+      }));
+    } catch {
+      // non-fatal
+    }
+  },
+  async get(campaignKey, isSession) {
+    if (isSession) return _sessionStore.get(campaignKey) ?? null;
+    const storage = getStorage();
+    if (!storage) return _sessionStore.get(campaignKey) ?? null;
+    try {
+      const raw = await storage.getItem(storeKey(campaignKey));
+      return raw ? JSON.parse(raw) : null;
+    } catch {
+      return null;
+    }
+  },
+  async set(campaignKey, state, isSession) {
+    _sessionStore.set(campaignKey, state);
+    if (isSession) return;
+    const storage = getStorage();
+    if (!storage) return;
+    try {
+      await storage.setItem(storeKey(campaignKey), JSON.stringify(state));
+    } catch {
+      // non-fatal: state already updated in-memory above
+    }
+  }
+};
+//# sourceMappingURL=frequencyStore.js.map

package/lib/commonjs/frequencyStore.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["STORE_META_KEY","_storage","_loadStorage","mod","require","default","console","warn","getStorage","undefined","_sessionStore","Map","storeKey","campaignKey","frequencyStore","exports","checkProjectId","projectId","storage","stored","getItem","meta","JSON","parse","keys","getAllKeys","digiaKeys","filter","k","startsWith","length","multiRemove","setItem","stringify","get","isSession","raw","set","state"],"sourceRoot":"../../src","sources":["frequencyStore.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/index.js

@@ -15,6 +15,12 @@ Object.defineProperty(exports, "DigiaAnchorView", {
     return _DigiaAnchorView.DigiaAnchorView;
   }
 });
+Object.defineProperty(exports, "DigiaHost", {
+  enumerable: true,
+  get: function () {
+    return _DigiaProvider.DigiaHost;
+  }
+});
 Object.defineProperty(exports, "DigiaHostView", {
   enumerable: true,
   get: function () {
@@ -29,6 +35,7 @@ Object.defineProperty(exports, "DigiaSlotView", {
 });
 var _Digia = require("./Digia");
 var _DigiaHostView = require("./DigiaHostView");
+var _DigiaProvider = require("./DigiaProvider");
 var _DigiaSlotView = require("./DigiaSlotView");
 var _DigiaAnchorView = require("./DigiaAnchorView");
 //# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_Digia","require","_DigiaHostView","_DigiaSlotView","_DigiaAnchorView"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,cAAA,GAAAD,OAAA;AACA,IAAAE,cAAA,GAAAF,OAAA;AACA,IAAAG,gBAAA,GAAAH,OAAA","ignoreList":[]}
+{"version":3,"names":["_Digia","require","_DigiaHostView","_DigiaProvider","_DigiaSlotView","_DigiaAnchorView"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,cAAA,GAAAD,OAAA;AACA,IAAAE,cAAA,GAAAF,OAAA;AACA,IAAAG,cAAA,GAAAH,OAAA;AACA,IAAAI,gBAAA,GAAAJ,OAAA","ignoreList":[]}

package/lib/commonjs/templateTypes.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=templateTypes.js.map

package/lib/commonjs/templateTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["templateTypes.ts"],"mappings":"","ignoreList":[]}

package/lib/module/Digia.js

@@ -7,7 +7,7 @@
  * import { Digia } from '@digia/engage-react-native';
  *
  * // In your App entry point (e.g. App.tsx):
- * await Digia.initialize({ apiKey: 'YOUR_API_KEY' });
+ * await Digia.initialize({ projectId: 'YOUR_PROJECT_ID' });
  *
  * // Whenever your navigation screen changes:
  * Digia.setCurrentScreen('Home');
@@ -17,6 +17,15 @@
 
 import { DeviceEventEmitter } from 'react-native';
 import { nativeDigiaModule } from './NativeDigiaEngage';
+import { digiaHealthReporter, HealthEventType } from './DigiaHealthReporter';
+import { digiaGuideController } from './DigiaGuideController';
+import { digiaActionHandler } from './actionHandler';
+import uuid from 'react-native-uuid';
+import { frequencyStore } from './frequencyStore';
+import { evaluate, hasPolicy, isSessionPolicy } from './frequencyEvaluator';
+const PRODUCTION_API_ROOT = 'https://app.digia.tech';
+const SANDBOX_API_ROOT = 'https://dev.digia.tech';
+const DIGIA_SDK_VERSION = '1.0.0';
 class DigiaClass {
   _plugins = new Map();
   // Tracks whether the native bridge plugin (RNEventBridgePlugin) has been
@@ -26,6 +35,13 @@ class DigiaClass {
   // the full InAppPayload when overlay lifecycle events arrive from native.
   _activePayloads = new Map();
   _engageSubscription = null;
+  _projectId = '';
+  _deviceId = '';
+  _apiBaseUrl = '';
+  _logLevel = 'error';
+  _currentScreen = null;
+  _campaignsByKey = new Map();
+  _registeredAnchorKeys = new Set();
 
   /**
    * Initialise the Digia Engage SDK.
@@ -36,7 +52,26 @@ class DigiaClass {
   async initialize(config) {
     const environment = config.environment ?? 'production';
     const logLevel = config.logLevel ?? 'error';
-    await nativeDigiaModule.initialize(config.apiKey, environment, logLevel);
+    this._projectId = config.projectId;
+    this._apiBaseUrl = this._resolveApiBaseUrl(config);
+    this._logLevel = logLevel;
+    this._fontFamily = config.fontFamily?.trim() || undefined;
+    digiaHealthReporter.init(config.projectId, this._apiBaseUrl);
+    digiaActionHandler.configure({
+      onAction: config.onAction,
+      routeViaSystemLinking: config.linking?.routeViaSystemLinking ?? true,
+      inAppBrowser: config.linking?.inAppBrowser
+    });
+    try {
+      await nativeDigiaModule.initialize(config.projectId, environment, logLevel, config.baseUrl, config.fontFamily);
+    } catch (e) {
+      // TODO: TO BE PICKED LATER @aditya-digia — health event reporting being removed
+      // digiaHealthReporter.report(HealthEventType.fetch_failed, { error_code: 0, platform: 'react_native' });
+      throw e;
+    }
+    this._deviceId = await this._loadOrCreateDeviceId();
+    await frequencyStore.checkProjectId(config.projectId);
+    await this._refreshCampaignStore();
   }
 
   /**
@@ -50,7 +85,7 @@ class DigiaClass {
    * ```ts
    * import { DigiaMoEngagePlugin } from '@digia/moengage-plugin';
    *
-   * await Digia.initialize({ apiKey: 'YOUR_KEY' });
+   * await Digia.initialize({ projectId: 'YOUR_PROJECT_ID' });
    * Digia.register(new DigiaMoEngagePlugin({ moEngage: MoEngage }));
    * ```
    */
@@ -66,6 +101,7 @@ class DigiaClass {
       this._nativeBridgeWired = true;
     }
     plugin.setup(this);
+    plugin.reportHealth?.(digiaHealthReporter);
     this._plugins.set(plugin.identifier, plugin);
   }
 
@@ -87,20 +123,104 @@ class DigiaClass {
    * All registered plugins will have forwardScreen() called automatically.
    */
   setCurrentScreen(name) {
+    this._currentScreen = name;
     nativeDigiaModule.setCurrentScreen(name);
     this._plugins.forEach(plugin => plugin.forwardScreen(name));
   }
+  registerAnchor(anchorKey, _screenName) {
+    const cleanAnchorKey = anchorKey.trim();
+    if (!cleanAnchorKey) return;
+    this._registeredAnchorKeys.add(cleanAnchorKey);
+  }
+  unregisterAnchor(anchorKey) {
+    this._registeredAnchorKeys.delete(anchorKey);
+  }
+
+  /**
+   * Global font family configured via {@link initialize}, or `undefined` when
+   * none was set. Used by the JS-rendered guide overlays (tooltip/spotlight)
+   * so their text matches native-rendered campaigns.
+   */
+  get fontFamily() {
+    return this._fontFamily;
+  }
 
   // ── DigiaDelegate ────────────────────────────────────────────────────────
   // Mirrors DigiaCEPDelegate on Android.
   // Forwards to the native DigiaCEPDelegate via the bridge.
 
-  onCampaignTriggered(payload) {
+  async onCampaignTriggered(payload) {
+    if (!this._nativeBridgeWired) {
+      digiaHealthReporter.report(HealthEventType.plugin_not_registered, {
+        campaign_key: payload.id
+      });
+    }
+    const campaignKey = this._extractCampaignKey(payload);
+    this._log(`onCampaignTriggered payloadId=${payload.id} extractedKey=${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;
+        }
+      }
+      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);
+        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;
+        }
+        this._activePayloads.set(payload.id, payload);
+        const digiaId = campaign._id ?? campaign.id ?? campaignKey;
+        const mounted = digiaGuideController.start({
+          payloadId: payload.id,
+          campaignKey,
+          campaignId: digiaId,
+          config,
+          onExperienceEvent: event => this._onGuideLifecycleEvent(event, payload.id, campaignKey, digiaId)
+        });
+        this._log(`guide trigger campaign_key=${campaignKey} mounted=${mounted}`);
+        if (!mounted) {
+          digiaHealthReporter.report(HealthEventType.host_not_mounted, {
+            campaign_key: campaignKey,
+            payload_id: payload.id
+          });
+        }
+        return;
+      }
+      if (!campaign) {
+        this._log(`campaign_key_mismatch: no campaign found for key="${campaignKey}"`);
+        digiaHealthReporter.report(HealthEventType.campaign_key_mismatch, {
+          campaign_key: campaignKey,
+          payload_id: payload.id,
+          available_campaign_keys: [...this._campaignsByKey.keys()]
+        });
+        return;
+      }
+    }
     this._activePayloads.set(payload.id, payload);
     nativeDigiaModule.triggerCampaign(payload.id, payload.content, payload.cepContext);
   }
   onCampaignInvalidated(campaignId) {
     this._activePayloads.delete(campaignId);
+    digiaGuideController.cancel(campaignId);
     nativeDigiaModule.invalidateCampaign(campaignId);
   }
 
@@ -121,23 +241,27 @@ class DigiaClass {
   _forwardExperienceEvent(data) {
     const payload = this._activePayloads.get(data.campaignId);
     if (!payload) return;
+    const campaignKey = this._extractCampaignKey(payload);
     let event;
     switch (data.type) {
       case 'impressed':
         event = {
           type: 'impressed'
         };
+        if (campaignKey) void this._bumpFrequencyImpression(campaignKey);
         break;
       case 'clicked':
         event = {
           type: 'clicked',
           elementId: data.elementId
         };
+        if (campaignKey) void this._applyStopOn(campaignKey, 'click');
         break;
       case 'dismissed':
         event = {
           type: 'dismissed'
         };
+        if (campaignKey) void this._applyStopOn(campaignKey, 'dismiss');
         this._activePayloads.delete(data.campaignId);
         break;
       default:
@@ -145,6 +269,267 @@ class DigiaClass {
     }
     this._plugins.forEach(plugin => plugin.notifyEvent(event, payload));
   }
+  _onGuideLifecycleEvent(event, payloadId, campaignKey, campaignId) {
+    const eventName = this._guideEventName(event.type);
+    const properties = this._buildGuideProperties(event, campaignId, campaignKey);
+    this._plugins.forEach(p => p.track?.(eventName, properties));
+    if (event.type === 'viewed') {
+      void this._bumpFrequencyImpression(campaignKey);
+    }
+    if (event.type === 'clicked' || event.type === 'completed') {
+      void this._applyStopOn(campaignKey, 'click');
+    }
+    if (event.type === 'dismissed') {
+      void this._applyStopOn(campaignKey, 'dismiss');
+    }
+
+    // Notify plugins of CEP lifecycle termination (template cleanup) on exit events.
+    if (event.type === 'dismissed' || event.type === 'completed') {
+      const storedPayload = this._activePayloads.get(payloadId);
+      if (storedPayload) {
+        this._plugins.forEach(p => p.notifyEvent({
+          type: 'dismissed'
+        }, storedPayload));
+        this._activePayloads.delete(payloadId);
+      }
+    }
+  }
+  _guideEventName(type) {
+    switch (type) {
+      case 'viewed':
+        return 'Digia Experience Viewed';
+      case 'step_viewed':
+        return 'Digia Step Viewed';
+      case 'clicked':
+        return 'Digia Experience Clicked';
+      case 'step_clicked':
+        return 'Digia Step Clicked';
+      case 'dismissed':
+        return 'Digia Experience Dismissed';
+      case 'step_dismissed':
+        return 'Digia Step Dismissed';
+      case 'completed':
+        return 'Digia Experience Completed';
+    }
+  }
+  _buildGuideProperties(event, campaignId, campaignKey) {
+    const base = {
+      campaign_id: campaignId,
+      campaign_key: campaignKey,
+      campaign_type: 'guide',
+      display_style: event.displayStyle,
+      step_index: event.stepIndex + 1,
+      step_total: event.stepTotal,
+      anchor_key: event.anchorKey,
+      slot_key: null,
+      element_id: null,
+      cta_label: null,
+      action_type: null,
+      action_url: null,
+      dismiss_reason: null,
+      abandoned_at_step: null,
+      digia_sdk_version: DIGIA_SDK_VERSION,
+      digia_platform: 'react_native'
+    };
+    if (event.type === 'clicked' || event.type === 'step_clicked') {
+      base.element_id = event.elementId ?? null;
+      base.cta_label = event.ctaLabel;
+      base.action_type = event.actionType;
+      base.action_url = event.actionUrl ?? null;
+    } else if (event.type === 'dismissed' || event.type === 'step_dismissed') {
+      base.dismiss_reason = event.dismissReason;
+      base.abandoned_at_step = event.stepIndex + 1;
+    }
+    return base;
+  }
+  _resolveApiBaseUrl(config) {
+    const root = (config.baseUrl ?? (config.environment === 'sandbox' ? SANDBOX_API_ROOT : PRODUCTION_API_ROOT)).trim();
+    const cleanRoot = root.replace(/\/+$/, '');
+    return cleanRoot.endsWith('/api/v1') ? cleanRoot : `${cleanRoot}/api/v1`;
+  }
+  async _refreshCampaignStore() {
+    try {
+      this._log(`fetching campaigns from ${this._apiBaseUrl}/engage/sdk/getCampaigns`);
+      const campaigns = await this._sdkPost('getCampaigns');
+      this._campaignsByKey.clear();
+      if (campaigns.length > 0) {
+        this._log(`campaign[0] raw keys: ${JSON.stringify(Object.keys(campaigns[0]))}`);
+      }
+      campaigns.forEach(campaign => {
+        const raw = campaign;
+        const key = typeof raw.campaign_key === 'string' && raw.campaign_key || typeof raw.campaignKey === 'string' && raw.campaignKey || null;
+        const type = typeof raw.campaign_type === 'string' && raw.campaign_type || typeof raw.campaignType === 'string' && raw.campaignType || '';
+        if (key) {
+          this._campaignsByKey.set(key, {
+            ...campaign,
+            campaign_key: key,
+            campaign_type: type
+          });
+        }
+      });
+      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}`);
+      digiaHealthReporter.report(HealthEventType.fetch_failed, {
+        error_code: 0,
+        platform: 'react_native',
+        reason
+      });
+    }
+  }
+  async _sdkPost(path, body = {}) {
+    const res = await fetch(`${this._apiBaseUrl}/engage/sdk/${path}`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'x-digia-project-id': this._projectId,
+        'x-digia-device-id': this._deviceId
+      },
+      body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+      throw new Error(`${path} failed: HTTP ${res.status}`);
+    }
+    const json = await res.json();
+    return this._extractApiResponse(json);
+  }
+  _extractApiResponse(json) {
+    if (Array.isArray(json)) return json;
+    if (json && typeof json === 'object') {
+      const obj = json;
+      const data = obj.data;
+      if (data && typeof data === 'object' && 'response' in data) {
+        const value = data.response;
+        if (value == null) throw new Error('SDK response.data.response is null');
+        return value;
+      }
+      if ('response' in obj) {
+        const value = obj.response;
+        if (value == null) throw new Error('SDK response.response is null');
+        return value;
+      }
+    }
+    throw new Error('SDK response missing data.response');
+  }
+  _emitSlotWidth(campaign) {
+    const raw = campaign;
+    const config = raw.templateConfig;
+    if (!config) {
+      this._log(`_emitSlotWidth: no templateConfig for campaign ${campaign.campaign_key}`);
+      return;
+    }
+    const slotKey = typeof config.slotKey === 'string' ? config.slotKey : null;
+    const width = typeof config.width === 'number' && config.width > 0 ? config.width : null;
+    this._log(`_emitSlotWidth slotKey=${slotKey} width=${width} campaign=${campaign.campaign_key}`);
+    if (slotKey) {
+      DeviceEventEmitter.emit('digiaSlotWidth', {
+        slotKey,
+        width
+      });
+    } else {
+      this._log(`_emitSlotWidth: no slotKey in templateConfig ${JSON.stringify(config)}`);
+    }
+  }
+  _extractCampaignKey(payload) {
+    const fromContent = this._extractString(payload.content, '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, 'digiaKey', 'campaign_key', 'campaignKey');
+      if (fromArgs) return fromArgs;
+    }
+    if (this._campaignsByKey.has(payload.id)) return payload.id;
+    return null;
+  }
+  _extractString(data, ...keys) {
+    for (const key of keys) {
+      const value = data[key];
+      if (typeof value === 'string' && value.trim()) return value.trim();
+    }
+    return null;
+  }
+  _parseTemplateConfig(campaign) {
+    const c = campaign;
+    const raw = c.templateConfig;
+    if (!raw || typeof raw !== 'object') return null;
+    const type = raw.templateType;
+    if (type !== 'tooltip' && type !== 'spotlight' && type !== 'carousel') {
+      this._log(`unknown templateType="${type}" for campaign_key=${campaign.campaign_key}`);
+      return null;
+    }
+    if (type === 'carousel') {
+      return raw;
+    }
+    const steps = Array.isArray(raw.steps) ? raw.steps : [];
+    return {
+      ...raw,
+      templateType: type,
+      steps
+    };
+  }
+
+  // ── Device ID ────────────────────────────────────────────────────────────
+
+  async _loadOrCreateDeviceId() {
+    const DEVICE_ID_KEY = 'digia:device_id';
+    try {
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const AsyncStorage = require('@react-native-async-storage/async-storage').default;
+      const stored = await AsyncStorage.getItem(DEVICE_ID_KEY);
+      if (stored) return stored;
+      const id = uuid.v4();
+      await AsyncStorage.setItem(DEVICE_ID_KEY, id);
+      return id;
+    } catch {
+      return uuid.v4();
+    }
+  }
+
+  // ── Frequency capping ────────────────────────────────────────────────────
+
+  async _getFrequencyState(campaignKey, isSession) {
+    return frequencyStore.get(campaignKey, isSession);
+  }
+  async _bumpFrequencyImpression(campaignKey) {
+    const campaign = this._campaignsByKey.get(campaignKey);
+    if (!campaign || !hasPolicy(campaign.frequency)) return;
+    const isSession = isSessionPolicy(campaign.frequency);
+    const now = Date.now();
+    const prev = await frequencyStore.get(campaignKey, isSession);
+    const next = {
+      shown_count: (prev?.shown_count ?? 0) + 1,
+      first_shown_at: prev?.first_shown_at ?? now,
+      last_shown_at: now,
+      stopped_at: prev?.stopped_at ?? null,
+      stopped_reason: prev?.stopped_reason ?? null
+    };
+    await frequencyStore.set(campaignKey, next, isSession);
+  }
+  async _applyStopOn(campaignKey, interactionType) {
+    const campaign = this._campaignsByKey.get(campaignKey);
+    const stopOn = campaign?.frequency?.stop_on;
+    if (!stopOn) return;
+    const matches = stopOn === 'any_action' || stopOn === interactionType;
+    if (!matches) return;
+    const isSession = isSessionPolicy(campaign.frequency);
+    const prev = await frequencyStore.get(campaignKey, isSession);
+    if (prev?.stopped_at) return;
+    const now = Date.now();
+    const next = {
+      shown_count: prev?.shown_count ?? 0,
+      first_shown_at: prev?.first_shown_at ?? null,
+      last_shown_at: prev?.last_shown_at ?? null,
+      stopped_at: now,
+      stopped_reason: interactionType
+    };
+    await frequencyStore.set(campaignKey, next, isSession);
+  }
+  _log(message) {
+    if (this._logLevel !== 'verbose') return;
+    // eslint-disable-next-line no-console
+    console.log(`[Digia] ${message}`);
+  }
 }
 export const Digia = new DigiaClass();
 //# sourceMappingURL=Digia.js.map