[Android] Add support for ec_auth and ec_color_scheme

[kiftio]

What changes are you making?

The EmbeddedCheckoutProtocol.url() function previously accepted a flat List<String> for delegations. This PR introduces a typed Options class and a typed Delegation class to the Kotlin ECP library, replacing the raw string list with a structured, extensible API.

Key changes:

• Introduces EmbeddedCheckoutProtocol.Options to group delegations, auth, and colorScheme into a single parameter passed to url().
• Introduces EmbeddedCheckoutProtocol.Delegation as a string-backed value type with a companion catalog of known delegations (windowOpen, paymentCredential, paymentInstrumentsChange, fulfillmentAddressChange). Unknown delegation values round-trip intact for forward compatibility.
• url() now appends ec_auth and ec_color_scheme query parameters in addition to ec_version and ec_delegate, and strips stale values of all four protocol params before re-applying them.
• appendEcpParams() in the Android SDK now reads any existing ec_auth value from the caller-supplied URL and forwards it through Options.auth, preserving caller-supplied auth tokens.
• The Kotlin catalog generation script (generate_kotlin_catalog.mjs) is updated to read x-delegations from the OpenRPC spec and emit the Delegation companion catalog automatically.

How to test

1. Run the protocol library tests:

   ./gradlew :embedded-checkout-protocol:test
   

2. Run the Android SDK tests:

   ./gradlew :lib:test
   

3. Verify that a URL containing ?ec_auth=token passed through appendEcpParams() retains ec_auth=token in the output.
4. Verify that calling EmbeddedCheckoutProtocol.url() with Options(auth = "token", colorScheme = "dark") appends ec_auth=token and ec_color_scheme=dark.
5. Verify idempotency: calling url() twice with the same Options on an already-decorated URL produces a single set of protocol params with no duplicates.

---

Before you merge

Important

• I've added tests to support my implementation
• I have read and agree with the Contribution Guidelines
• I have read and agree with the Code of Conduct
• I've updated the relevant platform README (platforms/swift/README.md and/or platforms/android/README.md)

---

Releasing a new Swift version?

• I have bumped the version in ShopifyCheckoutKit.podspec
• I have bumped the version in platforms/swift/Sources/ShopifyCheckoutKit/ShopifyCheckoutKit.swift
• I have updated platforms/swift/CHANGELOG.md
• I have updated the SwiftPM/CocoaPods version snippets in platforms/swift/README.md (major version only)

Releasing a new Android version?

• I have bumped checkoutKitAndroid in platforms/android/gradle/libs.versions.toml
• I have updated platforms/android/CHANGELOG.md
• I have updated the Gradle/Maven version snippets in platforms/android/README.md

Tip

See the Contributing documentation for the full release process per platform.

[kiftio]

• [Android] Expose fulfillmentChange #340 : 2 dependent PRs (#288 , #342 )
• [Android] Add support for ec_auth and ec_color_scheme #326 👈 (View in Graphite)
• [Android] Move url encoding to protocol #324
• [Android] publish packages independently #329
• [Android] extract checkout protocol module #315
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

React Native — Coverage Report

Lines	Statements	Branches	Functions
	91.66% (319/348)	87.86% (181/206)	100% (82/82)

[github-actions]

Package Size

Platform	Artifact	Base	Head	Delta
Android	release AAR	167.2 KiB	167.4 KiB	+210 B

Measured from the PR base SHA and PR head SHA. This comment reports package artifact sizes only; it is not a final app binary-size report.

[kiftio]

Merge activity

• Jun 25, 11:07 AM UTC: A user started a stack merge that includes this pull request via Graphite.
• Jun 25, 11:07 AM UTC: @kiftio merged this pull request with Graphite.