feat(add-product): implement 'addProduct' method

src/index.js

@@ -5,8 +5,9 @@
  */
 
 import { _config } from '@ecomplus/utils'
+
 import addItem from './methods/add-item'
-import fixItem from './methods/fix-item'
+import addPoduct from './methods/add-product'
 
 /**
  * Vanilla JS library to handle shopping cart object on E-Com Plus stores.
@@ -65,7 +66,7 @@ export default function (storeId, storageKey = _key, localStorage = _storage) {
 
   // instance methods
   this.addItem = addItem
-  this.fixItem = fixItem
+  this.addPoduct = addPoduct
 
   if (localStorage && storageKey) {
     // try to preset cart data from storage

src/methods/add-product.js

@@ -0,0 +1,72 @@
+import { price } from '@ecomplus/utils'
+
+export default ({ addItem }, product, variationId, quantity = 1, save = true) => {
+  // parse product object to item
+  const item = !variationId || !product.variations
+    ? product
+    : product.variations.find(({ _id }) => _id === variationId)
+  item.product_id = product._id
+
+  if (variationId) {
+    // handle selected variation object
+    item.variation_id = variationId
+    item.slug = product.slug
+    if (item.picture_id && product.pictures) {
+      // variation specific picture
+      const pictures = product.pictures.filter(picture => {
+        return picture._id === item.picture_id
+      })
+      if (pictures.length) {
+        item.picture = pictures[0]
+      }
+    }
+  }
+
+  if (!item.picture && product.pictures) {
+    // use first product picture as default
+    item.picture = product.pictures[0]
+  }
+  // fallback to product min quantity (when variation has not min quantity)
+  item.quantity = item.min_quantity || product.min_quantity || quantity
+  // defaults to product price when variation has no defined price
+  item.price = price(item) || price(product)
+
+  // add to global cart and return fixed item object
+  return addItem(item)
+}
+
+/**
+ * @method
+ * @name EcomCart#addProduct
+ * @description Parse product object to item, push to cart and save.
+ *
+ * @param {object} product -
+ * [Product object]{@link https://developers.e-com.plus/docs/api/#/store/products/products}
+ * @param {string} [variationId] - ID of selected variation if any
+ * @param {number} [quantity=1] - Item quantity added
+ * @param {boolean} [save=true] - Save cart data
+ *
+ * @returns {object|null} Returns the saved item object (with `_id`) or null
+ * when new item object is invalid.
+ *
+ * @example
+
+cart.addProduct({
+  _id: '123a5432109876543210cdef',
+  sku: 's-MP_2B4',
+  commodity_type: 'physical',
+  name: 'Mens Pique Polo Shirt',
+  slug: 'mens-pique-polo-shirt',
+  available: true,
+  visible: true,
+  price: 42.9,
+  price_effective_date: {
+    end: '2018-12-01T10:00:00.612Z'
+  },
+  base_price: 60,
+  currency_id: 'BRL',
+  currency_symbol: 'R$',
+  quantity: 100
+})
+
+ */