twilio-ruby 5.18.0 → 5.19.0

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

@@ -15,14 +15,29 @@ module Twilio
         def initialize(domain)
           super
           @version = 'v1'
+          @compositions = nil
           @composition_hooks = nil
           @composition_settings = nil
           @recordings = nil
           @recording_settings = nil
-          @compositions = nil
           @rooms = nil
         end
 
+        ##
+        # @param [String] sid The Composition Sid that uniquely identifies the Composition
+        #   to fetch.
+        # @return [Twilio::REST::Video::V1::CompositionContext] if sid was passed.
+        # @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
+          else
+            CompositionContext.new(self, sid)
+          end
+        end
+
         ##
         # @param [String] sid The Composition Hook Sid that uniquely identifies the
         #   Composition Hook to fetch.
@@ -65,21 +80,6 @@ module Twilio
           @recording_settings ||= RecordingSettingsContext.new self
         end
 
-        ##
-        # @param [String] sid The Composition Sid that uniquely identifies the Composition
-        #   to fetch.
-        # @return [Twilio::REST::Video::V1::CompositionContext] if sid was passed.
-        # @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
-          else
-            CompositionContext.new(self, sid)
-          end
-        end
-
         ##
         # @param [String] sid The Room Sid or name that uniquely identifies this resource.
         # @return [Twilio::REST::Video::V1::RoomContext] if sid was passed.

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

@@ -28,6 +28,15 @@ module Twilio
         @v1 ||= V1.new self
       end
 
+      ##
+      # @param [String] sid `CJxx…xx` A system-generated 34-character string that
+      #   uniquely identifies this Composition.
+      # @return [Twilio::REST::Video::V1::CompositionInstance] if sid was passed.
+      # @return [Twilio::REST::Video::V1::CompositionList]
+      def compositions(sid=:unset)
+        self.v1.compositions(sid)
+      end
+
       ##
       # @param [String] sid `HKxx…xx` A system-generated 34-character string that
       #   uniquely identifies this Composition Hook.
@@ -58,15 +67,6 @@ module Twilio
         self.v1.recording_settings()
       end
 
-      ##
-      # @param [String] sid `CJxx…xx` A system-generated 34-character string that
-      #   uniquely identifies this Composition.
-      # @return [Twilio::REST::Video::V1::CompositionInstance] if sid was passed.
-      # @return [Twilio::REST::Video::V1::CompositionList]
-      def compositions(sid=:unset)
-        self.v1.compositions(sid)
-      end
-
       ##
       # @param [String] sid A system-generated 34-character string that uniquely
       #   identifies this resource.

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

@@ -30,9 +30,9 @@ module Twilio
             # Retrieve a single page of BulkCountryUpdateInstance records from the API.
             # Request is executed immediately.
             # @param [String] update_request URL encoded JSON array of update objects. example
-            #   : [ { "iso_code": "GB", "low_risk_numbers_enabled": "true",
+            #   : `[ { "iso_code": "GB", "low_risk_numbers_enabled": "true",
             #   "high_risk_special_numbers_enabled":"true",
-            #   "high_risk_tollfraud_numbers_enabled": "false" } ]
+            #   "high_risk_tollfraud_numbers_enabled": "false" } ]`
             # @return [BulkCountryUpdateInstance] Newly created BulkCountryUpdateInstance
             def create(update_request: nil)
               data = Twilio::Values.of({'UpdateRequest' => update_request, })
@@ -109,7 +109,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The update_request
+            # @return [String] A URL encoded JSON array of update objects
             def update_request
               @properties['update_request']
             end

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

@@ -19,7 +19,7 @@ module Twilio
               # Initialize the HighriskSpecialPrefixList
               # @param [Version] version Version that contains the resource
               # @param [String] iso_code The [ISO country
-              #   code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
+              #   code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
               # @return [HighriskSpecialPrefixList] HighriskSpecialPrefixList
               def initialize(version, iso_code: nil)
                 super(version)
@@ -157,7 +157,7 @@ module Twilio
               # @param [Version] version Version that contains the resource
               # @param [Hash] payload payload that contains response from Twilio
               # @param [String] iso_code The [ISO country
-              #   code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
+              #   code](http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
               # @return [HighriskSpecialPrefixInstance] HighriskSpecialPrefixInstance
               def initialize(version, payload, iso_code: nil)
                 super(version)

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

@@ -38,14 +38,14 @@ module Twilio
             # @param [String] country_code Filter the results by specified [country
             #   codes](https://www.itu.int/itudoc/itu-t/ob-lists/icc/e164_763.html)
             # @param [Boolean] low_risk_numbers_enabled Filter to retrieve the country
