feat(billing-platform): Add daily usage breakdown endpoint protos

proto/sentry_protos/billing/v1/services/usage_pricer/v1/endpoint_get_daily_breakdown.proto

@@ -0,0 +1,54 @@
+syntax = "proto3";
+
+package sentry_protos.billing.v1.services.usage_pricer.v1;
+
+import "sentry_protos/billing/v1/date.proto";
+import "sentry_protos/billing/v1/usage_data.proto";
+
+// Compiles per-day, per-line-item usage breakdowns spanning one or more
+// contracts. UsagePricer evaluates each contract's package
+// ``BillableMetric.expression`` once per outcome field of the raw
+// usage, so callers receive the package-projected ``UsageData`` view
+// rather than the raw outcomes returned by ``BillingUsageService``.
+//
+// This is the "non-pricing" derived view UsagePricer exposes -- the
+// projection step pricing already performs internally, lifted out so
+// other presentation services (e.g. ChargeService for CSV / UI) can
+// consume it without re-implementing evaluation.
+message GetDailyBreakdownRequest {
+  // The contracts whose daily breakdowns should be returned.
+  repeated string contract_ids = 1;
+}
+
+// One line item's projected per-outcome quantities on a given date.
+message LineItemDailyOutcomes {
+  // Package line item uid (UsagePricer's native vocabulary).
+  string line_item_uid = 1;
+
+  // The seven outcome fields, each populated by evaluating the line
+  // item's ``BillableMetric.expression`` against that outcome's raw
+  // counts in the day's usage.
+  sentry_protos.billing.v1.UsageData outcomes = 2;
+}
+
+// One row per calendar date spanning the union of the requested
+// contracts' on-demand periods.
+message DailyLineItemOutcomes {
+  sentry_protos.billing.v1.Date date = 1;
+
+  // Per-line-item outcomes on this date. Every metered line item from
+  // the union of the requested contracts' packages is emitted,
+  // including line items with zero usage, so consumers can render
+  // zero-rows without a separate zero-fill pass.
+  repeated LineItemDailyOutcomes line_items = 2;
+}
+
+message GetDailyBreakdownResponse {
+  // Days in ascending date order. A given calendar date appears at
+  // most once regardless of how many of the requested contracts
+  // overlap it (BillingUsageService reports usage at calendar-day
+  // granularity, so a day straddling a mid-day rollover is still one
+  // row carrying the day's full outcomes). Contract ids from the
+  // request that do not resolve contribute no rows.
+  repeated DailyLineItemOutcomes days = 1;
+}

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

@@ -50,6 +50,11 @@ pub struct BillingConfig {
     /// (1 = monthly, 12 = annual). Frozen for the life of the contract.
     #[prost(uint32, tag = "7")]
     pub month_interval: u32,
+    /// Whether the org is allowed to incur pay-as-you-go usage.
+    /// Credit-card orgs always support payg; invoiced orgs that should
+    /// support it are an explicit override.
+    #[prost(bool, tag = "8")]
+    pub supports_payg: bool,
 }
 /// Indicates how the account is billed.
 #[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, PartialOrd, Ord, ::prost::Enumeration)]

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

@@ -1,4 +1,56 @@
 // This file is @generated by prost-build.
+/// Compiles per-day, per-line-item usage breakdowns spanning one or more
+/// contracts. UsagePricer evaluates each contract's package
+/// `BillableMetric.expression` once per outcome field of the raw
+/// usage, so callers receive the package-projected `UsageData` view
+/// rather than the raw outcomes returned by `BillingUsageService`.
+///
+/// This is the "non-pricing" derived view UsagePricer exposes -- the
+/// projection step pricing already performs internally, lifted out so
+/// other presentation services (e.g. ChargeService for CSV / UI) can
+/// consume it without re-implementing evaluation.
+#[derive(Clone, PartialEq, Eq, Hash, ::prost::Message)]
+pub struct GetDailyBreakdownRequest {
+    /// The contracts whose daily breakdowns should be returned.
+    #[prost(string, repeated, tag = "1")]
+    pub contract_ids: ::prost::alloc::vec::Vec<::prost::alloc::string::String>,
+}
+/// One line item's projected per-outcome quantities on a given date.
+#[derive(Clone, PartialEq, Eq, Hash, ::prost::Message)]
+pub struct LineItemDailyOutcomes {
+    /// Package line item uid (UsagePricer's native vocabulary).
+    #[prost(string, tag = "1")]
+    pub line_item_uid: ::prost::alloc::string::String,
+    /// The seven outcome fields, each populated by evaluating the line
+    /// item's `BillableMetric.expression` against that outcome's raw
+    /// counts in the day's usage.
+    #[prost(message, optional, tag = "2")]
+    pub outcomes: ::core::option::Option<super::super::super::UsageData>,
+}
+/// One row per calendar date spanning the union of the requested
+/// contracts' on-demand periods.
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct DailyLineItemOutcomes {
+    #[prost(message, optional, tag = "1")]
+    pub date: ::core::option::Option<super::super::super::Date>,
+    /// Per-line-item outcomes on this date. Every metered line item from
+    /// the union of the requested contracts' packages is emitted,
+    /// including line items with zero usage, so consumers can render
+    /// zero-rows without a separate zero-fill pass.
+    #[prost(message, repeated, tag = "2")]
+    pub line_items: ::prost::alloc::vec::Vec<LineItemDailyOutcomes>,
+}
+#[derive(Clone, PartialEq, ::prost::Message)]
+pub struct GetDailyBreakdownResponse {
+    /// Days in ascending date order. A given calendar date appears at
+    /// most once regardless of how many of the requested contracts
+    /// overlap it (BillingUsageService reports usage at calendar-day
+    /// granularity, so a day straddling a mid-day rollover is still one
+    /// row carrying the day's full outcomes). Contract ids from the
+    /// request that do not resolve contribute no rows.
+    #[prost(message, repeated, tag = "1")]
+    pub days: ::prost::alloc::vec::Vec<DailyLineItemOutcomes>,
+}
 #[derive(Clone, Copy, PartialEq, Eq, Hash, ::prost::Message)]
 pub struct UsagePricerRequest {
     #[prost(uint64, tag = "1")]