BackPort Update from Main

commerce/domain/checkout/giftcard/GiftCardAdapterDefault.cls

@@ -0,0 +1,11 @@
+/**
+ * @description Sample GiftCard Adapter Apex that calls the default implementation.
+ */
+global class GiftCardAdapterDefault extends CartExtension.GiftCardAdapter {
+
+
+    public override void applyGiftCard(CartExtension.ApplyGiftCardRequest request){
+        super.applyGiftCard(request);
+    }
+
+}

commerce/domain/checkout/giftcard/GiftCardAdapterSample.cls

@@ -0,0 +1,134 @@
+/**
+ * @description Custom Gift card adapter. This class will have operations like applyGiftCard(), redeemGiftCard(), refundGiftCard().
+ In this sample implementation of applyGiftCard, if the https service is registered , we make a call to that third party service
+ with giftCardNumber and pin passed as the input in the request. The response is expected to have appliedAmount
+ and giftCardReference. If https service is not registered then we return a hardcoded values.
+
+ ApplyGiftCardRequest : this is the input to applyGiftCard method. request will have giftCardNumber, giftCardPin
+ and amount set
+
+ ApplyGiftCardResponse : This is the output type from applyGiftCard method. Response will have giftCardReference,
+ appliedAmount, Success or Fail status set along with errorMessage in case of Fail status.
+ */
+
+global class GiftCardAdapter extends CartExtension.GiftCardAdapter{
+
+    private static String httpHost = 'https://example.com';
+    private static Boolean useHTTPService = false;
+
+    public virtual override CartExtension.ApplyGiftCardResponse applyGiftCard(CartExtension.ApplyGiftCardRequest applyRequest){
+
+        Double amount = applyRequest.getAmount();
+        String giftCardCurrency = applyRequest.getCurrencyIsoCode();
+        String giftCardCode = applyRequest.getGiftCardCode();
+        String pin = applyRequest.getPin();
+
+        CartExtension.ApplyGiftCardResponse response = null;
+
+        if(useHTTPService) {
+           response = applyGiftCardService(giftCardCode, pin, amount, giftCardCurrency);
+        } else {
+           response = applyGiftCardMockedService(giftCardCode, pin, amount, giftCardCurrency);
+        }
+
+        return response;
+
+    }
+
+    private CartExtension.ApplyGiftCardResponse applyGiftCardMockedService(String giftCardCode, String giftCardPin,
+                                                Double amount, String giftCardCurrency) {
+        CartExtension.ApplyGiftCardResponse applyResponse = new CartExtension.ApplyGiftCardResponse();
+
+        applyResponse.setGiftCardReference('123456789');
+        applyResponse.setAppliedAmount(50);
+        applyResponse.setLastFour('6789');
+        applyResponse.setStatus('Success');
+
+        return applyResponse;
+
+
+    }
+
+   private CartExtension.ApplyGiftCardResponse applyGiftCardService(String giftCardCode, String giftCardPin, Double amount) {
+
+       final Integer successfulHttpRequest = 200;
+       CartExtension.ApplyGiftCardResponse applyResponse;
+
+       Http http = new Http();
+       HttpRequest request = new HttpRequest();
+       request.setEndpoint(httpHost + '/apply-gift-card');
+       request.setMethod('POST');
+       HttpResponse response = http.send(request);
+
+
+       if (response.getStatusCode() == successfulHttpRequest) {
+           // Parse JSON response
+           String responseBody = response.getBody();
+           applyResponse = processSuccessResponseFromService(responseBody, amount);
+
+       }else{
+           // Read the error details
+           String responseBody = response.getBody();
+           applyResponse = processFailedResponseFromService(response);
+
+       }
+       return applyResponse;
+
+   }
+
+   private CartExtension.ApplyGiftCardResponse processSuccessResponseFromService(String thirdPartyResponse, Double amount) {
+      CartExtension.ApplyGiftCardResponse applyResponse = new CartExtension.ApplyGiftCardResponse();
+
+      // Parse JSON using JSON.deserialize or JSON.deserializeUntyped
+      Map<String, Object> resultMap = (Map<String, Object>) JSON.deserializeUntyped(thirdPartyResponse);
+
+      String giftCardReference = (String)resultMap.get('giftCardReference');
+
+      Double availableAmount = (Double)resultMap.get('availableAmount');
+      if(availableAmount >= amount){
+           applyResponse.setAppliedAmount(amount);
+       } else if(availableAmount < amount && availableAmount>0){
+           applyResponse.setAppliedAmount(availableAmount);
+       } else if(availableAmount == 0){
+           applyResponse.setAppliedAmount(0);
+           applyResponse.setErrorMessage('Zero balance in gift card');
+           applyResponse.setStatus('Fail');
+           applyResponse.setGiftCardReference(giftCardReference);
+           applyResponse.setLastFour(giftCardReference.substring(giftCardReference.length() - 4));
+           return applyResponse;
+
+       }
+       applyResponse.setGiftCardReference(giftCardReference);
+       applyResponse.setLastFour(giftCardReference.substring(giftCardReference.length() - 4));
+       applyResponse.setStatus('Success');
+
+       return applyResponse;
+     }
+
+   private CartExtension.ApplyGiftCardResponse processFailedResponseFromService(HttpResponse response) {
+
+       CartExtension.ApplyGiftCardResponse applyResponse = new CartExtension.ApplyGiftCardResponse();
+
+       // Read the error details
+       String responseBody = response.getBody();
+
+       System.debug('Error Status Code: ' + response.getStatusCode());
+       System.debug('Error Body: ' + responseBody);
+
+       // Optional: Parse error if response is JSON
+       if (response.getHeader('Content-Type').contains('application/json')) {
+           Map<String, Object> errorMap = (Map<String, Object>) JSON.deserializeUntyped(responseBody);
+
+           String errorMessage = (String) errorMap.get('message');
+           System.debug('Error Message: ' + errorMessage);
+           applyResponse.setStatus('Fail');
+           applyResponse.setErrorMessage(errorMessage);
+       }
+       return applyResponse;
+   }
+
+   public void shouldUseHttpService(Boolean input){
+           useHTTPService = input;
+   }
+
+}