-            #   permissions with dialing to low-risk numbers enabled set to true / false
+            #   permissions with dialing to low-risk numbers enabled. Can be: `true` or `false`.
             # @param [Boolean] high_risk_special_numbers_enabled Filter to retrieve the
-            #   country permissions with dialing to high-risk special service numbers enabled
-            #   set to true / false
+            #   country permissions with dialing to high-risk special service numbers enabled.
+            #   Can be: `true` or `false`
             # @param [Boolean] high_risk_tollfraud_numbers_enabled Filter to retrieve the
             #   country permissions with dialing to high-risk [toll
-            #   fraud](https://www.twilio.com/learn/voice-and-video/toll-fraud) numbers enabled
-            #   set to true / false
+            #   fraud](https://www.twilio.com/learn/voice-and-video/toll-fraud) numbers enabled.
+            #   Can be: `true` or `false`.
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit.  Default is no limit
             # @param [Integer] page_size Number of records to fetch per request, when
@@ -78,14 +78,14 @@ module Twilio
             # @param [String] country_code Filter the results by specified [country
             #   codes](https://www.itu.int/itudoc/itu-t/ob-lists/icc/e164_763.html)
             # @param [Boolean] low_risk_numbers_enabled Filter to retrieve the country
-            #   permissions with dialing to low-risk numbers enabled set to true / false
+            #   permissions with dialing to low-risk numbers enabled. Can be: `true` or `false`.
             # @param [Boolean] high_risk_special_numbers_enabled Filter to retrieve the
-            #   country permissions with dialing to high-risk special service numbers enabled
-            #   set to true / false
+            #   country permissions with dialing to high-risk special service numbers enabled.
+            #   Can be: `true` or `false`
             # @param [Boolean] high_risk_tollfraud_numbers_enabled Filter to retrieve the
             #   country permissions with dialing to high-risk [toll
-            #   fraud](https://www.twilio.com/learn/voice-and-video/toll-fraud) numbers enabled
-            #   set to true / false
+            #   fraud](https://www.twilio.com/learn/voice-and-video/toll-fraud) numbers enabled.
+            #   Can be: `true` or `false`.
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit. Default is no limit.
             # @param [Integer] page_size Number of records to fetch per request, when
@@ -134,14 +134,14 @@ module Twilio
             # @param [String] country_code Filter the results by specified [country
             #   codes](https://www.itu.int/itudoc/itu-t/ob-lists/icc/e164_763.html)
             # @param [Boolean] low_risk_numbers_enabled Filter to retrieve the country
-            #   permissions with dialing to low-risk numbers enabled set to true / false
+            #   permissions with dialing to low-risk numbers enabled. Can be: `true` or `false`.
             # @param [Boolean] high_risk_special_numbers_enabled Filter to retrieve the
-            #   country permissions with dialing to high-risk special service numbers enabled
-            #   set to true / false
+            #   country permissions with dialing to high-risk special service numbers enabled.
+            #   Can be: `true` or `false`
             # @param [Boolean] high_risk_tollfraud_numbers_enabled Filter to retrieve the
             #   country permissions with dialing to high-risk [toll
-            #   fraud](https://www.twilio.com/learn/voice-and-video/toll-fraud) numbers enabled
-            #   set to true / false
+            #   fraud](https://www.twilio.com/learn/voice-and-video/toll-fraud) numbers enabled.
+            #   Can be: `true` or `false`.
             # @param [String] page_token PageToken provided by the API
             # @param [Integer] page_number Page Number, this value is simply for client state
             # @param [Integer] page_size Number of records to return, defaults to 50
@@ -339,31 +339,31 @@ module Twilio
             end
 
             ##
-            # @return [Boolean] true, if dialing to low-risk numbers is enabled, else false
+            # @return [Boolean] `true`, if dialing to low-risk numbers is enabled, else `false`
             def low_risk_numbers_enabled
               @properties['low_risk_numbers_enabled']
             end
 
             ##
-            # @return [Boolean] true, if dialing to high-risk special services numbers is enabled, else false. This group of prefixes, are number ranges allocated by the corresponding country. They consist of number types such as premium numbers, special services, shared cost and others
+            # @return [Boolean] `true`, if dialing to high-risk special services numbers is enabled, else `false`
             def high_risk_special_numbers_enabled
               @properties['high_risk_special_numbers_enabled']
             end
 
             ##
-            # @return [Boolean] true, if dialing to high-risk toll fraud numbers is enabled, else false. This group of prefixes are narrow number ranges that have a high-risk of international revenue sharing fraud (IRSF) attacks also called toll fraud. The group of prefixes is formed through integration with anti-fraud databases and verified by analyzing calls on the Twilio Super Network. This group of prefixes are not available for download and are updated frequently
+            # @return [Boolean] `true`, if dialing to high-risk toll fraud numbers is enabled, else `false`
             def high_risk_tollfraud_numbers_enabled
               @properties['high_risk_tollfraud_numbers_enabled']
             end
 
             ##
