twilio-ruby 5.5.1 → 5.58.3

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

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -21,12 +23,10 @@ module Twilio
         @deployed_devices = nil
         @hosted_numbers = nil
         @marketplace = nil
-        @proxy = nil
-        @studio = nil
-        @acc_security = nil
         @sync = nil
         @understand = nil
         @wireless = nil
+        @trusted_comms = nil
       end
 
       ##
@@ -53,24 +53,6 @@ module Twilio
         @marketplace ||= Marketplace.new self
       end
 
-      ##
-      # Version proxy of preview
-      def proxy
-        @proxy ||= Proxy.new self
-      end
-
-      ##
-      # Version studio of preview
-      def studio
-        @studio ||= Studio.new self
-      end
-
-      ##
-      # Version acc_security of preview
-      def acc_security
-        @acc_security ||= AccSecurity.new self
-      end
-
       ##
       # Version sync of preview
       def sync
@@ -90,7 +72,14 @@ module Twilio
       end
 
       ##
-      # @param [String] resource_type The resource_type
+      # Version trusted_comms of preview
+      def trusted_comms
+        @trusted_comms ||= TrustedComms.new self
+      end
+
+      ##
+      # @param [String] resource_type The type of communication – Messages, Calls,
+      #   Conferences, and Participants
       # @return [Twilio::REST::Preview::BulkExports::ExportInstance] if resource_type was passed.
       # @return [Twilio::REST::Preview::BulkExports::ExportList]
       def exports(resource_type=:unset)
@@ -98,7 +87,8 @@ module Twilio
       end
 
       ##
-      # @param [String] resource_type The resource_type
+      # @param [String] resource_type The type of communication – Messages, Calls,
+      #   Conferences, and Participants
       # @return [Twilio::REST::Preview::BulkExports::ExportConfigurationInstance] if resource_type was passed.
       # @return [Twilio::REST::Preview::BulkExports::ExportConfigurationList]
       def export_configuration(resource_type=:unset)
@@ -133,7 +123,8 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this Add-on.
+      # @param [String] sid The unique string that we created to identify the
+      #   AvailableAddOn resource.
       # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnInstance] if sid was passed.
       # @return [Twilio::REST::Preview::Marketplace::AvailableAddOnList]
       def available_add_ons(sid=:unset)
@@ -141,8 +132,9 @@ module Twilio
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this Add-on
-      #   installation.
+      # @param [String] sid The unique string that we created to identify the
+      #   InstalledAddOn resource. This Sid can also be found in the Console on that
+      #   specific Add-ons page as the 'Available Add-on Sid'.
       # @return [Twilio::REST::Preview::Marketplace::InstalledAddOnInstance] if sid was passed.
       # @return [Twilio::REST::Preview::Marketplace::InstalledAddOnList]
       def installed_add_ons(sid=:unset)
@@ -151,18 +143,19 @@ module Twilio
 
       ##
       # @param [String] sid The sid
-      # @return [Twilio::REST::Preview::Understand::ServiceInstance] if sid was passed.
-      # @return [Twilio::REST::Preview::Understand::ServiceList]
+      # @return [Twilio::REST::Preview::Sync::ServiceInstance] if sid was passed.
+      # @return [Twilio::REST::Preview::Sync::ServiceList]
       def services(sid=:unset)
-        self.understand.services(sid)
+        self.sync.services(sid)
       end
 
       ##
-      # @param [String] sid A 34 character string that uniquely identifies this Flow.
-      # @return [Twilio::REST::Preview::Studio::FlowInstance] if sid was passed.
-      # @return [Twilio::REST::Preview::Studio::FlowList]
-      def flows(sid=:unset)
-        self.studio.flows(sid)
+      # @param [String] sid A 34 character string that uniquely identifies this
+      #   resource.
+      # @return [Twilio::REST::Preview::Understand::AssistantInstance] if sid was passed.
+      # @return [Twilio::REST::Preview::Understand::AssistantList]
+      def assistants(sid=:unset)
+        self.understand.assistants(sid)
       end
 
       ##
