rcs 1.0.17 → 2.0.0.pre.rc.1

data/lib/rcs/tools/url/client.rb

@@ -0,0 +1,245 @@
+# frozen_string_literal: true
+
+require_relative "../../../requests"
+require_relative "../../types/create_url_options"
+require_relative "../../types/shortened_url"
+require_relative "../../types/shortened_url_with_click_data"
+require "async"
+
+module Pinnacle
+  module Tools
+    class UrlClient
+      # @return [Pinnacle::RequestClient]
+      attr_reader :request_client
+
+      # @param request_client [Pinnacle::RequestClient]
+      # @return [Pinnacle::Tools::UrlClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+
+      # Create a shortened URL that redirects visitors to the provided destination URL.
+      #
+      # @param url [String] Destination URL for the shortened link that visitors will be redirected to when
+      #  clicked.
+      # @param options [Hash] Request of type Pinnacle::Types::CreateUrlOptions, as a Hash
+      #   * :expires_at (String)
+      # @param request_options [Pinnacle::RequestOptions]
+      # @return [Pinnacle::Types::ShortenedUrl]
+      # @example
+      #  api = Pinnacle::Client.new(
+      #    base_url: "https://api.example.com",
+      #    environment: Pinnacle::Environment::DEFAULT,
+      #    api_key: "YOUR_API_KEY"
+      #  )
+      #  api.tools.url.create(url: "https://www.pinnacle.sh/", options: { expires_at: "2025-06-23T16:18:25.000Z" })
+      def create(url:, options: nil, request_options: nil)
+        response = @request_client.conn.post do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          req.body = { **(request_options&.additional_body_parameters || {}), url: url, options: options }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/tools/url"
+        end
+        Pinnacle::Types::ShortenedUrl.from_json(json_object: response.body)
+      end
+
+      # Retrieve configuration and details for your shortened URL using its unique
+      #  identifier.
+      #
+      # @param link_id [String] Unique identifier from your shortened URL. For example, for
+      #  `https://pncl.to/ePzVxILF`, the `linkId` is `ePzVxILF`. <br>
+      #  See the response of [Create Shortened URL](./create-url) for more information.
+      # @param request_options [Pinnacle::RequestOptions]
+      # @return [Pinnacle::Types::ShortenedUrlWithClickData]
+      # @example
+      #  api = Pinnacle::Client.new(
+      #    base_url: "https://api.example.com",
+      #    environment: Pinnacle::Environment::DEFAULT,
+      #    api_key: "YOUR_API_KEY"
+      #  )
+      #  api.tools.url.get(link_id: "ePzVxILF")
+      def get(link_id:, request_options: nil)
+        response = @request_client.conn.get do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          unless request_options.nil? || request_options&.additional_body_parameters.nil?
+            req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+          end
+          req.url "#{@request_client.get_url(request_options: request_options)}/tools/url/#{link_id}"
+        end
+        Pinnacle::Types::ShortenedUrlWithClickData.from_json(json_object: response.body)
+      end
+
+      # Update the destination or configuration of an existing shortened URL.
+      #
+      # @param link_id [String] Unique identifier from your shortened URL. For example, for
+      #  `https://pncl.to/ePzVxILF`, the `linkId` is `ePzVxILF`. <br>
+      #  See the response of [Create Shortened URL](./create-url) for more information.
+      # @param url [String] New destination URL where your visitors will be redirected.
+      # @param options [Hash] Request of type Pinnacle::Types::CreateUrlOptions, as a Hash
+      #   * :expires_at (String)
+      # @param request_options [Pinnacle::RequestOptions]
+      # @return [Pinnacle::Types::ShortenedUrl]
+      # @example
+      #  api = Pinnacle::Client.new(
+      #    base_url: "https://api.example.com",
+      #    environment: Pinnacle::Environment::DEFAULT,
+      #    api_key: "YOUR_API_KEY"
+      #  )
+      #  api.tools.url.update(link_id: "ePzVxILF", url: "https://www.pinnacle.sh/")
+      def update(link_id:, url: nil, options: nil, request_options: nil)
+        response = @request_client.conn.put do |req|
+          req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+          req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+          req.headers = {
+        **(req.headers || {}),
+        **@request_client.get_headers,
+        **(request_options&.additional_headers || {})
+          }.compact
+          unless request_options.nil? || request_options&.additional_query_parameters.nil?
+            req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+          end
+          req.body = { **(request_options&.additional_body_parameters || {}), url: url, options: options }.compact
+          req.url "#{@request_client.get_url(request_options: request_options)}/tools/url/#{link_id}"
+        end
+        Pinnacle::Types::ShortenedUrl.from_json(json_object: response.body)
+      end
+    end
+
+    class AsyncUrlClient
+      # @return [Pinnacle::AsyncRequestClient]
+      attr_reader :request_client
+
+      # @param request_client [Pinnacle::AsyncRequestClient]
+      # @return [Pinnacle::Tools::AsyncUrlClient]
+      def initialize(request_client:)
+        @request_client = request_client
+      end
+
+      # Create a shortened URL that redirects visitors to the provided destination URL.
+      #
+      # @param url [String] Destination URL for the shortened link that visitors will be redirected to when
+      #  clicked.
+      # @param options [Hash] Request of type Pinnacle::Types::CreateUrlOptions, as a Hash
+      #   * :expires_at (String)
+      # @param request_options [Pinnacle::RequestOptions]
+      # @return [Pinnacle::Types::ShortenedUrl]
+      # @example
+      #  api = Pinnacle::Client.new(
+      #    base_url: "https://api.example.com",
+      #    environment: Pinnacle::Environment::DEFAULT,
+      #    api_key: "YOUR_API_KEY"
+      #  )
+      #  api.tools.url.create(url: "https://www.pinnacle.sh/", options: { expires_at: "2025-06-23T16:18:25.000Z" })
+      def create(url:, options: nil, request_options: nil)
+        Async do
+          response = @request_client.conn.post do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers = {
+          **(req.headers || {}),
+          **@request_client.get_headers,
+          **(request_options&.additional_headers || {})
+            }.compact
+            unless request_options.nil? || request_options&.additional_query_parameters.nil?
+              req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+            end
+            req.body = { **(request_options&.additional_body_parameters || {}), url: url, options: options }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/tools/url"
+          end
+          Pinnacle::Types::ShortenedUrl.from_json(json_object: response.body)
+        end
+      end
+
+      # Retrieve configuration and details for your shortened URL using its unique
+      #  identifier.
+      #
+      # @param link_id [String] Unique identifier from your shortened URL. For example, for
+      #  `https://pncl.to/ePzVxILF`, the `linkId` is `ePzVxILF`. <br>
+      #  See the response of [Create Shortened URL](./create-url) for more information.
+      # @param request_options [Pinnacle::RequestOptions]
+      # @return [Pinnacle::Types::ShortenedUrlWithClickData]
+      # @example
+      #  api = Pinnacle::Client.new(
+      #    base_url: "https://api.example.com",
+      #    environment: Pinnacle::Environment::DEFAULT,
+      #    api_key: "YOUR_API_KEY"
+      #  )
+      #  api.tools.url.get(link_id: "ePzVxILF")
+      def get(link_id:, request_options: nil)
+        Async do
+          response = @request_client.conn.get do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers = {
+          **(req.headers || {}),
+          **@request_client.get_headers,
+          **(request_options&.additional_headers || {})
+            }.compact
+            unless request_options.nil? || request_options&.additional_query_parameters.nil?
+              req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+            end
+            unless request_options.nil? || request_options&.additional_body_parameters.nil?
+              req.body = { **(request_options&.additional_body_parameters || {}) }.compact
+            end
+            req.url "#{@request_client.get_url(request_options: request_options)}/tools/url/#{link_id}"
+          end
+          Pinnacle::Types::ShortenedUrlWithClickData.from_json(json_object: response.body)
+        end
+      end
+
+      # Update the destination or configuration of an existing shortened URL.
+      #
+      # @param link_id [String] Unique identifier from your shortened URL. For example, for
+      #  `https://pncl.to/ePzVxILF`, the `linkId` is `ePzVxILF`. <br>
+      #  See the response of [Create Shortened URL](./create-url) for more information.
+      # @param url [String] New destination URL where your visitors will be redirected.
+      # @param options [Hash] Request of type Pinnacle::Types::CreateUrlOptions, as a Hash
+      #   * :expires_at (String)
+      # @param request_options [Pinnacle::RequestOptions]
+      # @return [Pinnacle::Types::ShortenedUrl]
+      # @example
+      #  api = Pinnacle::Client.new(
+      #    base_url: "https://api.example.com",
+      #    environment: Pinnacle::Environment::DEFAULT,
+      #    api_key: "YOUR_API_KEY"
+      #  )
+      #  api.tools.url.update(link_id: "ePzVxILF", url: "https://www.pinnacle.sh/")
+      def update(link_id:, url: nil, options: nil, request_options: nil)
+        Async do
+          response = @request_client.conn.put do |req|
+            req.options.timeout = request_options.timeout_in_seconds unless request_options&.timeout_in_seconds.nil?
+            req.headers["PINNACLE-API-KEY"] = request_options.api_key unless request_options&.api_key.nil?
+            req.headers = {
+          **(req.headers || {}),
+          **@request_client.get_headers,
+          **(request_options&.additional_headers || {})
+            }.compact
+            unless request_options.nil? || request_options&.additional_query_parameters.nil?
+              req.params = { **(request_options&.additional_query_parameters || {}) }.compact
+            end
+            req.body = { **(request_options&.additional_body_parameters || {}), url: url, options: options }.compact
+            req.url "#{@request_client.get_url(request_options: request_options)}/tools/url/#{link_id}"
+          end
+          Pinnacle::Types::ShortenedUrl.from_json(json_object: response.body)
+        end
+      end
+    end
+  end
+end

