feat(SDK-559): expose Iterable.authManager.getAuthToken()

Bridge native JWT reads for parity with Android getAuthToken() and iOS
IterableAPI.authToken, alongside existing getEmail/getUserId.

Author: jferrao-itrbl

CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ### Updates
 
+- Added `Iterable.authManager.getAuthToken()` to read the JWT currently held by the native SDK (SDK-559).
+  - iOS: `IterableAPI.authToken`.
+  - Android: `IterableApi.getAuthToken()`.
 - Added `Iterable.disableDeviceForAllUsers()` to unregister this device's push token from every user associated with the device (SDK-550).
   - iOS: forwards to native `IterableAPI.disableDeviceForAllUsers()`.
   - Android: graceful no-op that logs a warning; use `disableDeviceForCurrentUser()` to disable push for the current user. There is no public native "all users" equivalent.

android/src/main/java/com/iterable/iterableapi/RNIterableInternal.java

@@ -16,6 +16,11 @@ public static String getUserId() {
         return IterableApi.getInstance().getUserId();
     }
 
+    @Nullable
+    public static String getAuthToken() {
+        return IterableApi.getInstance().getAuthToken();
+    }
+
     public static JSONObject getInAppMessageJson(IterableInAppMessage message) {
         return message.toJSONObject();
     }

android/src/main/java/com/iterable/reactnative/RNIterableAPIModuleImpl.java

@@ -249,6 +249,10 @@ public void getUserId(Promise promise) {
         promise.resolve(RNIterableInternal.getUserId());
     }
 
+    public void getAuthToken(Promise promise) {
+        promise.resolve(RNIterableInternal.getAuthToken());
+    }
+
     public void trackEvent(String name, @Nullable ReadableMap dataFields) {
         IterableLogger.v(TAG, "trackEvent");
         IterableApi.getInstance().track(name, optSerializedDataFields(dataFields));

android/src/newarch/java/com/RNIterableAPIModule.java

@@ -72,6 +72,11 @@ public void getUserId(Promise promise) {
     moduleImpl.getUserId(promise);
   }
 
+  @Override
+  public void getAuthToken(Promise promise) {
+    moduleImpl.getAuthToken(promise);
+  }
+
   @Override
   public void trackEvent(String name, @Nullable ReadableMap dataFields) {
     moduleImpl.trackEvent(name, dataFields);

android/src/oldarch/java/com/RNIterableAPIModule.java

@@ -73,6 +73,11 @@ public void getUserId(Promise promise) {
       moduleImpl.getUserId(promise);
     }
 
+    @ReactMethod
+    public void getAuthToken(Promise promise) {
+      moduleImpl.getAuthToken(promise);
+    }
+
     @ReactMethod
     public void trackEvent(String name, @Nullable ReadableMap dataFields) {
       moduleImpl.trackEvent(name, dataFields);

ios/RNIterableAPI/RNIterableAPI.mm

@@ -283,6 +283,11 @@ - (void)updateVisibleRows:(NSArray *)visibleRows {
   [_swiftAPI updateVisibleRows:visibleRows];
 }
 
+- (void)getAuthToken:(RCTPromiseResolveBlock)resolve
+              reject:(RCTPromiseRejectBlock)reject {
+  [_swiftAPI getAuthToken:resolve rejecter:reject];
+}
+
 - (void)passAlongAuthToken:(NSString *_Nullable)authToken {
   [_swiftAPI passAlongAuthToken:authToken];
 }
@@ -571,6 +576,11 @@ - (void)wakeApp {
   [_swiftAPI updateVisibleRows:visibleRows];
 }
 
+RCT_EXPORT_METHOD(getAuthToken : (RCTPromiseResolveBlock)
+                      resolve rejecter : (RCTPromiseRejectBlock)reject) {
+  [_swiftAPI getAuthToken:resolve rejecter:reject];
+}
+
 RCT_EXPORT_METHOD(passAlongAuthToken : (NSString *_Nullable)authToken) {
   [_swiftAPI passAlongAuthToken:authToken];
 }

ios/RNIterableAPI/ReactIterableAPI.swift

@@ -500,6 +500,12 @@ import React
 
   // MARK: - SDK Auth Manager Functions
 
+  @objc(getAuthToken:rejecter:)
+  public func getAuthToken(resolver: RCTPromiseResolveBlock, rejecter: RCTPromiseRejectBlock) {
+    ITBInfo()
+    resolver(IterableAPI.authToken)
+  }
+
   @objc(passAlongAuthToken:)
   public func passAlongAuthToken(authToken: String?) {
     ITBInfo()

src/__mocks__/MockRNIterableAPI.ts

@@ -4,6 +4,7 @@ import { IterableInAppMessage } from '../inApp';
 export class MockRNIterableAPI {
   static email?: string;
   static userId?: string;
+  static authToken?: string | null;
   static token?: string;
   static lastPushPayload?: unknown;
   static attributionInfo?: IterableAttributionInfo;
@@ -82,6 +83,12 @@ export class MockRNIterableAPI {
 
   static setInAppShowResponse = jest.fn();
 
+  static async getAuthToken(): Promise<string | null> {
+    return await new Promise((resolve) => {
+      resolve(MockRNIterableAPI.authToken ?? null);
+    });
+  }
+
   static passAlongAuthToken = jest.fn();
 
   static pauseAuthRetries = jest.fn();

src/api/NativeRNIterableAPI.ts

@@ -179,6 +179,7 @@ export interface Spec extends TurboModule {
   ): void;
 
   // Auth
+  getAuthToken(): Promise<string | null>;
   passAlongAuthToken(authToken?: string | null): void;
   pauseAuthRetries(pauseRetry: boolean): void;
 

src/core/classes/Iterable.test.ts

@@ -1038,6 +1038,25 @@ describe('Iterable', () => {
       });
     });
 
+    describe('getAuthToken', () => {
+      it('should return the auth token from RNIterableAPI', async () => {
+        const expectedToken = 'jwt-token';
+        MockRNIterableAPI.authToken = expectedToken;
+
+        const result = await Iterable.authManager.getAuthToken();
+
+        expect(result).toBe(expectedToken);
+      });
+
+      it('should return null when RNIterableAPI has no auth token', async () => {
+        MockRNIterableAPI.authToken = null;
+
+        const result = await Iterable.authManager.getAuthToken();
+
+        expect(result).toBeNull();
+      });
+    });
+
     describe('passAlongAuthToken', () => {
       it('should call RNIterableAPI.passAlongAuthToken with a valid string token', async () => {
         // GIVEN a valid auth token