feat: add customBaseURL CNAME support to NetworkOptions

[jamesnrokt]

Summary

Adds NetworkOptions.Builder.setCustomBaseURL(String) which routes all mParticle endpoint traffic (config, events, identity, alias, audience) through a single HTTPS CNAME host. Mirrors iOS work from mparticle-apple-sdk#760.

What changed

• NetworkOptions: new customBaseURL field + getter; Builder.setCustomBaseURL(@NonNull String) validates HTTPS scheme, requires a host, and stores host(:port) only — path/query/fragment ignored.
• MParticleBaseClientImpl.getUrl: when customBaseURL is set:
  • Skips the pod prefix (the CNAME's CDN handles regional routing).
  • Logs a warning and ignores any per-endpoint DomainMapping and overridesSubdirectory (unsupported with CDN routing).
  • Rewrites paths to: /config/v4/<key>/config, /nativeevents/v2/<key>/events, /identity/v1/<path>, /nativeevents/v1/identity/<key>/alias, /nativeevents/v1/<key>/audience.
• android-core/proguard.pro: adds -keep rules for MParticle$Internal and ConfigManager.getNetworkOptions() so downstream kits can navigate the public extension surface after R8 minification.

Downstream

The Rokt kit reads NetworkOptions.customBaseURL and forwards it to the Rokt SDK: mparticle-integrations/mparticle-android-integration-rokt#143

Test plan

Added 9 androidTest cases in MParticleBaseClientImplTest:

• Custom CNAME routes config endpoint via /config/v4/
• Custom CNAME routes events endpoint via /nativeevents/v2/
• Custom CNAME routes identity endpoint via /identity/v1/
• Custom CNAME routes alias endpoint via /nativeevents/v1/identity/
• Custom CNAME routes audience endpoint via /nativeevents/v1/<key>/audience
• Non-HTTPS values rejected
• Path/query stripped
• Port preserved
• Malformed URL rejected

Locally: :android-core:testDebugUnitTest passes (existing unit suite); :android-core:compileDebugAndroidTestKotlin compiles. AndroidTest suite runs on CI emulator.

🤖 Generated with Claude Code

[cursor]

PR Summary

Medium Risk
Changes core URL construction for all network endpoints by introducing a global customBaseURL override, which could misroute traffic or break uploads/config/identity if path/host resolution is wrong; mitigated by extensive new instrumentation tests and input validation.

Overview
Adds NetworkOptions.Builder.setCustomBaseURL() (stored as host[:port]) and JSON serialization/deserialization support so a single HTTPS CNAME can override per-endpoint domain mappings.

Updates MParticleBaseClientImpl.getUrl() to resolve hosts via a new resolveHost() helper that prioritizes customBaseURL, adjusts endpoint path prefixes for CDN-style routing, and logs/ignores unsupported combinations (domain mappings and overridesSubdirectory when a custom base is set). Adds Android instrumentation tests covering endpoint URL rewriting, validation (HTTPS-only, malformed/path stripping, port preservation), and persistence via UploadSettings, plus ProGuard -keep rules for MParticle$Internal and ConfigManager.getNetworkOptions().

^{Reviewed by Cursor Bugbot for commit 91b1485. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 96950e7. Configure here.}

[denischilik]

Looks good to me but I think customBaseURL lost during database serialization round-trip should be addressed

[sonarqubecloud]

Quality Gate passed

Issues
4 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[mparticle-automation]

🎉 This PR is included in version 5.79.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