easypost 6.2.0 → 6.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ae0d691e3f798606f4153ba71f6d148e3d12eeade8dddec8ab8b06cbd9420173
-  data.tar.gz: 92ad3799e9d50460a99844d28c456050fe58ad78d3b440520a429623adc851a5
+  metadata.gz: b5c061be62ecbd985d48cc8d63c9ee9818cdb4f8da07140f308551f9f2404d8b
+  data.tar.gz: 77edf8e77aadc515bb909267f2fbeb780eef7eaf677d4dd862f917a114af39b9
 SHA512:
-  metadata.gz: 417aea06119816b367ae0e7eeaada243b1c3a266fb784f36df681130a617bf37bfe6d80a02c0c6aa72c4b1e210f2a220ce67aec37803dc9b04735df08c073b78
-  data.tar.gz: 5f550b00033885606ac1f9438696549b40b5602368c39985dded593b666782eaaf05887cbbe3a28afe996e05163c2f30e1740825c27c14e08a1c46f591d01e2e
+  metadata.gz: 6367c6955313221a4e063dfb477153f7c906b8db94fb398608b4c017eed750db036f96300bd8f1f2c804b33660803d2f02fd3ba07ce08647d6b0d3255f8ef12f
+  data.tar.gz: 31f99fd5e0a377c5e56c155e6ab262c80d42db6d9850daeadaca96c54b561ded5a7d63c47404701a62f564b62e03aaa6c21125b7b895f0673567a77d020c76db

data/.github/workflows/ci.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        rubyversion: ['2.6', '2.7', '3.0', '3.1', '3.2']
+        rubyversion: ['2.6', '2.7', '3.0', '3.1', '3.2', '3.3']
     steps:
       - name: Checkout Repository
         uses: actions/checkout@v3
@@ -19,7 +19,7 @@ jobs:
         uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.rubyversion }}
-          rubygems: '3.0.0'
+          rubygems: '3.3.0'
           bundler-cache: true
       - name: Install Dependencies
         run: make install
@@ -39,8 +39,8 @@ jobs:
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: '3.2'
-          rubygems: '3.0.0'
+          ruby-version: '3.3'
+          rubygems: '3.3.0'
           bundler-cache: true
       - name: Install Dependencies
         run: make install
@@ -57,8 +57,8 @@ jobs:
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: '3.2'
-          rubygems: '3.0.0'
+          ruby-version: '3.3'
+          rubygems: '3.3.0'
           bundler-cache: true
       - name: Install Dependencies
         run: make install

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # CHANGELOG
 
