twilio-ruby 5.45.0 → 5.60.0

data/lib/twilio-ruby/rest/video/v1/room/room_participant/room_participant_subscribe_rule.rb

@@ -138,7 +138,7 @@ module Twilio
               end
 
               ##
-              # @return [String] A collection of Subscribe Rules that describe how to include or exclude matching tracks
+              # @return [Array[String]] A collection of Subscribe Rules that describe how to include or exclude matching tracks
               def rules
                 @properties['rules']
               end

data/lib/twilio-ruby/rest/video/v1/room/room_recording_rule.rb

@@ -11,8 +11,6 @@ module Twilio
     class Video < Domain
       class V1 < Version
         class RoomContext < InstanceContext
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class RecordingRulesList < ListResource
             ##
             # Initialize the RecordingRulesList
@@ -55,8 +53,6 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class RecordingRulesPage < Page
             ##
             # Initialize the RecordingRulesPage
@@ -86,8 +82,6 @@ module Twilio
             end
           end
 
-          ##
-          # PLEASE NOTE that this class contains beta products that are subject to change. Use them with caution.
           class RecordingRulesInstance < InstanceResource
             ##
             # Initialize the RecordingRulesInstance
@@ -114,7 +108,7 @@ module Twilio
             end
 
             ##
-            # @return [String] A collection of recording Rules that describe how to include or exclude matching tracks for recording
+            # @return [Array[String]] A collection of recording Rules that describe how to include or exclude matching tracks for recording
             def rules
               @properties['rules']
             end

data/lib/twilio-ruby/rest/video/v1/room.rb

@@ -48,15 +48,20 @@ module Twilio
           # @param [Boolean] record_participants_on_connect Whether to start recording when
           #   Participants connect. ***This feature is not available in `peer-to-peer`
           #   rooms.***
-          # @param [room.VideoCodec] video_codecs An array of the video codecs that are
-          #   supported when publishing a track in the room.  Can be: `VP8` and `H264`.
+          # @param [Array[room.VideoCodec]] video_codecs An array of the video codecs that
+          #   are supported when publishing a track in the room.  Can be: `VP8` and `H264`.
           #   ***This feature is not available in `peer-to-peer` rooms***
           # @param [String] media_region The region for the media server in Group Rooms.
           #   Can be: one of the {available Media
           #   Regions}[https://www.twilio.com/docs/video/ip-address-whitelisting#group-rooms-media-servers].
           #   ***This feature is not available in `peer-to-peer` rooms.***
+          # @param [Hash] recording_rules A collection of Recording Rules that describe how
+          #   to include or exclude matching tracks for recording
+          # @param [Boolean] audio_only When set to true, indicates that the participants in
+          #   the room will only publish audio. No video tracks will be allowed. Group rooms
+          #   only.
           # @return [RoomInstance] Created RoomInstance
-          def create(enable_turn: :unset, type: :unset, unique_name: :unset, status_callback: :unset, status_callback_method: :unset, max_participants: :unset, record_participants_on_connect: :unset, video_codecs: :unset, media_region: :unset)
+          def create(enable_turn: :unset, type: :unset, unique_name: :unset, status_callback: :unset, status_callback_method: :unset, max_participants: :unset, record_participants_on_connect: :unset, video_codecs: :unset, media_region: :unset, recording_rules: :unset, audio_only: :unset)
             data = Twilio::Values.of({
                 'EnableTurn' => enable_turn,
                 'Type' => type,
@@ -67,6 +72,8 @@ module Twilio
                 'RecordParticipantsOnConnect' => record_participants_on_connect,
                 'VideoCodecs' => Twilio.serialize_list(video_codecs) { |e| e },
                 'MediaRegion' => media_region,
+                'RecordingRules' => Twilio.serialize_object(recording_rules),
+                'AudioOnly' => audio_only,
             })
 
             payload = @version.create('POST', @uri, data: data)
@@ -357,9 +364,11 @@ module Twilio
                 'duration' => payload['duration'] == nil ? payload['duration'] : payload['duration'].to_i,
                 'type' => payload['type'],
                 'max_participants' => payload['max_participants'].to_i,
