celitech 2.0.7 → 2.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d3424f5a55970a683d65659cdd00e6b6ed76433367af2804584ed8d0ae00e531
-  data.tar.gz: e13a30c0f6382ac209e773d18040150bec5cc57b6b19cd349dc34bd7ff4aba48
+  metadata.gz: 46c039c4f1a74210693493b6340e2fc6cb91fdeb88ebe455022f4556da1f8c9c
+  data.tar.gz: '081ea485c281a21f08c03ead1f878d19cdcf8ece3886a96ffe6e59cb87865b87'
 SHA512:
-  metadata.gz: 147b03dcc340c791f2117103fef9939fcf0ab1de63db3b60e30a69b545cc7050648d59ef30f05f49af017a00f61ab8dda8d562addd7b04cdfe152b183c31aa31
-  data.tar.gz: 5a3213b42f42925ee348d79a0f72c20b9ae56bb528a8df67c3edf1080e07a9489b5ec356776c28574fb3fc354438866eedbac56270080755bfea682ee5dcc25d
+  metadata.gz: cb07394925d19f34ff4322110a6025c086c5b3143a7b5f15c0ed7b6f98f2c6d13822fb160df45a382aaa14a3a840e6b18c722cf7fcc0a0f5e8c45bb8be271339
+  data.tar.gz: 5863d3bc26987f89caf0e4feb3f3e00a5d2edfe4b99852d422628f3b6a4f9f0f766cfd2acca39188dcf5565a4fb575fec71a510f2764c87216d50a43d7821420

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -1,17 +1,42 @@
-# Celitech Ruby SDK 2.0.7
+# Celitech Ruby SDK 2.0.10
 
 Welcome to the Celitech SDK documentation. This guide will help you get started with integrating and using the Celitech SDK in your project.
 
 ## Versions
 
-- API version: `2.0.7`
-- SDK version: `2.0.7`
+- API version: `2.0.10`
+- SDK version: `2.0.10`
 
 ## About the API
 
 Welcome to the CELITECH API documentation!
 
