metronome-sdk 3.5.0 → 3.7.0

data/rbi/metronome_sdk/resources/v1/contracts/products.rbi

@@ -34,6 +34,8 @@ module MetronomeSDK
                 T.nilable(
                   MetronomeSDK::V1::Contracts::QuantityRounding::OrHash
                 ),
+              sql_breakdown_granularity:
+                MetronomeSDK::V1::Contracts::ProductCreateParams::SqlBreakdownGranularity::OrSymbol,
               tags: T::Array[String],
               request_options: MetronomeSDK::RequestOptions::OrHash
             ).returns(
@@ -84,6 +86,13 @@ module MetronomeSDK
             # the method is "round up" and the decimal places is 0, then the quantity will be
             # rounded up to the nearest integer.
             quantity_rounding: nil,
+            # Defines the breakdown behavior when calculating usage from SQL Billable Metrics.
+            # If set to 'service_period' (default), the usage will be evaluated once for all
+            # events the invoice service period and the usage will be applied at the last
+            # instant of the invoice. If set to 'hour', it will be broken down and evaluated
+            # for each hour. For most use cases, 'hour' is recommended. The setting has no
+            # effect for Streaming Billable Metrics.
+            sql_breakdown_granularity: nil,
             tags: nil,
             request_options: {}
           )
@@ -134,6 +143,8 @@ module MetronomeSDK
                 T.nilable(
                   MetronomeSDK::V1::Contracts::QuantityRounding::OrHash
                 ),
