Feature: useBraintreePayPalOneTimePaymentSession hook

.changeset/clever-moose-spend.md

@@ -0,0 +1,5 @@
+---
+"@paypal/react-paypal-js": minor
+---
+
+Adds Braintree PayPal One Time Payment Session hook.

packages/react-paypal-js/src/v6/components/Braintree/BraintreePayPalProvider.test.tsx

@@ -4,7 +4,7 @@ import { act, render, waitFor } from "@testing-library/react";
 
 import { expectCurrentErrorValue } from "../../hooks/useErrorTestUtil";
 import { BraintreePayPalProvider } from "./BraintreePayPalProvider";
-import { useBraintreePayPal } from "../../hooks/useBraintreePayPal";
+import { useBraintreePayPal } from "../../hooks/Braintree/useBraintreePayPal";
 import { INSTANCE_LOADING_STATE } from "../../types/ProviderEnums";
 
 import type { BraintreeV6Namespace } from "../../types";

packages/react-paypal-js/src/v6/hooks/Braintree/braintreeUtils.ts

@@ -0,0 +1,34 @@
+/**
+ * Creates a Braintree payment session with error handling and retry prevention.
+ *
+ * @param sessionCreator - Function that creates the payment session
+ * @param failedInstanceRef - Ref tracking which checkout instance failed
+ * @param checkoutInstance - Current Braintree checkout instance
+ * @param setError - Error state setter
+ * @returns The payment session or null if creation fails
+ */
+export function createBraintreePaymentSession<T>(
+    sessionCreator: () => T,
+    failedInstanceRef: { current: unknown },
+    checkoutInstance: unknown,
+    setError: (error: Error | null) => void,
+): T | null {
+    // Skip retry if this checkout instance already failed
+    if (failedInstanceRef.current === checkoutInstance) {
+        return null;
+    }
+
+    try {
+        return sessionCreator();
+    } catch (err) {
+        failedInstanceRef.current = checkoutInstance;
+
+        const detailedError = new Error(
+            "Failed to create Braintree payment session. Ensure the BraintreePayPalProvider is properly initialized with a valid client token and namespace.",
+            { cause: err },
+        );
+
+        setError(detailedError);
+        return null;
+    }
+}

packages/react-paypal-js/src/v6/hooks/useBraintreePayPal.ts → packages/react-paypal-js/src/v6/hooks/Braintree/useBraintreePayPal.ts

@@ -1,9 +1,9 @@
 import { useContext } from "react";
 
-import { BraintreePayPalContext } from "../context/BraintreePayPalContext";
+import { BraintreePayPalContext } from "../../context/BraintreePayPalContext";
 
-import type { BraintreePayPalState } from "../context/BraintreePayPalContext";
-import type { BraintreePayPalProvider } from "../components/Braintree/BraintreePayPalProvider";
+import type { BraintreePayPalState } from "../../context/BraintreePayPalContext";
+import type { BraintreePayPalProvider } from "../../components/Braintree/BraintreePayPalProvider";
 
 /**
  * Returns {@link BraintreePayPalState} provided by a parent {@link BraintreePayPalProvider}.