@wix/auto_sdk_ecom_current-cart-v-2 1.0.15 → 1.0.17

package/build/internal/cjs/meta.d.ts

@@ -126,7 +126,7 @@ interface V2LineItem {
     /**
      * Custom extended fields for the line item object.
      *
-     * [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the app dashboard before they can be accessed with API calls.
+     * [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured using the 'Checkout & Orders - Line Items Schema Plugin' in the app dashboard before they can be accessed with API calls.
      */
     extendedFields?: ExtendedFields;
     /**
@@ -1461,16 +1461,6 @@ interface CartSummary {
     priceSummary?: PriceSummary;
     /** Payment details summarizing how the customer will pay for the order. */
     paymentSummary?: PaymentSummary;
-    /**
-     * List of errors that occurred during the calculation process.
-     * @maxSize 100
-     */
-    errors?: CalculationError[];
-    /**
-     * List of business violations raised by the Validations service plugin ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/service-plugins/validations/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/service-plugins/validations-integration-service-plugin/introduction)).
-     * @maxSize 100
-     */
-    violations?: Violation[];
     /**
      * A token representing the Cart's calculated prices.
      *
@@ -1487,6 +1477,17 @@ interface CartSummary {
      * @maxLength 1024
      */
     priceVerificationToken?: string | null;
+    /**
+     * List of errors that occurred during the calculation process, returned by Totals Calculator.
+     * TODO: Temporary field for backward compatibility; will be removed once we introduce the unified 'violations' model.
+     */
+    calculationErrors?: CalculationErrors;
+    /**
+     * List of business violations raised by the Validations service plugin ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/service-plugins/validations/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/service-plugins/validations-integration-service-plugin/introduction)).
+     * TODO: Temporary field for backward compatibility; will be removed once we introduce the unified 'violations' model.
+     * @maxSize 100
+     */
+    spiViolations?: Violation[];
 }
 interface LineItemSummary {
     /**
@@ -1731,32 +1732,149 @@ interface Charge {
     /** The billing date from which the charge starts. */
     cycleBillingDate?: Date | null;
 }
