[SDK-136] Add JWT Token generator #765

lposen · 2025-10-20T22:07:09Z

🔹 JIRA Ticket(s) if any

SDK-136

✏️ Description

Adds a token generator

Testing

Run the example app on ios and android
Logging in should work

… details

…APIModule

…into a ReadableMap

…IterableAuthManager

… ReactIterableAPI

Copilot

Pull Request Overview

This PR implements JWT token generation functionality for the Iterable SDK, enabling support for JWT-enabled API keys. The implementation includes TypeScript type definitions, native iOS and Android implementations, and comprehensive test coverage.

Adds JWT token generator method accessible via IterableAuthManager.generateJwtToken()
Implements native token generation for both iOS (Swift) and Android (Java) platforms
Updates example app to demonstrate JWT authentication flow

Reviewed Changes

Copilot reviewed 17 out of 17 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
`src/index.tsx`	Exports new `IterableGenerateJwtTokenArgs` type
`src/core/types/index.ts`	Re-exports JWT token arguments type
`src/core/types/IterableGenerateJwtTokenArgs.ts`	Defines TypeScript type for JWT token generation parameters with email/userId union
`src/core/classes/IterableAuthManager.ts`	Adds `generateJwtToken` method with comprehensive documentation
`src/core/classes/IterableApi.ts`	Implements static `generateJwtToken` method and corrects typo in comment
`src/core/classes/Iterable.ts`	Removes unused timeout variable and cleanup code
`src/api/NativeRNIterableAPI.ts`	Defines native module interface for JWT token generation
`src/__tests__/IterableAuthManager.test.ts`	Adds comprehensive test suite for auth manager functionality
`src/__mocks__/MockRNIterableAPI.ts`	Implements mock for JWT token generation testing
`ios/RNIterableAPI/ReactIterableAPI.swift`	Implements native iOS JWT generation with validation
`ios/RNIterableAPI/RNIterableAPI.mm`	Bridges Swift implementation to React Native
`example/src/hooks/useIterableApp.tsx`	Demonstrates JWT auth handler usage in example app
`example/README.md`	Updates documentation with JWT setup instructions
`example/.env.example`	Adds JWT secret configuration template
`android/src/oldarch/java/com/RNIterableAPIModule.java`	Adds JWT generation method to old architecture module
`android/src/newarch/java/com/RNIterableAPIModule.java`	Adds JWT generation method to new architecture module
`android/src/main/java/com/iterable/reactnative/RNIterableAPIModuleImpl.java`	Implements Android JWT token generation logic

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

Copilot · 2025-10-20T22:16:00Z

ios/RNIterableAPI/ReactIterableAPI.swift

