magento 0.26.1 → 0.29.0

data/lib/magento/cart.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Magento
+  class Cart < Model
+    self.endpoint = 'carts'
+    self.primary_key = :id
+
+    #
+    # Add a coupon by code to the current cart.
+    #
+    # Example:
+    #
+    #   cart = Magento::Cart.find(1)
+    #   cart.add_coupon('COAU4HXE0I')
+    #
+    # @return Boolean: true on success, false otherwise
+    def add_coupon(coupon)
+      self.class.add_coupon(id, coupon)
+    end
+
+    #
+    # Delete cart's coupon
+    #
+    # Example:
+    #
+    #   cart = Magento::Cart.find(1)
+    #   cart.delete_coupon()
+    #
+    # @return Boolean: true on success, raise exception otherwise
+    def delete_coupon
+      self.class.delete_coupon(id)
+    end
+
+    #
+    # Place order for cart
+    #
+    # Example:
+    #
+    #   cart = Magento::Cart.find('12345')
+    #
+    #   # or use "build" to not request information from the magento API
+    #   cart = Magento::GuestCart.build({ 'cart_id' => '12345' })
+    #
+    #   cart.order(
+    #     email: 'customer@gmail.com',
+    #     payment: { method: 'cashondelivery' }
+    #   )
+    #
+    # @return String: return the order id
+    def order(email:, payment:)
+      attributes = { cartId: id, paymentMethod: payment, email: email }
+      self.class.order(attributes)
+    end
+
+    class << self
+      #
+      # Add a coupon by code to a specified cart.
+      #
+      # Example:
+      #
+      #   Magento::Cart.add_coupon(
+      #     1,
+      #     'COAU4HXE0I'
+      #   )
+      #
+      # @return Boolean: true on success, false otherwise
+      def add_coupon(id, coupon)
+        url = "#{api_resource}/#{id}/coupons/#{coupon}"
+        request.put(url, nil).parse
+      end
+
+      #
+      # Delete a coupon from a specified cart.
+      #
+      # Example:
+      #
+      #   Magento::Cart.delete_coupon(1)
+      #
+      # @return Boolean: true on success, raise exception otherwise
+      def delete_coupon(id)
+        url = "#{api_resource}/#{id}/coupons"
+        request.delete(url).parse
+      end
+
+      #
+      # Place order for cart
+      #
+      # Example:
+      #
+      #   Magento::Cart.order(
+      #     cartId: '12345',
+      #     paymentMethod: { method: 'cashondelivery' },
+      #     email: email
+      #   )
+      #
+      # @return String: return the order id
+      def order(attributes)
+        attributes.transform_keys(&:to_sym)
+        url = "#{api_resource}/#{attributes[:cartId]}/order"
+        request.put(url, attributes).parse
+      end
+    end
+  end
+end

data/lib/magento/order.rb

@@ -34,7 +34,6 @@ module Magento
       self.class.invoice(id, params)
     end
 
-    
     #
     # Create offline refund for order
     #
@@ -65,6 +64,22 @@ module Magento
       self.class.send_email(id)
     end
 
+    #
+    # Creates a comment on the given Order
+    #
+    # order = Magento::Order.find(order_id)
+    #
+    # order.add_comment(
+    #   'comment',
+    #   is_customer_notified: 0,
+    #   is_visible_on_front: 1
+    # )
+    #
+    # Return true on success
+    def add_comment(comment, comment_params = nil)
+      self.class.add_comment(id, comment, comment_params)
+    end
+
     class << self
       def update(entity_id, attributes)
         attributes[:entity_id] = entity_id
@@ -104,7 +119,6 @@ module Magento
         request.post("order/#{order_id}/invoice", invoice_params).parse
       end
 
-      
       #
       # Create offline refund for order
       #
@@ -180,6 +194,29 @@ module Magento
       def send_email(order_id)
         request.post("orders/#{order_id}/emails").parse
       end
+
+      #
+      # Creates a comment on the given Order
+      #
+      # Magento::Order.add_comment(
+      #   order_id,
+      #   'comment',
+      #   is_customer_notified: 0,
+      #   is_visible_on_front: 1
+      # )
+      #
+      # to complete [documentation](https://magento.redoc.ly/2.4.2-admin/tag/ordersidcomments#operation/salesOrderManagementV1AddCommentPost)
+      #
+      # @return {Boolean}: return true on success
+      def add_comment(order_id, comment, comment_params = nil)
+        request.post(
+          "orders/#{order_id}/comments",
+          statusHistory: {
+            comment: comment,
+            **comment_params
+          }
+        ).parse
+      end
     end
   end
 end

data/lib/magento/params/create_image.rb

@@ -5,6 +5,35 @@ require 'mini_magick'
 
 module Magento
   module Params