-interface CalculationError {
-    /** The calculation component that caused the error. */
-    component?: CalculationComponentWithLiterals;
-    /** Machine-readable error code. */
-    code?: ErrorCodeWithLiterals;
+interface CalculationErrors extends CalculationErrorsShippingCalculationErrorOneOf {
+    /** General shipping calculation error. */
+    generalShippingCalculationError?: Details;
+    /** Carrier errors. */
+    carrierErrors?: CarrierErrors;
+    /** Tax calculation error. */
+    taxCalculationError?: Details;
+    /** Coupon calculation error. */
+    couponCalculationError?: Details;
+    /** Gift card calculation error. */
+    giftCardCalculationError?: Details;
+    /**
+     * Order validation errors.
+     * @maxSize 100
+     */
+    orderValidationErrors?: ApplicationError[];
     /**
-     * Human-readable explanation.
-     * @maxLength 100
+     * Membership payment methods calculation errors
+     * For example, will indicate that a line item that must be paid with membership payment doesn't have one or selected memberships are invalid
      */
-    description?: string | null;
+    membershipError?: Details;
+    /** Discount Rule calculation error. */
+    discountsCalculationError?: Details;
 }
-declare enum CalculationComponent {
-    UNKNOWN_CALCULATION_COMPONENT = "UNKNOWN_CALCULATION_COMPONENT",
-    DISCOUNTS = "DISCOUNTS",
-    DELIVERY = "DELIVERY",
-    TAX = "TAX",
-    MEMBERSHIPS = "MEMBERSHIPS",
-    GIFT_CARDS = "GIFT_CARDS"
+/** @oneof */
+interface CalculationErrorsShippingCalculationErrorOneOf {
+    /** General shipping calculation error. */
+    generalShippingCalculationError?: Details;
+    /** Carrier errors. */
+    carrierErrors?: CarrierErrors;
 }
-/** @enumType */
-type CalculationComponentWithLiterals = CalculationComponent | 'UNKNOWN_CALCULATION_COMPONENT' | 'DISCOUNTS' | 'DELIVERY' | 'TAX' | 'MEMBERSHIPS' | 'GIFT_CARDS';
-declare enum ErrorCode {
-    UNKNOWN_ERROR_CODE = "UNKNOWN_ERROR_CODE"
+interface Details extends DetailsKindOneOf {
+    applicationError?: ApplicationError;
+    validationError?: ValidationError;
+    systemError?: SystemError;
+    /**
+     * deprecated in API's - to enable migration from rendering arbitrary tracing to rest response
+     * @deprecated
+     */
+    tracing?: Record<string, string>;
+}
+/** @oneof */
+interface DetailsKindOneOf {
+    applicationError?: ApplicationError;
+    validationError?: ValidationError;
+    systemError?: SystemError;
+}
+interface ApplicationError {
+    /** Error code. */
+    code?: string;
+    /** Description of the error. */
+    description?: string;
+    /** Data related to the error. */
+    data?: Record<string, any> | null;
+}
+/**
+ * example result:
+ * {
+ * "fieldViolations": [
+ * {
+ * "field": "fieldA",
+ * "description": "invalid music note. supported notes: [do,re,mi,fa,sol,la,ti]",
+ * "violatedRule": "OTHER",
+ * "ruleName": "INVALID_NOTE",
+ * "data": {
+ * "value": "FI"
+ * }
+ * },
+ * {
+ * "field": "fieldB",
+ * "description": "field value out of range. supported range: [0-20]",
+ * "violatedRule": "MAX",
+ * "data": {
+ * "threshold": 20
+ * }
+ * },
+ * {
+ * "field": "fieldC",
+ * "description": "invalid phone number. provide a valid phone number of size: [7-12], supported characters: [0-9, +, -, (, )]",
+ * "violatedRule": "FORMAT",
+ * "data": {
+ * "type": "PHONE"
+ * }
+ * }
+ * ]
+ * }
+ */
+interface ValidationError {
+    fieldViolations?: FieldViolation[];
+}
+declare enum RuleType {
+    VALIDATION = "VALIDATION",
+    OTHER = "OTHER",
+    MAX = "MAX",
+    MIN = "MIN",
+    MAX_LENGTH = "MAX_LENGTH",
+    MIN_LENGTH = "MIN_LENGTH",
+    MAX_SIZE = "MAX_SIZE",
+    MIN_SIZE = "MIN_SIZE",
+    FORMAT = "FORMAT",
+    DECIMAL_LTE = "DECIMAL_LTE",
+    DECIMAL_GTE = "DECIMAL_GTE",
+    DECIMAL_LT = "DECIMAL_LT",
+    DECIMAL_GT = "DECIMAL_GT",
+    DECIMAL_MAX_SCALE = "DECIMAL_MAX_SCALE",
+    INVALID_ENUM_VALUE = "INVALID_ENUM_VALUE",
+    REQUIRED_FIELD = "REQUIRED_FIELD",
+    FIELD_NOT_ALLOWED = "FIELD_NOT_ALLOWED",
+    ONE_OF_ALIGNMENT = "ONE_OF_ALIGNMENT",
+    EXACT_LENGTH = "EXACT_LENGTH",
+    EXACT_SIZE = "EXACT_SIZE",
+    REQUIRED_ONE_OF_FIELD = "REQUIRED_ONE_OF_FIELD"
 }
 /** @enumType */
-type ErrorCodeWithLiterals = ErrorCode | 'UNKNOWN_ERROR_CODE';
+type RuleTypeWithLiterals = RuleType | 'VALIDATION' | 'OTHER' | 'MAX' | 'MIN' | 'MAX_LENGTH' | 'MIN_LENGTH' | 'MAX_SIZE' | 'MIN_SIZE' | 'FORMAT' | 'DECIMAL_LTE' | 'DECIMAL_GTE' | 'DECIMAL_LT' | 'DECIMAL_GT' | 'DECIMAL_MAX_SCALE' | 'INVALID_ENUM_VALUE' | 'REQUIRED_FIELD' | 'FIELD_NOT_ALLOWED' | 'ONE_OF_ALIGNMENT' | 'EXACT_LENGTH' | 'EXACT_SIZE' | 'REQUIRED_ONE_OF_FIELD';
+interface FieldViolation {
+    field?: string;
+    description?: string;
+    violatedRule?: RuleTypeWithLiterals;
+    /** applicable when violated_rule=OTHER */
+    ruleName?: string | null;
+    data?: Record<string, any> | null;
+}
+interface SystemError {
+    /** Error code. */
+    errorCode?: string | null;
+}
+interface CarrierErrors {
+    /**
+     * Carrier errors.
+     * @maxSize 100
+     */
+    errors?: CarrierError[];
+}
+interface CarrierError {
+    /**
+     * Carrier ID.
+     * @format GUID
+     */
+    carrierId?: string;
+    /** Error details. */
+    error?: Details;
+}
 interface Violation {
     /** Severity of the violation. The violations are shown on the cart and checkout pages. A warning is displayed as yellow, and allows a site visitor to proceed with caution. An error is displayed as red, and doesn't allow a site visitor to proceed with the eCommerce flow. */
     severity?: SeverityWithLiterals;

package/build/internal/cjs/meta.js

@@ -184,6 +184,9 @@ function createCurrentCart(payload) {
       method: "POST",
       methodFqn: "wix.ecom.cart.v2.CurrentCartService.CreateCurrentCart",
       packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
       url: resolveWixEcomCartV2CurrentCartServiceUrl({
         protoPath: "/v2/carts/current",
         data: serializedData,
@@ -234,6 +237,9 @@ function getCurrentCart(payload) {
       method: "GET",
       methodFqn: "wix.ecom.cart.v2.CurrentCartService.GetCurrentCart",
       packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
       url: resolveWixEcomCartV2CurrentCartServiceUrl({
         protoPath: "/v2/carts/current",
         data: payload,
@@ -318,6 +324,9 @@ function updateCurrentCart(payload) {
       method: "PATCH",
       methodFqn: "wix.ecom.cart.v2.CurrentCartService.UpdateCurrentCart",
       packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
       url: resolveWixEcomCartV2CurrentCartServiceUrl({
         protoPath: "/v2/carts/current",
         data: serializedData,
@@ -368,6 +377,9 @@ function deleteCurrentCart(payload) {
       method: "DELETE",
       methodFqn: "wix.ecom.cart.v2.CurrentCartService.DeleteCurrentCart",
       packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
       url: resolveWixEcomCartV2CurrentCartServiceUrl({
         protoPath: "/v2/carts/current",
         data: payload,
@@ -386,6 +398,9 @@ function refreshCurrentCart(payload) {
       method: "POST",
       methodFqn: "wix.ecom.cart.v2.CurrentCartService.RefreshCurrentCart",
       packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
       url: resolveWixEcomCartV2CurrentCartServiceUrl({
         protoPath: "/v2/carts/current/refresh",
         data: payload,
@@ -436,6 +451,9 @@ function calculateCurrentCart(payload) {
       method: "POST",
       methodFqn: "wix.ecom.cart.v2.CurrentCartService.CalculateCurrentCart",
       packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
       url: resolveWixEcomCartV2CurrentCartServiceUrl({
         protoPath: "/v2/carts/current/calculate",
         data: payload,
@@ -513,6 +531,9 @@ function addLineItemsToCurrentCart(payload) {
       method: "POST",
       methodFqn: "wix.ecom.cart.v2.CurrentCartService.AddLineItemsToCurrentCart",
       packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
       url: resolveWixEcomCartV2CurrentCartServiceUrl({
         protoPath: "/v2/carts/current/add-line-items",
         data: serializedData,
@@ -563,6 +584,9 @@ function removeLineItemsFromCurrentCart(payload) {
       method: "POST",
       methodFqn: "wix.ecom.cart.v2.CurrentCartService.RemoveLineItemsFromCurrentCart",
       packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
       url: resolveWixEcomCartV2CurrentCartServiceUrl({
         protoPath: "/v2/carts/current/remove-line-items",
         data: payload,
@@ -613,6 +637,9 @@ function updateLineItemsInCurrentCart(payload) {
       method: "POST",
       methodFqn: "wix.ecom.cart.v2.CurrentCartService.UpdateLineItemsInCurrentCart",
       packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
       url: resolveWixEcomCartV2CurrentCartServiceUrl({
         protoPath: "/v2/carts/current/update-line-items",
         data: payload,
@@ -663,6 +690,9 @@ function addCouponToCurrentCart(payload) {
       method: "POST",
       methodFqn: "wix.ecom.cart.v2.CurrentCartService.AddCouponToCurrentCart",
       packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
       url: resolveWixEcomCartV2CurrentCartServiceUrl({
         protoPath: "/v2/carts/current/add-coupon",
         data: payload,
@@ -713,6 +743,9 @@ function removeCouponFromCurrentCart(payload) {
       method: "POST",
       methodFqn: "wix.ecom.cart.v2.CurrentCartService.RemoveCouponFromCurrentCart",
       packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
       url: resolveWixEcomCartV2CurrentCartServiceUrl({
         protoPath: "/v2/carts/current/remove-coupon",
         data: payload,
@@ -763,6 +796,9 @@ function addGiftCardToCurrentCart(payload) {
       method: "POST",
       methodFqn: "wix.ecom.cart.v2.CurrentCartService.AddGiftCardToCurrentCart",
       packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
       url: resolveWixEcomCartV2CurrentCartServiceUrl({
         protoPath: "/v2/carts/current/add-gift-card",
         data: payload,
@@ -813,6 +849,9 @@ function removeGiftCardFromCurrentCart(payload) {
       method: "POST",
       methodFqn: "wix.ecom.cart.v2.CurrentCartService.RemoveGiftCardFromCurrentCart",
       packageName: PACKAGE_NAME,
+      migrationOptions: {
+        optInTransformResponse: true
+      },
       url: resolveWixEcomCartV2CurrentCartServiceUrl({
         protoPath: "/v2/carts/current/remove-gift-card",
         data: payload,