zixflow-reactnative 1.1.3 → 1.1.4

package/lib/module/utils/param-validation.js

@@ -3,6 +3,7 @@
 // Argument validation utilities for SDK internal use
 // Ensures input safety and throws clear errors when validation fails
 
+import { ZixflowColorScheme } from "../types/index.js";
 /**
  * Builds a standardized error message for validation failures.
  */
@@ -28,6 +29,16 @@ function failIf(condition, message) {
   }
 }
 
+/**
+ * Logs a warning if the condition is true.
+ * Use this for misconfigurations that degrade behavior but must not fail initialization.
+ */
+function warnIf(condition, message) {
+  if (__DEV__ && condition) {
+    console.warn(`[Zixflow] ${message()}`);
+  }
+}
+
 /**
  * Validates that a value is defined (not undefined or null).
  * Useful for checking required fields.
@@ -99,6 +110,67 @@ function validateAttributes(value, fieldName, options = {}) {
   return attributes;
 }
 
+/**
+ * The placeholder the SDK substitutes with the unread count when rendering
+ * `bellWithUnreadCount`.
+ */
+const COUNT_PLACEHOLDER = '{count}';
+
+/**
+ * Warns when `bellWithUnreadCount` is missing its `{count}` placeholder.
+ *
+ * The label is a template, not a finished string. A misspelled placeholder (`{COUNT}`,
+ * `{{count}}`, `%d`) matches nothing, so the template is announced verbatim — braces and all —
+ * and the count is never spoken. The check lives here rather than in either native layer
+ * because neither can report it usefully: Android logs at `debug`, which the default `ERROR`
+ * level discards, and iOS does not check at all. Warning from JavaScript reaches the
+ * developer's console on both platforms, whatever the SDK log level.
+ */
+function validateInboxAccessibilityLabels(value) {
+  if (isUndefined(value) || typeof value !== 'object') {
+    return;
+  }
+  const template = value.bellWithUnreadCount;
+  warnIf(typeof template === 'string' && !template.includes(COUNT_PLACEHOLDER), () => `"inApp.notificationInboxAccessibilityLabels.bellWithUnreadCount" has no ` + `"${COUNT_PLACEHOLDER}" placeholder, so the unread count will not be announced.`);
+}
+
+/**
+ * Warns when a value is not one of the `ZixflowColorScheme` values.
+ *
+ * TypeScript rejects a bad value already, but JavaScript callers reach both entry points
+ * untyped, and neither native layer reports the mistake at the default log level. The
+ * failure mode is a message rendered in the wrong theme with no error attached, so
+ * JavaScript is the only place the developer reliably sees it.
+ *
+ * `consequence` differs per entry point because the native fallback does: an unrecognized
+ * value at initialization resolves to `auto`, while the runtime setter leaves whatever
+ * scheme the app already chose in place.
+ */
+function warnIfNotColorScheme(value, fieldName, consequence) {
+  const allowed = Object.values(ZixflowColorScheme);
+  warnIf(!(typeof value === 'string' && allowed.includes(value)), () => `"${fieldName}" is not a valid ZixflowColorScheme (expected one of ` + `${allowed.join(', ')}), so ${consequence}.`);
+}
+
+/**
+ * Validates `inApp.colorScheme`. An absent value is legitimate here — the native SDKs
+ * already default to `auto` — so only a value the host actually set is checked.
+ */
+function validateConfigColorScheme(value) {
+  if (isUndefined(value)) {
+    return;
+  }
+  warnIfNotColorScheme(value, 'inApp.colorScheme', 'in-app messages will follow the device appearance');
+}
+
+/**
+ * Validates the argument to `setColorScheme`. Unlike the config field, an absent value is
+ * itself the mistake: the caller asked for a scheme change and named none, and there is no
+ * default to fall back to, so null and undefined are reported rather than skipped.
+ */
+function validateColorSchemeArgument(value) {
+  warnIfNotColorScheme(value, 'colorScheme', 'the color scheme will be left unchanged');
+}
+
 /**
  * Validates that the given value is a valid ZixflowConfig object.
  * Throws if required fields are missing or incorrectly typed.
@@ -115,6 +187,8 @@ function validateConfig(value) {
     allowEmpty: false,
     usage: usage
   });
+  validateConfigColorScheme(obj.inApp?.colorScheme);
+  validateInboxAccessibilityLabels(obj.inApp?.notificationInboxAccessibilityLabels);
 }
 
 // For type safety, we define a ConfigValidator type that asserts the value is a ZixflowConfig
@@ -124,7 +198,8 @@ export const assert = {
   string: validateString,
   record: validateRecord,
   attributes: validateAttributes,
-  config: validateConfig
+  config: validateConfig,
+  colorScheme: validateColorSchemeArgument
 };
 export const validate = {
   isUndefined: isUndefined

package/lib/module/utils/param-validation.js.map

@@ -1 +1 @@
-{"version":3,"names":["buildErrorMessage","usage","fieldName","error","prefix","isUndefined","value","undefined","failIf","condition","message","__DEV__","Error","failIfUndefined","validateString","options","allowEmpty","optional","typedValue","trim","validateRecord","expectedType","typeName","Array","isArray","validateAttributes","exists","attributes","Map","Object","fromEntries","validateConfig","obj","apiKey","assert","string","record","config","validate"],"sourceRoot":"../../../src","sources":["utils/param-validation.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["ZixflowColorScheme","buildErrorMessage","usage","fieldName","error","prefix","isUndefined","value","undefined","failIf","condition","message","__DEV__","Error","warnIf","console","warn","failIfUndefined","validateString","options","allowEmpty","optional","typedValue","trim","validateRecord","expectedType","typeName","Array","isArray","validateAttributes","exists","attributes","Map","Object","fromEntries","COUNT_PLACEHOLDER","validateInboxAccessibilityLabels","template","bellWithUnreadCount","includes","warnIfNotColorScheme","consequence","allowed","values","join","validateConfigColorScheme","validateColorSchemeArgument","validateConfig","obj","apiKey","inApp","colorScheme","notificationInboxAccessibilityLabels","assert","string","record","config","validate"],"sourceRoot":"../../../src","sources":["utils/param-validation.ts"],"mappings":";;AAAA;AACA;;AAEA,SAASA,kBAAkB,QAAQ,mBAAU;AAG7C;AACA;AACA;AACA,SAASC,iBAAiBA,CACxBC,KAAyB,EACzBC,SAAiB,EACjBC,KAAa,EACL;EACR,MAAMC,MAAM,GAAGH,KAAK,GAAG,GAAGA,KAAK,GAAG,GAAG,EAAE;EACvC,OAAO,GAAGG,MAAM,IAAIF,SAAS,KAAKC,KAAK,GAAG;AAC5C;;AAEA;AACA;AACA;AACA,SAASE,WAAWA,CAACC,KAAc,EAAW;EAC5C,OAAOA,KAAK,KAAKC,SAAS,IAAID,KAAK,KAAK,IAAI;AAC9C;;AAEA;AACA;AACA;AACA;AACA,SAASE,MAAMA,CAACC,SAAkB,EAAEC,OAAqB,EAAQ;EAC/D,IAAIC,OAAO,IAAIF,SAAS,EAAE;IACxB,MAAM,IAAIG,KAAK,CAAC,aAAaF,OAAO,CAAC,CAAC,EAAE,CAAC;EAC3C;AACF;;AAEA;AACA;AACA;AACA;AACA,SAASG,MAAMA,CAACJ,SAAkB,EAAEC,OAAqB,EAAQ;EAC/D,IAAIC,OAAO,IAAIF,SAAS,EAAE;IACxBK,OAAO,CAACC,IAAI,CAAC,aAAaL,OAAO,CAAC,CAAC,EAAE,CAAC;EACxC;AACF;;AAEA;AACA;AACA;AACA;AACA,SAASM,eAAeA,CACtBV,KAAc,EACdJ,SAAiB,EACjBD,KAAc,EACR;EACNO,MAAM,CAACH,WAAW,CAACC,KAAK,CAAC,EAAE,MACzBN,iBAAiB,CAACC,KAAK,EAAEC,SAAS,EAAE,aAAa,CACnD,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA,SAASe,cAAcA,CACrBX,KAAc,EACdJ,SAAiB,EACjBgB,OAIC,GAAG;EAAEC,UAAU,EAAE;AAAK,CAAC,EACxB;EACA,MAAM;IAAEA,UAAU;IAAElB,KAAK;IAAEmB;EAAS,CAAC,GAAGF,OAAO;EAC/C,IAAIE,QAAQ,IAAIf,WAAW,CAACC,KAAK,CAAC,EAAE;IAClC,OAAO,CAAC;EACV;EAEA,MAAMF,MAAM,GAAGH,KAAK,GAAG,GAAGA,KAAK,GAAG,GAAG,EAAE;EAEvCe,eAAe,CAACV,KAAK,EAAEJ,SAAS,EAAED,KAAK,CAAC;EACxCO,MAAM,CACJ,OAAOF,KAAK,KAAK,QAAQ,EACzB,MAAM,GAAGF,MAAM,IAAIF,SAAS,qBAC9B,CAAC;EACD;EACA;EACA,MAAMmB,UAAU,GAAGf,KAAe;EAClCE,MAAM,CACJ,CAACW,UAAU,IAAIE,UAAU,CAACC,IAAI,CAAC,CAAC,KAAK,EAAE,EACvC,MAAM,GAAGlB,MAAM,IAAIF,SAAS,+BAC9B,CAAC;AACH;;AAEA;AACA;AACA;AACA,SAASqB,cAAcA,CACrBjB,KAAc,EACdJ,SAAiB,EACjBgB,OAIC,GAAG,CAAC,CAAC,EACN;EACA,MAAM;IAAEjB,KAAK;IAAEuB,YAAY;IAAEJ;EAAS,CAAC,GAAGF,OAAO;EACjD,IAAIE,QAAQ,IAAIf,WAAW,CAACC,KAAK,CAAC,EAAE;IAClC,OAAO,CAAC;EACV;EAEA,MAAMF,MAAM,GAAGH,KAAK,GAAG,GAAGA,KAAK,GAAG,GAAG,EAAE;EACvC,MAAMwB,QAAQ,GAAGD,YAAY,IAAI,OAAO;EAExCR,eAAe,CAACV,KAAK,EAAEJ,SAAS,EAAED,KAAK,CAAC;EACxCO,MAAM,CACJ,OAAOF,KAAK,KAAK,QAAQ,IAAIoB,KAAK,CAACC,OAAO,CAACrB,KAAK,CAAC,EACjD,MAAM,GAAGF,MAAM,IAAIF,SAAS,qBAAqBuB,QAAQ,UAC3D,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA,SAASG,kBAAkBA,CACzBtB,KAAc,EACdJ,SAAiB,EACjBgB,OAIC,GAAG,CAAC,CAAC,EACwB;EAC9B,MAAMW,MAAM,GAAG,CAACxB,WAAW,CAACC,KAAK,CAAC;EAClC,IAAIY,OAAO,CAACE,QAAQ,IAAI,CAACS,MAAM,EAAE;IAC/B,OAAO,CAAC;EACV;EAEA,IAAIC,UAAmB;EACvB,IAAID,MAAM,IAAIvB,KAAK,YAAYyB,GAAG,EAAE;IAClC;IACAD,UAAU,GAAGE,MAAM,CAACC,WAAW,CAAC3B,KAAK,CAAC;EACxC,CAAC,MAAM;IACLwB,UAAU,GAAGxB,KAAK;EACpB;EACAiB,cAAc,CAACO,UAAU,EAAE5B,SAAS,EAAEgB,OAAO,CAAC;EAC9C,OAAOY,UAAU;AACnB;;AAEA;AACA;AACA;AACA;AACA,MAAMI,iBAAiB,GAAG,SAAS;;AAEnC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,gCAAgCA,CAAC7B,KAAc,EAAQ;EAC9D,IAAID,WAAW,CAACC,KAAK,CAAC,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;IACnD;EACF;EAEA,MAAM8B,QAAQ,GAAI9B,KAAK,CACpB+B,mBAAmB;EACtBxB,MAAM,CACJ,OAAOuB,QAAQ,KAAK,QAAQ,IAAI,CAACA,QAAQ,CAACE,QAAQ,CAACJ,iBAAiB,CAAC,EACrE,MACE,0EAA0E,GAC1E,IAAIA,iBAAiB,2DACzB,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASK,oBAAoBA,CAC3BjC,KAAc,EACdJ,SAAiB,EACjBsC,WAAmB,EACb;EACN,MAAMC,OAAiB,GAAGT,MAAM,CAACU,MAAM,CAAC3C,kBAAkB,CAAC;EAC3Dc,MAAM,CACJ,EAAE,OAAOP,KAAK,KAAK,QAAQ,IAAImC,OAAO,CAACH,QAAQ,CAAChC,KAAK,CAAC,CAAC,EACvD,MACE,IAAIJ,SAAS,uDAAuD,GACpE,GAAGuC,OAAO,CAACE,IAAI,CAAC,IAAI,CAAC,SAASH,WAAW,GAC7C,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA,SAASI,yBAAyBA,CAACtC,KAAc,EAAQ;EACvD,IAAID,WAAW,CAACC,KAAK,CAAC,EAAE;IACtB;EACF;EAEAiC,oBAAoB,CAClBjC,KAAK,EACL,mBAAmB,EACnB,mDACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA,SAASuC,2BAA2BA,CAACvC,KAAc,EAAQ;EACzDiC,oBAAoB,CAClBjC,KAAK,EACL,aAAa,EACb,yCACF,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA,SAASwC,cAAcA,CAACxC,KAAc,EAAkC;EACtE,MAAMJ,SAAS,GAAG,QAAQ;EAC1B,MAAMD,KAAK,GAAG,KAAK;EAEnBsB,cAAc,CAACjB,KAAK,EAAEJ,SAAS,EAAE;IAC/BsB,YAAY,EAAE,eAAe;IAC7BvB,KAAK,EAAEA;EACT,CAAC,CAAC;EAEF,MAAM8C,GAAG,GAAGzC,KAAsB;EAClCW,cAAc,CAAC8B,GAAG,CAACC,MAAM,EAAE,GAAG9C,SAAS,SAAS,EAAE;IAChDiB,UAAU,EAAE,KAAK;IACjBlB,KAAK,EAAEA;EACT,CAAC,CAAC;EACF2C,yBAAyB,CAACG,GAAG,CAACE,KAAK,EAAEC,WAAW,CAAC;EACjDf,gCAAgC,CAC9BY,GAAG,CAACE,KAAK,EAAEE,oCACb,CAAC;AACH;;AAEA;AACA;;AAGA,OAAO,MAAMC,MAMZ,GAAG;EACFC,MAAM,EAAEpC,cAAc;EACtBqC,MAAM,EAAE/B,cAAc;EACtBO,UAAU,EAAEF,kBAAkB;EAC9B2B,MAAM,EAAET,cAAc;EACtBI,WAAW,EAAEL;AACf,CAAC;AAED,OAAO,MAAMW,QAAQ,GAAG;EACtBnD,WAAW,EAAEA;AACf,CAAC","ignoreList":[]}

package/lib/module/zixflow-cdp.js

@@ -1,6 +1,8 @@
 "use strict";
 
+import { ZixflowGeofence } from "./zixflow-geofence.js";
 import { ZixflowInAppMessaging } from "./zixflow-inapp.js";
+import { ZixflowLiveActivities } from "./zixflow-liveactivities.js";
 import { ZixflowLocation } from "./zixflow-location.js";
 import { ZixflowPushMessaging } from "./zixflow-push.js";
 import { NativeLoggerListener } from "./native-logger-listener.js";
@@ -8,10 +10,21 @@ import { default as NativeModule } from "./specs/modules/NativeZixflow.js";
 import { ZixflowLogLevel } from "./types/index.js";
 import { callNativeModule, ensureNativeModule } from "./utils/native-bridge.js";
 import { assert, validate } from "./utils/param-validation.js";
-const packageJson = require('../../package.json');
+const packageJson = require('../package.json');
 
 // Track whether Zixflow SDK has been initialized to prevent usage before setup
 let _initialized = false;
+let deepLinkHandlerSubscription;
+
+/**
+ * Handles a Zixflow deep-link destination delivered from iOS.
+ * @public
+ */
+
+/**
+ * Removes a Zixflow deep-link handler.
+ * @public
+ */
 
 // Reference to the native Zixflow Data Pipelines module for SDK operations
 const nativeModule = ensureNativeModule(NativeModule);
