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

package/lib/module/frequencyEvaluator.js

@@ -0,0 +1,61 @@
+const WINDOW_MS = {
+  day: 86_400_000,
+  week: 7 * 86_400_000,
+  month: 30 * 86_400_000
+};
+export 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.
+ */
+export 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
+  };
+};
+export const hasPolicy = policy => policy !== null && policy !== undefined && (policy.max_total !== null || policy.max_per_window !== null || policy.stop_on !== null);
+//# sourceMappingURL=frequencyEvaluator.js.map

package/lib/module/frequencyEvaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["WINDOW_MS","day","week","month","isSessionPolicy","policy","max_per_window","window","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;AAED,OAAO,MAAMC,eAAe,GAAIC,MAAuB,IACnDA,MAAM,CAACC,cAAc,EAAEC,MAAM,KAAK,SAAS;;AAE/C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,QAAQ,GAAGA,CACpBH,MAAuB,EACvBI,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,IAAIP,MAAM,CAACS,SAAS,KAAK,IAAI,IAAIL,KAAK,CAACM,WAAW,IAAIV,MAAM,CAACS,SAAS,EAAE;IACpE,OAAO;MAAEH,KAAK,EAAE,KAAK;MAAEC,MAAM,EAAE;IAAY,CAAC;EAChD;EAEA,IAAIP,MAAM,CAACC,cAAc,KAAK,IAAI,EAAE;IAChC,MAAM;MAAEU,KAAK;MAAET,MAAM,EAAEU;IAAI,CAAC,GAAGZ,MAAM,CAACC,cAAc;IACpD,MAAMY,QAAQ,GAAGlB,SAAS,CAACiB,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;AAED,OAAO,MAAMS,SAAS,GAAIhB,MAA0C,IAChEA,MAAM,KAAK,IAAI,IACfA,MAAM,KAAKc,SAAS,KACnBd,MAAM,CAACS,SAAS,KAAK,IAAI,IAAIT,MAAM,CAACC,cAAc,KAAK,IAAI,IAAID,MAAM,CAACiB,OAAO,KAAK,IAAI,CAAC","ignoreList":[]}

package/lib/module/frequencyStore.js

