@booleanmaths/booleanmaths-rn-sdk 0.3.0 → 0.4.0

package/BooleanmathsRnSdk.podspec

@@ -10,8 +10,8 @@ Pod::Spec.new do |s|
   s.license      = package["license"]
   s.authors      = package["author"]
 
-  # No platform override needed. BooleanMathsSDK 1.0.1 lowered its own floor to
-  # 15.1, which is exactly React Native's min_ios_version_supported — pinning a
+  # No platform override needed. BooleanMathsSDK has declared a 15.1 floor since
+  # 1.0.1, which is exactly React Native's min_ios_version_supported — pinning a
   # higher floor here would push it onto every consuming app.
   s.platforms    = { :ios => min_ios_version_supported }
   s.source       = { :git => "https://github.com/medront/react-native-booleanmaths-sdk.git", :tag => "v#{s.version}" }
@@ -25,10 +25,12 @@ Pod::Spec.new do |s|
 
   s.swift_version = "5.9"
 
-  # `~> 1.0.1`, deliberately not `~> 1.0`: 1.0.0 is still published on Trunk
-  # carrying an iOS 17.0 deployment target, and resolving to it would break the
-  # install for any app below iOS 17.
-  s.dependency "BooleanMathsSDK", "~> 1.0.1"
+  # `~> 1.1` resolves to >= 1.1, < 2.0. The earlier pin carried a `.1` patch
+  # component purely to exclude 1.0.0, which is still published on Trunk carrying
+  # an iOS 17.0 deployment target and would break the install for any app below
+  # iOS 17. A 1.1 floor excludes it outright, so the patch component is no longer
+  # load-bearing and the range can stay open across minors.
+  s.dependency "BooleanMathsSDK", "~> 1.1"
 
   # Mirrors Android's BuildConfig.WRAPPER_VERSION, which is read from
   # package.json so the reported wrapper_version cannot drift from the published

package/README.md

@@ -18,8 +18,8 @@ call the same methods everywhere.
 
 | Platform | Native SDK | Behaviour |
 | :------- | :--------- | :-------- |
-| Android  | ✅ `com.booleanmaths:bm-sdk:1.0.9` | Fully functional |
-| iOS      | ✅ `BooleanMathsSDK 1.0.1` | Event tracking fully functional — see below |
+| Android  | ✅ `com.booleanmaths:bm-sdk:1.0.12` | Fully functional |
+| iOS      | ✅ `BooleanMathsSDK 1.1.0` | Event tracking fully functional — see below |
 | Web      | ❌ not published | Silent no-op, **never crashes** |
 
 ### What iOS supports
@@ -33,6 +33,8 @@ rather than a bug.
 | `initialize()` | ✅ | ✅ |
 | `trackEvent()` with nested properties | ✅ | ✅ |
 | `wrapper_type` / `wrapper_version` on every event | ✅ | ✅ |
+| `isDebug` → `environment` on every event | ✅ | ✅ |
+| `app_info` (package, version, install/update times) on every event | ✅ | ✅ |
 | Automatic `app_opened` | ✅ | ✅ |
 | Automatic `FirstOpen` (once per install) | ✅ | ✅ — but with no attribution payload, see below |
 | Visitor ID and 30-minute session handling | ✅ | ✅ |
@@ -140,11 +142,17 @@ To pin a different native SDK version, set this in your app's **root**
 ```gradle
 buildscript {
     ext {
-        BooleanmathsRnSdk_bmSdkVersion = "1.0.9"
+        BooleanmathsRnSdk_bmSdkVersion = "1.0.12"
     }
 }
 ```
 
+> ⚠️ **1.0.10 is the floor.** The wrapper calls
+> `BooleanMathsSDK.initialize(context, apiKey, pixelId, isDebug)`, and the
+> four-argument overload only exists from 1.0.10. Pinning anything older fails
+> the Kotlin compile with an unresolved-overload error rather than degrading at
+> runtime.
+
 ### iOS
 
 Autolinking picks the module up; run `pod install` to pull in the native SDK.
@@ -157,10 +165,10 @@ That resolves `BooleanMathsSDK` from CocoaPods Trunk. Points worth knowing:
 
 - **Minimum deployment target is iOS 15.1**, matching React Native's own floor,
   so adopting this SDK does not raise your app's minimum iOS version.