-            # @return [String] The URL for this resource
+            # @return [String] The absolute URL of this resource
             def url
               @properties['url']
             end
 
             ##
-            # @return [String] The links
+            # @return [String] A list of URLs related to this resource
             def links
               @properties['links']
             end

data/lib/twilio-ruby/version.rb

@@ -1,3 +1,3 @@
 module Twilio
-    VERSION = '5.18.0'
+    VERSION = '5.19.0'
 end

data/spec/integration/api/v2010/account/sip/domain_spec.rb

@@ -52,7 +52,8 @@ describe 'Domain' do
                   "voice_method": "POST",
                   "voice_status_callback_method": "POST",
                   "voice_status_callback_url": null,
-                  "voice_url": "https://dundermifflin.example.com/twilio/app.php"
+                  "voice_url": "https://dundermifflin.example.com/twilio/app.php",
+                  "trunk_sid": "TRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
               }
           ],
           "start": 0,
@@ -141,7 +142,8 @@ describe 'Domain' do
           "voice_method": "POST",
           "voice_status_callback_method": "POST",
           "voice_status_callback_url": null,
-          "voice_url": "https://dundermifflin.example.com/twilio/app.php"
+          "voice_url": "https://dundermifflin.example.com/twilio/app.php",
+          "trunk_sid": null
       }
       ]
     ))
@@ -194,7 +196,8 @@ describe 'Domain' do
           "voice_method": "POST",
           "voice_status_callback_method": "POST",
           "voice_status_callback_url": null,
-          "voice_url": "https://dundermifflin.example.com/twilio/app.php"
+          "voice_url": "https://dundermifflin.example.com/twilio/app.php",
+          "trunk_sid": "TRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
       }
       ]
     ))
@@ -247,7 +250,8 @@ describe 'Domain' do
           "voice_method": "POST",
           "voice_status_callback_method": "POST",
           "voice_status_callback_url": null,
-          "voice_url": "https://dundermifflin.example.com/twilio/app.php"
+          "voice_url": "https://dundermifflin.example.com/twilio/app.php",
+          "trunk_sid": "TRaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
       }
       ]
     ))

data/spec/integration/insights/v1/summary_spec.rb

@@ -0,0 +1,60 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+# 
+# frozen_string_literal: true
+
+require 'spec_helper.rb'
+
+describe 'CallSummary' do
+  it "can fetch" do
+    @holodeck.mock(Twilio::Response.new(500, ''))
+
+    expect {
+      @client.insights.v1.summary('CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').fetch()
+    }.to raise_exception(Twilio::REST::TwilioError)
+
+    values = {}
+    expect(
+    @holodeck.has_request?(Holodeck::Request.new(
+        method: 'get',
+        url: 'https://insights.twilio.com/v1/Voice/CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Summary',
+    ))).to eq(true)
+  end
+
+  it "receives fetch responses" do
+    @holodeck.mock(Twilio::Response.new(
+        200,
+      %q[
+      {
+          "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "call_sid": "CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "call_type": "carrier",
+          "call_state": "ringing",
+          "processing_state": "complete",
+          "direction": "inbound",
+          "disconnected_by": "callee",
+          "start_time": "2015-07-30T20:00:00Z",
+          "end_time": "2015-07-30T20:00:00Z",
+          "duration": 100,
+          "connect_duration": 99,
+          "from": {},
+          "to": {},
+          "carrier_edge": {},
+          "client_edge": {},
+          "sip_edge": {},
+          "tags": [
+              "tags"
+          ],
+          "url": "https://insights.twilio.com/v1/Voice/CAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Summary"
+      }
+      ]
+    ))
+
+    actual = @client.insights.v1.summary('CAXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').fetch()
+
+    expect(actual).to_not eq(nil)
+  end
+end

data/spec/integration/proxy/v1/service/phone_number_spec.rb

@@ -35,7 +35,7 @@ describe 'PhoneNumber' do
           "service_sid": "KSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
           "date_created": "2015-07-30T20:00:00Z",
           "date_updated": "2015-07-30T20:00:00Z",
