Merge pull request #326 from EasyPost/luma

feat: adds luma functions

Author: Justintime50

CHANGELOG.md

@@ -1,5 +1,12 @@
 # CHANGELOG
 
+## Next Release
+
+- Adds the following functions
+  - `shipment.create_and_buy_luma`
+  - `shipment.buy_luma`
+  - `luma.get_promise`
+
 ## v7.0.1 (2025-05-27)
 
 - Corrects the endpoint used for creating/updating UPS accounts

examples

@@ -48,6 +48,7 @@ def initialize(api_key:, read_timeout: 60, open_timeout: 30, api_base: 'https://
     EasyPost::Services::EndShipper,
     EasyPost::Services::Event,
     EasyPost::Services::Insurance,
+    EasyPost::Services::Luma,
     EasyPost::Services::Order,
     EasyPost::Services::Parcel,
     EasyPost::Services::Pickup,

lib/easypost/client.rb

@@ -20,6 +20,7 @@ module EasyPost::Services
 require_relative 'services/end_shipper'
 require_relative 'services/event'
 require_relative 'services/insurance'
+require_relative 'services/luma'
 require_relative 'services/order'
 require_relative 'services/parcel'
 require_relative 'services/pickup'

lib/easypost/services.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+class EasyPost::Services::Luma < EasyPost::Services::Service
+  # Get service recommendations from Luma that meet the criteria of your ruleset.
+  def get_promise(params = {})
+    url = 'luma/promise'
+    wrapped_params = { shipment: params }
+    response = @client.make_request(:post, url, wrapped_params)
+
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response).luma_info
+  end
+end

lib/easypost/services/luma.rb

@@ -113,18 +113,35 @@ def generate_form(id, form_type, form_options = {})
   # Retrieves the estimated delivery date of each Rate via SmartRate.
   def retrieve_estimated_delivery_date(id, planned_ship_date)
     url = "shipments/#{id}/smartrate/delivery_date"
-    params = { planned_ship_date: planned_ship_date }
-    response = @client.make_request(:get, url, params)
+    wrapped_params = { planned_ship_date: planned_ship_date }
+    response = @client.make_request(:get, url, wrapped_params)
 
     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)
+    wrapped_params = { desired_delivery_date: desired_delivery_date }
+    response = @client.make_request(:get, url, wrapped_params)
 
     EasyPost::InternalUtilities::Json.convert_json_to_object(response, MODEL_CLASS).rates
   end
+
+  # Create and buy a Luma Shipment in one call.
+  def create_and_buy_luma(params = {})
+    url = 'shipments/luma'
+    wrapped_params = { shipment: params }
+    response = @client.make_request(:post, url, wrapped_params)
+
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response, MODEL_CLASS)
+  end
+
+  # Buy a Shipment with Luma.
+  def buy_luma(id, params = {})
+    url = "shipments/#{id}/luma"
+    response = @client.make_request(:post, url, params)
+
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response, MODEL_CLASS)
+  end
 end