commerce/domain/checkout/giftcard/GiftCardMockHttpResponseFail.cls

@@ -0,0 +1,17 @@
+@isTest
+global class GiftCardMockHttpResponseFail implements HttpCalloutMock {
+    // Implement this interface method
+    global HTTPResponse respond(HTTPRequest req) {
+        // Optionally, only send a mock response for a specific endpoint
+        // and method.
+        System.assertEquals('https://example.com/apply-gift-card', req.getEndpoint());
+        System.assertEquals('POST', req.getMethod());
+
+        // Create a fake response
+        HttpResponse res = new HttpResponse();
+        res.setHeader('Content-Type', 'application/json');
+        res.setBody('{"error": "Internal Server Error", "message": "Something went wrong"}');
+        res.setStatusCode(500);
+        return res;
+    }
+}

commerce/domain/checkout/giftcard/GiftCardMockHttpResponseSuccess.cls

@@ -0,0 +1,17 @@
+@isTest
+global class GiftCardMockHttpResponseSuccess implements HttpCalloutMock {
+    // Implement this interface method
+    global HTTPResponse respond(HTTPRequest req) {
+        // Optionally, only send a mock response for a specific endpoint
+        // and method.
+        System.assertEquals('https://example.com/apply-gift-card', req.getEndpoint());
+        System.assertEquals('POST', req.getMethod());
+
+        // Create a fake response
+        HttpResponse res = new HttpResponse();
+        res.setHeader('Content-Type', 'application/json');
+        res.setBody('{"giftCardReference":"111111111","availableAmount":20}');
+        res.setStatusCode(200);
+        return res;
+    }
+}

commerce/domain/checkout/giftcard/GiftcardAdapterUnitTest.cls

@@ -0,0 +1,81 @@
+@IsTest
+global class GiftcardAdapterUnitTest{
+
+    /**
+     * @description Verify that SplitShipmentService invoked the default implementation.
+     */
+    @IsTest
+    public static void applyGiftCard(){
+        CartExtension.ApplyGiftCardRequest applyRequest = new CartExtension.ApplyGiftCardRequest('123456789', '1234', 50,'USD');
+        GiftCardAdapterSample adapter = new GiftCardAdapterSample();
+
+        // Act
+        Test.startTest();
+        CartExtension.ApplyGiftCardResponse applyResponse = adapter.applyGiftCard(applyRequest);
+        Test.stopTest();
+
+
+        // Assert
+        System.assertEquals(applyResponse.getGiftCardReference, '123456789')
+        System.assertEquals(applyResponse.getStatus(), 'Success');
+        System.assertEquals(applyResponse.getAppliedAmount(), 50);
+        System.assertEquals(applyResponse.getErrorMessage(), null);
+    }
+
+    @IsTest
+    public static void applyGiftCardWithThirdPartyServiceSuccess(){
+        CartExtension.ApplyGiftCardRequest applyRequest = new CartExtension.ApplyGiftCardRequest('111111111', '1234', 50,'USD');
+        GiftCardAdapter adapter = new GiftCardAdapter();
+
+        adapter.shouldUseHttpService(true);
+
+        // Set mock callout class
+        System.Test.setMock(HttpCalloutMock.class, new GiftCardMockHttpResponseSuccess());
+        // Act
+        Test.startTest();
+        CartExtension.ApplyGiftCardResponse applyResponse = adapter.applyGiftCard(applyRequest);
+        Test.stopTest();
+
+        System.assertEquals(applyResponse.getGiftCardReference(), '111111111');
+        System.assertEquals(applyResponse.getStatus(), 'Success');
+        System.assertEquals(applyResponse.getAppliedAmount(), 20);
+        System.assertEquals(applyResponse.getLastFour(), '1111');
+
+
+    }
+
+    @IsTest
+    public static void applyGiftCardWithThirdPartyServiceFail(){
+        CartExtension.ApplyGiftCardRequest applyRequest = new CartExtension.ApplyGiftCardRequest('111111111', '1234', 50,'USD');
+        GiftCardAdapter adapter = new GiftCardAdapter();
+
+        adapter.shouldUseHttpService(true);
+
+        // Set mock callout class
+        System.Test.setMock(HttpCalloutMock.class, new GiftCardMockHttpResponseFail());
+        // Act
+        Test.startTest();
+        CartExtension.ApplyGiftCardResponse applyResponse = adapter.applyGiftCard(applyRequest);
+        Test.stopTest();
+
+        System.assertEquals(applyResponse.getStatus(), 'Fail');
+    }
+
+    @IsTest
+    public static void applyGiftCardWithDefaultImplementation(){
+        CartExtension.ApplyGiftCardRequest applyRequest = new CartExtension.ApplyGiftCardRequest('987654321', '1234', 50,'USD');
+        GiftCardAdapterDefault defaultAdapter = new GiftCardAdapterDefault();
+        try{
+            // Act
+            Test.startTest();
+            defaultAdapter.applyGiftCard(applyRequest);
+            Test.stopTest();
+
+            // If an exception was not thrown, fail the test
+            System.assert(false, 'Expected exception was not thrown');
+        }catch(CalloutException e){
+            // Assert that the exception was thrown
+            System.assert(e.getMessage().contains('Native gift card is not supported'));
+        }
+    }
+}

