twilio-ruby 5.46.1 → 5.77.0

data/lib/twilio-ruby/rest/bulkexports/v1/export/job.rb

@@ -11,8 +11,6 @@ module Twilio
     class Bulkexports < Domain
       class V1 < Version
         class ExportList < ListResource
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class JobList < ListResource
             ##
             # Initialize the JobList
@@ -32,8 +30,6 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class JobPage < Page
             ##
             # Initialize the JobPage
@@ -63,8 +59,6 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class JobContext < InstanceContext
             ##
             # Initialize the JobContext
@@ -111,8 +105,6 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class JobInstance < InstanceResource
             ##
             # Initialize the JobInstance
@@ -136,6 +128,8 @@ module Twilio
                   'webhook_method' => payload['webhook_method'],
                   'email' => payload['email'],
                   'url' => payload['url'],
+                  'job_queue_position' => payload['job_queue_position'],
+                  'estimated_completion_time' => payload['estimated_completion_time'],
               }
 
               # Context
@@ -167,7 +161,7 @@ module Twilio
             end
 
             ##
-            # @return [Hash] This is a list of the completed, pending, or errored dates within the export time range, with one entry for each status with more than one day in that status
+            # @return [Hash] The details of a job state which is an object that contains a `status` string, a day count integer, and list of days in the job
             def details
               @properties['details']
             end
@@ -214,6 +208,18 @@ module Twilio
               @properties['url']
             end
 
+            ##
+            # @return [String] This is the job position from the 1st in line. Your queue position will never increase. As jobs ahead of yours in the queue are processed, the queue position number will decrease
+            def job_queue_position
+              @properties['job_queue_position']
+            end
+
+            ##
+            # @return [String] this is the time estimated until your job is complete. This is calculated each time you request the job list. The time is calculated based on the current rate of job completion (which may vary) and your job queue position
+            def estimated_completion_time
+              @properties['estimated_completion_time']
+            end
+
             ##
             # Fetch the JobInstance
             # @return [JobInstance] Fetched JobInstance

data/lib/twilio-ruby/rest/bulkexports/v1/export.rb

@@ -10,8 +10,6 @@ module Twilio
   module REST
     class Bulkexports < Domain
       class V1 < Version
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ExportList < ListResource
           ##
           # Initialize the ExportList
@@ -50,8 +48,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ExportPage < Page
           ##
           # Initialize the ExportPage
@@ -81,8 +77,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ExportContext < InstanceContext
           ##
           # Initialize the ExportContext
@@ -156,8 +150,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ExportInstance < InstanceResource
           ##
           # Initialize the ExportInstance

data/lib/twilio-ruby/rest/bulkexports/v1/export_configuration.rb

@@ -10,8 +10,6 @@ module Twilio
   module REST
     class Bulkexports < Domain
       class V1 < Version
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ExportConfigurationList < ListResource
           ##
           # Initialize the ExportConfigurationList
@@ -31,8 +29,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ExportConfigurationPage < Page
           ##
           # Initialize the ExportConfigurationPage
@@ -62,8 +58,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ExportConfigurationContext < InstanceContext
           ##
           # Initialize the ExportConfigurationContext
@@ -125,8 +119,6 @@ module Twilio
           end
         end
 
-        ##
-        # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
         class ExportConfigurationInstance < InstanceResource
           ##
           # Initialize the ExportConfigurationInstance

data/lib/twilio-ruby/rest/bulkexports/v1.rb

@@ -26,11 +26,12 @@ module Twilio
         # @return [Twilio::REST::Bulkexports::V1::ExportList]
         def exports(resource_type=:unset)
           if resource_type.nil?
-            raise ArgumentError, 'resource_type cannot be nil'
-          elsif resource_type == :unset
-            @exports ||= ExportList.new self
+              raise ArgumentError, 'resource_type cannot be nil'
+          end
+          if resource_type == :unset
+              @exports ||= ExportList.new self
           else
-            ExportContext.new(self, resource_type)
+              ExportContext.new(self, resource_type)
           end
         end
 
@@ -41,11 +42,12 @@ module Twilio
         # @return [Twilio::REST::Bulkexports::V1::ExportConfigurationList]
         def export_configuration(resource_type=:unset)
           if resource_type.nil?
