celitech 2.0.7

data/lib/celitech/services/purchases.rb

@@ -0,0 +1,195 @@
+# frozen_string_literal: true
+
+module Celitech
+  class Purchases
+    NO_OVERRIDE = Object.new.freeze
+    private_constant :NO_OVERRIDE
+
+    def initialize(connection, config = nil, token_manager: nil)
+      @connection = connection
+      @config = config
+      @token_manager = token_manager
+    end
+
+    # Create Purchase V2
+    def create_purchase_v2(body:, config: NO_OVERRIDE)
+      headers = config_headers(config).merge(resolve_config(config)&.additional_headers || {})
+      body.validate! if body.respond_to?(:validate!)
+      conn = resolve_connection(config)
+      response = conn.post('/purchases/v2', body, headers: headers)
+      return response if !config.equal?(NO_OVERRIDE) && config&.return_raw
+      result = response.body.map { |item| ::Celitech::Models::CreatePurchaseV2OkResponse.from_hash(item) }
+      result&.each { |item| item&.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)
+      end
+      raise
+    end
+
+    # List Purchases
+    def list_purchases(
+      purchase_id: nil,
+      iccid: nil,
+      after_date: nil,
+      before_date: nil,
+      email: nil,
+      reference_id: nil,
+      after_cursor: nil,
+      limit: nil,
+      after: nil,
+      before: nil,
+      config: NO_OVERRIDE
+    )
+      query_params = {
+        'purchaseId' => purchase_id,
+        'iccid' => iccid,
+        'afterDate' => after_date,
+        'beforeDate' => before_date,
+        'email' => email,
+        'referenceId' => reference_id,
+        'afterCursor' => after_cursor,
+        'limit' => limit,
+        'after' => after,
+        'before' => before,
+      }.compact
+      query_params = query_params.merge(resolve_config(config)&.additional_query_parameters || {})
+      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('/purchases', query_params, headers)
+      return response if !config.equal?(NO_OVERRIDE) && config&.return_raw
+      result = ::Celitech::Models::ListPurchasesOkResponse.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)
+      end
+      raise
+    end
+
+    # Create Purchase
+    # @deprecated
+    def create_purchase(body:, config: NO_OVERRIDE)
+      headers = config_headers(config).merge(resolve_config(config)&.additional_headers || {})
+      body.validate! if body.respond_to?(:validate!)
+      conn = resolve_connection(config)
+      response = conn.post('/purchases', body, headers: headers)
+      return response if !config.equal?(NO_OVERRIDE) && config&.return_raw
+      result = ::Celitech::Models::CreatePurchaseOkResponse.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)
+      end
+      raise
+    end
+
+    # Top-up eSIM
+    def top_up_esim(body:, config: NO_OVERRIDE)
+      headers = config_headers(config).merge(resolve_config(config)&.additional_headers || {})
+      body.validate! if body.respond_to?(:validate!)
+      conn = resolve_connection(config)
+      response = conn.post('/purchases/topup', body, headers: headers)
+      return response if !config.equal?(NO_OVERRIDE) && config&.return_raw
+      result = ::Celitech::Models::TopUpEsimOkResponse.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)
+      end
+      raise
+    end
+
+    # Edit Purchase
+    def edit_purchase(body:, config: NO_OVERRIDE)
+      headers = config_headers(config).merge(resolve_config(config)&.additional_headers || {})
+      body.validate! if body.respond_to?(:validate!)
+      conn = resolve_connection(config)
+      response = conn.post('/purchases/edit', body, headers: headers)
+      return response if !config.equal?(NO_OVERRIDE) && config&.return_raw
+      result = ::Celitech::Models::EditPurchaseOkResponse.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)
+      end
+      raise
+    end
+
+    # Get Purchase Consumption
+    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)
+      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)
+      end
+      raise
+    end
+
+    private
+
+    def config_headers(_override_config)
+      return {} unless @token_manager
+
+      @token_manager.headers
+    end
+
+    def resolve_connection(override_config)
+      cfg = override_config.equal?(NO_OVERRIDE) ? @config : override_config
+      return @connection unless cfg&.base_url || cfg&.timeout || cfg&.retry_config
+
+      HTTP::Connection.new(
+        cfg.base_url || @connection.base_url,
+        @connection.default_headers,
+        timeout: cfg.timeout || @connection.timeout,
+        retry_config: cfg.retry_config || @connection.retry_config,
+      )
+    end
+
+    def resolve_config(override_config)
+      override_config.equal?(NO_OVERRIDE) ? @config : override_config
+    end
+  end
+end

