peddler 3.0.0.beta1 → 3.0.0

data/lib/peddler/token.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require "http"
+
+module Peddler
+  # Requests refresh and access tokens that authorize your application to take actions on behalf of a selling partner.
+  #
+  # The refresh token allows you to generate access tokens. Access tokens expire one hour after they are issued.
+  #
+  # @see https://developer-docs.amazon.com/sp-api/docs/connecting-to-the-selling-partner-api
+  class Token
+    class Error < StandardError
+      attr_reader :cause
+
+      def initialize(msg = nil, cause = nil)
+        @cause = cause
+        super(msg)
+      end
+    end
+
+    URL = "https://api.amazon.com/auth/o2/token"
+
+    attr_reader :client_id, :client_secret, :options
+
+    class << self
+      def request(...)
+        new(...).request
+      end
+    end
+
+    def initialize(client_id: ENV["LWA_CLIENT_ID"], client_secret: ENV["LWA_CLIENT_SECRET"], **options)
+      @client_id = client_id
+      @client_secret = client_secret
+      @options = options
+    end
+
+    def request
+      response = HTTP.post(URL, form: params)
+
+      unless response.status.success?
+        message = response.parse["error_description"]
+        raise Error.new(message, response)
+      end
+
+      response
+    end
+
+    private
+
+    def params
+      {
+        grant_type: grant_type,
+        client_id: client_id,
+        client_secret: client_secret,
+      }.compact.merge(options)
+    end
+
+    def grant_type
+      return if options.key?(:grant_type)
+
+      if options.key?(:refresh_token)
+        "refresh_token"
+      elsif options.key?(:scope)
+        "client_credentials"
+      elsif options.key?(:code)
+        "authorization_code"
+      end
+    end
+  end
+end

data/lib/peddler/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Peddler
-  VERSION = "3.0.0.beta1"
+  VERSION = "3.0.0"
 end

data/lib/peddler.rb

@@ -1,54 +1,58 @@
 # frozen_string_literal: true
 