@@ -189,6 +182,32 @@ module Twilio
         self.wireless.sims(sid)
       end
 
+      ##
+      # @param [String] sid The unique SID identifier of the Branded Channel.
+      # @return [Twilio::REST::Preview::TrustedComms::BrandedChannelInstance] if sid was passed.
+      # @return [Twilio::REST::Preview::TrustedComms::BrandedChannelList]
+      def branded_channels(sid=:unset)
+        self.trusted_comms.branded_channels(sid)
+      end
+
+      ##
+      # @return [Twilio::REST::Preview::TrustedComms::BrandsInformationInstance]
+      def brands_information
+        self.trusted_comms.brands_information()
+      end
+
+      ##
+      # @return [Twilio::REST::Preview::TrustedComms::CpsInstance]
+      def cps
+        self.trusted_comms.cps()
+      end
+
+      ##
+      # @return [Twilio::REST::Preview::TrustedComms::CurrentCallInstance]
+      def current_calls
+        self.trusted_comms.current_calls()
+      end
+
       ##
       # Provide a user friendly representation
       def to_s

data/lib/twilio-ruby/rest/pricing/v1/messaging/country.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -51,7 +53,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
@@ -63,7 +65,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],
@@ -83,11 +85,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               CountryPage.new(@version, response, @solution)
             end
 
@@ -130,7 +130,7 @@ module Twilio
             # @param [Hash] payload Payload response from the API
             # @return [CountryInstance] CountryInstance
             def get_instance(payload)
-              CountryInstance.new(@version, payload)
+              CountryInstance.new(@version, payload, )
             end
 
             ##
@@ -144,29 +144,25 @@ module Twilio
             ##
             # Initialize the CountryContext
             # @param [Version] version Version that contains the resource
-            # @param [String] iso_country The iso_country
+            # @param [String] iso_country The {ISO country
+            #   code}[http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] of the pricing
+            #   information to fetch.
             # @return [CountryContext] CountryContext
             def initialize(version, iso_country)
               super(version)
 
               # Path Solution
-              @solution = {iso_country: iso_country}
+              @solution = {iso_country: iso_country, }
               @uri = "/Messaging/Countries/#{@solution[:iso_country]}"
             end
 
             ##
-            # Fetch a CountryInstance
+            # Fetch the CountryInstance
             # @return [CountryInstance] Fetched CountryInstance
             def fetch
-              params = Twilio::Values.of({})
+              payload = @version.fetch('GET', @uri)
 
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
-
-              CountryInstance.new(@version, payload, iso_country: @solution[:iso_country])
+              CountryInstance.new(@version, payload, iso_country: @solution[:iso_country], )
             end
 
             ##
@@ -175,6 +171,13 @@ module Twilio
               context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
               "#<Twilio.Pricing.V1.CountryContext #{context}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+              "#<Twilio.Pricing.V1.CountryContext #{context}>"
+            end
           end
 
           class CountryInstance < InstanceResource
@@ -182,7 +185,9 @@ module Twilio
             # Initialize the CountryInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] iso_country The iso_country
+            # @param [String] iso_country The {ISO country
+            #   code}[http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] of the pricing
+            #   information to fetch.
             # @return [CountryInstance] CountryInstance
             def initialize(version, payload, iso_country: nil)
               super(version)
@@ -191,15 +196,15 @@ module Twilio
               @properties = {
                   'country' => payload['country'],
                   'iso_country' => payload['iso_country'],
-                  'url' => payload['url'],
                   'outbound_sms_prices' => payload['outbound_sms_prices'],
                   'inbound_sms_prices' => payload['inbound_sms_prices'],
                   'price_unit' => payload['price_unit'],
+                  'url' => payload['url'],
               }
 
               # Context
               @instance_context = nil
-              @params = {'iso_country' => iso_country || @properties['iso_country']}
+              @params = {'iso_country' => iso_country || @properties['iso_country'], }
             end
 
             ##
@@ -208,49 +213,49 @@ module Twilio
             # @return [CountryContext] CountryContext for this CountryInstance
             def context
               unless @instance_context
