wavix-ruby-sdk 1.0.0

data/lib/wavix/buy/countries/client.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Wavix
+  module Buy
+    module Countries
+      class Client
+        # @param client [Wavix::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Returns a list of countries where phone numbers are available.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [Boolean, nil] :text_enabled_only
+        #
+        # @return [Wavix::Buy::Countries::Types::ListCountriesResponse]
+        def list(request_options: {}, **params)
+          params = Wavix::Internal::Types::Utils.normalize_keys(params)
+          query_params = {}
+          query_params["text_enabled_only"] = params[:text_enabled_only] if params.key?(:text_enabled_only)
+
+          request = Wavix::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "GET",
+            path: "v1/buy/countries",
+            query: query_params,
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Wavix::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            Wavix::Buy::Countries::Types::ListCountriesResponse.load(response.body)
+          else
+            error_class = Wavix::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/wavix/buy/countries/types/list_countries_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Wavix
+  module Buy
+    module Countries
+      module Types
+        class ListCountriesRequest < Internal::Types::Model
+          field :text_enabled_only, -> { Internal::Types::Boolean }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/wavix/buy/countries/types/list_countries_response.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Wavix
+  module Buy
+    module Countries
+      module Types
+        class ListCountriesResponse < Internal::Types::Model
+          field :countries, -> { Internal::Types::Array[Wavix::Types::Country] }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/wavix/buy/numbers/client.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Wavix
+  module Buy
+    module Numbers
+      class Client
+        # @param client [Wavix::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Returns a paginated list of phone numbers available for purchase in the specified city.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [Integer] :country_id
+        # @option params [Integer] :city_id
+        # @option params [Boolean, nil] :text_enabled_only
+        # @option params [Integer, nil] :page
+        # @option params [Integer, nil] :per_page
+        #
+        # @return [Wavix::Buy::Numbers::Types::ListNumbersResponse]
+        def list(request_options: {}, **params)
+          params = Wavix::Internal::Types::Utils.normalize_keys(params)
+          query_params = {}
+          query_params["text_enabled_only"] = params[:text_enabled_only] if params.key?(:text_enabled_only)
+          query_params["page"] = params[:page] if params.key?(:page)
+          query_params["per_page"] = params[:per_page] if params.key?(:per_page)
+
+          request = Wavix::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "GET",
+            path: "v1/buy/countries/#{URI.encode_uri_component(params[:country_id].to_s)}/cities/#{URI.encode_uri_component(params[:city_id].to_s)}/dids",
+            query: query_params,
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Wavix::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            Wavix::Buy::Numbers::Types::ListNumbersResponse.load(response.body)
+          else
+            error_class = Wavix::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/wavix/buy/numbers/types/list_numbers_request.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Wavix
+  module Buy
+    module Numbers
+      module Types
+        class ListNumbersRequest < Internal::Types::Model
+          field :country_id, -> { Integer }, optional: false, nullable: false
+
+          field :city_id, -> { Integer }, optional: false, nullable: false
+
+          field :text_enabled_only, -> { Internal::Types::Boolean }, optional: true, nullable: false
+
+          field :page, -> { Integer }, optional: true, nullable: false
+
+          field :per_page, -> { Integer }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/wavix/buy/numbers/types/list_numbers_response.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Wavix
+  module Buy
+    module Numbers
+      module Types
+        class ListNumbersResponse < Internal::Types::Model
+          field :dids, -> { Internal::Types::Array[Wavix::Types::AvailableNumber] }, optional: false, nullable: false
+
+          field :pagination, -> { Wavix::Types::Pagination }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/wavix/buy/region_cities/client.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Wavix
+  module Buy
+    module RegionCities
+      class Client
+        # @param client [Wavix::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Returns a list of cities in the specified region for countries where `has_provinces_or_states` is `true`.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [Integer] :country_id
+        # @option params [Integer] :region_id
+        # @option params [Boolean, nil] :text_enabled_only
+        #
+        # @return [Wavix::Buy::RegionCities::Types::ListRegionCitiesResponse]
+        def list(request_options: {}, **params)
+          params = Wavix::Internal::Types::Utils.normalize_keys(params)
+          query_params = {}
+          query_params["text_enabled_only"] = params[:text_enabled_only] if params.key?(:text_enabled_only)
+
+          request = Wavix::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "GET",
+            path: "v1/buy/countries/#{URI.encode_uri_component(params[:country_id].to_s)}/regions/#{URI.encode_uri_component(params[:region_id].to_s)}/cities",
+            query: query_params,
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Wavix::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            Wavix::Buy::RegionCities::Types::ListRegionCitiesResponse.load(response.body)
+          else
+            error_class = Wavix::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/wavix/buy/region_cities/types/list_region_cities_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Wavix
+  module Buy
+    module RegionCities
+      module Types
+        class ListRegionCitiesRequest < Internal::Types::Model
+          field :country_id, -> { Integer }, optional: false, nullable: false
+
+          field :region_id, -> { Integer }, optional: false, nullable: false
+
+          field :text_enabled_only, -> { Internal::Types::Boolean }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/wavix/buy/region_cities/types/list_region_cities_response.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Wavix
+  module Buy
+    module RegionCities
+      module Types
+        class ListRegionCitiesResponse < Internal::Types::Model
+          field :cities, -> { Internal::Types::Array[Wavix::Types::City] }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/wavix/buy/regions/client.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Wavix
+  module Buy
+    module Regions
+      class Client
+        # @param client [Wavix::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Returns a list of regions (states or provinces) for countries where `has_provinces_or_states` is `true`.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [Integer] :country_id
+        # @option params [Boolean, nil] :text_enabled_only
+        #
+        # @return [Wavix::Buy::Regions::Types::ListRegionsResponse]
+        def list(request_options: {}, **params)
+          params = Wavix::Internal::Types::Utils.normalize_keys(params)
+          query_params = {}
+          query_params["text_enabled_only"] = params[:text_enabled_only] if params.key?(:text_enabled_only)
+
+          request = Wavix::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "GET",
+            path: "v1/buy/countries/#{URI.encode_uri_component(params[:country_id].to_s)}/regions",
+            query: query_params,
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Wavix::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            Wavix::Buy::Regions::Types::ListRegionsResponse.load(response.body)
+          else
+            error_class = Wavix::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/wavix/buy/regions/types/list_regions_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Wavix
+  module Buy
+    module Regions
+      module Types
+        class ListRegionsRequest < Internal::Types::Model
+          field :country_id, -> { Integer }, optional: false, nullable: false
+
+          field :text_enabled_only, -> { Internal::Types::Boolean }, optional: true, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/wavix/buy/regions/types/list_regions_response.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Wavix
+  module Buy
+    module Regions
+      module Types
+        class ListRegionsResponse < Internal::Types::Model
+          field :regions, -> { Internal::Types::Array[Wavix::Types::Region] }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/wavix/call_control/audio/client.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module Wavix
+  module CallControl
+    module Audio
+      class Client
+        # @param client [Wavix::Internal::Http::RawClient]
+        #
+        # @return [void]
+        def initialize(client:)
+          @client = client
+        end
+
+        # Plays an audio prompt into the active call identified by `id`.
+        #
+        # @param request_options [Hash]
+        # @param params [Wavix::CallControl::Audio::Types::CallAudioPlayRequest]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :id
+        #
+        # @return [Wavix::Types::SuccessResponse]
+        def play(request_options: {}, **params)
+          params = Wavix::Internal::Types::Utils.normalize_keys(params)
+          request_data = Wavix::CallControl::Audio::Types::CallAudioPlayRequest.new(params).to_h
+          non_body_param_names = %w[id]
+          body = request_data.except(*non_body_param_names)
+
+          request = Wavix::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "POST",
+            path: "v1/calls/#{URI.encode_uri_component(params[:id].to_s)}/play",
+            body: body,
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Wavix::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            Wavix::Types::SuccessResponse.load(response.body)
+          else
+            error_class = Wavix::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+
+        # Stops audio playback in the active call identified by `id`.
+        #
+        # @param request_options [Hash]
+        # @param params [Hash]
+        # @option request_options [String] :base_url
+        # @option request_options [Hash{String => Object}] :additional_headers
+        # @option request_options [Hash{String => Object}] :additional_query_parameters
+        # @option request_options [Hash{String => Object}] :additional_body_parameters
+        # @option request_options [Integer] :timeout_in_seconds
+        # @option params [String] :id
+        #
+        # @return [Wavix::Types::SuccessResponse]
+        def stop(request_options: {}, **params)
+          params = Wavix::Internal::Types::Utils.normalize_keys(params)
+          request = Wavix::Internal::JSON::Request.new(
+            base_url: request_options[:base_url],
+            method: "DELETE",
+            path: "v1/calls/#{URI.encode_uri_component(params[:id].to_s)}/audio",
+            request_options: request_options
+          )
+          begin
+            response = @client.send(request)
+          rescue Net::HTTPRequestTimeout
+            raise Wavix::Errors::TimeoutError
+          end
+          code = response.code.to_i
+          if code.between?(200, 299)
+            Wavix::Types::SuccessResponse.load(response.body)
+          else
+            error_class = Wavix::Errors::ResponseError.subclass_for_code(code)
+            raise error_class.new(response.body, code: code)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/wavix/call_control/audio/types/call_audio_play_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Wavix
+  module CallControl
+    module Audio
+      module Types
+        class CallAudioPlayRequest < Internal::Types::Model
+          field :id, -> { String }, optional: false, nullable: false
+
+          field :audio_file, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end

data/lib/wavix/call_control/audio/types/stop_audio_request.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Wavix
+  module CallControl
+    module Audio
+      module Types
+        class StopAudioRequest < Internal::Types::Model
+          field :id, -> { String }, optional: false, nullable: false
+        end
+      end
+    end
+  end
+end