[AC-2567] Billing Performance Improvements (#4143)

* Moved AccountsBilling controller to be owned by Billing

* Added org billing history endpoint

* Updated GetBillingInvoicesAsync to only retrieve paid, open, and uncollectible invoices, and added option to limit results

* Removed invoices and transactions from GetBillingAsync

* Limiting the number of invoices and transactions returned

* Moved Billing models to Billing namespace

* Split billing info and billing history objects

* Removed billing method GetBillingBalanceAndSourceAsync

* Removed unused using

* Cleaned up BillingInfo a bit

* Update migration scripts to use `CREATE OR ALTER` instead of checking for the `OBJECT_ID`

* Applying limit to aggregated invoices after they return from Stripe

src/Api/Billing/Controllers/AccountsBillingController.cs

@@ -0,0 +1,42 @@
+using Bit.Api.Billing.Models.Responses;
+using Bit.Core.Services;
+using Bit.Core.Utilities;
+using Microsoft.AspNetCore.Authorization;
+using Microsoft.AspNetCore.Mvc;
+
+namespace Bit.Api.Billing.Controllers;
+
+[Route("accounts/billing")]
+[Authorize("Application")]
+public class AccountsBillingController(
+    IPaymentService paymentService,
+    IUserService userService) : Controller
+{
+    [HttpGet("history")]
+    [SelfHosted(NotSelfHostedOnly = true)]
+    public async Task<BillingHistoryResponseModel> GetBillingHistoryAsync()
+    {
+        var user = await userService.GetUserByPrincipalAsync(User);
+        if (user == null)
+        {
+            throw new UnauthorizedAccessException();
+        }
+
+        var billingInfo = await paymentService.GetBillingHistoryAsync(user);
+        return new BillingHistoryResponseModel(billingInfo);
+    }
+
+    [HttpGet("payment-method")]
+    [SelfHosted(NotSelfHostedOnly = true)]
+    public async Task<BillingPaymentResponseModel> GetPaymentMethodAsync()
+    {
+        var user = await userService.GetUserByPrincipalAsync(User);
+        if (user == null)
+        {
+            throw new UnauthorizedAccessException();
+        }
+
+        var billingInfo = await paymentService.GetBillingAsync(user);
+        return new BillingPaymentResponseModel(billingInfo);
+    }
+}

src/Api/Billing/Controllers/OrganizationBillingController.cs

@@ -1,5 +1,4 @@
 using Bit.Api.Billing.Models.Responses;
-using Bit.Api.Models.Response;
 using Bit.Core.Billing.Services;
 using Bit.Core.Context;
 using Bit.Core.Repositories;
@@ -33,6 +32,21 @@ public class OrganizationBillingController(
         return TypedResults.Ok(response);
     }
 
+    [HttpGet("history")]
+    public async Task<IResult> GetHistoryAsync([FromRoute] Guid organizationId)
+    {
+        var organization = await organizationRepository.GetByIdAsync(organizationId);
+
+        if (organization == null)
+        {
+            return TypedResults.NotFound();
+        }
+
+        var billingInfo = await paymentService.GetBillingHistoryAsync(organization);
+
+        return TypedResults.Ok(billingInfo);
+    }
+
     [HttpGet]
     [SelfHosted(NotSelfHostedOnly = true)]
     public async Task<IResult> GetBillingAsync(Guid organizationId)

src/Api/Billing/Controllers/OrganizationsController.cs

@@ -45,7 +45,7 @@ public class OrganizationsController(
     ISubscriberService subscriberService)
     : Controller
 {
-    [HttpGet("{id}/billing-status")]
+    [HttpGet("{id:guid}/billing-status")]
     public async Task<OrganizationBillingStatusResponseModel> GetBillingStatus(Guid id)
     {
         if (!await currentContext.EditPaymentMethods(id))

src/Api/Billing/Models/Responses/BillingHistoryResponseModel.cs

@@ -0,0 +1,61 @@
+using Bit.Core.Billing.Models;
+using Bit.Core.Enums;
+using Bit.Core.Models.Api;
+
+namespace Bit.Api.Billing.Models.Responses;
+
+public class BillingHistoryResponseModel : ResponseModel
+{
+    public BillingHistoryResponseModel(BillingHistoryInfo billing)
+        : base("billingHistory")
+    {
+        Transactions = billing.Transactions?.Select(t => new BillingTransaction(t));
+        Invoices = billing.Invoices?.Select(i => new BillingInvoice(i));
+    }
+    public IEnumerable<BillingInvoice> Invoices { get; set; }
+    public IEnumerable<BillingTransaction> Transactions { get; set; }
+}
+
+public class BillingInvoice
+{
+    public BillingInvoice(BillingHistoryInfo.BillingInvoice inv)
+    {
+        Amount = inv.Amount;
+        Date = inv.Date;
+        Url = inv.Url;
+        PdfUrl = inv.PdfUrl;
+        Number = inv.Number;
+        Paid = inv.Paid;
+    }
+
+    public decimal Amount { get; set; }
+    public DateTime? Date { get; set; }
+    public string Url { get; set; }
+    public string PdfUrl { get; set; }
+    public string Number { get; set; }
+    public bool Paid { get; set; }
+}
+
+public class BillingTransaction
+{
+    public BillingTransaction(BillingHistoryInfo.BillingTransaction transaction)
+    {
+        CreatedDate = transaction.CreatedDate;
+        Amount = transaction.Amount;
+        Refunded = transaction.Refunded;
+        RefundedAmount = transaction.RefundedAmount;
+        PartiallyRefunded = transaction.PartiallyRefunded;
+        Type = transaction.Type;
+        PaymentMethodType = transaction.PaymentMethodType;
+        Details = transaction.Details;
+    }
+
+    public DateTime CreatedDate { get; set; }
+    public decimal Amount { get; set; }
+    public bool? Refunded { get; set; }
+    public bool? PartiallyRefunded { get; set; }
+    public decimal? RefundedAmount { get; set; }
+    public TransactionType Type { get; set; }
+    public PaymentMethodType? PaymentMethodType { get; set; }
+    public string Details { get; set; }
+}

src/Api/Billing/Models/Responses/BillingPaymentResponseModel.cs

@@ -0,0 +1,17 @@
+using Bit.Core.Billing.Models;
+using Bit.Core.Models.Api;
+
+namespace Bit.Api.Billing.Models.Responses;
+
+public class BillingPaymentResponseModel : ResponseModel
+{
+    public BillingPaymentResponseModel(BillingInfo billing)
+        : base("billingPayment")
+    {
+        Balance = billing.Balance;
+        PaymentSource = billing.PaymentSource != null ? new BillingSource(billing.PaymentSource) : null;
+    }
+
+    public decimal Balance { get; set; }
+    public BillingSource PaymentSource { get; set; }
+}

src/Api/Billing/Models/Responses/BillingResponseModel.cs

@@ -0,0 +1,34 @@
+using Bit.Core.Billing.Models;
+using Bit.Core.Enums;
+using Bit.Core.Models.Api;
+
+namespace Bit.Api.Billing.Models.Responses;
+
+public class BillingResponseModel : ResponseModel
+{
+    public BillingResponseModel(BillingInfo billing)
+        : base("billing")
+    {
+        Balance = billing.Balance;
+        PaymentSource = billing.PaymentSource != null ? new BillingSource(billing.PaymentSource) : null;
+    }
+
+    public decimal Balance { get; set; }
+    public BillingSource PaymentSource { get; set; }
+}
+
+public class BillingSource
+{
+    public BillingSource(BillingInfo.BillingSource source)
+    {
+        Type = source.Type;
+        CardBrand = source.CardBrand;
+        Description = source.Description;
+        NeedsVerification = source.NeedsVerification;
+    }
+
+    public PaymentMethodType Type { get; set; }
+    public string CardBrand { get; set; }
+    public string Description { get; set; }
+    public bool NeedsVerification { get; set; }
+}