Release braintree-web 3.129.0 source

Author: braintreeps

.husky/pre-commit

@@ -4,14 +4,8 @@
 FILES=$(git diff --name-only --cached --diff-filter=ACM | grep -E '(js|jsx)$' | grep -Ev '^(tasks\/|test\/)' || true)
 
 if [ ! -z "$FILES" ]; then
-	for file in $FILES; do
-		if ! npx eslint "$file"; then
-			echo "ESLint failed on staged file '$file'. Please fix the errors and try again."
-			exit 1
-		fi
-	done
+	echo "$FILES" | xargs ./node_modules/.bin/eslint --cache
 
-	# Prettify all selected files
 	echo "$FILES" | xargs ./node_modules/.bin/prettier --ignore-unknown --cache --check
 else
 	echo -e "\033[1;31m You have no staged javascript files, skipping checks .. \033[0m"

CHANGELOG.md

@@ -1,5 +1,12 @@
 # CHANGELOG
 
+## 3.129.0 (2025-09-04)
+
+- PayPalCheckout
+  - Change the URL of `teBraintree` environment to `www.braintree.stage.paypal.com`
+- PayPal Checkout
+  - Improve observability for App Switch flow
+
 ## 3.128.0 (2025-08-28)
 
 - Hosted Fields

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "braintree-web",
-  "version": "3.128.0",
+  "version": "3.129.0",
   "license": "MIT",
   "main": "src/index.js",
   "private": true,

package.json

@@ -1580,6 +1580,12 @@ PayPalCheckout.prototype._attachPreloadPixel = function (options) {
   }
   if (options.merchantId) {
     preloadOptions["merchant-id"] = options.merchantId;
+  } else if (
+    this._configuration &&
+    this._configuration.gatewayConfiguration.merchantId
+  ) {
+    preloadOptions["merchant-id"] =
+      this._configuration.gatewayConfiguration.merchantId;
   }
 
   request = new XMLHttpRequest();
@@ -1612,6 +1618,13 @@ PayPalCheckout.prototype._formatPaymentResourceData = function (
     },
     shippingOptions: options.shippingOptions,
     payer_email: options.userAuthenticationEmail, // eslint-disable-line camelcase
+    source: constants.BT_SOURCE,
+    merchant: gatewayConfiguration.merchantId,
+
+    flowType:
+      options.flow === "vault"
+        ? constants.BT_FLOW_TYPES.VAULT
+        : constants.BT_FLOW_TYPES.EXPRESS_CHECKOUT,
   };
 
   if (options.hasOwnProperty("returnUrl")) {

src/paypal-checkout/paypal-checkout.js

@@ -10,6 +10,11 @@ module.exports = {
   ENVIRONMENT: {
     stage: "https://www.msmaster.qa.paypal.com/sdk/js?",
     sandbox: "https://www.sandbox.paypal.com/sdk/js?",
-    teBraintree: "https://www.te-braintree.qa.paypal.com/sdk/js?",
+    teBraintree: "https://www.braintree.stage.paypal.com/sdk/js?",
+  },
+  BT_SOURCE: "bsdk",
+  BT_FLOW_TYPES: {
+    VAULT: "va",
+    EXPRESS_CHECKOUT: "ecs",
   },
 };

src/paypal/shared/constants.js

@@ -12,6 +12,7 @@ const frameService = require("../../../src/lib/frame-service/external");
 const { fake, yieldsAsync } = require("../../helpers");
 const methods = require("../../../src/lib/methods");
 const errors = require("../../../src/paypal-checkout/errors");
+const constants = require("../../../src/paypal/shared/constants");
 
 describe("PayPalCheckout", () => {
   let testContext;
@@ -3268,7 +3269,7 @@ describe("PayPalCheckout", () => {
           firstHeadElement
         );
         expect(fakeScript.src).toMatch(
-          "https://www.te-braintree.qa.paypal.com/sdk/js?"
+          "https://www.braintree.stage.paypal.com/sdk/js?"
         );
       });
     });
@@ -3845,6 +3846,7 @@ describe("PayPalCheckout", () => {
       testContext.configuration = {
         authorization: "development_testing_altpay_merchant",
         gatewayConfiguration: {
+          merchantId: "merchant-id",
           paypal: {
             assetsUrl: "https://paypal.assets.url",
             displayName: "my brand",
@@ -3946,6 +3948,100 @@ describe("PayPalCheckout", () => {
       expect(actual.cancelUrl).toBe("www.example.com/cancel");
     });
 
+    it("includes BT source parameter with value 'bsdk'", () => {
+      const options = {
+        flow: "checkout",
+      };
+
+      const actual = PayPalCheckout.prototype._formatPaymentResourceData.call(
+        {
+          _configuration: testContext.configuration,
+          _formatPaymentResourceCheckoutData: jest.fn(),
+          _formatPaymentResourceVaultData: jest.fn(),
+        },
+        options,
+        testContext.config
+      );
+
+      expect(actual.source).toBe(constants.BT_SOURCE);
+    });
+
+    it("includes BT merchant parameter from gateway configuration", () => {
+      const options = {
+        flow: "checkout",
+      };
+
+      const actual = PayPalCheckout.prototype._formatPaymentResourceData.call(
+        {
+          _configuration: testContext.configuration,
+          _merchantAccountId: "DEFAULT_MERCHANT_ID",
+          _formatPaymentResourceCheckoutData: jest.fn(),
+          _formatPaymentResourceVaultData: jest.fn(),
+        },
+        options,
+        testContext.config
+      );
+
+      expect(actual.merchant).toBe("merchant-id");
+    });
+
+    it("includes BT flowType parameter as 'ecs' for checkout flow", () => {
+      const options = {
+        flow: "checkout",
+      };
+
+      const actual = PayPalCheckout.prototype._formatPaymentResourceData.call(
+        {
+          _configuration: testContext.configuration,
+          _formatPaymentResourceCheckoutData: jest.fn(),
+          _formatPaymentResourceVaultData: jest.fn(),
+        },
+        options,
+        testContext.config
+      );
+
+      expect(actual.flowType).toBe(constants.BT_FLOW_TYPES.EXPRESS_CHECKOUT);
+    });
+
+    it("includes BT flowType parameter as 'va' for vault flow", () => {
+      const options = {
+        flow: "vault",
+      };
+
+      const actual = PayPalCheckout.prototype._formatPaymentResourceData.call(
+        {
+          _configuration: testContext.configuration,
+          _formatPaymentResourceCheckoutData: jest.fn(),
+          _formatPaymentResourceVaultData: jest.fn(),
+        },
+        options,
+        testContext.config
+      );
+
+      expect(actual.flowType).toBe(constants.BT_FLOW_TYPES.VAULT);
+    });
+
+    it("includes all BT parameters together", () => {
+      const options = {
+        flow: "checkout",
+      };
+
+      const actual = PayPalCheckout.prototype._formatPaymentResourceData.call(
+        {
+          _configuration: testContext.configuration,
+          _merchantAccountId: "DEFAULT_MERCHANT_ID",
+          _formatPaymentResourceCheckoutData: jest.fn(),
+          _formatPaymentResourceVaultData: jest.fn(),
+        },
+        options,
+        testContext.config
+      );
+
+      expect(actual.source).toBe(constants.BT_SOURCE);
+      expect(actual.merchant).toBe("merchant-id");
+      expect(actual.flowType).toBe(constants.BT_FLOW_TYPES.EXPRESS_CHECKOUT);
+    });
+
     it("passes along appSwitchPreference when passed", () => {
       const options = {
         appSwitchPreference: {