feat(billing-platform): add batched ChargeService.list_charges_for_invoice_ids (REVENG-157)

proto/sentry_protos/billing/v1/services/charge/v1/endpoint_list_charges.proto

@@ -2,6 +2,8 @@ syntax = "proto3";
 
 package sentry_protos.billing.v1.services.charge.v1;
 
+import "sentry_protos/billing/v1/services/charge/v1/charge.proto";
+
 message Charge {
   uint64 amount_cents = 1;
   bool paid = 2;
@@ -17,3 +19,22 @@ message ListChargesForInvoiceRequest {
 message ListChargesForInvoiceResponse {
   repeated Charge charges = 1;
 }
+
+// Batched variant for paginated invoice surfaces. Returns
+// ``PlatformCharge`` (the canonical projection, with embedded refunds via
+// ``PlatformCharge.refunds``) for every charge tied to any of the
+// requested invoices, so callers get full per-invoice charge + refund
+// state in one round trip. Avoids the N+1 of fetching refunds or
+// charges per invoice when rendering paginated invoice lists.
+message ListChargesForInvoiceIdsRequest {
+  repeated uint64 invoice_ids = 1;
+}
+
+message ListChargesForInvoiceIdsResponse {
+  // Flat list of charges across all requested invoices, ordered by
+  // ``(invoice_id, date_added)`` ascending. Each ``PlatformCharge``
+  // carries its ``invoice_id`` and embedded ``refunds``; group by
+  // ``charge.invoice_id`` to reconstruct per-invoice state. Invoices
+  // with no charges simply don't appear.
+  repeated PlatformCharge charges = 1;
+}

rust/src/sentry_protos.billing.v1.services.charge.v1.rs

@@ -168,6 +168,27 @@ pub struct ListChargesForInvoiceResponse {
     #[prost(message, repeated, tag = "1")]
     pub charges: ::prost::alloc::vec::Vec<Charge>,
 }
+/// Batched variant for paginated invoice surfaces. Returns
+/// `PlatformCharge` (the canonical projection, with embedded refunds via
+/// `PlatformCharge.refunds`) for every charge tied to any of the
+/// requested invoices, so callers get full per-invoice charge + refund
+/// state in one round trip. Avoids the N+1 of fetching refunds or
+/// charges per invoice when rendering paginated invoice lists.
+#[derive(Clone, PartialEq, Eq, Hash, ::prost::Message)]
+pub struct ListChargesForInvoiceIdsRequest {
+    #[prost(uint64, repeated, tag = "1")]
+    pub invoice_ids: ::prost::alloc::vec::Vec<u64>,
+}
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct ListChargesForInvoiceIdsResponse {
+    /// Flat list of charges across all requested invoices, ordered by
+    /// `(invoice_id, date_added)` ascending. Each `PlatformCharge`
+    /// carries its `invoice_id` and embedded `refunds`; group by
+    /// `charge.invoice_id` to reconstruct per-invoice state. Invoices
+    /// with no charges simply don't appear.
+    #[prost(message, repeated, tag = "1")]
+    pub charges: ::prost::alloc::vec::Vec<PlatformCharge>,
+}
 /// Lists every recorded refund associated with the charges for a single
 /// platform invoice. Callers in the presentation layer use this to render
 /// invoice-level refund state without crossing the charge service boundary.