zixflow-reactnative 1.1.2 → 1.1.4

package/lib/typescript/module/types/live-activities.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Public types for the Live Activities module.
+ *
+ * Live Activities (iOS) / Live Notifications (Android) render live, updating
+ * notifications from built-in templates. Two templates ship today: Segments and
+ * Countdown Timer. Field names and identifiers are identical across platforms.
+ */
+/**
+ * Built-in activity type identifiers usable from the wrapper.
+ *
+ * The values are the reverse-DNS identifiers Zixflow uses everywhere — the
+ * `notificationType` on the wire, Android's `LiveNotificationType`, and iOS's
+ * `CIOSegmentsAttributes.identifier` — so JS, both native SDKs, and the backend
+ * share one vocabulary.
+ *
+ * Use these enum members (not raw strings) for `LiveActivitiesConfig.types` and a
+ * payload's `type` to avoid typos.
+ *
+ * @public
+ */
+export declare enum LiveActivityTemplate {
+    Segments = "com.zixflow.livenotifications.segments",
+    CountdownTimer = "com.zixflow.livenotifications.countdowntimer",
+    /**
+     * Your own activity type, rendered by SwiftUI you write.
+     *
+     * Unlike the members above, this value is a marker rather than an identifier — your activity is
+     * named by {@link LiveActivitiesConfig.customType}, and the SDK reports it under that name. It
+     * belongs in a payload's `type`, never in {@link LiveActivitiesConfig.types}.
+     */
+    Custom = "custom"
+}
+/**
+ * Segments template — a progress activity split into N segments.
+ * `header` is a static attribute (fixed at start); the rest are content-state.
+ *
+ * @public
+ */
+export interface LiveActivitySegmentsPayload {
+    type: LiveActivityTemplate.Segments;
+    /** Static header line (set at start, never changes). */
+    header: string;
+    /** Primary status line. */
+    status: string;
+    /** Optional secondary status line. */
+    substatus?: string;
+    /** Total number of segments. */
+    segmentsTotal: number;
+    /** Number of completed segments (clamped to 0..segmentsTotal). */
+    segmentsComplete: number;
+    /** Optional trailing text (e.g. an ETA). */
+    trailingText?: string;
+}
+/**
+ * Custom template — your own activity type, rendered by SwiftUI you write.
+ *
+ * Unlike the built-in templates there is no schema: `data` is an untyped map, because a bridge
+ * payload carries nothing for the SDK to validate against. Every value is a string, so your widget
+ * parses whichever ones it needs.
+ *
+ * Requires {@link LiveActivitiesConfig.customType} to be set. On iOS you must also render
+ * `CIOCustomAttributes` in your Widget Extension; on Android your `createLiveNotification`
+ * callback receives the same map.
+ *
+ * @public
+ */
+export interface LiveActivityCustomPayload {
+    type: LiveActivityTemplate.Custom;
+    /**
+     * The full content-state, re-sent in its entirety on every update. Neither platform keeps a
+     * static/dynamic split for custom types, so include anything your widget needs each time.
+     *
+     * Values must be strings. Numbers and booleans are coerced, but nested objects and arrays are
+     * not supported and the platforms disagree on them — iOS drops them, Android stringifies them —
+     * so flatten anything structured before sending it.
+     */
+    data: Record<string, string>;
+}
+/**
+ * Countdown Timer template — a live countdown to a target time.
+ * `header` is a static attribute (fixed at start); the rest are content-state.
+ *
+ * @public
+ */
+export interface LiveActivityCountdownTimerPayload {
+    type: LiveActivityTemplate.CountdownTimer;
+    /** Static header line (set at start, never changes). */
+    header: string;
+    /** Primary title line. */
+    title: string;
+    /** Optional status message. */
+    statusMessage?: string;
+    /** Target time as epoch **seconds**. Omit to render the finished state. */
+    endTime?: number;
+}
+/**
+ * Payload for {@link ZixflowLiveActivities.start} and
+ * {@link ZixflowLiveActivities.update}.
+ *
+ * Because ActivityKit replaces content-state wholesale on update, `update` takes the
+ * same full payload as `start` — pass the complete desired state each time.
+ *
+ * @public
+ */
+export type LiveActivityPayload = LiveActivitySegmentsPayload | LiveActivityCountdownTimerPayload | LiveActivityCustomPayload;
+/**
+ * Live Activities branding (Android only). On iOS, branding is compiled into the
+ * widget extension's SwiftUI, so these values are ignored there.
+ *
+ * @public
+ */
+export interface LiveActivitiesBranding {
+    /** Reserved for future use. */
+    companyName?: string;
+    /** Accent color as "#RRGGBB". */
+    accentColorHex?: string;
+    /**
+     * Bundled Android drawable resource name for the logo, resolved natively.
+     * Preferred over {@link LiveActivitiesBranding.logoUrl} when both are set — it
+     * needs no network.
+     */
+    logoResource?: string;
+    /** Remote logo URL (downloaded and cached natively). */
+    logoUrl?: string;
+    /** Android drawable resource name, resolved natively. */
+    smallIconResource?: string;
+}
+/**
+ * Live Activities configuration, passed under the `liveNotifications` key of the SDK config.
+ *
+ * @public
+ */
+export interface LiveActivitiesConfig {
+    /**
+     * Built-in activity types to enable. Enables the matching native type on each
+     * platform and registers push-to-start for it. Unrecognized identifiers are
+     * ignored, so a newer native template can't break an older wrapper build.
+     *
+     * `Custom` is excluded on purpose — it is enabled by {@link LiveActivitiesConfig.customType},
+     * and both platforms would silently drop it from this list.
+     */
+    types?: Exclude<LiveActivityTemplate, LiveActivityTemplate.Custom>[];
+    /**
+     * Your own reverse-DNS identifier for the custom activity type, e.g.
+     * `'com.myapp.rideshare'`. Setting it enables the custom template on both platforms.
+     *
+     * Start one with `{ type: LiveActivityTemplate.Custom, data: { … } }`; the SDK reports it
+     * under this identifier, and your campaigns target it by the same name.
+     *
+     * Singular by design: iOS resolves an activity's type from its Swift attributes type, and
+     * every custom activity shares one. A second identifier could not be told apart, so one
+     * identifier is the limit rather than a silent mis-attribution.
+     *
+     * You must also render it yourself — `CIOCustomAttributes` in an iOS Widget Extension, and
+     * the `createLiveNotification` callback on Android.
+     */
+    customType?: string;
+    /** Android Live Notification branding (ignored on iOS). */
+    branding?: LiveActivitiesBranding;
+}
+//# sourceMappingURL=live-activities.d.ts.map

