squake 0.4.3 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e22e0f482c248647b17219586fe85804cf1e44a5ba84a559d5635c79c77eb7f5
-  data.tar.gz: 3fc836ae7a666ac85da41511d97f6017394910561563f1a873dadfc5dfcd945c
+  metadata.gz: 8777e0847a6851455fbf62736f46f685c18a393e33a1586f1f879ceee4fdc4ba
+  data.tar.gz: b6c5bb698721fdce1b2d51e552ac3d1c82fac4f8330098667b4f6a17f20b0bd2
 SHA512:
-  metadata.gz: ceb4f8164253c9891c7be951943d09230cd02f132f4b054aca34eaaea3fa9287802903d927c5877857c73ba1e9021137a673b5bf6c6fe34994a6a953043cc121
-  data.tar.gz: cae5cb6dfdb84d0784bd350f21569f6de04ad76ca42b21d21ac58c2b69bd9251ecbbd702160db1c44143e5660e41bac0d02412a3c0e69ebaa912687058a57b99
+  metadata.gz: 5c701fef3eb69146d564477e923f551328f6e5898161e58fc65ed659ed7e2c5796d02f432359fb19b1a7ea611524de3ff0daa7dbe891f963b6c1c70f62feffd7
+  data.tar.gz: 55f77258422c2f3fc525a63d2815fd3e68edf5480145e2629d4738489e42df9eafb43bb4f4de81c0ad8c9593482992eca2afbf039488ef225c2be2ee414a676d

data/README.md

@@ -117,6 +117,44 @@ else
 end
 ```
 
+### Get a price quote alone
+
+#### For a given carbon quantity
+
+```ruby
+Squake::Pricing.quote(
+  client: squake_client, # optional
+  carbon_quantity: 1000, # required
+  carbon_unit: 'kilogram', # optional, default: 'gram', other options: 'kilogram', 'tonne'
+  product_id: 'some_product_id', # required
+  expand: [], # optional, default: [], allowed values: 'product', 'price' to enrich the response
+)
+
+if context.success?
+  context.result # Squake::Model::Pricing
+else
+  context.errors # [Squake::Errors::APIErrorResult]
+end
+```
+
+#### For a given fixed total
+
+```ruby
+context = Squake::Pricing.quote(
+  client: squake_client, # optional
+  fixed_total: 1000, # required
+  currency: 'USD', # optional, default: 'EUR'
+  product_id: 'some_product_id', # required
+  expand: [], # optional, default: [], allowed values: 'product', 'price' to enrich the response
+)
+
+if context.success?
+  context.result # Squake::Model::Pricing
+else
+  context.errors # [Squake::Errors::APIErrorResult]
+end
+```
+
 ### Calculate emissions and include a price quote
 
 ```ruby

data/lib/squake/model/pricing.rb

@@ -49,7 +49,7 @@ module Squake
         Squake::Model::Pricing.new(
           id: response_body.fetch(:id),
           items: items,
-          carbon_quantity: response_body.fetch(:carbon_quantity).to_d,
+          carbon_quantity: BigDecimal(response_body.fetch(:carbon_quantity).to_s),
           carbon_unit: response_body.fetch(:carbon_unit),
           payment_link: response_body.fetch(:payment_link, nil),
           price: price,

data/lib/squake/pricing.rb

@@ -0,0 +1,56 @@
+# typed: strict
+# frozen_string_literal: true
+
+module Squake
+  # https://docs-v2.squake.earth/group/endpoint-pricing
+  class Pricing
+    extend T::Sig
+
+    ENDPOINT = T.let('/v2/pricing', String)
+
+    sig do
+      params(
+        product_id: String,
+        fixed_total: T.nilable(Numeric),
+        currency: String,
+        carbon_quantity: T.nilable(Numeric),
+        carbon_unit: T.nilable(String),
+        expand: T::Array[String],
+        client: Squake::Client,
+        request_id: T.nilable(String),
+      ).returns(Squake::Return[Squake::Model::Pricing])
+    end
+    def self.quote(
+      product_id:, fixed_total: nil, currency: 'EUR', carbon_quantity: nil, carbon_unit: 'gram',
+      expand: [], client: Squake::Client.new, request_id: nil
+    )
+
+      result = client.call(
+        path: ENDPOINT,
+        method: :get,
+        headers: { 'X-Request-Id' => request_id }.compact,
+        params: {
+          product: product_id,
+          fixed_total: fixed_total,
+          currency: currency,
+          carbon_quantity: carbon_quantity,
+          carbon_unit: carbon_unit,
+          expand: expand,
+        },
+      )
+
+      if result.success?
+        pricing = Squake::Model::Pricing.from_api_response(
+          T.cast(result.body, T::Hash[Symbol, T.untyped]),
+        )
+        Return.new(result: pricing)
+      else
+        error = Squake::Errors::APIErrorResult.new(
+          code: :"api_error_#{result.code}",
+          detail: result.error_message,
+        )
+        Return.new(errors: [error])
+      end
+    end
+  end
+end

data/lib/squake/util.rb

@@ -9,15 +9,22 @@ module Squake
     # parameters in a URI or as form parameters in a request body. This mainly
     # involves escaping special characters from parameter keys and values (e.g.
     # `&`).
-    sig { params(params: T::Hash[Symbol, String]).returns(String) }
+    sig { params(params: T::Hash[Symbol, T.any(String, T::Array[String])]).returns(String) }
     def self.encode_parameters(params)
-      params.map { |k, v| "#{url_encode(k.to_s)}=#{url_encode(v)}" }.join('&')
+      params.map do |k, v|
+        case v
+        when Array
+          v.map { |e| "#{url_encode(k.to_s)}[]=#{url_encode(e.to_s)}" }.join('&')
+        else
+          "#{url_encode(k.to_s)}=#{url_encode(v.to_s)}" unless v.nil?
+        end
+      end.join('&')
     end
 
     # Encodes a string in a way that makes it suitable for use in a set of
     # query parameters in a URI or in a set of form parameters in a request
     # body.
-    sig { params(key: String).returns(String) }
+    sig { params(key: T.nilable(String)).returns(String) }
     def self.url_encode(key)
       CGI.escape(key.to_s).
         # Don't use strict form encoding by changing the square bracket control

data/lib/squake/version.rb

@@ -2,5 +2,5 @@
 # frozen_string_literal: true
 
 module Squake
-  VERSION = '0.4.3'
+  VERSION = '0.5.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: squake
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 0.5.1
 platform: ruby
 authors:
 - SQUAKE
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-09-12 00:00:00.000000000 Z
+date: 2023-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: net-http
@@ -190,6 +190,7 @@ files:
 - lib/squake/model/pricing.rb
 - lib/squake/model/product.rb
 - lib/squake/model/purchase.rb
+- lib/squake/pricing.rb
 - lib/squake/products.rb
 - lib/squake/purchase.rb
 - lib/squake/response.rb
@@ -217,7 +218,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: The industry solution for sustainable travel and logistics.