data/lib/celitech/validator.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Celitech
+  module Validator
+    class << self
+      def validate_string!(value, field, min_length: nil, max_length: nil, pattern: nil)
+        return if value.nil?
+
+        raise ValidationError.new(field, "must be at least #{min_length} characters long") if min_length && value.to_s.length < min_length
+        raise ValidationError.new(field, "must be at most #{max_length} characters long") if max_length && value.to_s.length > max_length
+        return unless pattern && !value.to_s.match?(pattern)
+
+        raise ValidationError.new(field, "must match pattern #{pattern.source}")
+      end
+
+      def validate_number!(value, field, min: nil, min_exclusive: nil, max: nil, max_exclusive: nil,
+                           multiple_of: nil)
+        return if value.nil?
+
+        raise ValidationError.new(field, "must be >= #{min}") if min && value < min
+        raise ValidationError.new(field, "must be > #{min_exclusive}") if min_exclusive && value <= min_exclusive
+        raise ValidationError.new(field, "must be <= #{max}") if max && value > max
+        raise ValidationError.new(field, "must be < #{max_exclusive}") if max_exclusive && value >= max_exclusive
+        return unless multiple_of && (value % multiple_of).abs > Float::EPSILON * multiple_of.abs
+
+        raise ValidationError.new(field, "must be a multiple of #{multiple_of}")
+      end
+
+      alias validate_integer! validate_number!
+
+      def validate_array!(value, field, min_items: nil, max_items: nil, unique_items: false)
+        return if value.nil?
+
+        raise ValidationError.new(field, "must have at least #{min_items} items") if min_items && value.length < min_items
+        raise ValidationError.new(field, "must have at most #{max_items} items") if max_items && value.length > max_items
+        return unless unique_items && value.length != value.uniq.length
+
+        raise ValidationError.new(field, 'must contain unique items')
+      end
+    end
+  end
+end

data/lib/celitech/version.rb

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

data/lib/celitech.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require_relative 'celitech/version'
+require_relative 'celitech/error'
+require_relative 'celitech/models/serializable'
+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/http/hooks'
+require_relative 'celitech/http/connection'
+require_relative 'celitech/http/response'
+require_relative 'celitech/http/oauth_token_manager'
+require_relative 'celitech/environment'
+require_relative 'celitech/config'
+require_relative 'celitech/validator'
+require_relative 'celitech/models/list_destinations_ok_response'
+require_relative 'celitech/models/destinations'
+require_relative 'celitech/models/list_packages_ok_response'
+require_relative 'celitech/models/packages'
+require_relative 'celitech/models/create_purchase_v2_ok_response'
+require_relative 'celitech/models/create_purchase_v2_ok_response_purchase'
+require_relative 'celitech/models/create_purchase_v2_ok_response_profile'
+require_relative 'celitech/models/create_purchase_v2_request'
+require_relative 'celitech/models/create_purchase_v2_request_language'
+require_relative 'celitech/models/list_purchases_ok_response'
+require_relative 'celitech/models/purchases'
+require_relative 'celitech/models/package'
+require_relative 'celitech/models/purchases_esim'
+require_relative 'celitech/models/create_purchase_ok_response'
+require_relative 'celitech/models/create_purchase_ok_response_purchase'
+require_relative 'celitech/models/create_purchase_ok_response_profile'
+require_relative 'celitech/models/create_purchase_request'
+require_relative 'celitech/models/create_purchase_request_language'
+require_relative 'celitech/models/top_up_esim_ok_response'
+require_relative 'celitech/models/top_up_esim_ok_response_purchase'
+require_relative 'celitech/models/top_up_esim_ok_response_profile'
+require_relative 'celitech/models/top_up_esim_request'
+require_relative 'celitech/models/edit_purchase_ok_response'
+require_relative 'celitech/models/edit_purchase_request'
+require_relative 'celitech/models/get_purchase_consumption_ok_response'
+require_relative 'celitech/models/get_esim_ok_response'
+require_relative 'celitech/models/get_esim_ok_response_esim'
+require_relative 'celitech/models/get_esim_device_ok_response'
+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/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/services/destinations'
+require_relative 'celitech/services/packages'
+require_relative 'celitech/services/purchases'
+require_relative 'celitech/services/e_sim'
+require_relative 'celitech/services/i_frame'
+require_relative 'celitech/services/o_auth'
+require_relative 'celitech/client'
+
+module Celitech
+end