+
+    # Helper class to create product image params.
+    # before generating the hash, the following image treatments are performed:
+    # - resize image
+    # - remove alpha
+    # - leaves square
+    # - convert image to jpg
+    #
+    # Example:
+    #
+    #   params = Magento::Params::CreateImage.new(
+    #     title: 'Image title',
+    #     path: '/path/to/image.jpg', # or url
+    #     position: 1,
+    #     size: 'small', # options: 'large'(defaut), 'medium' and 'small',
+    #     disabled: true, # default is false,
+    #     main: true, # default is false,
+    #   ).to_h
+    #
+    #   Magento::Product.add_media('sku', params)
+    #
+    # The resize defaut confiruration is:
+    #
+    #   Magento.configure do |config|
+    #     config.product_image.small_size  = '200x200>'
+    #     config.product_image.medium_size = '400x400>'
+    #     config.product_image.large_size  = '800x800>'
+    #   end
+    #
     class CreateImage < Dry::Struct
       VARIANTS = {
         'large'  => :image,
@@ -34,6 +63,20 @@ module Magento
         }
       end
 
+      # Generates a list containing an Magento::Params::CreateImage
+      # instance for each size of the same image.
+      #
+      # Example:
+      #
+      #   params = Magento::Params::CreateImage.new(
+      #     title: 'Image title',
+      #     path: '/path/to/image.jpg', # or url
+      #     position: 1,
+      #   ).variants
+      #
+      #   params.map(&:size)
+      #   => ['large', 'medium', 'small']
+      #
       def variants
         VARIANTS.keys.map do |size|
           CreateImage.new(attributes.merge(size: size, disabled: size != 'large'))

data/lib/magento/product.rb

@@ -38,6 +38,34 @@ module Magento
       super || @custom_attributes&.any? { |a| a.attribute_code == attribute_code.to_s }
     end
 
+    # Create new gallery entry
+    # 
+    # Example:
+    #
+    #   product = Magento::Product.find('sku')
+    #
+    #   product.add_media(
+    #     media_type: 'image',
+    #     label: 'Image label',
+    #     position: 1,
+    #     content: {
+    #       base64_encoded_data: 'image-string-base64',
+    #       type: 'image/jpg',
+    #       name: 'filename.jpg'
+    #     },
+    #     types: ['image']
+    #   )
+    #
+    # Or you can use the Magento::Params::CreateImage helper class
+    #
+    #   params = Magento::Params::CreateImage.new(
+    #     title: 'Image title',
+    #     path: '/path/to/image.jpg', # or url
+    #     position: 1,
+    #   ).to_h
+    #
+    #   product.add_media(params)
+    #
     def add_media(attributes)
       self.class.add_media(sku, attributes)
     end
@@ -88,9 +116,57 @@ module Magento
       self.class.update_stock(sku, id, attributes)
     end
 
+    # Assign a product link to another product
+    #
+    #   product = Magento::Product.find('sku')
+    #
+    #   product.create_links([
+    #     {
+    #       link_type: 'upsell',
+    #       linked_product_sku: 'linked_product_sku',
+    #       linked_product_type: 'simple',
+    #       position: position,
+    #       sku: 'product-sku'
+    #     }
+    #   ])
+    #
+    def create_links(product_links)
+      self.class.create_links(sku, product_links)
+    end
+
+    def remove_link(link_type:, linked_product_sku:)
+      self.class.remove_link(sku, link_type: link_type, linked_product_sku: linked_product_sku)
+    end
+
     class << self
       alias_method :find_by_sku, :find
 
+      # Create new gallery entry
+      #
+      # Example:
+      #
+      #   Magento::Product.add_media('sku', {
+      #     media_type: 'image',
+      #     label: 'Image title',
+      #     position: 1,
+      #     content: {
+      #       base64_encoded_data: 'image-string-base64',
+      #       type: 'image/jpg',
+      #       name: 'filename.jpg'
+      #     },
+      #     types: ['image']
+      #   })
+      #
+      # Or you can use the Magento::Params::CreateImage helper class
+      #
+      #   params = Magento::Params::CreateImage.new(
+      #     title: 'Image title',
+      #     path: '/path/to/image.jpg', # or url
+      #     position: 1,
+      #   ).to_h
+      #
+      #   Magento::Product.add_media('sku', params)
+      #
       def add_media(sku, attributes)
         request.post("products/#{sku}/media", { entry: attributes }).parse
       end
@@ -134,6 +210,18 @@ module Magento
         request.put("products/#{sku}/stockItems/#{id}", stockItem: attributes).parse
       end
 
