stigg 0.1.0.pre.alpha.1 → 0.1.0.pre.alpha.2

data/lib/stigg/models/v1/subscription_preview_response.rb

@@ -6,16 +6,20 @@ module Stigg
       # @see Stigg::Resources::V1::Subscriptions#preview
       class SubscriptionPreviewResponse < Stigg::Internal::Type::BaseModel
         # @!attribute data
+        #   Pricing preview with invoices
         #
         #   @return [Stigg::Models::V1::SubscriptionPreviewResponse::Data]
         required :data, -> { Stigg::Models::V1::SubscriptionPreviewResponse::Data }
 
         # @!method initialize(data:)
-        #   @param data [Stigg::Models::V1::SubscriptionPreviewResponse::Data]
+        #   Response object
+        #
+        #   @param data [Stigg::Models::V1::SubscriptionPreviewResponse::Data] Pricing preview with invoices
 
         # @see Stigg::Models::V1::SubscriptionPreviewResponse#data
         class Data < Stigg::Internal::Type::BaseModel
           # @!attribute immediate_invoice
+          #   Invoice due immediately
           #
           #   @return [Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice]
           required :immediate_invoice,
@@ -23,6 +27,7 @@ module Stigg
                    api_name: :immediateInvoice
 
           # @!attribute billing_period_range
+          #   Billing period range
           #
           #   @return [Stigg::Models::V1::SubscriptionPreviewResponse::Data::BillingPeriodRange, nil]
           optional :billing_period_range,
@@ -30,6 +35,7 @@ module Stigg
                    api_name: :billingPeriodRange
 
           # @!attribute free_items
+          #   Free items included
           #
           #   @return [Array<Stigg::Models::V1::SubscriptionPreviewResponse::Data::FreeItem>, nil]
           optional :free_items,
@@ -37,16 +43,19 @@ module Stigg
                    api_name: :freeItems
 
           # @!attribute has_scheduled_updates
+          #   Whether updates are scheduled
           #
           #   @return [Boolean, nil]
           optional :has_scheduled_updates, Stigg::Internal::Type::Boolean, api_name: :hasScheduledUpdates
 
           # @!attribute is_plan_downgrade
+          #   Whether this is a downgrade
           #
           #   @return [Boolean, nil]
           optional :is_plan_downgrade, Stigg::Internal::Type::Boolean, api_name: :isPlanDowngrade
 
           # @!attribute recurring_invoice
+          #   Recurring invoice preview
           #
           #   @return [Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice, nil]
           optional :recurring_invoice,
@@ -54,26 +63,36 @@ module Stigg
                    api_name: :recurringInvoice
 
           # @!method initialize(immediate_invoice:, billing_period_range: nil, free_items: nil, has_scheduled_updates: nil, is_plan_downgrade: nil, recurring_invoice: nil)
-          #   @param immediate_invoice [Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice]
-          #   @param billing_period_range [Stigg::Models::V1::SubscriptionPreviewResponse::Data::BillingPeriodRange]
-          #   @param free_items [Array<Stigg::Models::V1::SubscriptionPreviewResponse::Data::FreeItem>]
-          #   @param has_scheduled_updates [Boolean]
-          #   @param is_plan_downgrade [Boolean]
-          #   @param recurring_invoice [Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice]
+          #   Pricing preview with invoices
+          #
+          #   @param immediate_invoice [Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice] Invoice due immediately
+          #
+          #   @param billing_period_range [Stigg::Models::V1::SubscriptionPreviewResponse::Data::BillingPeriodRange] Billing period range
+          #
+          #   @param free_items [Array<Stigg::Models::V1::SubscriptionPreviewResponse::Data::FreeItem>] Free items included
+          #
+          #   @param has_scheduled_updates [Boolean] Whether updates are scheduled
+          #
+          #   @param is_plan_downgrade [Boolean] Whether this is a downgrade
+          #
+          #   @param recurring_invoice [Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice] Recurring invoice preview
 
           # @see Stigg::Models::V1::SubscriptionPreviewResponse::Data#immediate_invoice
           class ImmediateInvoice < Stigg::Internal::Type::BaseModel
             # @!attribute sub_total
+            #   Subtotal before discounts
             #
             #   @return [Float]
             required :sub_total, Float, api_name: :subTotal
 
             # @!attribute total
+            #   Invoice total
             #
             #   @return [Float]
             required :total, Float
 
             # @!attribute billing_period_range
+            #   Billing period covered
             #
             #   @return [Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice::BillingPeriodRange, nil]
             optional :billing_period_range,