@@ -43,6 +56,89 @@ export class Zixflow {
     });
   };
 
+  /**
+   * Signal that the app's React Native Linking listener is ready to receive Zixflow URLs.
+   *
+   * This is only needed by UIScene hosts that initialize Zixflow natively, such as Expo
+   * config-plugin auto-initialization. Call it after registering the Linking listener.
+   */
+  static setDeepLinkRoutingReady = () => {
+    return withNativeModule(native => native.setDeepLinkRoutingReady());
+  };
+
+  /**
+   * Register an acknowledged deep-link handler for an iOS UIScene host.
+   *
+   * This API only handles Zixflow destinations delivered through an iOS UIScene lifecycle.
+   * In a native React Native scene host, pair this with
+   * `NativeZixflow.configureAcknowledgedSceneDeepLinkRouting()` in the SceneDelegate. Register
+   * this before `initialize` when possible. Return `true` after routing a URL. Returning `false`,
+   * throwing, or rejecting lets the native SDK try the host AppDelegate, then React Native Linking
+   * for a host-owned custom scheme or the system for other URLs. Cold URLs are buffered until this
+   * handler is registered, subject to the native timeout. After delivery, the handler has ten
+   * seconds to settle. Once that timeout runs the native fallback, a late handler cannot cancel it
+   * and may cause a second navigation if it also routes the URL.
+   */
+  static setDeepLinkHandler = handler => {
+    if (typeof handler !== 'function') {
+      throw new Error('[Zixflow] "handler" must be a function.');
+    }
+
+    // Native unregister is tokenless and removes the current native handler. Remove the old
+    // subscription first so its cleanup cannot unregister the replacement.
+    deepLinkHandlerSubscription?.remove();
+    return withNativeModule(native => {
+      const nativeSubscription = native.onDeepLinkReceived(async data => {
+        const event = data;
+        if (typeof event.id !== 'string' || typeof event.url !== 'string') {
+          NativeLoggerListener.warn('Received an invalid native deep-link event.');
+          return;
+        }
+        let handled = false;
+        try {
+          handled = (await handler(event.url)) === true;
+        } catch (error) {
+          NativeLoggerListener.warn('Deep-link handler failed:', error);
+        }
+        try {
+          native.acknowledgeDeepLink(event.id, handled);
+        } catch (error) {
+          NativeLoggerListener.warn('Failed to acknowledge a deep-link result:', error);
+        }
+      });
+      let removed = false;
+      const subscription = {
+        remove: () => {
+          if (removed) {
+            return;
+          }
+          removed = true;
+          try {
+            native.unregisterDeepLinkHandler();
+          } finally {
+            nativeSubscription.remove();
+            if (deepLinkHandlerSubscription === subscription) {
+              deepLinkHandlerSubscription = undefined;
+            }
+          }
+        }
+      };
+      try {
+        native.registerDeepLinkHandler();
+      } catch (error) {
+        try {
+          native.unregisterDeepLinkHandler();
+        } catch {
+          // Preserve the registration error; the native timeout still owns pending URLs.
+        }
+        nativeSubscription.remove();
+        throw error;
+      }
+      deepLinkHandlerSubscription = subscription;
+      return subscription;
+    });
+  };
+
   /** Identify a user to start tracking their activity. Requires userId, traits, or both. */
   static identify = async ({
     userId,
@@ -147,7 +243,9 @@ export class Zixflow {
    * @deprecated This method will be removed in a future version. If you need this functionality, please contact us.
    */
   static isInitialized = () => _initialized;
+  static geofence = new ZixflowGeofence();
   static inAppMessaging = new ZixflowInAppMessaging();
+  static liveActivities = new ZixflowLiveActivities();
   static location = new ZixflowLocation();
   static pushMessaging = new ZixflowPushMessaging();
 }

package/lib/module/zixflow-cdp.js.map

@@ -1 +1 @@
-{"version":3,"names":["ZixflowInAppMessaging","ZixflowLocation","ZixflowPushMessaging","NativeLoggerListener","default","NativeModule","ZixflowLogLevel","callNativeModule","ensureNativeModule","assert","validate","packageJson","require","_initialized","nativeModule","withNativeModule","fn","Zixflow","initialize","config","inApp","siteId","apiKey","logLevel","None","expoVersion","args","packageSource","packageVersion","version","promise","native","then","identify","userId","traits","isUndefined","Error","string","allowEmpty","usage","optional","normalizedTraits","attributes","clearIdentify","track","name","properties","normalizedProps","screen","title","setProfileAttributes","normalizedAttrs","setDeviceAttributes","registerDeviceToken","token","deleteDeviceToken","trackMetric","deliveryID","deviceToken","event","isInitialized","inAppMessaging","location","pushMessaging","initNativeLogger"],"sourceRoot":"../../src","sources":["zixflow-cdp.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["ZixflowGeofence","ZixflowInAppMessaging","ZixflowLiveActivities","ZixflowLocation","ZixflowPushMessaging","NativeLoggerListener","default","NativeModule","ZixflowLogLevel","callNativeModule","ensureNativeModule","assert","validate","packageJson","require","_initialized","deepLinkHandlerSubscription","nativeModule","withNativeModule","fn","Zixflow","initialize","config","inApp","siteId","apiKey","logLevel","None","expoVersion","args","packageSource","packageVersion","version","promise","native","then","setDeepLinkRoutingReady","setDeepLinkHandler","handler","Error","remove","nativeSubscription","onDeepLinkReceived","data","event","id","url","warn","handled","error","acknowledgeDeepLink","removed","subscription","unregisterDeepLinkHandler","undefined","registerDeepLinkHandler","identify","userId","traits","isUndefined","string","allowEmpty","usage","optional","normalizedTraits","attributes","clearIdentify","track","name","properties","normalizedProps","screen","title","setProfileAttributes","normalizedAttrs","setDeviceAttributes","registerDeviceToken","token","deleteDeviceToken","trackMetric","deliveryID","deviceToken","isInitialized","geofence","inAppMessaging","liveActivities","location","pushMessaging","initNativeLogger"],"sourceRoot":"../../src","sources":["zixflow-cdp.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/zixflow-geofence.js

@@ -0,0 +1,50 @@
+"use strict";
+
+import { default as NativeModule } from "./specs/modules/NativeZixflowGeofence.js";
+
+/**
+ * Ensures all methods defined in codegen spec are implemented by the public module
+ *
+ * @internal
+ */
+
+// Geofence is an optional module — NativeModule may be null when geofence is not enabled.
+// Methods silently no-op when the native module is unavailable, with a one-time dev warning.
+let hasWarnedNotEnabled = false;
+const withNativeModule = fn => {
+  if (NativeModule) {
+    fn(NativeModule);
+  } else if (__DEV__ && !hasWarnedNotEnabled) {
+    hasWarnedNotEnabled = true;
+    console.warn('Zixflow: Geofence module is not enabled. ' + 'To use geofence features, set zixflow_geofence_enabled=true in ' + 'gradle.properties (Android) or add the geofence subspec to your Podfile (iOS).');
+  }
+};
+
+/**
+ * Public entry point for the optional Geofence module.
+ *
+ * Geofence runs automatically once enabled. Apps opt in by passing a `geofence` config to
+ * `initialize` and enabling the module at build time: set `zixflow_geofence_enabled=true`
+ * in `gradle.properties` (Android) or add the `geofence` subspec to your Podfile (iOS).
+ * Enabling geofence also enables the Location module, which geofence depends on.
+ *
+ * @public
+ */
+export class ZixflowGeofence {
+  /**
+   * Requests a one-shot location fix and refreshes the nearby geofence set from it,
+   * without sending a location analytics event (unlike
+   * `Zixflow.location.requestLocationUpdate()`) and without caching the fix.
+   *
+   * Call this after the host app has been granted location permission — the SDK never
+   * requests permission itself. It is the primary way to drive geofencing when the module
+   * is configured with `MANUAL` location mode; with the default `AUTOMATIC` the SDK acquires
+   * location on its own and this only forces an immediate refresh.
+   *
+   * No-ops if the geofence module is not enabled or a user has not been identified.
+   */
+  refreshFromCurrentLocation() {
+    return withNativeModule(native => native.refreshFromCurrentLocation());
+  }
+}
+//# sourceMappingURL=zixflow-geofence.js.map

package/lib/module/zixflow-geofence.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["default","NativeModule","hasWarnedNotEnabled","withNativeModule","fn","__DEV__","console","warn","ZixflowGeofence","refreshFromCurrentLocation","native"],"sourceRoot":"../../src","sources":["zixflow-geofence.ts"],"mappings":";;AACA,SACEA,OAAO,IAAIC,YAAY,QAElB,0CAAuC;;AAE9C;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA,IAAIC,mBAAmB,GAAG,KAAK;AAC/B,MAAMC,gBAAgB,GAAIC,EAAiC,IAAW;EACpE,IAAIH,YAAY,EAAE;IAChBG,EAAE,CAACH,YAAY,CAAC;EAClB,CAAC,MAAM,IAAII,OAAO,IAAI,CAACH,mBAAmB,EAAE;IAC1CA,mBAAmB,GAAG,IAAI;IAC1BI,OAAO,CAACC,IAAI,CACV,2CAA2C,GACzC,iEAAiE,GACjE,gFACJ,CAAC;EACH;AACF,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,eAAe,CAA+B;EACzD;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,0BAA0BA,CAAA,EAAS;IACjC,OAAON,gBAAgB,CAAEO,MAAM,IAAKA,MAAM,CAACD,0BAA0B,CAAC,CAAC,CAAC;EAC1E;AACF","ignoreList":[]}

package/lib/module/zixflow-inapp.js

@@ -2,9 +2,11 @@
 
 import { InlineInAppMessageView } from "./components/index.js";
 import { NativeLoggerListener } from "./native-logger-listener.js";
-import { NotificationInbox } from "./notification-inbox.js";
+import { NotificationInbox, parseInboxMessage } from "./notification-inbox.js";
 import NativeZixflowMessagingInApp from "./specs/modules/NativeZixflowMessagingInApp.js";
+import { InboxMessageEvent } from "./types/index.js";
 import { callNativeModule, ensureNativeModule } from "./utils/native-bridge.js";
+import { assert } from "./utils/param-validation.js";
 
 /**
  * Ensures all methods defined in codegen spec are implemented by the public module
@@ -26,6 +28,12 @@ const withNativeModule = fn => {
  * @public
  */
 class ZixflowInAppMessaging {
+  /**
+   * Live inbox subscriptions. The SDK's inbox forwarder is a SINGLE global listener, so it is
+   * registered when the first subscription is created and unregistered when the last one goes away —
+   * never per subscription, or one `remove()` would tear it out from under the others.
+   */
+  _inboxListenerCount = 0;
   registerEventsListener(listener) {
     const emitter = data => {
       // Convert raw native payload to InAppMessageEvent
@@ -51,6 +59,77 @@ class ZixflowInAppMessaging {
     });
   }
 
+  /**
+   * Registers a listener for Visual Notification Inbox events (action taken,
+   * shown, opened, dismissed).
+   *
+   * While a listener is registered the host owns action navigation: the native
+   * SDK suppresses its default action handling and forwards the event here.
+   * Call `.remove()` on the returned subscription to unregister and restore the
+   * SDK's default behavior.
+   *
+   * @param listener - callback invoked with an {@link InboxMessageEvent}
+   * @returns an EventSubscription; call `.remove()` to stop listening
+   */
+  registerInboxEventListener(listener) {
+    const emitter = data => {
+      // Convert raw native payload to InboxMessageEvent with a parsed message
+      const event = new InboxMessageEvent(data.eventType, parseInboxMessage(data.message), data.actionName, data.actionValue);
+      listener(event);
+    };
+    return withNativeModule(native => {
+      let registeredNativeForwarder = false;
+      try {
+        // Register the native forwarder with the SDK, then subscribe to the
+        // codegen-generated event emitter.
+        // Wrapped in try-catch due to previous reports of crashes on certain Android architectures.
+        if (this._inboxListenerCount === 0) {
+          native.registerInboxEventListener();
+          registeredNativeForwarder = true;
+        }
+        const subscription = native.onInboxEventReceived(emitter);
+        this._inboxListenerCount += 1;
+
+        // Wrap remove() so unregistering the LAST JS listener also unregisters the native forwarder
+        // (restoring the SDK's default action handling). Guarded so a double remove() cannot
+        // unbalance the count and drop the forwarder while other subscriptions are still live.
+        const originalRemove = subscription.remove.bind(subscription);
+        let removed = false;
+        subscription.remove = () => {
+          if (removed) {
+            return;
+          }
+          removed = true;
+          originalRemove();
+          this._inboxListenerCount -= 1;
+          if (this._inboxListenerCount === 0) {
+            withNativeModule(n => n.unregisterInboxEventListener());
+          }
+        };
+        return subscription;
+      } catch (error) {
+        // If the forwarder was registered and subscribing then failed, roll it back. Otherwise the
+        // SDK keeps suppressing its own action handling while nothing in JS is listening, so inbox
+        // actions are reported as handled and silently go nowhere.
+        if (registeredNativeForwarder) {
+          try {
+            native.unregisterInboxEventListener();
+          } catch (rollbackError) {
+            NativeLoggerListener.warn('Failed to roll back inbox listener registration:', rollbackError);
+          }
+        }
+        NativeLoggerListener.warn('Failed to attach inbox event listener:', error);
+        // Return a no-op subscription to maintain backwards compatibility
+        return {
+          remove: () => {},
+          eventType: '',
+          key: 0,
+          subscriber: null
+        };
+      }
+    });
+  }
+
   /**
    * Dismisses any currently displayed in-app message
    */
@@ -58,6 +137,23 @@ class ZixflowInAppMessaging {
     withNativeModule(native => native.dismissMessage());
   }
 
+  /**
+   * Overrides the color scheme used to render in-app messages.
+   *
+   * Takes effect immediately: messages already on screen — inline views included — are
+   * re-themed in place, so this can be called whenever the app's appearance setting
+   * changes rather than only before a message is shown.
+   *
+   * @param colorScheme - scheme to render with; `ZixflowColorScheme.Auto` returns to following
+   * the device appearance
+   */
+  setColorScheme(colorScheme) {
+    // Validated here as well as in `initialize`: this is a public method reachable from
+    // untyped JavaScript, and without it a bad value reaches the native fallback silently.
+    assert.colorScheme(colorScheme);
+    withNativeModule(native => native.setColorScheme(colorScheme));
+  }
+
   /**
    * Gets the message inbox instance for managing inbox messages
    *
@@ -87,6 +183,8 @@ class InAppMessageEvent {
 
 // Export in-app messaging types and components for simplified imports
 
+export { NotificationInboxBellView, NotificationInboxView } from "./components/index.js";
 export { NotificationInbox } from "./notification-inbox.js";
+export { InboxEventType, InboxMessageEvent } from "./types/index.js";
 export { ZixflowInAppMessaging, InAppMessageEvent, InlineInAppMessageView };
 //# sourceMappingURL=zixflow-inapp.js.map

package/lib/module/zixflow-inapp.js.map

@@ -1 +1 @@
-{"version":3,"names":["InlineInAppMessageView","NativeLoggerListener","NotificationInbox","NativeZixflowMessagingInApp","callNativeModule","ensureNativeModule","nativeModule","withNativeModule","fn","ZixflowInAppMessaging","registerEventsListener","listener","emitter","data","event","InAppMessageEvent","eventType","messageId","deliveryId","actionValue","actionName","native","onInAppEventReceived","error","warn","remove","key","subscriber","dismissMessage","inbox","_notificationInbox","constructor"],"sourceRoot":"../../src","sources":["zixflow-inapp.ts"],"mappings":";;AACA,SAASA,sBAAsB,QAAQ,uBAAc;AACrD,SAASC,oBAAoB,QAAQ,6BAA0B;AAC/D,SACEC,iBAAiB,QAEZ,yBAAsB;AAC7B,OAAOC,2BAA2B,MAE3B,gDAA6C;AAEpD,SAASC,gBAAgB,EAAEC,kBAAkB,QAAQ,0BAAuB;;AAE5E;AACA;AACA;AACA;AACA;;AAMA;AACA,MAAMC,YAAY,GAAGD,kBAAkB,CAACF,2BAA2B,CAAC;;AAEpE;AACA,MAAMI,gBAAgB,GAAOC,EAA8B,IAAQ;EACjE,OAAOJ,gBAAgB,CAACE,YAAY,EAAEE,EAAE,CAAC;AAC3C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA,MAAMC,qBAAqB,CAA4B;EAGrDC,sBAAsBA,CACpBC,QAA4C,EACzB;IACnB,MAAMC,OAAO,GAAIC,IAAS,IAAK;MAC7B;MACA,MAAMC,KAAK,GAAG,IAAIC,iBAAiB,CACjCF,IAAI,CAACG,SAAS,EACdH,IAAI,CAACI,SAAS,EACdJ,IAAI,CAACK,UAAU,EACfL,IAAI,CAACM,WAAW,EAChBN,IAAI,CAACO,UACP,CAAC;MACDT,QAAQ,CAACG,KAAK,CAAC;IACjB,CAAC;IAED,OAAOP,gBAAgB,CAAEc,MAAM,IAAK;MAClC,IAAI;QACF;QACA;QACA;QACA,OAAOA,MAAM,CAACC,oBAAoB,CAACV,OAAO,CAAC;MAC7C,CAAC,CAAC,OAAOW,KAAK,EAAE;QACdtB,oBAAoB,CAACuB,IAAI,CACvB,yCAAyC,EACzCD,KACF,CAAC;QACD;QACA,OAAO;UACLE,MAAM,EAAEA,CAAA,KAAM,CAAC,CAAC;UAChBT,SAAS,EAAE,EAAE;UACbU,GAAG,EAAE,CAAC;UACNC,UAAU,EAAE;QACd,CAAC;MACH;IACF,CAAC,CAAC;EACJ;;EAEA;AACF;AACA;EACEC,cAAcA,CAAA,EAAG;IACfrB,gBAAgB,CAAEc,MAAM,IAAKA,MAAM,CAACO,cAAc,CAAC,CAAC,CAAC;EACvD;;EAEA;AACF;AACA;AACA;AACA;EACEC,KAAKA,CAAA,EAAsB;IACzB,IAAI,CAAC,IAAI,CAACC,kBAAkB,EAAE;MAC5B,IAAI,CAACA,kBAAkB,GAAG,IAAI5B,iBAAiB,CAAC,CAAC;IACnD;IACA,OAAO,IAAI,CAAC4B,kBAAkB;EAChC;AACF;;AAEA;AACA;AACA;AACA;AACA,MAAMf,iBAAiB,CAAC;EAOtBgB,WAAWA,CACTf,SAAgC,EAChCC,SAAiB,EACjBC,UAAmB,EACnBC,WAAoB,EACpBC,UAAmB,EACnB;IACA,IAAI,CAACJ,SAAS,GAAGA,SAAS;IAC1B,IAAI,CAACE,UAAU,GAAGA,UAAU;IAC5B,IAAI,CAACD,SAAS,GAAGA,SAAS;IAC1B,IAAI,CAACE,WAAW,GAAGA,WAAW;IAC9B,IAAI,CAACC,UAAU,GAAGA,UAAU;EAC9B;AACF;;AAEA;;AAEA,SAASlB,iBAAiB,QAAQ,yBAAsB;AAExD,SAASO,qBAAqB,EAAEM,iBAAiB,EAAEf,sBAAsB","ignoreList":[]}
+{"version":3,"names":["InlineInAppMessageView","NativeLoggerListener","NotificationInbox","parseInboxMessage","NativeZixflowMessagingInApp","InboxMessageEvent","callNativeModule","ensureNativeModule","assert","nativeModule","withNativeModule","fn","ZixflowInAppMessaging","_inboxListenerCount","registerEventsListener","listener","emitter","data","event","InAppMessageEvent","eventType","messageId","deliveryId","actionValue","actionName","native","onInAppEventReceived","error","warn","remove","key","subscriber","registerInboxEventListener","message","registeredNativeForwarder","subscription","onInboxEventReceived","originalRemove","bind","removed","n","unregisterInboxEventListener","rollbackError","dismissMessage","setColorScheme","colorScheme","inbox","_notificationInbox","constructor","NotificationInboxBellView","NotificationInboxView","InboxEventType"],"sourceRoot":"../../src","sources":["zixflow-inapp.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/zixflow-liveactivities.js

@@ -0,0 +1,80 @@
+"use strict";
+
+import { default as NativeModule } from "./specs/modules/NativeZixflowLiveActivities.js";
+
+/**
+ * Ensures all methods defined in codegen spec are implemented by the public module
+ *
+ * @internal
+ */
+
+/**
+ * Live Activities (iOS) / Live Notifications (Android).
+ *
+ * Start, update, and end live, updating notifications from built-in templates
+ * (Segments, Countdown Timer). Enable the activity types via the `liveNotifications`
+ * key of the SDK config passed to {@link Zixflow.initialize}.
+ *
+ * @public
+ */
+export class ZixflowLiveActivities {
+  /**
+   * Report an opened Live Activity and return the URL the app should route.
+   *
+   * Zixflow tracking URLs are unwrapped to their destination after attribution is recorded.
+   * A tracking URL without a destination returns `null`; any other URL is returned unchanged.
+   * This method never rejects, so it can safely compose with Expo Router's
+   * `redirectSystemPath` hook. On Android it is a pass-through.
+   *
+   * Use this in exactly one URL-routing layer. Calling it more than once for the same Zixflow
+   * tracking URL reports more than one opened event.
+   *
+   * @param url - The incoming URL from the host's linking lifecycle.
+   * @returns The URL to route, or `null` when the Zixflow URL has no destination.
+   */
+  async handleWidgetUrl(url) {
+    try {
+      return await NativeModule.handleWidgetUrl(url);
+    } catch {
+      return url;
+    }
+  }
+
+  /**
+   * Start a built-in-template activity.
+   *
+   * @param payload - Template payload; `payload.type` selects the template.
+   * @returns The SDK-minted activity id, used for later `update`/`end`.
+   */
+  start(payload) {
+    return NativeModule.start(payload);
+  }
+
+  /**
+   * Replace the whole content-state of a running activity.
+   *
+   * ActivityKit (iOS) replaces content-state wholesale, so pass the **full** desired
+   * state — not just the changed fields. Static attributes (e.g. `header`) cannot
+   * change after start and are ignored on iOS.
+   *
+   * @param activityId - Id returned by {@link ZixflowLiveActivities.start}.
+   * @param payload - The complete desired state.
+   */
+  update(activityId, payload) {
+    return NativeModule.update(activityId, payload);
+  }
+
+  /**
+   * End a running activity, optionally rendering a final content-state.
+   *
+   * @param activityId - Id returned by {@link ZixflowLiveActivities.start}.
+   * @param payload - **iOS only.** The final content-state to render as the activity ends.
+   *   ActivityKit keeps the last content-state on screen when none is given, so pass one to show
+   *   a terminal state (e.g. all segments complete). Android renders its own terminal state and
+   *   ignores this.
+   */
+  end(activityId, payload) {
+    return NativeModule.end(activityId, payload);
+  }
+}
+//# sourceMappingURL=zixflow-liveactivities.js.map

package/lib/module/zixflow-liveactivities.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["default","NativeModule","ZixflowLiveActivities","handleWidgetUrl","url","start","payload","update","activityId","end"],"sourceRoot":"../../src","sources":["zixflow-liveactivities.ts"],"mappings":";;AACA,SACEA,OAAO,IAAIC,YAAY,QAElB,gDAA6C;;AAGpD;AACA;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,qBAAqB,CAAqC;EACrE;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,MAAMC,eAAeA,CAACC,GAAW,EAA0B;IACzD,IAAI;MACF,OAAO,MAAMH,YAAY,CAACE,eAAe,CAACC,GAAG,CAAC;IAChD,CAAC,CAAC,MAAM;MACN,OAAOA,GAAG;IACZ;EACF;;EAEA;AACF;AACA;AACA;AACA;AACA;EACEC,KAAKA,CAACC,OAA4B,EAAmB;IACnD,OAAOL,YAAY,CAACI,KAAK,CAACC,OAAO,CAAC;EACpC;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,MAAMA,CAACC,UAAkB,EAAEF,OAA4B,EAAiB;IACtE,OAAOL,YAAY,CAACM,MAAM,CAACC,UAAU,EAAEF,OAAO,CAAC;EACjD;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEG,GAAGA,CAACD,UAAkB,EAAEF,OAA6B,EAAiB;IACpE,OAAOL,YAAY,CAACQ,GAAG,CAACD,UAAU,EAAEF,OAAO,CAAC;EAC9C;AACF","ignoreList":[]}

package/lib/typescript/commonjs/components/NotificationInboxBellView.d.ts

@@ -0,0 +1,39 @@
+import React from 'react';
+import { type NativeProps } from '../specs/components/NotificationInboxBellNativeComponent';
+/**
+ * Props for the {@link NotificationInboxBellView} component.
+ */
+/** @public */
+export interface NotificationInboxBellViewProps extends Omit<NativeProps, 'onTap'> {
+    /**
+     * Called when the user taps the bell.
+     *
+     * Observational only — the SDK opens the inbox itself, so there is nothing the
+     * host has to do in response. Reports any tap inside this view's frame, which
+     * is the bell when the view is sized to it as recommended.
+     */
+    onTap?: () => void;
+}
+/**
+ * The Visual Notification Inbox bell (with unread badge). Tapping it opens the
+ * SDK's own inbox panel — the host presents nothing.
+ *
+ * Place it wherever the app's layout calls for it. Remote branding still styles
+ * the bell itself (colors, icon), but branding's *position* is not applied: the
+ * host owns placement via `style`. The bell renders nothing when the inbox has
+ * nothing to show, so give it a fixed size for predictable layout — at least 88
+ * points/dp square, since the native composition insets the 56pt bell by 16 on
+ * each side and a smaller box squeezes the circle onto the glyph.
+ *
+ * @example
+ * ```tsx
+ * <NotificationInboxBellView
+ *   style={{ width: 88, height: 88 }}
+ *   onTap={() => analytics.track('inbox_bell_tapped')}
+ * />
+ * ```
+ */
+/** @public */
+declare const NotificationInboxBellView: React.FC<NotificationInboxBellViewProps>;
+export default NotificationInboxBellView;
+//# sourceMappingURL=NotificationInboxBellView.d.ts.map

package/lib/typescript/commonjs/components/NotificationInboxBellView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationInboxBellView.d.ts","sourceRoot":"","sources":["../../../../src/components/NotificationInboxBellView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAA6C,EAC3C,KAAK,WAAW,EACjB,MAAM,0DAA0D,CAAC;AAElE;;GAEG;AACH,cAAc;AACd,MAAM,WAAW,8BAA+B,SAAQ,IAAI,CAC1D,WAAW,EACX,OAAO,CACR;IACC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,cAAc;AACd,QAAA,MAAM,yBAAyB,EAAE,KAAK,CAAC,EAAE,CAAC,8BAA8B,CASvE,CAAC;AAEF,eAAe,yBAAyB,CAAC"}