commerce/domain/checkout/order/createOrder/classes/CreateOrderSample.cls

@@ -13,7 +13,9 @@ public virtual class CreateOrderSample extends CartExtension.CheckoutCreateOrder
         List<OrderItem> orderItems = orderGraph.getOrderItems();        
         Decimal roundedPrice = 0.0;
         for (OrderItem orderItem : orderItems) {
-            roundedPrice += orderItem.UnitPrice.round(System.RoundingMode.CEILING);
+            if(orderItem.UnitPrice != null) {
+                roundedPrice += orderItem.UnitPrice.round(System.RoundingMode.CEILING);
+            }
         }
         order.Description += roundedPrice;
         return response;

commerce/domain/inventory/cart/calculator/classes/InventoryCartCalculatorSample.cls

@@ -0,0 +1,56 @@
+/**
+  * @description 
+  * 
+  * USE CASE
+  * 
+  * The customer was notified by the warehouse that during the inventory process, SKU_RED_SHIRT was accidentally made available. 
+  * Due to a system issue, the warehouse is currently unable to mark it as unavailable again. 
+  * Customer does NOT want to sell the SKU_RED_SHIRT in the store front
+  * 
+  * SI Solution
+  * Extended inventory calculator to show a message during checkout that SKU_RED_SHIRT that shipping migth be delay 
+  * 
+  */
+  public class InventoryCartCalculatorSample extends CartExtension.InventoryCartCalculator {
+
+
+    private static final String SKU_RED_SHIRT = 'SKU_RED_SHIRT'; 
+    private static final String SKU_RED_SHIRT_MESSAGE = 'Apologies for the inconvenience, but there is an issue with SKU_RED_SHIRT, and it is currently unavailable.'; 
+
+    public InventoryCartCalculatorSample() {
+        super();
+    }
+
+     /**
+     * @description Constructor used by unit tests only. 
+     * @param apexExecutor Executor which executes various calculators. Can be used to stub calculation results or delegate calculations to actual Calculator. See <<CartCalculateExecutorMock>>.
+     */
+    public InventoryCartCalculatorSample(CartExtension.CartCalculateExecutorMock apexExecutor) {
+        // Must call super constructor in order for provided Executor to be used for calculations
+        super(apexExecutor);
+    }
+
+    public virtual override void calculate(CartExtension.CartCalculateCalculatorRequest request) { 
+
+        CartExtension.Cart cart = request.getCart();    
+
+        super.calculate(request);
+
+        CartExtension.CartItemList cartItemCollection = cart.getCartItems();
+        Iterator<CartExtension.CartItem> cartItemCollectionIterator = cartItemCollection.iterator();
+
+        while (cartItemCollectionIterator.hasNext()) {
+            CartExtension.CartItem cartItem = cartItemCollectionIterator.next();
+
+            system.debug('CART ITEM SKU: ' + cartItem.getSku());
+            if (cartItem.getSku().equals(SKU_RED_SHIRT)) {
+                CartExtension.CartValidationOutput cvo = new CartExtension.CartValidationOutput(
+                    CartExtension.CartValidationOutputTypeEnum.INVENTORY,
+                    CartExtension.CartValidationOutputLevelEnum.ERROR, cartItem);
+                    cvo.setMessage(SKU_RED_SHIRT_MESSAGE);
+                    cart.getCartValidationOutputs().add(cvo);
+                system.debug('CART CVO: ' + cvo);
+            }
+        }
+    }
+}

commerce/domain/inventory/cart/calculator/classes/InventoryCartCalculatorSample.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>61.0</apiVersion>
+    <status>Active</status>
+</ApexClass>