data/lib/rcs/types/advanced_phone_information.rb

@@ -0,0 +1,147 @@
+# frozen_string_literal: true
+
+require_relative "advanced_phone_information_type"
+require_relative "number_format"
+require_relative "advanced_phone_information_location"
+require_relative "advanced_phone_information_carrier"
+require_relative "advanced_phone_information_contact"
+require "ostruct"
+require "json"
+
+module Pinnacle
+  module Types
+    # Detailed phone number analysis including validation status, classification with
+    #  fraud risk,
+    #  precise geographic data, carrier intelligence, and enhanced contact information.
+    #  Provides comprehensive insights for risk assessment, compliance, and advanced
+    #  usage scenarios.
+    class AdvancedPhoneInformation
+      # @return [Boolean] Indicates whether the phone number is valid and capable of receiving
+      #  communications.
+      attr_reader :is_valid
+      # @return [Pinnacle::Types::AdvancedPhoneInformationType] Detailed classification including fraud risk and security recommendations.
+      attr_reader :type
+      # @return [Pinnacle::Types::NumberFormat] Different standardized ways the phone number can be formatted for display or
+      #  dialing.
+      attr_reader :formats
+      # @return [Pinnacle::Types::AdvancedPhoneInformationLocation] Comprehensive geographic and administrative location data with precise
+      #  coordinates
+      #  and timezone information for accurate localization.
+      attr_reader :location
+      # @return [Pinnacle::Types::AdvancedPhoneInformationCarrier] Detailed carrier information.
+      attr_reader :carrier
+      # @return [Pinnacle::Types::AdvancedPhoneInformationContact] Enhanced contact information associated with the phone number.
+      attr_reader :contact
+      # @return [OpenStruct] Additional properties unmapped to the current class definition
+      attr_reader :additional_properties
+      # @return [Object]
+      attr_reader :_field_set
+      protected :_field_set
+
+      OMIT = Object.new
+
+      # @param is_valid [Boolean] Indicates whether the phone number is valid and capable of receiving
+      #  communications.
+      # @param type [Pinnacle::Types::AdvancedPhoneInformationType] Detailed classification including fraud risk and security recommendations.
+      # @param formats [Pinnacle::Types::NumberFormat] Different standardized ways the phone number can be formatted for display or
+      #  dialing.
+      # @param location [Pinnacle::Types::AdvancedPhoneInformationLocation] Comprehensive geographic and administrative location data with precise
+      #  coordinates
+      #  and timezone information for accurate localization.
+      # @param carrier [Pinnacle::Types::AdvancedPhoneInformationCarrier] Detailed carrier information.
+      # @param contact [Pinnacle::Types::AdvancedPhoneInformationContact] Enhanced contact information associated with the phone number.
+      # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+      # @return [Pinnacle::Types::AdvancedPhoneInformation]
+      def initialize(is_valid:, type:, formats:, location:, carrier:, contact: OMIT, additional_properties: nil)
+        @is_valid = is_valid
+        @type = type
+        @formats = formats
+        @location = location
+        @carrier = carrier
+        @contact = contact if contact != OMIT
+        @additional_properties = additional_properties
+        @_field_set = {
+          "isValid": is_valid,
+          "type": type,
+          "formats": formats,
+          "location": location,
+          "carrier": carrier,
+          "contact": contact
+        }.reject do |_k, v|
+          v == OMIT
+        end
+      end
+
+      # Deserialize a JSON object to an instance of AdvancedPhoneInformation
+      #
+      # @param json_object [String]
+      # @return [Pinnacle::Types::AdvancedPhoneInformation]
+      def self.from_json(json_object:)
+        struct = JSON.parse(json_object, object_class: OpenStruct)
+        parsed_json = JSON.parse(json_object)
+        is_valid = parsed_json["isValid"]
+        if parsed_json["type"].nil?
+          type = nil
+        else
+          type = parsed_json["type"].to_json
+          type = Pinnacle::Types::AdvancedPhoneInformationType.from_json(json_object: type)
+        end
+        if parsed_json["formats"].nil?
+          formats = nil
+        else
+          formats = parsed_json["formats"].to_json
+          formats = Pinnacle::Types::NumberFormat.from_json(json_object: formats)
+        end
+        if parsed_json["location"].nil?
+          location = nil
+        else
+          location = parsed_json["location"].to_json
+          location = Pinnacle::Types::AdvancedPhoneInformationLocation.from_json(json_object: location)
+        end
+        if parsed_json["carrier"].nil?
+          carrier = nil
+        else
+          carrier = parsed_json["carrier"].to_json
+          carrier = Pinnacle::Types::AdvancedPhoneInformationCarrier.from_json(json_object: carrier)
+        end
+        if parsed_json["contact"].nil?
+          contact = nil
+        else
+          contact = parsed_json["contact"].to_json
+          contact = Pinnacle::Types::AdvancedPhoneInformationContact.from_json(json_object: contact)
+        end
+        new(
+          is_valid: is_valid,
+          type: type,
+          formats: formats,
+          location: location,
+          carrier: carrier,
+          contact: contact,
+          additional_properties: struct
+        )
+      end
+
+      # Serialize an instance of AdvancedPhoneInformation to a JSON object
+      #
+      # @return [String]
+      def to_json(*_args)
+        @_field_set&.to_json
+      end
+
+      # Leveraged for Union-type generation, validate_raw attempts to parse the given
+      #  hash and check each fields type against the current object's property
+      #  definitions.
+      #
+      # @param obj [Object]
+      # @return [Void]
+      def self.validate_raw(obj:)
+        obj.is_valid.is_a?(Boolean) != false || raise("Passed value for field obj.is_valid is not the expected type, validation failed.")
+        Pinnacle::Types::AdvancedPhoneInformationType.validate_raw(obj: obj.type)
+        Pinnacle::Types::NumberFormat.validate_raw(obj: obj.formats)
+        Pinnacle::Types::AdvancedPhoneInformationLocation.validate_raw(obj: obj.location)
+        Pinnacle::Types::AdvancedPhoneInformationCarrier.validate_raw(obj: obj.carrier)
+        obj.contact.nil? || Pinnacle::Types::AdvancedPhoneInformationContact.validate_raw(obj: obj.contact)
+      end
+    end
+  end
+end

