vacuum 5.0.0 → 5.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc789e68874474859f4ca103b08ce6c56e7d714eafa76f1f2780efabc232726f
-  data.tar.gz: 48d6f52b193a912da0ed88845813d6814786ea60fc83ceff2541407c482e4097
+  metadata.gz: 0ab3db70bf188be7e645a18cd7faa49836662625763031a72e213af37b246d78
+  data.tar.gz: 1558eea1b389f27c029efba19c9dd244d8c594eb056ed944e0016e4dc362dbd8
 SHA512:
-  metadata.gz: 7a58ce7a92532ac352ebef589caf42192a958af8203fdf4eae1e0d859b317b13afc8f9b79b635645b92d4bdb756eb9f21e4505ca5c2c091ab1235b32a2dc2dec
-  data.tar.gz: 538c6c125cf2d3b22622df7ff0ac91ffa76536edcf81ab3d8849968046f016926e64da300301a53fa5757125d16d96dbb67180539b62dc3476de8a248a0efec7
+  metadata.gz: b677583ab6f8759042ce9e7805f1646e72af0b307e22b55a433c7f141b9ab4e21a17d4969a9741a503c1e5940fe6c4912abc3bf4b693538d8fa31f01874d7c20
+  data.tar.gz: 07fe15c4f43ab1735d0c6cd111cb94f6fb79a1c17ed2f33e1e94ea08e30630d78f52a50193f6945767171aede03d3be6393c3b5b7fa8d2adcf7196569f701e25

data/README.md

@@ -33,13 +33,16 @@ response.parse
 
 ### Versions and Marketplaces
 
-The `version` determines which authentication endpoint to use:
+The `version` determines which authentication endpoint to use. Versions `2.x` use Amazon Cognito; versions `3.x` use Login with Amazon (LwA).
 
 | Version | Region |
 |---------|--------|
 | `"2.1"` | North America |
 | `"2.2"` | Europe |
 | `"2.3"` | Far East |
+| `"3.1"` | North America |
+| `"3.2"` | Europe |
+| `"3.3"` | Far East |
 
 ### Operations
 

data/lib/vacuum/client.rb

@@ -7,16 +7,18 @@ module Vacuum
   #
   # Handles authentication automatically and caches access tokens.
   #
-  # @example Basic usage
+  # @example Basic usage (v2.x)
   #   client = Vacuum::Client.new(
   #     credential_id: "YOUR_CREDENTIAL_ID",
   #     credential_secret: "YOUR_CREDENTIAL_SECRET",
   #     version: "2.1"
   #   )
-  #   response = client.search_items(
-  #     marketplace: "www.amazon.com",
-  #     partner_tag: "yourtag-20",
-  #     keywords: "ruby programming"
+  #
+  # @example Basic usage (v3.x)
+  #   client = Vacuum::Client.new(
+  #     credential_id: "YOUR_CREDENTIAL_ID",
+  #     credential_secret: "YOUR_CREDENTIAL_SECRET",
+  #     version: "3.3"
   #   )
   #
   # @example With shared cache (for multi-process environments like Rails)
@@ -31,6 +33,9 @@ module Vacuum
       "2.1" => "https://creatorsapi.auth.us-east-1.amazoncognito.com/oauth2/token",
       "2.2" => "https://creatorsapi.auth.eu-south-2.amazoncognito.com/oauth2/token",
       "2.3" => "https://creatorsapi.auth.us-west-2.amazoncognito.com/oauth2/token",
+      "3.1" => "https://api.amazon.com/auth/o2/token",
+      "3.2" => "https://api.amazon.co.uk/auth/o2/token",
+      "3.3" => "https://api.amazon.co.jp/auth/o2/token",
     }.freeze
 
     API_URL = "https://creatorsapi.amazon/catalog/v1"
@@ -41,7 +46,7 @@ module Vacuum
     #
     # @param credential_id [String] Your Creators API credential ID
     # @param credential_secret [String] Your Creators API credential secret
-    # @param version [String] API version ("2.1", "2.2", or "2.3")
+    # @param version [String] API version ("2.1"-"2.3" for Cognito, "3.1"-"3.3" for LwA)
     # @param cache [#fetch] Optional cache store
     # @param http [HTTP::Client]
     def initialize(version:, credential_id:, credential_secret:, cache: nil, http: HTTP)
@@ -99,10 +104,20 @@ module Vacuum
 
     private
 
+    def v3?
+      @version.start_with?("3.")
+    end
+
     def request(operation, marketplace:, partner_tag:, **params)
+      auth_header = if v3?
+        "Bearer #{access_token}"
+      else
+        "Bearer #{access_token}, Version #{@version}"
+      end
+
       @http
         .headers(
-          "Authorization" => "Bearer #{access_token}, Version #{@version}",
+          "Authorization" => auth_header,
           "x-marketplace" => marketplace,
         )
         .post("#{API_URL}/#{operation}", json: camelize_keys(marketplace:, partner_tag:, **params))
@@ -130,16 +145,36 @@ module Vacuum
     end
 
     def fetch_token
-      response = @http
+      response = if v3?
+        fetch_token_lwa
+      else
+        fetch_token_cognito
+      end
+
+      data = response.parse
+      @token_expires_at = Time.now + TOKEN_TTL
+      @access_token = data["access_token"]
+    end
+
+    # v2.x: Cognito with Basic Auth and form-encoded body
+    def fetch_token_cognito
+      @http
         .basic_auth(user: @credential_id, pass: @credential_secret)
         .post(@auth_url, form: {
           grant_type: "client_credentials",
           scope: "creatorsapi/default",
         })
+    end
 
-      data = response.parse
-      @token_expires_at = Time.now + TOKEN_TTL
-      @access_token = data["access_token"]
+    # v3.x: Login with Amazon (LwA) with JSON body
+    def fetch_token_lwa
+      @http
+        .post(@auth_url, json: {
+          grant_type: "client_credentials",
+          client_id: @credential_id,
+          client_secret: @credential_secret,
+          scope: "creatorsapi::default",
+        })
     end
   end
 end

data/lib/vacuum/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Vacuum
-  VERSION = "5.0.0"
+  VERSION = "5.1.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vacuum
 version: !ruby/object:Gem::Version
-  version: 5.0.0
+  version: 5.1.0
 platform: ruby
 authors:
 - Hakan Ensari
@@ -56,7 +56,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Amazon Creators API in Ruby
 test_files: []