tiger_stripe

# File generated from our OpenAPI spec
defmodule Stripe.Params.Billing.MeterCreateParams do
  @moduledoc "Parameters for meter create."

  @typedoc """
  * `customer_mapping` - Fields that specify how to map a meter event to a customer.
  * `default_aggregation` - The default settings to aggregate a meter's events with.
  * `display_name` - The meter’s name. Not visible to the customer. Max length: 250.
  * `event_name` - The name of the meter event to record usage for. Corresponds with the `event_name` field on meter events. Max length: 100.
  * `event_time_window` - The time window which meter events have been pre-aggregated for, if any. Possible values: `day`, `hour`.
  * `expand` - Specifies which fields in the response should be expanded.
  * `value_settings` - Fields that specify how to calculate a meter event's value.
  """
  @type t :: %__MODULE__{
          customer_mapping: map() | nil,
          default_aggregation: map(),
          display_name: String.t(),
          event_name: String.t(),
          event_time_window: String.t() | nil,
          expand: [String.t()] | nil,
          value_settings: map() | nil
        }

  defstruct [
    :customer_mapping,
    :default_aggregation,
    :display_name,
    :event_name,
    :event_time_window,
    :expand,
    :value_settings
  ]

  defmodule CustomerMapping do
    @moduledoc "Nested parameters."

    @typedoc """
    * `event_payload_key` - The key in the meter event payload to use for mapping the event to a customer. Max length: 100.
    * `type` - The method for mapping a meter event to a customer. Must be `by_id`. Possible values: `by_id`.
    """
    @type t :: %__MODULE__{
            event_payload_key: String.t() | nil,
            type: String.t() | nil
          }
    defstruct [:event_payload_key, :type]
  end

  defmodule DefaultAggregation do
    @moduledoc "Nested parameters."

    @typedoc """
    * `formula` - Specifies how events are aggregated. Allowed values are `count` to count the number of events, `sum` to sum each event's value and `last` to take the last event's value in the window. Possible values: `count`, `last`, `sum`.
    """
    @type t :: %__MODULE__{
            formula: String.t() | nil
          }
    defstruct [:formula]
  end

  defmodule ValueSettings do
    @moduledoc "Nested parameters."

    @typedoc """
    * `event_payload_key` - The key in the usage event payload to use as the value for this meter. For example, if the event payload contains usage on a `bytes_used` field, then set the event_payload_key to "bytes_used". Max length: 100.
    """
    @type t :: %__MODULE__{
            event_payload_key: String.t() | nil
          }
    defstruct [:event_payload_key]
  end
end