+      # Assign a product link to another product
+      #
+      #   Product.create_links('product-sku', [
+      #     {
+      #       link_type: 'upsell',
+      #       linked_product_sku: 'linked_product_sku',
+      #       linked_product_type: 'simple',
+      #       position: position,
+      #       sku: 'product-sku'
+      #     }
+      #   ])
+      #
       def create_links(sku, product_links)
         request.post("products/#{sku}/links", { items: product_links })
       end

data/lib/magento/query.rb

@@ -70,15 +70,17 @@ module Magento
       self
     end
 
-    def order(attributes)
-      if attributes.is_a?(String)
-        self.sort_orders = [{ field: verify_id(attributes), direction: :asc }]
-      elsif attributes.is_a?(Hash)
-        self.sort_orders = []
-        attributes.each do |field, direction|
-          raise "Invalid sort order direction '#{direction}'" unless %w[asc desc].include?(direction.to_s)
-
-          sort_orders << { field: verify_id(field), direction: direction }
+    def order(*attributes)
+      self.sort_orders = []
+      attributes.each do |sort_order|
+        if sort_order.is_a?(String) || sort_order.is_a?(Symbol)
+          sort_orders << { field: verify_id(sort_order), direction: :asc }
+        elsif sort_order.is_a?(Hash)
+          sort_order.each do |field, direction|
+            raise "Invalid sort order direction '#{direction}'" unless %w[asc desc].include?(direction.to_s)
+
+            sort_orders << { field: verify_id(field), direction: direction }
+          end
         end
       end
       self

data/lib/magento/request.rb

@@ -54,7 +54,12 @@ module Magento
       begin
         msg = resp.parse['message']
         errors = resp.parse['errors'] || resp.parse['parameters']
-        resp.parse['parameters'].each { |k, v| msg.sub! "%#{k}", v } if resp.parse['parameters'].is_a? Hash
+        case errors
+        when Hash
+          errors.each { |k, v| msg.sub! "%#{k}", v }
+        when Array
+          errors.each_with_index { |v, i| msg.sub! "%#{i + 1}", v.to_s }
+        end
       rescue StandardError
         msg = 'Failed access to the magento server'
         errors = []

data/lib/magento/version.rb

@@ -1,3 +1,3 @@
 module Magento
-  VERSION = '0.26.1'
+  VERSION = '0.29.0'
 end

data/lib/magento.rb

@@ -25,6 +25,7 @@ require_relative 'magento/guest_cart'
 require_relative 'magento/sales_rule'
 require_relative 'magento/inventory'
 require_relative 'magento/import'
+require_relative 'magento/cart'
 
 require_relative 'magento/params/create_custom_attribute'
 require_relative 'magento/params/create_image'

data/spec/magento/core/model_mapper_spec.rb

@@ -0,0 +1,74 @@
+RSpec.describe Magento::ModelMapper do
+  describe '.to_hash' do
+    it 'serializes object to hash' do
+      class Magento::SameClass
+        attr_accessor :name, :description, :items
+      end
+
+      object = Magento::SameClass.new
+      object.name = 'Some name'
+      object.description = 'Some description'
+      object.items = [object.dup]
+
+      expect(Magento::ModelMapper.to_hash(object)).to eql({
+        'name' => 'Some name',
+        'description' => 'Some description',
+        'items' => [{ 'name' => 'Some name', 'description' => 'Some description' }]
+      })
+    end
+  end
+
+  describe '.map_hash' do
+    it 'returns magento object from hash' do
+      class Magento::SameClass; end
+      hash = { name: 'Some name', price: 10.99 }
+
+      object = Magento::ModelMapper.map_hash(Magento::SameClass, hash)
+
+      expect(object).to be_instance_of(Magento::SameClass)
+      expect(object.name).to eql hash[:name]
+      expect(object.price).to eql hash[:price]
+    end
+  end
+
+  describe '.map_array' do
+    it 'returns magento object list from array of hash' do
+      class Magento::SameClass; end
+      array = [{ name: 'Some name', price: 10.99 }]
+
+      object = Magento::ModelMapper.map_array('same_class', array)
+
+      expect(object).to be_a(Array)
+      expect(object).to all be_instance_of(Magento::SameClass)
+    end
+  end
+
+  describe 'include ModelParser' do
+    before do
+      class Magento::SameClass
+        include Magento::ModelParser
+      end
+    end
+
+    let(:hash) { { name: 'Same name' } }
+
+    describe '.build' do
+      it 'calls Magento::ModelMapper.map_hash' do
+        expect(Magento::ModelMapper).to receive(:map_hash)
+          .with(Magento::SameClass, hash)
+
+        Magento::SameClass.build(hash)
+      end
+    end
+
+    describe '#to_h' do
+      it 'calls Magento::ModelMapper.to_hash' do
+        object = Magento::SameClass.build(hash)
+
+        expect(Magento::ModelMapper).to receive(:to_hash).with(object)
+
+        object.to_h
+      end
+    end
+  end
+end