-require "peddler/access_token"
-require "peddler/api/amazon_warehousing_and_distribution_2024_05_09.rb"
-require "peddler/api/aplus_content_2020_11_01.rb"
-require "peddler/api/application_management_2023_11_30.rb"
-require "peddler/api/catalog_items_v0.rb"
-require "peddler/api/catalog_items_2020_12_01.rb"
-require "peddler/api/catalog_items_2022_04_01.rb"
-require "peddler/api/data_kiosk_2023_11_15.rb"
-require "peddler/api/easy_ship_2022_03_23.rb"
-require "peddler/api/fba_inbound_eligibility_v1.rb"
-require "peddler/api/fba_inventory_v1.rb"
-require "peddler/api/feeds_2021_06_30.rb"
-require "peddler/api/finances_v0.rb"
-require "peddler/api/fulfillment_inbound_v0.rb"
-require "peddler/api/fulfillment_inbound_2024_03_20.rb"
-require "peddler/api/fulfillment_outbound_2020_07_01.rb"
-require "peddler/api/listings_items_2020_09_01.rb"
-require "peddler/api/listings_items_2021_08_01.rb"
-require "peddler/api/listings_restrictions_2021_08_01.rb"
-require "peddler/api/merchant_fulfillment_v0.rb"
-require "peddler/api/messaging_v1.rb"
-require "peddler/api/notifications_v1.rb"
-require "peddler/api/orders_v0.rb"
-require "peddler/api/product_fees_v0.rb"
-require "peddler/api/product_pricing_v0.rb"
-require "peddler/api/product_pricing_2022_05_01.rb"
-require "peddler/api/product_type_definitions_2020_09_01.rb"
-require "peddler/api/replenishment_2022_11_07.rb"
-require "peddler/api/reports_2021_06_30.rb"
-require "peddler/api/sales_v1.rb"
-require "peddler/api/sellers_v1.rb"
-require "peddler/api/services_v1.rb"
-require "peddler/api/shipment_invoicing_v0.rb"
-require "peddler/api/shipping_v1.rb"
-require "peddler/api/shipping_v2.rb"
-require "peddler/api/solicitations_v1.rb"
-require "peddler/api/supply_sources_2020_07_01.rb"
-require "peddler/api/tokens_2021_03_01.rb"
-require "peddler/api/uploads_2020_11_01.rb"
-require "peddler/api/vendor_direct_fulfillment_inventory_v1.rb"
-require "peddler/api/vendor_direct_fulfillment_orders_v1.rb"
-require "peddler/api/vendor_direct_fulfillment_orders_2021_12_28.rb"
-require "peddler/api/vendor_direct_fulfillment_payments_v1.rb"
-require "peddler/api/vendor_direct_fulfillment_sandbox_test_data_2021_10_28.rb"
-require "peddler/api/vendor_direct_fulfillment_shipping_v1.rb"
-require "peddler/api/vendor_direct_fulfillment_shipping_2021_12_28.rb"
-require "peddler/api/vendor_direct_fulfillment_transactions_v1.rb"
-require "peddler/api/vendor_direct_fulfillment_transactions_2021_12_28.rb"
-require "peddler/api/vendor_invoices_v1.rb"
-require "peddler/api/vendor_orders_v1.rb"
-require "peddler/api/vendor_shipments_v1.rb"
-require "peddler/api/vendor_transaction_status_v1.rb"
+require "peddler/api/amazon_warehousing_and_distribution_2024_05_09"
+require "peddler/api/aplus_content_2020_11_01"
+require "peddler/api/application_integrations_2024_04_01"
+require "peddler/api/application_management_2023_11_30"
+require "peddler/api/catalog_items_2020_12_01"
+require "peddler/api/catalog_items_2022_04_01"
+require "peddler/api/catalog_items_v0"
+require "peddler/api/data_kiosk_2023_11_15"
+require "peddler/api/easy_ship_2022_03_23"
+require "peddler/api/fba_inbound_eligibility_v1"
+require "peddler/api/fba_inventory_v1"
+require "peddler/api/feeds_2021_06_30"
+require "peddler/api/finances_2024_06_19"
+require "peddler/api/finances_v0"
+require "peddler/api/fulfillment_inbound_2024_03_20"
+require "peddler/api/fulfillment_inbound_v0"
+require "peddler/api/fulfillment_outbound_2020_07_01"
+require "peddler/api/invoices_2024_06_19"
+require "peddler/api/listings_items_2020_09_01"
+require "peddler/api/listings_items_2021_08_01"
+require "peddler/api/listings_restrictions_2021_08_01"
+require "peddler/api/merchant_fulfillment_v0"
+require "peddler/api/messaging_v1"
+require "peddler/api/notifications_v1"
+require "peddler/api/orders_v0"
+require "peddler/api/product_fees_v0"
+require "peddler/api/product_pricing_2022_05_01"
+require "peddler/api/product_pricing_v0"
+require "peddler/api/product_type_definitions_2020_09_01"
+require "peddler/api/replenishment_2022_11_07"
+require "peddler/api/reports_2021_06_30"
+require "peddler/api/sales_v1"
+require "peddler/api/sellers_v1"
+require "peddler/api/services_v1"
+require "peddler/api/shipment_invoicing_v0"
+require "peddler/api/shipping_v1"
+require "peddler/api/shipping_v2"
+require "peddler/api/solicitations_v1"
+require "peddler/api/supply_sources_2020_07_01"
+require "peddler/api/tokens_2021_03_01"
+require "peddler/api/uploads_2020_11_01"
+require "peddler/api/vendor_direct_fulfillment_inventory_v1"
+require "peddler/api/vendor_direct_fulfillment_orders_2021_12_28"
+require "peddler/api/vendor_direct_fulfillment_orders_v1"
+require "peddler/api/vendor_direct_fulfillment_payments_v1"
+require "peddler/api/vendor_direct_fulfillment_sandbox_test_data_2021_10_28"
+require "peddler/api/vendor_direct_fulfillment_shipping_2021_12_28"
+require "peddler/api/vendor_direct_fulfillment_shipping_v1"
+require "peddler/api/vendor_direct_fulfillment_transactions_2021_12_28"
+require "peddler/api/vendor_direct_fulfillment_transactions_v1"
+require "peddler/api/vendor_invoices_v1"
+require "peddler/api/vendor_orders_v1"
+require "peddler/api/vendor_shipments_v1"
+require "peddler/api/vendor_transaction_status_v1"
+require "peddler/marketplace"
+require "peddler/token"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: peddler
 version: !ruby/object:Gem::Version
-  version: 3.0.0.beta1
+  version: 3.0.0
 platform: ruby
 authors:
 - Hakan Ensari
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-15 00:00:00.000000000 Z
+date: 2024-10-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http
@@ -40,10 +40,10 @@ files:
 - LICENSE
 - README.md
 - lib/peddler.rb
-- lib/peddler/access_token.rb
 - lib/peddler/api.rb
 - lib/peddler/api/amazon_warehousing_and_distribution_2024_05_09.rb
 - lib/peddler/api/aplus_content_2020_11_01.rb
+- lib/peddler/api/application_integrations_2024_04_01.rb
 - lib/peddler/api/application_management_2023_11_30.rb
 - lib/peddler/api/catalog_items_2020_12_01.rb
 - lib/peddler/api/catalog_items_2022_04_01.rb
@@ -53,10 +53,12 @@ files:
 - lib/peddler/api/fba_inbound_eligibility_v1.rb
 - lib/peddler/api/fba_inventory_v1.rb
 - lib/peddler/api/feeds_2021_06_30.rb