-- **The pod is pinned to `~> 1.0.1`,** deliberately not `~> 1.0`. Version 1.0.0
-  is still published with an iOS 17.0 floor, and resolving to it would break
-  the install for apps below iOS 17. Confirm your `Podfile.lock` shows
-  `BooleanMathsSDK (1.0.1)` or newer.
+- **The pod is constrained to `~> 1.1`** — that is, `>= 1.1, < 2.0`. The floor
+  matters: version 1.0.0 is still published with an iOS 17.0 floor, and
+  resolving to it would break the install for apps below iOS 17. Confirm your
+  `Podfile.lock` shows `BooleanMathsSDK (1.1.0)` or newer.
 - **The SDK ships as a closed-source, vendored *dynamic* XCFramework.**
   CocoaPods embeds and re-signs it with your app's identity. If you use
   `use_frameworks!`, both `:linkage => :static` and `:linkage => :dynamic`
@@ -182,6 +190,9 @@ import { BooleanMaths } from '@booleanmaths/booleanmaths-rn-sdk';
 // Once, as early as possible — typically in your root component.
 BooleanMaths.initialize('YOUR_API_KEY', 'YOUR_PIXEL_ID');
 
+// Or, to mark this build's events as development rather than production:
+BooleanMaths.initialize('YOUR_API_KEY', 'YOUR_PIXEL_ID', __DEV__);
+
 // Anywhere afterwards.
 BooleanMaths.trackEvent('purchase', {
   orderId: 'ORD-1024',
@@ -204,7 +215,7 @@ ignored.
 
 ## API
 
-### `BooleanMaths.initialize(apiKey, pixelId): void`
+### `BooleanMaths.initialize(apiKey, pixelId, isDebug?): void`
 
 Initializes the native SDK. Also registers this wrapper with the native SDK
 **before** initializing, so that even the automatic `FirstOpen` and `app_opened`
@@ -217,6 +228,39 @@ On Android it additionally forwards the launch intent (see
 [Deep links](#deep-links-and-notification-attribution)); there is no iOS
 equivalent.
 
+`isDebug` defaults to `false`. See [Debug mode](#debug-mode) below.
+
+### Debug mode
+
+Passing `isDebug: true` does two things on both platforms:
+
+1. **Every event this process tracks is stamped `environment: "development"`**
+   instead of `"production"`, in the `setup` block of the request payload.
+2. **The native SDK's verbose logging is switched on.** Warnings and errors —
+   "SDK is already initialized", network failures, malformed intents — are
+   logged *regardless* of this flag, so a broken integration is still
+   diagnosable in a production build. Only the routine per-event chatter
+   ("Persisted event", "Sending payload") is gated.
+
+The flag is recorded **per event, when the event is queued** — not when the
+queue is flushed. An event written by a debug build therefore stays marked as
+development even if it only reaches the network later, after an app restart.
+Both platforms migrated their local queue schemas for this (Room v6 → v7 on
+Android, SQLite v1 → v2 on iOS); the migration is automatic and no events are
+lost.
+
+The wrapper deliberately **does not** default this to `__DEV__`. Which
+environment events land in is a backend-routing decision, not a bundler one —
+release builds pointed at a development pixel are a normal QA setup. Pass
+`__DEV__` yourself if that is the behaviour you want:
+
+```ts
+BooleanMaths.initialize(API_KEY, PIXEL_ID, __DEV__);
+```
+
+Requires native SDK `bm-sdk` **1.0.10+** on Android and `BooleanMathsSDK`
+**1.1.0+** on iOS; both are the versions this wrapper depends on.
+
 ### `BooleanMaths.trackEvent(name, properties?): void`
 
 Records a custom event. `properties` defaults to `{}` and may contain strings,
@@ -379,7 +423,7 @@ persisted by `AttributionManager` and attached to **every subsequent event** as
 `data.attribution`. iOS produces no `data.attribution` block, since it handles
 no intents; Apple Search Ads attribution is deferred to a later release.
 
-### What counts as a campaign intent (native SDK v1.0.9)
+### What counts as a campaign intent (native SDK v1.0.12)
 
 `handleIntent` ignores an intent when **all** of these hold, which is what a
 plain launcher tap looks like:
@@ -449,7 +493,7 @@ costs you that one key and nothing else.
   { "value": 2499, "items": [{ "quantity": 2, "price": 999.5 }] }
   ```
 
-  > ⚠️ **Known native SDK limitation (still present in v1.0.9).** The integers do *not* survive
+  > ⚠️ **Known native SDK limitation (still present in v1.0.12).** 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

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.9"
+    bmSdkVersion: "1.0.12"
   ]
 
   ext.getExtOrDefault = { prop ->

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

@@ -8,17 +8,22 @@ import com.facebook.react.bridge.ReadableMap
 class BooleanmathsRnSdkModule(reactContext: ReactApplicationContext) :
   NativeBooleanmathsRnSdkSpec(reactContext) {
 
-  override fun initializeSdk(apiKey: String, pixelId: String) {
+  override fun initializeSdk(apiKey: String, pixelId: String, isDebug: Boolean) {
     safely("initialize") {
       // Stamp the wrapper identity *before* initialize() so the automatic
       // `app_opened` and `FirstOpen` events that the native SDK tracks during
       // initialization already carry wrapper_type / wrapper_version.
       applyWrapperConfig()
 
+      // `isDebug` is passed explicitly rather than left to the native default:
+      // it decides the `environment` field ("development" / "production") that
+      // every event carries, and it gates the native SDK's verbose logging.
+      // The JS wrapper always supplies it, defaulting to false.
       BooleanMathsSDK.initialize(
         reactApplicationContext.applicationContext,
         apiKey,
-        pixelId
+        pixelId,
+        isDebug
       )
 
       // ...and again afterwards, because the native SDK can only persist the

package/ios/BMBooleanMathsBridge.swift

@@ -35,10 +35,11 @@ public final class BMBooleanMathsBridge: NSObject {
   /// Named `initializeSdk` rather than `initialize` for the same reason the
   /// codegen spec is: `+[NSObject initialize]` already exists.
   @MainActor
-  @objc(initializeSdkWithApiKey:pixelId:wrapperVersion:)
+  @objc(initializeSdkWithApiKey:pixelId:isDebug:wrapperVersion:)
   public static func initializeSdk(
     apiKey: String,
     pixelId: String,
+    isDebug: Bool,
     wrapperVersion: String
   ) {
     // Before `initialize`, not after: `initialize` itself emits `FirstOpen` and
@@ -54,7 +55,11 @@ public final class BMBooleanMathsBridge: NSObject {
     // persisted one. One call, before initialize, is correct and sufficient.
     BooleanMaths.shared.setWrapperConfig(type: wrapperType, version: wrapperVersion)
 
-    BooleanMaths.shared.initialize(apiKey: apiKey, pixelId: pixelId)
+    // `isDebug` is passed explicitly rather than left to the SDK's default: it
+    // decides the `environment` field ("development" / "production") stamped on
+    // every event, and it gates the SDK's verbose logging. The JS wrapper always
+    // supplies it, defaulting to false. Same contract as Android.
+    BooleanMaths.shared.initialize(apiKey: apiKey, pixelId: pixelId, isDebug: isDebug)
 
     // There is no iOS equivalent of Android's forwardCurrentIntent(): deep links
     // are deferred on iOS, so nothing is forwarded here. See `handleIntent` in

package/ios/BooleanmathsRnSdk.mm

@@ -47,7 +47,7 @@ static void BMWarnIntentUnsupportedOnce(void)
   });
 }
 
-- (void)initializeSdk:(NSString *)apiKey pixelId:(NSString *)pixelId
+- (void)initializeSdk:(NSString *)apiKey pixelId:(NSString *)pixelId isDebug:(BOOL)isDebug
 {
   // Captured outside the block: it is a compile-time constant, not thread state.
   NSString *wrapperVersion = @BMRN_WRAPPER_VERSION;
@@ -58,6 +58,7 @@ static void BMWarnIntentUnsupportedOnce(void)
     BMSafely(@"initialize", ^{
       [BMBooleanMathsBridge initializeSdkWithApiKey:apiKey
                                             pixelId:pixelId
+                                            isDebug:isDebug
                                      wrapperVersion:wrapperVersion];
     });
   });

package/lib/module/BooleanMaths.js

@@ -17,7 +17,7 @@ function warnOnce() {
 }
 export const BooleanMaths = {
   isSupported: false,
-  initialize(_apiKey, _pixelId) {
+  initialize(_apiKey, _pixelId, _isDebug) {
     warnOnce();
   },
   trackEvent(_name, _properties) {

package/lib/module/BooleanMaths.js.map

@@ -1 +1 @@
-{"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":[]}
+{"version":3,"names":["hasWarned","warnOnce","__DEV__","console","warn","BooleanMaths","isSupported","initialize","_apiKey","_pixelId","_isDebug","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,EAAEC,QAAkB,EAAQ;IACtET,QAAQ,CAAC,CAAC;EACZ,CAAC;EAEDU,UAAUA,CAACC,KAAa,EAAEC,WAAyC,EAAQ;IACzEZ,QAAQ,CAAC,CAAC;EACZ,CAAC;EAEDa,YAAYA,CAAA,EAAS;IACnBb,QAAQ,CAAC,CAAC;EACZ,CAAC;EAEDc,wBAAwBA,CAAA,EAAS;IAC/Bd,QAAQ,CAAC,CAAC;EACZ,CAAC;EAEDe,eAAeA,CAAA,EAAkB;IAC/Bf,QAAQ,CAAC,CAAC;IACV,OAAO,IAAI;EACb;AACF,CAAC","ignoreList":[]}

package/lib/module/BooleanMaths.native.js

@@ -48,12 +48,16 @@ function forwardCurrentIntent() {
 }
 export const BooleanMaths = {
   isSupported,
-  initialize(apiKey, pixelId) {
+  initialize(apiKey, pixelId, isDebug = false) {
     if (!isSupported) {
       warnOnce();
       return;
     }
-    NativeBooleanmathsRnSdk.initializeSdk(apiKey, pixelId);
+
+    // Coerced rather than passed through: the codegen spec declares a
+    // non-optional boolean, and a truthy non-boolean from untyped JS would
+    // arrive at the native side as a type mismatch rather than a flag.
+    NativeBooleanmathsRnSdk.initializeSdk(apiKey, pixelId, Boolean(isDebug));
   },
   trackEvent(name, properties = {}) {
     if (!isSupported) {

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","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;AACA;AACA;AACA;AACA,MAAMC,mBAAsD,GAAG,CAC7D,SAAS,EACT,KAAK,CACN;AAED,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":[]}
+{"version":3,"names":["Platform","NativeBooleanmathsRnSdk","SUPPORTED_PLATFORMS","isPlatformSupported","includes","OS","isSupported","hasWarned","warnOnce","__DEV__","console","warn","forwardCurrentIntent","handleIntent","BooleanMaths","initialize","apiKey","pixelId","isDebug","initializeSdk","Boolean","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;AACA;AACA;AACA;AACA,MAAMC,mBAAsD,GAAG,CAC7D,SAAS,EACT,KAAK,CACN;AAED,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,EAAEC,OAAgB,GAAG,KAAK,EAAQ;IAC1E,IAAI,CAACZ,WAAW,EAAE;MAChBE,QAAQ,CAAC,CAAC;MACV;IACF;;IAEA;IACA;IACA;IACAP,uBAAuB,CAAEkB,aAAa,CAACH,MAAM,EAAEC,OAAO,EAAEG,OAAO,CAACF,OAAO,CAAC,CAAC;EAC3E,CAAC;EAEDG,UAAUA,CAACC,IAAY,EAAEC,UAAuC,GAAG,CAAC,CAAC,EAAQ;IAC3E,IAAI,CAACjB,WAAW,EAAE;MAChBE,QAAQ,CAAC,CAAC;MACV;IACF;IAEAP,uBAAuB,CAAEoB,UAAU,CAACC,IAAI,EAAEC,UAAU,CAAC;EACvD,CAAC;EAEDV,YAAY,EAAED,oBAAoB;EAElCY,wBAAwB,EAAEZ,oBAAoB;EAE9Ca,eAAeA,CAAA,EAAkB;IAC/B,IAAI,CAACnB,WAAW,EAAE;MAChBE,QAAQ,CAAC,CAAC;MACV,OAAO,IAAI;IACb;IAEA,OAAOP,uBAAuB,CAAEwB,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;AAsBpE;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;AA2BpE;AACA;AACA;AACA;AACA,eAAeA,mBAAmB,CAACC,GAAG,CAAO,mBAAmB,CAAC","ignoreList":[]}

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;AAmE5E,eAAO,MAAM,YAAY,EAAE,eAiC1B,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;AAmE5E,eAAO,MAAM,YAAY,EAAE,eAoC1B,CAAC"}

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

@@ -5,8 +5,13 @@ export interface Spec extends TurboModule {
      * already taken by `NativeModule.initialize()` on Android and by
      * `+[NSObject initialize]` on iOS. The public JS API exposes this as
      * `BooleanMaths.initialize()`.
+     *
+     * `isDebug` is required here even though it is optional on the public API —
+     * codegen has no notion of a default, so `BooleanMaths.initialize` always
+     * passes an explicit boolean. Same arrangement as `trackEvent`'s
+     * `properties`.
      */
-    initializeSdk(apiKey: string, pixelId: string): void;
+    initializeSdk(apiKey: string, pixelId: string, isDebug: boolean): void;
     trackEvent(name: string, properties: Object): void;
     /** Android only. No-op elsewhere. */
     handleIntent(): void;

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,YAAY,IAAI,IAAI,CAAC;IACrB;;;OAGG;IACH,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;;;;;;;;;;OAUG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACvE,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

@@ -15,8 +15,21 @@ export interface BooleanMathsApi {
      *
      * Calling this more than once is harmless — the native SDK ignores
      * subsequent calls.
+     *
+     * @param isDebug Marks this process as a development build. Every event it
+     * tracks is stamped `environment: "development"` instead of `"production"`,
+     * and the native SDKs' verbose logging is switched on. Defaults to `false`.
+     *
+     * The flag is recorded per event when the event is queued, not when the
+     * queue is flushed, so events written by a debug build stay marked as
+     * development even if they only sync later.
+     *
+     * It is deliberately *not* derived from `__DEV__` inside the wrapper —
+     * where an event lands is a backend-routing decision, not a bundler one, and
+     * some teams want release builds pointed at development. Pass `__DEV__`
+     * yourself if that is the behaviour you want.
      */
-    initialize(apiKey: string, pixelId: string): void;
+    initialize(apiKey: string, pixelId: string, isDebug?: boolean): void;
     /**
      * Records a custom event. Events are persisted locally and synced in the
      * background, so this never blocks and never throws on network failure.

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;;;;;;;;;;;;;;;OAeG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;;;;;OAMG;IACH,wBAAwB,IAAI,IAAI,CAAC;IAEjC;;;;;;;OAOG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;OAIG;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;;;;;;;;;;;;;;;;;;;OAmBG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAErE;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAEzE;;;;;;;;;;;;;;;OAeG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;;;;;OAMG;IACH,wBAAwB,IAAI,IAAI,CAAC;IAEjC;;;;;;;OAOG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@booleanmaths/booleanmaths-rn-sdk",
-  "version": "0.3.0",
+  "version": "0.4.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

@@ -70,13 +70,16 @@ function forwardCurrentIntent(): void {
 export const BooleanMaths: BooleanMathsApi = {
   isSupported,
 
-  initialize(apiKey: string, pixelId: string): void {
+  initialize(apiKey: string, pixelId: string, isDebug: boolean = false): void {
     if (!isSupported) {
       warnOnce();
       return;
     }
 
-    NativeBooleanmathsRnSdk!.initializeSdk(apiKey, pixelId);
+    // Coerced rather than passed through: the codegen spec declares a
+    // non-optional boolean, and a truthy non-boolean from untyped JS would
+    // arrive at the native side as a type mismatch rather than a flag.
+    NativeBooleanmathsRnSdk!.initializeSdk(apiKey, pixelId, Boolean(isDebug));
   },
 
   trackEvent(name: string, properties: BooleanMathsEventProperties = {}): void {

package/src/BooleanMaths.tsx

@@ -26,7 +26,7 @@ function warnOnce() {
 export const BooleanMaths: BooleanMathsApi = {
   isSupported: false,
 
-  initialize(_apiKey: string, _pixelId: string): void {
+  initialize(_apiKey: string, _pixelId: string, _isDebug?: boolean): void {
     warnOnce();
   },
 

package/src/NativeBooleanmathsRnSdk.ts

@@ -6,8 +6,13 @@ export interface Spec extends TurboModule {
    * already taken by `NativeModule.initialize()` on Android and by
    * `+[NSObject initialize]` on iOS. The public JS API exposes this as
    * `BooleanMaths.initialize()`.
+   *
+   * `isDebug` is required here even though it is optional on the public API —
+   * codegen has no notion of a default, so `BooleanMaths.initialize` always
+   * passes an explicit boolean. Same arrangement as `trackEvent`'s
+   * `properties`.
    */
-  initializeSdk(apiKey: string, pixelId: string): void;
+  initializeSdk(apiKey: string, pixelId: string, isDebug: boolean): void;
   trackEvent(name: string, properties: Object): void;
   /** Android only. No-op elsewhere. */
   handleIntent(): void;

package/src/types.ts

@@ -25,8 +25,21 @@ export interface BooleanMathsApi {
    *
    * Calling this more than once is harmless — the native SDK ignores
    * subsequent calls.
+   *
+   * @param isDebug Marks this process as a development build. Every event it
+   * tracks is stamped `environment: "development"` instead of `"production"`,
+   * and the native SDKs' verbose logging is switched on. Defaults to `false`.
+   *
+   * The flag is recorded per event when the event is queued, not when the
+   * queue is flushed, so events written by a debug build stay marked as
+   * development even if they only sync later.
+   *
+   * It is deliberately *not* derived from `__DEV__` inside the wrapper —
+   * where an event lands is a backend-routing decision, not a bundler one, and
+   * some teams want release builds pointed at development. Pass `__DEV__`
+   * yourself if that is the behaviour you want.
    */
-  initialize(apiKey: string, pixelId: string): void;
+  initialize(apiKey: string, pixelId: string, isDebug?: boolean): void;
 
   /**
    * Records a custom event. Events are persisted locally and synced in the