TRAC-362: add optional requestOptions to itemAdd and handleItemAdd for locale-aware cart requests

[bc-yevhenii-buliuk]

Jira: TRAC-362

What/Why?

This PR adds optional requestOptions param to itemAdd() and handleItemAdd() for multi-lang support

BigCommerce supports multi-language via URL subfolder locales (e.g. /es, /fr). When a shopper is on site.com/es, AJAX requests must include the /es prefix so the server returns translated content.

itemAdd() and handleItemAdd() previously ignored the third argument, making it impossible to pass baseUrl from the theme. As a result, the add-to-cart request was sent to /remote/v1/cart/add instead of /es/remote/v1/cart/add, and the cart modal displayed untranslated content.

Rollout/Rollback

revert the PR

Testing

TRAC_362_fix_testing_on_Integration.mov

add-es-product-to-cart.mov

---

Note

Low Risk
Low risk: small, backward-compatible signature change that only threads an optional baseUrl through the existing request options for add-to-cart; main risk is inadvertent behavior change if callers relied on the ignored third argument.

Overview
Enables locale-aware add-to-cart requests by adding an optional requestOptions parameter to cart.itemAdd() and cart.handleItemAdd() and forwarding requestOptions.baseUrl into the underlying /cart/add remote request.

Updates unit tests to assert baseUrl is passed through when provided and that calls without requestOptions remain backward compatible.

^{Reviewed by Cursor Bugbot for commit 52b6ef6. 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.}

[funivan]

could you check all calls related to remoteRequest. Thanks.

[github-actions]

🎉 This PR is included in version 6.22.0 🎉

The release is available on:

• GitHub release
• npm package (@latest dist-tag)
• 6.22.0

Your semantic-release bot 📦🚀