merge_ruby_client 0.0.1

data/lib/merge_ruby_client/crm/contacts/client.rb

@@ -0,0 +1,485 @@
+# frozen_string_literal: true
+
+require_relative "../../../requests"
+require "date"
+require_relative "types/contacts_list_request_expand"
+require_relative "../types/paginated_contact_list"
+require_relative "../types/contact_request"
+require_relative "../types/crm_contact_response"
+require_relative "types/contacts_retrieve_request_expand"
+require_relative "../types/contact"
+require_relative "../types/patched_contact_request"
+require_relative "../types/ignore_common_model_request"
+require_relative "../types/meta_response"
+require_relative "../types/paginated_remote_field_class_list"
+require "async"
+
+module Merge
+  module Crm
+    class ContactsClient
+      attr_reader :request_client
+
+      # @param request_client [RequestClient]
+      # @return [Crm::ContactsClient]
+      def initialize(request_client:)
+        # @type [RequestClient]
+        @request_client = request_client
+      end
+
+      # Returns a list of `Contact` objects.
+      #
+      # @param account_id [String] If provided, will only return contacts with this account.
+      # @param created_after [DateTime] If provided, will only return objects created after this datetime.
+      # @param created_before [DateTime] If provided, will only return objects created before this datetime.
+      # @param cursor [String] The pagination cursor value.
+      # @param email_addresses [String] If provided, will only return contacts matching the email addresses; multiple email_addresses can be separated by commas.
+      # @param expand [CONTACTS_LIST_REQUEST_EXPAND] Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
+      # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
+      # @param include_remote_fields [Boolean] Whether to include all remote fields, including fields that Merge did not map to common models, in a normalized format.
+      # @param modified_after [DateTime] If provided, only objects synced by Merge after this date time will be returned.
+      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be returned.
+      # @param page_size [Integer] Number of results to return per page.
+      # @param phone_numbers [String] If provided, will only return contacts matching the phone numbers; multiple phone numbers can be separated by commas.
+      # @param remote_id [String] The API provider's ID for the given object.
+      # @param request_options [RequestOptions]
+      # @return [Crm::PaginatedContactList]
+      def list(account_id: nil, created_after: nil, created_before: nil, cursor: nil, email_addresses: nil,
+               expand: nil, include_deleted_data: nil, include_remote_data: nil, include_remote_fields: nil, modified_after: nil, modified_before: nil, page_size: nil, phone_numbers: nil, remote_id: nil, request_options: nil)
+        response = @request_client.conn.get("/api/crm/v1/contacts") do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+          req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "account_id": account_id,
+            "created_after": created_after,
+            "created_before": created_before,
+            "cursor": cursor,
+            "email_addresses": email_addresses,
+            "expand": expand,
+            "include_deleted_data": include_deleted_data,
+            "include_remote_data": include_remote_data,
+            "include_remote_fields": include_remote_fields,
+            "modified_after": modified_after,
+            "modified_before": modified_before,
+            "page_size": page_size,
+            "phone_numbers": phone_numbers,
+            "remote_id": remote_id
+          }.compact
+        end
+        Crm::PaginatedContactList.from_json(json_object: response.body)
+      end
+
+      # Creates a `Contact` object with the given values.
+      #
+      # @param is_debug_mode [Boolean] Whether to include debug fields (such as log file links) in the response.
+      # @param run_async [Boolean] Whether or not third-party updates should be run asynchronously.
+      # @param model [Hash] Request of type Crm::ContactRequest, as a Hash
+      #   * :first_name (String)
+      #   * :last_name (String)
+      #   * :account (Hash)
+      #   * :owner (Hash)
+      #   * :addresses (Array<Crm::AddressRequest>)
+      #   * :email_addresses (Array<Crm::EmailAddressRequest>)
+      #   * :phone_numbers (Array<Crm::PhoneNumberRequest>)
+      #   * :last_activity_at (DateTime)
+      #   * :integration_params (Hash{String => String})
+      #   * :linked_account_params (Hash{String => String})
+      #   * :remote_fields (Array<Crm::RemoteFieldRequest>)
+      # @param request_options [RequestOptions]
+      # @return [Crm::CrmContactResponse]
+      def create(model:, is_debug_mode: nil, run_async: nil, request_options: nil)
+        response = @request_client.conn.post("/api/crm/v1/contacts") do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+          req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "is_debug_mode": is_debug_mode,
+            "run_async": run_async
+          }.compact
+          req.body = { **(request_options&.additional_body_parameters || {}), model: model }.compact
+        end
+        Crm::CrmContactResponse.from_json(json_object: response.body)
+      end
+
+      # Returns a `Contact` object with the given `id`.
+      #
+      # @param id [String]
+      # @param expand [CONTACTS_RETRIEVE_REQUEST_EXPAND] Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
+      # @param include_remote_fields [Boolean] Whether to include all remote fields, including fields that Merge did not map to common models, in a normalized format.
+      # @param request_options [RequestOptions]
+      # @return [Crm::Contact]
+      def retrieve(id:, expand: nil, include_remote_data: nil, include_remote_fields: nil, request_options: nil)
+        response = @request_client.conn.get("/api/crm/v1/contacts/#{id}") do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+          req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "expand": expand,
+            "include_remote_data": include_remote_data,
+            "include_remote_fields": include_remote_fields
+          }.compact
+        end
+        Crm::Contact.from_json(json_object: response.body)
+      end
+
+      # Updates a `Contact` object with the given `id`.
+      #
+      # @param id [String]
+      # @param is_debug_mode [Boolean] Whether to include debug fields (such as log file links) in the response.
+      # @param run_async [Boolean] Whether or not third-party updates should be run asynchronously.
+      # @param model [Hash] Request of type Crm::PatchedContactRequest, as a Hash
+      #   * :first_name (String)
+      #   * :last_name (String)
+      #   * :account (String)
+      #   * :owner (Hash)
+      #   * :addresses (Array<Crm::AddressRequest>)
+      #   * :email_addresses (Array<Crm::EmailAddressRequest>)
+      #   * :phone_numbers (Array<Crm::PhoneNumberRequest>)
+      #   * :last_activity_at (DateTime)
+      #   * :integration_params (Hash{String => String})
+      #   * :linked_account_params (Hash{String => String})
+      #   * :remote_fields (Array<Crm::RemoteFieldRequest>)
+      # @param request_options [RequestOptions]
+      # @return [Crm::CrmContactResponse]
+      def partial_update(id:, model:, is_debug_mode: nil, run_async: nil, request_options: nil)
+        response = @request_client.conn.patch("/api/crm/v1/contacts/#{id}") do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+          req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "is_debug_mode": is_debug_mode,
+            "run_async": run_async
+          }.compact
+          req.body = { **(request_options&.additional_body_parameters || {}), model: model }.compact
+        end
+        Crm::CrmContactResponse.from_json(json_object: response.body)
+      end
+
+      # Ignores a specific row based on the `model_id` in the url. These records will have their properties set to null, and will not be updated in future syncs. The "reason" and "message" fields in the request body will be stored for audit purposes.
+      #
+      # @param model_id [String]
+      # @param request [Hash] Request of type Crm::IgnoreCommonModelRequest, as a Hash
+      #   * :reason (REASON_ENUM)
+      #   * :message (String)
+      # @param request_options [RequestOptions]
+      # @return [Void]
+      def ignore_create(model_id:, request:, request_options: nil)
+        @request_client.conn.post("/api/crm/v1/contacts/ignore/#{model_id}") do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+          req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+          req.body = { **(request || {}), **(request_options&.additional_body_parameters || {}) }.compact
+        end
+      end
+
+      # Returns metadata for `CRMContact` PATCHs.
+      #
+      # @param id [String]
+      # @param request_options [RequestOptions]
+      # @return [Crm::MetaResponse]
+      def meta_patch_retrieve(id:, request_options: nil)
+        response = @request_client.conn.get("/api/crm/v1/contacts/meta/patch/#{id}") do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+          req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+        end
+        Crm::MetaResponse.from_json(json_object: response.body)
+      end
+
+      # Returns metadata for `CRMContact` POSTs.
+      #
+      # @param request_options [RequestOptions]
+      # @return [Crm::MetaResponse]
+      def meta_post_retrieve(request_options: nil)
+        response = @request_client.conn.get("/api/crm/v1/contacts/meta/post") do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+          req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+        end
+        Crm::MetaResponse.from_json(json_object: response.body)
+      end
+
+      # Returns a list of `RemoteFieldClass` objects.
+      #
+      # @param cursor [String] The pagination cursor value.
+      # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
+      # @param include_remote_fields [Boolean] Whether to include all remote fields, including fields that Merge did not map to common models, in a normalized format.
+      # @param page_size [Integer] Number of results to return per page.
+      # @param request_options [RequestOptions]
+      # @return [Crm::PaginatedRemoteFieldClassList]
+      def remote_field_classes_list(cursor: nil, include_deleted_data: nil, include_remote_data: nil,
+                                    include_remote_fields: nil, page_size: nil, request_options: nil)
+        response = @request_client.conn.get("/api/crm/v1/contacts/remote-field-classes") do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+          req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+          req.params = {
+            **(request_options&.additional_query_parameters || {}),
+            "cursor": cursor,
+            "include_deleted_data": include_deleted_data,
+            "include_remote_data": include_remote_data,
+            "include_remote_fields": include_remote_fields,
+            "page_size": page_size
+          }.compact
+        end
+        Crm::PaginatedRemoteFieldClassList.from_json(json_object: response.body)
+      end
+    end
+
+    class AsyncContactsClient
+      attr_reader :request_client
+
+      # @param request_client [AsyncRequestClient]
+      # @return [Crm::AsyncContactsClient]
+      def initialize(request_client:)
+        # @type [AsyncRequestClient]
+        @request_client = request_client
+      end
+
+      # Returns a list of `Contact` objects.
+      #
+      # @param account_id [String] If provided, will only return contacts with this account.
+      # @param created_after [DateTime] If provided, will only return objects created after this datetime.
+      # @param created_before [DateTime] If provided, will only return objects created before this datetime.
+      # @param cursor [String] The pagination cursor value.
+      # @param email_addresses [String] If provided, will only return contacts matching the email addresses; multiple email_addresses can be separated by commas.
+      # @param expand [CONTACTS_LIST_REQUEST_EXPAND] Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
+      # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
+      # @param include_remote_fields [Boolean] Whether to include all remote fields, including fields that Merge did not map to common models, in a normalized format.
+      # @param modified_after [DateTime] If provided, only objects synced by Merge after this date time will be returned.
+      # @param modified_before [DateTime] If provided, only objects synced by Merge before this date time will be returned.
+      # @param page_size [Integer] Number of results to return per page.
+      # @param phone_numbers [String] If provided, will only return contacts matching the phone numbers; multiple phone numbers can be separated by commas.
+      # @param remote_id [String] The API provider's ID for the given object.
+      # @param request_options [RequestOptions]
+      # @return [Crm::PaginatedContactList]
+      def list(account_id: nil, created_after: nil, created_before: nil, cursor: nil, email_addresses: nil,
+               expand: nil, include_deleted_data: nil, include_remote_data: nil, include_remote_fields: nil, modified_after: nil, modified_before: nil, page_size: nil, phone_numbers: nil, remote_id: nil, request_options: nil)
+        Async do
+          response = @request_client.conn.get("/api/crm/v1/contacts") do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+            req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+            req.params = {
+              **(request_options&.additional_query_parameters || {}),
+              "account_id": account_id,
+              "created_after": created_after,
+              "created_before": created_before,
+              "cursor": cursor,
+              "email_addresses": email_addresses,
+              "expand": expand,
+              "include_deleted_data": include_deleted_data,
+              "include_remote_data": include_remote_data,
+              "include_remote_fields": include_remote_fields,
+              "modified_after": modified_after,
+              "modified_before": modified_before,
+              "page_size": page_size,
+              "phone_numbers": phone_numbers,
+              "remote_id": remote_id
+            }.compact
+          end
+          Crm::PaginatedContactList.from_json(json_object: response.body)
+        end
+      end
+
+      # Creates a `Contact` object with the given values.
+      #
+      # @param is_debug_mode [Boolean] Whether to include debug fields (such as log file links) in the response.
+      # @param run_async [Boolean] Whether or not third-party updates should be run asynchronously.
+      # @param model [Hash] Request of type Crm::ContactRequest, as a Hash
+      #   * :first_name (String)
+      #   * :last_name (String)
+      #   * :account (Hash)
+      #   * :owner (Hash)
+      #   * :addresses (Array<Crm::AddressRequest>)
+      #   * :email_addresses (Array<Crm::EmailAddressRequest>)
+      #   * :phone_numbers (Array<Crm::PhoneNumberRequest>)
+      #   * :last_activity_at (DateTime)
+      #   * :integration_params (Hash{String => String})
+      #   * :linked_account_params (Hash{String => String})
+      #   * :remote_fields (Array<Crm::RemoteFieldRequest>)
+      # @param request_options [RequestOptions]
+      # @return [Crm::CrmContactResponse]
+      def create(model:, is_debug_mode: nil, run_async: nil, request_options: nil)
+        Async do
+          response = @request_client.conn.post("/api/crm/v1/contacts") do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+            req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+            req.params = {
+              **(request_options&.additional_query_parameters || {}),
+              "is_debug_mode": is_debug_mode,
+              "run_async": run_async
+            }.compact
+            req.body = { **(request_options&.additional_body_parameters || {}), model: model }.compact
+          end
+          Crm::CrmContactResponse.from_json(json_object: response.body)
+        end
+      end
+
+      # Returns a `Contact` object with the given `id`.
+      #
+      # @param id [String]
+      # @param expand [CONTACTS_RETRIEVE_REQUEST_EXPAND] Which relations should be returned in expanded form. Multiple relation names should be comma separated without spaces.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
+      # @param include_remote_fields [Boolean] Whether to include all remote fields, including fields that Merge did not map to common models, in a normalized format.
+      # @param request_options [RequestOptions]
+      # @return [Crm::Contact]
+      def retrieve(id:, expand: nil, include_remote_data: nil, include_remote_fields: nil, request_options: nil)
+        Async do
+          response = @request_client.conn.get("/api/crm/v1/contacts/#{id}") do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+            req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+            req.params = {
+              **(request_options&.additional_query_parameters || {}),
+              "expand": expand,
+              "include_remote_data": include_remote_data,
+              "include_remote_fields": include_remote_fields
+            }.compact
+          end
+          Crm::Contact.from_json(json_object: response.body)
+        end
+      end
+
+      # Updates a `Contact` object with the given `id`.
+      #
+      # @param id [String]
+      # @param is_debug_mode [Boolean] Whether to include debug fields (such as log file links) in the response.
+      # @param run_async [Boolean] Whether or not third-party updates should be run asynchronously.
+      # @param model [Hash] Request of type Crm::PatchedContactRequest, as a Hash
+      #   * :first_name (String)
+      #   * :last_name (String)
+      #   * :account (String)
+      #   * :owner (Hash)
+      #   * :addresses (Array<Crm::AddressRequest>)
+      #   * :email_addresses (Array<Crm::EmailAddressRequest>)
+      #   * :phone_numbers (Array<Crm::PhoneNumberRequest>)
+      #   * :last_activity_at (DateTime)
+      #   * :integration_params (Hash{String => String})
+      #   * :linked_account_params (Hash{String => String})
+      #   * :remote_fields (Array<Crm::RemoteFieldRequest>)
+      # @param request_options [RequestOptions]
+      # @return [Crm::CrmContactResponse]
+      def partial_update(id:, model:, is_debug_mode: nil, run_async: nil, request_options: nil)
+        Async do
+          response = @request_client.conn.patch("/api/crm/v1/contacts/#{id}") do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+            req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+            req.params = {
+              **(request_options&.additional_query_parameters || {}),
+              "is_debug_mode": is_debug_mode,
+              "run_async": run_async
+            }.compact
+            req.body = { **(request_options&.additional_body_parameters || {}), model: model }.compact
+          end
+          Crm::CrmContactResponse.from_json(json_object: response.body)
+        end
+      end
+
+      # Ignores a specific row based on the `model_id` in the url. These records will have their properties set to null, and will not be updated in future syncs. The "reason" and "message" fields in the request body will be stored for audit purposes.
+      #
+      # @param model_id [String]
+      # @param request [Hash] Request of type Crm::IgnoreCommonModelRequest, as a Hash
+      #   * :reason (REASON_ENUM)
+      #   * :message (String)
+      # @param request_options [RequestOptions]
+      # @return [Void]
+      def ignore_create(model_id:, request:, request_options: nil)
+        Async do
+          @request_client.conn.post("/api/crm/v1/contacts/ignore/#{model_id}") do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+            req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+            req.body = { **(request || {}), **(request_options&.additional_body_parameters || {}) }.compact
+          end
+        end
+      end
+
+      # Returns metadata for `CRMContact` PATCHs.
+      #
+      # @param id [String]
+      # @param request_options [RequestOptions]
+      # @return [Crm::MetaResponse]
+      def meta_patch_retrieve(id:, request_options: nil)
+        Async do
+          response = @request_client.conn.get("/api/crm/v1/contacts/meta/patch/#{id}") do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+            req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+          end
+          Crm::MetaResponse.from_json(json_object: response.body)
+        end
+      end
+
+      # Returns metadata for `CRMContact` POSTs.
+      #
+      # @param request_options [RequestOptions]
+      # @return [Crm::MetaResponse]
+      def meta_post_retrieve(request_options: nil)
+        Async do
+          response = @request_client.conn.get("/api/crm/v1/contacts/meta/post") do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+            req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+          end
+          Crm::MetaResponse.from_json(json_object: response.body)
+        end
+      end
+
+      # Returns a list of `RemoteFieldClass` objects.
+      #
+      # @param cursor [String] The pagination cursor value.
+      # @param include_deleted_data [Boolean] Whether to include data that was marked as deleted by third party webhooks.
+      # @param include_remote_data [Boolean] Whether to include the original data Merge fetched from the third-party to produce these models.
+      # @param include_remote_fields [Boolean] Whether to include all remote fields, including fields that Merge did not map to common models, in a normalized format.
+      # @param page_size [Integer] Number of results to return per page.
+      # @param request_options [RequestOptions]
+      # @return [Crm::PaginatedRemoteFieldClassList]
+      def remote_field_classes_list(cursor: nil, include_deleted_data: nil, include_remote_data: nil,
+                                    include_remote_fields: nil, page_size: nil, request_options: nil)
+        Async do
+          response = @request_client.conn.get("/api/crm/v1/contacts/remote-field-classes") do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["Authorization"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers["X-Account-Token"] = request_options.account_token unless request_options&.account_token.nil?
+            req.headers = { **req.headers, **(request_options&.additional_headers || {}) }.compact
+            req.params = {
+              **(request_options&.additional_query_parameters || {}),
+              "cursor": cursor,
+              "include_deleted_data": include_deleted_data,
+              "include_remote_data": include_remote_data,
+              "include_remote_fields": include_remote_fields,
+              "page_size": page_size
+            }.compact
+          end
+          Crm::PaginatedRemoteFieldClassList.from_json(json_object: response.body)
+        end
+      end
+    end
+  end
+end

data/lib/merge_ruby_client/crm/contacts/types/contacts_list_request_expand.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Merge
+  module Crm
+    class Contacts
+      # @type [CONTACTS_LIST_REQUEST_EXPAND]
+      CONTACTS_LIST_REQUEST_EXPAND = { account: "account", account_owner: "account,owner", owner: "owner" }.freeze
+    end
+  end
+end

data/lib/merge_ruby_client/crm/contacts/types/contacts_retrieve_request_expand.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Merge
+  module Crm
+    class Contacts
+      # @type [CONTACTS_RETRIEVE_REQUEST_EXPAND]
+      CONTACTS_RETRIEVE_REQUEST_EXPAND = { account: "account", account_owner: "account,owner", owner: "owner" }.freeze
+    end
+  end
+end