mailhub-sdk 0.1.0

data/lib/Mailhub/contact/client.rb

@@ -0,0 +1,385 @@
+# frozen_string_literal: true
+
+module Mailhub
+  module Contact
+    class Client
+      # @param client [Mailhub::Internal::Http::RawClient]
+      #
+      # @return [void]
+      def initialize(client:)
+        @client = client
+      end
+
+      # @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, nil] :search
+      # @option params [Integer, nil] :segment_id
+      # @option params [String, nil] :sort_by
+      # @option params [String, nil] :sort_direction
+      # @option params [Integer, nil] :page_size
+      # @option params [String, nil] :cursor
+      #
+      # @example
+      #   client.contact.get_contacts
+      #
+      # @return [Mailhub::Types::ContactModelCursorPagedResult]
+      def get_contacts(request_options: {}, **params)
+        params = Mailhub::Internal::Types::Utils.normalize_keys(params)
+        query_params = {}
+        query_params["search"] = params[:search] if params.key?(:search)
+        query_params["segmentId"] = params[:segment_id] if params.key?(:segment_id)
+        query_params["sortBy"] = params[:sort_by] if params.key?(:sort_by)
+        query_params["sortDirection"] = params[:sort_direction] if params.key?(:sort_direction)
+        query_params["pageSize"] = params[:page_size] if params.key?(:page_size)
+        query_params["cursor"] = params[:cursor] if params.key?(:cursor)
+
+        request = Mailhub::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "v1/contacts",
+          query: query_params,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Mailhub::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Mailhub::Types::ContactModelCursorPagedResult.load(response.body)
+        else
+          error_class = Mailhub::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # @param request_options [Hash]
+      # @param params [Mailhub::Contact::Types::CreateContactRequest]
+      # @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
+      #
+      # @example
+      #   client.contact.create_contact
+      #
+      # @return [Mailhub::Types::ContactModel]
+      def create_contact(request_options: {}, **params)
+        params = Mailhub::Internal::Types::Utils.normalize_keys(params)
+        request = Mailhub::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "v1/contacts",
+          body: Mailhub::Contact::Types::CreateContactRequest.new(params).to_h,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Mailhub::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Mailhub::Types::ContactModel.load(response.body)
+        else
+          error_class = Mailhub::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # @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] :guid
+      #
+      # @example
+      #   client.contact.get_contact(guid: "guid")
+      #
+      # @return [Mailhub::Types::ContactModel]
+      def get_contact(request_options: {}, **params)
+        params = Mailhub::Internal::Types::Utils.normalize_keys(params)
+        request = Mailhub::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "v1/contacts/#{URI.encode_uri_component(params[:guid].to_s)}",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Mailhub::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Mailhub::Types::ContactModel.load(response.body)
+        else
+          error_class = Mailhub::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # @param request_options [Hash]
+      # @param params [Mailhub::Contact::Types::UpdateContactRequest]
+      # @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] :guid
+      #
+      # @example
+      #   client.contact.update_contact(guid: "guid")
+      #
+      # @return [Mailhub::Types::ContactModel]
+      def update_contact(request_options: {}, **params)
+        params = Mailhub::Internal::Types::Utils.normalize_keys(params)
+        request_data = Mailhub::Contact::Types::UpdateContactRequest.new(params).to_h
+        non_body_param_names = %w[guid]
+        body = request_data.except(*non_body_param_names)
+
+        request = Mailhub::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "PUT",
+          path: "v1/contacts/#{URI.encode_uri_component(params[:guid].to_s)}",
+          body: body,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Mailhub::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Mailhub::Types::ContactModel.load(response.body)
+        else
+          error_class = Mailhub::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # @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] :guid
+      #
+      # @example
+      #   client.contact.delete_contact(guid: "guid")
+      #
+      # @return [untyped]
+      def delete_contact(request_options: {}, **params)
+        params = Mailhub::Internal::Types::Utils.normalize_keys(params)
+        request = Mailhub::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "DELETE",
+          path: "v1/contacts/#{URI.encode_uri_component(params[:guid].to_s)}",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Mailhub::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        return if code.between?(200, 299)
+
+        error_class = Mailhub::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+
+      # @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] :guid
+      #
+      # @example
+      #   client.contact.block_contact(guid: "guid")
+      #
+      # @return [untyped]
+      def block_contact(request_options: {}, **params)
+        params = Mailhub::Internal::Types::Utils.normalize_keys(params)
+        request = Mailhub::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "v1/contacts/#{URI.encode_uri_component(params[:guid].to_s)}/block",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Mailhub::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        return if code.between?(200, 299)
+
+        error_class = Mailhub::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+
+      # @param request_options [Hash]
+      # @param params [Mailhub::Contact::Types::BlockContactsByGUIDRequest]
+      # @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
+      #
+      # @example
+      #   client.contact.block_contacts
+      #
+      # @return [untyped]
+      def block_contacts(request_options: {}, **params)
+        params = Mailhub::Internal::Types::Utils.normalize_keys(params)
+        request = Mailhub::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "v1/contacts/block",
+          body: Mailhub::Contact::Types::BlockContactsByGUIDRequest.new(params).to_h,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Mailhub::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        return if code.between?(200, 299)
+
+        error_class = Mailhub::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+
+      # @param request_options [Hash]
+      # @param params [Mailhub::Contact::Types::DeleteContactsByGUIDRequest]
+      # @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
+      #
+      # @example
+      #   client.contact.delete_contacts
+      #
+      # @return [untyped]
+      def delete_contacts(request_options: {}, **params)
+        params = Mailhub::Internal::Types::Utils.normalize_keys(params)
+        request = Mailhub::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "v1/contacts/delete",
+          body: Mailhub::Contact::Types::DeleteContactsByGUIDRequest.new(params).to_h,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Mailhub::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        return if code.between?(200, 299)
+
+        error_class = Mailhub::Errors::ResponseError.subclass_for_code(code)
+        raise error_class.new(response.body, code: code)
+      end
+
+      # @param request_options [Hash]
+      # @param params [void]
+      # @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
+      #
+      # @example
+      #   client.contact.import_contacts
+      #
+      # @return [Mailhub::Types::ContactImportModel]
+      def import_contacts(request_options: {}, **params)
+        params = Mailhub::Internal::Types::Utils.normalize_keys(params)
+        body = Internal::Multipart::FormData.new
+
+        body.add_part(params[:file].to_form_data_part(name: "file")) if params[:file]
+        if params[:validate_email_domain]
+          body.add(
+            name: "validateEmailDomain",
+            value: params[:validate_email_domain]
+          )
+        end
+
+        request = Mailhub::Internal::Multipart::Request.new(
+          base_url: request_options[:base_url],
+          method: "POST",
+          path: "v1/contacts/import",
+          body: body,
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Mailhub::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Mailhub::Types::ContactImportModel.load(response.body)
+        else
+          error_class = Mailhub::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+
+      # @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] :job_id
+      #
+      # @example
+      #   client.contact.get_import_job(job_id: "jobId")
+      #
+      # @return [Mailhub::Types::ContactImportJobModel]
+      def get_import_job(request_options: {}, **params)
+        params = Mailhub::Internal::Types::Utils.normalize_keys(params)
+        request = Mailhub::Internal::JSON::Request.new(
+          base_url: request_options[:base_url],
+          method: "GET",
+          path: "v1/contacts/import/#{URI.encode_uri_component(params[:job_id].to_s)}",
+          request_options: request_options
+        )
+        begin
+          response = @client.send(request)
+        rescue Net::HTTPRequestTimeout
+          raise Mailhub::Errors::TimeoutError
+        end
+        code = response.code.to_i
+        if code.between?(200, 299)
+          Mailhub::Types::ContactImportJobModel.load(response.body)
+        else
+          error_class = Mailhub::Errors::ResponseError.subclass_for_code(code)
+          raise error_class.new(response.body, code: code)
+        end
+      end
+    end
+  end
+end

data/lib/Mailhub/contact/types/block_contact_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Mailhub
+  module Contact
+    module Types
+      class BlockContactRequest < Internal::Types::Model
+        field :guid, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/Mailhub/contact/types/block_contacts_by_guid_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Mailhub
+  module Contact
+    module Types
+      class BlockContactsByGUIDRequest < Internal::Types::Model
+        field :guids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/Mailhub/contact/types/create_contact_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Mailhub
+  module Contact
+    module Types
+      class CreateContactRequest < Internal::Types::Model
+        field :email, -> { String }, optional: true, nullable: false
+
+        field :name, -> { String }, optional: true, nullable: false
+
+        field :fields, -> { Internal::Types::Hash[String, Object] }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/Mailhub/contact/types/delete_contact_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Mailhub
+  module Contact
+    module Types
+      class DeleteContactRequest < Internal::Types::Model
+        field :guid, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/Mailhub/contact/types/delete_contacts_by_guid_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Mailhub
+  module Contact
+    module Types
+      class DeleteContactsByGUIDRequest < Internal::Types::Model
+        field :guids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/Mailhub/contact/types/get_contact_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Mailhub
+  module Contact
+    module Types
+      class GetContactRequest < Internal::Types::Model
+        field :guid, -> { String }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/Mailhub/contact/types/get_contacts_request.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Mailhub
+  module Contact
+    module Types
+      class GetContactsRequest < Internal::Types::Model
+        field :search, -> { String }, optional: true, nullable: false
+
+        field :segment_id, -> { Integer }, optional: true, nullable: false, api_name: "segmentId"
+
+        field :sort_by, -> { String }, optional: true, nullable: false, api_name: "sortBy"
+
+        field :sort_direction, -> { String }, optional: true, nullable: false, api_name: "sortDirection"
+
+        field :page_size, -> { Integer }, optional: true, nullable: false, api_name: "pageSize"
+
+        field :cursor, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/Mailhub/contact/types/get_import_job_request.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Mailhub
+  module Contact
+    module Types
+      class GetImportJobRequest < Internal::Types::Model
+        field :job_id, -> { String }, optional: false, nullable: false, api_name: "jobId"
+      end
+    end
+  end
+end

data/lib/Mailhub/contact/types/import_contacts_request.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Mailhub
+  module Contact
+    module Types
+      class ImportContactsRequest < Internal::Types::Model; end
+    end
+  end
+end

data/lib/Mailhub/contact/types/update_contact_request.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Mailhub
+  module Contact
+    module Types
+      class UpdateContactRequest < Internal::Types::Model
+        field :guid, -> { String }, optional: false, nullable: false
+
+        field :email, -> { String }, optional: true, nullable: false
+
+        field :name, -> { String }, optional: true, nullable: false
+
+        field :fields, -> { Internal::Types::Hash[String, Object] }, optional: true, nullable: false
+      end
+    end
+  end
+end