data/lib/rcs/types/advanced_phone_information_carrier.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require "ostruct"
+require "json"
+
+module Pinnacle
+  module Types
+    # Detailed carrier information.
+    class AdvancedPhoneInformationCarrier
+      # @return [String] Carrier or service provider name as registered with telecom authorities.
+      attr_reader :name
+      # @return [String] Standardized carrier name used across data sources.
+      attr_reader :normalized_carrier
+      # @return [String] Mobile Country Code - 3-digit identifier assigned by ITU-T for the country.
+      #  Used in GSM, UMTS, and LTE networks for international roaming and
+      #  identification.
+      attr_reader :mcc
+      # @return [String] Mobile Network Code - 2 or 3-digit identifier for the specific carrier within
+      #  the country.
+      #  Combined with MCC provides unique global identification of the mobile network.
+      attr_reader :mnc
+      # @return [OpenStruct] Additional properties unmapped to the current class definition
+      attr_reader :additional_properties
+      # @return [Object]
+      attr_reader :_field_set
+      protected :_field_set
+
+      OMIT = Object.new
+
+      # @param name [String] Carrier or service provider name as registered with telecom authorities.
+      # @param normalized_carrier [String] Standardized carrier name used across data sources.
+      # @param mcc [String] Mobile Country Code - 3-digit identifier assigned by ITU-T for the country.
+      #  Used in GSM, UMTS, and LTE networks for international roaming and
+      #  identification.
+      # @param mnc [String] Mobile Network Code - 2 or 3-digit identifier for the specific carrier within
+      #  the country.
+      #  Combined with MCC provides unique global identification of the mobile network.
+      # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+      # @return [Pinnacle::Types::AdvancedPhoneInformationCarrier]
+      def initialize(name:, normalized_carrier:, mcc:, mnc:, additional_properties: nil)
+        @name = name
+        @normalized_carrier = normalized_carrier
+        @mcc = mcc
+        @mnc = mnc
+        @additional_properties = additional_properties
+        @_field_set = { "name": name, "normalizedCarrier": normalized_carrier, "mcc": mcc, "mnc": mnc }
+      end
+
+      # Deserialize a JSON object to an instance of AdvancedPhoneInformationCarrier
+      #
+      # @param json_object [String]
+      # @return [Pinnacle::Types::AdvancedPhoneInformationCarrier]
+      def self.from_json(json_object:)
+        struct = JSON.parse(json_object, object_class: OpenStruct)
+        parsed_json = JSON.parse(json_object)
+        name = parsed_json["name"]
+        normalized_carrier = parsed_json["normalizedCarrier"]
+        mcc = parsed_json["mcc"]
+        mnc = parsed_json["mnc"]
+        new(
+          name: name,
+          normalized_carrier: normalized_carrier,
+          mcc: mcc,
+          mnc: mnc,
+          additional_properties: struct
+        )
+      end
+
+      # Serialize an instance of AdvancedPhoneInformationCarrier to a JSON object
+      #
+      # @return [String]
+      def to_json(*_args)
+        @_field_set&.to_json
+      end
+
+      # Leveraged for Union-type generation, validate_raw attempts to parse the given
+      #  hash and check each fields type against the current object's property
+      #  definitions.
+      #
+      # @param obj [Object]
+      # @return [Void]
+      def self.validate_raw(obj:)
+        obj.name.is_a?(String) != false || raise("Passed value for field obj.name is not the expected type, validation failed.")
+        obj.normalized_carrier.is_a?(String) != false || raise("Passed value for field obj.normalized_carrier is not the expected type, validation failed.")
+        obj.mcc.is_a?(String) != false || raise("Passed value for field obj.mcc is not the expected type, validation failed.")
+        obj.mnc.is_a?(String) != false || raise("Passed value for field obj.mnc is not the expected type, validation failed.")
+      end
+    end
+  end
+end