@@ -0,0 +1,64 @@
+// 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}`;
+export const 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/module/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","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":"AAEA;AACA,MAAMA,cAAc,GAAG,qBAAqB;AAU5C,IAAIC,QAAoC,GAAG,IAAI;AAE/C,MAAMC,YAAY,GAAGA,CAAA,KAAkC;EACnD,IAAI;IACA;IACA,MAAMC,GAAG,GAAGC,OAAO,CAAC,2CAA2C,CAAC;IAChE,OAAOD,GAAG,CAACE,OAAO,IAAIF,GAAG;EAC7B,CAAC,CAAC,MAAM;IACJG,OAAO,CAACC,IAAI,CAAC,8FAA8F,CAAC;IAC5G,OAAO,IAAI;EACf;AACJ,CAAC;AAED,MAAMC,UAAU,GAAGA,CAAA,KAAkC;EACjD,IAAIP,QAAQ,KAAKQ,SAAS,EAAE;IACxBR,QAAQ,GAAGC,YAAY,CAAC,CAAC;EAC7B;EACA,OAAOD,QAAQ;AACnB,CAAC;AAED,MAAMS,aAAa,GAAG,IAAIC,GAAG,CAAyB,CAAC;AAEvD,MAAMC,QAAQ,GAAIC,WAAmB,IAAK,cAAcA,WAAW,EAAE;AAErE,OAAO,MAAMC,cAAc,GAAG;EAC1B,MAAMC,cAAcA,CAACC,SAAiB,EAAiB;IACnD,MAAMC,OAAO,GAAGT,UAAU,CAAC,CAAC;IAC5B,IAAI,CAACS,OAAO,EAAE;IACd,IAAI;MACA,MAAMC,MAAM,GAAG,MAAMD,OAAO,CAACE,OAAO,CAACnB,cAAc,CAAC;MACpD,MAAMoB,IAAI,GAAGF,MAAM,GAAIG,IAAI,CAACC,KAAK,CAACJ,MAAM,CAAC,GAA6B,IAAI;MAC1E,IAAIE,IAAI,IAAIA,IAAI,CAACJ,SAAS,KAAKA,SAAS,EAAE;QACtC,MAAMO,IAAI,GAAG,MAAMN,OAAO,CAACO,UAAU,CAAC,CAAC;QACvC,MAAMC,SAAS,GAAGF,IAAI,CAACG,MAAM,CAAEC,CAAC,IAAKA,CAAC,CAACC,UAAU,CAAC,aAAa,CAAC,CAAC;QACjE,IAAIH,SAAS,CAACI,MAAM,GAAG,CAAC,EAAE,MAAMZ,OAAO,CAACa,WAAW,CAAC,CAAC,GAAGL,SAAS,CAAC,CAAC;MACvE;MACA,MAAMR,OAAO,CAACc,OAAO,CAAC/B,cAAc,EAAEqB,IAAI,CAACW,SAAS,CAAC;QAAEhB;MAAU,CAAC,CAAC,CAAC;IACxE,CAAC,CAAC,MAAM;MACJ;IAAA;EAER,CAAC;EAED,MAAMiB,GAAGA,CAACpB,WAAmB,EAAEqB,SAAkB,EAAkC;IAC/E,IAAIA,SAAS,EAAE,OAAOxB,aAAa,CAACuB,GAAG,CAACpB,WAAW,CAAC,IAAI,IAAI;IAC5D,MAAMI,OAAO,GAAGT,UAAU,CAAC,CAAC;IAC5B,IAAI,CAACS,OAAO,EAAE,OAAOP,aAAa,CAACuB,GAAG,CAACpB,WAAW,CAAC,IAAI,IAAI;IAC3D,IAAI;MACA,MAAMsB,GAAG,GAAG,MAAMlB,OAAO,CAACE,OAAO,CAACP,QAAQ,CAACC,WAAW,CAAC,CAAC;MACxD,OAAOsB,GAAG,GAAId,IAAI,CAACC,KAAK,CAACa,GAAG,CAAC,GAAsB,IAAI;IAC3D,CAAC,CAAC,MAAM;MACJ,OAAO,IAAI;IACf;EACJ,CAAC;EAED,MAAMC,GAAGA,CAACvB,WAAmB,EAAEwB,KAAqB,EAAEH,SAAkB,EAAiB;IACrFxB,aAAa,CAAC0B,GAAG,CAACvB,WAAW,EAAEwB,KAAK,CAAC;IACrC,IAAIH,SAAS,EAAE;IACf,MAAMjB,OAAO,GAAGT,UAAU,CAAC,CAAC;IAC5B,IAAI,CAACS,OAAO,EAAE;IACd,IAAI;MACA,MAAMA,OAAO,CAACc,OAAO,CAACnB,QAAQ,CAACC,WAAW,CAAC,EAAEQ,IAAI,CAACW,SAAS,CAACK,KAAK,CAAC,CAAC;IACvE,CAAC,CAAC,MAAM;MACJ;IAAA;EAER;AACJ,CAAC","ignoreList":[]}

package/lib/typescript/Digia.d.ts