+        userId: userId
+      )
+    } else if let email = email {
+      token = IterableTokenGenerator.generateJwtForEial(


Corrected spelling of 'generateJwtForEial' to 'generateJwtForEmail'.

Suggested change

token = IterableTokenGenerator.generateJwtForEial(

token = IterableTokenGenerator.generateJwtForEmail(

Copilot · 2025-10-20T22:16:01Z

example/README.md

 1. Sign into your Iterable account
 2. Go to [Integrations > API Keys](https://app.iterable.com/settings/apiKeys)
 3. Click "New API Key" in the top right corner
 4. Fill in the followsing fields:


Corrected spelling of 'followsing' to 'following'.

Suggested change

4. Fill in the followsing fields:

4. Fill in the following fields:

…r version 6.21.0

github-actions · 2025-10-20T22:18:40Z

Lines	Statements	Branches	Functions
	57.5% (318/553)	30.45% (67/220)	56.37% (115/204)

Ayyanchira · 2025-10-20T22:24:09Z

We might have to re-consider JWT generator in native SDKs. Idea of JWT is that tokens will be generated on Client's server side. The generator on client side was just for testing purpose and should have lived in the Tester apps for purpose of test. Will need to investigate how native layer jwt generation code made it to public SDK

qltysh · 2025-10-21T02:38:32Z

3 new issues

Tool	Category	Rule	Count
qlty	Structure	High total complexity (count = 56)	1
qlty	Structure	Function with high complexity (count = 7): generateJwtToken	1
qlty	Structure	Function with many returns (count = 9): IterableAppProvider	1

_{This is from Qlty Cloud, the successor to Code Climate Quality. Learn more.}

qltysh · 2025-10-21T02:38:35Z

❌ 3 blocking issues (6 total)

Tool	Category	Rule	Count
eslint	Lint	Error loading TSDoc config file:
Error encountered for /home/runner/work/react-native-sdk/tsdoc.json:
Unable to resolve "extends" reference to "typedoc/tsdoc.json": Cannot find module 'typedoc/tsdoc.json' from '/home/runner/work/react-native-sdk'
3	❌
qlty	Structure	High total complexity (count = 56)	1
qlty	Structure	Function with high complexity (count = 7): generateJwtToken	1
qlty	Structure	Function with many returns (count = 9): IterableAppProvider	1

_{This is from Qlty Cloud, the successor to Code Climate Quality. Learn more.}

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

src/__tests__/IterableAuthManager.test.ts

src/core/classes/IterableAuthManager.ts

src/core/types/IterableGenerateJwtTokenArgs.ts

qltysh · 2025-10-21T02:38:47Z

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

+    public void generateJwtToken(ReadableMap opts, Promise promise) {
+        try {
+            String secret = opts.getString("secret");
+            long durationMs = (long) opts.getDouble("duration");
+            String userId = opts.hasKey("userId") && !opts.isNull("userId") ? opts.getString("userId") : null;
+            String email = opts.hasKey("email") && !opts.isNull("email") ? opts.getString("email") : null;
+
+            // Validate that exactly one of userId or email is provided
+            if ((userId != null && email != null) || (userId == null && email == null)) {
+                promise.reject("E_INVALID_ARGS", "The token must include a userId or email, but not both.", (Throwable) null);
+                return;
+            }
+
+            // Use the Android SDK's Duration-based JWT generator
+            Duration duration = Duration.ofMillis(durationMs);
+            String token = IterableJwtGenerator.generateToken(secret, duration, email, userId);
+            promise.resolve(token);
+        } catch (Exception e) {
+            promise.reject("E_JWT_GENERATION_FAILED", "Failed to generate JWT: " + e.getMessage(), e);
+        }


Function with high complexity (count = 7): generateJwtToken [qlty:function-complexity]

qltysh · 2025-10-21T02:38:47Z

src/__tests__/IterableAuthManager.test.ts

@@ -0,0 +1,186 @@
+import { MockRNIterableAPI } from '../__mocks__/MockRNIterableAPI';


Error loading TSDoc config file:
Error encountered for /home/runner/work/react-native-sdk/tsdoc.json:
Unable to resolve "extends" reference to "typedoc/tsdoc.json": Cannot find module 'typedoc/tsdoc.json' from '/home/runner/work/react-native-sdk'
[eslint:tsdoc/syntax]

qltysh · 2025-10-21T02:38:47Z

src/core/classes/IterableAuthManager.ts

@@ -1,5 +1,6 @@
-import { IterableAuthResponse } from './IterableAuthResponse';
+import type { IterableGenerateJwtTokenArgs } from '../types/IterableGenerateJwtTokenArgs';


Error loading TSDoc config file:
Error encountered for /home/runner/work/react-native-sdk/tsdoc.json:
Unable to resolve "extends" reference to "typedoc/tsdoc.json": Cannot find module 'typedoc/tsdoc.json' from '/home/runner/work/react-native-sdk'
[eslint:tsdoc/syntax]

qltysh · 2025-10-21T02:38:47Z

src/core/types/IterableGenerateJwtTokenArgs.ts

@@ -0,0 +1,28 @@
+interface IterableGenerateJwtTokenArgsBase {


Error loading TSDoc config file:
Error encountered for /home/runner/work/react-native-sdk/tsdoc.json:
Unable to resolve "extends" reference to "typedoc/tsdoc.json": Cannot find module 'typedoc/tsdoc.json' from '/home/runner/work/react-native-sdk'
[eslint:tsdoc/syntax]

qltysh · 2025-10-21T02:38:52Z

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

+    public void generateJwtToken(ReadableMap opts, Promise promise) {
+        try {
+            String secret = opts.getString("secret");
+            long durationMs = (long) opts.getDouble("duration");
+            String userId = opts.hasKey("userId") && !opts.isNull("userId") ? opts.getString("userId") : null;
+            String email = opts.hasKey("email") && !opts.isNull("email") ? opts.getString("email") : null;
+
+            // Validate that exactly one of userId or email is provided
+            if ((userId != null && email != null) || (userId == null && email == null)) {
+                promise.reject("E_INVALID_ARGS", "The token must include a userId or email, but not both.", (Throwable) null);
+                return;
+            }
+
+            // Use the Android SDK's Duration-based JWT generator
+            Duration duration = Duration.ofMillis(durationMs);
+            String token = IterableJwtGenerator.generateToken(secret, duration, email, userId);
+            promise.resolve(token);
+        } catch (Exception e) {
+            promise.reject("E_JWT_GENERATION_FAILED", "Failed to generate JWT: " + e.getMessage(), e);
+        }


Function with high complexity (count = 7): generateJwtToken [qlty:function-complexity]

qltysh · 2025-10-21T02:38:53Z

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

+    public void generateJwtToken(ReadableMap opts, Promise promise) {
+        try {
+            String secret = opts.getString("secret");
+            long durationMs = (long) opts.getDouble("duration");
+            String userId = opts.hasKey("userId") && !opts.isNull("userId") ? opts.getString("userId") : null;
+            String email = opts.hasKey("email") && !opts.isNull("email") ? opts.getString("email") : null;
+
+            // Validate that exactly one of userId or email is provided
+            if ((userId != null && email != null) || (userId == null && email == null)) {
+                promise.reject("E_INVALID_ARGS", "The token must include a userId or email, but not both.", (Throwable) null);
+                return;
+            }
+
+            // Use the Android SDK's Duration-based JWT generator
+            Duration duration = Duration.ofMillis(durationMs);
+            String token = IterableJwtGenerator.generateToken(secret, duration, email, userId);
+            promise.resolve(token);
+        } catch (Exception e) {
+            promise.reject("E_JWT_GENERATION_FAILED", "Failed to generate JWT: " + e.getMessage(), e);
+        }


Function with high complexity (count = 7): generateJwtToken [qlty:function-complexity]

lposen added 10 commits October 17, 2025 14:31

docs: update .env.example and README.md to include JWT authentication…

e5a5d18

… details

feat: add JWT generation method for user authentication in RNIterable…

7d9011a

…APIModule

refactor: simplify JWT generation method by consolidating parameters …

fe926aa

…into a ReadableMap

feat: update JWT generation method

0c34d2e

feat: implement JWT token generation with email or userId support

6fa6fcb

feat: add unit tests for JWT token generation and related methods in …

1b4f196

…IterableAuthManager

feat: implement generateJwtToken method in ReactIterableAPI

a843b5d

refactor: update auth token handling and improve conditional check in…

d484c41

… ReactIterableAPI

refactor: remove unused method and update JWT token example

51441fb

chore: removed accidentally added change

12d0add

lposen requested a review from Copilot October 20, 2025 22:15

Copilot AI reviewed Oct 20, 2025

View reviewed changes

chore: update yarn.lock to remove deprecated @typescript-eslint/parse…

c4d86d5

…r version 6.21.0

lposen added the jwt label Oct 20, 2025

qltysh bot reviewed Oct 21, 2025

View reviewed changes

	token = IterableTokenGenerator.generateJwtForEial(
	token = IterableTokenGenerator.generateJwtForEmail(

	4. Fill in the followsing fields:
	4. Fill in the following fields:

		@@ -0,0 +1,186 @@
		import { MockRNIterableAPI } from '../__mocks__/MockRNIterableAPI';

		@@ -1,5 +1,6 @@
		import { IterableAuthResponse } from './IterableAuthResponse';
		import type { IterableGenerateJwtTokenArgs } from '../types/IterableGenerateJwtTokenArgs';

		@@ -0,0 +1,28 @@
		interface IterableGenerateJwtTokenArgsBase {

[SDK-136] Add JWT Token generator #765

Are you sure you want to change the base?

[SDK-136] Add JWT Token generator #765

Uh oh!

Conversation

lposen commented Oct 20, 2025 • edited by atlassian bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔹 JIRA Ticket(s) if any

✏️ Description

Testing

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Copilot AI Oct 20, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 20, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Oct 20, 2025

Uh oh!

Ayyanchira commented Oct 20, 2025

Uh oh!

qltysh bot commented Oct 21, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

3 new issues

Uh oh!

qltysh bot commented Oct 21, 2025

❌ 3 blocking issues (6 total)

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

qltysh bot Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

qltysh bot Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

qltysh bot Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

qltysh bot Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

qltysh bot Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

qltysh bot Oct 21, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

lposen commented Oct 20, 2025 •

edited by atlassian bot

Loading

qltysh bot commented Oct 21, 2025 •

edited

Loading