+                'max_concurrent_published_tracks' => payload['max_concurrent_published_tracks'] == nil ? payload['max_concurrent_published_tracks'] : payload['max_concurrent_published_tracks'].to_i,
                 'record_participants_on_connect' => payload['record_participants_on_connect'],
                 'video_codecs' => payload['video_codecs'],
                 'media_region' => payload['media_region'],
+                'audio_only' => payload['audio_only'],
                 'url' => payload['url'],
                 'links' => payload['links'],
             }
@@ -458,6 +467,12 @@ module Twilio
             @properties['max_participants']
           end
 
+          ##
+          # @return [String] The maximum number of published tracks allowed in the room at the same time
+          def max_concurrent_published_tracks
+            @properties['max_concurrent_published_tracks']
+          end
+
           ##
           # @return [Boolean] Whether to start recording when Participants connect
           def record_participants_on_connect
@@ -465,7 +480,7 @@ module Twilio
           end
 
           ##
-          # @return [room.VideoCodec] An array of the video codecs that are supported when publishing a track in the room
+          # @return [Array[room.VideoCodec]] An array of the video codecs that are supported when publishing a track in the room
           def video_codecs
             @properties['video_codecs']
           end
@@ -476,6 +491,12 @@ module Twilio
             @properties['media_region']
           end
 
+          ##
+          # @return [Boolean] Indicates whether the room will only contain audio track participants for group rooms.
+          def audio_only
+            @properties['audio_only']
+          end
+
           ##
           # @return [String] The absolute URL of the resource
           def url

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