+## v6.3.0 (2024-07-12)
+
+- Adds new `shipment.recommend_ship_date`, `smartrate.recommend_ship_date`, and `smartrate.estimate_delivery_date` functions
+- Routes `UpsAccount`, `UpsMailInnovationsAccount`, and `UpsSurepostAccount` create/update requests to the new `/ups_oauth_registrations` endpoint
+  - Starting `2024-08-05`, UPS accounts will require a new payload to register or update. See [UPS OAuth 2.0 Update](https://support.easypost.com/hc/en-us/articles/26635027512717-UPS-OAuth-2-0-Update?utm_medium=email&_hsenc=p2ANqtz-96MmFtWICOzy9sKRbbcZSiMovZSrY3MSX1_bgY9N3f9yLVfWQdLhjAGq-SmNcOnDIS6GYhZ0OApjDBrGkKyLLMx1z6_TFOVp6-wllhEFQINrkuRuc&_hsmi=313130292&utm_content=313130292&utm_source=hs_email) for more details
+
 ## v6.2.0 (2024-04-10)
 
 - Fix payment method funding and deletion failures due to undetermined payment method type

data/Makefile

@@ -24,8 +24,13 @@ docs:
 install-styleguide: | update-examples-submodule
 	sh examples/symlink_directory_files.sh examples/style_guides/ruby .
 
+## init-examples-submodule - Initialize the examples submodule
+init-examples-submodule:
+	git submodule init
+	git submodule update
+
 ## install - Install globally from source
-install: | update-examples-submodule
+install: | init-examples-submodule
 	bundle install
 
 ## lint - Lint the project

data/README.md

@@ -163,7 +163,7 @@ If you're using a custom HTTP connection, keep in mind that the `response_data`
 
 ## Documentation
 
-API documentation can be found at: <https://easypost.com/docs/api>.
+API documentation can be found at: <https://docs.easypost.com>.
 
 Library documentation can be found on the web at: <https://easypost.github.io/easypost-ruby/> or by building them locally via the `make docs` command.
 

data/VERSION

@@ -1 +1 @@
-6.2.0
+6.3.0

data/lib/easypost/client.rb

@@ -56,6 +56,7 @@ class EasyPost::Client
     EasyPost::Services::Report,
     EasyPost::Services::ScanForm,
     EasyPost::Services::Shipment,
+    EasyPost::Services::SmartRate,
     EasyPost::Services::Tracker,
     EasyPost::Services::User,
     EasyPost::Services::Webhook,

data/lib/easypost/services/carrier_account.rb

@@ -1,16 +1,20 @@
 # frozen_string_literal: true
 
 class EasyPost::Services::CarrierAccount < EasyPost::Services::Service
-  CUSTOM_WORKFLOW_CARRIER_TYPES = %w[UpsAccount FedexAccount FedexSmartpostAccount].freeze
+  CUSTOM_WORKFLOW_CARRIER_TYPES = %w[FedexAccount FedexSmartpostAccount].freeze
+  UPS_OAUTH_CARRIER_ACCOUNT_TYPES = %w[UpsAccount UpsMailInnovationsAccount UpsSurepostAccount].freeze
   MODEL_CLASS = EasyPost::Models::CarrierAccount
 
   # Create a carrier account
   def create(params = {})
-    wrapped_params = { carrier_account: params }
+    carrier_account_type = params[:type]
+    wrapped_params = { select_top_layer_key(carrier_account_type).to_sym => params }
 
     # For UPS and FedEx the endpoint is different
-    create_url = if CUSTOM_WORKFLOW_CARRIER_TYPES.include?(params[:type])
+    create_url = if CUSTOM_WORKFLOW_CARRIER_TYPES.include?(carrier_account_type)
                    'carrier_accounts/register'
+                 elsif UPS_OAUTH_CARRIER_ACCOUNT_TYPES.include?(carrier_account_type)
+                   'ups_oauth_registrations'
                  else
                    'carrier_accounts'
                  end
@@ -33,8 +37,14 @@ class EasyPost::Services::CarrierAccount < EasyPost::Services::Service
 
   # Update a carrier account
   def update(id, params = {})
-    wrapped_params = { carrier_account: params }
-    response = @client.make_request(:put, "carrier_accounts/#{id}", wrapped_params)
+    carrier_account = retrieve(id)
+    wrapped_params = { select_top_layer_key(carrier_account[:type]).to_sym => params }
+    update_url = if UPS_OAUTH_CARRIER_ACCOUNT_TYPES.include?(params[:type])
+                   'ups_oauth_registrations/'
+                 else
+                   'carrier_accounts/'
+                 end
+    response = @client.make_request(:put, "#{update_url}#{id}", wrapped_params)
 
     EasyPost::InternalUtilities::Json.convert_json_to_object(response, MODEL_CLASS)
   end
@@ -46,4 +56,15 @@ class EasyPost::Services::CarrierAccount < EasyPost::Services::Service
     # Return true if succeeds, an error will be thrown if it fails
     true
   end
+
+  private
+
+  # Select the top-layer key for the carrier account creation/update request based on the carrier type.
+  def select_top_layer_key(carrier_account_type)
+    if UPS_OAUTH_CARRIER_ACCOUNT_TYPES.include?(carrier_account_type)
+      'ups_oauth_registrations'
+    else
+      'carrier_account'
+    end
+  end
 end

data/lib/easypost/services/shipment.rb

@@ -118,4 +118,13 @@ class EasyPost::Services::Shipment < EasyPost::Services::Service
 
     EasyPost::InternalUtilities::Json.convert_json_to_object(response, MODEL_CLASS).rates
   end
+
+  # Retrieve a recommended ship date for an existing Shipment via the Precision Shipping API, based on a specific desired delivery date.
+  def recommend_ship_date(id, desired_delivery_date)
+    url = "shipments/#{id}/smartrate/precision_shipping"
+    params = { desired_delivery_date: desired_delivery_date }
+    response = @client.make_request(:get, url, params)
+
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response, MODEL_CLASS).rates
+  end
 end

data/lib/easypost/services/smart_rate.rb

@@ -0,0 +1,19 @@
+class EasyPost::Services::SmartRate < EasyPost::Services::Service
+  # Retrieve the estimated delivery date of each carrier-service level combination via the
+  # Smart Deliver By API, based on a specific ship date and origin-destination postal code pair.
+  def estimate_delivery_date(params = {})
+    url = 'smartrate/deliver_by'
+
+    response = @client.make_request(:post, url, params)
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response, EasyPost::Models::EasyPostObject)
+  end
+
+  # Retrieve a recommended ship date for each carrier-service level combination via the
+  # Smart Deliver On API, based on a specific delivery date and origin-destination postal code pair.
+  def recommend_ship_date(params = {})
+    url = 'smartrate/deliver_on'
+
+    response = @client.make_request(:post, url, params)
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response, EasyPost::Models::EasyPostObject)
+  end
+end

data/lib/easypost/services/tracker.rb

@@ -30,6 +30,7 @@ class EasyPost::Services::Tracker < EasyPost::Services::Service
   end
 
   # Create multiple Tracker objects in bulk.
+  # <b>DEPRECATED:</b> Please use <tt>create</tt> instead. This function will be removed in a future release.
   def create_list(params = {})
     wrapped_params = { 'trackers' => params }
 

data/lib/easypost/services.rb

@@ -28,6 +28,7 @@ require_relative 'services/refund'
 require_relative 'services/report'
 require_relative 'services/scan_form'
 require_relative 'services/shipment'
+require_relative 'services/smart_rate'
 require_relative 'services/tracker'
 require_relative 'services/user'
 require_relative 'services/webhook'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: easypost
 version: !ruby/object:Gem::Version
-  version: 6.2.0
+  version: 6.3.0
 platform: ruby
 authors:
 - EasyPost Developers
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-04-10 00:00:00.000000000 Z
+date: 2024-07-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: brakeman
@@ -310,6 +310,7 @@ files:
 - lib/easypost/services/report.rb
 - lib/easypost/services/scan_form.rb
 - lib/easypost/services/shipment.rb
+- lib/easypost/services/smart_rate.rb
 - lib/easypost/services/tracker.rb
 - lib/easypost/services/user.rb
 - lib/easypost/services/webhook.rb
@@ -338,7 +339,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.4
+rubygems_version: 3.5.14
 signing_key:
 specification_version: 4
 summary: EasyPost Ruby Client Library