svix 1.56.0 → 1.58.0

data/lib/svix/models/stream_portal_access_in.rb

@@ -0,0 +1,293 @@
+=begin
+#Svix API
+
+#No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+The version of the OpenAPI document: 1.1.1
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.9.0
+
+=end
+
+require 'date'
+require 'time'
+
+module Svix
+  class StreamPortalAccessIn
+    # How long the token will be valid for, in seconds.  Valid values are between 1 hour and 7 days. The default is 7 days.
+    attr_accessor :expiry
+
+    # The set of feature flags the created token will have access to.
+    attr_accessor :feature_flags
+
+    # Whether the app portal should be in read-only mode.
+    attr_accessor :read_only
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'expiry' => :'expiry',
+        :'feature_flags' => :'featureFlags',
+        :'read_only' => :'readOnly'
+      }
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'expiry' => :'Integer',
+        :'feature_flags' => :'Array<String>',
+        :'read_only' => :'Boolean'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+        :'expiry',
+        :'read_only'
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Svix::StreamPortalAccessIn` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!self.class.attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Svix::StreamPortalAccessIn`. Please check the name to make sure it's valid. List of attributes: " + self.class.attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'expiry')
+        self.expiry = attributes[:'expiry']
+      else
+        self.expiry = 604800
+      end
+
+      if attributes.key?(:'feature_flags')
+        if (value = attributes[:'feature_flags']).is_a?(Array)
+          self.feature_flags = value
+        end
+      end
+
+      if attributes.key?(:'read_only')
+        self.read_only = attributes[:'read_only']
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if !@expiry.nil? && @expiry > 604800
+        invalid_properties.push('invalid value for "expiry", must be smaller than or equal to 604800.')
+      end
+
+      if !@expiry.nil? && @expiry < 3600
+        invalid_properties.push('invalid value for "expiry", must be greater than or equal to 3600.')
+      end
+
+      if !@feature_flags.nil? && @feature_flags.length > 25
+        invalid_properties.push('invalid value for "feature_flags", number of items must be less than or equal to 25.')
+      end
+
+      if !@feature_flags.nil? && @feature_flags.length < 1
+        invalid_properties.push('invalid value for "feature_flags", number of items must be greater than or equal to 1.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if !@expiry.nil? && @expiry > 604800
+      return false if !@expiry.nil? && @expiry < 3600
+      return false if !@feature_flags.nil? && @feature_flags.length > 25
+      return false if !@feature_flags.nil? && @feature_flags.length < 1
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] expiry Value to be assigned
+    def expiry=(expiry)
+      if !expiry.nil? && expiry > 604800
+        fail ArgumentError, 'invalid value for "expiry", must be smaller than or equal to 604800.'
+      end
+
+      if !expiry.nil? && expiry < 3600
+        fail ArgumentError, 'invalid value for "expiry", must be greater than or equal to 3600.'
+      end
+
+      @expiry = expiry
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] feature_flags Value to be assigned
+    def feature_flags=(feature_flags)
+      if feature_flags.nil?
+        fail ArgumentError, 'feature_flags cannot be nil'
+      end
+
+      if feature_flags.length > 25
+        fail ArgumentError, 'invalid value for "feature_flags", number of items must be less than or equal to 25.'
+      end
+
+      if feature_flags.length < 1
+        fail ArgumentError, 'invalid value for "feature_flags", number of items must be greater than or equal to 1.'
+      end
+
+      @feature_flags = feature_flags
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          expiry == o.expiry &&
+          feature_flags == o.feature_flags &&
+          read_only == o.read_only
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [expiry, feature_flags, read_only].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Deserializes the data based on type
+    # @param string type Data type
+    # @param string value Value to be deserialized
+    # @return [Object] Deserialized data
+    def self._deserialize(type, value)
+      case type.to_sym
+      when :Time
+        Time.parse(value)
+      when :Date
+        Date.parse(value)
+      when :String
+        value.to_s
+      when :Integer
+        value.to_i
+      when :Float
+        value.to_f
+      when :Boolean
+        if value.to_s =~ /\A(true|t|yes|y|1)\z/i
+          true
+        else
+          false
+        end
+      when :Object
+        # generic object (usually a Hash), return directly
+        value
+      when /\AArray<(?<inner_type>.+)>\z/
+        inner_type = Regexp.last_match[:inner_type]
+        value.map { |v| _deserialize(inner_type, v) }
+      when /\AHash<(?<k_type>.+?), (?<v_type>.+)>\z/
+        k_type = Regexp.last_match[:k_type]
+        v_type = Regexp.last_match[:v_type]
+        {}.tap do |hash|
+          value.each do |k, v|
+            hash[_deserialize(k_type, k)] = _deserialize(v_type, v)
+          end
+        end
+      else # model
+        # models (e.g. Pet) or oneOf
+        klass = Svix.const_get(type)
+        klass.respond_to?(:openapi_any_of) || klass.respond_to?(:openapi_one_of) ? klass.build(value) : klass.build_from_hash(value)
+      end
+    end
+
+    # Returns the string representation of the object
+    # @return [String] String presentation of the object
+    def to_s
+      to_hash.to_s
+    end
+
+    # to_body is an alias to to_hash (backward compatibility)
+    # @return [Hash] Returns the object in the form of hash
+    def to_body
+      to_hash
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+    # Outputs non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    # @param [Object] value Any valid value
+    # @return [Hash] Returns the value in the form of hash
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map { |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+
+  end
+
+end

data/lib/svix/models/template_out.rb

@@ -23,6 +23,7 @@ module Svix
 
     attr_accessor :filter_types
 
+    # The TransformationTemplate's ID.
     attr_accessor :id
 
     attr_accessor :instructions
@@ -35,6 +36,7 @@ module Svix
 
     attr_accessor :name
 
+    # The Organization's ID.
     attr_accessor :org_id
 
     attr_accessor :transformation
@@ -97,7 +99,7 @@ module Svix
         :'id' => :'String',
         :'instructions' => :'String',
         :'instructions_link' => :'String',
-        :'kind' => :'TransformationTemplateKind',
+        :'kind' => :'ConnectorKind',
         :'logo' => :'String',
         :'name' => :'String',
         :'org_id' => :'String',
@@ -235,6 +237,19 @@ module Svix
         invalid_properties.push('invalid value for "id", id cannot be nil.')
       end
 
+      if @id.to_s.length > 34
+        invalid_properties.push('invalid value for "id", the character length must be smaller than or equal to 34.')
+      end
+
+      if @id.to_s.length < 34
+        invalid_properties.push('invalid value for "id", the character length must be great than or equal to 34.')
+      end
+
+      pattern = Regexp.new(/^trtmpl_[A-Za-z0-9]{27}$/)
+      if @id !~ pattern
+        invalid_properties.push("invalid value for \"id\", must conform to the pattern #{pattern}.")
+      end
+
       if @instructions.nil?
         invalid_properties.push('invalid value for "instructions", instructions cannot be nil.')
       end
@@ -255,6 +270,19 @@ module Svix
         invalid_properties.push('invalid value for "org_id", org_id cannot be nil.')
       end
 
+      if @org_id.to_s.length > 31
+        invalid_properties.push('invalid value for "org_id", the character length must be smaller than or equal to 31.')
+      end
+
+      if @org_id.to_s.length < 31
+        invalid_properties.push('invalid value for "org_id", the character length must be great than or equal to 31.')
+      end
+
+      pattern = Regexp.new(/^org_[A-Za-z0-9]{27}$/)
+      if @org_id !~ pattern
+        invalid_properties.push("invalid value for \"org_id\", must conform to the pattern #{pattern}.")
+      end
+
       if @transformation.nil?
         invalid_properties.push('invalid value for "transformation", transformation cannot be nil.')
       end
@@ -276,11 +304,17 @@ module Svix
       return false if !@feature_flag.nil? && @feature_flag !~ Regexp.new(/^[a-zA-Z0-9\-_.]+$/)
       return false if !@filter_types.nil? && @filter_types.length < 1
       return false if @id.nil?
+      return false if @id.to_s.length > 34
+      return false if @id.to_s.length < 34
+      return false if @id !~ Regexp.new(/^trtmpl_[A-Za-z0-9]{27}$/)
       return false if @instructions.nil?
       return false if @kind.nil?
       return false if @logo.nil?
       return false if @name.nil?
       return false if @org_id.nil?
+      return false if @org_id.to_s.length > 31
+      return false if @org_id.to_s.length < 31
+      return false if @org_id !~ Regexp.new(/^org_[A-Za-z0-9]{27}$/)
       return false if @transformation.nil?
       return false if @updated_at.nil?
       true
@@ -311,6 +345,52 @@ module Svix
       @filter_types = filter_types
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] id Value to be assigned
+    def id=(id)
+      if id.nil?
+        fail ArgumentError, 'id cannot be nil'
+      end
+
+      if id.to_s.length > 34
+        fail ArgumentError, 'invalid value for "id", the character length must be smaller than or equal to 34.'
+      end
+
+      if id.to_s.length < 34
+        fail ArgumentError, 'invalid value for "id", the character length must be great than or equal to 34.'
+      end
+
+      pattern = Regexp.new(/^trtmpl_[A-Za-z0-9]{27}$/)
+      if id !~ pattern
+        fail ArgumentError, "invalid value for \"id\", must conform to the pattern #{pattern}."
+      end
+
+      @id = id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] org_id Value to be assigned
+    def org_id=(org_id)
+      if org_id.nil?
+        fail ArgumentError, 'org_id cannot be nil'
+      end
+
+      if org_id.to_s.length > 31
+        fail ArgumentError, 'invalid value for "org_id", the character length must be smaller than or equal to 31.'
+      end
+
+      if org_id.to_s.length < 31
+        fail ArgumentError, 'invalid value for "org_id", the character length must be great than or equal to 31.'
+      end
+
+      pattern = Regexp.new(/^org_[A-Za-z0-9]{27}$/)
+      if org_id !~ pattern
+        fail ArgumentError, "invalid value for \"org_id\", must conform to the pattern #{pattern}."
+      end
+
+      @org_id = org_id
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)