@@ -81,16 +100,19 @@ module Stigg
                      api_name: :billingPeriodRange
 
             # @!attribute currency
+            #   Currency code
             #
             #   @return [String, nil]
             optional :currency, String, nil?: true
 
             # @!attribute discount
+            #   Total discount amount
             #
             #   @return [Float, nil]
             optional :discount, Float
 
             # @!attribute discount_details
+            #   Discount breakdown
             #
             #   @return [Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice::DiscountDetails, nil]
             optional :discount_details,
@@ -98,32 +120,45 @@ module Stigg
                      api_name: :discountDetails
 
             # @!attribute discounts
+            #   Applied discounts
             #
             #   @return [Array<Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice::Discount>, nil]
             optional :discounts,
                      -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice::Discount] }
 
             # @!attribute lines
+            #   Line items
             #
             #   @return [Array<Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice::Line>, nil]
             optional :lines,
                      -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice::Line] }
 
             # @!attribute tax
+            #   Tax amount
             #
             #   @return [Float, nil]
             optional :tax, Float
 
             # @!method initialize(sub_total:, total:, billing_period_range: nil, currency: nil, discount: nil, discount_details: nil, discounts: nil, lines: nil, tax: nil)
-            #   @param sub_total [Float]
-            #   @param total [Float]
-            #   @param billing_period_range [Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice::BillingPeriodRange]
-            #   @param currency [String, nil]
-            #   @param discount [Float]
-            #   @param discount_details [Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice::DiscountDetails]
-            #   @param discounts [Array<Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice::Discount>]
-            #   @param lines [Array<Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice::Line>]
-            #   @param tax [Float]
+            #   Invoice due immediately
+            #
+            #   @param sub_total [Float] Subtotal before discounts
+            #
+            #   @param total [Float] Invoice total
+            #
+            #   @param billing_period_range [Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice::BillingPeriodRange] Billing period covered
+            #
+            #   @param currency [String, nil] Currency code
+            #
+            #   @param discount [Float] Total discount amount
+            #
+            #   @param discount_details [Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice::DiscountDetails] Discount breakdown
+            #
+            #   @param discounts [Array<Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice::Discount>] Applied discounts
+            #
+            #   @param lines [Array<Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice::Line>] Line items
+            #
+            #   @param tax [Float] Tax amount
 
             # @see Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice#billing_period_range
             class BillingPeriodRange < Stigg::Internal::Type::BaseModel
@@ -140,6 +175,8 @@ module Stigg
               required :start, Time
 
               # @!method initialize(end_:, start:)
+              #   Billing period covered
+              #
               #   @param end_ [Time] Billing period end date
               #
               #   @param start [Time] Billing period start date
@@ -148,80 +185,105 @@ module Stigg
             # @see Stigg::Models::V1::SubscriptionPreviewResponse::Data::ImmediateInvoice#discount_details
             class DiscountDetails < Stigg::Internal::Type::BaseModel
               # @!attribute code
+              #   Promo code used
               #
               #   @return [String, nil]
               optional :code, String
 
               # @!attribute fixed_amount
+              #   Fixed discount amount
               #
               #   @return [Float, nil]
               optional :fixed_amount, Float, api_name: :fixedAmount
 
               # @!attribute percentage
+              #   Percentage discount
               #
               #   @return [Float, nil]
               optional :percentage, Float
 
               # @!method initialize(code: nil, fixed_amount: nil, percentage: nil)
-              #   @param code [String]
-              #   @param fixed_amount [Float]
-              #   @param percentage [Float]
+              #   Discount breakdown
+              #
+              #   @param code [String] Promo code used
+              #
+              #   @param fixed_amount [Float] Fixed discount amount
+              #
+              #   @param percentage [Float] Percentage discount
             end
 
             class Discount < Stigg::Internal::Type::BaseModel
               # @!attribute amount
+              #   Discount amount
               #
               #   @return [Float]
               required :amount, Float
 
               # @!attribute currency
+              #   Currency code
               #
               #   @return [String]
               required :currency, String
 
               # @!attribute description
+              #   Discount description
               #
               #   @return [String]
               required :description, String
 
               # @!method initialize(amount:, currency:, description:)
-              #   @param amount [Float]
-              #   @param currency [String]
-              #   @param description [String]
+              #   Applied discount amount
+              #
+              #   @param amount [Float] Discount amount
+              #
+              #   @param currency [String] Currency code
+              #
+              #   @param description [String] Discount description
             end
 
             class Line < Stigg::Internal::Type::BaseModel
               # @!attribute currency
