[feat] Parameter sets, part 4 (#418)

- Add parameter sets for classes I-R (Insurance - Reports)
- Add overload methods for classes I-R to accept parameters
- Add unit tests to test method overloads
- New cassettes for new tests
- Re-record all pickup cassettes due to date change

Author: nwithan8

EasyPost.Tests/BetaFeaturesTests/ModelsTests/InsuranceTest.cs

@@ -0,0 +1,25 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using EasyPost.Models.API;
+using EasyPost.Tests._Utilities;
+using EasyPost.Tests._Utilities.Attributes;
+using EasyPost.Utilities.Internal.Attributes;
+using Xunit;
+
+namespace EasyPost.Tests.BetaFeaturesTests.ModelsTests
+{
+    public class InsuranceTests : UnitTest
+    {
+        public InsuranceTests() : base("insurance_with_parameters")
+        {
+        }
+
+        #region Tests
+
+        #region Test CRUD Operations
+
+        #endregion
+
+        #endregion
+    }
+}

EasyPost.Tests/BetaFeaturesTests/ModelsTests/OrderTest.cs

@@ -0,0 +1,74 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using EasyPost.Exceptions.General;
+using EasyPost.Models.API;
+using EasyPost.Tests._Utilities;
+using EasyPost.Tests._Utilities.Attributes;
+using EasyPost.Utilities.Internal.Attributes;
+using Xunit;
+
+namespace EasyPost.Tests.BetaFeaturesTests.ModelsTests
+{
+    public class OrderTests : UnitTest
+    {
+        public OrderTests() : base("order_with_parameters")
+        {
+        }
+
+        #region Tests
+
+        #region Test CRUD Operations
+
+        [Fact]
+        [CrudOperations.Update]
+        [Testing.Function]
+        public async Task TestBuy()
+        {
+            UseVCR("buy");
+
+            // buy with a carrier and service
+            Dictionary<string, object> orderCreateData = Fixtures.BasicOrder;
+
+            BetaFeatures.Parameters.Orders.Create orderCreateParameters = Fixtures.Parameters.Orders.Create(orderCreateData);
+
+            Order order = await Client.Order.Create(orderCreateParameters);
+
+            BetaFeatures.Parameters.Orders.Buy orderBuyParameters = new BetaFeatures.Parameters.Orders.Buy(Fixtures.Usps, Fixtures.UspsService);
+
+            order = await order.Buy(orderBuyParameters);
+
+            List<Shipment> shipments = order.Shipments;
+
+            foreach (Shipment shipment in shipments)
+            {
+                Assert.IsType<Shipment>(shipment);
+                Assert.NotNull(shipment.PostageLabel);
+            }
+
+            // buy with a rate
+            orderCreateData = Fixtures.BasicOrder;
+
+            orderCreateParameters = Fixtures.Parameters.Orders.Create(orderCreateData);
+
+            order = await Client.Order.Create(orderCreateParameters);
+
+            Rate rate = order.LowestRate();
+
+            orderBuyParameters = new BetaFeatures.Parameters.Orders.Buy(rate);
+
+            order = await order.Buy(rate);
+
+            shipments = order.Shipments;
+
+            foreach (Shipment shipment in shipments)
+            {
+                Assert.IsType<Shipment>(shipment);
+                Assert.NotNull(shipment.PostageLabel);
+            }
+        }
+
+        #endregion
+
+        #endregion
+    }
+}

EasyPost.Tests/BetaFeaturesTests/ModelsTests/PickupTest.cs

@@ -0,0 +1,56 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using EasyPost.Exceptions.General;
+using EasyPost.Models.API;
+using EasyPost.Tests._Utilities;
+using EasyPost.Tests._Utilities.Attributes;
+using EasyPost.Utilities.Internal.Attributes;
+using Xunit;
+
+namespace EasyPost.Tests.BetaFeaturesTests.ModelsTests
+{
+    public class PickupTests : UnitTest
+    {
+        public PickupTests() : base("pickup_with_parameters")
+        {
+        }
+
+        #region Tests
+
+        #region Test CRUD Operations
+
+        [Fact]
+        [CrudOperations.Update]
+        [Testing.Function]
+        public async Task TestBuy()
+        {
+            UseVCR("buy");
+
+            Dictionary<string, object> shipmentData = Fixtures.OneCallBuyShipment;
+
+            BetaFeatures.Parameters.Shipments.Create shipmentCreateParameters = Fixtures.Parameters.Shipments.Create(shipmentData);
+
+            Shipment shipment = await Client.Shipment.Create(shipmentCreateParameters);
+
+            Dictionary<string, object> pickupData = Fixtures.BasicPickup;
+            pickupData["shipment"] = shipment;
+
+            BetaFeatures.Parameters.Pickups.Create pickupCreateParameters = Fixtures.Parameters.Pickups.Create(pickupData);
+
+            Pickup pickup = await Client.Pickup.Create(pickupCreateParameters);
+
+            BetaFeatures.Parameters.Pickups.Buy pickupBuyParameters = new BetaFeatures.Parameters.Pickups.Buy(Fixtures.Usps, Fixtures.PickupService);
+
+            pickup = await pickup.Buy(pickupBuyParameters);
+
+            Assert.IsType<Pickup>(pickup);
+            Assert.StartsWith("pickup_", pickup.Id);
+            Assert.NotNull(pickup.Confirmation);
+            Assert.Equal("scheduled", pickup.Status);
+        }
+
+        #endregion
+
+        #endregion
+    }
+}

EasyPost.Tests/BetaFeaturesTests/ServicesTests/Beta/RateServiceTest.cs

@@ -0,0 +1,40 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using EasyPost.Models.API.Beta;
+using EasyPost.Tests._Utilities;
+using EasyPost.Tests._Utilities.Attributes;
+using Xunit;
+
+namespace EasyPost.Tests.BetaFeaturesTests.ServicesTests.Beta
+{
+    public class RateServiceTests : UnitTest
+    {
+        public RateServiceTests() : base("beta_rate_service_with_parameters")
+        {
+        }
+
+        #region Tests
+
+        #region Test CRUD Operations
+
+        #endregion
+
+        [Fact]
+        [Testing.Function]
+        public async Task TestGetRates()
+        {
+            UseVCR("get_rates");
+
+            Dictionary<string, object> data = Fixtures.BasicShipment;
+
+            BetaFeatures.Parameters.Beta.Rates.Retrieve parameters = Fixtures.Parameters.Rates.RetrieveBeta(data);
+
+            List<StatelessRate> rates = await Client.Beta.Rate.RetrieveStatelessRates(parameters);
+
+            Assert.NotNull(rates);
+            Assert.NotEmpty(rates);
+        }
+
+        #endregion
+    }
+}

EasyPost.Tests/BetaFeaturesTests/ServicesTests/Beta/ReferralServiceTest.cs

@@ -0,0 +1,102 @@
+using System.Threading.Tasks;
+using EasyPost.Exceptions.API;
+using EasyPost.Models.API;
+using EasyPost.Models.API.Beta;
+using EasyPost.Tests._Utilities;
+using EasyPost.Tests._Utilities.Attributes;
+using EasyPost.Utilities.Internal.Attributes;
+using Xunit;
+
+namespace EasyPost.Tests.BetaFeaturesTests.ServicesTests.Beta
+{
+    public class ReferralServiceTests : UnitTest
+    {
+        public ReferralServiceTests() : base("beta_referral_service_with_parameters", TestUtils.ApiKey.Referral)
+        {
+        }
+
+        #region Tests
+
+        #region Test CRUD Operations
+
+        [Fact]
+        [CrudOperations.Create]
+        [Testing.Function]
+        public async Task TestAddPaymentMethod()
+        {
+            UseVCR("add_payment_method");
+
+            try
+            {
+                BetaFeatures.Parameters.ReferralCustomers.AddPaymentMethod parameters = new()
+                {
+                    StripeCustomerId = "cus_123",
+                    PaymentMethodReference = "ba_123",
+                };
+
+                PaymentMethod _ = await Client.Beta.Referral.AddPaymentMethod(parameters);
+            }
+            catch (InvalidRequestError e)
+            {
+                // the data we're sending is invalid, we expect an error to be thrown
+                Assert.Equal(422, e.StatusCode);
+                Assert.Equal("BILLING.INVALID_PAYMENT_GATEWAY_REFERENCE", e.Code);
+                Assert.Equal("Invalid Payment Gateway Reference.", e.Message);
+            }
+        }
+
+        [Fact]
+        [CrudOperations.Update]
+        [Testing.Function]
+        public async Task TestRefundByAmount()
+        {
+            UseVCR("refund_by_amount");
+
+            try
+            {
+                BetaFeatures.Parameters.ReferralCustomers.RefundByAmount parameters = new()
+                {
+                    Amount = 2000,
+                };
+
+                PaymentRefund _ = await Client.Beta.Referral.RefundByAmount(parameters);
+            }
+            catch (InvalidRequestError e)
+            {
+                // the data we're sending is invalid, we expect an error to be thrown
+                Assert.Equal(422, e.StatusCode);
+                Assert.Equal("TRANSACTION.AMOUNT_INVALID", e.Code);
+                Assert.Equal("Refund amount is invalid. Please use a valid amount or escalate to finance.", e.Message);
+            }
+        }
+
+        [Fact]
+        [CrudOperations.Update]
+        [Testing.Function]
+        public async Task TestRefundByPaymentLog()
+        {
+            UseVCR("refund_by_payment_log");
+
+            try
+            {
+                BetaFeatures.Parameters.ReferralCustomers.RefundByPaymentLog parameters = new()
+                {
+                    PaymentLogId = "paylog_123",
+                };
+
+                PaymentRefund _ = await Client.Beta.Referral.RefundByPaymentLog(parameters);
+            }
+            catch (InvalidRequestError e)
+            {
+                // the data we're sending is invalid, we expect an error to be thrown
+                Assert.Equal(422, e.StatusCode);
+                Assert.Equal("TRANSACTION.DOES_NOT_EXIST", e.Code);
+                Assert.Equal("We could not find a transaction with that id.", e.Message);
+            }
+        }
+
+        #endregion
+
+        #endregion
+    }
+}

EasyPost.Tests/BetaFeaturesTests/ServicesTests/InsuranceServiceTest.cs

@@ -0,0 +1,72 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using EasyPost.Models.API;
+using EasyPost.Tests._Utilities;
+using EasyPost.Tests._Utilities.Attributes;
+using EasyPost.Utilities.Internal.Attributes;
+using Xunit;
+
+namespace EasyPost.Tests.BetaFeaturesTests.ServicesTests
+{
+    public class InsuranceServiceTests : UnitTest
+    {
+        public InsuranceServiceTests() : base("insurance_service_with_parameters")
+        {
+        }
+
+        #region Tests
+
+        #region Test CRUD Operations
+
+        [Fact]
+        [CrudOperations.Create]
+        [Testing.Function]
+        public async Task TestCreate()
+        {
+            UseVCR("create");
+
+            Dictionary<string, object> shipmentData = Fixtures.OneCallBuyShipment;
+
+            BetaFeatures.Parameters.Shipments.Create shipmentParameters = Fixtures.Parameters.Shipments.Create(shipmentData);
+
+            Shipment shipment = await Client.Shipment.Create(shipmentParameters);
+
+            Dictionary<string, object> insuranceData = Fixtures.BasicInsurance;
+            insuranceData.Add("tracking_code", shipment.TrackingCode);
+
+            BetaFeatures.Parameters.Insurance.Create insuranceParameters = Fixtures.Parameters.Insurance.Create(insuranceData);
+
+            Insurance insurance = await Client.Insurance.Create(insuranceParameters);
+
+            Assert.IsType<Insurance>(insurance);
+            Assert.StartsWith("ins_", insurance.Id);
+            Assert.Equal("100.00000", insurance.Amount);
+        }
+
+        [Fact]
+        [CrudOperations.Read]
+        [Testing.Function]
+        public async Task TestAll()
+        {
+            UseVCR("all");
+
+            Dictionary<string, object> data = new Dictionary<string, object>() { { "page_size", Fixtures.PageSize } };
+
+            BetaFeatures.Parameters.Insurance.All parameters = Fixtures.Parameters.Insurance.All(data);
+
+            InsuranceCollection insuranceCollection = await Client.Insurance.All(parameters);
+
+            List<Insurance> insurances = insuranceCollection.Insurances;
+
+            Assert.True(insurances.Count <= Fixtures.PageSize);
+            foreach (Insurance item in insurances)
+            {
+                Assert.IsType<Insurance>(item);
+            }
+        }
+
+        #endregion
+
+        #endregion
+    }
+}