[jferrao-itrbl]

📝 Summary

Expose IterableConfig.unknownUserHandler so JWT apps receive the native unknown user id before authHandler runs.

🎟️ Jira Ticket: SDK-804

📖 Description

Adds IterableConfig.unknownUserHandler and unknownUserHandlerPresent in toDict(), matching the native onUnknownUserCreated contract on iOS 6.7.5 and Android 3.10.1.

When the handler is set at Iterable.initialize, the iOS and Android bridges register an IterableUnknownUserHandler and emit handleUnknownUserCreatedCalled with { userId }. The JS layer invokes the config callback synchronously so integrators can stash the generated id before native requests a JWT via the existing authHandler (no TurboModule or authHandler signature changes).

TSDoc and tests document JWT pairing, omit logging the userId on handler errors, and leave onCriteriaReceived / onCriteriaFetchFailed unimplemented per ticket scope.

🧪 How to test?

• yarn typecheck
• yarn lint
• yarn check:circular
• yarn test (includes unknownUserHandler cases in Iterable.test.ts)
• Manual JWT UUA: enable UUA + consent, set unknownUserHandler to store userId, return a token for that id from authHandler (example harness: SDK-811)

🧾 Changelog

Added Unreleased entry in CHANGELOG.md for IterableConfig.unknownUserHandler (SDK-804).

📹 Loom recording if applicable

N/A

🐞 Github Issues solved

N/A

📚 Docs PR if applicable

N/A

[github-actions]

Lines	Statements	Branches	Functions
	72.84% (609/836)	62.37% (242/388)	68.16% (182/267)

[qltysh]

Coverage Impact

Unable to calculate total coverage change because base branch coverage was not found.

Modified Files with Diff Coverage (1)

Rating	File	% Diff	Uncovered Line #s
	src/core/classes/Iterable.ts	88.9%	1317
	Total	88.9%

🤖 Increase coverage with AI coding...

In the `feature/SDK-804-unknown-user-handler` branch, add test coverage for this new code:

- `src/core/classes/Iterable.ts` -- Line 1317

🚦 See full report on Qlty Cloud »

🛟 Help

• Diff Coverage: Coverage for added or modified lines of code (excludes deleted files). Learn more.

• Total Coverage: Coverage for the whole repository, calculated as the sum of all File Coverage. Learn more.

• File Coverage: Covered Lines divided by Covered Lines plus Missed Lines. (Excludes non-executable lines including blank lines and comments.)

  • Indirect Changes: Changes to File Coverage for files that were not modified in this PR. Learn more.

[rtlsilva]

Approving with one non-blocking suggestion.
Depending on the likelihood of adoption of verbatim guidance, it could be upgraded to blocking instead.