@reactionary/commercetools 0.10.36 → 0.10.37

package/capabilities/checkout.capability.js

@@ -165,16 +165,46 @@ class CommercetoolsCheckoutCapability extends CheckoutCapability {
   }
   async getAvailableShippingMethods(payload) {
     const client = await this.getClient();
-    const shippingMethodsResponse = await client.shippingMethods.matchingCart().get({
-      queryArgs: {
-        cartId: payload.checkout.key
-      }
-    }).execute();
+    const [shippingMethodsResponse, cartResponse] = await Promise.all([
+      client.shippingMethods.matchingCart().get({
+        queryArgs: {
+          cartId: payload.checkout.key
+        }
+      }).execute(),
+      client.carts.withId({ ID: payload.checkout.key }).get().execute()
+    ]);
     const result = shippingMethodsResponse.body.results.map(
-      (shippingMethod) => this.factory.parseShippingMethod(this.context, shippingMethod)
+      (shippingMethod) => this.factory.parseShippingMethod(this.context, this.withFreeShipping(shippingMethod, cartResponse.body))
     );
     return success(result);
   }
+  /**
+   * Quotes the matching shipping rates as free where the cart reaches the
+   * rate's free-above threshold. commercetools' matching-cart query returns
+   * the rates at their configured price and only applies the threshold once
+   * the method is set on the cart.
+   */
+  withFreeShipping(shippingMethod, cart) {
+    return {
+      ...shippingMethod,
+      zoneRates: shippingMethod.zoneRates.map((zoneRate) => ({
+        ...zoneRate,
+        shippingRates: zoneRate.shippingRates.map((rate) => rate.isMatching && this.isFreeShipping(rate, cart) ? { ...rate, price: { ...rate.price, centAmount: 0 } } : rate)
+      }))
+    };
+  }
+  /**
+   * Whether commercetools charges nothing for the rate once the method is set:
+   * shipping is free if the sum of the (custom) line item prices, after line
+   * item discounts, reaches the rate's free-above threshold.
+   */
+  isFreeShipping(rate, cart) {
+    if (!rate.freeAbove || rate.freeAbove.currencyCode !== cart.totalPrice.currencyCode) {
+      return false;
+    }
+    const itemsTotal = [...cart.lineItems, ...cart.customLineItems].reduce((sum, item) => sum + item.totalPrice.centAmount, 0);
+    return itemsTotal >= rate.freeAbove.centAmount;
+  }
   async getAvailablePaymentMethods(payload) {
     const staticMethods = this.getStaticPaymentMethods(payload.checkout);
     const dynamicMethods = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reactionary/commercetools",
-  "version": "0.10.36",
+  "version": "0.10.37",
   "type": "module",
   "main": "./index.js",
   "types": "./src/index.d.ts",
@@ -9,7 +9,7 @@
     "url": "git+https://github.com/Solteq/reactionary.git"
   },
   "dependencies": {
-    "@reactionary/core": "0.10.36",
+    "@reactionary/core": "0.10.37",
     "zod": "4.1.9",
     "@commercetools/ts-client": "^4.9.1",
     "@commercetools/platform-sdk": "^8.25.0",

package/src/capabilities/checkout.capability.d.ts

@@ -1,4 +1,4 @@
-import type { MyCartUpdateAction } from '@commercetools/platform-sdk';
+import type { Cart as CTCart, MyCartUpdateAction, ShippingMethod as CTShippingMethod, ShippingRate as CTShippingRate } from '@commercetools/platform-sdk';
 import type { Cache, CheckoutFactory, CheckoutFactoryCheckoutOutput, CheckoutFactoryPaymentMethodOutput, CheckoutFactoryShippingMethodOutput, CheckoutFactoryWithOutput, CheckoutIdentifier, CheckoutMutationAddPaymentInstruction, CheckoutMutationFinalizeCheckout, CheckoutMutationInitiateCheckout, CheckoutMutationRemovePaymentInstruction, CheckoutMutationSetShippingAddress, CheckoutMutationSetShippingInstruction, CheckoutQueryById, CheckoutQueryForAvailablePaymentMethods, CheckoutQueryForAvailableShippingMethods, NotFoundError, PaymentMethod, RequestContext, Result } from '@reactionary/core';
 import { CheckoutCapability } from '@reactionary/core';
 import type { CommercetoolsAPI } from '../core/client.js';
@@ -23,6 +23,19 @@ export declare class CommercetoolsCheckoutCapability<TFactory extends CheckoutFa
     getById(payload: CheckoutQueryById): Promise<Result<CheckoutFactoryCheckoutOutput<TFactory>, NotFoundError>>;
     setShippingAddress(payload: CheckoutMutationSetShippingAddress): Promise<Result<CheckoutFactoryCheckoutOutput<TFactory>>>;
     getAvailableShippingMethods(payload: CheckoutQueryForAvailableShippingMethods): Promise<Result<CheckoutFactoryShippingMethodOutput<TFactory>[]>>;
+    /**
+     * Quotes the matching shipping rates as free where the cart reaches the
+     * rate's free-above threshold. commercetools' matching-cart query returns
+     * the rates at their configured price and only applies the threshold once
+     * the method is set on the cart.
+     */
+    protected withFreeShipping(shippingMethod: CTShippingMethod, cart: CTCart): CTShippingMethod;
+    /**
+     * Whether commercetools charges nothing for the rate once the method is set:
+     * shipping is free if the sum of the (custom) line item prices, after line
+     * item discounts, reaches the rate's free-above threshold.
+     */
+    protected isFreeShipping(rate: CTShippingRate, cart: CTCart): boolean;
     getAvailablePaymentMethods(payload: CheckoutQueryForAvailablePaymentMethods): Promise<Result<CheckoutFactoryPaymentMethodOutput<TFactory>[]>>;
     addPaymentInstruction(payload: CheckoutMutationAddPaymentInstruction): Promise<Result<CheckoutFactoryCheckoutOutput<TFactory>>>;
     removePaymentInstruction(payload: CheckoutMutationRemovePaymentInstruction): Promise<Result<CheckoutFactoryCheckoutOutput<TFactory>>>;