data/lib/svix/models/template_patch.rb

@@ -83,7 +83,7 @@ module Svix
         :'filter_types' => :'Array<String>',
         :'instructions' => :'String',
         :'instructions_link' => :'String',
-        :'kind' => :'TransformationTemplateKind',
+        :'kind' => :'ConnectorKind',
         :'logo' => :'String',
         :'name' => :'String',
         :'transformation' => :'String'

data/lib/svix/models/template_update.rb

@@ -83,7 +83,7 @@ module Svix
         :'filter_types' => :'Array<String>',
         :'instructions' => :'String',
         :'instructions_link' => :'String',
-        :'kind' => :'TransformationTemplateKind',
+        :'kind' => :'ConnectorKind',
         :'logo' => :'String',
         :'name' => :'String',
         :'transformation' => :'String'

data/lib/svix/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Svix
-  VERSION = "1.56.0"
+  VERSION = "1.58.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: svix
 version: !ruby/object:Gem::Version
-  version: 1.56.0
+  version: 1.58.0
 platform: ruby
 authors:
 - Svix
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-01-04 00:00:00.000000000 Z
+date: 2025-02-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -102,20 +102,28 @@ files:
 - lib/svix/internal.rb
 - lib/svix/message_api.rb
 - lib/svix/message_attempt_api.rb