+              #   Currency code
               #
               #   @return [String]
               required :currency, String
 
               # @!attribute description
+              #   Line item description
               #
               #   @return [String]
               required :description, String
 
               # @!attribute sub_total
+              #   Line subtotal
               #
               #   @return [Float]
               required :sub_total, Float, api_name: :subTotal
 
               # @!attribute unit_price
+              #   Price per unit
               #
               #   @return [Float]
               required :unit_price, Float, api_name: :unitPrice
 
               # @!attribute quantity
+              #   Quantity
               #
               #   @return [Float, nil]
               optional :quantity, Float
 
               # @!method initialize(currency:, description:, sub_total:, unit_price:, quantity: nil)
-              #   @param currency [String]
-              #   @param description [String]
-              #   @param sub_total [Float]
-              #   @param unit_price [Float]
-              #   @param quantity [Float]
+              #   Invoice line item
+              #
+              #   @param currency [String] Currency code
+              #
+              #   @param description [String] Line item description
+              #
+              #   @param sub_total [Float] Line subtotal
+              #
+              #   @param unit_price [Float] Price per unit
+              #
+              #   @param quantity [Float] Quantity
             end
           end
 
@@ -240,6 +302,8 @@ module Stigg
             optional :start, Time
 
             # @!method initialize(end_: nil, start: nil)
+            #   Billing period range
+            #
             #   @param end_ [Time] Billing period end date
             #
             #   @param start [Time] Billing period start date
@@ -247,33 +311,41 @@ module Stigg
 
           class FreeItem < Stigg::Internal::Type::BaseModel
             # @!attribute addon_id
+            #   Addon ID
             #
             #   @return [String]
             required :addon_id, String, api_name: :addonId
 
             # @!attribute quantity
+            #   Quantity
             #
             #   @return [Float]
             required :quantity, Float
 
             # @!method initialize(addon_id:, quantity:)
-            #   @param addon_id [String]
-            #   @param quantity [Float]
+            #   Free item in subscription
+            #
+            #   @param addon_id [String] Addon ID
+            #
+            #   @param quantity [Float] Quantity
           end
 
           # @see Stigg::Models::V1::SubscriptionPreviewResponse::Data#recurring_invoice
           class RecurringInvoice < Stigg::Internal::Type::BaseModel
             # @!attribute sub_total
+            #   Subtotal before discounts
             #
             #   @return [Float]
             required :sub_total, Float, api_name: :subTotal
 
             # @!attribute total
+            #   Invoice total
             #
             #   @return [Float]
             required :total, Float
 
             # @!attribute billing_period_range
+            #   Billing period covered
             #
             #   @return [Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice::BillingPeriodRange, nil]
             optional :billing_period_range,
@@ -281,16 +353,19 @@ module Stigg
                      api_name: :billingPeriodRange
 
             # @!attribute currency
+            #   Currency code
             #
             #   @return [String, nil]
             optional :currency, String, nil?: true
 
             # @!attribute discount
+            #   Total discount amount
             #
             #   @return [Float, nil]
             optional :discount, Float
 
             # @!attribute discount_details
+            #   Discount breakdown
             #
             #   @return [Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice::DiscountDetails, nil]
             optional :discount_details,
@@ -298,32 +373,45 @@ module Stigg
                      api_name: :discountDetails
 
             # @!attribute discounts
+            #   Applied discounts
             #
             #   @return [Array<Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice::Discount>, nil]
             optional :discounts,
                      -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice::Discount] }
 
             # @!attribute lines
+            #   Line items
             #
             #   @return [Array<Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice::Line>, nil]
             optional :lines,
                      -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice::Line] }
 
             # @!attribute tax
+            #   Tax amount
             #
             #   @return [Float, nil]
             optional :tax, Float
 
             # @!method initialize(sub_total:, total:, billing_period_range: nil, currency: nil, discount: nil, discount_details: nil, discounts: nil, lines: nil, tax: nil)