-            raise ArgumentError, 'resource_type cannot be nil'
-          elsif resource_type == :unset
-            @export_configuration ||= ExportConfigurationList.new self
+              raise ArgumentError, 'resource_type cannot be nil'
+          end
+          if resource_type == :unset
+              @export_configuration ||= ExportConfigurationList.new self
           else
-            ExportConfigurationContext.new(self, resource_type)
+              ExportConfigurationContext.new(self, resource_type)
           end
         end
 

data/lib/twilio-ruby/rest/chat/v1/service/channel/message.rb

@@ -293,7 +293,7 @@ module Twilio
                     'was_edited' => payload['was_edited'],
                     'from' => payload['from'],
                     'body' => payload['body'],
-                    'index' => payload['index'].to_i,
+                    'index' => payload['index'] == nil ? payload['index'] : payload['index'].to_i,
                     'url' => payload['url'],
                 }
 

data/lib/twilio-ruby/rest/chat/v1/service/channel.rb

@@ -345,8 +345,8 @@ module Twilio
                   'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                   'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
                   'created_by' => payload['created_by'],
-                  'members_count' => payload['members_count'].to_i,
-                  'messages_count' => payload['messages_count'].to_i,
+                  'members_count' => payload['members_count'] == nil ? payload['members_count'] : payload['members_count'].to_i,
+                  'messages_count' => payload['messages_count'] == nil ? payload['messages_count'] : payload['messages_count'].to_i,
                   'url' => payload['url'],
                   'links' => payload['links'],
               }

data/lib/twilio-ruby/rest/chat/v1/service/user.rb

@@ -287,7 +287,7 @@ module Twilio
                   'is_notifiable' => payload['is_notifiable'],
                   'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                   'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
-                  'joined_channels_count' => payload['joined_channels_count'].to_i,
+                  'joined_channels_count' => payload['joined_channels_count'] == nil ? payload['joined_channels_count'] : payload['joined_channels_count'].to_i,
                   'links' => payload['links'],
                   'url' => payload['url'],
               }

data/lib/twilio-ruby/rest/chat/v1/service.rb

@@ -489,8 +489,8 @@ module Twilio
                 'default_channel_creator_role_sid' => payload['default_channel_creator_role_sid'],
                 'read_status_enabled' => payload['read_status_enabled'],
                 'reachability_enabled' => payload['reachability_enabled'],
-                'typing_indicator_timeout' => payload['typing_indicator_timeout'].to_i,
-                'consumption_report_interval' => payload['consumption_report_interval'].to_i,
+                'typing_indicator_timeout' => payload['typing_indicator_timeout'] == nil ? payload['typing_indicator_timeout'] : payload['typing_indicator_timeout'].to_i,
+                'consumption_report_interval' => payload['consumption_report_interval'] == nil ? payload['consumption_report_interval'] : payload['consumption_report_interval'].to_i,
                 'limits' => payload['limits'],
                 'webhooks' => payload['webhooks'],
                 'pre_webhook_url' => payload['pre_webhook_url'],

data/lib/twilio-ruby/rest/chat/v1.rb

