@propeller-commerce/propeller-v2-vue-ui 0.3.22 → 0.3.23

package/CHANGELOG.md

@@ -8,6 +8,22 @@ 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.3.23] - 2026-06-26
+
+### Added
+
+- **`useCheckout().placeOrder` now supports PSP (deferred-payment) orders.**
+  - New `orderStatus?` option — defaults to `'REQUEST'` in quote mode / `'NEW'`
+    otherwise; pass `'UNFINISHED'` (or any backend status string) 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.
+
+  Backward compatible: existing callers behave exactly as before. Mirrors React
+  UI 0.4.14.
+
 ## [0.3.22] - 2026-06-25
 
 ### Added

package/dist/composables/vue/useCheckout.d.ts

@@ -22,6 +22,25 @@ export interface PlaceOrderOptions {
     isQuoteMode?: boolean;
     reference?: string;
     notes?: string;
+    /**
+     * Order status to set. When omitted it defaults to `'REQUEST'` in quote mode
+     * and `'NEW'` otherwise. Pass `'UNFINISHED'` for an order awaiting an external
+     * payment (PSP) whose final status the payment webhook sets later. Any backend
+     * status string is accepted.
+     */
+    orderStatus?: 'NEW' | 'REQUEST' | 'UNFINISHED' | (string & {});
+    /**
+     * Whether this placement *finalizes* the order — i.e. sends the order
+     * confirmation email, fires the confirm event, attaches the order PDF, and
+     * clears the cart. Defaults to `true`.
+     *
+     * Set this to `false` for an order awaiting an external payment (e.g.
+     * `'UNFINISHED'` orders handed off to a PSP). The confirmation/cart deletion
+     * should then happen when the payment is confirmed (the PSP webhook), not at
+     * placement — otherwise the shopper is emailed and the cart cleared before
+     * they've paid.
+     */
+    finalizeOrder?: boolean;
 }
 /** Backwards-friendly alias kept for the public `UseCheckout*` type re-exports. */
 export type PlaceOrderResult = Result<{

package/dist/index.cjs

@@ -946,7 +946,9 @@ function useCheckout(options) {
           language
         });
       }
-      const orderStatus = opts.isQuoteMode ? "REQUEST" : "NEW";
+      const orderStatus = opts.orderStatus ?? (opts.isQuoteMode ? "REQUEST" : "NEW");
+      const finalizeOrder = opts.finalizeOrder ?? true;
+      const sendConfirmation = finalizeOrder && !opts.isQuoteMode;
       const response = await cartService.processCart({
         id: cartId,
         input: { orderStatus, language }
@@ -957,10 +959,10 @@ function useCheckout(options) {
         orderId,
         status: orderStatus,
         payStatus: propellerSdkV2.PaymentStatuses.OPEN,
-        sendOrderConfirmationEmail: !opts.isQuoteMode,
-        addPDFAttachment: !opts.isQuoteMode,
-        triggerOrderSendConfirmEvent: !opts.isQuoteMode,
-        deleteCart: true
+        sendOrderConfirmationEmail: sendConfirmation,
+        addPDFAttachment: sendConfirmation,
+        triggerOrderSendConfirmEvent: sendConfirmation,
+        deleteCart: finalizeOrder
       });
       if (opts.isQuoteMode) {
         await orderService.triggerQuoteSendRequest?.({ orderId, language });