-            #   @param sub_total [Float]
-            #   @param total [Float]
-            #   @param billing_period_range [Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice::BillingPeriodRange]
-            #   @param currency [String, nil]
-            #   @param discount [Float]
-            #   @param discount_details [Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice::DiscountDetails]
-            #   @param discounts [Array<Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice::Discount>]
-            #   @param lines [Array<Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice::Line>]
-            #   @param tax [Float]
+            #   Recurring invoice preview
+            #
+            #   @param sub_total [Float] Subtotal before discounts
+            #
+            #   @param total [Float] Invoice total
+            #
+            #   @param billing_period_range [Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice::BillingPeriodRange] Billing period covered
+            #
+            #   @param currency [String, nil] Currency code
+            #
+            #   @param discount [Float] Total discount amount
+            #
+            #   @param discount_details [Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice::DiscountDetails] Discount breakdown
+            #
+            #   @param discounts [Array<Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice::Discount>] Applied discounts
+            #
+            #   @param lines [Array<Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice::Line>] Line items
+            #
+            #   @param tax [Float] Tax amount
 
             # @see Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice#billing_period_range
             class BillingPeriodRange < Stigg::Internal::Type::BaseModel
@@ -340,6 +428,8 @@ module Stigg
               required :start, Time
 
               # @!method initialize(end_:, start:)
+              #   Billing period covered
+              #
               #   @param end_ [Time] Billing period end date
               #
               #   @param start [Time] Billing period start date
@@ -348,80 +438,105 @@ module Stigg
             # @see Stigg::Models::V1::SubscriptionPreviewResponse::Data::RecurringInvoice#discount_details
             class DiscountDetails < Stigg::Internal::Type::BaseModel
               # @!attribute code
+              #   Promo code used
               #
               #   @return [String, nil]
               optional :code, String
 
               # @!attribute fixed_amount
+              #   Fixed discount amount
               #
               #   @return [Float, nil]
               optional :fixed_amount, Float, api_name: :fixedAmount
 
               # @!attribute percentage
+              #   Percentage discount
               #
               #   @return [Float, nil]
               optional :percentage, Float
 
               # @!method initialize(code: nil, fixed_amount: nil, percentage: nil)
-              #   @param code [String]
-              #   @param fixed_amount [Float]
-              #   @param percentage [Float]
+              #   Discount breakdown
+              #
+              #   @param code [String] Promo code used
+              #
+              #   @param fixed_amount [Float] Fixed discount amount
+              #
+              #   @param percentage [Float] Percentage discount
             end
 
             class Discount < Stigg::Internal::Type::BaseModel
               # @!attribute amount
+              #   Discount amount
               #
               #   @return [Float]
               required :amount, Float
 
               # @!attribute currency
+              #   Currency code
               #
               #   @return [String]
               required :currency, String
 
               # @!attribute description
+              #   Discount description
               #
               #   @return [String]
               required :description, String
 
               # @!method initialize(amount:, currency:, description:)
-              #   @param amount [Float]
-              #   @param currency [String]
-              #   @param description [String]
+              #   Applied discount amount
+              #
+              #   @param amount [Float] Discount amount
+              #
+              #   @param currency [String] Currency code
+              #
+              #   @param description [String] Discount description
             end
 
             class Line < Stigg::Internal::Type::BaseModel
               # @!attribute currency
+              #   Currency code
               #
               #   @return [String]
               required :currency, String
 
               # @!attribute description
+              #   Line item description
               #
               #   @return [String]
               required :description, String
 
               # @!attribute sub_total
+              #   Line subtotal
               #
               #   @return [Float]
               required :sub_total, Float, api_name: :subTotal
 
               # @!attribute unit_price
+              #   Price per unit
               #
               #   @return [Float]
               required :unit_price, Float, api_name: :unitPrice
 
               # @!attribute quantity
+              #   Quantity
               #
               #   @return [Float, nil]
               optional :quantity, Float
 
               # @!method initialize(currency:, description:, sub_total:, unit_price:, quantity: nil)
-              #   @param currency [String]
-              #   @param description [String]
-              #   @param sub_total [Float]
-              #   @param unit_price [Float]
-              #   @param quantity [Float]
+              #   Invoice line item
+              #
+              #   @param currency [String] Currency code
+              #
+              #   @param description [String] Line item description
+              #
+              #   @param sub_total [Float] Line subtotal
+              #
+              #   @param unit_price [Float] Price per unit
+              #
+              #   @param quantity [Float] Quantity
             end
           end
         end

data/lib/stigg/models/v1/subscription_retrieve_response.rb

@@ -6,12 +6,15 @@ module Stigg
       # @see Stigg::Resources::V1::Subscriptions#retrieve
       class SubscriptionRetrieveResponse < Stigg::Internal::Type::BaseModel
         # @!attribute data
+        #   Customer subscription to a plan
         #
         #   @return [Stigg::Models::V1::SubscriptionRetrieveResponse::Data]
         required :data, -> { Stigg::Models::V1::SubscriptionRetrieveResponse::Data }
 
         # @!method initialize(data:)