-          "phone_number": "+987654321",
+          "phone_number": "+1987654321",
           "friendly_name": "Friendly Name",
           "iso_country": "US",
           "capabilities": {
@@ -119,7 +119,7 @@ describe 'PhoneNumber' do
                   "sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                   "date_created": "2015-07-30T20:00:00Z",
                   "date_updated": "2015-07-30T20:00:00Z",
-                  "phone_number": "+987654321",
+                  "phone_number": "+1987654321",
                   "friendly_name": "Friendly Name",
                   "iso_country": "US",
                   "capabilities": {

data/spec/integration/proxy/v1/service/session/interaction_spec.rb

@@ -32,7 +32,7 @@ describe 'Interaction' do
       %q[
       {
           "service_sid": "KSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
-          "data": "data",
+          "data": "{\\"body\\":\\"some message\\"}",
           "date_created": "2015-07-30T20:00:00Z",
           "date_updated": "2015-07-30T20:00:00Z",
           "inbound_participant_sid": "KPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

data/spec/integration/proxy/v1/service/session/participant/message_interaction_spec.rb

@@ -33,7 +33,7 @@ describe 'MessageInteraction' do
       %q[
       {
           "service_sid": "KSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
-          "data": "body",
+          "data": "{\\"body\\":\\"some message\\"}",
           "date_created": "2015-07-30T20:00:00Z",
           "date_updated": "2015-07-30T20:00:00Z",
           "participant_sid": "KPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
@@ -88,7 +88,7 @@ describe 'MessageInteraction' do
       %q[
       {
           "service_sid": "KSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
-          "data": "data",
+          "data": "{\\"body\\":\\"some message\\"}",
           "date_created": "2015-07-30T20:00:00Z",
           "date_updated": "2015-07-30T20:00:00Z",
           "participant_sid": "KPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",

data/spec/integration/proxy/v1/service/session/participant_spec.rb

@@ -35,8 +35,8 @@ describe 'Participant' do
           "session_sid": "KCaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
           "service_sid": "KSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
           "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
-          "identifier": "identifier",
-          "proxy_identifier": "proxy_identifier",
+          "identifier": "+14155551212",
+          "proxy_identifier": "+14155559999",
           "proxy_identifier_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
           "friendly_name": "friendly_name",
           "date_deleted": "2015-07-30T20:00:00Z",
@@ -57,6 +57,37 @@ describe 'Participant' do
     expect(actual).to_not eq(nil)
   end
 
+  it "receives fetch_channel responses" do
+    @holodeck.mock(Twilio::Response.new(
+        200,
+      %q[
+      {
+          "sid": "KPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "session_sid": "KCaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "service_sid": "KSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "identifier": "messenger:14155551212",
+          "proxy_identifier": "messenger:14155559999",
+          "proxy_identifier_sid": "XEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "friendly_name": "a facebook user",
+          "date_deleted": "2015-07-30T20:00:00Z",
+          "date_updated": "2015-07-30T20:00:00Z",
+          "date_created": "2015-07-30T20:00:00Z",
+          "url": "https://proxy.twilio.com/v1/Services/KSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Sessions/KCaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants/KPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "links": {
+              "message_interactions": "https://proxy.twilio.com/v1/Services/KSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Sessions/KCaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants/KPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/MessageInteractions"
+          }
+      }
+      ]
+    ))
+
+    actual = @client.proxy.v1.services('KSXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                             .sessions('KCXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                             .participants('KPXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').fetch()
+
+    expect(actual).to_not eq(nil)
+  end
+
   it "can read" do
     @holodeck.mock(Twilio::Response.new(500, ''))
 
@@ -127,8 +158,8 @@ describe 'Participant' do
           "session_sid": "KCaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
           "service_sid": "KSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
           "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
-          "identifier": "identifier",
-          "proxy_identifier": "proxy_identifier",
+          "identifier": "+14155551212",
+          "proxy_identifier": "+14155559999",
           "proxy_identifier_sid": "PNaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
           "friendly_name": "friendly_name",
           "date_deleted": "2015-07-30T20:00:00Z",
@@ -149,6 +180,37 @@ describe 'Participant' do
     expect(actual).to_not eq(nil)
   end
 
+  it "receives create_channel responses" do
+    @holodeck.mock(Twilio::Response.new(
+        201,
+      %q[
+      {
+          "sid": "KPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "session_sid": "KCaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "service_sid": "KSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "identifier": "messenger:123456",
+          "proxy_identifier": "messenger:987654532",
+          "proxy_identifier_sid": "XEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "friendly_name": "a facebook user",
+          "date_deleted": "2015-07-30T20:00:00Z",
+          "date_updated": "2015-07-30T20:00:00Z",
+          "date_created": "2015-07-30T20:00:00Z",
+          "url": "https://proxy.twilio.com/v1/Services/KSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Sessions/KCaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants/KPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
+          "links": {
+              "message_interactions": "https://proxy.twilio.com/v1/Services/KSaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Sessions/KCaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants/KPaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/MessageInteractions"
+          }
+      }
+      ]
+    ))
+
+    actual = @client.proxy.v1.services('KSXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                             .sessions('KCXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                             .participants.create(identifier: 'identifier')
+
+    expect(actual).to_not eq(nil)
+  end
+
   it "can delete" do
     @holodeck.mock(Twilio::Response.new(500, ''))