SDK-563 pass configurable preferUserId through tryUser to setUserID/setEmail

[joaodordio]

📝 Summary

Pass preferUserId through tryUser so setUserID / JWT setEmail can opt out of identify-time user creation (SDK-563 pt2).

🎟️ Jira Ticket: SDK-563

📖 Description

Follow-up to #578 / 2.3.0.

That release made preferUserId configurable on updateUser, updateCart, and trackPurchase, but setUserID / JWT setEmail still called tryUser() → updateUser({}), which forced preferUserId: true. Care.com (email-based project) hit this on identify and got placeholder / duplicate profiles.

This PR:

• Threads an optional preferUserId arg through setUserID and JWT setEmail into tryUser → updateUser({ preferUserId })
• Keeps the existing default (undefined → true) so callers that omit it behave as before
• Adds authorization tests for default true and explicit false on non-JWT setUserID, JWT setUserID, and JWT setEmail
• Adds a CHANGELOG Unreleased entry

Usage Care validated:

setUserID('user-123', undefined, false)

🧪 How to test?

1. yarn jest --config jest.config.js src/authorization/authorization.test.ts -t preferUserId
2. In a sample app (JWT or non-JWT), call setUserID('test-id', undefined, false) and confirm /users/update body has preferUserId: false
3. Call setUserID('test-id') with no third arg and confirm /users/update still sends preferUserId: true

🧾 Changelog

CHANGELOG Unreleased entry added for the tryUser handoff (SDK-563).

📹 Loom recording if applicable

N/A

🐞 Github Issues solved

N/A

📚 Docs PR if applicable

https://github.com/Iterable/iterable-docs/pull/1574 (docs/sdk/august-release)

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 74.43%. Comparing base (669147f) to head (aaeb652).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #582   +/-   ##
=======================================
  Coverage   74.43%   74.43%           
=======================================
  Files          57       57           
  Lines        2742     2742           
  Branches      821      821           
=======================================
  Hits         2041     2041           
  Misses        700      700           
  Partials        1        1           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.