@@ -29,11 +29,12 @@ module Twilio
         # @return [Twilio::REST::Video::V1::CompositionList]
         def compositions(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @compositions ||= CompositionList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @compositions ||= CompositionList.new self
           else
-            CompositionContext.new(self, sid)
+              CompositionContext.new(self, sid)
           end
         end
 
@@ -43,11 +44,12 @@ module Twilio
         # @return [Twilio::REST::Video::V1::CompositionHookList]
         def composition_hooks(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @composition_hooks ||= CompositionHookList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @composition_hooks ||= CompositionHookList.new self
           else
-            CompositionHookContext.new(self, sid)
+              CompositionHookContext.new(self, sid)
           end
         end
 
@@ -63,11 +65,12 @@ module Twilio
         # @return [Twilio::REST::Video::V1::RecordingList]
         def recordings(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @recordings ||= RecordingList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @recordings ||= RecordingList.new self
           else
-            RecordingContext.new(self, sid)
+              RecordingContext.new(self, sid)
           end
         end
 
@@ -83,11 +86,12 @@ module Twilio
         # @return [Twilio::REST::Video::V1::RoomList]
         def rooms(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @rooms ||= RoomList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @rooms ||= RoomList.new self
           else
-            RoomContext.new(self, sid)
+              RoomContext.new(self, sid)
           end
         end
 

data/lib/twilio-ruby/rest/voice/v1/dialing_permissions/country.rb

@@ -334,7 +334,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The E.164 assigned country codes(s)
+            # @return [Array[String]] The E.164 assigned country codes(s)
             def country_codes
               @properties['country_codes']
             end

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

@@ -29,11 +29,12 @@ module Twilio
         # @return [Twilio::REST::Voice::V1::ByocTrunkList]
         def byoc_trunks(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @byoc_trunks ||= ByocTrunkList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @byoc_trunks ||= ByocTrunkList.new self
           else
-            ByocTrunkContext.new(self, sid)
+              ByocTrunkContext.new(self, sid)
           end
         end
 
@@ -44,11 +45,12 @@ module Twilio
         # @return [Twilio::REST::Voice::V1::ConnectionPolicyList]
         def connection_policies(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @connection_policies ||= ConnectionPolicyList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @connection_policies ||= ConnectionPolicyList.new self
           else
-            ConnectionPolicyContext.new(self, sid)
+              ConnectionPolicyContext.new(self, sid)
           end
         end
 
@@ -65,11 +67,12 @@ module Twilio
         # @return [Twilio::REST::Voice::V1::IpRecordList]
         def ip_records(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @ip_records ||= IpRecordList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @ip_records ||= IpRecordList.new self
           else
-            IpRecordContext.new(self, sid)
+              IpRecordContext.new(self, sid)
           end
         end
 
@@ -80,11 +83,12 @@ module Twilio
         # @return [Twilio::REST::Voice::V1::SourceIpMappingList]
         def source_ip_mappings(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @source_ip_mappings ||= SourceIpMappingList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @source_ip_mappings ||= SourceIpMappingList.new self
           else
-            SourceIpMappingContext.new(self, sid)
+              SourceIpMappingContext.new(self, sid)
           end
         end
 

data/lib/twilio-ruby/rest/wireless/v1/rate_plan.rb

@@ -127,9 +127,9 @@ module Twilio
           # @param [Boolean] national_roaming_enabled Whether SIMs can roam on networks
           #   other than the home network (T-Mobile USA) in the United States. See {national
           #   roaming}[https://www.twilio.com/docs/wireless/api/rateplan-resource#national-roaming].
-          # @param [String] international_roaming The list of services that SIMs capable of
-          #   using GPRS/3G/4G/LTE data connectivity can use outside of the United States. Can
-          #   be: `data`, `voice`, and `messaging`.
+          # @param [Array[String]] international_roaming The list of services that SIMs
+          #   capable of using GPRS/3G/4G/LTE data connectivity can use outside of the United
+          #   States. Can be: `data`, `voice`, and `messaging`.
           # @param [String] national_roaming_data_limit The total data usage (download and
           #   upload combined) in Megabytes that the Network allows during one month on
           #   non-home networks in the United States. The metering period begins the day of
@@ -371,7 +371,7 @@ module Twilio
           end
 
           ##
-          # @return [String] The services that SIMs capable of using GPRS/3G/4G/LTE data connectivity can use outside of the United States
+          # @return [Array[String]] The services that SIMs capable of using GPRS/3G/4G/LTE data connectivity can use outside of the United States
           def international_roaming
             @properties['international_roaming']
           end

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

@@ -33,11 +33,12 @@ module Twilio
         # @return [Twilio::REST::Wireless::V1::CommandList]
         def commands(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @commands ||= CommandList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @commands ||= CommandList.new self
           else
-            CommandContext.new(self, sid)
+              CommandContext.new(self, sid)
           end
         end
 
@@ -47,11 +48,12 @@ module Twilio
         # @return [Twilio::REST::Wireless::V1::RatePlanList]
         def rate_plans(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @rate_plans ||= RatePlanList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @rate_plans ||= RatePlanList.new self
           else
-            RatePlanContext.new(self, sid)
+              RatePlanContext.new(self, sid)
           end
         end
 
@@ -61,11 +63,12 @@ module Twilio
         # @return [Twilio::REST::Wireless::V1::SimList]
         def sims(sid=:unset)
           if sid.nil?
-            raise ArgumentError, 'sid cannot be nil'
-          elsif sid == :unset
-            @sims ||= SimList.new self
+              raise ArgumentError, 'sid cannot be nil'
+          end
+          if sid == :unset
+              @sims ||= SimList.new self
           else
-            SimContext.new(self, sid)
+              SimContext.new(self, sid)
           end
         end
 

data/lib/twilio-ruby/rest.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+Dir[File.join(__dir__, 'framework/rest/*.rb')].sort.each do |file|
+  require file
+end
+
+Dir[File.join(__dir__, 'rest/*.rb')].sort.each do |file|
+  require file
+end
+
+Dir[File.join(__dir__, 'rest/**/*.rb')].sort.each do |file|
+  require file
+end

data/lib/twilio-ruby/twiml/voice_response.rb

@@ -47,9 +47,12 @@ module Twilio
       # answer_on_bridge:: Preserve the ringing behavior of the inbound call until the Dialed call picks up
       # ring_tone:: Ringtone allows you to override the ringback tone that Twilio will play back to the caller while executing the Dial
       # recording_track:: To indicate which audio track should be recorded
+      # sequential:: Used to determine if child TwiML nouns should be dialed in order, one after the other (sequential) or dial all at once (parallel). Default is false, parallel
+      # refer_url:: Webhook that will receive future SIP REFER requests
+      # refer_method:: The HTTP method to use for the refer Webhook
       # keyword_args:: additional attributes
-      def dial(number: nil, action: nil, method: nil, timeout: nil, hangup_on_star: nil, time_limit: nil, caller_id: nil, record: nil, trim: nil, recording_status_callback: nil, recording_status_callback_method: nil, recording_status_callback_event: nil, answer_on_bridge: nil, ring_tone: nil, recording_track: nil, **keyword_args)
-        dial = Dial.new(number: number, action: action, method: method, timeout: timeout, hangup_on_star: hangup_on_star, time_limit: time_limit, caller_id: caller_id, record: record, trim: trim, recording_status_callback: recording_status_callback, recording_status_callback_method: recording_status_callback_method, recording_status_callback_event: recording_status_callback_event, answer_on_bridge: answer_on_bridge, ring_tone: ring_tone, recording_track: recording_track, **keyword_args)
+      def dial(number: nil, action: nil, method: nil, timeout: nil, hangup_on_star: nil, time_limit: nil, caller_id: nil, record: nil, trim: nil, recording_status_callback: nil, recording_status_callback_method: nil, recording_status_callback_event: nil, answer_on_bridge: nil, ring_tone: nil, recording_track: nil, sequential: nil, refer_url: nil, refer_method: nil, **keyword_args)
+        dial = Dial.new(number: number, action: action, method: method, timeout: timeout, hangup_on_star: hangup_on_star, time_limit: time_limit, caller_id: caller_id, record: record, trim: trim, recording_status_callback: recording_status_callback, recording_status_callback_method: recording_status_callback_method, recording_status_callback_event: recording_status_callback_event, answer_on_bridge: answer_on_bridge, ring_tone: ring_tone, recording_track: recording_track, sequential: sequential, refer_url: refer_url, refer_method: refer_method, **keyword_args)
 
         yield(dial) if block_given?
         append(dial)
@@ -336,9 +339,11 @@ module Twilio
       # connector_name:: Unique name for Stream Connector
       # url:: URL of the remote service where the Stream is routed
       # track:: Track to be streamed to remote service
+      # status_callback:: Status Callback URL
+      # status_callback_method:: Status Callback URL method
       # keyword_args:: additional attributes
-      def stream(name: nil, connector_name: nil, url: nil, track: nil, **keyword_args)
-        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, **keyword_args)
+      def stream(name: nil, connector_name: nil, url: nil, track: nil, status_callback: nil, status_callback_method: nil, **keyword_args)
+        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, status_callback: status_callback, status_callback_method: status_callback_method, **keyword_args)
 
         yield(stream) if block_given?
         append(stream)
@@ -425,9 +430,11 @@ module Twilio
       # connector_name:: Unique name for Stream Connector
       # url:: URL of the remote service where the Stream is routed
       # track:: Track to be streamed to remote service
+      # status_callback:: Status Callback URL
+      # status_callback_method:: Status Callback URL method
       # keyword_args:: additional attributes
-      def stream(name: nil, connector_name: nil, url: nil, track: nil, **keyword_args)
-        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, **keyword_args)
+      def stream(name: nil, connector_name: nil, url: nil, track: nil, status_callback: nil, status_callback_method: nil, **keyword_args)
+        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, status_callback: status_callback, status_callback_method: status_callback_method, **keyword_args)
 
         yield(stream) if block_given?
         append(stream)
@@ -1143,13 +1150,37 @@ module Twilio
       # connector_name:: Unique name for Stream Connector
       # url:: URL of the remote service where the Stream is routed
       # track:: Track to be streamed to remote service
+      # status_callback:: Status Callback URL
+      # status_callback_method:: Status Callback URL method
       # keyword_args:: additional attributes
-      def stream(name: nil, connector_name: nil, url: nil, track: nil, **keyword_args)
-        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, **keyword_args)
+      def stream(name: nil, connector_name: nil, url: nil, track: nil, status_callback: nil, status_callback_method: nil, **keyword_args)
+        stream = Stream.new(name: name, connector_name: connector_name, url: url, track: track, status_callback: status_callback, status_callback_method: status_callback_method, **keyword_args)
 
         yield(stream) if block_given?
         append(stream)
       end
+
+      ##
+      # Create a new <VirtualAgent> element
+      # connector_name:: Defines the conversation profile Dialogflow needs to use
+      # language:: Language to be used by Dialogflow to transcribe speech
+      # sentiment_analysis:: Whether sentiment analysis needs to be enabled or not
+      # status_callback:: URL to post status callbacks from Twilio
+      # keyword_args:: additional attributes
+      def virtual_agent(connector_name: nil, language: nil, sentiment_analysis: nil, status_callback: nil, **keyword_args)
+        append(VirtualAgent.new(connector_name: connector_name, language: language, sentiment_analysis: sentiment_analysis, status_callback: status_callback, **keyword_args))
+      end
+    end
+
+    ##
+    # <VirtualAgent> TwiML Noun
+    class VirtualAgent < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'VirtualAgent'
+
+        yield(self) if block_given?
+      end
     end
 
     ##

data/lib/twilio-ruby/version.rb

@@ -1,3 +1,3 @@
 module Twilio
-    VERSION = '5.45.0'
+    VERSION = '5.60.0'
 end

data/lib/twilio-ruby.rb

@@ -16,27 +16,17 @@ require 'twilio-ruby/util'
 require 'twilio-ruby/security/request_validator'
 require 'twilio-ruby/util/configuration'
 
-Dir[File.dirname(__FILE__) + '/twilio-ruby/http/**/*.rb'].sort.each do |file|
-  require file
-end
-Dir[File.dirname(__FILE__) + '/twilio-ruby/framework/**/*.rb'].sort.each do |file|
-  require file
-end
-Dir[File.dirname(__FILE__) + '/twilio-ruby/rest/*.rb'].sort.each do |file|
-  require file
-end
-Dir[File.dirname(__FILE__) + '/twilio-ruby/rest/**/*.rb'].sort.each do |file|
-  require file
-end
-Dir[File.dirname(__FILE__) + '/twilio-ruby/compatibility/**/*.rb'].sort.each do |file|
+Dir[File.join(__dir__, 'twilio-ruby/framework/*.rb')].sort.each do |file|
   require file
 end
 
 module Twilio
   extend SingleForwardable
 
-  autoload :JWT, File.join(File.dirname(__FILE__), 'twilio-ruby', 'jwt', 'jwt.rb')
-  autoload :TwiML, File.join(File.dirname(__FILE__), 'twilio-ruby', 'twiml', 'twiml.rb')
+  autoload :JWT, File.join(__dir__, 'twilio-ruby', 'jwt', 'jwt.rb')
+  autoload :TwiML, File.join(__dir__, 'twilio-ruby', 'twiml', 'twiml.rb')
+  autoload :HTTP, File.join(__dir__, 'twilio-ruby', 'http.rb')
+  autoload :REST, File.join(__dir__, 'twilio-ruby', 'rest.rb')
 
   def_delegators :configuration, :account_sid, :auth_token, :http_client, :region, :edge, :logger
 

data/sonar-project.properties

@@ -0,0 +1,13 @@
+sonar.projectKey=twilio_twilio-ruby
+sonar.projectName=twilio-ruby
+sonar.organization=twilio
+
+sonar.sources=lib/twilio-ruby
+# Exclude any auto-generated source code
+sonar.exclusions=lib/twilio-ruby/rest/**/*
+sonar.tests=spec/
+# Exclude any auto-generated integration tests
+sonar.test.exclusions=spec/integration/**/*.spec.rb
+
+# For Code Coverage analysis
+sonar.ruby.coverage.reportPaths=coverage/.resultset.sonarqube.json

data/twilio-ruby.gemspec

@@ -16,7 +16,7 @@ Gem::Specification.new do |spec|
   spec.license       = 'MIT'
   spec.metadata      = { 'yard.run' => 'yri' } # use "yard" to build full HTML docs
 
-  spec.files         = `git ls-files -z`.split("\x0")
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match?(%r{^(spec)/}) }
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ['lib']