-                @instance_context = CountryContext.new(@version, @params['iso_country'])
+                @instance_context = CountryContext.new(@version, @params['iso_country'], )
               end
               @instance_context
             end
 
             ##
-            # @return [String] The country
+            # @return [String] The name of the country
             def country
               @properties['country']
             end
 
             ##
-            # @return [String] The iso_country
+            # @return [String] The ISO country code
             def iso_country
               @properties['iso_country']
             end
 
             ##
-            # @return [String] The outbound_sms_prices
+            # @return [Array[String]] The list of OutboundSMSPrice records
             def outbound_sms_prices
               @properties['outbound_sms_prices']
             end
 
             ##
-            # @return [String] The inbound_sms_prices
+            # @return [Array[String]] The list of InboundPrice records
             def inbound_sms_prices
               @properties['inbound_sms_prices']
             end
 
             ##
-            # @return [String] The price_unit
+            # @return [String] The currency in which prices are measured, in ISO 4127 format (e.g. usd, eur, jpy)
             def price_unit
               @properties['price_unit']
             end
 
             ##
-            # @return [String] The url
+            # @return [String] The absolute URL of the resource
             def url
               @properties['url']
             end
 
             ##
-            # Fetch a CountryInstance
+            # Fetch the CountryInstance
             # @return [CountryInstance] Fetched CountryInstance
             def fetch
               context.fetch

data/lib/twilio-ruby/rest/pricing/v1/messaging.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -25,17 +27,19 @@ module Twilio
 
           ##
           # Access the countries
-          # @param [String] iso_country The iso_country
+          # @param [String] iso_country The {ISO country
+          #   code}[http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] of the pricing
+          #   information to fetch.
           # @return [CountryList]
           # @return [CountryContext] if iso_country was passed.
           def countries(iso_country=:unset)
             raise ArgumentError, 'iso_country cannot be nil' if iso_country.nil?
 
             if iso_country != :unset
-              return CountryContext.new(@version, iso_country)
+              return CountryContext.new(@version, iso_country, )
             end
 
-              @countries ||= CountryList.new(@version)
+              @countries ||= CountryList.new(@version, )
           end
 
           ##
@@ -64,7 +68,7 @@ module Twilio
           # @param [Hash] payload Payload response from the API
           # @return [MessagingInstance] MessagingInstance
           def get_instance(payload)
-            MessagingInstance.new(@version, payload)
+            MessagingInstance.new(@version, payload, )
           end
 
           ##
@@ -84,7 +88,7 @@ module Twilio
             super(version)
 
             # Marshaled Properties
-            @properties = {'name' => payload['name'], 'url' => payload['url'], 'links' => payload['links']}
+            @properties = {'name' => payload['name'], 'url' => payload['url'], 'links' => payload['links'], }
           end
 
           ##

data/lib/twilio-ruby/rest/pricing/v1/phone_number/country.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -51,7 +53,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
@@ -63,7 +65,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],
@@ -83,11 +85,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               CountryPage.new(@version, response, @solution)
             end
 
@@ -130,7 +130,7 @@ module Twilio
             # @param [Hash] payload Payload response from the API
             # @return [CountryInstance] CountryInstance
             def get_instance(payload)
-              CountryInstance.new(@version, payload)
+              CountryInstance.new(@version, payload, )
             end
 
             ##
@@ -144,29 +144,25 @@ module Twilio
             ##
             # Initialize the CountryContext
             # @param [Version] version Version that contains the resource
-            # @param [String] iso_country The iso_country
+            # @param [String] iso_country The {ISO country
+            #   code}[http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] of the pricing
+            #   information to fetch.
             # @return [CountryContext] CountryContext
             def initialize(version, iso_country)
               super(version)
 
               # Path Solution
-              @solution = {iso_country: iso_country}
+              @solution = {iso_country: iso_country, }
               @uri = "/PhoneNumbers/Countries/#{@solution[:iso_country]}"
             end
 
             ##