metadata

@@ -0,0 +1,162 @@
+--- !ruby/object:Gem::Specification
+name: celitech
+version: !ruby/object:Gem::Version
+  version: 2.0.7
+platform: ruby
+authors:
+- CELITECH
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-09-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.85.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.85.1
+- !ruby/object:Gem::Dependency
+  name: rubocop-ast
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.49.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.49.1
+- !ruby/object:Gem::Dependency
+  name: rubocop-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.39.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.39.1
+- !ruby/object:Gem::Dependency
+  name: rubocop-performance
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.26.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.26.1
+description:
+email:
+- support@celitech.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/celitech.rb
+- lib/celitech/client.rb
+- lib/celitech/config.rb
+- lib/celitech/environment.rb
+- lib/celitech/error.rb
+- lib/celitech/http/connection.rb
+- 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
+- lib/celitech/models/create_purchase_request.rb
+- lib/celitech/models/create_purchase_request_language.rb
+- lib/celitech/models/create_purchase_v2_ok_response.rb
+- lib/celitech/models/create_purchase_v2_ok_response_profile.rb
+- lib/celitech/models/create_purchase_v2_ok_response_purchase.rb
+- lib/celitech/models/create_purchase_v2_request.rb
+- lib/celitech/models/create_purchase_v2_request_language.rb
+- lib/celitech/models/destinations.rb
+- lib/celitech/models/device.rb
+- lib/celitech/models/edit_purchase_ok_response.rb
+- lib/celitech/models/edit_purchase_request.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
+- lib/celitech/models/get_esim_ok_response.rb
+- lib/celitech/models/get_esim_ok_response_esim.rb
+- lib/celitech/models/get_purchase_consumption_ok_response.rb
+- lib/celitech/models/grant_type.rb
+- lib/celitech/models/history.rb
+- lib/celitech/models/list_destinations_ok_response.rb
+- lib/celitech/models/list_packages_ok_response.rb
+- lib/celitech/models/list_purchases_ok_response.rb
+- lib/celitech/models/o_auth_token_request.rb
+- lib/celitech/models/o_auth_token_response.rb
+- lib/celitech/models/open_model.rb
+- lib/celitech/models/package.rb
+- lib/celitech/models/packages.rb
+- lib/celitech/models/purchases.rb
+- lib/celitech/models/purchases_esim.rb
+- lib/celitech/models/serializable.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/services/destinations.rb
+- lib/celitech/services/e_sim.rb
+- lib/celitech/services/i_frame.rb
+- lib/celitech/services/o_auth.rb
+- lib/celitech/services/packages.rb
+- lib/celitech/services/purchases.rb
+- lib/celitech/validator.rb
+- lib/celitech/version.rb
+homepage: https://github.com/Celitech/celitech
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+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/)'
+test_files: []