Refactor draft order sync flows

[pbennett1-godaddy]

Summary

Refactors the React checkout draft-order synchronization flow to make checkout state updates more reliable before payment confirmation.

This branch centralizes draft-order sync behavior, reduces duplicate order mutations, improves recovery/error handling when syncs fail, and ensures payment flows flush pending draft-order changes
before attempting checkout confirmation. It also expands checkout test coverage across validation, shipping, pickup, totals, tips, discounts, payment methods, redirects, hydration, tracking, and error
states.

Changeset

• Changeset added (docs)

Added:

• .changeset/quiet-checkouts-sync.md
  • Patch release for @godaddy/react

Test Plan

• Ran TypeScript validation:

  pnpm --filter @godaddy/react typecheck                                                                                                                                                                

                                                                                                                                                                                                          
- [x] Added and updated checkout test coverage for:                                                                                                                                                       
    - Draft order sync provider behavior                                                                                                                                                                  
    - Checkout confirmation blocking while sync is pending                                                                                                                                                
    - Sync failure recovery paths and displayed errors                                                                                                                                                    
    - Shipping method re-application and tax recalculation                                                                                                                                                
    - Free order / free payment transitions                                                                                                                                                               
    - Pickup selection and fulfillment location flows                                                                                                                                                     
    - Billing and address validation behavior                                                                                                                                                             
    - Payment flush behavior before confirmation                                                                                                                                                          
    - Wallet/payment method rendering and gating                                                                                                                                                          
    - Totals, tips, discounts, redirects, hydration, and tracking contracts                                                                                                                               
- [x] Verified the current @godaddy/react TypeScript errors are resolved.                                                            

[changeset-bot]

🦋 Changeset detected

Latest commit: 8d73ddf

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@godaddy/react	Patch
nextjs	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[wcole1-godaddy]

[P1] DraftOrderExpressCheckout can now crash outside the full checkout form.

useConfirmCheckout() now creates useFlushCheckoutSync(), which immediately calls useDraftOrderSyncQueue() and throws unless a DraftOrderSyncProvider is present. The standalone exported DraftOrderExpressCheckout only provides checkoutContext, so rendering express buttons that transitively use useConfirmCheckout can fail before checkout starts. Also, DraftOrderSyncProvider itself needs useFormContext, so a fix needs either an optional/no-op flush path for standalone express checkout or a proper form/sync provider wrapper.

Relevant paths: packages/react/src/components/checkout/payment/utils/use-flush-checkout-sync.ts, packages/react/src/components/checkout/payment/utils/use-confirm-checkout.ts, and packages/react/src/components/checkout/express-checkout/express-checkout.tsx.