@booleanmaths/booleanmaths-rn-sdk 0.1.1 → 0.2.0

package/README.md

@@ -17,7 +17,7 @@ Android SDK.
 
 | Platform | Native SDK | Behaviour |
 | :------- | :--------- | :-------- |
-| Android  | ✅ `com.booleanmaths:bm-sdk:1.0.8` | Fully functional |
+| Android  | ✅ `com.booleanmaths:bm-sdk:1.0.9` | Fully functional |
 | iOS      | ❌ not published | Silent no-op, **never crashes** |
 | Web      | ❌ not published | Silent no-op, **never crashes** |
 
@@ -98,7 +98,7 @@ To pin a different native SDK version, set this in your app's **root**
 ```gradle
 buildscript {
     ext {
-        BooleanmathsRnSdk_bmSdkVersion = "1.0.8"
+        BooleanmathsRnSdk_bmSdkVersion = "1.0.9"
     }
 }
 ```
@@ -155,11 +155,21 @@ forwards the launch intent (see [Deep links](#deep-links-and-notification-attrib
 Records a custom event. `properties` defaults to `{}` and may contain strings,
 numbers, booleans, nested objects, and arrays.
 
-### `BooleanMaths.handleNotificationIntent(): void`
+### `BooleanMaths.handleIntent(): void`
 
 **Android only** (no-op elsewhere). Forwards the current Activity's intent to
-the native SDK so deep-link and notification campaign data is attributed. Safe
-to call repeatedly — the native SDK de-duplicates intents it has already seen.
+the native SDK so ad deep links, app links and push-notification campaign data
+are attributed. Safe to call repeatedly — the native SDK de-duplicates intents
+it has already seen.
+
+This is the single entry point for every kind of launch intent; native SDK
+1.0.9 unified them behind one method.
+
+### `BooleanMaths.handleNotificationIntent(): void`
+
+Deprecated alias of `handleIntent()`, kept so existing callers keep working.
+It calls straight through to the same native `handleIntent`, so there is no
+behavioural difference — prefer `handleIntent()` in new code.
 
 ### `BooleanMaths.getHelloMessage(): string | null`
 
@@ -181,7 +191,7 @@ app is never seen by those callbacks.**
 
 This wrapper works around it by forwarding `currentActivity.intent` at the end
 of `initialize()`. For links that arrive while the app is already running, call
-`handleNotificationIntent()` yourself:
+`handleIntent()` yourself:
 
 ```ts
 useEffect(() => {
@@ -189,13 +199,13 @@ useEffect(() => {
 
   // Deep link received while the app is running.
   const link = Linking.addEventListener('url', () => {
-    BooleanMaths.handleNotificationIntent();
+    BooleanMaths.handleIntent();
   });
 
   // Notification tap that brought the app back to the foreground.
   const state = AppState.addEventListener('change', (next) => {
     if (next === 'active') {
-      BooleanMaths.handleNotificationIntent();
+      BooleanMaths.handleIntent();
     }
   });
 
@@ -255,9 +265,11 @@ Watch it land with:
 adb logcat -s BooleanMathsSDK:D EventDispatcher:D
 ```
 
-A successful tap logs `Notification click tracked with campaign data.`,
-persists a `NotificationClick` event, and dispatches it with the campaign
-fields nested under `data.notification`.
+The demo's tap intent is an `ACTION_VIEW` deep link, so a successful tap logs
+`Deep link click tracked with campaign data.`, persists a `DeepLinkClick`
+event, and dispatches it with the campaign fields nested under `data.link`. An
+intent without `ACTION_VIEW` takes the `NotificationClick` path instead — see
+[Automatic events](#automatic-events).
 
 ---
 
@@ -269,31 +281,40 @@ The native SDK tracks these without any call from you:
 | :---- | :--- |
 | `app_opened` | First Activity creation / SDK initialization |
 | `FirstOpen` | Once per install, with Google Play Install Referrer attribution |
-| `NotificationClick` | Any intent with an action, data string, or extras is handled — see the caveat below |
+| `DeepLinkClick` | An `ACTION_VIEW` intent is handled — ad deep links and app links. Campaign fields nest under `data.link` |
+| `NotificationClick` | Any other intent carrying campaign data is handled. Fields nest under `data.notification` |
 
 Visitor ID and session ID (30-minute timeout) are generated and persisted
-natively.
-
-> ⚠️ **`NotificationClick` fires on ordinary app opens too (native SDK v1.0.7).**
-> `extractCampaignData` records `intent.action` unconditionally, and
-> `handleNotificationIntent` emits the event whenever the resulting map is
-> non-empty. A launcher tap always carries `action = ACTION_MAIN`, so opening
-> the app normally produces:
->
-> ```json
-> { "event": "NotificationClick",
->   "data": { "notification": { "action": "android.intent.action.MAIN" } } }
-> ```
->
-> So `NotificationClick` counts **notification taps plus plain opens**, and
-> cannot be used as a tap metric without filtering. A real tap is
-> distinguishable downstream: it carries a `data` deep link and/or campaign
-> extras, whereas a launcher open has only `action`.
+natively. Campaign data from a handled intent is also persisted by
+`AttributionManager` and attached to **every subsequent event** as
+`data.attribution` — natively, so `trackEvent` needs no extra work from you.
+
+### What counts as a campaign intent (native SDK v1.0.9)
+
+`handleIntent` ignores an intent when **all** of these hold, which is what a
+plain launcher tap looks like:
+
+- `action` is `ACTION_MAIN`, **and**
+- `categories` contains `CATEGORY_LAUNCHER`, **and**
+- there are no extras, **and**
+- `data` is `null`
+
+Anything else with non-empty campaign data is attributed: `ACTION_VIEW` emits
+`DeepLinkClick`, everything else emits `NotificationClick`. Intents are
+de-duplicated in a `WeakHashMap`, so re-forwarding the same intent is a no-op.
+
+> ℹ️ **This fixes a v1.0.7/v1.0.8 bug this README previously warned about.**
+> Older native SDKs recorded `intent.action` unconditionally and emitted
+> `NotificationClick` whenever the resulting map was non-empty — so an ordinary
+> launcher open produced a spurious
+> `{ "event": "NotificationClick", "data": { "notification": { "action": "android.intent.action.MAIN" } } }`
+> and the event could not be used as a tap metric without downstream
+> filtering. As of 1.0.9 the launcher case is skipped at the source, and real
+> deep links are split out into their own `DeepLinkClick` event.
 >
-> This wrapper reproduces the behaviour deliberately, for parity with native
-> Android and the Flutter wrapper — the native SDK does exactly the same via its
-> `onActivityCreated` callback. The fix belongs upstream in the Android SDK
-> (require deep-link data or extras before emitting the event), not here.
+> If you built dashboards or alerts that filter `NotificationClick` down to
+> real taps, revisit them: the noise is gone, and `ACTION_VIEW` taps now arrive
+> under a **different event name**.
 
 ---
 
@@ -311,7 +332,7 @@ Two normalizations happen on the Android side, both worth knowing:
   { "value": 2499, "items": [{ "quantity": 2, "price": 999.5 }] }
   ```
 
-  > ⚠️ **Known native SDK limitation (v1.0.7).** The integers do *not* survive
+  > ⚠️ **Known native SDK limitation (still present in v1.0.9).** The integers do *not* survive
   > to the wire. `EventDispatcher` re-reads the stored payload with
   > `gson.fromJson(properties, Map::class.java)`, and Gson coerces every number
   > in a raw `Map` to `Double` — so the request body ends up with `2499.0` and
@@ -358,7 +379,7 @@ explicit forwarding, and `singleTask` activities need `setIntent`.
 
 ## License
 
-MIT
+[Apache-2.0](LICENSE)
 
 ---
 

package/android/build.gradle

@@ -6,7 +6,7 @@ buildscript {
     // Version of the native Android SDK (com.booleanmaths:bm-sdk) this wrapper
     // is built against. Override with `ext.BooleanmathsRnSdk_bmSdkVersion` in
     // your app's root build.gradle to pin a different one.
-    bmSdkVersion: "1.0.8"
+    bmSdkVersion: "1.0.9"
   ]
 
   ext.getExtOrDefault = { prop ->

package/android/src/main/java/com/booleanmathsrnsdk/BooleanmathsRnSdkModule.kt

@@ -41,6 +41,16 @@ class BooleanmathsRnSdkModule(reactContext: ReactApplicationContext) :
     }
   }
 
+  override fun handleIntent() {
+    safely("handleIntent") { forwardCurrentIntent() }
+  }
+
+  /**
+   * Alias of [handleIntent]. The native SDK unified ad deep links, app links
+   * and push notifications behind `handleIntent` in 1.0.9 and kept
+   * `handleNotificationIntent` as a delegating alias; this mirrors that so
+   * apps written against the older name keep working unchanged.
+   */
   override fun handleNotificationIntent() {
     safely("handleNotificationIntent") { forwardCurrentIntent() }
   }
@@ -64,7 +74,7 @@ class BooleanmathsRnSdkModule(reactContext: ReactApplicationContext) :
 
     // The native SDK de-duplicates intents it has already processed, so
     // calling this more than once for the same intent is safe.
-    BooleanMathsSDK.handleNotificationIntent(intent)
+    BooleanMathsSDK.handleIntent(intent)
   }
 
   /**

package/ios/BooleanmathsRnSdk.mm

@@ -28,12 +28,18 @@ static void BMWarnUnsupportedOnce(void)
   BMWarnUnsupportedOnce();
 }
 
-- (void)handleNotificationIntent
+- (void)handleIntent
 {
   // Android-only concept; nothing to do on iOS even once an iOS SDK exists.
   BMWarnUnsupportedOnce();
 }
 
+- (void)handleNotificationIntent
+{
+  // Alias of handleIntent, mirroring the Android bridge.
+  BMWarnUnsupportedOnce();
+}
+
 - (NSString *)getHelloMessage
 {
   BMWarnUnsupportedOnce();

package/lib/module/BooleanMaths.js

@@ -23,6 +23,9 @@ export const BooleanMaths = {
   trackEvent(_name, _properties) {
     warnOnce();
   },
+  handleIntent() {
+    warnOnce();
+  },
   handleNotificationIntent() {
     warnOnce();
   },

package/lib/module/BooleanMaths.js.map

@@ -1 +1 @@
-{"version":3,"names":["hasWarned","warnOnce","__DEV__","console","warn","BooleanMaths","isSupported","initialize","_apiKey","_pixelId","trackEvent","_name","_properties","handleNotificationIntent","getHelloMessage"],"sourceRoot":"../../src","sources":["BooleanMaths.tsx"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAIA,SAAS,GAAG,KAAK;AAErB,SAASC,QAAQA,CAAA,EAAG;EAClB,IAAID,SAAS,IAAI,OAAOE,OAAO,KAAK,WAAW,IAAI,CAACA,OAAO,EAAE;IAC3D;EACF;EAEAF,SAAS,GAAG,IAAI;EAEhBG,OAAO,CAACC,IAAI,CACV,sFAAsF,GACpF,2EAA2E,GAC3E,8DACJ,CAAC;AACH;AAEA,OAAO,MAAMC,YAA6B,GAAG;EAC3CC,WAAW,EAAE,KAAK;EAElBC,UAAUA,CAACC,OAAe,EAAEC,QAAgB,EAAQ;IAClDR,QAAQ,CAAC,CAAC;EACZ,CAAC;EAEDS,UAAUA,CAACC,KAAa,EAAEC,WAAyC,EAAQ;IACzEX,QAAQ,CAAC,CAAC;EACZ,CAAC;EAEDY,wBAAwBA,CAAA,EAAS;IAC/BZ,QAAQ,CAAC,CAAC;EACZ,CAAC;EAEDa,eAAeA,CAAA,EAAkB;IAC/Bb,QAAQ,CAAC,CAAC;IACV,OAAO,IAAI;EACb;AACF,CAAC","ignoreList":[]}
+{"version":3,"names":["hasWarned","warnOnce","__DEV__","console","warn","BooleanMaths","isSupported","initialize","_apiKey","_pixelId","trackEvent","_name","_properties","handleIntent","handleNotificationIntent","getHelloMessage"],"sourceRoot":"../../src","sources":["BooleanMaths.tsx"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAIA,SAAS,GAAG,KAAK;AAErB,SAASC,QAAQA,CAAA,EAAG;EAClB,IAAID,SAAS,IAAI,OAAOE,OAAO,KAAK,WAAW,IAAI,CAACA,OAAO,EAAE;IAC3D;EACF;EAEAF,SAAS,GAAG,IAAI;EAEhBG,OAAO,CAACC,IAAI,CACV,sFAAsF,GACpF,2EAA2E,GAC3E,8DACJ,CAAC;AACH;AAEA,OAAO,MAAMC,YAA6B,GAAG;EAC3CC,WAAW,EAAE,KAAK;EAElBC,UAAUA,CAACC,OAAe,EAAEC,QAAgB,EAAQ;IAClDR,QAAQ,CAAC,CAAC;EACZ,CAAC;EAEDS,UAAUA,CAACC,KAAa,EAAEC,WAAyC,EAAQ;IACzEX,QAAQ,CAAC,CAAC;EACZ,CAAC;EAEDY,YAAYA,CAAA,EAAS;IACnBZ,QAAQ,CAAC,CAAC;EACZ,CAAC;EAEDa,wBAAwBA,CAAA,EAAS;IAC/Bb,QAAQ,CAAC,CAAC;EACZ,CAAC;EAEDc,eAAeA,CAAA,EAAkB;IAC/Bd,QAAQ,CAAC,CAAC;IACV,OAAO,IAAI;EACb;AACF,CAAC","ignoreList":[]}

package/lib/module/BooleanMaths.native.js

@@ -28,6 +28,20 @@ function warnOnce() {
   }
   console.warn('[@booleanmaths/booleanmaths-rn-sdk] The native module could not be found on ' + `${Platform.OS}. Rebuild the app after installing the package (a Metro ` + 'reload is not enough), and on iOS run `pod install`. All SDK calls are ' + 'no-ops until this is fixed.');
 }
+
+/**
+ * Shared by `handleIntent` and its `handleNotificationIntent` alias. A
+ * standalone function rather than `this.handleIntent()` so the alias keeps
+ * working when it is pulled off the object, as in
+ * `const { handleNotificationIntent } = BooleanMaths`.
+ */
+function forwardCurrentIntent() {
+  if (!isSupported) {
+    warnOnce();
+    return;
+  }
+  NativeBooleanmathsRnSdk.handleIntent();
+}
 export const BooleanMaths = {
   isSupported,
   initialize(apiKey, pixelId) {
@@ -44,13 +58,8 @@ export const BooleanMaths = {
     }
     NativeBooleanmathsRnSdk.trackEvent(name, properties);
   },
-  handleNotificationIntent() {
-    if (!isSupported) {
-      warnOnce();
-      return;
-    }
-    NativeBooleanmathsRnSdk.handleNotificationIntent();
-  },
+  handleIntent: forwardCurrentIntent,
+  handleNotificationIntent: forwardCurrentIntent,
   getHelloMessage() {
     if (!isSupported) {
       warnOnce();

package/lib/module/BooleanMaths.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["Platform","NativeBooleanmathsRnSdk","SUPPORTED_PLATFORMS","isPlatformSupported","includes","OS","isSupported","hasWarned","warnOnce","__DEV__","console","warn","BooleanMaths","initialize","apiKey","pixelId","initializeSdk","trackEvent","name","properties","handleNotificationIntent","getHelloMessage"],"sourceRoot":"../../src","sources":["BooleanMaths.native.tsx"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,cAAc;AACvC,OAAOC,uBAAuB,MAAM,8BAA2B;AAG/D;AACA;AACA;AACA;AACA;AACA,MAAMC,mBAAsD,GAAG,CAAC,SAAS,CAAC;AAE1E,MAAMC,mBAAmB,GAAGD,mBAAmB,CAACE,QAAQ,CAACJ,QAAQ,CAACK,EAAE,CAAC;;AAErE;AACA;AACA;AACA;AACA;AACA,MAAMC,WAAW,GAAGH,mBAAmB,IAAIF,uBAAuB,IAAI,IAAI;AAE1E,IAAIM,SAAS,GAAG,KAAK;AAErB,SAASC,QAAQA,CAAA,EAAG;EAClB,IAAID,SAAS,IAAI,CAACE,OAAO,EAAE;IACzB;EACF;EAEAF,SAAS,GAAG,IAAI;EAEhB,IAAI,CAACJ,mBAAmB,EAAE;IACxBO,OAAO,CAACC,IAAI,CACV,uFAAuFX,QAAQ,CAACK,EAAE,GAAG,GACnG,2EAA2E,GAC3E,2EAA2E,GAC3E,sEACJ,CAAC;IACD;EACF;EAEAK,OAAO,CAACC,IAAI,CACV,8EAA8E,GAC5E,GAAGX,QAAQ,CAACK,EAAE,0DAA0D,GACxE,yEAAyE,GACzE,6BACJ,CAAC;AACH;AAEA,OAAO,MAAMO,YAA6B,GAAG;EAC3CN,WAAW;EAEXO,UAAUA,CAACC,MAAc,EAAEC,OAAe,EAAQ;IAChD,IAAI,CAACT,WAAW,EAAE;MAChBE,QAAQ,CAAC,CAAC;MACV;IACF;IAEAP,uBAAuB,CAAEe,aAAa,CAACF,MAAM,EAAEC,OAAO,CAAC;EACzD,CAAC;EAEDE,UAAUA,CAACC,IAAY,EAAEC,UAAuC,GAAG,CAAC,CAAC,EAAQ;IAC3E,IAAI,CAACb,WAAW,EAAE;MAChBE,QAAQ,CAAC,CAAC;MACV;IACF;IAEAP,uBAAuB,CAAEgB,UAAU,CAACC,IAAI,EAAEC,UAAU,CAAC;EACvD,CAAC;EAEDC,wBAAwBA,CAAA,EAAS;IAC/B,IAAI,CAACd,WAAW,EAAE;MAChBE,QAAQ,CAAC,CAAC;MACV;IACF;IAEAP,uBAAuB,CAAEmB,wBAAwB,CAAC,CAAC;EACrD,CAAC;EAEDC,eAAeA,CAAA,EAAkB;IAC/B,IAAI,CAACf,WAAW,EAAE;MAChBE,QAAQ,CAAC,CAAC;MACV,OAAO,IAAI;IACb;IAEA,OAAOP,uBAAuB,CAAEoB,eAAe,CAAC,CAAC;EACnD;AACF,CAAC","ignoreList":[]}
+{"version":3,"names":["Platform","NativeBooleanmathsRnSdk","SUPPORTED_PLATFORMS","isPlatformSupported","includes","OS","isSupported","hasWarned","warnOnce","__DEV__","console","warn","forwardCurrentIntent","handleIntent","BooleanMaths","initialize","apiKey","pixelId","initializeSdk","trackEvent","name","properties","handleNotificationIntent","getHelloMessage"],"sourceRoot":"../../src","sources":["BooleanMaths.native.tsx"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,cAAc;AACvC,OAAOC,uBAAuB,MAAM,8BAA2B;AAG/D;AACA;AACA;AACA;AACA;AACA,MAAMC,mBAAsD,GAAG,CAAC,SAAS,CAAC;AAE1E,MAAMC,mBAAmB,GAAGD,mBAAmB,CAACE,QAAQ,CAACJ,QAAQ,CAACK,EAAE,CAAC;;AAErE;AACA;AACA;AACA;AACA;AACA,MAAMC,WAAW,GAAGH,mBAAmB,IAAIF,uBAAuB,IAAI,IAAI;AAE1E,IAAIM,SAAS,GAAG,KAAK;AAErB,SAASC,QAAQA,CAAA,EAAG;EAClB,IAAID,SAAS,IAAI,CAACE,OAAO,EAAE;IACzB;EACF;EAEAF,SAAS,GAAG,IAAI;EAEhB,IAAI,CAACJ,mBAAmB,EAAE;IACxBO,OAAO,CAACC,IAAI,CACV,uFAAuFX,QAAQ,CAACK,EAAE,GAAG,GACnG,2EAA2E,GAC3E,2EAA2E,GAC3E,sEACJ,CAAC;IACD;EACF;EAEAK,OAAO,CAACC,IAAI,CACV,8EAA8E,GAC5E,GAAGX,QAAQ,CAACK,EAAE,0DAA0D,GACxE,yEAAyE,GACzE,6BACJ,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,SAASO,oBAAoBA,CAAA,EAAS;EACpC,IAAI,CAACN,WAAW,EAAE;IAChBE,QAAQ,CAAC,CAAC;IACV;EACF;EAEAP,uBAAuB,CAAEY,YAAY,CAAC,CAAC;AACzC;AAEA,OAAO,MAAMC,YAA6B,GAAG;EAC3CR,WAAW;EAEXS,UAAUA,CAACC,MAAc,EAAEC,OAAe,EAAQ;IAChD,IAAI,CAACX,WAAW,EAAE;MAChBE,QAAQ,CAAC,CAAC;MACV;IACF;IAEAP,uBAAuB,CAAEiB,aAAa,CAACF,MAAM,EAAEC,OAAO,CAAC;EACzD,CAAC;EAEDE,UAAUA,CAACC,IAAY,EAAEC,UAAuC,GAAG,CAAC,CAAC,EAAQ;IAC3E,IAAI,CAACf,WAAW,EAAE;MAChBE,QAAQ,CAAC,CAAC;MACV;IACF;IAEAP,uBAAuB,CAAEkB,UAAU,CAACC,IAAI,EAAEC,UAAU,CAAC;EACvD,CAAC;EAEDR,YAAY,EAAED,oBAAoB;EAElCU,wBAAwB,EAAEV,oBAAoB;EAE9CW,eAAeA,CAAA,EAAkB;IAC/B,IAAI,CAACjB,WAAW,EAAE;MAChBE,QAAQ,CAAC,CAAC;MACV,OAAO,IAAI;IACb;IAEA,OAAOP,uBAAuB,CAAEsB,eAAe,CAAC,CAAC;EACnD;AACF,CAAC","ignoreList":[]}

package/lib/module/NativeBooleanmathsRnSdk.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","get"],"sourceRoot":"../../src","sources":["NativeBooleanmathsRnSdk.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;AAiBpE;AACA;AACA;AACA;AACA,eAAeA,mBAAmB,CAACC,GAAG,CAAO,mBAAmB,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","get"],"sourceRoot":"../../src","sources":["NativeBooleanmathsRnSdk.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA0B,cAAc;AAsBpE;AACA;AACA;AACA;AACA,eAAeA,mBAAmB,CAACC,GAAG,CAAO,mBAAmB,CAAC","ignoreList":[]}

package/lib/typescript/src/BooleanMaths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BooleanMaths.d.ts","sourceRoot":"","sources":["../../../src/BooleanMaths.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAA+B,MAAM,YAAS,CAAC;AAyB5E,eAAO,MAAM,YAAY,EAAE,eAmB1B,CAAC"}
+{"version":3,"file":"BooleanMaths.d.ts","sourceRoot":"","sources":["../../../src/BooleanMaths.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAA+B,MAAM,YAAS,CAAC;AAyB5E,eAAO,MAAM,YAAY,EAAE,eAuB1B,CAAC"}

package/lib/typescript/src/BooleanMaths.native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BooleanMaths.native.d.ts","sourceRoot":"","sources":["../../../src/BooleanMaths.native.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAA+B,MAAM,YAAS,CAAC;AA6C5E,eAAO,MAAM,YAAY,EAAE,eAsC1B,CAAC"}
+{"version":3,"file":"BooleanMaths.native.d.ts","sourceRoot":"","sources":["../../../src/BooleanMaths.native.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAA+B,MAAM,YAAS,CAAC;AA4D5E,eAAO,MAAM,YAAY,EAAE,eAiC1B,CAAC"}

package/lib/typescript/src/NativeBooleanmathsRnSdk.d.ts

@@ -9,6 +9,11 @@ export interface Spec extends TurboModule {
     initializeSdk(apiKey: string, pixelId: string): void;
     trackEvent(name: string, properties: Object): void;
     /** Android only. No-op elsewhere. */
+    handleIntent(): void;
+    /**
+     * Alias of `handleIntent`, kept so existing callers keep working. Android
+     * only. No-op elsewhere.
+     */
     handleNotificationIntent(): void;
     /** Smoke test that the native bridge is wired up. */
     getHelloMessage(): string;

package/lib/typescript/src/NativeBooleanmathsRnSdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeBooleanmathsRnSdk.d.ts","sourceRoot":"","sources":["../../../src/NativeBooleanmathsRnSdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,qCAAqC;IACrC,wBAAwB,IAAI,IAAI,CAAC;IACjC,qDAAqD;IACrD,eAAe,IAAI,MAAM,CAAC;CAC3B;AAED;;;GAGG;;AACH,wBAAkE"}
+{"version":3,"file":"NativeBooleanmathsRnSdk.d.ts","sourceRoot":"","sources":["../../../src/NativeBooleanmathsRnSdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,qCAAqC;IACrC,YAAY,IAAI,IAAI,CAAC;IACrB;;;OAGG;IACH,wBAAwB,IAAI,IAAI,CAAC;IACjC,qDAAqD;IACrD,eAAe,IAAI,MAAM,CAAC;CAC3B;AAED;;;GAGG;;AACH,wBAAkE"}

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

@@ -25,12 +25,24 @@ export interface BooleanMathsApi {
      */
     trackEvent(name: string, properties?: BooleanMathsEventProperties): void;
     /**
-     * Forwards the current Activity's intent to the native SDK so deep-link and
-     * notification campaign data is attributed.
+     * Forwards the current Activity's intent to the native SDK so ad deep links,
+     * app links and push-notification campaign data are attributed.
      *
-     * Android only — a no-op on every other platform. Call this from your
-     * deep-link handler and once after `initialize`; see the README for why the
-     * launch intent needs this.
+     * This is the primary entry point for every kind of launch intent. Android
+     * only — a no-op on every other platform. Call it from your deep-link
+     * handler; `initialize` already forwards the launch intent itself (see the
+     * README for why that needs special handling).
+     *
+     * Safe to call repeatedly — the native SDK de-duplicates intents it has
+     * already processed.
+     */
+    handleIntent(): void;
+    /**
+     * Backward-compatible alias of {@link handleIntent}.
+     *
+     * @deprecated Prefer `handleIntent()`, which names what it actually does:
+     * the native SDK routes deep links, app links and notifications through the
+     * same path. This alias will be kept for the foreseeable future.
      */
     handleNotificationIntent(): void;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GACjC,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,yBAAyB,EAAE,GAC3B;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAC9C,MAAM,EACN,yBAAyB,CAC1B,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAElD;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAEzE;;;;;;;OAOG;IACH,wBAAwB,IAAI,IAAI,CAAC;IAEjC;;;OAGG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,yBAAyB,GACjC,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,yBAAyB,EAAE,GAC3B;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,CAAA;CAAE,CAAC;AAEjD,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAC9C,MAAM,EACN,yBAAyB,CAC1B,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAElD;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAEzE;;;;;;;;;;;OAWG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;;;;;OAMG;IACH,wBAAwB,IAAI,IAAI,CAAC;IAEjC;;;OAGG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@booleanmaths/booleanmaths-rn-sdk",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "React Native SDK for BooleanMaths — track user events and attribution in mobile apps.",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/BooleanMaths.native.tsx

@@ -45,6 +45,21 @@ function warnOnce() {
   );
 }
 
+/**
+ * Shared by `handleIntent` and its `handleNotificationIntent` alias. A
+ * standalone function rather than `this.handleIntent()` so the alias keeps
+ * working when it is pulled off the object, as in
+ * `const { handleNotificationIntent } = BooleanMaths`.
+ */
+function forwardCurrentIntent(): void {
+  if (!isSupported) {
+    warnOnce();
+    return;
+  }
+
+  NativeBooleanmathsRnSdk!.handleIntent();
+}
+
 export const BooleanMaths: BooleanMathsApi = {
   isSupported,
 
@@ -66,14 +81,9 @@ export const BooleanMaths: BooleanMathsApi = {
     NativeBooleanmathsRnSdk!.trackEvent(name, properties);
   },
 
-  handleNotificationIntent(): void {
-    if (!isSupported) {
-      warnOnce();
-      return;
-    }
+  handleIntent: forwardCurrentIntent,
 
-    NativeBooleanmathsRnSdk!.handleNotificationIntent();
-  },
+  handleNotificationIntent: forwardCurrentIntent,
 
   getHelloMessage(): string | null {
     if (!isSupported) {

package/src/BooleanMaths.tsx

@@ -34,6 +34,10 @@ export const BooleanMaths: BooleanMathsApi = {
     warnOnce();
   },
 
+  handleIntent(): void {
+    warnOnce();
+  },
+
   handleNotificationIntent(): void {
     warnOnce();
   },

package/src/NativeBooleanmathsRnSdk.ts

@@ -10,6 +10,11 @@ export interface Spec extends TurboModule {
   initializeSdk(apiKey: string, pixelId: string): void;
   trackEvent(name: string, properties: Object): void;
   /** Android only. No-op elsewhere. */
+  handleIntent(): void;
+  /**
+   * Alias of `handleIntent`, kept so existing callers keep working. Android
+   * only. No-op elsewhere.
+   */
   handleNotificationIntent(): void;
   /** Smoke test that the native bridge is wired up. */
   getHelloMessage(): string;

package/src/types.ts

@@ -37,12 +37,25 @@ export interface BooleanMathsApi {
   trackEvent(name: string, properties?: BooleanMathsEventProperties): void;
 
   /**
-   * Forwards the current Activity's intent to the native SDK so deep-link and
-   * notification campaign data is attributed.
+   * Forwards the current Activity's intent to the native SDK so ad deep links,
+   * app links and push-notification campaign data are attributed.
    *
-   * Android only — a no-op on every other platform. Call this from your
-   * deep-link handler and once after `initialize`; see the README for why the
-   * launch intent needs this.
+   * This is the primary entry point for every kind of launch intent. Android
+   * only — a no-op on every other platform. Call it from your deep-link
+   * handler; `initialize` already forwards the launch intent itself (see the
+   * README for why that needs special handling).
+   *
+   * Safe to call repeatedly — the native SDK de-duplicates intents it has
+   * already processed.
+   */
+  handleIntent(): void;
+
+  /**
+   * Backward-compatible alias of {@link handleIntent}.
+   *
+   * @deprecated Prefer `handleIntent()`, which names what it actually does:
+   * the native SDK routes deep links, app links and notifications through the
+   * same path. This alias will be kept for the foreseeable future.
    */
   handleNotificationIntent(): void;