+- lib/svix/models/active_application_out.rb
+- lib/svix/models/active_endpoint_out.rb
 - lib/svix/models/aggregate_event_types_out.rb
+- lib/svix/models/aggregated_event_types.rb
 - lib/svix/models/app_portal_access_in.rb
 - lib/svix/models/app_portal_access_out.rb
 - lib/svix/models/app_usage_stats_in.rb
 - lib/svix/models/app_usage_stats_out.rb
 - lib/svix/models/application_in.rb
+- lib/svix/models/application_message_failure.rb
+- lib/svix/models/application_message_id_pair.rb
 - lib/svix/models/application_out.rb
 - lib/svix/models/application_patch.rb
 - lib/svix/models/application_stats.rb
+- lib/svix/models/application_stats_out.rb
 - lib/svix/models/application_token_expire_in.rb
 - lib/svix/models/attempt_statistics_data.rb
 - lib/svix/models/attempt_statistics_response.rb
 - lib/svix/models/auth_token_out.rb
 - lib/svix/models/azure_blob_storage_config.rb
+- lib/svix/models/background_task_finished_event.rb
+- lib/svix/models/background_task_finished_event2.rb
 - lib/svix/models/background_task_out.rb
 - lib/svix/models/background_task_status.rb
 - lib/svix/models/background_task_type.rb
