zixflow-reactnative 1.1.3 → 1.1.4

package/lib/typescript/module/zixflow-geofence.d.ts

@@ -0,0 +1,36 @@
+import { type TurboModule } from 'react-native';
+import { type Spec as CodegenSpec } from './specs/modules/NativeZixflowGeofence';
+/**
+ * Ensures all methods defined in codegen spec are implemented by the public module
+ *
+ * @internal
+ */
+interface NativeGeofenceSpec extends Omit<CodegenSpec, keyof TurboModule> {
+}
+/**
+ * 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 declare class ZixflowGeofence implements NativeGeofenceSpec {
+    /**
+     * 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(): void;
+}
+export {};
+//# sourceMappingURL=zixflow-geofence.d.ts.map

package/lib/typescript/module/zixflow-geofence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zixflow-geofence.d.ts","sourceRoot":"","sources":["../../../src/zixflow-geofence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAEL,KAAK,IAAI,IAAI,WAAW,EACzB,MAAM,uCAAuC,CAAC;AAE/C;;;;GAIG;AACH,UAAU,kBAAmB,SAAQ,IAAI,CAAC,WAAW,EAAE,MAAM,WAAW,CAAC;CAAG;AAkB5E;;;;;;;;;GASG;AACH,qBAAa,eAAgB,YAAW,kBAAkB;IACxD;;;;;;;;;;;OAWG;IACH,0BAA0B,IAAI,IAAI;CAGnC"}

package/lib/typescript/module/zixflow-inapp.d.ts

@@ -2,13 +2,14 @@ import { type EventSubscription, type TurboModule } from 'react-native';
 import { InlineInAppMessageView } from './components';
 import { NotificationInbox, type NotificationInboxSpec } from './notification-inbox';
 import { type Spec as CodegenSpec } from './specs/modules/NativeZixflowMessagingInApp';
-import type { InAppMessageEventType } from './types';
+import type { ZixflowColorScheme, InAppMessageEventType } from './types';
+import { InboxMessageEvent } from './types';
 /**
  * Ensures all methods defined in codegen spec are implemented by the public module
  *
  * @internal
  */