+- lib/peddler/api/finances_2024_06_19.rb
 - lib/peddler/api/finances_v0.rb
 - lib/peddler/api/fulfillment_inbound_2024_03_20.rb
 - lib/peddler/api/fulfillment_inbound_v0.rb
 - lib/peddler/api/fulfillment_outbound_2020_07_01.rb
+- lib/peddler/api/invoices_2024_06_19.rb
 - lib/peddler/api/listings_items_2020_09_01.rb
 - lib/peddler/api/listings_items_2021_08_01.rb
 - lib/peddler/api/listings_restrictions_2021_08_01.rb
@@ -93,10 +95,12 @@ files:
 - lib/peddler/api/vendor_orders_v1.rb
 - lib/peddler/api/vendor_shipments_v1.rb
 - lib/peddler/api/vendor_transaction_status_v1.rb
+- lib/peddler/endpoint.rb
 - lib/peddler/error.rb
-- lib/peddler/region.rb
+- lib/peddler/marketplace.rb
+- lib/peddler/token.rb
 - lib/peddler/version.rb
-homepage: https://github.com/hakanensari/peddler
+homepage: https://github.com/lineofflight/peddler
 licenses:
 - MIT
 metadata:
@@ -119,5 +123,5 @@ requirements: []
 rubygems_version: 3.5.16
 signing_key:
 specification_version: 4
-summary: The Amazon Selling Partner API (SP-API) in Ruby
+summary: Amazon Selling Partner API (SP-API) in Ruby
 test_files: []

data/lib/peddler/access_token.rb

@@ -1,76 +0,0 @@
-# frozen_string_literal: true
-
-require "http"
-
-module Peddler
-  # Requests a Login with Amazon (LWA) access token that authorizes your application to take actions on behalf of a
-  # selling partner. An LWA access token expires one hour after it is issued.
-  #
-  # @see https://developer-docs.amazon.com/sp-api/docs/connecting-to-the-selling-partner-api
-  class AccessToken
-    URL = "https://api.amazon.com/auth/o2/token"
-
-    attr_reader :client_id, :client_secret, :refresh_token, :scope
-
-    class << self
-      # Requests an access token
-      #
-      # @param client_id [String]
-      # @param client_secret [String]
-      # @param refresh_token [String]
-      # @param scope [String]
-      def request(client_id: ENV["LWA_CLIENT_ID"], client_secret: ENV["LWA_CLIENT_SECRET"], refresh_token: nil,
-        scope: nil)
-        new(client_id: client_id, client_secret: client_secret, refresh_token: refresh_token, scope: scope).request
-      end
-    end
-
-    # @param client_id [String]
-    # @param client_secret [String]
-    # @param refresh_token [String]
-    # @param scope [String]
-    def initialize(client_id: ENV["LWA_CLIENT_ID"], client_secret: ENV["LWA_CLIENT_SECRET"], refresh_token: nil,
-      scope: nil)
-      @client_id = client_id
-      @client_secret = client_secret
-      @refresh_token = refresh_token
-      @scope = scope
-
-      validate_lwa_credentials!
-      validate_exclusive_token_or_scope!
-    end
-
-    def request
-      response = HTTP.post(URL, form: params)
-      response.parse.fetch("access_token")
-    end
-
-    private
-
-    def validate_lwa_credentials!
-      if client_id.nil? || client_secret.nil?
-        raise ArgumentError, "Provide client_id and client_secret."
-      end
-    end
-
-    def validate_exclusive_token_or_scope!
-      if @refresh_token.nil? == @scope.nil?
-        raise ArgumentError, "Provide either refresh_token or scope, not both."
-      end
-    end
-
-    def params
-      {
-        grant_type: grant_type,
-        refresh_token: refresh_token,
-        scope: scope,
-        client_id: client_id,
-        client_secret: client_secret,
-      }.compact
-    end
-
-    def grant_type
-      scope ? "client_credentials" : "refresh_token"
-    end
-  end
-end

data/lib/peddler/region.rb

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-require "uri"
-
-module Peddler
-  class Region
-    class UnknownRegion < ArgumentError; end
-
-    # @see https://developer-docs.amazon.com/sp-api/docs/sp-api-endpoints
-    ENDPOINTS = {
-      "us-east-1" => "https://sellingpartnerapi-na.amazon.com",
-      "us-west-2" => "https://sellingpartnerapi-fe.amazon.com",
-      "eu-west-1" => "https://sellingpartnerapi-eu.amazon.com",
-    }
-
-    attr_reader :name
-
-    # @param [String] name
-    def initialize(name)
-      @name = name
-    end
-
-    # @return [String]
-    def endpoint
-      ENDPOINTS.fetch(name) do
-        raise UnknownRegion, "#{name} not found"
-      end
-    end
-  end
-end