@propeller-commerce/propeller-v2-react-ui 0.4.13 → 0.4.14

package/CHANGELOG.md

@@ -8,6 +8,23 @@ once it reaches 1.0. Until then (the `0.x` line) the public API may change
 between minor versions; breaking changes are called out below and in
 [MIGRATION.md](./MIGRATION.md).
 
+## [0.4.14] - 2026-06-26
+
+### Added
+
+- **`useCheckout().placeOrder` now supports PSP (deferred-payment) orders.**
+  - `orderStatus` accepts `'UNFINISHED'` (and any backend status string), not
+    just `'NEW'` / `'REQUEST'` — for an order awaiting an external payment whose
+    final status the PSP webhook sets later.
+  - New `finalizeOrder?: boolean` option (default `true`). Pass `false` to defer
+    the order-confirmation email, confirm event, PDF attachment, **and cart
+    deletion** to payment time — so a shopper handed off to a PSP isn't emailed
+    and their cart isn't cleared before they've paid.
+
+  Both are backward compatible: existing callers (which omit `finalizeOrder`)
+  behave exactly as before — a normal order and a quote still finalize at
+  placement.
+
 ## [0.4.13] - 2026-06-25
 
 ### Added

package/dist/index.cjs

@@ -1015,6 +1015,8 @@ function useCheckout(options) {
         const cartService = propellerV2CoreUi.createServices(graphqlClient).cart;
         const orderService = propellerV2CoreUi.createServices(graphqlClient).order;
         const { cartId, orderStatus, reference, notes, isQuoteMode } = opts;
+        const finalizeOrder = opts.finalizeOrder ?? true;
+        const sendConfirmation = finalizeOrder && !isQuoteMode;
         if (reference || notes) {
           await cartService.updateCart({
             id: cartId,
@@ -1036,10 +1038,13 @@ function useCheckout(options) {
           orderId,
           status: orderStatus,
           payStatus: propellerSdkV2.PaymentStatuses.OPEN,
-          sendOrderConfirmationEmail: !isQuoteMode,
-          addPDFAttachment: !isQuoteMode,
-          triggerOrderSendConfirmEvent: !isQuoteMode,
-          deleteCart: true
+          sendOrderConfirmationEmail: sendConfirmation,
+          addPDFAttachment: sendConfirmation,
+          triggerOrderSendConfirmEvent: sendConfirmation,
+          // Keep the cart only for an unfinalized (PSP-pending) order so the
+          // shopper can retry payment; clear it once the order is finalized
+          // (a normal order or a quote).
+          deleteCart: finalizeOrder
         });
         if (isQuoteMode) {
           await orderService.triggerQuoteSendRequest({ orderId, language });