-        #   @param data [Stigg::Models::V1::SubscriptionRetrieveResponse::Data]
+        #   Response object
+        #
+        #   @param data [Stigg::Models::V1::SubscriptionRetrieveResponse::Data] Customer subscription to a plan
 
         # @see Stigg::Models::V1::SubscriptionRetrieveResponse#data
         class Data < Stigg::Internal::Type::BaseModel
@@ -133,6 +136,12 @@ module Stigg
                    api_name: :paymentCollectionMethod,
                    nil?: true
 
+          # @!attribute prices
+          #
+          #   @return [Array<Stigg::Models::V1::SubscriptionRetrieveResponse::Data::Price>, nil]
+          optional :prices,
+                   -> { Stigg::Internal::Type::ArrayOf[Stigg::Models::V1::SubscriptionRetrieveResponse::Data::Price] }
+
           # @!attribute resource_id
           #   Resource ID
           #
@@ -145,7 +154,9 @@ module Stigg
           #   @return [Time, nil]
           optional :trial_end_date, Time, api_name: :trialEndDate, nil?: true
 
-          # @!method initialize(id:, billing_id:, created_at:, customer_id:, payment_collection:, plan_id:, pricing_type:, start_date:, status:, cancellation_date: nil, cancel_reason: nil, current_billing_period_end: nil, current_billing_period_start: nil, effective_end_date: nil, end_date: nil, metadata: nil, paying_customer_id: nil, payment_collection_method: nil, resource_id: nil, trial_end_date: nil)
+          # @!method initialize(id:, billing_id:, created_at:, customer_id:, payment_collection:, plan_id:, pricing_type:, start_date:, status:, cancellation_date: nil, cancel_reason: nil, current_billing_period_end: nil, current_billing_period_start: nil, effective_end_date: nil, end_date: nil, metadata: nil, paying_customer_id: nil, payment_collection_method: nil, prices: nil, resource_id: nil, trial_end_date: nil)
+          #   Customer subscription to a plan
+          #
           #   @param id [String] Subscription ID
           #
           #   @param billing_id [String, nil] Billing ID
@@ -182,6 +193,8 @@ module Stigg
           #
           #   @param payment_collection_method [Symbol, Stigg::Models::V1::SubscriptionRetrieveResponse::Data::PaymentCollectionMethod, nil] The method used to collect payments for a subscription
           #
+          #   @param prices [Array<Stigg::Models::V1::SubscriptionRetrieveResponse::Data::Price>]
+          #
           #   @param resource_id [String, nil] Resource ID
           #
           #   @param trial_end_date [Time, nil] Subscription trial end date
@@ -267,6 +280,33 @@ module Stigg
             # @!method self.values
             #   @return [Array<Symbol>]
           end
+
+          class Price < Stigg::Internal::Type::BaseModel
+            # @!attribute id
+            #   Price ID
+            #
+            #   @return [String]
+            required :id, String
+
+            # @!attribute created_at
+            #   Creation timestamp
+            #
+            #   @return [String]
+            required :created_at, String, api_name: :createdAt
+
+            # @!attribute updated_at
+            #   Last update timestamp
+            #
+            #   @return [String]
+            required :updated_at, String, api_name: :updatedAt
+
+            # @!method initialize(id:, created_at:, updated_at:)
+            #   @param id [String] Price ID
+            #
+            #   @param created_at [String] Creation timestamp
+            #
+            #   @param updated_at [String] Last update timestamp
+          end
         end
       end
     end

data/lib/stigg/models/v1/subscription_transfer_params.rb

@@ -9,17 +9,13 @@ module Stigg
         include Stigg::Internal::Type::RequestParameters
 
         # @!attribute destination_resource_id
-        #   The resource ID to transfer the subscription to. The destination resource must
-        #   belong to the same customer.
+        #   Resource ID to transfer the subscription to
         #
         #   @return [String]
         required :destination_resource_id, String, api_name: :destinationResourceId
 
         # @!method initialize(destination_resource_id:, request_options: {})
-        #   Some parameter documentations has been truncated, see
-        #   {Stigg::Models::V1::SubscriptionTransferParams} for more details.
-        #
-        #   @param destination_resource_id [String] The resource ID to transfer the subscription to. The destination resource must b
+        #   @param destination_resource_id [String] Resource ID to transfer the subscription to
         #
         #   @param request_options [Stigg::RequestOptions, Hash{Symbol=>Object}]
       end