seatschart 0.1.0

data/lib/seatschart/models/put_api_events_by_event_id_sales_rules_request_quotas_inner.rb

@@ -0,0 +1,418 @@
+=begin
+#SeatsChart API
+
+#Seat inventory and locking API for B2B2C integrations. Authenticate using `x-api-key` (partners) or `Authorization: Bearer` with an HS256 JWT.
+
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.11.0
+
+=end
+
+require 'date'
+require 'time'
+
+module SeatsChart
+  class PutApiEventsByEventIdSalesRulesRequestQuotasInner
+    attr_accessor :id
+
+    attr_accessor :label
+
+    # Ticket type ids counted by this quota (e.g. [\"meia\"]).
+    attr_accessor :ticket_types
+
+    # Share of the event capacity (0.4 = 40%, Lei 12.933).
+    attr_accessor :max_share
+
+    # Absolute ticket count; with maxShare the lower limit applies.
+    attr_accessor :max_count
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'id' => :'id',
+        :'label' => :'label',
+        :'ticket_types' => :'ticketTypes',
+        :'max_share' => :'maxShare',
+        :'max_count' => :'maxCount'
+      }
+    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
+      {
+        :'id' => :'String',
+        :'label' => :'String',
+        :'ticket_types' => :'Array<String>',
+        :'max_share' => :'Float',
+        :'max_count' => :'Integer'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    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 `SeatsChart::PutApiEventsByEventIdSalesRulesRequestQuotasInner` 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 `SeatsChart::PutApiEventsByEventIdSalesRulesRequestQuotasInner`. 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?(:'id')
+        self.id = attributes[:'id']
+      else
+        self.id = nil
+      end
+
+      if attributes.key?(:'label')
+        self.label = attributes[:'label']
+      else
+        self.label = nil
+      end
+
+      if attributes.key?(:'ticket_types')
+        if (value = attributes[:'ticket_types']).is_a?(Array)
+          self.ticket_types = value
+        end
+      else
+        self.ticket_types = nil
+      end
+
+      if attributes.key?(:'max_share')
+        self.max_share = attributes[:'max_share']
+      end
+
+      if attributes.key?(:'max_count')
+        self.max_count = attributes[:'max_count']
+      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 @id.nil?
+        invalid_properties.push('invalid value for "id", id cannot be nil.')
+      end
+
+      if @id.to_s.length > 64
+        invalid_properties.push('invalid value for "id", the character length must be smaller than or equal to 64.')
+      end
+
+      if @id.to_s.length < 1
+        invalid_properties.push('invalid value for "id", the character length must be great than or equal to 1.')
+      end
+
+      pattern = Regexp.new(/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,63}$/)
+      if @id !~ pattern
+        invalid_properties.push("invalid value for \"id\", must conform to the pattern #{pattern}.")
+      end
+
+      if @label.nil?
+        invalid_properties.push('invalid value for "label", label cannot be nil.')
+      end
+
+      if @label.to_s.length > 64
+        invalid_properties.push('invalid value for "label", the character length must be smaller than or equal to 64.')
+      end
+
+      if @label.to_s.length < 1
+        invalid_properties.push('invalid value for "label", the character length must be great than or equal to 1.')
+      end
+
+      if @ticket_types.nil?
+        invalid_properties.push('invalid value for "ticket_types", ticket_types cannot be nil.')
+      end
+
+      if @ticket_types.length > 16
+        invalid_properties.push('invalid value for "ticket_types", number of items must be less than or equal to 16.')
+      end
+
+      if @ticket_types.length < 1
+        invalid_properties.push('invalid value for "ticket_types", number of items must be greater than or equal to 1.')
+      end
+
+      if !@max_share.nil? && @max_share > 1
+        invalid_properties.push('invalid value for "max_share", must be smaller than or equal to 1.')
+      end
+
+      if !@max_count.nil? && @max_count > 1000000
+        invalid_properties.push('invalid value for "max_count", must be smaller than or equal to 1000000.')
+      end
+
+      if !@max_count.nil? && @max_count < 0
+        invalid_properties.push('invalid value for "max_count", must be greater than or equal to 0.')
+      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 @id.nil?
+      return false if @id.to_s.length > 64
+      return false if @id.to_s.length < 1
+      return false if @id !~ Regexp.new(/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,63}$/)
+      return false if @label.nil?
+      return false if @label.to_s.length > 64
+      return false if @label.to_s.length < 1
+      return false if @ticket_types.nil?
+      return false if @ticket_types.length > 16
+      return false if @ticket_types.length < 1
+      return false if !@max_share.nil? && @max_share > 1
+      return false if !@max_count.nil? && @max_count > 1000000
+      return false if !@max_count.nil? && @max_count < 0
+      true
+    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 > 64
+        fail ArgumentError, 'invalid value for "id", the character length must be smaller than or equal to 64.'
+      end
+
+      if id.to_s.length < 1
+        fail ArgumentError, 'invalid value for "id", the character length must be great than or equal to 1.'
+      end
+
+      pattern = Regexp.new(/^[A-Za-z0-9][A-Za-z0-9_.:-]{0,63}$/)
+      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] label Value to be assigned
+    def label=(label)
+      if label.nil?
+        fail ArgumentError, 'label cannot be nil'
+      end
+
+      if label.to_s.length > 64
+        fail ArgumentError, 'invalid value for "label", the character length must be smaller than or equal to 64.'
+      end
+
+      if label.to_s.length < 1
+        fail ArgumentError, 'invalid value for "label", the character length must be great than or equal to 1.'
+      end
+
+      @label = label
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] ticket_types Value to be assigned
+    def ticket_types=(ticket_types)
+      if ticket_types.nil?
+        fail ArgumentError, 'ticket_types cannot be nil'
+      end
+
+      if ticket_types.length > 16
+        fail ArgumentError, 'invalid value for "ticket_types", number of items must be less than or equal to 16.'
+      end
+
+      if ticket_types.length < 1
+        fail ArgumentError, 'invalid value for "ticket_types", number of items must be greater than or equal to 1.'
+      end
+
+      @ticket_types = ticket_types
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] max_share Value to be assigned
+    def max_share=(max_share)
+      if max_share.nil?
+        fail ArgumentError, 'max_share cannot be nil'
+      end
+
+      if max_share > 1
+        fail ArgumentError, 'invalid value for "max_share", must be smaller than or equal to 1.'
+      end
+
+      @max_share = max_share
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] max_count Value to be assigned
+    def max_count=(max_count)
+      if max_count.nil?
+        fail ArgumentError, 'max_count cannot be nil'
+      end
+
+      if max_count > 1000000
+        fail ArgumentError, 'invalid value for "max_count", must be smaller than or equal to 1000000.'
+      end
+
+      if max_count < 0
+        fail ArgumentError, 'invalid value for "max_count", must be greater than or equal to 0.'
+      end
+
+      @max_count = max_count
+    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 &&
+          id == o.id &&
+          label == o.label &&
+          ticket_types == o.ticket_types &&
+          max_share == o.max_share &&
+          max_count == o.max_count
+    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
+      [id, label, ticket_types, max_share, max_count].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 = SeatsChart.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/seatschart/retry.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+# Retry and idempotency helpers for the SeatsChart Ruby client.
+# Copied into the generated gem (lib/seatschart/retry.rb) and required from lib/seatschart.rb by
+# scripts/generate-server-sdks.sh.
+#
+# Throttled (429) and unavailable (503) responses are retried with exponential backoff and full jitter,
+# honouring Retry-After. Only requests that are safe to repeat are retried: idempotent methods (GET, HEAD,
+# OPTIONS, PUT, DELETE) and requests carrying an Idempotency-Key header, which is resent unchanged so the
+# API replays the stored outcome instead of applying it twice.
+#
+#   SeatsChart.configure { |c| c.api_key['x-api-key'] = ENV['SEATSCHART_KEY'] }
+#   SeatsChart::Retry.policy = SeatsChart::Retry::Policy.new(max_attempts: 5)   # optional
+#   api.reserve(body, header_params: SeatsChart::Retry.idempotency_headers('order-42'))
+require 'securerandom'
+require 'time'
+
+module SeatsChart
+  module Retry
+    IDEMPOTENCY_KEY_HEADER = 'Idempotency-Key'
+    IDEMPOTENT_METHODS = %w[GET HEAD OPTIONS PUT DELETE].freeze
+
+    # A fresh key for one logical operation; reuse it for every retry of that operation.
+    def self.new_idempotency_key
+      SecureRandom.uuid
+    end
+
+    def self.idempotency_headers(key = nil)
+      { IDEMPOTENCY_KEY_HEADER => key || new_idempotency_key }
+    end
+
+    def self.retry_safe?(method, headers)
+      return true if IDEMPOTENT_METHODS.include?(method.to_s.upcase)
+
+      (headers || {}).any? { |name, value| name.to_s.casecmp?('idempotency-key') && !value.to_s.strip.empty? }
+    end
+
+    # Retry-After in seconds (delta-seconds or HTTP date); nil when absent or invalid.
+    def self.parse_retry_after(value, now = Time.now)
+      return nil if value.nil? || value.to_s.strip.empty?
+
+      raw = value.to_s.strip
+      return Float(raw) if raw.match?(/\A\d+(\.\d+)?\z/)
+
+      [Time.httpdate(raw) - now, 0.0].max
+    rescue ArgumentError
+      nil
+    end
+
+    def self.header(headers, name)
+      return nil if headers.nil?
+
+      pair = headers.to_h.find { |k, _| k.to_s.casecmp?(name) }
+      value = pair && pair[1]
+      value.is_a?(Array) ? value.first : value
+    end
+
+    class Policy
+      attr_reader :max_attempts, :base_delay, :max_delay, :max_retry_after, :statuses
+
+      def initialize(max_attempts: 4, base_delay: 0.25, max_delay: 8.0, max_retry_after: 30.0, statuses: [429, 503],
+                     sleeper: ->(seconds) { sleep(seconds) }, random: -> { rand })
+        raise ArgumentError, 'max_attempts must be >= 1' if max_attempts < 1
+
+        @max_attempts = max_attempts
+        @base_delay = base_delay
+        @max_delay = max_delay
+        @max_retry_after = max_retry_after
+        @statuses = statuses
+        @sleeper = sleeper
+        @random = random
+      end
+
+      # Seconds to wait before retry number attempt (1-based); nil when Retry-After is too long.
+      def delay(attempt, retry_after)
+        return(retry_after > max_retry_after ? nil : retry_after) unless retry_after.nil?
+
+        ceiling = [max_delay, base_delay * (2**[attempt - 1, 0].max)].min
+        @random.call * ceiling
+      end
+
+      def wait(seconds)
+        @sleeper.call(seconds)
+      end
+    end
+
+    class << self
+      attr_writer :policy
+
+      def policy
+        @policy ||= Policy.new
+      end
+    end
+
+    # Prepended to the generated ApiClient: repeats call_api on retryable ApiErrors.
+    module ApiClientExtension
+      def call_api(http_method, path, opts = {})
+        policy = SeatsChart::Retry.policy
+        attempt = 1
+        begin
+          super
+        rescue SeatsChart::ApiError => e
+          raise unless attempt < policy.max_attempts && policy.statuses.include?(e.code.to_i) &&
+                       SeatsChart::Retry.retry_safe?(http_method, opts[:header_params])
+
+          wait = policy.delay(attempt, SeatsChart::Retry.parse_retry_after(SeatsChart::Retry.header(e.response_headers, 'Retry-After')))
+          raise if wait.nil?
+
+          policy.wait(wait)
+          attempt += 1
+          retry
+        end
+      end
+    end
+  end
+
+  ApiClient.prepend(Retry::ApiClientExtension) if const_defined?(:ApiClient)
+end

data/lib/seatschart/version.rb

@@ -0,0 +1,15 @@
+=begin
+#SeatsChart API
+
+#Seat inventory and locking API for B2B2C integrations. Authenticate using `x-api-key` (partners) or `Authorization: Bearer` with an HS256 JWT.
+
+The version of the OpenAPI document: 1.0.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.11.0
+
+=end
+
+module SeatsChart
+  VERSION = '0.1.0'
+end