-            # Fetch a CountryInstance
+            # Fetch the CountryInstance
             # @return [CountryInstance] Fetched CountryInstance
             def fetch
-              params = Twilio::Values.of({})
+              payload = @version.fetch('GET', @uri)
 
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
-
-              CountryInstance.new(@version, payload, iso_country: @solution[:iso_country])
+              CountryInstance.new(@version, payload, iso_country: @solution[:iso_country], )
             end
 
             ##
@@ -175,6 +171,13 @@ module Twilio
               context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
               "#<Twilio.Pricing.V1.CountryContext #{context}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+              "#<Twilio.Pricing.V1.CountryContext #{context}>"
+            end
           end
 
           class CountryInstance < InstanceResource
@@ -182,7 +185,9 @@ module Twilio
             # Initialize the CountryInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] iso_country The iso_country
+            # @param [String] iso_country The {ISO country
+            #   code}[http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] of the pricing
+            #   information to fetch.
             # @return [CountryInstance] CountryInstance
             def initialize(version, payload, iso_country: nil)
               super(version)
@@ -191,14 +196,14 @@ module Twilio
               @properties = {
                   'country' => payload['country'],
                   'iso_country' => payload['iso_country'],
-                  'url' => payload['url'],
                   'phone_number_prices' => payload['phone_number_prices'],
                   'price_unit' => payload['price_unit'],
+                  'url' => payload['url'],
               }
 
               # Context
               @instance_context = nil
-              @params = {'iso_country' => iso_country || @properties['iso_country']}
+              @params = {'iso_country' => iso_country || @properties['iso_country'], }
             end
 
             ##
@@ -207,43 +212,43 @@ module Twilio
             # @return [CountryContext] CountryContext for this CountryInstance
             def context
               unless @instance_context
-                @instance_context = CountryContext.new(@version, @params['iso_country'])
+                @instance_context = CountryContext.new(@version, @params['iso_country'], )
               end
               @instance_context
             end
 
             ##
-            # @return [String] The country
+            # @return [String] The name of the country
             def country
               @properties['country']
             end
 
             ##
-            # @return [String] The iso_country
+            # @return [String] The ISO country code
             def iso_country
               @properties['iso_country']
             end
 
             ##
-            # @return [String] The phone_number_prices
+            # @return [Array[String]] The list of PhoneNumberPrices records
             def phone_number_prices
               @properties['phone_number_prices']
             end
 
             ##
-            # @return [String] The price_unit
+            # @return [String] The currency in which prices are measured, in ISO 4127 format (e.g. usd, eur, jpy)
             def price_unit
               @properties['price_unit']
             end
 
             ##
-            # @return [String] The url
+            # @return [String] The absolute URL of the resource
             def url
               @properties['url']
             end
 
             ##
-            # Fetch a CountryInstance
+            # Fetch the CountryInstance
             # @return [CountryInstance] Fetched CountryInstance
             def fetch
               context.fetch

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

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -25,17 +27,19 @@ module Twilio
 
           ##
           # Access the countries
-          # @param [String] iso_country The iso_country
+          # @param [String] iso_country The {ISO country
+          #   code}[http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2] of the pricing
+          #   information to fetch.
           # @return [CountryList]
           # @return [CountryContext] if iso_country was passed.
           def countries(iso_country=:unset)
             raise ArgumentError, 'iso_country cannot be nil' if iso_country.nil?
 
             if iso_country != :unset
-              return CountryContext.new(@version, iso_country)
+              return CountryContext.new(@version, iso_country, )
             end
 
-              @countries ||= CountryList.new(@version)
+              @countries ||= CountryList.new(@version, )
           end
 
           ##
@@ -64,7 +68,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
 
           ##
@@ -84,7 +88,7 @@ module Twilio
             super(version)
 
             # Marshaled Properties
-            @properties = {'name' => payload['name'], 'url' => payload['url'], 'links' => payload['links']}
+            @properties = {'name' => payload['name'], 'url' => payload['url'], 'links' => payload['links'], }
           end
 
           ##