-Useful links: [Homepage](https://www.celitech.com) | [Support email](mailto:support@celitech.com) | [Blog](https://www.celitech.com/blog/)
+Useful links: [Homepage](https://www.celitech.com) | [Support email](mailto:devops@celitech.com) | [Blog](https://www.celitech.com/blog/)
+
+# Introduction
+
+This is the reference documentation and schemas for the CELITECH API and webhooks. For tutorials and other documentation please refer to the [CELITECH Documentation](https://docs.celitech.com).
+
+"Partners" refers to online service providers that use our eSIM API. Access levels include Gold, Platinum, and Diamond.
+
+## API
+
+The CELITECH API is designed for use by partner platforms, including both web and mobile applications. It's assumed all endpoint calls are initiated from the backend of an integrated platform.
+
+API URL: `https://api.celitech.net/v1`
+
+## Authentication & Authorization
+
+CELITECH API uses the OAuth 2.0 protocol for authentication and authorization.
+The endpoints are protected using client credentials flow which is based on a token exchange. The token has a defined life span (typically 1 hour), after which a new token must be obtained.
+
+To begin, obtain OAuth 2.0 client credentials ( **CLIENT_ID** & **CLIENT_SECRET** ) from the [CELITECH Dashboard](https://www.dashboard.celitech.com/). Then your client application requests an access token from the CELITECH Authorization Server, extracts a token from the response, and sends the token to the CELITECH API that you want to access.
+
+Security Scheme Type: `OAuth2`
+
+Flow type: `clientCredentials`
+
+Token URL: `https://auth.celitech.net/oauth2/token`
 
 ## Table of Contents
 
@@ -209,12 +234,12 @@ The SDK includes several models that represent the data structures used in API r
 | [GetEsimOkResponse](documentation/models/get_esim_ok_response.md)                                |             |
 | [GetEsimDeviceOkResponse](documentation/models/get_esim_device_ok_response.md)                   |             |
 | [GetEsimHistoryOkResponse](documentation/models/get_esim_history_ok_response.md)                 |             |
+| [SuspendEsimOkResponse](documentation/models/suspend_esim_ok_response.md)                        |             |
 | [TokenOkResponse](documentation/models/token_ok_response.md)                                     |             |
 | [OAuthTokenResponse](documentation/models/o_auth_token_response.md)                              |             |
 | [OAuthTokenRequest](documentation/models/o_auth_token_request.md)                                |             |
 | [GrantType](documentation/models/grant_type.md)                                                  |             |
-| [BadRequest](documentation/models/bad_request.md)                                                |             |
-| [Unauthorized](documentation/models/unauthorized.md)                                             |             |
+| [ErrorResponse](documentation/models/error_response.md)                                          |             |
 
 </details>
 

data/lib/celitech/error.rb

@@ -20,6 +20,14 @@ module Celitech
     end
   end
 
+  # The request never reached the server: connection refused, host unresolvable, socket closed by
+  # the peer, or a failed TLS handshake. The underlying transport exception is on `#cause`.
+  class ConnectionError < Error
+    def initialize(msg = 'Failed to connect')
+      super
+    end
+  end
+
   class ValidationError < Error
     attr_reader :field, :validation_message
 
@@ -30,16 +38,7 @@ module Celitech
     end
   end
 
-  class BadRequestError < APIError
-    attr_reader :data
-
-    def initialize(status, data, body, headers = {})
-      super(status, body, headers)
-      @data = data
-    end
-  end
-
-  class UnauthorizedError < APIError
+  class ErrorResponseError < APIError
     attr_reader :data
 
     def initialize(status, data, body, headers = {})

data/lib/celitech/http/connection.rb

@@ -2,12 +2,42 @@
 
 require 'json'
 require 'net/http'
+require 'openssl'
 require 'time'
 require 'uri'
 
 module Celitech
   module HTTP
     class Connection
+      # Failures that mean the request never reached the server. `SocketError` covers DNS
+      # resolution; `EOFError` is the peer closing mid-exchange; `OpenSSL::SSL::SSLError` is a
+      # handshake or certificate failure. Wrapped as `ConnectionError` so a caller does not have to
+      # rescue Net::HTTP's and Socket's own exception classes to handle an unreachable server.
+      CONNECTION_ERRORS = [
+        SocketError,
+        EOFError,
+        Errno::ECONNREFUSED,
+        Errno::ECONNRESET,
+        Errno::ECONNABORTED,
+        Errno::EHOSTUNREACH,
+        Errno::ENETUNREACH,
+        Errno::EPIPE,
+        Errno::ETIMEDOUT,
+        OpenSSL::SSL::SSLError,
+      ].freeze
+
+      # Net::HTTP's three timeout exceptions, all reachable because a configured timeout is applied
+      # as open_timeout, read_timeout AND write_timeout. Deliberately not widened to their shared
+      # parent `Timeout::Error`, which would also swallow an unrelated `Timeout.timeout` block in
+      # caller code. Wrapped as `TimeoutError` for the same reason as CONNECTION_ERRORS above.
+      # `IO::TimeoutError` is the fourth and is NOT a Net::HTTP class: since Ruby 3.2 an expired
+      # connect deadline surfaces from the IO layer, and it descends from IOError rather than
+      # Timeout::Error, so none of the three above catch it and CONNECTION_ERRORS excludes bare
+      # IOError. Without it a timed-out connect escaped unwrapped on ruby 3.3 -- the version the
+      # gemspec floors at and the e2e image runs -- while raising Net::OpenTimeout on 4.x, so it
+      # looked correct locally. No `defined?` guard: the gemspec requires >= 3.3.
+      TIMEOUT_ERRORS = [Net::OpenTimeout, Net::ReadTimeout, Net::WriteTimeout, IO::TimeoutError].freeze
+
       attr_accessor :default_headers
       attr_reader :base_url, :timeout, :retry_config
 
@@ -55,18 +85,21 @@ module Celitech
         # transport (TLS, timeouts, proxy) — the caller owns those settings.
         @custom_http     = !http_client.nil?
         @http            = http_client || Net::HTTP.new(@uri.host, @uri.port)
-        @default_headers = { 'User-Agent' => 'postman-codegen/2.6.0 celitech/2.0.7 (ruby)' }.merge(default_headers)
+        @default_headers = { 'User-Agent' => 'postman-codegen/3.7.0 celitech/2.0.10 (ruby)' }.merge(default_headers)
         @refresh_manager = refresh_manager
         @mutex           = Mutex.new
         @hook            = Hooks.new
         unless @custom_http
           @http.use_ssl = @uri.scheme == 'https'
+          # Guards ABSENCE, not zero: only nil and false are falsy in Ruby, so `timeout: 0` is
+          # truthy and IS applied, and Net::HTTP reads 0 as "fail immediately" (nil, not 0, is its
+          # no-timeout value). An absent timeout leaves Net::HTTP's own defaults in place.
           if timeout
             @http.open_timeout = timeout
             @http.read_timeout = timeout
           end
         end
-        @http.start unless @http.started?
+        start_connection
       end
 
       def get(path, params = {}, headers = {})
@@ -135,15 +168,17 @@ module Celitech
           @hook.after_response(req, response, params)
           response
         rescue APIError => e
-          if attempts < (@retry_config&.fetch(:attempts, nil) || 3) && %w[GET POST PUT DELETE PATCH HEAD OPTIONS].include?(req.method.upcase) && (e.status >= 500 || e.status == 408 || e.status == 429)
+          if attempts < (@retry_config&.fetch(:attempts, nil) || 3) && %w[GET PUT DELETE HEAD OPTIONS].include?(req.method.upcase) && (e.status >= 500 || e.status == 408 || e.status == 429)
             sleep(retry_after_delay(e) || retry_delay(attempts))
             retry
           end
           @hook.on_error(e, req, params)
           raise
         end
-      rescue Net::ReadTimeout, Net::OpenTimeout => e
+      rescue *TIMEOUT_ERRORS => e
         raise TimeoutError, e.message
+      rescue *CONNECTION_ERRORS => e
+        raise ConnectionError, e.message
       end
 
       def stream_execute(req)
@@ -198,8 +233,10 @@ module Celitech
                 end
               end
             end
-          rescue Net::ReadTimeout, Net::OpenTimeout => e
+          rescue *TIMEOUT_ERRORS => e
             raise TimeoutError, e.message
+          rescue *CONNECTION_ERRORS => e
+            raise ConnectionError, e.message
           end
         end
       end
@@ -278,7 +315,23 @@ module Celitech
         rescue StandardError
           nil
         end
-        @http.start
+        start_connection
+      end
+
+      # The connection is opened eagerly (in initialize) and re-opened on a dropped socket, so this
+      # is the other place a connection-level failure can surface — a refused connection used to
+      # escape the constructor as a bare Errno::ECONNREFUSED.
+      #
+      # Timeouts are wrapped here too, and are reachable from the constructor: Net::HTTP reads
+      # `timeout: 0` as "fail immediately", so opening the connection raises before any request is
+      # made. Without this the SDK's own `TimeoutError` was only raised from `execute`, and a
+      # `timeout: 0` client leaked a bare `Net::OpenTimeout` out of `Client.new`.
+      def start_connection
+        @http.start unless @http.started?
+      rescue *TIMEOUT_ERRORS => e
+        raise TimeoutError, e.message
+      rescue *CONNECTION_ERRORS => e
+        raise ConnectionError, e.message
       end
 
       def set_body(req, body, content_type)

data/lib/celitech/http/oauth_token_manager.rb

@@ -16,10 +16,13 @@ module Celitech
     class OAuthTokenManager
       REFRESH_BUFFER_SECS = 5
 
-      def initialize(client_id:, client_secret:, token_url:)
+      # @param token_url [String] The token endpoint; a relative URL is joined to `base_url`.
+      # @param base_url [String, nil] The URL a relative `token_url` is resolved against.
+      def initialize(client_id:, client_secret:, token_url:, base_url: nil)
         @client_id     = client_id
         @client_secret = client_secret
         @token_url     = token_url
+        @base_url      = base_url
         @access_token  = nil
         @expires_at    = nil
         @mutex         = Mutex.new
@@ -27,6 +30,11 @@ module Celitech
 
       attr_writer :client_id, :client_secret
 
+      # @return [Boolean] Whether both a client ID and a client secret are set.
+      def credentials?
+        [@client_id, @client_secret].none? { |value| value.nil? || value.to_s.empty? }
+      end
+
       def headers
         { 'Authorization' => "Bearer #{token}" }
       end
@@ -49,8 +57,15 @@ module Celitech
         @access_token.nil? || (@expires_at && Time.now + REFRESH_BUFFER_SECS >= @expires_at)
       end
 
+      def token_uri
+        url = @token_url.to_s
+        return URI.parse(url) if @base_url.nil? || url.match?(%r{\A[a-z][a-z0-9+.-]*://}i)
+
+        URI.parse("#{@base_url.to_s.chomp('/')}/#{url.delete_prefix('/')}")
+      end
+
       def fetch_token
-        uri = URI.parse(@token_url)
+        uri = token_uri
         req = Net::HTTP::Post.new(uri.request_uri)
         req.set_form_data(
           grant_type: 'client_credentials',

data/lib/celitech/models/create_purchase_request.rb

@@ -144,6 +144,7 @@ module Celitech
       end
 
       def validate!
+        Validator.validate_string!(@reference_id, 'referenceId', max_length: 255, pattern: /^[a-zA-Z0-9\-_.@+]+$/) unless @reference_id.equal?(::Celitech::Models::UNSET)
         @language&.validate! if !@language.equal?(::Celitech::Models::UNSET) && @language.respond_to?(:validate!)
       end
 

data/lib/celitech/models/create_purchase_v2_request.rb

@@ -145,6 +145,7 @@ module Celitech
 
       def validate!
         Validator.validate_number!(@quantity, 'quantity', min: 1, max: 5) unless @quantity.equal?(::Celitech::Models::UNSET)
+        Validator.validate_string!(@reference_id, 'referenceId', max_length: 255, pattern: /^[a-zA-Z0-9\-_.@+]+$/) unless @reference_id.equal?(::Celitech::Models::UNSET)
         @language&.validate! if !@language.equal?(::Celitech::Models::UNSET) && @language.respond_to?(:validate!)
       end
 

data/lib/celitech/models/{bad_request.rb → error_response.rb}

@@ -2,7 +2,7 @@
 
 module Celitech
   module Models
-    class BadRequest
+    class ErrorResponse
       include ::Celitech::Models::Serializable
       include ::Celitech::Models::OpenModel
 

data/lib/celitech/models/{unauthorized.rb → suspend_esim_ok_response.rb}

@@ -2,7 +2,7 @@
 
 module Celitech
   module Models
-    class Unauthorized
+    class SuspendEsimOkResponse
       include ::Celitech::Models::Serializable
       include ::Celitech::Models::OpenModel
 

data/lib/celitech/models/top_up_esim_request.rb

@@ -135,6 +135,7 @@ module Celitech
 
       def validate!
         Validator.validate_string!(@iccid, 'iccid', min_length: 18, max_length: 22) unless @iccid.equal?(::Celitech::Models::UNSET)
+        Validator.validate_string!(@reference_id, 'referenceId', max_length: 255, pattern: /^[a-zA-Z0-9\-_.@+]+$/) unless @reference_id.equal?(::Celitech::Models::UNSET)
       end
 
       def open_model_extras

data/lib/celitech/serializers/params_serializer.rb

@@ -0,0 +1,182 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'uri'
+
+module Celitech
+  module Serializers
+    # Serializes parameters using OpenAPI-defined styles for query and path parameters.
+    module Params
+      # Returns an array of "key=value" strings for the given query parameter.
+      # Returns an empty array if +value+ is nil.
+      def self.query_part(key, value, style = :form, explode: true)
+        value = normalize(value)
+        return [] if value.nil?
+
+        case style
+        when :space_delimited then space_delimited_parts(key, value, explode)
+        when :pipe_delimited  then pipe_delimited_parts(key, value, explode)
+        when :deep_object     then deep_object_parts(key, value)
+        else                       form_parts(key, value, explode)
+        end
+      end
+
+      # Serializes a path parameter using the "simple" style (RFC 6570 §3.2.2), which is the
+      # OpenAPI default for a path parameter. A scalar is percent-encoded; an array is comma
+      # joined (+explode+ does not change simple-style arrays); an object is comma joined as
+      # "key,value" pairs, or as "key=value" pairs when exploded.
+      def self.simple(value, explode: false)
+        value = normalize(value)
+        return '' if value.nil?
+
+        if value.is_a?(Array)
+          value.compact.map { |v| encode(v) }.join(',')
+        elsif value.is_a?(Hash)
+          pairs = value.compact
+          if explode
+            pairs.map { |k, v| "#{encode(k)}=#{encode(v)}" }.join(',')
+          else
+            pairs.flat_map { |k, v| [encode(k), encode(v)] }.join(',')
+          end
+        else
+          encode(value)
+        end
+      end
+
+      # Serializes a path parameter using the "label" style (RFC 6570 §3.2.5).
+      def self.label(value, explode: false)
+        value = normalize(value)
+        return '' if value.nil?
+
+        if value.is_a?(Array)
+          values = value.compact
+          return '' if values.empty?
+
+          explode ? values.map { |v| ".#{encode(v)}" }.join : ".#{values.map { |v| encode(v) }.join(',')}"
+        elsif value.is_a?(Hash)
+          return '' if value.empty?
+
+          if explode
+            parts = value.filter_map { |k, v| "#{encode(k)}=#{encode(v)}" unless v.nil? }
+            parts.empty? ? '' : ".#{parts.join('.')}"
+          else
+            parts = value.filter_map { |k, v| [encode(k), encode(v)] unless v.nil? }.flatten
+            parts.empty? ? '' : ".#{parts.join(',')}"
+          end
+        else
+          ".#{encode(value)}"
+        end
+      end
+
+      # Serializes a path parameter using the "matrix" style (RFC 6570 §3.2.7).
+      def self.matrix(key, value, explode: false)
+        value = normalize(value)
+        return '' if value.nil?
+
+        if value.is_a?(Array)
+          values = value.compact
+          return '' if values.empty?
+
+          if explode
+            values.map { |v| ";#{key}=#{encode(v)}" }.join
+          else
+            ";#{key}=#{values.map { |v| encode(v) }.join(',')}"
+          end
+        elsif value.is_a?(Hash)
+          return '' if value.empty?
+
+          if explode
+            parts = value.filter_map { |k, v| ";#{encode(k)}=#{encode(v)}" unless v.nil? }
+            parts.empty? ? '' : parts.join
+          else
+            parts = value.filter_map { |k, v| [encode(k), encode(v)] unless v.nil? }.flatten
+            parts.empty? ? '' : ";#{key}=#{parts.join(',')}"
+          end
+        else
+          ";#{key}=#{encode(value)}"
+        end
+      end
+
+      private_class_method def self.form_parts(key, value, explode)
+        if value.is_a?(Array)
+          values = value.compact
+          return [] if values.empty?
+
+          if explode
+            values.map { |v| "#{encode(key)}=#{encode(v)}" }
+          else
+            ["#{encode(key)}=#{values.map { |v| encode(v) }.join(',')}"]
+          end
+        elsif value.is_a?(Hash)
+          return [] if value.empty?
+
+          if explode
+            value.filter_map { |k, v| "#{encode(k)}=#{encode(v)}" unless v.nil? }
+          else
+            parts = value.filter_map { |k, v| [encode(k), encode(v)] unless v.nil? }.flatten
+            parts.empty? ? [] : ["#{encode(key)}=#{parts.join(',')}"]
+          end
+        else
+          ["#{encode(key)}=#{encode(value)}"]
+        end
+      end
+
+      private_class_method def self.space_delimited_parts(key, value, explode)
+        return form_parts(key, value, true) if explode
+        return [] unless value.is_a?(Array)
+
+        values = value.compact
+        values.empty? ? [] : ["#{encode(key)}=#{values.map { |v| encode(v) }.join('%20')}"]
+      end
+
+      private_class_method def self.pipe_delimited_parts(key, value, explode)
+        return form_parts(key, value, true) if explode
+        return [] unless value.is_a?(Array)
+
+        values = value.compact
+        # Pipe delimiter is intentionally not percent-encoded per the OpenAPI spec.
+        values.empty? ? [] : ["#{encode(key)}=#{values.map { |v| encode(v) }.join('|')}"]
+      end
+
+      private_class_method def self.deep_object_parts(key, value)
+        return [] unless value.is_a?(Hash)
+
+        value.filter_map { |k, v| "#{encode(key)}[#{encode(k)}]=#{encode(v)}" unless v.nil? }
+      end
+
+      # Reduces a declared parameter value to the plain Ruby shape the styles above are defined
+      # over: a union to its member, a model to its wire Hash. Without this a model reaches
+      # #encode as an object and is stringified by Ruby's #inspect, which puts a memory address
+      # on the wire instead of the caller's data.
+      private_class_method def self.normalize(value)
+        value = value.value if value.is_a?(Models::UnionType)
+        return to_hash(value) if value.is_a?(Models::Serializable)
+
+        value
+      end
+
+      # Percent-encodes a value using RFC 3986. Spaces are encoded as %20 (not +)
+      # so the result is safe for both query strings and path segments.
+      private_class_method def self.encode(value)
+        # Normalizing again here is for a nested MODEL leaf: the entry points above reduce only the
+        # top-level value, so a model held inside a Hash/Array reaches #encode unreduced. It cannot
+        # be deferred into the JSON branch below, because that branch's own test — "is this a
+        # ::Hash/::Array?" — is only true once the model has been reduced to one. The repeat pass
+        # on an already-plain value is two #is_a? checks; #to_hash runs only for a real model.
+        value = normalize(value)
+        # A style is defined over scalars, a flat array and a flat object only — OpenAPI says
+        # nothing about what a nested array/object leaf looks like. JSON is emitted for it so the
+        # caller's data survives, rather than Ruby's Array#to_s / Hash#to_s rendering.
+        value = ::JSON.generate(value) if value.is_a?(::Hash) || value.is_a?(::Array)
+        URI.encode_www_form_component(value.to_s).gsub('+', '%20')
+      end
+
+      private_class_method def self.to_hash(serializable)
+        serializable.class.wire_keys.each_with_object({}) do |(attr, key), h|
+          val = serializable.attributes[attr]
+          h[key] = val unless val.nil? || val.equal?(Models::UNSET)
+        end
+      end
+    end
+  end
+end

data/lib/celitech/services/destinations.rb

@@ -22,12 +22,9 @@ module Celitech
       result
     rescue APIError => e
       case e.status
-      when 400
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::BadRequest.from_hash(e.body) : nil
-        raise ::Celitech::BadRequestError.new(e.status, parsed, e.body, e.headers)
-      when 401
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::Unauthorized.from_hash(e.body) : nil
-        raise ::Celitech::UnauthorizedError.new(e.status, parsed, e.body, e.headers)
+      when 400, 401, 409, 422, 503
+        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::ErrorResponse.from_hash(e.body) : nil
+        raise ::Celitech::ErrorResponseError.new(e.status, parsed, e.body, e.headers)
       end
       raise
     end

data/lib/celitech/services/e_sim.rb

@@ -27,12 +27,9 @@ module Celitech
       result
     rescue APIError => e
       case e.status
-      when 400
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::BadRequest.from_hash(e.body) : nil
-        raise ::Celitech::BadRequestError.new(e.status, parsed, e.body, e.headers)
-      when 401
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::Unauthorized.from_hash(e.body) : nil
-        raise ::Celitech::UnauthorizedError.new(e.status, parsed, e.body, e.headers)
+      when 400, 401, 409, 422, 503
+        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::ErrorResponse.from_hash(e.body) : nil
+        raise ::Celitech::ErrorResponseError.new(e.status, parsed, e.body, e.headers)
       end
       raise
     end
@@ -42,19 +39,16 @@ module Celitech
       headers = config_headers(config).merge(resolve_config(config)&.additional_headers || {})
       Validator.validate_string!(iccid, 'iccid', min_length: 18, max_length: 22)
       conn = resolve_connection(config)
-      response = conn.get("/esim/#{iccid}/device", {}, headers)
+      response = conn.get("/esim/#{Serializers::Params.simple(iccid, explode: false)}/device", {}, headers)
       return response if !config.equal?(NO_OVERRIDE) && config&.return_raw
       result = ::Celitech::Models::GetEsimDeviceOkResponse.from_hash(response.body)
       result&.validate! if resolve_config(config)&.enable_response_validation
       result
     rescue APIError => e
       case e.status
-      when 400
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::BadRequest.from_hash(e.body) : nil
-        raise ::Celitech::BadRequestError.new(e.status, parsed, e.body, e.headers)
-      when 401
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::Unauthorized.from_hash(e.body) : nil
-        raise ::Celitech::UnauthorizedError.new(e.status, parsed, e.body, e.headers)
+      when 400, 401, 409, 422, 503
+        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::ErrorResponse.from_hash(e.body) : nil
+        raise ::Celitech::ErrorResponseError.new(e.status, parsed, e.body, e.headers)
       end
       raise
     end
@@ -64,19 +58,40 @@ module Celitech
       headers = config_headers(config).merge(resolve_config(config)&.additional_headers || {})
       Validator.validate_string!(iccid, 'iccid', min_length: 18, max_length: 22)
       conn = resolve_connection(config)
-      response = conn.get("/esim/#{iccid}/history", {}, headers)
+      response = conn.get("/esim/#{Serializers::Params.simple(iccid, explode: false)}/history", {}, headers)
       return response if !config.equal?(NO_OVERRIDE) && config&.return_raw
       result = ::Celitech::Models::GetEsimHistoryOkResponse.from_hash(response.body)
       result&.validate! if resolve_config(config)&.enable_response_validation
       result
     rescue APIError => e
       case e.status
-      when 400
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::BadRequest.from_hash(e.body) : nil
-        raise ::Celitech::BadRequestError.new(e.status, parsed, e.body, e.headers)
-      when 401
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::Unauthorized.from_hash(e.body) : nil
-        raise ::Celitech::UnauthorizedError.new(e.status, parsed, e.body, e.headers)
+      when 400, 401, 409, 422, 503
+        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::ErrorResponse.from_hash(e.body) : nil
+        raise ::Celitech::ErrorResponseError.new(e.status, parsed, e.body, e.headers)
+      end
+      raise
+    end
+
+    # Suspend eSIM
+    def suspend_esim(iccid:, idempotency_key: nil, config: NO_OVERRIDE)
+      headers = config_headers(config).merge(
+        {
+          'Idempotency-Key' => idempotency_key,
+        }.compact,
+      ).merge(resolve_config(config)&.additional_headers || {})
+      Validator.validate_string!(iccid, 'iccid', min_length: 18, max_length: 22)
+      Validator.validate_string!(idempotency_key, 'Idempotency-Key', min_length: 1, max_length: 255)
+      conn = resolve_connection(config)
+      response = conn.post("/esim/#{Serializers::Params.simple(iccid, explode: false)}/suspend", nil, headers: headers)
+      return response if !config.equal?(NO_OVERRIDE) && config&.return_raw
+      result = ::Celitech::Models::SuspendEsimOkResponse.from_hash(response.body)
+      result&.validate! if resolve_config(config)&.enable_response_validation
+      result
+    rescue APIError => e
+      case e.status
+      when 400, 401, 409, 422, 503
+        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::ErrorResponse.from_hash(e.body) : nil
+        raise ::Celitech::ErrorResponseError.new(e.status, parsed, e.body, e.headers)
       end
       raise
     end

data/lib/celitech/services/i_frame.rb

@@ -22,12 +22,9 @@ module Celitech
       result
     rescue APIError => e
       case e.status
-      when 400
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::BadRequest.from_hash(e.body) : nil
-        raise ::Celitech::BadRequestError.new(e.status, parsed, e.body, e.headers)
-      when 401
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::Unauthorized.from_hash(e.body) : nil
-        raise ::Celitech::UnauthorizedError.new(e.status, parsed, e.body, e.headers)
+      when 400, 401, 409, 422, 503
+        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::ErrorResponse.from_hash(e.body) : nil
+        raise ::Celitech::ErrorResponseError.new(e.status, parsed, e.body, e.headers)
       end
       raise
     end

data/lib/celitech/services/packages.rb

@@ -45,12 +45,9 @@ module Celitech
       result
     rescue APIError => e
       case e.status
-      when 400
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::BadRequest.from_hash(e.body) : nil
-        raise ::Celitech::BadRequestError.new(e.status, parsed, e.body, e.headers)
-      when 401
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::Unauthorized.from_hash(e.body) : nil
-        raise ::Celitech::UnauthorizedError.new(e.status, parsed, e.body, e.headers)
+      when 400, 401, 409, 422, 503
+        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::ErrorResponse.from_hash(e.body) : nil
+        raise ::Celitech::ErrorResponseError.new(e.status, parsed, e.body, e.headers)
       end
       raise
     end

data/lib/celitech/services/purchases.rb

@@ -12,8 +12,13 @@ module Celitech
     end
 
     # Create Purchase V2
-    def create_purchase_v2(body:, config: NO_OVERRIDE)
-      headers = config_headers(config).merge(resolve_config(config)&.additional_headers || {})
+    def create_purchase_v2(body:, idempotency_key: nil, config: NO_OVERRIDE)
+      headers = config_headers(config).merge(
+        {
+          'Idempotency-Key' => idempotency_key,
+        }.compact,
+      ).merge(resolve_config(config)&.additional_headers || {})
+      Validator.validate_string!(idempotency_key, 'Idempotency-Key', min_length: 1, max_length: 255)
       body.validate! if body.respond_to?(:validate!)
       conn = resolve_connection(config)
       response = conn.post('/purchases/v2', body, headers: headers)
@@ -23,12 +28,9 @@ module Celitech
       result
     rescue APIError => e
       case e.status
-      when 400
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::BadRequest.from_hash(e.body) : nil
-        raise ::Celitech::BadRequestError.new(e.status, parsed, e.body, e.headers)
-      when 401
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::Unauthorized.from_hash(e.body) : nil
-        raise ::Celitech::UnauthorizedError.new(e.status, parsed, e.body, e.headers)
+      when 400, 401, 409, 422, 503
+        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::ErrorResponse.from_hash(e.body) : nil
+        raise ::Celitech::ErrorResponseError.new(e.status, parsed, e.body, e.headers)
       end
       raise
     end
@@ -70,20 +72,22 @@ module Celitech
       result
     rescue APIError => e
       case e.status
-      when 400
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::BadRequest.from_hash(e.body) : nil
-        raise ::Celitech::BadRequestError.new(e.status, parsed, e.body, e.headers)
-      when 401
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::Unauthorized.from_hash(e.body) : nil
-        raise ::Celitech::UnauthorizedError.new(e.status, parsed, e.body, e.headers)
+      when 400, 401, 409, 422, 503
+        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::ErrorResponse.from_hash(e.body) : nil
+        raise ::Celitech::ErrorResponseError.new(e.status, parsed, e.body, e.headers)
       end
       raise
     end
 
     # Create Purchase
     # @deprecated
-    def create_purchase(body:, config: NO_OVERRIDE)
-      headers = config_headers(config).merge(resolve_config(config)&.additional_headers || {})
+    def create_purchase(body:, idempotency_key: nil, config: NO_OVERRIDE)
+      headers = config_headers(config).merge(
+        {
+          'Idempotency-Key' => idempotency_key,
+        }.compact,
+      ).merge(resolve_config(config)&.additional_headers || {})
+      Validator.validate_string!(idempotency_key, 'Idempotency-Key', min_length: 1, max_length: 255)
       body.validate! if body.respond_to?(:validate!)
       conn = resolve_connection(config)
       response = conn.post('/purchases', body, headers: headers)
@@ -93,19 +97,21 @@ module Celitech
       result
     rescue APIError => e
       case e.status
-      when 400
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::BadRequest.from_hash(e.body) : nil
-        raise ::Celitech::BadRequestError.new(e.status, parsed, e.body, e.headers)
-      when 401
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::Unauthorized.from_hash(e.body) : nil
-        raise ::Celitech::UnauthorizedError.new(e.status, parsed, e.body, e.headers)
+      when 400, 401, 409, 422, 503
+        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::ErrorResponse.from_hash(e.body) : nil
+        raise ::Celitech::ErrorResponseError.new(e.status, parsed, e.body, e.headers)
       end
       raise
     end
 
     # Top-up eSIM
-    def top_up_esim(body:, config: NO_OVERRIDE)
-      headers = config_headers(config).merge(resolve_config(config)&.additional_headers || {})
+    def top_up_esim(body:, idempotency_key: nil, config: NO_OVERRIDE)
+      headers = config_headers(config).merge(
+        {
+          'Idempotency-Key' => idempotency_key,
+        }.compact,
+      ).merge(resolve_config(config)&.additional_headers || {})
+      Validator.validate_string!(idempotency_key, 'Idempotency-Key', min_length: 1, max_length: 255)
       body.validate! if body.respond_to?(:validate!)
       conn = resolve_connection(config)
       response = conn.post('/purchases/topup', body, headers: headers)
@@ -115,19 +121,21 @@ module Celitech
       result
     rescue APIError => e
       case e.status
-      when 400
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::BadRequest.from_hash(e.body) : nil
-        raise ::Celitech::BadRequestError.new(e.status, parsed, e.body, e.headers)
-      when 401
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::Unauthorized.from_hash(e.body) : nil
-        raise ::Celitech::UnauthorizedError.new(e.status, parsed, e.body, e.headers)
+      when 400, 401, 409, 422, 503
+        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::ErrorResponse.from_hash(e.body) : nil
+        raise ::Celitech::ErrorResponseError.new(e.status, parsed, e.body, e.headers)
       end
       raise
     end
 
     # Edit Purchase
-    def edit_purchase(body:, config: NO_OVERRIDE)
-      headers = config_headers(config).merge(resolve_config(config)&.additional_headers || {})
+    def edit_purchase(body:, idempotency_key: nil, config: NO_OVERRIDE)
+      headers = config_headers(config).merge(
+        {
+          'Idempotency-Key' => idempotency_key,
+        }.compact,
+      ).merge(resolve_config(config)&.additional_headers || {})
+      Validator.validate_string!(idempotency_key, 'Idempotency-Key', min_length: 1, max_length: 255)
       body.validate! if body.respond_to?(:validate!)
       conn = resolve_connection(config)
       response = conn.post('/purchases/edit', body, headers: headers)
@@ -137,12 +145,9 @@ module Celitech
       result
     rescue APIError => e
       case e.status
-      when 400
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::BadRequest.from_hash(e.body) : nil
-        raise ::Celitech::BadRequestError.new(e.status, parsed, e.body, e.headers)
-      when 401
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::Unauthorized.from_hash(e.body) : nil
-        raise ::Celitech::UnauthorizedError.new(e.status, parsed, e.body, e.headers)
+      when 400, 401, 409, 422, 503
+        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::ErrorResponse.from_hash(e.body) : nil
+        raise ::Celitech::ErrorResponseError.new(e.status, parsed, e.body, e.headers)
       end
       raise
     end
@@ -151,19 +156,17 @@ module Celitech
     def get_purchase_consumption(purchase_id:, config: NO_OVERRIDE)
       headers = config_headers(config).merge(resolve_config(config)&.additional_headers || {})
       conn = resolve_connection(config)
-      response = conn.get("/purchases/#{purchase_id}/consumption", {}, headers)
+      url = "/purchases/#{Serializers::Params.simple(purchase_id, explode: false)}/consumption"
+      response = conn.get(url, {}, headers)
       return response if !config.equal?(NO_OVERRIDE) && config&.return_raw
       result = ::Celitech::Models::GetPurchaseConsumptionOkResponse.from_hash(response.body)
       result&.validate! if resolve_config(config)&.enable_response_validation
       result
     rescue APIError => e
       case e.status
-      when 400
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::BadRequest.from_hash(e.body) : nil
-        raise ::Celitech::BadRequestError.new(e.status, parsed, e.body, e.headers)
-      when 401
-        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::Unauthorized.from_hash(e.body) : nil
-        raise ::Celitech::UnauthorizedError.new(e.status, parsed, e.body, e.headers)
+      when 400, 401, 409, 422, 503
+        parsed = e.body.is_a?(Hash) ? ::Celitech::Models::ErrorResponse.from_hash(e.body) : nil
+        raise ::Celitech::ErrorResponseError.new(e.status, parsed, e.body, e.headers)
       end
       raise
     end

data/lib/celitech/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Celitech
-  VERSION = '2.0.7'
+  VERSION = '2.0.10'
 end

data/lib/celitech.rb

@@ -7,6 +7,7 @@ require_relative 'celitech/models/union_type'
 require_relative 'celitech/models/open_model'
 require_relative 'celitech/serializers/json_serializer'
 require_relative 'celitech/serializers/form_serializer'
+require_relative 'celitech/serializers/params_serializer'
 require_relative 'celitech/http/hooks'
 require_relative 'celitech/http/connection'
 require_relative 'celitech/http/response'
@@ -46,12 +47,12 @@ require_relative 'celitech/models/device'
 require_relative 'celitech/models/get_esim_history_ok_response'
 require_relative 'celitech/models/get_esim_history_ok_response_esim'
 require_relative 'celitech/models/history'
+require_relative 'celitech/models/suspend_esim_ok_response'
 require_relative 'celitech/models/token_ok_response'
 require_relative 'celitech/models/o_auth_token_response'
 require_relative 'celitech/models/o_auth_token_request'
 require_relative 'celitech/models/grant_type'
-require_relative 'celitech/models/bad_request'
-require_relative 'celitech/models/unauthorized'
+require_relative 'celitech/models/error_response'
 require_relative 'celitech/services/destinations'
 require_relative 'celitech/services/packages'
 require_relative 'celitech/services/purchases'

metadata

@@ -1,15 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: celitech
 version: !ruby/object:Gem::Version
-  version: 2.0.7
+  version: 2.0.10
 platform: ruby
 authors:
 - CELITECH
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-13 00:00:00.000000000 Z
+date: 2026-10-18 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -66,13 +94,28 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 1.26.1
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.19'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.19'
 description:
 email:
-- support@celitech.com
+- devops@celitech.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE
 - README.md
 - lib/celitech.rb
 - lib/celitech/client.rb
@@ -83,7 +126,6 @@ files:
 - lib/celitech/http/hooks.rb
 - lib/celitech/http/oauth_token_manager.rb
 - lib/celitech/http/response.rb
-- lib/celitech/models/bad_request.rb
 - lib/celitech/models/create_purchase_ok_response.rb
 - lib/celitech/models/create_purchase_ok_response_profile.rb
 - lib/celitech/models/create_purchase_ok_response_purchase.rb
@@ -98,6 +140,7 @@ files:
 - lib/celitech/models/device.rb
 - lib/celitech/models/edit_purchase_ok_response.rb
 - lib/celitech/models/edit_purchase_request.rb
+- lib/celitech/models/error_response.rb
 - lib/celitech/models/get_esim_device_ok_response.rb
 - lib/celitech/models/get_esim_history_ok_response.rb
 - lib/celitech/models/get_esim_history_ok_response_esim.rb
@@ -117,15 +160,16 @@ files:
 - lib/celitech/models/purchases.rb
 - lib/celitech/models/purchases_esim.rb
 - lib/celitech/models/serializable.rb
+- lib/celitech/models/suspend_esim_ok_response.rb
 - lib/celitech/models/token_ok_response.rb
 - lib/celitech/models/top_up_esim_ok_response.rb
 - lib/celitech/models/top_up_esim_ok_response_profile.rb
 - lib/celitech/models/top_up_esim_ok_response_purchase.rb
 - lib/celitech/models/top_up_esim_request.rb
-- lib/celitech/models/unauthorized.rb
 - lib/celitech/models/union_type.rb
 - lib/celitech/serializers/form_serializer.rb
 - lib/celitech/serializers/json_serializer.rb
+- lib/celitech/serializers/params_serializer.rb
 - lib/celitech/services/destinations.rb
 - lib/celitech/services/e_sim.rb
 - lib/celitech/services/i_frame.rb
@@ -158,5 +202,21 @@ rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: 'Welcome to the CELITECH API documentation!  Useful links: [Homepage](https://www.celitech.com)
-  | [Support email](mailto:support@celitech.com) | [Blog](https://www.celitech.com/blog/)'
+  | [Support email](mailto:devops@celitech.com) | [Blog](https://www.celitech.com/blog/)  #
+  Introduction  This is the reference documentation and schemas for the CELITECH API
+  and webhooks. For tutorials and other documentation please refer to the [CELITECH
+  Documentation](https://docs.celitech.com).  "Partners" refers to online service
+  providers that use our eSIM API. Access levels include Gold, Platinum, and Diamond.  ##
+  API  The CELITECH API is designed for use by partner platforms, including both web
+  and mobile applications. It''s assumed all endpoint calls are initiated from the
+  backend of an integrated platform.  API URL: `https://api.celitech.net/v1`  ## Authentication
+  & Authorization CELITECH API uses the OAuth 2.0 protocol for authentication and
+  authorization. The endpoints are protected using client credentials flow which is
+  based on a token exchange. The token has a defined life span (typically 1 hour),
+  after which a new token must be obtained.  To begin, obtain OAuth 2.0 client credentials
+  ( **CLIENT_ID** & **CLIENT_SECRET** ) from the [CELITECH Dashboard](https://www.dashboard.celitech.com/).
+  Then your client application requests an access token from the CELITECH Authorization
+  Server, extracts a token from the response, and sends the token to the CELITECH
+  API that you want to access.  Security Scheme Type: `OAuth2`  Flow type: `clientCredentials`  Token
+  URL: `https://auth.celitech.net/oauth2/token`'
 test_files: []