+              sql_breakdown_granularity:
+                MetronomeSDK::V1::Contracts::ProductUpdateParams::SqlBreakdownGranularity::OrSymbol,
               tags: T::Array[String],
               request_options: MetronomeSDK::RequestOptions::OrHash
             ).returns(
@@ -192,6 +203,13 @@ module MetronomeSDK
             # the method is "round up" and the decimal places is 0, then the quantity will be
             # rounded up to the nearest integer.
             quantity_rounding: nil,
+            # Defines the breakdown behavior when calculating usage from SQL Billable Metrics.
+            # If set to 'service_period' (default), the usage will be evaluated once for all
+            # events the invoice service period and the usage will be applied at the last
+            # instant of the invoice. If set to 'hour', it will be broken down and evaluated
+            # for each hour. For most use cases, 'hour' is recommended. The setting has no
+            # effect for Streaming Billable Metrics.
+            sql_breakdown_granularity: nil,
             # If not provided, defaults to product's current tags
             tags: nil,
             request_options: {}

data/rbi/metronome_sdk/resources/v1/contracts.rbi

@@ -19,8 +19,8 @@ module MetronomeSDK
 
         # Contracts define a customer's products, pricing, discounts, access duration, and
         # billing configuration. Contracts serve as the central billing agreement for both
-        # PLG and Enterprise customers, you can automatically customers access to your
-        # products and services directly from your product or CRM.
+        # PLG and Enterprise customers. You can automatically grant customers access to
+        # your products and services directly from your product or CRM.
         #
         # ### Use this endpoint to:
         #
@@ -200,6 +200,10 @@ module MetronomeSDK
               MetronomeSDK::V1::ContractCreateParams::ScheduledChargesOnUsageInvoices::OrSymbol,
             spend_threshold_configuration:
               MetronomeSDK::SpendThresholdConfiguration::OrHash,
+            spend_trackers:
+              T::Array[
+                MetronomeSDK::V1::ContractCreateParams::SpendTracker::OrHash
+              ],
             subscriptions:
               T::Array[
                 MetronomeSDK::V1::ContractCreateParams::Subscription::OrHash
@@ -245,7 +249,7 @@ module MetronomeSDK
           package_alias: nil,
           # If provided, provisions a customer on a package instead of creating a
           # traditional contract. When specified, only customer_id, starting_at, package_id,
-          # and uniqueness_key are allowed.
+          # uniqueness_key, transition, and custom_fields are allowed.
           package_id: nil,
           prepaid_balance_threshold_configuration: nil,
           # This field's availability is dependent on your client's configuration.
@@ -271,6 +275,9 @@ module MetronomeSDK
           # on a separate invoice from usage charges.
           scheduled_charges_on_usage_invoices: nil,
           spend_threshold_configuration: nil,
+          # Spend trackers to attach to this contract. Aliases must be unique within a
+          # contract.
+          spend_trackers: nil,
           # Optional list of
           # [subscriptions](https://docs.metronome.com/manage-product-access/create-subscription/)
           # to add to the contract.
@@ -696,6 +703,84 @@ module MetronomeSDK
         )
         end
 
+        # Retrieve detailed balance for seat-based credits and commits from the contract's
+        # subscriptions, broken down by individual seats.
+        #
+        # ### Use this endpoint to:
+        #
+        # - Display per-seat balance information in customer dashboards
+        # - Filter balance data by subscription or specific seats
+        #
+        # ### Key response fields:
+        #
+        # An array of seat balance objects containing:
+        #
+        # - Seat id
+        # - Balance: current total balance across all commits and credits
+        #
+        # ### Usage guidelines:
+        #
+        # - Date filtering: use `covering_date` OR `starting_at`/`ending_before` to filter
+        #   balance data by time range
+        # - Set `include_credits_and_commits=true` for detailed commits and credits
+        #   breakdown per seat
+        # - Set `include_ledgers=true` for detailed transaction history per commit/credit
+        #   per seat
+        sig do
+          params(
+            contract_id: String,
+            customer_id: String,
+            covering_date: Time,
+            cursor: String,
+            effective_before: Time,
+            include_credits_and_commits: T::Boolean,
+            include_ledgers: T::Boolean,
+            limit: Integer,
+            seat_ids: T::Array[String],
+            starting_at: Time,
+            subscription_ids: T::Array[String],
+            request_options: MetronomeSDK::RequestOptions::OrHash
+          ).returns(MetronomeSDK::Models::V1::ContractListSeatBalancesResponse)
+        end
+        def list_seat_balances(
+          # The contract ID to retrieve seat balances for
+          contract_id:,
+          # The customer ID to retrieve seat balances for
+          customer_id:,
+          # Include only commits or credits with access that cover this specific date
+          # (cannot be used with starting_at or ending_before).
+          covering_date: nil,
+          # Page token from a previous response to retrieve the next page
+          cursor: nil,
+          # Include only commits or credits with access effective on or before this date
+          # (cannot be used with covering_date).
+          effective_before: nil,
+          # Include credits and commits in the response
+          include_credits_and_commits: nil,
+          # Include ledger entries for each commit and commit. `include_credits_and_commits`
+          # must be set to `true` for `include_ledgers=true` to apply.
+          include_ledgers: nil,
+          # Maximum number of seats to return. Range: 1-100. Default: 25. When
+          # `include_credits_and_commits = true`, if the total commits/credits across all
+          # seats exceeds 100, a limit of 100 applies to the total credits and commits.
+          # Seats are included greedily to maximize the number of seats returned. Example:
+          # if seat 1 has 98 commits and seat 2 has 10 commits, both seats will be returned
+          # (total: 108 commits). Each returned seat includes all of its associated credits
+          # and commits.
+          limit: nil,
+          # Optional filter to only include specific seats.
+          seat_ids: nil,
+          # Include only commits or credits with access effective on or after this date
+          # (cannot be used with covering_date).
+          starting_at: nil,
+          # Optional filter to only include seats from specific subscriptions. If
+          # subscriptions ids are not mapped to SEAT_BASED subscriptions, error will be
+          # returned.
+          subscription_ids: nil,
+          request_options: {}
+        )
+        end
+
         # For a specific customer and contract, get the rates at a specific point in time.
         # This endpoint takes the contract's rate card into consideration, including
         # scheduled changes. It also takes into account overrides on the contract.

data/rbi/metronome_sdk/resources/v1/customers/invoices.rbi

@@ -120,6 +120,7 @@ module MetronomeSDK
           sig do
             params(
               customer_id: String,
+              contract_id: String,
               credit_type_id: String,
               ending_before: Time,
               limit: Integer,
@@ -129,6 +130,8 @@ module MetronomeSDK
                 MetronomeSDK::V1::Customers::InvoiceListParams::Sort::OrSymbol,
               starting_on: Time,
               status: String,
+              type:
+                MetronomeSDK::V1::Customers::InvoiceListParams::Type::OrSymbol,
               request_options: MetronomeSDK::RequestOptions::OrHash
             ).returns(
               MetronomeSDK::Internal::CursorPage[
@@ -139,6 +142,8 @@ module MetronomeSDK
           def list(
             # Path param
             customer_id:,
+            # Query param: Only return invoices for the specified contract
+            contract_id: nil,
             # Query param: Only return invoices for the specified credit type
             credit_type_id: nil,
             # Query param: RFC 3339 timestamp (exclusive). Invoices will only be returned for
@@ -159,6 +164,8 @@ module MetronomeSDK
             starting_on: nil,
             # Query param: Invoice status, e.g. DRAFT, FINALIZED, or VOID
             status: nil,
+            # Query param: Filter invoices by type. Defaults to returning all invoice types.
+            type: nil,
             request_options: {}
           )
           end

data/rbi/metronome_sdk/resources/v1/packages.rbi

@@ -59,8 +59,6 @@ module MetronomeSDK
             name: String,
             aliases:
               T::Array[MetronomeSDK::V1::PackageCreateParams::Alias::OrHash],
-            billing_anchor_date:
-              MetronomeSDK::V1::PackageCreateParams::BillingAnchorDate::OrSymbol,
             billing_provider:
               MetronomeSDK::V1::PackageCreateParams::BillingProvider::OrSymbol,
             commits:
@@ -96,6 +94,10 @@ module MetronomeSDK
               MetronomeSDK::V1::PackageCreateParams::ScheduledChargesOnUsageInvoices::OrSymbol,
             spend_threshold_configuration:
               MetronomeSDK::SpendThresholdConfiguration::OrHash,
+            spend_trackers:
+              T::Array[
+                MetronomeSDK::V1::PackageCreateParams::SpendTracker::OrHash
+              ],
             subscriptions:
               T::Array[
                 MetronomeSDK::V1::PackageCreateParams::Subscription::OrHash
@@ -112,7 +114,6 @@ module MetronomeSDK
           # multiple packages, it will reference the package to which it was most recently
           # assigned. It is not exposed to end customers.
           aliases: nil,
-          billing_anchor_date: nil,
           billing_provider: nil,
           commits: nil,
           contract_name: nil,
@@ -141,6 +142,7 @@ module MetronomeSDK
           # on a separate invoice from usage charges.
           scheduled_charges_on_usage_invoices: nil,
           spend_threshold_configuration: nil,
+          spend_trackers: nil,
           subscriptions: nil,
           # Prevents the creation of duplicates. If a request to create a record is made
           # with a previously used uniqueness key, a new record will not be created and the
@@ -219,10 +221,9 @@ module MetronomeSDK
         #
         # ### **Usage guidelines:**
         #
-        # Use the **`starting_at`**, **`covering_date`**,
-        # and **`include_archived`** parameters to filter the list of returned contracts.
-        # For example, to list only currently active contracts,
-        # pass **`covering_date`** equal to the current time.
+        # Use the **`starting_at`**, **`covering_date`**, and **`include_archived`**
+        # parameters to filter the list of returned contracts. For example, to list only
+        # currently active contracts, pass **`covering_date`** equal to the current time.
         sig do
           params(
             package_id: String,

data/rbi/metronome_sdk/resources/v1.rbi

@@ -80,9 +80,6 @@ module MetronomeSDK
       sig { returns(MetronomeSDK::Resources::V1::Packages) }
       attr_reader :packages
 
-      sig { returns(MetronomeSDK::Resources::V1::Payments) }
-      attr_reader :payments
-
       # Use these endpoints to configure a billing API key, a webhook secret, or invoice
       # finalization behavior.
       sig { returns(MetronomeSDK::Resources::V1::Settings) }

data/rbi/metronome_sdk/resources/v2/contracts.rbi

@@ -159,6 +159,10 @@ module MetronomeSDK
               ],
             add_spend_threshold_configuration:
               MetronomeSDK::SpendThresholdConfigurationV2::OrHash,
+            add_spend_trackers:
+              T::Array[
+                MetronomeSDK::V2::ContractEditParams::AddSpendTracker::OrHash
+              ],
             add_subscriptions:
               T::Array[
                 MetronomeSDK::V2::ContractEditParams::AddSubscription::OrHash
@@ -176,6 +180,7 @@ module MetronomeSDK
               T::Array[
                 MetronomeSDK::V2::ContractEditParams::ArchiveScheduledCharge::OrHash
               ],
+            archive_spend_trackers: T::Array[String],
             remove_overrides:
               T::Array[
                 MetronomeSDK::V2::ContractEditParams::RemoveOverride::OrHash
@@ -240,6 +245,9 @@ module MetronomeSDK
           add_revenue_system_configuration_update: nil,
           add_scheduled_charges: nil,
           add_spend_threshold_configuration: nil,
+          # Spend trackers to add to this contract. Aliases must be unique within a
+          # contract.
+          add_spend_trackers: nil,
           # Optional list of
           # [subscriptions](https://docs.metronome.com/manage-product-access/create-subscription/)
           # to add to the contract.
@@ -255,6 +263,8 @@ module MetronomeSDK
           archive_credits: nil,
           # IDs of scheduled charges to archive
           archive_scheduled_charges: nil,
+          # Aliases of spend trackers to archive.
+          archive_spend_trackers: nil,
           # IDs of overrides to remove
           remove_overrides: nil,
           # Optional uniqueness key to prevent duplicate contract edits.

data/sig/metronome_sdk/models/commit.rbs

@@ -29,6 +29,7 @@ module MetronomeSDK
         rollover_fraction: Float,
         salesforce_opportunity_id: String,
         specifiers: ::Array[MetronomeSDK::CommitSpecifier],
+        spend_tracker_attributes: MetronomeSDK::Commit::SpendTrackerAttributes,
         subscription_config: MetronomeSDK::Commit::SubscriptionConfig,
         uniqueness_key: String
       }
@@ -152,6 +153,12 @@ module MetronomeSDK
         ::Array[MetronomeSDK::CommitSpecifier]
       ) -> ::Array[MetronomeSDK::CommitSpecifier]
 
+      attr_reader spend_tracker_attributes: MetronomeSDK::Commit::SpendTrackerAttributes?
+
+      def spend_tracker_attributes=: (
+        MetronomeSDK::Commit::SpendTrackerAttributes
+      ) -> MetronomeSDK::Commit::SpendTrackerAttributes
+
       attr_reader subscription_config: MetronomeSDK::Commit::SubscriptionConfig?
 
       def subscription_config=: (
@@ -190,6 +197,7 @@ module MetronomeSDK
         ?rollover_fraction: Float,
         ?salesforce_opportunity_id: String,
         ?specifiers: ::Array[MetronomeSDK::CommitSpecifier],
+        ?spend_tracker_attributes: MetronomeSDK::Commit::SpendTrackerAttributes,
         ?subscription_config: MetronomeSDK::Commit::SubscriptionConfig,
         ?uniqueness_key: String
       ) -> void
@@ -222,6 +230,7 @@ module MetronomeSDK
         rollover_fraction: Float,
         salesforce_opportunity_id: String,
         specifiers: ::Array[MetronomeSDK::CommitSpecifier],
+        spend_tracker_attributes: MetronomeSDK::Commit::SpendTrackerAttributes,
         subscription_config: MetronomeSDK::Commit::SubscriptionConfig,
         uniqueness_key: String
       }
@@ -957,6 +966,16 @@ module MetronomeSDK
         def to_hash: -> { commit_id: String, contract_id: String }
       end
 
+      type spend_tracker_attributes = { counts_as_discounted: bool }
+
+      class SpendTrackerAttributes < MetronomeSDK::Internal::Type::BaseModel
+        attr_accessor counts_as_discounted: bool
+
+        def initialize: (counts_as_discounted: bool) -> void
+
+        def to_hash: -> { counts_as_discounted: bool }
+      end
+
       type subscription_config =
         {
           allocation: MetronomeSDK::Models::Commit::SubscriptionConfig::allocation,

data/sig/metronome_sdk/models/contract.rbs

@@ -14,6 +14,7 @@ module MetronomeSDK
         prepaid_balance_threshold_configuration: MetronomeSDK::PrepaidBalanceThresholdConfiguration,
         scheduled_charges_on_usage_invoices: MetronomeSDK::Models::Contract::scheduled_charges_on_usage_invoices,
         spend_threshold_configuration: MetronomeSDK::SpendThresholdConfiguration,
+        spend_trackers: ::Array[MetronomeSDK::Contract::SpendTracker],
         subscriptions: ::Array[MetronomeSDK::Subscription],
         uniqueness_key: String
       }
@@ -65,6 +66,12 @@ module MetronomeSDK
         MetronomeSDK::SpendThresholdConfiguration
       ) -> MetronomeSDK::SpendThresholdConfiguration
 
+      attr_reader spend_trackers: ::Array[MetronomeSDK::Contract::SpendTracker]?
+
+      def spend_trackers=: (
+        ::Array[MetronomeSDK::Contract::SpendTracker]
+      ) -> ::Array[MetronomeSDK::Contract::SpendTracker]
+
       attr_reader subscriptions: ::Array[MetronomeSDK::Subscription]?
 
       def subscriptions=: (
@@ -88,6 +95,7 @@ module MetronomeSDK
         ?prepaid_balance_threshold_configuration: MetronomeSDK::PrepaidBalanceThresholdConfiguration,
         ?scheduled_charges_on_usage_invoices: MetronomeSDK::Models::Contract::scheduled_charges_on_usage_invoices,
         ?spend_threshold_configuration: MetronomeSDK::SpendThresholdConfiguration,
+        ?spend_trackers: ::Array[MetronomeSDK::Contract::SpendTracker],
         ?subscriptions: ::Array[MetronomeSDK::Subscription],
         ?uniqueness_key: String
       ) -> void
@@ -105,6 +113,7 @@ module MetronomeSDK
         prepaid_balance_threshold_configuration: MetronomeSDK::PrepaidBalanceThresholdConfiguration,
         scheduled_charges_on_usage_invoices: MetronomeSDK::Models::Contract::scheduled_charges_on_usage_invoices,
         spend_threshold_configuration: MetronomeSDK::SpendThresholdConfiguration,
+        spend_trackers: ::Array[MetronomeSDK::Contract::SpendTracker],
         subscriptions: ::Array[MetronomeSDK::Subscription],
         uniqueness_key: String
       }
@@ -395,6 +404,148 @@ module MetronomeSDK
 
         def self?.values: -> ::Array[MetronomeSDK::Models::Contract::scheduled_charges_on_usage_invoices]
       end
+
+      type spend_tracker =
+        {
+          alias_: String,
+          applicable_spend_specifiers: ::Array[MetronomeSDK::Contract::SpendTracker::ApplicableSpendSpecifier],
+          credit_type_id: String,
+          reset_frequency: MetronomeSDK::Models::Contract::SpendTracker::reset_frequency,
+          accumulated_spend: MetronomeSDK::Contract::SpendTracker::AccumulatedSpend
+        }
+
+      class SpendTracker < MetronomeSDK::Internal::Type::BaseModel
+        attr_accessor alias_: String
+
+        attr_accessor applicable_spend_specifiers: ::Array[MetronomeSDK::Contract::SpendTracker::ApplicableSpendSpecifier]
+
+        attr_accessor credit_type_id: String
+
+        attr_accessor reset_frequency: MetronomeSDK::Models::Contract::SpendTracker::reset_frequency
+
+        attr_reader accumulated_spend: MetronomeSDK::Contract::SpendTracker::AccumulatedSpend?
+
+        def accumulated_spend=: (
+          MetronomeSDK::Contract::SpendTracker::AccumulatedSpend
+        ) -> MetronomeSDK::Contract::SpendTracker::AccumulatedSpend
+
+        def initialize: (
+          alias_: String,
+          applicable_spend_specifiers: ::Array[MetronomeSDK::Contract::SpendTracker::ApplicableSpendSpecifier],
+          credit_type_id: String,
+          reset_frequency: MetronomeSDK::Models::Contract::SpendTracker::reset_frequency,
+          ?accumulated_spend: MetronomeSDK::Contract::SpendTracker::AccumulatedSpend
+        ) -> void
+
+        def to_hash: -> {
+          alias_: String,
+          applicable_spend_specifiers: ::Array[MetronomeSDK::Contract::SpendTracker::ApplicableSpendSpecifier],
+          credit_type_id: String,
+          reset_frequency: MetronomeSDK::Models::Contract::SpendTracker::reset_frequency,
+          accumulated_spend: MetronomeSDK::Contract::SpendTracker::AccumulatedSpend
+        }
+
+        type applicable_spend_specifier =
+          {
+            sources: ::Array[MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::source],
+            spend_type: MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::spend_type,
+            discounted: MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::discounted
+          }
+
+        class ApplicableSpendSpecifier < MetronomeSDK::Internal::Type::BaseModel
+          attr_accessor sources: ::Array[MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::source]
+
+          attr_accessor spend_type: MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::spend_type
+
+          attr_reader discounted: MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::discounted?
+
+          def discounted=: (
+            MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::discounted
+          ) -> MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::discounted
+
+          def initialize: (
+            sources: ::Array[MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::source],
+            spend_type: MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::spend_type,
+            ?discounted: MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::discounted
+          ) -> void
+
+          def to_hash: -> {
+            sources: ::Array[MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::source],
+            spend_type: MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::spend_type,
+            discounted: MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::discounted
+          }
+
+          type source = :THRESHOLD_RECHARGE | :MANUAL
+
+          module Source
+            extend MetronomeSDK::Internal::Type::Enum
+
+            THRESHOLD_RECHARGE: :THRESHOLD_RECHARGE
+            MANUAL: :MANUAL
+
+            def self?.values: -> ::Array[MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::source]
+          end
+
+          type spend_type = :COMMIT_PURCHASE
+
+          module SpendType
+            extend MetronomeSDK::Internal::Type::Enum
+
+            COMMIT_PURCHASE: :COMMIT_PURCHASE
+
+            def self?.values: -> ::Array[MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::spend_type]
+          end
+
+          type discounted = :ANY | :DISCOUNTED_ONLY | :UNDISCOUNTED_ONLY
+
+          module Discounted
+            extend MetronomeSDK::Internal::Type::Enum
+
+            ANY: :ANY
+            DISCOUNTED_ONLY: :DISCOUNTED_ONLY
+            UNDISCOUNTED_ONLY: :UNDISCOUNTED_ONLY
+
+            def self?.values: -> ::Array[MetronomeSDK::Models::Contract::SpendTracker::ApplicableSpendSpecifier::discounted]
+          end
+        end
+
+        type reset_frequency = :BILLING_PERIOD
+
+        module ResetFrequency
+          extend MetronomeSDK::Internal::Type::Enum
+
+          BILLING_PERIOD: :BILLING_PERIOD
+
+          def self?.values: -> ::Array[MetronomeSDK::Models::Contract::SpendTracker::reset_frequency]
+        end
+
+        type accumulated_spend =
+          {
+            amount: Float,
+            period_ending_before: Time,
+            period_starting_at: Time
+          }
+
+        class AccumulatedSpend < MetronomeSDK::Internal::Type::BaseModel
+          attr_accessor amount: Float
+
+          attr_accessor period_ending_before: Time
+
+          attr_accessor period_starting_at: Time
+
+          def initialize: (
+            amount: Float,
+            period_ending_before: Time,
+            period_starting_at: Time
+          ) -> void
+
+          def to_hash: -> {
+            amount: Float,
+            period_ending_before: Time,
+            period_starting_at: Time
+          }
+        end
+      end
     end
   end
 end