package/lib/typescript/module/types/live-activities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-activities.d.ts","sourceRoot":"","sources":["../../../../src/types/live-activities.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;GAYG;AACH,oBAAY,oBAAoB;IAC9B,QAAQ,2CAA2C;IACnD,cAAc,iDAAiD;IAC/D;;;;;;OAMG;IACH,MAAM,WAAW;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,oBAAoB,CAAC,QAAQ,CAAC;IACpC,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC;IAClC;;;;;;;OAOG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,oBAAoB,CAAC,cAAc,CAAC;IAC1C,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,mBAAmB,GAC3B,2BAA2B,GAC3B,iCAAiC,GACjC,yBAAyB,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;IACrE;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC"}

package/lib/typescript/module/utils/param-validation.d.ts

@@ -30,12 +30,19 @@ declare function validateAttributes(value: unknown, fieldName: string, options?:
     expectedType?: string;
     optional?: boolean;
 }): CustomAttributes | undefined;
+/**
+ * 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.
+ */
+declare function validateColorSchemeArgument(value: unknown): void;
 type ConfigValidator = (value: unknown) => asserts value is ZixflowConfig;
 export declare const assert: {
     string: typeof validateString;
     record: typeof validateRecord;
     attributes: typeof validateAttributes;
     config: ConfigValidator;
+    colorScheme: typeof validateColorSchemeArgument;
 };
 export declare const validate: {
     isUndefined: typeof isUndefined;

package/lib/typescript/module/utils/param-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"param-validation.d.ts","sourceRoot":"","sources":["../../../../src/utils/param-validation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAchE;;GAEG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE5C;AA0BD;;;GAGG;AACH,iBAAS,cAAc,CACrB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACG,QAqBzB;AAED;;GAEG;AACH,iBAAS,cAAc,CACrB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACf,QAeP;AAED;;;;GAIG;AACH,iBAAS,kBAAkB,CACzB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACf,GACL,gBAAgB,GAAG,SAAS,CAe9B;AAwBD,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;AAE1E,eAAO,MAAM,MAAM,EAAE;IACnB,MAAM,EAAE,OAAO,cAAc,CAAC;IAC9B,MAAM,EAAE,OAAO,cAAc,CAAC;IAC9B,UAAU,EAAE,OAAO,kBAAkB,CAAC;IACtC,MAAM,EAAE,eAAe,CAAC;CAMzB,CAAC;AAEF,eAAO,MAAM,QAAQ;;CAEpB,CAAC"}
+{"version":3,"file":"param-validation.d.ts","sourceRoot":"","sources":["../../../../src/utils/param-validation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAchE;;GAEG;AACH,iBAAS,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE5C;AAoCD;;;GAGG;AACH,iBAAS,cAAc,CACrB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACG,QAqBzB;AAED;;GAEG;AACH,iBAAS,cAAc,CACrB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACf,QAeP;AAED;;;;GAIG;AACH,iBAAS,kBAAkB,CACzB,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACf,GACL,gBAAgB,GAAG,SAAS,CAe9B;AA2ED;;;;GAIG;AACH,iBAAS,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAMzD;AA4BD,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;AAE1E,eAAO,MAAM,MAAM,EAAE;IACnB,MAAM,EAAE,OAAO,cAAc,CAAC;IAC9B,MAAM,EAAE,OAAO,cAAc,CAAC;IAC9B,UAAU,EAAE,OAAO,kBAAkB,CAAC;IACtC,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,OAAO,2BAA2B,CAAC;CAOjD,CAAC;AAEF,eAAO,MAAM,QAAQ;;CAEpB,CAAC"}

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

@@ -1,11 +1,47 @@
+import { ZixflowGeofence } from './zixflow-geofence';
 import { ZixflowInAppMessaging } from './zixflow-inapp';
+import { ZixflowLiveActivities } from './zixflow-liveactivities';
 import { ZixflowLocation } from './zixflow-location';
 import { ZixflowPushMessaging } from './zixflow-push';
 import { MetricEvent, type ZixflowConfig, type IdentifyParams } from './types';
+/**
+ * Handles a Zixflow deep-link destination delivered from iOS.
+ * @public
+ */
+export type DeepLinkHandler = (url: string) => boolean | Promise<boolean>;
+/**
+ * Removes a Zixflow deep-link handler.
+ * @public
+ */
+export interface DeepLinkHandlerSubscription {
+    /** Stop routing Zixflow deep links through this handler. */
+    remove(): void;
+}
 /** @public */
 export declare class Zixflow {
     /** Initialize the Zixflow SDK with given configuration. */
     static readonly initialize: (config: ZixflowConfig) => Promise<void>;
+    /**
+     * 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 readonly setDeepLinkRoutingReady: () => void;
+    /**
+     * 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 readonly setDeepLinkHandler: (handler: DeepLinkHandler) => DeepLinkHandlerSubscription;
     /** Identify a user to start tracking their activity. Requires userId, traits, or both. */
     static readonly identify: ({ userId, traits, }?: IdentifyParams) => Promise<any>;
     /** Clear current user identification and stop tracking. */
@@ -33,7 +69,9 @@ export declare class Zixflow {
      * @deprecated This method will be removed in a future version. If you need this functionality, please contact us.
      */
     static readonly isInitialized: () => boolean;
+    static readonly geofence: ZixflowGeofence;
     static readonly inAppMessaging: ZixflowInAppMessaging;
+    static readonly liveActivities: ZixflowLiveActivities;
     static readonly location: ZixflowLocation;
     static readonly pushMessaging: ZixflowPushMessaging;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"zixflow-cdp.d.ts","sourceRoot":"","sources":["../../../src/zixflow-cdp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAMtD,OAAO,EAEL,WAAW,EACX,KAAK,aAAa,EAElB,KAAK,cAAc,EACpB,MAAM,SAAS,CAAC;AAkBjB,cAAc;AACd,qBAAa,OAAO;IAClB,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,CAAC,UAAU,GAAU,QAAQ,aAAa,mBAiCvD;IAEF,0FAA0F;IAC1F,MAAM,CAAC,QAAQ,CAAC,QAAQ,GAAU,sBAG/B,cAAmB,kBAkBpB;IAEF,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,CAAC,aAAa,qBAE3B;IAEF,+CAA+C;IAC/C,MAAM,CAAC,QAAQ,CAAC,KAAK,GACnB,MAAM,MAAM,EACZ,aAAa,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,kBAWhC;IAEF,0DAA0D;IAC1D,MAAM,CAAC,QAAQ,CAAC,MAAM,GACpB,OAAO,MAAM,EACb,aAAa,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,kBAWhC;IAEF,0EAA0E;IAC1E,MAAM,CAAC,QAAQ,CAAC,oBAAoB,GAClC,YAAY,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,kBAS/B;IAEF,6CAA6C;IAC7C,MAAM,CAAC,QAAQ,CAAC,mBAAmB,GACjC,YAAY,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,kBAS/B;IAEF,sDAAsD;IACtD,MAAM,CAAC,QAAQ,CAAC,mBAAmB,GAAU,OAAO,MAAM,mBAIxD;IAEF,4EAA4E;IAC5E,MAAM,CAAC,QAAQ,CAAC,iBAAiB,sBAE/B;IAEF,kFAAkF;IAClF,MAAM,CAAC,QAAQ,CAAC,WAAW,GAAU,qCAIlC;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,WAAW,CAAC;KACpB,mBAQC;IAEF;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,aAAa,gBAAsB;IAEnD,MAAM,CAAC,QAAQ,CAAC,cAAc,wBAA+B;IAC7D,MAAM,CAAC,QAAQ,CAAC,QAAQ,kBAAyB;IACjD,MAAM,CAAC,QAAQ,CAAC,aAAa,uBAA8B;CAC5D"}
+{"version":3,"file":"zixflow-cdp.d.ts","sourceRoot":"","sources":["../../../src/zixflow-cdp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAMtD,OAAO,EAEL,WAAW,EACX,KAAK,aAAa,EAElB,KAAK,cAAc,EACpB,MAAM,SAAS,CAAC;AAWjB;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAE1E;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,4DAA4D;IAC5D,MAAM,IAAI,IAAI,CAAC;CAChB;AAUD,cAAc;AACd,qBAAa,OAAO;IAClB,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,CAAC,UAAU,GAAU,QAAQ,aAAa,mBAuBvD;IAEF;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,uBAAuB,aAErC;IAEF;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,QAAQ,CAAC,kBAAkB,GAChC,SAAS,eAAe,KACvB,2BAA2B,CAqE5B;IAEF,0FAA0F;IAC1F,MAAM,CAAC,QAAQ,CAAC,QAAQ,GAAU,sBAG/B,cAAmB,kBAkBpB;IAEF,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,CAAC,aAAa,qBAE3B;IAEF,+CAA+C;IAC/C,MAAM,CAAC,QAAQ,CAAC,KAAK,GACnB,MAAM,MAAM,EACZ,aAAa,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,kBAWhC;IAEF,0DAA0D;IAC1D,MAAM,CAAC,QAAQ,CAAC,MAAM,GACpB,OAAO,MAAM,EACb,aAAa,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,kBAWhC;IAEF,0EAA0E;IAC1E,MAAM,CAAC,QAAQ,CAAC,oBAAoB,GAClC,YAAY,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,kBAS/B;IAEF,6CAA6C;IAC7C,MAAM,CAAC,QAAQ,CAAC,mBAAmB,GACjC,YAAY,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,kBAS/B;IAEF,sDAAsD;IACtD,MAAM,CAAC,QAAQ,CAAC,mBAAmB,GAAU,OAAO,MAAM,mBAIxD;IAEF,4EAA4E;IAC5E,MAAM,CAAC,QAAQ,CAAC,iBAAiB,sBAE/B;IAEF,kFAAkF;IAClF,MAAM,CAAC,QAAQ,CAAC,WAAW,GAAU,qCAIlC;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,WAAW,CAAC;KACpB,mBAQC;IAEF;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,aAAa,gBAAsB;IAEnD,MAAM,CAAC,QAAQ,CAAC,QAAQ,kBAAyB;IACjD,MAAM,CAAC,QAAQ,CAAC,cAAc,wBAA+B;IAC7D,MAAM,CAAC,QAAQ,CAAC,cAAc,wBAA+B;IAC7D,MAAM,CAAC,QAAQ,CAAC,QAAQ,kBAAyB;IACjD,MAAM,CAAC,QAAQ,CAAC,aAAa,uBAA8B;CAC5D"}

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/lib/typescript/module/zixflow.d.ts

@@ -1,8 +1,3 @@
-/**
- * Zixflow SDK - Main entry point
- *
- * This provides the Zixflow-branded API.
- */
 export { Zixflow } from './zixflow-cdp';
 export { ZixflowInAppMessaging } from './zixflow-inapp';
 export { ZixflowLocation } from './zixflow-location';

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

@@ -1 +1 @@
-{"version":3,"file":"zixflow.d.ts","sourceRoot":"","sources":["../../../src/zixflow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"zixflow.d.ts","sourceRoot":"","sources":["../../../src/zixflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zixflow-reactnative",
-  "version": "1.1.2",
-  "description": "Official Zixflow SDK for React Native. Customer engagement platform built on proven Zixflow technology. Track customers and send messages to your iOS/Android apps.",
+  "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",
   "module": "./lib/module/index.js",
@@ -19,13 +19,14 @@
     },
     "./package.json": "./package.json"
   },
-  "zixflowNativeiOSSdkVersion": "= 1.1.2",
-  "zixflowNativeAndroidSdkVersion": "1.1.1",
+  "zixflowNativeiOSSdkVersion": "= 1.1.3",
+  "zixflowNativeAndroidSdkVersion": "1.1.3",
   "files": [
     "src",
     "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';