twilio-ruby 5.5.1 → 5.58.3

data/lib/twilio-ruby/rest/ip_messaging/v2/service.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -22,20 +24,15 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of ServiceInstance records from the API.
-          # Request is executed immediately.
+          # Create the ServiceInstance
           # @param [String] friendly_name The friendly_name
-          # @return [ServiceInstance] Newly created ServiceInstance
+          # @return [ServiceInstance] Created ServiceInstance
           def create(friendly_name: nil)
-            data = Twilio::Values.of({'FriendlyName' => friendly_name})
+            data = Twilio::Values.of({'FriendlyName' => friendly_name, })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
-            ServiceInstance.new(@version, payload)
+            ServiceInstance.new(@version, payload, )
           end
 
           ##
@@ -67,7 +64,7 @@ module Twilio
           def stream(limit: nil, page_size: nil)
             limits = @version.read_limits(limit, page_size)
 
-            page = self.page(page_size: limits[:page_size])
+            page = self.page(page_size: limits[:page_size], )
 
             @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
           end
@@ -79,7 +76,7 @@ module Twilio
           def each
             limits = @version.read_limits
 
-            page = self.page(page_size: limits[:page_size])
+            page = self.page(page_size: limits[:page_size], )
 
             @version.stream(page,
                             limit: limits[:limit],
@@ -99,11 +96,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             ServicePage.new(@version, response, @solution)
           end
 
@@ -146,7 +141,7 @@ module Twilio
           # @param [Hash] payload Payload response from the API
           # @return [ServiceInstance] ServiceInstance
           def get_instance(payload)
-            ServiceInstance.new(@version, payload)
+            ServiceInstance.new(@version, payload, )
           end
 
           ##
@@ -166,7 +161,7 @@ module Twilio
             super(version)
 
             # Path Solution
-            @solution = {sid: sid}
+            @solution = {sid: sid, }
             @uri = "/Services/#{@solution[:sid]}"
 
             # Dependents
@@ -177,25 +172,19 @@ module Twilio
           end
 
           ##
-          # Fetch a ServiceInstance
+          # Fetch the ServiceInstance
           # @return [ServiceInstance] Fetched ServiceInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
-            ServiceInstance.new(@version, payload, sid: @solution[:sid])
+            ServiceInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the ServiceInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # Delete the ServiceInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
-            @version.delete('delete', @uri)
+             @version.delete('DELETE', @uri)
           end
 
           ##
@@ -238,14 +227,15 @@ module Twilio
           # @param [String] pre_webhook_url The pre_webhook_url
           # @param [String] post_webhook_url The post_webhook_url
           # @param [String] webhook_method The webhook_method
-          # @param [String] webhook_filters The webhook_filters
+          # @param [Array[String]] webhook_filters The webhook_filters
           # @param [String] limits_channel_members The limits.channel_members
           # @param [String] limits_user_channels The limits.user_channels
           # @param [String] media_compatibility_message The media.compatibility_message
           # @param [String] pre_webhook_retry_count The pre_webhook_retry_count
           # @param [String] post_webhook_retry_count The post_webhook_retry_count
+          # @param [Boolean] notifications_log_enabled The notifications.log_enabled
           # @return [ServiceInstance] Updated ServiceInstance
-          def update(friendly_name: :unset, default_service_role_sid: :unset, default_channel_role_sid: :unset, default_channel_creator_role_sid: :unset, read_status_enabled: :unset, reachability_enabled: :unset, typing_indicator_timeout: :unset, consumption_report_interval: :unset, notifications_new_message_enabled: :unset, notifications_new_message_template: :unset, notifications_new_message_sound: :unset, notifications_new_message_badge_count_enabled: :unset, notifications_added_to_channel_enabled: :unset, notifications_added_to_channel_template: :unset, notifications_added_to_channel_sound: :unset, notifications_removed_from_channel_enabled: :unset, notifications_removed_from_channel_template: :unset, notifications_removed_from_channel_sound: :unset, notifications_invited_to_channel_enabled: :unset, notifications_invited_to_channel_template: :unset, notifications_invited_to_channel_sound: :unset, pre_webhook_url: :unset, post_webhook_url: :unset, webhook_method: :unset, webhook_filters: :unset, limits_channel_members: :unset, limits_user_channels: :unset, media_compatibility_message: :unset, pre_webhook_retry_count: :unset, post_webhook_retry_count: :unset)
+          def update(friendly_name: :unset, default_service_role_sid: :unset, default_channel_role_sid: :unset, default_channel_creator_role_sid: :unset, read_status_enabled: :unset, reachability_enabled: :unset, typing_indicator_timeout: :unset, consumption_report_interval: :unset, notifications_new_message_enabled: :unset, notifications_new_message_template: :unset, notifications_new_message_sound: :unset, notifications_new_message_badge_count_enabled: :unset, notifications_added_to_channel_enabled: :unset, notifications_added_to_channel_template: :unset, notifications_added_to_channel_sound: :unset, notifications_removed_from_channel_enabled: :unset, notifications_removed_from_channel_template: :unset, notifications_removed_from_channel_sound: :unset, notifications_invited_to_channel_enabled: :unset, notifications_invited_to_channel_template: :unset, notifications_invited_to_channel_sound: :unset, pre_webhook_url: :unset, post_webhook_url: :unset, webhook_method: :unset, webhook_filters: :unset, limits_channel_members: :unset, limits_user_channels: :unset, media_compatibility_message: :unset, pre_webhook_retry_count: :unset, post_webhook_retry_count: :unset, notifications_log_enabled: :unset)
             data = Twilio::Values.of({
                 'FriendlyName' => friendly_name,
                 'DefaultServiceRoleSid' => default_service_role_sid,
@@ -277,15 +267,12 @@ module Twilio
                 'Media.CompatibilityMessage' => media_compatibility_message,
                 'PreWebhookRetryCount' => pre_webhook_retry_count,
                 'PostWebhookRetryCount' => post_webhook_retry_count,
+                'Notifications.LogEnabled' => notifications_log_enabled,
             })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
-            ServiceInstance.new(@version, payload, sid: @solution[:sid])
+            ServiceInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
@@ -296,11 +283,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return ChannelContext.new(@version, @solution[:sid], sid)
+              return ChannelContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @channels
-              @channels = ChannelList.new(@version, service_sid: @solution[:sid])
+              @channels = ChannelList.new(@version, service_sid: @solution[:sid], )
             end
 
             @channels
@@ -314,11 +301,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return RoleContext.new(@version, @solution[:sid], sid)
+              return RoleContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @roles
-              @roles = RoleList.new(@version, service_sid: @solution[:sid])
+              @roles = RoleList.new(@version, service_sid: @solution[:sid], )
             end
 
             @roles
@@ -332,11 +319,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return UserContext.new(@version, @solution[:sid], sid)
+              return UserContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @users
-              @users = UserList.new(@version, service_sid: @solution[:sid])
+              @users = UserList.new(@version, service_sid: @solution[:sid], )
             end
 
             @users
@@ -350,11 +337,11 @@ module Twilio
             raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
             if sid != :unset
-              return BindingContext.new(@version, @solution[:sid], sid)
+              return BindingContext.new(@version, @solution[:sid], sid, )
             end
 
             unless @bindings
-              @bindings = BindingList.new(@version, service_sid: @solution[:sid])
+              @bindings = BindingList.new(@version, service_sid: @solution[:sid], )
             end
 
             @bindings
@@ -366,6 +353,13 @@ module Twilio
             context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
             "#<Twilio.IpMessaging.V2.ServiceContext #{context}>"
           end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.IpMessaging.V2.ServiceContext #{context}>"
+          end
         end
 
         class ServiceInstance < InstanceResource
@@ -407,7 +401,7 @@ module Twilio
 
             # Context
             @instance_context = nil
-            @params = {'sid' => sid || @properties['sid']}
+            @params = {'sid' => sid || @properties['sid'], }
           end
 
           ##
@@ -416,7 +410,7 @@ module Twilio
           # @return [ServiceContext] ServiceContext for this ServiceInstance
           def context
             unless @instance_context
-              @instance_context = ServiceContext.new(@version, @params['sid'])
+              @instance_context = ServiceContext.new(@version, @params['sid'], )
             end
             @instance_context
           end
@@ -518,7 +512,7 @@ module Twilio
           end
 
           ##
-          # @return [String] The webhook_filters
+          # @return [Array[String]] The webhook_filters
           def webhook_filters
             @properties['webhook_filters']
           end
@@ -560,15 +554,15 @@ module Twilio
           end
 
           ##
-          # Fetch a ServiceInstance
+          # Fetch the ServiceInstance
           # @return [ServiceInstance] Fetched ServiceInstance
           def fetch
             context.fetch
           end
 
           ##
-          # Deletes the ServiceInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # Delete the ServiceInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             context.delete
           end
@@ -613,14 +607,15 @@ module Twilio
           # @param [String] pre_webhook_url The pre_webhook_url
           # @param [String] post_webhook_url The post_webhook_url
           # @param [String] webhook_method The webhook_method
-          # @param [String] webhook_filters The webhook_filters
+          # @param [Array[String]] webhook_filters The webhook_filters
           # @param [String] limits_channel_members The limits.channel_members
           # @param [String] limits_user_channels The limits.user_channels
           # @param [String] media_compatibility_message The media.compatibility_message
           # @param [String] pre_webhook_retry_count The pre_webhook_retry_count
           # @param [String] post_webhook_retry_count The post_webhook_retry_count
+          # @param [Boolean] notifications_log_enabled The notifications.log_enabled
           # @return [ServiceInstance] Updated ServiceInstance
-          def update(friendly_name: :unset, default_service_role_sid: :unset, default_channel_role_sid: :unset, default_channel_creator_role_sid: :unset, read_status_enabled: :unset, reachability_enabled: :unset, typing_indicator_timeout: :unset, consumption_report_interval: :unset, notifications_new_message_enabled: :unset, notifications_new_message_template: :unset, notifications_new_message_sound: :unset, notifications_new_message_badge_count_enabled: :unset, notifications_added_to_channel_enabled: :unset, notifications_added_to_channel_template: :unset, notifications_added_to_channel_sound: :unset, notifications_removed_from_channel_enabled: :unset, notifications_removed_from_channel_template: :unset, notifications_removed_from_channel_sound: :unset, notifications_invited_to_channel_enabled: :unset, notifications_invited_to_channel_template: :unset, notifications_invited_to_channel_sound: :unset, pre_webhook_url: :unset, post_webhook_url: :unset, webhook_method: :unset, webhook_filters: :unset, limits_channel_members: :unset, limits_user_channels: :unset, media_compatibility_message: :unset, pre_webhook_retry_count: :unset, post_webhook_retry_count: :unset)
+          def update(friendly_name: :unset, default_service_role_sid: :unset, default_channel_role_sid: :unset, default_channel_creator_role_sid: :unset, read_status_enabled: :unset, reachability_enabled: :unset, typing_indicator_timeout: :unset, consumption_report_interval: :unset, notifications_new_message_enabled: :unset, notifications_new_message_template: :unset, notifications_new_message_sound: :unset, notifications_new_message_badge_count_enabled: :unset, notifications_added_to_channel_enabled: :unset, notifications_added_to_channel_template: :unset, notifications_added_to_channel_sound: :unset, notifications_removed_from_channel_enabled: :unset, notifications_removed_from_channel_template: :unset, notifications_removed_from_channel_sound: :unset, notifications_invited_to_channel_enabled: :unset, notifications_invited_to_channel_template: :unset, notifications_invited_to_channel_sound: :unset, pre_webhook_url: :unset, post_webhook_url: :unset, webhook_method: :unset, webhook_filters: :unset, limits_channel_members: :unset, limits_user_channels: :unset, media_compatibility_message: :unset, pre_webhook_retry_count: :unset, post_webhook_retry_count: :unset, notifications_log_enabled: :unset)
             context.update(
                 friendly_name: friendly_name,
                 default_service_role_sid: default_service_role_sid,
@@ -652,6 +647,7 @@ module Twilio
                 media_compatibility_message: media_compatibility_message,
                 pre_webhook_retry_count: pre_webhook_retry_count,
                 post_webhook_retry_count: post_webhook_retry_count,
+                notifications_log_enabled: notifications_log_enabled,
             )
           end
 

data/lib/twilio-ruby/rest/ip_messaging/v2.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -19,29 +21,31 @@ module Twilio
 
         ##
         # @param [String] sid The sid
-        # @return [Twilio::REST::Chat::V2::CredentialContext] if sid was passed.
-        # @return [Twilio::REST::Chat::V2::CredentialList]
+        # @return [Twilio::REST::Ip_messaging::V2::CredentialContext] if sid was passed.
+        # @return [Twilio::REST::Ip_messaging::V2::CredentialList]
         def credentials(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @credentials ||= CredentialList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @credentials ||= CredentialList.new self
           else
-            CredentialContext.new(self, sid)
+              CredentialContext.new(self, sid)
           end
         end
 
         ##
         # @param [String] sid The sid
-        # @return [Twilio::REST::Chat::V2::ServiceContext] if sid was passed.
-        # @return [Twilio::REST::Chat::V2::ServiceList]
+        # @return [Twilio::REST::Ip_messaging::V2::ServiceContext] if sid was passed.
+        # @return [Twilio::REST::Ip_messaging::V2::ServiceList]
         def services(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @services ||= ServiceList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @services ||= ServiceList.new self
           else
-            ServiceContext.new(self, sid)
+              ServiceContext.new(self, sid)
           end
         end
 

data/lib/twilio-ruby/rest/ip_messaging.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -35,16 +37,16 @@ module Twilio
 
       ##
       # @param [String] sid The sid
-      # @return [Twilio::REST::Chat::V2::CredentialInstance] if sid was passed.
-      # @return [Twilio::REST::Chat::V2::CredentialList]
+      # @return [Twilio::REST::Ip_messaging::V2::CredentialInstance] if sid was passed.
+      # @return [Twilio::REST::Ip_messaging::V2::CredentialList]
       def credentials(sid=:unset)
         self.v2.credentials(sid)
       end
 
       ##
       # @param [String] sid The sid
-      # @return [Twilio::REST::Chat::V2::ServiceInstance] if sid was passed.
-      # @return [Twilio::REST::Chat::V2::ServiceList]
+      # @return [Twilio::REST::Ip_messaging::V2::ServiceInstance] if sid was passed.
+      # @return [Twilio::REST::Ip_messaging::V2::ServiceList]
       def services(sid=:unset)
         self.v2.services(sid)
       end

data/lib/twilio-ruby/rest/lookups/v1/phone_number.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -46,7 +48,7 @@ module Twilio
           # @param [Hash] payload Payload response from the API
           # @return [PhoneNumberInstance] PhoneNumberInstance
           def get_instance(payload)
-            PhoneNumberInstance.new(@version, payload)
+            PhoneNumberInstance.new(@version, payload, )
           end
 
           ##
@@ -60,22 +62,37 @@ module Twilio
           ##
           # Initialize the PhoneNumberContext
           # @param [Version] version Version that contains the resource
-          # @param [String] phone_number The phone_number
+          # @param [String] phone_number The phone number to lookup in
+          #   {E.164}[https://www.twilio.com/docs/glossary/what-e164] format, which consists
+          #   of a + followed by the country code and subscriber number.
           # @return [PhoneNumberContext] PhoneNumberContext
           def initialize(version, phone_number)
             super(version)
 
             # Path Solution
-            @solution = {phone_number: phone_number}
-            @uri = "/PhoneNumbers/#{@solution[:phone_number]}"
-          end
-
-          ##
-          # Fetch a PhoneNumberInstance
-          # @param [String] country_code The country_code
-          # @param [String] type The type
-          # @param [String] add_ons The add_ons
-          # @param [Hash] add_ons_data The add_ons_data
+            @solution = {phone_number: phone_number, }
+            @uri = "/PhoneNumbers/#{CGI.escape(@solution[:phone_number]).gsub("+", "%20")}"
+          end
+
+          ##
+          # Fetch the PhoneNumberInstance
+          # @param [String] country_code The {ISO country
+          #   code}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] of the phone number to
+          #   fetch. This is used to specify the country when the phone number is provided in
+          #   a national format.
+          # @param [Array[String]] type The type of information to return. Can be: `carrier`
+          #   or `caller-name`. The default is null.  Carrier information costs $0.005 per
+          #   phone number looked up.  Caller Name information is currently available only in
+          #   the US and costs $0.01 per phone number looked up.  To retrieve both types on
+          #   information, specify this parameter twice; once with `carrier` and once with
+          #   `caller-name` as the value.
+          # @param [Array[String]] add_ons The `unique_name` of an Add-on you would like to
+          #   invoke. Can be the `unique_name` of an Add-on that is installed on your account.
+          #   You can specify multiple instances of this parameter to invoke multiple Add-ons.
+          #   For more information about  Add-ons, see the {Add-ons
+          #   documentation}[https://www.twilio.com/docs/add-ons].
+          # @param [Hash] add_ons_data Data specific to the add-on you would like to invoke.
+          #   The content and format of this value depends on the add-on.
           # @return [PhoneNumberInstance] Fetched PhoneNumberInstance
           def fetch(country_code: :unset, type: :unset, add_ons: :unset, add_ons_data: :unset)
             params = Twilio::Values.of({
@@ -83,15 +100,11 @@ module Twilio
                 'Type' => Twilio.serialize_list(type) { |e| e },
                 'AddOns' => Twilio.serialize_list(add_ons) { |e| e },
             })
-
             params.merge!(Twilio.prefixed_collapsible_map(add_ons_data, 'AddOns'))
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
 
-            PhoneNumberInstance.new(@version, payload, phone_number: @solution[:phone_number])
+            payload = @version.fetch('GET', @uri, params: params)
+
+            PhoneNumberInstance.new(@version, payload, phone_number: @solution[:phone_number], )
           end
 
           ##
@@ -100,6 +113,13 @@ module Twilio
             context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
             "#<Twilio.Lookups.V1.PhoneNumberContext #{context}>"
           end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Lookups.V1.PhoneNumberContext #{context}>"
+          end
         end
 
         class PhoneNumberInstance < InstanceResource
@@ -107,7 +127,9 @@ module Twilio
           # Initialize the PhoneNumberInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] phone_number The phone_number
+          # @param [String] phone_number The phone number to lookup in
+          #   {E.164}[https://www.twilio.com/docs/glossary/what-e164] format, which consists
+          #   of a + followed by the country code and subscriber number.
           # @return [PhoneNumberInstance] PhoneNumberInstance
           def initialize(version, payload, phone_number: nil)
             super(version)
@@ -125,7 +147,7 @@ module Twilio
 
             # Context
             @instance_context = nil
-            @params = {'phone_number' => phone_number || @properties['phone_number']}
+            @params = {'phone_number' => phone_number || @properties['phone_number'], }
           end
 
           ##
@@ -134,62 +156,75 @@ module Twilio
           # @return [PhoneNumberContext] PhoneNumberContext for this PhoneNumberInstance
           def context
             unless @instance_context
-              @instance_context = PhoneNumberContext.new(@version, @params['phone_number'])
+              @instance_context = PhoneNumberContext.new(@version, @params['phone_number'], )
             end
             @instance_context
           end
 
           ##
-          # @return [String] The caller_name
+          # @return [Hash] The name of the phone number's owner
           def caller_name
             @properties['caller_name']
           end
 
           ##
-          # @return [String] The country_code
+          # @return [String] The ISO country code for the phone number
           def country_code
             @properties['country_code']
           end
 
           ##
-          # @return [String] The phone_number
+          # @return [String] The phone number in E.164 format
           def phone_number
             @properties['phone_number']
           end
 
           ##
-          # @return [String] The national_format
+          # @return [String] The phone number, in national format
           def national_format
             @properties['national_format']
           end
 
           ##
-          # @return [String] The carrier
+          # @return [Hash] The telecom company that provides the phone number
           def carrier
             @properties['carrier']
           end
 
           ##
-          # @return [Hash] The add_ons
+          # @return [Hash] A JSON string with the results of the Add-ons you specified
           def add_ons
             @properties['add_ons']
           end
 
           ##
-          # @return [String] The url
+          # @return [String] The absolute URL of the resource
           def url
             @properties['url']
           end
 
           ##
-          # Fetch a PhoneNumberInstance
-          # @param [String] country_code The country_code
-          # @param [String] type The type
-          # @param [String] add_ons The add_ons
-          # @param [Hash] add_ons_data The add_ons_data
+          # Fetch the PhoneNumberInstance
+          # @param [String] country_code The {ISO country
+          #   code}[https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] of the phone number to
+          #   fetch. This is used to specify the country when the phone number is provided in
+          #   a national format.
+          # @param [Array[String]] type The type of information to return. Can be: `carrier`
+          #   or `caller-name`. The default is null.  Carrier information costs $0.005 per
+          #   phone number looked up.  Caller Name information is currently available only in
+          #   the US and costs $0.01 per phone number looked up.  To retrieve both types on
+          #   information, specify this parameter twice; once with `carrier` and once with
+          #   `caller-name` as the value.
+          # @param [Array[String]] add_ons The `unique_name` of an Add-on you would like to
+          #   invoke. Can be the `unique_name` of an Add-on that is installed on your account.
+          #   You can specify multiple instances of this parameter to invoke multiple Add-ons.
+          #   For more information about  Add-ons, see the {Add-ons
+          #   documentation}[https://www.twilio.com/docs/add-ons].
+          # @param [Hash] add_ons_data Data specific to the add-on you would like to invoke.
+          #   The content and format of this value depends on the add-on.
           # @return [PhoneNumberInstance] Fetched PhoneNumberInstance
           def fetch(country_code: :unset, type: :unset, add_ons: :unset, add_ons_data: :unset)
-            context.fetch(country_code: country_code, type: type, add_ons: add_ons, add_ons_data: add_ons_data)
+            context.fetch(country_code: country_code, type: type, add_ons: add_ons, add_ons_data: add_ons_data, )
           end
 
           ##

data/lib/twilio-ruby/rest/lookups/v1.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -17,16 +19,19 @@ module Twilio
         end
 
         ##
-        # @param [String] phone_number The phone_number
+        # @param [String] phone_number The phone number to lookup in
+        #   {E.164}[https://www.twilio.com/docs/glossary/what-e164] format, which consists
+        #   of a + followed by the country code and subscriber number.
         # @return [Twilio::REST::Lookups::V1::PhoneNumberContext] if phone_number was passed.
         # @return [Twilio::REST::Lookups::V1::PhoneNumberList]
         def phone_numbers(phone_number=:unset)
           if phone_number.nil?
-            raise ArgumentError, 'phone_number cannot be nil'
-          elsif phone_number == :unset
-            @phone_numbers ||= PhoneNumberList.new self
+              raise ArgumentError, 'phone_number cannot be nil'
+          end
+          if phone_number == :unset
+              @phone_numbers ||= PhoneNumberList.new self
           else
-            PhoneNumberContext.new(self, phone_number)
+              PhoneNumberContext.new(self, phone_number)
           end
         end
 

data/lib/twilio-ruby/rest/lookups.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -27,7 +29,9 @@ module Twilio
       end
 
       ##
-      # @param [String] phone_number The phone_number
+      # @param [String] phone_number The phone number in
+      #   {E.164}[https://www.twilio.com/docs/glossary/what-e164] format, which consists
+      #   of a + followed by the country code and subscriber number.
       # @return [Twilio::REST::Lookups::V1::PhoneNumberInstance] if phone_number was passed.
       # @return [Twilio::REST::Lookups::V1::PhoneNumberList]
       def phone_numbers(phone_number=:unset)