@@ -26,11 +26,12 @@ module Twilio
         # @return [Twilio::REST::Chat::V1::CredentialList]
         def credentials(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @credentials ||= CredentialList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @credentials ||= CredentialList.new self
           else
-            CredentialContext.new(self, sid)
+              CredentialContext.new(self, sid)
           end
         end
 
@@ -41,11 +42,12 @@ module Twilio
         # @return [Twilio::REST::Chat::V1::ServiceList]
         def services(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @services ||= ServiceList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @services ||= ServiceList.new self
           else
-            ServiceContext.new(self, sid)
+              ServiceContext.new(self, sid)
           end
         end
 

data/lib/twilio-ruby/rest/chat/v2/service/channel/message.rb

@@ -344,7 +344,7 @@ module Twilio
                     'was_edited' => payload['was_edited'],
                     'from' => payload['from'],
                     'body' => payload['body'],
-                    'index' => payload['index'].to_i,
+                    'index' => payload['index'] == nil ? payload['index'] : payload['index'].to_i,
                     'type' => payload['type'],
                     'media' => payload['media'],
                     'url' => payload['url'],

data/lib/twilio-ruby/rest/chat/v2/service/channel.rb

@@ -406,8 +406,8 @@ module Twilio
                   'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                   'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
                   'created_by' => payload['created_by'],
-                  'members_count' => payload['members_count'].to_i,
-                  'messages_count' => payload['messages_count'].to_i,
+                  'members_count' => payload['members_count'] == nil ? payload['members_count'] : payload['members_count'].to_i,
+                  'messages_count' => payload['messages_count'] == nil ? payload['messages_count'] : payload['messages_count'].to_i,
                   'url' => payload['url'],
                   'links' => payload['links'],
               }

data/lib/twilio-ruby/rest/chat/v2/service/user/user_channel.rb

@@ -193,9 +193,13 @@ module Twilio
 
               ##
               # Delete the UserChannelInstance
+              # @param [user_channel.WebhookEnabledType] x_twilio_webhook_enabled The
+              #   X-Twilio-Webhook-Enabled HTTP request header
               # @return [Boolean] true if delete succeeds, false otherwise
-              def delete
-                 @version.delete('DELETE', @uri)
+              def delete(x_twilio_webhook_enabled: :unset)
+                headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
+
+                 @version.delete('DELETE', @uri, headers: headers)
               end
 
               ##
@@ -377,9 +381,11 @@ module Twilio
 
               ##
               # Delete the UserChannelInstance
+              # @param [user_channel.WebhookEnabledType] x_twilio_webhook_enabled The
+              #   X-Twilio-Webhook-Enabled HTTP request header
               # @return [Boolean] true if delete succeeds, false otherwise
-              def delete
-                context.delete
+              def delete(x_twilio_webhook_enabled: :unset)
+                context.delete(x_twilio_webhook_enabled: x_twilio_webhook_enabled, )
               end
 
               ##

data/lib/twilio-ruby/rest/chat/v2/service/user.rb

@@ -323,7 +323,7 @@ module Twilio
                   'is_notifiable' => payload['is_notifiable'],
                   'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                   'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
-                  'joined_channels_count' => payload['joined_channels_count'].to_i,
+                  'joined_channels_count' => payload['joined_channels_count'] == nil ? payload['joined_channels_count'] : payload['joined_channels_count'].to_i,
                   'links' => payload['links'],
                   'url' => payload['url'],
               }

data/lib/twilio-ruby/rest/chat/v2/service.rb

@@ -429,15 +429,15 @@ module Twilio
                 'default_channel_creator_role_sid' => payload['default_channel_creator_role_sid'],
                 'read_status_enabled' => payload['read_status_enabled'],
                 'reachability_enabled' => payload['reachability_enabled'],
-                'typing_indicator_timeout' => payload['typing_indicator_timeout'].to_i,
-                'consumption_report_interval' => payload['consumption_report_interval'].to_i,
+                'typing_indicator_timeout' => payload['typing_indicator_timeout'] == nil ? payload['typing_indicator_timeout'] : payload['typing_indicator_timeout'].to_i,
+                'consumption_report_interval' => payload['consumption_report_interval'] == nil ? payload['consumption_report_interval'] : payload['consumption_report_interval'].to_i,
                 'limits' => payload['limits'],
                 'pre_webhook_url' => payload['pre_webhook_url'],
                 'post_webhook_url' => payload['post_webhook_url'],
                 'webhook_method' => payload['webhook_method'],
                 'webhook_filters' => payload['webhook_filters'],
-                'pre_webhook_retry_count' => payload['pre_webhook_retry_count'].to_i,
-                'post_webhook_retry_count' => payload['post_webhook_retry_count'].to_i,
+                'pre_webhook_retry_count' => payload['pre_webhook_retry_count'] == nil ? payload['pre_webhook_retry_count'] : payload['pre_webhook_retry_count'].to_i,
+                'post_webhook_retry_count' => payload['post_webhook_retry_count'] == nil ? payload['post_webhook_retry_count'] : payload['post_webhook_retry_count'].to_i,
                 'notifications' => payload['notifications'],
                 'media' => payload['media'],
                 'url' => payload['url'],