-interface NativeInAppSpec extends Omit<CodegenSpec, keyof TurboModule | NotificationInboxSpec | 'onInAppEventReceived'> {
+interface NativeInAppSpec extends Omit<CodegenSpec, keyof TurboModule | NotificationInboxSpec | 'onInAppEventReceived' | 'registerInboxEventListener' | 'unregisterInboxEventListener' | 'onInboxEventReceived'> {
 }
 /**
  * Helper class so that registering event listeners is easier for customers.
@@ -17,11 +18,41 @@ interface NativeInAppSpec extends Omit<CodegenSpec, keyof TurboModule | Notifica
  */
 declare class ZixflowInAppMessaging implements NativeInAppSpec {
     private _notificationInbox?;
+    /**
+     * 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.
+     */
+    private _inboxListenerCount;
     registerEventsListener(listener: (event: InAppMessageEvent) => void): EventSubscription;
+    /**
+     * 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: (event: InboxMessageEvent) => void): EventSubscription;
     /**
      * Dismisses any currently displayed in-app message
      */
     dismissMessage(): void;
+    /**
+     * 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: ZixflowColorScheme): void;
     /**
      * Gets the message inbox instance for managing inbox messages
      *
@@ -42,7 +73,10 @@ declare class InAppMessageEvent {
     constructor(eventType: InAppMessageEventType, messageId: string, deliveryId?: string, actionValue?: string, actionName?: string);
 }
 export type { InlineInAppMessageViewProps } from './components';
+export type { NotificationInboxBellViewProps, NotificationInboxViewProps, } from './components';
+export { NotificationInboxBellView, NotificationInboxView } from './components';
 export { NotificationInbox } from './notification-inbox';
 export type { InboxMessage, NotificationInboxChangeListener } from './types';
+export { InboxEventType, InboxMessageEvent } from './types';
 export { ZixflowInAppMessaging, InAppMessageEvent, InlineInAppMessageView };
 //# sourceMappingURL=zixflow-inapp.d.ts.map

package/lib/typescript/module/zixflow-inapp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zixflow-inapp.d.ts","sourceRoot":"","sources":["../../../src/zixflow-inapp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EACL,iBAAiB,EACjB,KAAK,qBAAqB,EAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAoC,EAClC,KAAK,IAAI,IAAI,WAAW,EACzB,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGrD;;;;GAIG;AACH,UAAU,eAAgB,SAAQ,IAAI,CACpC,WAAW,EACX,MAAM,WAAW,GAAG,qBAAqB,GAAG,sBAAsB,CACnE;CAAG;AAUJ;;;;GAIG;AACH,cAAM,qBAAsB,YAAW,eAAe;IACpD,OAAO,CAAC,kBAAkB,CAAC,CAAoB;IAE/C,sBAAsB,CACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAC3C,iBAAiB;IAmCpB;;OAEG;IACH,cAAc;IAId;;;;OAIG;IACH,KAAK,IAAI,iBAAiB;CAM3B;AAED;;GAEG;AACH,cAAc;AACd,cAAM,iBAAiB;IACrB,SAAS,EAAE,qBAAqB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGlB,SAAS,EAAE,qBAAqB,EAChC,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM;CAQtB;AAGD,YAAY,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,+BAA+B,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"zixflow-inapp.d.ts","sourceRoot":"","sources":["../../../src/zixflow-inapp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EACL,iBAAiB,EAEjB,KAAK,qBAAqB,EAC3B,MAAM,sBAAsB,CAAC;AAC9B,OAAoC,EAClC,KAAK,IAAI,IAAI,WAAW,EACzB,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAAkB,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAI5D;;;;GAIG;AACH,UAAU,eAAgB,SAAQ,IAAI,CACpC,WAAW,EACT,MAAM,WAAW,GACjB,qBAAqB,GACrB,sBAAsB,GACtB,4BAA4B,GAC5B,8BAA8B,GAC9B,sBAAsB,CACzB;CAAG;AAUJ;;;;GAIG;AACH,cAAM,qBAAsB,YAAW,eAAe;IACpD,OAAO,CAAC,kBAAkB,CAAC,CAAoB;IAE/C;;;;OAIG;IACH,OAAO,CAAC,mBAAmB,CAAK;IAEhC,sBAAsB,CACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAC3C,iBAAiB;IAmCpB;;;;;;;;;;;OAWG;IACH,0BAA0B,CACxB,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAC3C,iBAAiB;IAuEpB;;OAEG;IACH,cAAc;IAId;;;;;;;;;OASG;IACH,cAAc,CAAC,WAAW,EAAE,kBAAkB;IAO9C;;;;OAIG;IACH,KAAK,IAAI,iBAAiB;CAM3B;AAED;;GAEG;AACH,cAAc;AACd,cAAM,iBAAiB;IACrB,SAAS,EAAE,qBAAqB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAGlB,SAAS,EAAE,qBAAqB,EAChC,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,UAAU,CAAC,EAAE,MAAM;CAQtB;AAGD,YAAY,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EACV,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,+BAA+B,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,CAAC"}

package/lib/typescript/module/zixflow-liveactivities.d.ts

@@ -0,0 +1,66 @@
+import { type TurboModule } from 'react-native';
+import { type Spec as CodegenSpec } from './specs/modules/NativeZixflowLiveActivities';
+import type { LiveActivityPayload } from './types/live-activities';
+/**
+ * Ensures all methods defined in codegen spec are implemented by the public module
+ *
+ * @internal
+ */
+interface NativeLiveActivitiesSpec extends Omit<CodegenSpec, keyof TurboModule> {
+}
+/**
+ * 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 declare class ZixflowLiveActivities implements NativeLiveActivitiesSpec {
+    /**
+     * 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.
+     */
+    handleWidgetUrl(url: string): Promise<string | null>;
+    /**
+     * 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: LiveActivityPayload): Promise<string>;
+    /**
+     * 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: string, payload: LiveActivityPayload): Promise<void>;
+    /**
+     * 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: string, payload?: LiveActivityPayload): Promise<void>;
+}
+export {};
+//# sourceMappingURL=zixflow-liveactivities.d.ts.map

package/lib/typescript/module/zixflow-liveactivities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zixflow-liveactivities.d.ts","sourceRoot":"","sources":["../../../src/zixflow-liveactivities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAEL,KAAK,IAAI,IAAI,WAAW,EACzB,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;;;GAIG;AACH,UAAU,wBAAyB,SAAQ,IAAI,CAC7C,WAAW,EACX,MAAM,WAAW,CAClB;CAAG;AAEJ;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,YAAW,wBAAwB;IACpE;;;;;;;;;;;;;OAaG;IACG,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQ1D;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIpD;;;;;;;;;OASG;IACH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE;;;;;;;;OAQG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGtE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zixflow-reactnative",
-  "version": "1.1.3",
+  "version": "1.1.4",
   "description": "Official Zixflow SDK for React Native. Track customers and send messages to your iOS/Android apps.",
   "source": "./src/index.ts",
   "main": "./lib/commonjs/index.js",
@@ -26,6 +26,7 @@
     "lib",
     "android",
     "ios",
+    "docs/cocoapods-deployment-target-normalization.md",
     "cpp",
     "*.podspec",
     "react-native.config.js",
@@ -44,6 +45,7 @@
     "pre-deploy": "npm run typescript",
     "typecheck": "tsc",
     "typescript": "tsc --noEmit",
+    "test": "jest",
     "lint": "eslint \"**/*.{js,ts,tsx}\"",
     "lint:report": "npm run lint -- --output-file eslint_report.json --format json",
     "prepare": "bob build",
@@ -73,6 +75,7 @@
     "@evilmartians/lefthook": "^1.11.12",
     "@microsoft/api-extractor": "^7.52.8",
     "@react-native-community/cli": "^20.0.0",
+    "@react-native-community/cli-config-apple": "20.1.3",
     "@react-native/babel-preset": "^0.83.0",
     "@react-native/eslint-config": "^0.83.0",
     "@react-native/metro-config": "^0.86.0",
@@ -80,6 +83,7 @@
     "@types/react": "^19.2.0",
     "@typescript-eslint/eslint-plugin": "^8.31.1",
     "@typescript-eslint/parser": "^8.31.1",
+    "babel-jest": "^29.7.0",
     "eslint": "9.25.1",
     "eslint-config-prettier": "10.1.2",
     "eslint-plugin-ft-flow": "^3.0.11",
@@ -87,6 +91,7 @@
     "eslint-plugin-prettier": "^5.2.6",
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-react-native": "^5.0.0",
+    "jest": "^29.7.0",
     "prettier": "^3.5.3",
     "react": "19.2.0",
     "react-native": "^0.83.0",
@@ -150,12 +155,16 @@
     },
     "ios": {
       "componentProvider": {
-        "InlineMessageNative": "RCTInlineMessageNative"
+        "InlineMessageNative": "RCTInlineMessageNative",
+        "NotificationInboxBellNative": "RCTNotificationInboxBellNative",
+        "NotificationInboxViewNative": "RCTNotificationInboxViewNative"
       },
       "modulesProvider": {
         "NativeZixflowLogging": "RCTNativeZixflowLogging",
         "NativeZixflow": "RCTNativeZixflow",
+        "NativeZixflowLiveActivities": "RCTNativeLiveActivities",
         "NativeZixflowLocation": "RCTNativeZixflowLocation",
+        "NativeZixflowGeofence": "RCTNativeZixflowGeofence",
         "NativeZixflowMessagingInApp": "RCTNativeMessagingInApp",
         "NativeZixflowMessagingPush": "RCTNativeMessagingPush"
       }

package/src/components/NotificationInboxBellView.tsx

@@ -0,0 +1,55 @@
+import React from 'react';
+import NotificationInboxBellNativeComponent, {
+  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 */
+const NotificationInboxBellView: React.FC<NotificationInboxBellViewProps> = ({
+  onTap,
+  ...props
+}) => {
+  const handleTap = () => {
+    onTap?.();
+  };
+
+  return <NotificationInboxBellNativeComponent {...props} onTap={handleTap} />;
+};
+
+export default NotificationInboxBellView;

package/src/components/NotificationInboxView.tsx

@@ -0,0 +1,30 @@
+import React from 'react';
+import NotificationInboxViewNativeComponent, {
+  type NativeProps,
+} from '../specs/components/NotificationInboxViewNativeComponent';
+
+/**
+ * Props for the {@link NotificationInboxView} component.
+ */
+/** @public */
+export interface NotificationInboxViewProps extends NativeProps {}
+
+/**
+ * The Visual Notification Inbox message list — the Jist-rendered messages —
+ * embeddable directly in your own screen. It fills the area you give it via
+ * `style` and brings no surrounding chrome (no bell, no scrim).
+ *
+ * Message actions are handled by the existing global InboxEventListener, so this
+ * component takes no per-message action callback.
+ *
+ * @example
+ * ```tsx
+ * <NotificationInboxView style={{ flex: 1 }} />
+ * ```
+ */
+/** @public */
+const NotificationInboxView: React.FC<NotificationInboxViewProps> = (props) => {
+  return <NotificationInboxViewNativeComponent {...props} />;
+};
+
+export default NotificationInboxView;

package/src/components/index.ts

@@ -1,3 +1,9 @@
 // Export all components and types from the components directory for simplified imports
 export type { InlineInAppMessageViewProps } from './InlineInAppMessageView';
 export { default as InlineInAppMessageView } from './InlineInAppMessageView';
+
+// Visual Notification Inbox UI components
+export type { NotificationInboxBellViewProps } from './NotificationInboxBellView';
+export { default as NotificationInboxBellView } from './NotificationInboxBellView';
+export type { NotificationInboxViewProps } from './NotificationInboxView';
+export { default as NotificationInboxView } from './NotificationInboxView';

package/src/index.ts

@@ -4,6 +4,11 @@
  * Zixflow React Native SDK - A powerful SDK for building
  * customer engagement features in React Native applications.
  */
-
-// Export the Zixflow API
-export * from './zixflow';
+export * from './zixflow-cdp';
+export * from './zixflow-geofence';
+export * from './zixflow-inapp';
+export * from './zixflow-liveactivities';
+export * from './zixflow-location';
+export * from './zixflow-push';
+export * from './components';
+export * from './types';

package/src/notification-inbox.ts

@@ -46,7 +46,7 @@ export type NotificationInboxSpec =
  * Helper function to parse raw inbox message from native layer
  * @internal
  */
-function parseInboxMessage(raw: any): InboxMessage {
+export function parseInboxMessage(raw: any): InboxMessage {
   return {
     queueId: raw.queueId,
     deliveryId: raw.deliveryId ?? undefined,

package/src/specs/components/NotificationInboxBellNativeComponent.ts

@@ -0,0 +1,24 @@
+// React Native docs now recommend Codegen types should be imported from the react-native package
+// But it breaks on Expo and older React Native versions, so we import from react-native/Libraries/Types/CodegenTypes
+// for compatibility with all versions until we can fully migrate to the new import style without breaking older versions
+// https://reactnative.dev/docs/strict-typescript-api#codegen-types-should-now-be-imported-from-the-react-native-package
+
+import type { HostComponent, ViewProps } from 'react-native';
+/* eslint-disable @react-native/no-deep-imports */
+import type { DirectEventHandler } from 'react-native/Libraries/Types/CodegenTypes';
+import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
+
+/** Event data for inbox bell taps. Carries no payload; presence indicates a tap. */
+export interface BellTapEvent {}
+
+/** Props for the native NotificationInboxBell component. */
+export interface NativeProps extends ViewProps {
+  /** Fired when the user taps the bell. Host should present its own inbox UI. */
+  onTap?: DirectEventHandler<BellTapEvent>;
+}
+
+// React Native Codegen automatically generates the native component bridge based on the NativeProps interface.
+// Public view is NotificationInboxBellView in the components directory.
+export default codegenNativeComponent<NativeProps>(
+  'NotificationInboxBellNative'
+) as HostComponent<NativeProps>;

package/src/specs/components/NotificationInboxViewNativeComponent.ts

@@ -0,0 +1,22 @@
+// React Native docs now recommend Codegen types should be imported from the react-native package
+// But it breaks on Expo and older React Native versions, so we import from react-native/Libraries/Types/CodegenTypes
+// for compatibility with all versions until we can fully migrate to the new import style without breaking older versions
+// https://reactnative.dev/docs/strict-typescript-api#codegen-types-should-now-be-imported-from-the-react-native-package
+
+import type { HostComponent, ViewProps } from 'react-native';
+/* eslint-disable @react-native/no-deep-imports */
+import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNativeComponent';
+
+/**
+ * Props for the native NotificationInboxView component (the Jist-rendered message list).
+ * No required props; the host controls sizing via standard ViewProps style.
+ * Message actions are handled by the existing global InboxEventListener, so this
+ * component needs no per-component action callback.
+ */
+export interface NativeProps extends ViewProps {}
+
+// React Native Codegen automatically generates the native component bridge based on the NativeProps interface.
+// Public view is NotificationInboxView in the components directory.
+export default codegenNativeComponent<NativeProps>(
+  'NotificationInboxViewNative'
+) as HostComponent<NativeProps>;

package/src/specs/modules/NativeZixflow.ts

@@ -1,5 +1,8 @@
 import { TurboModuleRegistry, type TurboModule } from 'react-native';
-import type { UnsafeObject } from 'react-native/Libraries/Types/CodegenTypes';
+import type {
+  EventEmitter,
+  UnsafeObject,
+} from 'react-native/Libraries/Types/CodegenTypes';
 
 /**
  * Native module specification for Zixflow React Native SDK
@@ -41,6 +44,11 @@ export interface Spec extends TurboModule {
     config: NativeBridgeObject,
     args: NativeBridgeObject
   ): Promise<void>;
+  setDeepLinkRoutingReady(): void;
+  readonly onDeepLinkReceived: EventEmitter<UnsafeObject>;
+  registerDeepLinkHandler(): void;
+  unregisterDeepLinkHandler(): void;
+  acknowledgeDeepLink(id: string, handled: boolean): void;
   identify(params?: NativeBridgeObject): void;
   clearIdentify(): void;
   track(name: string, properties?: NativeBridgeObject): void;

package/src/specs/modules/NativeZixflowGeofence.ts

@@ -0,0 +1,14 @@
+import { TurboModuleRegistry, type TurboModule } from 'react-native';
+
+/**
+ * Native module specification for Zixflow Geofence React Native SDK
+ *
+ * @see NativeZixflow.ts for detailed documentation on TurboModule patterns,
+ * Codegen compatibility, and type safety approach.
+ */
+
+export interface Spec extends TurboModule {
+  refreshFromCurrentLocation(): void;
+}
+
+export default TurboModuleRegistry.get<Spec>('NativeZixflowGeofence');

package/src/specs/modules/NativeZixflowLiveActivities.ts

@@ -0,0 +1,39 @@
+import { TurboModuleRegistry, type TurboModule } from 'react-native';
+import type { UnsafeObject } from 'react-native/Libraries/Types/CodegenTypes';
+
+/**
+ * Native module specification for Zixflow Live Activities React Native SDK
+ *
+ * Live Activities (iOS) / Live Notifications (Android) let you show a live,
+ * updating notification driven by a built-in template (Segments, Countdown Timer)
+ * or by a custom type you render yourself.
+ *
+ * @see NativeZixflow.ts for detailed documentation on TurboModule patterns,
+ * Codegen compatibility, and type safety approach.
+ */
+
+type NativeBridgeObject = UnsafeObject;
+
+export interface Spec extends TurboModule {
+  /** Report a Live Activity open and return the destination URL to route. */
+  handleWidgetUrl(url: string): Promise<string | null>;
+  /** Start an activity. Resolves with the SDK-minted activity id. */
+  start(payload: NativeBridgeObject): Promise<string>;
+  /** Replace the whole content-state of a running activity. Pass the full desired state. */
+  update(activityId: string, payload: NativeBridgeObject): Promise<void>;
+  /**
+   * End a running activity, optionally rendering a final content-state.
+   *
+   * `payload` is iOS-only: ActivityKit keeps the last content-state on screen unless a final one
+   * is supplied. Android renders its own terminal state, so it ignores the payload.
+   */
+  end(activityId: string, payload?: NativeBridgeObject): Promise<void>;
+}
+
+// Registered unconditionally on both platforms — Android in ZixflowReactNativePackage, iOS via
+// an ObjC bridge that is always compiled. When the Live Activities pods are absent the module is
+// still present and its methods reject with `live_activity_module_unavailable`, so `getEnforcing`
+// is accurate here (unlike Location, which really can be absent and uses `get`).
+export default TurboModuleRegistry.getEnforcing<Spec>(
+  'NativeZixflowLiveActivities'
+);

package/src/specs/modules/NativeZixflowMessagingInApp.ts

@@ -14,7 +14,16 @@ import type {
 /** TurboModule interface for Zixflow In-App Messaging native operations */
 export interface Spec extends TurboModule {
   dismissMessage(): void;
+  // Carries the ZixflowColorScheme string value; the enum itself cannot cross Codegen.
+  setColorScheme(colorScheme: string): void;
   readonly onInAppEventReceived: EventEmitter<UnsafeObject>;
+  // Notification Inbox event listener methods.
+  // Registers/unregisters a native forwarder with the SDK so inbox events
+  // (action taken, shown, opened, dismissed) are emitted to JS. Distinct from
+  // onInAppEventReceived so inbox events never collide with in-app events.
+  registerInboxEventListener(): void;
+  unregisterInboxEventListener(): void;
+  readonly onInboxEventReceived: EventEmitter<UnsafeObject>;
   // Notification Inbox related methods
   setupInboxListener(): void;
   readonly subscribeToMessagesChanged: EventEmitter<UnsafeObject>;
@@ -25,6 +34,8 @@ export interface Spec extends TurboModule {
   trackMessageClicked(message: UnsafeObject, actionName?: string): void;
 }
 
-export default TurboModuleRegistry.get<Spec>(
+// Registered unconditionally on both platforms, like MessagingPush and DataPipelines — not
+// gated by an optional subspec/module flag the way Location and Geofence are.
+export default TurboModuleRegistry.getEnforcing<Spec>(
   'NativeZixflowMessagingInApp'
 );

package/src/specs/modules/NativeZixflowMessagingPush.ts

@@ -22,6 +22,8 @@ export interface Spec extends TurboModule {
   getPushPermissionStatus(): Promise<string>;
 }
 
-export default TurboModuleRegistry.get<Spec>(
+// Registered unconditionally on both platforms, like MessagingInApp and DataPipelines — not
+// gated by an optional subspec/module flag the way Location and Geofence are.
+export default TurboModuleRegistry.getEnforcing<Spec>(
   'NativeZixflowMessagingPush'
 );

package/src/types/data-pipelines.ts

@@ -1,3 +1,6 @@
+import type { ZixflowColorScheme } from './in-app';
+import type { NotificationInboxAccessibilityLabels } from './inbox';
+import type { LiveActivitiesConfig } from './live-activities';
 import type { PushClickBehaviorAndroid } from './push';
 
 /**
@@ -60,7 +63,21 @@ export type ZixflowConfig = {
   screenViewUse?: ScreenView;
   trackApplicationLifecycleEvents?: boolean;
   autoTrackDeviceAttributes?: boolean;
-  inApp?: {};
+  inApp?: {
+    /**
+     * Color scheme used to render in-app messages. Defaults to `ZixflowColorScheme.Auto`, which
+     * follows the device appearance. Set it when the app has its own appearance setting that
+     * can disagree with the operating system.
+     *
+     * Can be changed after initialization with `Zixflow.inAppMessaging.setColorScheme`.
+     */
+    colorScheme?: ZixflowColorScheme;
+    /**
+     * Accessibility labels for the Visual Notification Inbox. Optional; an omitted label leaves
+     * that element unlabeled rather than falling back to English.
+     */
+    notificationInboxAccessibilityLabels?: NotificationInboxAccessibilityLabels;
+  };
   push?: {
     android?: {
       pushClickBehavior?: PushClickBehaviorAndroid;
@@ -69,6 +86,30 @@ export type ZixflowConfig = {
   location?: {
     trackingMode?: ZixflowLocationTrackingMode;
   };
+  /**
+   * Geofence configuration. Providing this opts the app into geofence monitoring,
+   * which runs automatically once enabled. Enabling geofence also enables the
+   * Location module, which geofence depends on.
+   */
+  geofence?: {
+    /**
+     * How the SDK acquires location fixes for geofence monitoring. Defaults to
+     * `AUTOMATIC` (the SDK acquires location itself on identify and app launch). Use
+     * `MANUAL` to drive refreshes yourself via
+     * `Zixflow.geofence.refreshFromCurrentLocation()`.
+     */
+    locationMode?: ZixflowGeofenceLocationMode;
+  };
+  /** iOS-only SDK configuration. Has no effect on Android. */
+  ios?: {
+    /**
+     * Whether geofence transitions are delivered in real time on a background cold-wake.
+     * When unset, defaults to on if the geofence module is enabled, off otherwise.
+     */
+    allowBackgroundDelivery?: boolean;
+  };
+  /** Live Activities (iOS) / Live Notifications (Android) configuration. */
+  liveNotifications?: LiveActivitiesConfig;
 };
 
 /**
@@ -118,6 +159,18 @@ export enum ZixflowLocationTrackingMode {
   OnAppStart = 'ON_APP_START',
 }
 
+/**
+ * How the Geofence module acquires location fixes.
+ *
+ * @public
+ */
+export enum ZixflowGeofenceLocationMode {
+  /** SDK acquires location itself (on identify and app launch). Default. */
+  Automatic = 'AUTOMATIC',
+  /** Host drives refreshes via `Zixflow.geofence.refreshFromCurrentLocation()`. */
+  Manual = 'MANUAL',
+}
+
 /**
  * Enum to specify the type of metric for tracking
  *

package/src/types/in-app.ts

@@ -27,6 +27,29 @@ export enum InAppMessageEventType {
   messageShown = 'messageShown',
 }
 
+/**
+ * Color scheme used to render in-app messages.
+ *
+ * Selects which of the light/dark variants authored in the Zixflow editor is
+ * rendered. Use it when the app has its own appearance setting that can disagree with
+ * the operating system: `Auto` follows the device, while `Light` and `Dark` pin the
+ * variant regardless of it.
+ *
+ * The string values are the wire contract shared with both native SDKs, which match
+ * them lowercase and resolve anything unrecognized to `auto` — so they must stay
+ * exactly as written here even if the members are renamed.
+ *
+ * @public
+ */
+export enum ZixflowColorScheme {
+  /** Follow the device's current appearance. The default when unset. */
+  Auto = 'auto',
+  /** Always render the light variant, whatever the device is set to. */
+  Light = 'light',
+  /** Always render the dark variant, whatever the device is set to. */
+  Dark = 'dark',
+}
+
 /**
  * Represents an inbox message for a user.
  *