@wix/auto_sdk_ecom_cart-v-2 1.0.22 → 1.0.24

package/build/cjs/index.d.ts

@@ -22,13 +22,15 @@ interface Cart {
     revision?: string | null;
     /**
      * Line items added to the Cart by the customer.
-     * This list may include both valid items (in stock) and invalid ones (e.g., out of stock).
-     * When submitting an order, only valid items will be included in the order.
+     * This list may include items in stock and invalid out out stock.
      * @maxSize 300
      * @readonly
      */
     lineItems?: V2LineItem[];
-    /** The sum of all line item final prices. */
+    /**
+     * The sum of all line item final prices.
+     * @readonly
+     */
     subtotal?: ConvertedMoney;
     /**
      * Optional message left by the customer.
@@ -40,6 +42,7 @@ interface Cart {
      * List of coupons added to the Cart.
      * Currently, only one coupon code is supported.
      * @maxSize 1
+     * @readonly
      */
     coupons?: Coupon[];
     /** Information about the source of the Cart, detailing the origin or context in which the Cart was created. */
@@ -224,6 +227,7 @@ interface ConvertedMoney {
      * Default: `amount`.
      * @format DECIMAL_VALUE
      * @decimalValue options { gte:0, lte:999999999, maxScale:3 }
+     * @readonly
      */
     convertedAmount?: string;
 }
@@ -1986,7 +1990,6 @@ interface CreateCurrentCartRequest {
     /**
      * Coupons to apply.
      * Currently only one is supported.
-     * If the coupon code is invalid, the cart will be created without it.
      * @maxSize 1
      * @minLength 1
      * @maxLength 50
@@ -1995,7 +1998,6 @@ interface CreateCurrentCartRequest {
     /**
      * Gift cards to add.
      * Currently only one is support.
-     * If the gift card code is invalid, the cart will be created without it.
      * @maxSize 1
      * @minLength 8
      * @maxLength 20
@@ -2070,18 +2072,14 @@ interface CustomItemPricingInfo {
     /**
      * Sale price of a single item, without modifiers.
      * Includes tax if `tax_info.prices_include_tax` is true.
-     * @format DECIMAL_VALUE
-     * @decimalValue options { gte:0, lte:1000000000000000, maxScale:3 }
      */
-    price?: string;
+    price?: ConvertedMoney;
     /**
      * Full price of a single item before any discounts, without modifiers.
      * Defaults to `price` when not provided.
      * Includes tax if `tax_info.prices_include_tax` is true.
-     * @format DECIMAL_VALUE
-     * @decimalValue options { gte:0, lte:1000000000000000, maxScale:3 }
      */
-    fullPrice?: string | null;
+    fullPrice?: ConvertedMoney;
     /**
      * Additional description for the price.
      * For example, when price is 0 but additional details about the actual price are needed - "Starts at $67".
@@ -2197,6 +2195,12 @@ interface RefreshCurrentCartResponse {
     cart?: Cart;
 }
 interface CalculateCurrentCartRequest {
+    /**
+     * Whether to retrieve the latest item prices, discounts, and inventory data from the catalogs before calculating the cart.
+     *
+     * Default: `false`
+     */
+    refreshCart?: boolean;
     /**
      * Specifies the level of **business validation** to perform during cart calculation,
      * by calling the [Validations service plugin](https://dev.wix.com/api/rest/wix-ecommerce/validations-integration-spi/introduction).
@@ -2519,7 +2523,6 @@ interface CreateCartRequest {
     /**
      * Coupons to apply.
      * Currently only one is supported.
-     * If the coupon code is invalid, the cart will be created without it.
      * @maxSize 1
      * @minLength 1
      * @maxLength 50
@@ -2528,7 +2531,6 @@ interface CreateCartRequest {
     /**
      * Gift cards to add.
      * Currently only one is support.
-     * If the gift card code is invalid, the cart will be created without it.
      * @maxSize 1
      * @minLength 8
      * @maxLength 20
@@ -2584,6 +2586,12 @@ interface CalculateCartRequest {
      * @format GUID
      */
     cartId: string;
+    /**
+     * Whether to retrieve the latest item prices, discounts, and inventory data from the catalogs before calculating the cart.
+     *
+     * Default: `false`
+     */
+    refreshCart?: boolean;
     /**
      * Specifies the level of **business validation** to perform during cart calculation,
      * by calling the [Validations service plugin](https://dev.wix.com/api/rest/wix-ecommerce/validations-integration-spi/introduction).
@@ -2687,7 +2695,7 @@ interface PlaceOrderResponse {
      */
     paymentGatewayOrderId?: string | null;
     /** Whether an order was successfully created from this cart and the payment transaction was completed. */
-    cartCompleted?: boolean;
+    completed?: boolean;
 }
 interface AddLineItemsRequest {
     /**
@@ -2868,7 +2876,6 @@ interface CreateCartOptions {
     /**
      * Coupons to apply.
      * Currently only one is supported.
-     * If the coupon code is invalid, the cart will be created without it.
      * @maxSize 1
      * @minLength 1
      * @maxLength 50
@@ -2877,7 +2884,6 @@ interface CreateCartOptions {
     /**
      * Gift cards to add.
      * Currently only one is support.
-     * If the gift card code is invalid, the cart will be created without it.
      * @maxSize 1
      * @minLength 8
      * @maxLength 20
@@ -2908,13 +2914,15 @@ interface UpdateCart {
     revision?: string | null;
     /**
      * Line items added to the Cart by the customer.
-     * This list may include both valid items (in stock) and invalid ones (e.g., out of stock).
-     * When submitting an order, only valid items will be included in the order.
+     * This list may include items in stock and invalid out out stock.
      * @maxSize 300
      * @readonly
      */
     lineItems?: V2LineItem[];
-    /** The sum of all line item final prices. */
+    /**
+     * The sum of all line item final prices.
+     * @readonly
+     */
     subtotal?: ConvertedMoney;
     /**
      * Optional message left by the customer.
@@ -2926,6 +2934,7 @@ interface UpdateCart {
      * List of coupons added to the Cart.
      * Currently, only one coupon code is supported.
      * @maxSize 1
+     * @readonly
      */
     coupons?: Coupon[];
     /** Information about the source of the Cart, detailing the origin or context in which the Cart was created. */
@@ -2983,6 +2992,12 @@ interface UpdateCart {
     extendedFields?: ExtendedFields;
 }
 interface CalculateCartOptions {
+    /**
+     * Whether to retrieve the latest item prices, discounts, and inventory data from the catalogs before calculating the cart.
+     *
+     * Default: `false`
+     */
+    refreshCart?: boolean;
     /**
      * Specifies the level of **business validation** to perform during cart calculation,
      * by calling the [Validations service plugin](https://dev.wix.com/api/rest/wix-ecommerce/validations-integration-spi/introduction).

package/build/cjs/index.js

@@ -171,18 +171,10 @@ function createCart(payload) {
         paths: [
           { path: "cart.createdDate" },
           { path: "cart.updatedDate" },
-          {
-            path: "cart.lineItems.source.catalogOverrideFields.image.urlExpirationDate"
-          },
-          { path: "cart.lineItems.attributes.image.urlExpirationDate" },
           {
             path: "cart.lineItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
           },
           { path: "cart.lineItems.attributes.serviceProperties.scheduledDate" },
-          {
-            path: "catalogItems.catalogOverrideFields.image.urlExpirationDate"
-          },
-          { path: "customItems.attributes.image.urlExpirationDate" },
           {
             path: "customItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
           },
@@ -227,10 +219,6 @@ function createCart(payload) {
           paths: [
             { path: "cart.createdDate" },
             { path: "cart.updatedDate" },
-            {
-              path: "cart.lineItems.source.catalogOverrideFields.image.urlExpirationDate"
-            },
-            { path: "cart.lineItems.attributes.image.urlExpirationDate" },
             {
               path: "cart.lineItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
             },
@@ -280,10 +268,6 @@ function getCart(payload) {
           paths: [
             { path: "cart.createdDate" },
             { path: "cart.updatedDate" },
-            {
-              path: "cart.lineItems.source.catalogOverrideFields.image.urlExpirationDate"
-            },
-            { path: "cart.lineItems.attributes.image.urlExpirationDate" },
             {
               path: "cart.lineItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
             },
@@ -323,10 +307,6 @@ function updateCart(payload) {
         paths: [
           { path: "cart.createdDate" },
           { path: "cart.updatedDate" },
-          {
-            path: "cart.lineItems.source.catalogOverrideFields.image.urlExpirationDate"
-          },
-          { path: "cart.lineItems.attributes.image.urlExpirationDate" },
           {
             path: "cart.lineItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
           },
@@ -367,10 +347,6 @@ function updateCart(payload) {
           paths: [
             { path: "cart.createdDate" },
             { path: "cart.updatedDate" },
-            {
-              path: "cart.lineItems.source.catalogOverrideFields.image.urlExpirationDate"
-            },
-            { path: "cart.lineItems.attributes.image.urlExpirationDate" },
             {
               path: "cart.lineItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
             },
@@ -441,10 +417,6 @@ function refreshCart(payload) {
           paths: [
             { path: "cart.createdDate" },
             { path: "cart.updatedDate" },
-            {
-              path: "cart.lineItems.source.catalogOverrideFields.image.urlExpirationDate"
-            },
-            { path: "cart.lineItems.attributes.image.urlExpirationDate" },
             {
               path: "cart.lineItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
             },
@@ -494,10 +466,6 @@ function calculateCart(payload) {
           paths: [
             { path: "cart.createdDate" },
             { path: "cart.updatedDate" },
-            {
-              path: "cart.lineItems.source.catalogOverrideFields.image.urlExpirationDate"
-            },
-            { path: "cart.lineItems.attributes.image.urlExpirationDate" },
             {
               path: "cart.lineItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
             },
@@ -585,10 +553,6 @@ function addLineItems(payload) {
       {
         transformFn: import_timestamp.transformSDKTimestampToRESTTimestamp,
         paths: [
-          {
-            path: "catalogItems.catalogOverrideFields.image.urlExpirationDate"
-          },
-          { path: "customItems.attributes.image.urlExpirationDate" },
           {
             path: "customItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
           },
@@ -616,10 +580,6 @@ function addLineItems(payload) {
           paths: [
             { path: "cart.createdDate" },
             { path: "cart.updatedDate" },
-            {
-              path: "cart.lineItems.source.catalogOverrideFields.image.urlExpirationDate"
-            },
-            { path: "cart.lineItems.attributes.image.urlExpirationDate" },
             {
               path: "cart.lineItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
             },
@@ -669,10 +629,6 @@ function removeLineItems(payload) {
           paths: [
             { path: "cart.createdDate" },
             { path: "cart.updatedDate" },
-            {
-              path: "cart.lineItems.source.catalogOverrideFields.image.urlExpirationDate"
-            },
-            { path: "cart.lineItems.attributes.image.urlExpirationDate" },
             {
               path: "cart.lineItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
             },
@@ -722,10 +678,6 @@ function updateLineItems(payload) {
           paths: [
             { path: "cart.createdDate" },
             { path: "cart.updatedDate" },
-            {
-              path: "cart.lineItems.source.catalogOverrideFields.image.urlExpirationDate"
-            },
-            { path: "cart.lineItems.attributes.image.urlExpirationDate" },
             {
               path: "cart.lineItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
             },
@@ -775,10 +727,6 @@ function addCoupon(payload) {
           paths: [
             { path: "cart.createdDate" },
             { path: "cart.updatedDate" },
-            {
-              path: "cart.lineItems.source.catalogOverrideFields.image.urlExpirationDate"
-            },
-            { path: "cart.lineItems.attributes.image.urlExpirationDate" },
             {
               path: "cart.lineItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
             },
@@ -828,10 +776,6 @@ function removeCoupon(payload) {
           paths: [
             { path: "cart.createdDate" },
             { path: "cart.updatedDate" },
-            {
-              path: "cart.lineItems.source.catalogOverrideFields.image.urlExpirationDate"
-            },
-            { path: "cart.lineItems.attributes.image.urlExpirationDate" },
             {
               path: "cart.lineItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
             },
@@ -881,10 +825,6 @@ function addGiftCard(payload) {
           paths: [
             { path: "cart.createdDate" },
             { path: "cart.updatedDate" },
-            {
-              path: "cart.lineItems.source.catalogOverrideFields.image.urlExpirationDate"
-            },
-            { path: "cart.lineItems.attributes.image.urlExpirationDate" },
             {
               path: "cart.lineItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
             },
@@ -934,10 +874,6 @@ function removeGiftCard(payload) {
           paths: [
             { path: "cart.createdDate" },
             { path: "cart.updatedDate" },
-            {
-              path: "cart.lineItems.source.catalogOverrideFields.image.urlExpirationDate"
-            },
-            { path: "cart.lineItems.attributes.image.urlExpirationDate" },
             {
               path: "cart.lineItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
             },
@@ -987,10 +923,6 @@ function markCartAsCompleted(payload) {
           paths: [
             { path: "cart.createdDate" },
             { path: "cart.updatedDate" },
-            {
-              path: "cart.lineItems.source.catalogOverrideFields.image.urlExpirationDate"
-            },
-            { path: "cart.lineItems.attributes.image.urlExpirationDate" },
             {
               path: "cart.lineItems.attributes.subscriptionInfo.subscriptionSettings.startDate"
             },
@@ -1474,6 +1406,7 @@ async function calculateCart2(cartId, options) {
   const { httpClient, sideEffects } = arguments[2];
   const payload = (0, import_rename_all_nested_keys.renameKeysFromSDKRequestToRESTRequest)({
     cartId,
+    refreshCart: options?.refreshCart,
     validationsConfig: options?.validationsConfig,
     customCalculationConfig: options?.customCalculationConfig
   });
@@ -1511,6 +1444,7 @@ async function calculateCart2(cartId, options) {
         spreadPathsToArguments: {},
         explicitPathsToArguments: {
           cartId: "$[0]",
+          refreshCart: "$[1].refreshCart",
           validationsConfig: "$[1].validationsConfig",
           customCalculationConfig: "$[1].customCalculationConfig"
         },