data/lib/twilio-ruby/rest/chat/v2.rb

@@ -25,11 +25,12 @@ module Twilio
         # @return [Twilio::REST::Chat::V2::CredentialList]
         def credentials(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @credentials ||= CredentialList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @credentials ||= CredentialList.new self
           else
-            CredentialContext.new(self, sid)
+              CredentialContext.new(self, sid)
           end
         end
 
@@ -39,11 +40,12 @@ module Twilio
         # @return [Twilio::REST::Chat::V2::ServiceList]
         def services(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @services ||= ServiceList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @services ||= ServiceList.new self
           else
-            ServiceContext.new(self, sid)
+              ServiceContext.new(self, sid)
           end
         end
 

data/lib/twilio-ruby/rest/chat/v3/channel.rb

@@ -0,0 +1,275 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Chat < Domain
+      class V3 < Version
+        class ChannelList < ListResource
+          ##
+          # Initialize the ChannelList
+          # @param [Version] version Version that contains the resource
+          # @return [ChannelList] ChannelList
+          def initialize(version)
+            super(version)
+
+            # Path Solution
+            @solution = {}
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '#<Twilio.Chat.V3.ChannelList>'
+          end
+        end
+
+        class ChannelPage < Page
+          ##
+          # Initialize the ChannelPage
+          # @param [Version] version Version that contains the resource
+          # @param [Response] response Response from the API
+          # @param [Hash] solution Path solution for the resource
+          # @return [ChannelPage] ChannelPage
+          def initialize(version, response, solution)
+            super(version, response)
+
+            # Path Solution
+            @solution = solution
+          end
+
+          ##
+          # Build an instance of ChannelInstance
+          # @param [Hash] payload Payload response from the API
+          # @return [ChannelInstance] ChannelInstance
+          def get_instance(payload)
+            ChannelInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '<Twilio.Chat.V3.ChannelPage>'
+          end
+        end
+
+        class ChannelContext < InstanceContext
+          ##
+          # Initialize the ChannelContext
+          # @param [Version] version Version that contains the resource
+          # @param [String] service_sid The unique SID identifier of the Service.
+          # @param [String] sid A 34 character string that uniquely identifies this Channel.
+          # @return [ChannelContext] ChannelContext
+          def initialize(version, service_sid, sid)
+            super(version)
+
+            # Path Solution
+            @solution = {service_sid: service_sid, sid: sid, }
+            @uri = "/Services/#{@solution[:service_sid]}/Channels/#{@solution[:sid]}"
+          end
+
+          ##
+          # Update the ChannelInstance
+          # @param [channel.ChannelType] type TThe Type for this Channel to migrate to. Can
+          #   only be `private`. Migration to 'public' is not allowed.
+          # @param [String] messaging_service_sid The unique ID of the {Messaging
+          #   Service}[https://www.twilio.com/docs/sms/services/api] this channel belongs to.
+          # @param [channel.WebhookEnabledType] x_twilio_webhook_enabled The
+          #   X-Twilio-Webhook-Enabled HTTP request header
+          # @return [ChannelInstance] Updated ChannelInstance
+          def update(type: :unset, messaging_service_sid: :unset, x_twilio_webhook_enabled: :unset)
+            data = Twilio::Values.of({'Type' => type, 'MessagingServiceSid' => messaging_service_sid, })
+            headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
+
+            payload = @version.update('POST', @uri, data: data, headers: headers)
+
+            ChannelInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid], )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Chat.V3.ChannelContext #{context}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Chat.V3.ChannelContext #{context}>"
+          end
+        end
+
+        class ChannelInstance < InstanceResource
+          ##
+          # Initialize the ChannelInstance
+          # @param [Version] version Version that contains the resource
+          # @param [Hash] payload payload that contains response from Twilio
+          # @param [String] service_sid The unique SID identifier of the Service.
+          # @param [String] sid A 34 character string that uniquely identifies this Channel.
+          # @return [ChannelInstance] ChannelInstance
+          def initialize(version, payload, service_sid: nil, sid: nil)
+            super(version)
+
+            # Marshaled Properties
+            @properties = {
+                'sid' => payload['sid'],
+                'account_sid' => payload['account_sid'],
+                'service_sid' => payload['service_sid'],
+                'friendly_name' => payload['friendly_name'],
+                'unique_name' => payload['unique_name'],
+                'attributes' => payload['attributes'],
+                'type' => payload['type'],
+                'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
+                'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
+                'created_by' => payload['created_by'],
+                'members_count' => payload['members_count'] == nil ? payload['members_count'] : payload['members_count'].to_i,
+                'messages_count' => payload['messages_count'] == nil ? payload['messages_count'] : payload['messages_count'].to_i,
+                'messaging_service_sid' => payload['messaging_service_sid'],
+                'url' => payload['url'],
+            }
+
+            # Context
+            @instance_context = nil
+            @params = {
+                'service_sid' => service_sid || @properties['service_sid'],
+                'sid' => sid || @properties['sid'],
+            }
+          end
+
+          ##
+          # Generate an instance context for the instance, the context is capable of
+          # performing various actions.  All instance actions are proxied to the context
+          # @return [ChannelContext] ChannelContext for this ChannelInstance
+          def context
+            unless @instance_context
+              @instance_context = ChannelContext.new(@version, @params['service_sid'], @params['sid'], )
+            end
+            @instance_context
+          end
+
+          ##
+          # @return [String] The unique string that identifies the resource
+          def sid
+            @properties['sid']
+          end
+
+          ##
+          # @return [String] The SID of the Account that created the resource
+          def account_sid
+            @properties['account_sid']
+          end
+
+          ##
+          # @return [String] The SID of the Service that the resource is associated with
+          def service_sid
+            @properties['service_sid']
+          end
+
+          ##
+          # @return [String] The string that you assigned to describe the resource
+          def friendly_name
+            @properties['friendly_name']
+          end
+
+          ##
+          # @return [String] An application-defined string that uniquely identifies the resource
+          def unique_name
+            @properties['unique_name']
+          end
+
+          ##
+          # @return [String] The JSON string that stores application-specific data
+          def attributes
+            @properties['attributes']
+          end
+
+          ##
+          # @return [channel.ChannelType] The visibility of the channel. Can be: `public` or `private`
+          def type
+            @properties['type']
+          end
+
+          ##
+          # @return [Time] The ISO 8601 date and time in GMT when the resource was created
+          def date_created
+            @properties['date_created']
+          end
+
+          ##
+          # @return [Time] The ISO 8601 date and time in GMT when the resource was last updated
+          def date_updated
+            @properties['date_updated']
+          end
+
+          ##
+          # @return [String] The identity of the User that created the channel
+          def created_by
+            @properties['created_by']
+          end
+
+          ##
+          # @return [String] The number of Members in the Channel
+          def members_count
+            @properties['members_count']
+          end
+
+          ##
+          # @return [String] The number of Messages that have been passed in the Channel
+          def messages_count
+            @properties['messages_count']
+          end
+
+          ##
+          # @return [String] The unique ID of the Messaging Service this channel belongs to.
+          def messaging_service_sid
+            @properties['messaging_service_sid']
+          end
+
+          ##
+          # @return [String] The absolute URL of the Channel resource
+          def url
+            @properties['url']
+          end
+
+          ##
+          # Update the ChannelInstance
+          # @param [channel.ChannelType] type TThe Type for this Channel to migrate to. Can
+          #   only be `private`. Migration to 'public' is not allowed.
+          # @param [String] messaging_service_sid The unique ID of the {Messaging
+          #   Service}[https://www.twilio.com/docs/sms/services/api] this channel belongs to.
+          # @param [channel.WebhookEnabledType] x_twilio_webhook_enabled The
+          #   X-Twilio-Webhook-Enabled HTTP request header
+          # @return [ChannelInstance] Updated ChannelInstance
+          def update(type: :unset, messaging_service_sid: :unset, x_twilio_webhook_enabled: :unset)
+            context.update(
+                type: type,
+                messaging_service_sid: messaging_service_sid,
+                x_twilio_webhook_enabled: x_twilio_webhook_enabled,
+            )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Chat.V3.ChannelInstance #{values}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Chat.V3.ChannelInstance #{values}>"
+          end
+        end
+      end
+    end
+  end
+end