data/lib/rcs/types/advanced_phone_information_contact.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+require_relative "enhanced_contact"
+require "ostruct"
+require "json"
+
+module Pinnacle
+  module Types
+    # Enhanced contact information associated with the phone number.
+    class AdvancedPhoneInformationContact
+      # @return [String] Given name of the primary contact.
+      attr_reader :first_name
+      # @return [String] Family name of the primary contact.
+      attr_reader :last_name
+      # @return [String] Primary email associated with the number’s registration.
+      attr_reader :email_address
+      # @return [String] Street address including number and street name.
+      attr_reader :street
+      # @return [String] Secondary address info like suite or apartment number.
+      attr_reader :unit
+      # @return [String] Combined city, state, and postal info in a human-readable format.
+      attr_reader :place
+      # @return [String] Postal or ZIP code of the contact’s address.
+      attr_reader :zip
+      # @return [String] Full state or province name of the contact’s address.
+      attr_reader :state
+      # @return [String] Full country name of the contact’s registered address.
+      attr_reader :country
+      # @return [Pinnacle::Types::ENHANCED_CONTACT] Collection of online profiles and social media accounts associated with the
+      #  contact. <br>
+      #  These are potential candidates and may be inaccurate. Always double check.
+      attr_reader :profiles
+      # @return [OpenStruct] Additional properties unmapped to the current class definition
+      attr_reader :additional_properties
+      # @return [Object]
+      attr_reader :_field_set
+      protected :_field_set
+
+      OMIT = Object.new
+
+      # @param first_name [String] Given name of the primary contact.
+      # @param last_name [String] Family name of the primary contact.
+      # @param email_address [String] Primary email associated with the number’s registration.
+      # @param street [String] Street address including number and street name.
+      # @param unit [String] Secondary address info like suite or apartment number.
+      # @param place [String] Combined city, state, and postal info in a human-readable format.
+      # @param zip [String] Postal or ZIP code of the contact’s address.
+      # @param state [String] Full state or province name of the contact’s address.
+      # @param country [String] Full country name of the contact’s registered address.
+      # @param profiles [Pinnacle::Types::ENHANCED_CONTACT] Collection of online profiles and social media accounts associated with the
+      #  contact. <br>
+      #  These are potential candidates and may be inaccurate. Always double check.
+      # @param additional_properties [OpenStruct] Additional properties unmapped to the current class definition
+      # @return [Pinnacle::Types::AdvancedPhoneInformationContact]
+      def initialize(first_name: OMIT, last_name: OMIT, email_address: OMIT, street: OMIT, unit: OMIT, place: OMIT,
+                     zip: OMIT, state: OMIT, country: OMIT, profiles: OMIT, additional_properties: nil)
+        @first_name = first_name if first_name != OMIT
+        @last_name = last_name if last_name != OMIT
+        @email_address = email_address if email_address != OMIT
+        @street = street if street != OMIT
+        @unit = unit if unit != OMIT
+        @place = place if place != OMIT
+        @zip = zip if zip != OMIT
+        @state = state if state != OMIT
+        @country = country if country != OMIT
+        @profiles = profiles if profiles != OMIT
+        @additional_properties = additional_properties
+        @_field_set = {
+          "firstName": first_name,
+          "lastName": last_name,
+          "emailAddress": email_address,
+          "street": street,
+          "unit": unit,
+          "place": place,
+          "zip": zip,
+          "state": state,
+          "country": country,
+          "profiles": profiles
+        }.reject do |_k, v|
+          v == OMIT
+        end
+      end
+
+      # Deserialize a JSON object to an instance of AdvancedPhoneInformationContact
+      #
+      # @param json_object [String]
+      # @return [Pinnacle::Types::AdvancedPhoneInformationContact]
+      def self.from_json(json_object:)
+        struct = JSON.parse(json_object, object_class: OpenStruct)
+        parsed_json = JSON.parse(json_object)
+        first_name = parsed_json["firstName"]
+        last_name = parsed_json["lastName"]
+        email_address = parsed_json["emailAddress"]
+        street = parsed_json["street"]
+        unit = parsed_json["unit"]
+        place = parsed_json["place"]
+        zip = parsed_json["zip"]
+        state = parsed_json["state"]
+        country = parsed_json["country"]
+        profiles = parsed_json["profiles"]&.map do |item|
+          item = item.to_json
+          Pinnacle::Types::EnhancedContactItem.from_json(json_object: item)
+        end
+        new(
+          first_name: first_name,
+          last_name: last_name,
+          email_address: email_address,
+          street: street,
+          unit: unit,
+          place: place,
+          zip: zip,
+          state: state,
+          country: country,
+          profiles: profiles,
+          additional_properties: struct
+        )
+      end
+
+      # Serialize an instance of AdvancedPhoneInformationContact to a JSON object
+      #
+      # @return [String]
+      def to_json(*_args)
+        @_field_set&.to_json
+      end
+
+      # Leveraged for Union-type generation, validate_raw attempts to parse the given
+      #  hash and check each fields type against the current object's property
+      #  definitions.
+      #
+      # @param obj [Object]
+      # @return [Void]
+      def self.validate_raw(obj:)
+        obj.first_name&.is_a?(String) != false || raise("Passed value for field obj.first_name is not the expected type, validation failed.")
+        obj.last_name&.is_a?(String) != false || raise("Passed value for field obj.last_name is not the expected type, validation failed.")
+        obj.email_address&.is_a?(String) != false || raise("Passed value for field obj.email_address is not the expected type, validation failed.")
+        obj.street&.is_a?(String) != false || raise("Passed value for field obj.street is not the expected type, validation failed.")
+        obj.unit&.is_a?(String) != false || raise("Passed value for field obj.unit is not the expected type, validation failed.")
+        obj.place&.is_a?(String) != false || raise("Passed value for field obj.place is not the expected type, validation failed.")
+        obj.zip&.is_a?(String) != false || raise("Passed value for field obj.zip is not the expected type, validation failed.")
+        obj.state&.is_a?(String) != false || raise("Passed value for field obj.state is not the expected type, validation failed.")
+        obj.country&.is_a?(String) != false || raise("Passed value for field obj.country is not the expected type, validation failed.")
+        obj.profiles&.is_a?(Array) != false || raise("Passed value for field obj.profiles is not the expected type, validation failed.")
+      end
+    end
+  end
+end