@@ -125,6 +133,8 @@ files:
 - lib/svix/models/client_secret_jwt_params_in.rb
 - lib/svix/models/completion_choice.rb
 - lib/svix/models/completion_message.rb
+- lib/svix/models/connector_in.rb
+- lib/svix/models/connector_kind.rb
 - lib/svix/models/count_out.rb
 - lib/svix/models/create_stream_in.rb
 - lib/svix/models/create_token_in.rb
@@ -132,6 +142,12 @@ files:
 - lib/svix/models/custom_strings_override.rb
 - lib/svix/models/custom_theme_override.rb
 - lib/svix/models/dashboard_access_out.rb
+- lib/svix/models/data.rb
+- lib/svix/models/data_any_of.rb
+- lib/svix/models/data_any_of1.rb
+- lib/svix/models/data_any_of2.rb
+- lib/svix/models/data_any_of3.rb
+- lib/svix/models/data_any_of4.rb
 - lib/svix/models/duration.rb
 - lib/svix/models/endpoint_created_event.rb
 - lib/svix/models/endpoint_created_event_data.rb
@@ -139,13 +155,18 @@ files:
 - lib/svix/models/endpoint_deleted_event_data.rb
 - lib/svix/models/endpoint_disabled_event.rb
 - lib/svix/models/endpoint_disabled_event_data.rb
+- lib/svix/models/endpoint_disabled_trigger.rb
+- lib/svix/models/endpoint_enabled_event.rb
+- lib/svix/models/endpoint_enabled_event_data.rb
 - lib/svix/models/endpoint_headers_in.rb
 - lib/svix/models/endpoint_headers_out.rb
 - lib/svix/models/endpoint_headers_patch_in.rb
 - lib/svix/models/endpoint_in.rb
 - lib/svix/models/endpoint_message_out.rb
 - lib/svix/models/endpoint_mtls_config_in.rb
+- lib/svix/models/endpoint_mtls_config_out.rb
 - lib/svix/models/endpoint_oauth_config_in.rb
+- lib/svix/models/endpoint_oauth_config_out.rb
 - lib/svix/models/endpoint_out.rb
 - lib/svix/models/endpoint_patch.rb
 - lib/svix/models/endpoint_secret_out.rb
@@ -176,6 +197,7 @@ files:
 - lib/svix/models/event_type_schema_in.rb
 - lib/svix/models/event_type_update.rb
 - lib/svix/models/export_event_type_out.rb
+- lib/svix/models/expung_all_contents_out.rb
 - lib/svix/models/font_size_config.rb
 - lib/svix/models/generate_in.rb
 - lib/svix/models/generate_out.rb
@@ -190,6 +212,7 @@ files:
 - lib/svix/models/integration_out.rb
 - lib/svix/models/integration_update.rb
 - lib/svix/models/kafka_security_protocol_type.rb
+- lib/svix/models/list_response_active_application_out.rb
 - lib/svix/models/list_response_application_out.rb
 - lib/svix/models/list_response_application_stats.rb
 - lib/svix/models/list_response_background_task_out.rb
@@ -224,22 +247,28 @@ files:
 - lib/svix/models/message_events_out.rb
 - lib/svix/models/message_in.rb
 - lib/svix/models/message_out.rb
+- lib/svix/models/message_precheck_in.rb
+- lib/svix/models/message_precheck_out.rb
 - lib/svix/models/message_raw_payload_out.rb
 - lib/svix/models/message_status.rb
 - lib/svix/models/message_subscriber_auth_token_out.rb
 - lib/svix/models/o_auth_payload_in.rb
 - lib/svix/models/o_auth_payload_out.rb
