Merge pull request #139 from zalando-incubator/revert-137-136-xuid-cart-ops

fix(Cart): degrade version, docs update

Author: ahmed-shehata

README.md

@@ -301,6 +301,9 @@ AtlasSDK instance returned from AtlasSDK configure method.
     * [.createGuestCheckout(json)](#AtlasSDKClient+createGuestCheckout) ⇒ [<code>CreateOrderRedirectResponse</code>](#CreateOrderRedirectResponse)
     * [.getCheckoutCustomer(token)](#AtlasSDKClient+getCheckoutCustomer) ⇒ [<code>CheckoutCustomer</code>](#CheckoutCustomer)
     * [.getCheckoutAddresses(token)](#AtlasSDKClient+getCheckoutAddresses) ⇒ <code>CheckoutAddress</code>
+    * [.createCheckoutCart(json, token)](#AtlasSDKClient+createCheckoutCart) ⇒ [<code>CartResponse</code>](#CartResponse)
+    * [.getCheckoutCart(cartId)](#AtlasSDKClient+getCheckoutCart) ⇒ [<code>CartResponse</code>](#CartResponse)
+    * [.putCheckoutcart(json, cartId)](#AtlasSDKClient+putCheckoutcart) ⇒ [<code>CartResponse</code>](#CartResponse)
 
 <a name="new_AtlasSDKClient_new"></a>
 
@@ -468,6 +471,44 @@ Parameters customer <strong>token</strong> needed to fetch customer object.
 | --- | --- | --- |
 | token | <code>String</code> | customer OAuth2 token |
 
+<a name="AtlasSDKClient+createCheckoutCart"></a>
+
+### atlasSDKClient.createCheckoutCart(json, token) ⇒ [<code>CartResponse</code>](#CartResponse)
+Creates Zalando customer cart
+
+**Kind**: instance method of [<code>AtlasSDKClient</code>](#AtlasSDKClient)  
+**Returns**: [<code>CartResponse</code>](#CartResponse) - - customer cart  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| json | [<code>CreateCartRequest</code>](#CreateCartRequest) | cart to create |
+| token | <code>String</code> | customer OAuth2 token |
+
+<a name="AtlasSDKClient+getCheckoutCart"></a>
+
+### atlasSDKClient.getCheckoutCart(cartId) ⇒ [<code>CartResponse</code>](#CartResponse)
+Returns a cart by id
+
+**Kind**: instance method of [<code>AtlasSDKClient</code>](#AtlasSDKClient)  
+**Returns**: [<code>CartResponse</code>](#CartResponse) - - cart  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| cartId | <code>String</code> | cart ID to get |
+
+<a name="AtlasSDKClient+putCheckoutcart"></a>
+
+### atlasSDKClient.putCheckoutcart(json, cartId) ⇒ [<code>CartResponse</code>](#CartResponse)
+Updates existing cart by id
+
+**Kind**: instance method of [<code>AtlasSDKClient</code>](#AtlasSDKClient)  
+**Returns**: [<code>CartResponse</code>](#CartResponse) - - updated cart  
+
+| Param | Type | Description |
+| --- | --- | --- |
+| json | [<code>CreateCartRequest</code>](#CreateCartRequest) | cart object to update a cart with |
+| cartId | <code>String</code> | id of the cart to be updated |
+
 <a name="PickupPoint"></a>
 
 ## PickupPoint

src/api/atlas_sdk_client.js

@@ -528,8 +528,16 @@ class AtlasSDKClient {
     return fetchEndpoint(CheckoutEndpoint).then(res => res);
   }
 
+  /**
+   * Creates Zalando customer cart
+   *
+   * @param {CreateCartRequest} json - cart to create
+   * @param {String} token - customer OAuth2 token
+   * @return {CartResponse} - customer cart
+   */
   createCheckoutCart(json, token) {
     const url = `${this.config.atlasCheckoutApi.url}/carts`;
+
     const CheckoutEndpoint = {
       url: url,
       method: 'POST',
@@ -546,8 +554,15 @@ class AtlasSDKClient {
     return fetchEndpoint(CheckoutEndpoint).then(res => res);
   }
 
+  /**
+   * Returns a cart by id
+   *
+   * @param {String} cartId - cart ID to get
+   * @return {CartResponse} - cart
+   */
   getCheckoutCart(cartId) {
     const url = `${this.config.atlasCheckoutApi.url}/carts/${cartId}`;
+
     const CheckoutEndpoint = {
       url: url,
       method: 'GET',
@@ -561,8 +576,16 @@ class AtlasSDKClient {
     return fetchEndpoint(CheckoutEndpoint).then(res => res);
   }
 
+  /**
+   * Updates existing cart by id
+   *
+   * @param {CreateCartRequest} json - cart object to update a cart with
+   * @param {String} cartId - id of the cart to be updated
+   * @return {CartResponse} - updated cart
+   */
   putCheckoutcart(json, cartId) {
     const url = `${this.config.atlasCheckoutApi.url}/carts/${cartId}`;
+
     const CheckoutEndpoint = {
       url: url,
       method: 'PUT',