@@ -21,6 +21,7 @@ declare class DigiaClass implements DigiaDelegate {
     private readonly _activePayloads;
     private _engageSubscription;
     private _projectId;
+    private _deviceId;
     private _apiBaseUrl;
     private _logLevel;
     private _fontFamily;
@@ -71,7 +72,7 @@ declare class DigiaClass implements DigiaDelegate {
      * so their text matches native-rendered campaigns.
      */
     get fontFamily(): string | undefined;
-    onCampaignTriggered(payload: InAppPayload): void;
+    onCampaignTriggered(payload: InAppPayload): Promise<void>;
     onCampaignInvalidated(campaignId: string): void;
     /**
      * Subscribes to `digiaOverlayEvent` emitted by the native
@@ -94,6 +95,10 @@ declare class DigiaClass implements DigiaDelegate {
     private _extractCampaignKey;
     private _extractString;
     private _parseTemplateConfig;
+    private _loadOrCreateDeviceId;
+    private _getFrequencyState;
+    _bumpFrequencyImpression(campaignKey: string): Promise<void>;
+    _applyStopOn(campaignKey: string, interactionType: 'click' | 'dismiss'): Promise<void>;
     private _log;
 }
 export declare const Digia: DigiaClass;

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

@@ -1 +1 @@
-{"version":3,"file":"Digia.d.ts","sourceRoot":"","sources":["../../src/Digia.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,KAAK,EAER,WAAW,EACX,aAAa,EAEb,WAAW,EAEX,YAAY,EACf,MAAM,SAAS,CAAC;AAejB,cAAM,UAAW,YAAW,aAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAG3D,OAAO,CAAC,kBAAkB,CAAS;IAGnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmC;IACnE,OAAO,CAAC,mBAAmB,CAAmC;IAC9D,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;IAClE,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAqB;IAE3D;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BpD;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAgBnC;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAMlD;;;;;;OAMG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMpC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAMpE,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIzC;;;;OAIG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAOD,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAqEhD,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAQ/C;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,uBAAuB;IAyB/B,OAAO,CAAC,sBAAsB;IAoB9B,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,qBAAqB;IAqC7B,OAAO,CAAC,kBAAkB;YAOZ,qBAAqB;YAgCrB,QAAQ;IAkBtB,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,IAAI;CAMf;AAED,eAAO,MAAM,KAAK,YAAmB,CAAC"}
+{"version":3,"file":"Digia.d.ts","sourceRoot":"","sources":["../../src/Digia.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,OAAO,KAAK,EAER,WAAW,EACX,aAAa,EAEb,WAAW,EAIX,YAAY,EACf,MAAM,SAAS,CAAC;AAgBjB,cAAM,UAAW,YAAW,aAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAG3D,OAAO,CAAC,kBAAkB,CAAS;IAGnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmC;IACnE,OAAO,CAAC,mBAAmB,CAAmC;IAC9D,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkC;IAClE,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAqB;IAE3D;;;;;OAKG;IACG,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BpD;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAgBnC;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAMlD;;;;;;OAMG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMpC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAMpE,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIzC;;;;OAIG;IACH,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IAOK,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiF/D,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAQ/C;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,uBAAuB;IA8B/B,OAAO,CAAC,sBAAsB;IA8B9B,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,qBAAqB;IAqC7B,OAAO,CAAC,kBAAkB;YAOZ,qBAAqB;YAgCrB,QAAQ;IAmBtB,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,oBAAoB;YAkBd,qBAAqB;YAiBrB,kBAAkB;IAI1B,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB5D,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB5F,OAAO,CAAC,IAAI;CAMf;AAED,eAAO,MAAM,KAAK,YAAmB,CAAC"}

package/lib/typescript/DigiaAnchorView.d.ts

@@ -5,17 +5,21 @@
  * When a SHOW_TOOLTIP or SHOW_SPOTLIGHT campaign fires, the native SDK looks up this view
  * via AnchorRegistry and uses getLocationOnScreen() for accurate pixel-perfect coordinates.
  *
+ * Also reports layout into the JS digiaAnchorRegistry so JS-rendered guides (tooltip/spotlight)
+ * can position themselves relative to this anchor.
+ *
  * Usage:
  *   <DigiaAnchorView anchorKey="pdp_add_to_cart" style={{ alignSelf: 'flex-start' }}>
  *     <TouchableOpacity ...>Add to Cart</TouchableOpacity>
  *   </DigiaAnchorView>
  */
+import React from 'react';
 import { type ViewProps } from 'react-native';
 interface DigiaAnchorViewProps extends ViewProps {
     anchorKey: string;
     /** Corner radius in dp — used to round the spotlight cutout to match the wrapped button. */
     cornerRadius?: number;
 }
-export declare const DigiaAnchorView: import("react-native").HostComponent<DigiaAnchorViewProps>;
+export declare const DigiaAnchorView: ({ anchorKey, onLayout, ...rest }: DigiaAnchorViewProps) => React.JSX.Element;
 export {};
 //# sourceMappingURL=DigiaAnchorView.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"DigiaAnchorView.d.ts","sourceRoot":"","sources":["../../src/DigiaAnchorView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAA0B,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEtE,UAAU,oBAAqB,SAAQ,SAAS;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,eAAe,4DAAkE,CAAC"}
+{"version":3,"file":"DigiaAnchorView.d.ts","sourceRoot":"","sources":["../../src/DigiaAnchorView.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAA8B,MAAM,OAAO,CAAC;AACnD,OAAO,EAAgC,KAAK,SAAS,EAA0B,MAAM,cAAc,CAAC;AAGpG,UAAU,oBAAqB,SAAQ,SAAS;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,eAAO,MAAM,eAAe,GAAI,kCAAkC,oBAAoB,sBAqBrF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"DigiaProvider.d.ts","sourceRoot":"","sources":["../../src/DigiaProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAwuBxE,wBAAgB,SAAS,sBAExB"}
+{"version":3,"file":"DigiaProvider.d.ts","sourceRoot":"","sources":["../../src/DigiaProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AA0uBxE,wBAAgB,SAAS,sBAExB"}

package/lib/typescript/frequencyEvaluator.d.ts

@@ -0,0 +1,14 @@
+import type { FrequencyPolicy, FrequencyState, FrequencyEvalResult } from './types';
+export declare const isSessionPolicy: (policy: FrequencyPolicy) => boolean;
+/**
+ * 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.
+ */
+export declare const evaluate: (policy: FrequencyPolicy, state: FrequencyState | null, now: number) => FrequencyEvalResult;
+export declare const hasPolicy: (policy: FrequencyPolicy | null | undefined) => policy is FrequencyPolicy;
+//# sourceMappingURL=frequencyEvaluator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frequencyEvaluator.d.ts","sourceRoot":"","sources":["../../src/frequencyEvaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAQpF,eAAO,MAAM,eAAe,GAAI,QAAQ,eAAe,KAAG,OACX,CAAC;AAEhD;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,GACjB,QAAQ,eAAe,EACvB,OAAO,cAAc,GAAG,IAAI,EAC5B,KAAK,MAAM,KACZ,mBA2BF,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,QAAQ,eAAe,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM,IAAI,eAGW,CAAC"}

package/lib/typescript/frequencyStore.d.ts

@@ -0,0 +1,7 @@
+import type { FrequencyState } from './types';
+export declare const frequencyStore: {
+    checkProjectId(projectId: string): Promise<void>;
+    get(campaignKey: string, isSession: boolean): Promise<FrequencyState | null>;
+    set(campaignKey: string, state: FrequencyState, isSession: boolean): Promise<void>;
+};
+//# sourceMappingURL=frequencyStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frequencyStore.d.ts","sourceRoot":"","sources":["../../src/frequencyStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAqC9C,eAAO,MAAM,cAAc;8BACS,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;qBAiB/B,MAAM,aAAa,OAAO,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;qBAY3D,MAAM,SAAS,cAAc,aAAa,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAW3F,CAAC"}

package/lib/typescript/types.d.ts

@@ -98,7 +98,7 @@ export type GuideLifecycleEvent = {
  */
 export interface DigiaDelegate {
     /** Deliver a campaign payload into the Digia rendering engine. */
-    onCampaignTriggered(payload: InAppPayload): void;
+    onCampaignTriggered(payload: InAppPayload): void | Promise<void>;
     /** Invalidate / dismiss a campaign by its ID. */
     onCampaignInvalidated(campaignId: string): void;
 }
@@ -163,6 +163,28 @@ export type OnAction = (action: DigiaAction, context: ActionContext) => ActionRe
 export type InAppBrowserAdapter = {
     open: (url: string) => Promise<void>;
 };
+export interface FrequencyWindow {
+    count: number;
+    window: 'session' | 'day' | 'week' | 'month';
+}
+export interface FrequencyPolicy {
+    max_total: number | null;
+    max_per_window: FrequencyWindow | null;
+    stop_on: 'click' | 'dismiss' | 'any_action' | null;
+    min_gap_ms?: number | null;
+}
+export interface FrequencyState {
+    shown_count: number;
+    first_shown_at: number | null;
+    last_shown_at: number | null;
+    stopped_at: number | null;
+    stopped_reason: string | null;
+}
+export type FrequencySkipReason = 'max_total' | 'window' | 'stopped';
+export interface FrequencyEvalResult {
+    allow: boolean;
+    reason: FrequencySkipReason | null;
+}
 /**
  * Configuration for initialising the Digia Engage SDK.
  */

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.0.0-rc.1",
+  "version": "2.0.0-rc.2",
   "description": "React Native bridge for Digia Engage – renders native Android Compose UI inside React Native apps",
   "main": "src/index.ts",
   "module": "src/index.ts",
@@ -44,6 +44,10 @@
   },
   "author": "Digia Technology Private Limited",
   "license": "MIT",
+  "dependencies": {
+    "@react-native-async-storage/async-storage": "^2.1.2",
+    "react-native-uuid": "^2.0.3"
+  },
   "peerDependencies": {
     "@floating-ui/core": "^1.0.0",
     "react-native-reanimated": ">=3.0.0",

package/src/Digia.ts

@@ -20,12 +20,17 @@ 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';
 import type {
     CampaignType,
     DigiaConfig,
     DigiaDelegate,
     DigiaExperienceEvent,
     DigiaPlugin,
+    FrequencyPolicy,
+    FrequencyState,
     GuideLifecycleEvent,
     InAppPayload,
 } from './types';
@@ -41,6 +46,7 @@ interface SdkCampaign {
     campaign_key: string;
     campaign_type: CampaignType;
     templateConfig?: Record<string, unknown>;
+    frequency?: FrequencyPolicy | null;
 }
 
 class DigiaClass implements DigiaDelegate {
@@ -53,6 +59,7 @@ class DigiaClass implements DigiaDelegate {
     private readonly _activePayloads = new Map<string, InAppPayload>();
     private _engageSubscription: { remove(): void } | null = null;
     private _projectId = '';
+    private _deviceId = '';
     private _apiBaseUrl = '';
     private _logLevel: DigiaConfig['logLevel'] = 'error';
     private _fontFamily: string | undefined;
@@ -89,6 +96,8 @@ class DigiaClass implements DigiaDelegate {
             throw e;
         }
 
+        this._deviceId = await this._loadOrCreateDeviceId();
+        await frequencyStore.checkProjectId(config.projectId);
         await this._refreshCampaignStore();
     }
 
@@ -170,7 +179,7 @@ class DigiaClass implements DigiaDelegate {
     // Mirrors DigiaCEPDelegate on Android.
     // Forwards to the native DigiaCEPDelegate via the bridge.
 
-    onCampaignTriggered(payload: InAppPayload): void {
+    async onCampaignTriggered(payload: InAppPayload): Promise<void> {
         if (!this._nativeBridgeWired) {
             digiaHealthReporter.report(HealthEventType.plugin_not_registered, { campaign_key: payload.id });
         }
@@ -180,6 +189,18 @@ class DigiaClass implements DigiaDelegate {
 
         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);
@@ -270,16 +291,21 @@ class DigiaClass implements DigiaDelegate {
         const payload = this._activePayloads.get(data.campaignId);
         if (!payload) return;
 
+        const campaignKey = this._extractCampaignKey(payload);
+
         let event: DigiaExperienceEvent;
         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:
@@ -299,6 +325,16 @@ class DigiaClass implements DigiaDelegate {
         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);
@@ -403,6 +439,7 @@ class DigiaClass implements DigiaDelegate {
             headers: {
                 'Content-Type': 'application/json',
                 'x-digia-project-id': this._projectId,
+                'x-digia-device-id': this._deviceId,
             },
             body: JSON.stringify(body),
         });
@@ -489,6 +526,67 @@ class DigiaClass implements DigiaDelegate {
         return { ...raw, templateType: type, steps } as TemplateConfig;
     }
 
+    // ── Device ID ────────────────────────────────────────────────────────────
+
+    private async _loadOrCreateDeviceId(): Promise<string> {
+        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() as string;
+            await AsyncStorage.setItem(DEVICE_ID_KEY, id);
+            return id;
+        } catch {
+            return uuid.v4() as string;
+        }
+    }
+
+    // ── Frequency capping ────────────────────────────────────────────────────
+
+    private async _getFrequencyState(campaignKey: string, isSession: boolean): Promise<FrequencyState | null> {
+        return frequencyStore.get(campaignKey, isSession);
+    }
+
+    async _bumpFrequencyImpression(campaignKey: string): Promise<void> {
+        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: FrequencyState = {
+            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: string, interactionType: 'click' | 'dismiss'): Promise<void> {
+        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: FrequencyState = {
+            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);
+    }
+
     private _log(message: string): void {
         if (this._logLevel !== 'verbose') return;
         // eslint-disable-next-line no-console

package/src/DigiaAnchorView.tsx

@@ -5,13 +5,18 @@
  * When a SHOW_TOOLTIP or SHOW_SPOTLIGHT campaign fires, the native SDK looks up this view
  * via AnchorRegistry and uses getLocationOnScreen() for accurate pixel-perfect coordinates.
  *
+ * Also reports layout into the JS digiaAnchorRegistry so JS-rendered guides (tooltip/spotlight)
+ * can position themselves relative to this anchor.
+ *
  * Usage:
  *   <DigiaAnchorView anchorKey="pdp_add_to_cart" style={{ alignSelf: 'flex-start' }}>
  *     <TouchableOpacity ...>Add to Cart</TouchableOpacity>
  *   </DigiaAnchorView>
  */
 
-import { requireNativeComponent, type ViewProps } from 'react-native';
+import React, { useCallback, useRef } from 'react';
+import { requireNativeComponent, View, type ViewProps, type LayoutChangeEvent } from 'react-native';
+import { digiaAnchorRegistry } from './digiaAnchorRegistry';
 
 interface DigiaAnchorViewProps extends ViewProps {
     anchorKey: string;
@@ -19,4 +24,27 @@ interface DigiaAnchorViewProps extends ViewProps {
     cornerRadius?: number;
 }
 
-export const DigiaAnchorView = requireNativeComponent<DigiaAnchorViewProps>('DigiaAnchorView');
+const NativeDigiaAnchorView = requireNativeComponent<DigiaAnchorViewProps>('DigiaAnchorView');
+
+export const DigiaAnchorView = ({ anchorKey, onLayout, ...rest }: DigiaAnchorViewProps) => {
+    const viewRef = useRef<View>(null);
+
+    const handleLayout = useCallback((e: LayoutChangeEvent) => {
+        onLayout?.(e);
+        // Use measure() for absolute screen coordinates (onLayout gives relative coords)
+        viewRef.current?.measure((_x, _y, width, height, pageX, pageY) => {
+            if (width > 0 && height > 0) {
+                digiaAnchorRegistry.setLayout(anchorKey, { pageX, pageY, width, height });
+            }
+        });
+    }, [anchorKey, onLayout]);
+
+    return (
+        <NativeDigiaAnchorView
+            ref={viewRef as any}
+            anchorKey={anchorKey}
+            onLayout={handleLayout}
+            {...rest}
+        />
+    );
+};

package/src/DigiaProvider.tsx

@@ -221,7 +221,9 @@ function TooltipOverlay({
     useEffect(() => {
         setLayout(null);
         setFloatPos(null);
+        if (__DEV__) console.log(`[Digia] guide waiting for anchor key="${step.anchorKey}"`);
         return digiaAnchorRegistry.subscribe(step.anchorKey, (l) => {
+            if (__DEV__) console.log(`[Digia] anchor resolved key="${step.anchorKey}"`, l);
             setLayout(l);
         });
     }, [step.anchorKey]);

package/src/frequencyEvaluator.ts

@@ -0,0 +1,57 @@
+import type { FrequencyPolicy, FrequencyState, FrequencyEvalResult } from './types';
+
+const WINDOW_MS: Record<string, number> = {
+    day:   86_400_000,
+    week:  7 * 86_400_000,
+    month: 30 * 86_400_000,
+};
+
+export const isSessionPolicy = (policy: FrequencyPolicy): boolean =>
+    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.
+ */
+export const evaluate = (
+    policy: FrequencyPolicy,
+    state: FrequencyState | null,
+    now: number,
+): FrequencyEvalResult => {
+    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 };
+};
+
+export const hasPolicy = (policy: FrequencyPolicy | null | undefined): policy is FrequencyPolicy =>
+    policy !== null &&
+    policy !== undefined &&
+    (policy.max_total !== null || policy.max_per_window !== null || policy.stop_on !== null);