-- lib/svix/models/oauth2_auth_method_in.rb
-- lib/svix/models/oauth2_grant_type_in.rb
+- lib/svix/models/oauth2_auth_method_in_out.rb
+- lib/svix/models/oauth2_grant_type_in_out.rb
 - lib/svix/models/oauth_jws_signing_algorithm.rb
 - lib/svix/models/one_time_token_in.rb
 - lib/svix/models/one_time_token_out.rb
+- lib/svix/models/operational_webhook_endpoint_headers_in.rb
+- lib/svix/models/operational_webhook_endpoint_headers_out.rb
 - lib/svix/models/operational_webhook_endpoint_in.rb
 - lib/svix/models/operational_webhook_endpoint_out.rb
 - lib/svix/models/operational_webhook_endpoint_secret_in.rb
 - lib/svix/models/operational_webhook_endpoint_secret_out.rb
 - lib/svix/models/operational_webhook_endpoint_update.rb
 - lib/svix/models/ordering.rb
+- lib/svix/models/polling_endpoint_message_out.rb
+- lib/svix/models/polling_endpoint_out.rb
 - lib/svix/models/recover_in.rb
 - lib/svix/models/recover_out.rb
 - lib/svix/models/redshift_config.rb
@@ -259,6 +288,7 @@ files:
 - lib/svix/models/sink_otel_v1_config.rb
 - lib/svix/models/sink_out.rb
 - lib/svix/models/sink_payload_format.rb
+- lib/svix/models/sink_secret_out.rb
 - lib/svix/models/sink_status.rb
 - lib/svix/models/sink_status_in.rb
 - lib/svix/models/sink_transform_in.rb
@@ -272,6 +302,7 @@ files:
 - lib/svix/models/stream_in.rb
 - lib/svix/models/stream_out.rb
 - lib/svix/models/stream_patch.rb
+- lib/svix/models/stream_portal_access_in.rb
 - lib/svix/models/stream_sink_in.rb
 - lib/svix/models/stream_sink_in_one_of.rb
 - lib/svix/models/stream_sink_in_one_of1.rb
@@ -283,16 +314,13 @@ files:
 - lib/svix/models/stream_sink_in_one_of7.rb
 - lib/svix/models/stream_sink_out.rb
 - lib/svix/models/stream_sink_patch.rb
-- lib/svix/models/template_in.rb
 - lib/svix/models/template_out.rb
 - lib/svix/models/template_patch.rb
 - lib/svix/models/template_update.rb
 - lib/svix/models/transformation_http_method.rb
 - lib/svix/models/transformation_simulate_in.rb
 - lib/svix/models/transformation_simulate_out.rb
-- lib/svix/models/transformation_template_kind.rb
 - lib/svix/models/validation_error.rb
-- lib/svix/operational_webhook_endpoint_api.rb
 - lib/svix/statistics_api.rb
 - lib/svix/svix.rb
 - lib/svix/util.rb

data/lib/svix/operational_webhook_endpoint_api.rb

@@ -1,37 +0,0 @@
-# frozen_string_literal: true
-
-module Svix
-  class OperationalWebhookEndpointAPI
-    def initialize(api_client)
-      @api = OperationalWebhookEndpointApi.new(api_client)
-    end
-
-    def list(options = {})
-      return @api.v1_endpoint_list(options)
-    end
-
-    def create(endpoint_in, options = {})
-      return @api.v1_endpoint_create(endpoint_in, options)
-    end
-
-    def get(endpoint_id)
-      return @api.v1_endpoint_get(endpoint_id)
-    end
-
-    def update(endpoint_id, endpoint_update)
-      return @api.v1_endpoint_update(endpoint_id, endpoint_update)
-    end
-
-    def delete(endpoint_id)
-      return @api.v1_endpoint_delete(endpoint_id)
-    end
-
-    def get_secret(endpoint_id)
-      return @api.v1_endpoint_get_secret(endpoint_id)
-    end
-
-    def rotate_secret(endpoint_id, endpoint_secret_rotate_in, options = {})
-      return @api.v1_endpoint_rotate_secret(endpoint_id, endpoint_secret_rotate_in, options)
-    end
-  end
-end