twilio-ruby 5.10.2 → 5.10.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b8f3bb7818ab79d0310f3aa52a686aa21a0404c0
-  data.tar.gz: f21379efc9736fc94cff5e7d456730b19284313e
+  metadata.gz: 2b37be8aeab93417e7fe86ce12826f450a22f333
+  data.tar.gz: 9e77d51ce0e0d7825dbad1fed1a88810abff0a18
 SHA512:
-  metadata.gz: d0368ed2a1c4b9cdd40ed62e86e59e5aeac6fc4db02e48c4d9b935923f4e1f64cd45ad0202442b586002cb23e403eb4e60d29a817df90085c75fde850ef09a7b
-  data.tar.gz: 8f713191f1498c852389dd3b3d683c14367fb7302bc56ebe17100696c226a5f0deb31d70491ccdbdd73e887a636540a76cbb939ccc544d881cb7263c3222c7cd
+  metadata.gz: 882f6fa1a1b4220bbd2b14783ec0832114ca4322e6c37ab687f27f435f9c4ee49f70004be406a35115e9958b12eb0618b6940ee9f4f125a2d0bd749eaaa013c1
+  data.tar.gz: 3ceb3919d9890622266da701edc5aa13531021516a40d28f317f6b21c7f01b197bf33f4160a6ff3b66de281018d9042fbfa8e49ab6ebff481643613df06b5fd2

data/CHANGES.md

@@ -1,6 +1,20 @@
 twilio-ruby changelog
 =====================
 
+[2018-06-04] Version 5.10.3
+----------------------------
+**Library**
+- PR #409: Switch to single quotes for rubocop. Thanks to @cjcodes!
+- PR #407: Allows developers to add comments to TwiML. Thanks to @philnash!
+- PR #405: Update description. Thanks to @efossier!
+
+**Chat**
+- Add Binding and UserBinding documentation
+
+**Lookups**
+- Add back support for `fraud` lookup type
+
+
 [2018-05-25] Version 5.10.2
 ----------------------------
 **Studio**

data/README.md

@@ -27,13 +27,13 @@ in-line code documentation here in the library.
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.10.2'
+gem 'twilio-ruby', '~> 5.10.3'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.10.2
+gem install twilio-ruby -v 5.10.3
 ```
 
 To build and install the development branch yourself from the latest source:

data/lib/twilio-ruby/rest/chat/v2/service/binding.rb

@@ -15,7 +15,9 @@ module Twilio
             ##
             # Initialize the BindingList
             # @param [Version] version Version that contains the resource
-            # @param [String] service_sid The service_sid
+            # @param [String] service_sid The unique id of the
+            #   [Service](https://www.twilio.com/docs/api/chat/rest/services) this binding
+            #   belongs to.
             # @return [BindingList] BindingList
             def initialize(version, service_sid: nil)
               super(version)
@@ -29,7 +31,11 @@ module Twilio
             # Lists BindingInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
-            # @param [binding.BindingType] binding_type The binding_type
+            # @param [binding.BindingType] binding_type The push technology used for the
+            #   returned Bindings.  Supported values are apn, gcm and fcm.  See [push
+            #   notification
+            #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+            #   for more information.
             # @param [String] identity The identity
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit.  Default is no limit
@@ -51,7 +57,11 @@ module Twilio
             # Streams BindingInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
-            # @param [binding.BindingType] binding_type The binding_type
+            # @param [binding.BindingType] binding_type The push technology used for the
+            #   returned Bindings.  Supported values are apn, gcm and fcm.  See [push
+            #   notification
+            #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+            #   for more information.
             # @param [String] identity The identity
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit. Default is no limit.
@@ -85,7 +95,11 @@ module Twilio
             ##
             # Retrieve a single page of BindingInstance records from the API.
             # Request is executed immediately.
-            # @param [binding.BindingType] binding_type The binding_type
+            # @param [binding.BindingType] binding_type The push technology used for the
+            #   returned Bindings.  Supported values are apn, gcm and fcm.  See [push
+            #   notification
+            #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+            #   for more information.
             # @param [String] identity The identity
             # @param [String] page_token PageToken provided by the API
             # @param [Integer] page_number Page Number, this value is simply for client state
@@ -206,7 +220,9 @@ module Twilio
             # Initialize the BindingInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] service_sid The service_sid
+            # @param [String] service_sid The unique id of the
+            #   [Service](https://www.twilio.com/docs/api/chat/rest/services) this binding
+            #   belongs to.
             # @param [String] sid The sid
             # @return [BindingInstance] BindingInstance
             def initialize(version, payload, service_sid: nil, sid: nil)
@@ -245,73 +261,73 @@ module Twilio
             end
 
             ##
-            # @return [String] The sid
+            # @return [String] A 34 character string that uniquely identifies this resource.
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] The account_sid
+            # @return [String] The unique id of the Account responsible for this binding.
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The service_sid
+            # @return [String] The unique id of the Service this binding belongs to.
             def service_sid
               @properties['service_sid']
             end
 
             ##
-            # @return [Time] The date_created
+            # @return [Time] The date that this resource was created.
             def date_created
               @properties['date_created']
             end
 
             ##
-            # @return [Time] The date_updated
+            # @return [Time] The date that this resource was last updated.
             def date_updated
               @properties['date_updated']
             end
 
             ##
-            # @return [String] The endpoint
+            # @return [String] The unique endpoint identifier for this Binding.
             def endpoint
               @properties['endpoint']
             end
 
             ##
-            # @return [String] The identity
+            # @return [String] A unique string identifier for the Binding for this User in this Service.
             def identity
               @properties['identity']
             end
 
             ##
-            # @return [String] The credential_sid
+            # @return [String] The unique id of the Credential for this binding.
             def credential_sid
               @properties['credential_sid']
             end
 
             ##
-            # @return [binding.BindingType] The binding_type
+            # @return [binding.BindingType] The push technology to use for this binding.
             def binding_type
               @properties['binding_type']
             end
 
             ##
-            # @return [String] The message_types
+            # @return [String] List of message types for this binding.
             def message_types
               @properties['message_types']
             end
 
             ##
-            # @return [String] The url
+            # @return [String] An absolute URL for this binding.
             def url
               @properties['url']
             end
 
             ##
-            # @return [String] The links
+            # @return [String] Absolute URLs to access the Users for this Binding.
             def links
               @properties['links']
             end

data/lib/twilio-ruby/rest/chat/v2/service/user/user_binding.rb

@@ -16,8 +16,14 @@ module Twilio
               ##
               # Initialize the UserBindingList
               # @param [Version] version Version that contains the resource
-              # @param [String] service_sid The service_sid
-              # @param [String] user_sid The user_sid
+              # @param [String] service_sid The unique id of the
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/services) this binding
+              #   belongs to.
+              # @param [String] user_sid The unique id of the
+              #   [User](https://www.twilio.com/docs/api/chat/rest/users) for this binding.  See
+              #   [push notification
+              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   for more information.
               # @return [UserBindingList] UserBindingList
               def initialize(version, service_sid: nil, user_sid: nil)
                 super(version)
@@ -31,7 +37,11 @@ module Twilio
               # Lists UserBindingInstance records from the API as a list.
               # Unlike stream(), this operation is eager and will load `limit` records into
               # memory before returning.
-              # @param [user_binding.BindingType] binding_type The binding_type
+              # @param [user_binding.BindingType] binding_type The push technology used for the
+              #   returned Bindings.  Supported values are apn, gcm and fcm.  See [push
+              #   notification
+              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   for more information.
               # @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
@@ -47,7 +57,11 @@ module Twilio
               # Streams UserBindingInstance records from the API as an Enumerable.
               # This operation lazily loads records as efficiently as possible until the limit
               # is reached.
-              # @param [user_binding.BindingType] binding_type The binding_type
+              # @param [user_binding.BindingType] binding_type The push technology used for the
+              #   returned Bindings.  Supported values are apn, gcm and fcm.  See [push
+              #   notification
+              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   for more information.
               # @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
@@ -80,7 +94,11 @@ module Twilio
               ##
               # Retrieve a single page of UserBindingInstance records from the API.
               # Request is executed immediately.
-              # @param [user_binding.BindingType] binding_type The binding_type
+              # @param [user_binding.BindingType] binding_type The push technology used for the
+              #   returned Bindings.  Supported values are apn, gcm and fcm.  See [push
+              #   notification
+              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   for more information.
               # @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
@@ -211,8 +229,14 @@ module Twilio
               # Initialize the UserBindingInstance
               # @param [Version] version Version that contains the resource
               # @param [Hash] payload payload that contains response from Twilio
-              # @param [String] service_sid The service_sid
-              # @param [String] user_sid The user_sid
+              # @param [String] service_sid The unique id of the
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/services) this binding
+              #   belongs to.
+              # @param [String] user_sid The unique id of the
+              #   [User](https://www.twilio.com/docs/api/chat/rest/users) for this binding.  See
+              #   [push notification
+              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   for more information.
               # @param [String] sid The sid
               # @return [UserBindingInstance] UserBindingInstance
               def initialize(version, payload, service_sid: nil, user_sid: nil, sid: nil)
@@ -256,73 +280,73 @@ module Twilio
               end
 
               ##
-              # @return [String] The sid
+              # @return [String] A 34 character string that uniquely identifies this resource.
               def sid
                 @properties['sid']
               end
 
               ##
-              # @return [String] The account_sid
+              # @return [String] The unique id of the Account responsible for this binding.
               def account_sid
                 @properties['account_sid']
               end
 
               ##
-              # @return [String] The service_sid
+              # @return [String] The unique id of the Service this binding belongs to.
               def service_sid
                 @properties['service_sid']
               end
 
               ##
-              # @return [Time] The date_created
+              # @return [Time] The date that this resource was created.
               def date_created
                 @properties['date_created']
               end
 
               ##
-              # @return [Time] The date_updated
+              # @return [Time] The date that this resource was last updated.
               def date_updated
                 @properties['date_updated']
               end
 
               ##
-              # @return [String] The endpoint
+              # @return [String] The unique endpoint identifier for this Binding.
               def endpoint
                 @properties['endpoint']
               end
 
               ##
-              # @return [String] The identity
+              # @return [String] A unique string identifier for the Binding for this User in this Service.
               def identity
                 @properties['identity']
               end
 
               ##
-              # @return [String] The user_sid
+              # @return [String] The unique id of the User for this binding.
               def user_sid
                 @properties['user_sid']
               end
 
               ##
-              # @return [String] The credential_sid
+              # @return [String] The unique id of the Credential for this binding.
               def credential_sid
                 @properties['credential_sid']
               end
 
               ##
-              # @return [user_binding.BindingType] The binding_type
+              # @return [user_binding.BindingType] The push technology to use for this binding.
               def binding_type
                 @properties['binding_type']
               end
 
               ##
-              # @return [String] The message_types
+              # @return [String] List of message types for this binding.
               def message_types
                 @properties['message_types']
               end
 
               ##
-              # @return [String] The url
+              # @return [String] An absolute URL for this binding.
               def url
                 @properties['url']
               end

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

@@ -15,7 +15,9 @@ module Twilio
             ##
             # Initialize the BindingList
             # @param [Version] version Version that contains the resource
-            # @param [String] service_sid The service_sid
+            # @param [String] service_sid The unique id of the
+            #   [Service](https://www.twilio.com/docs/api/chat/rest/services) this binding
+            #   belongs to.
             # @return [BindingList] BindingList
             def initialize(version, service_sid: nil)
               super(version)
@@ -29,7 +31,11 @@ module Twilio
             # Lists BindingInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
-            # @param [binding.BindingType] binding_type The binding_type
+            # @param [binding.BindingType] binding_type The push technology used for the
+            #   returned Bindings.  Supported values are apn, gcm and fcm.  See [push
+            #   notification
+            #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+            #   for more information.
             # @param [String] identity The identity
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit.  Default is no limit
@@ -51,7 +57,11 @@ module Twilio
             # Streams BindingInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
-            # @param [binding.BindingType] binding_type The binding_type
+            # @param [binding.BindingType] binding_type The push technology used for the
+            #   returned Bindings.  Supported values are apn, gcm and fcm.  See [push
+            #   notification
+            #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+            #   for more information.
             # @param [String] identity The identity
             # @param [Integer] limit Upper limit for the number of records to return. stream()
             #    guarantees to never return more than limit. Default is no limit.
@@ -85,7 +95,11 @@ module Twilio
             ##
             # Retrieve a single page of BindingInstance records from the API.
             # Request is executed immediately.
-            # @param [binding.BindingType] binding_type The binding_type
+            # @param [binding.BindingType] binding_type The push technology used for the
+            #   returned Bindings.  Supported values are apn, gcm and fcm.  See [push
+            #   notification
+            #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+            #   for more information.
             # @param [String] identity The identity
             # @param [String] page_token PageToken provided by the API
             # @param [Integer] page_number Page Number, this value is simply for client state
@@ -206,7 +220,9 @@ module Twilio
             # Initialize the BindingInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] service_sid The service_sid
+            # @param [String] service_sid The unique id of the
+            #   [Service](https://www.twilio.com/docs/api/chat/rest/services) this binding
+            #   belongs to.
             # @param [String] sid The sid
             # @return [BindingInstance] BindingInstance
             def initialize(version, payload, service_sid: nil, sid: nil)
@@ -245,73 +261,73 @@ module Twilio
             end
 
             ##
-            # @return [String] The sid
+            # @return [String] A 34 character string that uniquely identifies this resource.
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] The account_sid
+            # @return [String] The unique id of the Account responsible for this binding.
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The service_sid
+            # @return [String] The unique id of the Service this binding belongs to.
             def service_sid
               @properties['service_sid']
             end
 
             ##
-            # @return [Time] The date_created
+            # @return [Time] The date that this resource was created.
             def date_created
               @properties['date_created']
             end
 
             ##
-            # @return [Time] The date_updated
+            # @return [Time] The date that this resource was last updated.
             def date_updated
               @properties['date_updated']
             end
 
             ##
-            # @return [String] The endpoint
+            # @return [String] The unique endpoint identifier for this Binding.
             def endpoint
               @properties['endpoint']
             end
 
             ##
-            # @return [String] The identity
+            # @return [String] A unique string identifier for the Binding for this User in this Service.
             def identity
               @properties['identity']
             end
 
             ##
-            # @return [String] The credential_sid
+            # @return [String] The unique id of the Credential for this binding.
             def credential_sid
               @properties['credential_sid']
             end
 
             ##
-            # @return [binding.BindingType] The binding_type
+            # @return [binding.BindingType] The push technology to use for this binding.
             def binding_type
               @properties['binding_type']
             end
 
             ##
-            # @return [String] The message_types
+            # @return [String] List of message types for this binding.
             def message_types
               @properties['message_types']
             end
 
             ##
-            # @return [String] The url
+            # @return [String] An absolute URL for this binding.
             def url
               @properties['url']
             end
 
             ##
-            # @return [String] The links
+            # @return [String] Absolute URLs to access the Users for this Binding.
             def links
               @properties['links']
             end

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

@@ -16,8 +16,14 @@ module Twilio
               ##
               # Initialize the UserBindingList
               # @param [Version] version Version that contains the resource
-              # @param [String] service_sid The service_sid
-              # @param [String] user_sid The user_sid
+              # @param [String] service_sid The unique id of the
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/services) this binding
+              #   belongs to.
+              # @param [String] user_sid The unique id of the
+              #   [User](https://www.twilio.com/docs/api/chat/rest/users) for this binding.  See
+              #   [push notification
+              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   for more information.
               # @return [UserBindingList] UserBindingList
               def initialize(version, service_sid: nil, user_sid: nil)
                 super(version)
@@ -31,7 +37,11 @@ module Twilio
               # Lists UserBindingInstance records from the API as a list.
               # Unlike stream(), this operation is eager and will load `limit` records into
               # memory before returning.
-              # @param [user_binding.BindingType] binding_type The binding_type
+              # @param [user_binding.BindingType] binding_type The push technology used for the
+              #   returned Bindings.  Supported values are apn, gcm and fcm.  See [push
+              #   notification
+              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   for more information.
               # @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
@@ -47,7 +57,11 @@ module Twilio
               # Streams UserBindingInstance records from the API as an Enumerable.
               # This operation lazily loads records as efficiently as possible until the limit
               # is reached.
-              # @param [user_binding.BindingType] binding_type The binding_type
+              # @param [user_binding.BindingType] binding_type The push technology used for the
+              #   returned Bindings.  Supported values are apn, gcm and fcm.  See [push
+              #   notification
+              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   for more information.
               # @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
@@ -80,7 +94,11 @@ module Twilio
               ##
               # Retrieve a single page of UserBindingInstance records from the API.
               # Request is executed immediately.
-              # @param [user_binding.BindingType] binding_type The binding_type
+              # @param [user_binding.BindingType] binding_type The push technology used for the
+              #   returned Bindings.  Supported values are apn, gcm and fcm.  See [push
+              #   notification
+              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   for more information.
               # @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
@@ -211,8 +229,14 @@ module Twilio
               # Initialize the UserBindingInstance
               # @param [Version] version Version that contains the resource
               # @param [Hash] payload payload that contains response from Twilio
-              # @param [String] service_sid The service_sid
-              # @param [String] user_sid The user_sid
+              # @param [String] service_sid The unique id of the
+              #   [Service](https://www.twilio.com/docs/api/chat/rest/services) this binding
+              #   belongs to.
+              # @param [String] user_sid The unique id of the
+              #   [User](https://www.twilio.com/docs/api/chat/rest/users) for this binding.  See
+              #   [push notification
+              #   configuration](https://www.twilio.com/docs/chat/push-notification-configuration)
+              #   for more information.
               # @param [String] sid The sid
               # @return [UserBindingInstance] UserBindingInstance
               def initialize(version, payload, service_sid: nil, user_sid: nil, sid: nil)
@@ -256,73 +280,73 @@ module Twilio
               end
 
               ##
-              # @return [String] The sid
+              # @return [String] A 34 character string that uniquely identifies this resource.
               def sid
                 @properties['sid']
               end
 
               ##
-              # @return [String] The account_sid
+              # @return [String] The unique id of the Account responsible for this binding.
               def account_sid
                 @properties['account_sid']
               end
 
               ##
-              # @return [String] The service_sid
+              # @return [String] The unique id of the Service this binding belongs to.
               def service_sid
                 @properties['service_sid']
               end
 
               ##
-              # @return [Time] The date_created
+              # @return [Time] The date that this resource was created.
               def date_created
                 @properties['date_created']
               end
 
               ##
-              # @return [Time] The date_updated
+              # @return [Time] The date that this resource was last updated.
               def date_updated
                 @properties['date_updated']
               end
 
               ##
-              # @return [String] The endpoint
+              # @return [String] The unique endpoint identifier for this Binding.
               def endpoint
                 @properties['endpoint']
               end
 
               ##
-              # @return [String] The identity
+              # @return [String] A unique string identifier for the Binding for this User in this Service.
               def identity
                 @properties['identity']
               end
 
               ##
-              # @return [String] The user_sid
+              # @return [String] The unique id of the User for this binding.
               def user_sid
                 @properties['user_sid']
               end
 
               ##
-              # @return [String] The credential_sid
+              # @return [String] The unique id of the Credential for this binding.
               def credential_sid
                 @properties['credential_sid']
               end
 
               ##
-              # @return [user_binding.BindingType] The binding_type
+              # @return [user_binding.BindingType] The push technology to use for this binding.
               def binding_type
                 @properties['binding_type']
               end
 
               ##
-              # @return [String] The message_types
+              # @return [String] List of message types for this binding.
               def message_types
                 @properties['message_types']
               end
 
               ##
-              # @return [String] The url
+              # @return [String] An absolute URL for this binding.
               def url
                 @properties['url']
               end

data/lib/twilio-ruby/rest/preview/understand/assistant/field_type/field_value.rb

@@ -125,7 +125,8 @@ module Twilio
               # @param [String] language An ISO language-country string of the value.
               # @param [String] value A user-provided string that uniquely identifies this
               #   resource as an alternative to the sid. Unique up to 64 characters long.
-              # @param [String] synonym_of The synonym_of
+              # @param [String] synonym_of A value that indicates this field value is a synonym
+              #   of. Empty if the value is not a synonym.
               # @return [FieldValueInstance] Newly created FieldValueInstance
               def create(language: nil, value: nil, synonym_of: :unset)
                 data = Twilio::Values.of({'Language' => language, 'Value' => value, 'SynonymOf' => synonym_of, })
@@ -338,7 +339,7 @@ module Twilio
               end
 
               ##
-              # @return [String] The value
+              # @return [String] The Field Value itself.
               def value
                 @properties['value']
               end
@@ -350,7 +351,7 @@ module Twilio
               end
 
               ##
-              # @return [String] The synonym_of
+              # @return [String] A value that indicates this field value is a synonym of. Empty if the value is not a synonym.
               def synonym_of
                 @properties['synonym_of']
               end

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

@@ -34,7 +34,7 @@ module Twilio
           #   this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
           # @param [Time] date_created_before Only show Compositions that started before
           #   this this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
-          # @param [String] room_sid The room_sid
+          # @param [String] room_sid Only show Compositions with the given Room SID.
           # @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
@@ -62,7 +62,7 @@ module Twilio
           #   this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
           # @param [Time] date_created_before Only show Compositions that started before
           #   this this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
-          # @param [String] room_sid The room_sid
+          # @param [String] room_sid Only show Compositions with the given Room SID.
           # @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
@@ -106,7 +106,7 @@ module Twilio
           #   this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
           # @param [Time] date_created_before Only show Compositions that started before
           #   this this ISO8601 date-time, given as `YYYY-MM-DDThh:mm:ss-hh:mm`.
-          # @param [String] room_sid The room_sid
+          # @param [String] room_sid Only show Compositions with the given Room SID.
           # @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
@@ -151,27 +151,37 @@ module Twilio
           #   Composition in terms of regions. See the section [Managing Video
           #   Layouts](#managing-video-layouts) below for further information.
           # @param [String] audio_sources An array of audio sources to merge. All the
-          #   specified sources must belong to the same Group Room. It can
-          #   include:<ul><li>Zero or more `RecordingTrackSid`</li><li>Zero or more
-          #   `MediaTrackSid`</li><li>Zero or more `ParticipantSid`</li><li>Zero or more Track
-          #   names. These can be specified using wildcards (e.g. `student*`)</li></ul>
+          #   specified sources must belong to the same Group Room. It can include: 
+          #   * Zero or more `RecordingTrackSid`
+          #   * Zero or more `MediaTrackSid`
+          #   * Zero or more `ParticipantSid`
+          #   * Zero or more Track names. These can be specified using wildcards (e.g.
+          #   `student*`)
           # @param [String] audio_sources_excluded An array of audio sources to exclude from
           #   the Composition. Any new Composition shall include all audio sources specified
           #   in `AudioSources` except for the ones specified in `AudioSourcesExcluded`. This
-          #   parameter may include:<ul><li>Zero or more `RecordingTrackSid`</li><li>Zero or
-          #   more `MediaTrackSid`</li><li>Zero or more `ParticipantSid`</li><li>Zero or more
-          #   Track names. These can be specified using wildcards (e.g. `student*`)</li></ul>
+          #   parameter may include: 
+          #   * Zero or more `RecordingTrackSid`
+          #   * Zero or more `MediaTrackSid`
+          #   * Zero or more `ParticipantSid`
+          #   * Zero or more Track names. These can be specified using wildcards (e.g.
+          #   `student*`)
           # @param [String] resolution A string representing the numbers of pixels for rows
           #   (width) and columns (height) of the generated composed video. This string must
           #   have the format `{width}x{height}`. This parameter must comply with the
-          #   following constraints:<ul><li>`width >= 16 && width <= 1280`</li><li>`height >=
-          #   16 && height <= 1280`</li><li>`width * height <= 921,600`</li></ul>Typical
-          #   values are:<ul><li>HD = `1280x720`</li><li>PAL = `1024x576`</li><li>VGA =
-          #   `640x480`</li><li>CIF = `320x240`</li></ul>Note that the `Resolution` implicitly
-          #   imposes an aspect ratio to the resulting composition. When the original video
-          #   tracks get constrained by this aspect ratio they are scaled-down to fit. You can
-          #   find detailed information in the [Managing Video
-          #   Layouts](#managing-video-layouts) section. Defaults to `640x480`.
+          #   following constraints: 
+          #   * `width >= 16 && width <= 1280`
+          #   * `height >= 16 && height <= 1280`
+          #   * `width * height <= 921,600`
+          #   Typical values are: 
+          #   * HD = `1280x720`
+          #   * PAL = `1024x576`
+          #   * VGA = `640x480`
+          #   * CIF = `320x240`
+          #   Note that the `Resolution` implicitly imposes an aspect ratio to the resulting
+          #   composition. When the original video tracks get constrained by this aspect ratio
+          #   they are scaled-down to fit. You can find detailed information in the [Managing
+          #   Video Layouts](#managing-video-layouts) section. Defaults to `640x480`.
           # @param [composition.Format] format Container format of the Composition media
           #   file. Can be any of the following: `mp4`, `webm`. The use of `mp4` or `webm`
           #   makes mandatory the specification of `AudioSources` and/or one `VideoLayout`

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

@@ -12,6 +12,16 @@ module Twilio
   module TwiML
     class TwiMLError < StandardError; end
 
+    class Comment
+      def initialize(body)
+        @body = body
+      end
+
+      def xml(document)
+        Nokogiri::XML::Comment.new(document, @body)
+      end
+    end
+
     class TwiML
         attr_accessor :name
 
@@ -68,12 +78,18 @@ module Twilio
         end
 
         def append(verb)
-          raise TwiMLError, 'Only appending of TwiML is allowed' unless verb.is_a?(TwiML)
+          unless verb.is_a?(TwiML) || verb.is_a?(Comment)
+              raise TwiMLError, 'Only appending of TwiML is allowed'
+          end
 
           @verbs << verb
           self
         end
 
+        def comment(body)
+          append(Comment.new(body))
+        end
+
       alias to_xml to_s
     end
   end

data/lib/twilio-ruby/version.rb

@@ -1,3 +1,3 @@
 module Twilio
-    VERSION = '5.10.2'
+    VERSION = '5.10.3'
 end

data/spec/integration/lookups/v1/phone_number_spec.rb

@@ -41,6 +41,15 @@ describe 'PhoneNumber' do
               "name": "verizon",
               "type": "mobile"
           },
+          "fraud": {
+              "error_code": null,
+              "mobile_country_code": "310",
+              "mobile_network_code": "456",
+              "advanced_line_type": "voip",
+              "caller_name": "Delicious Cheese Cake",
+              "is_ported": false,
+              "last_ported_date": "2018-05-01 04:05:11"
+          },
           "country_code": "US",
           "national_format": "(510) 867-5309",
           "phone_number": "+15108675309",

data/spec/twiml/messaging_response_spec.rb

@@ -20,6 +20,12 @@ describe Twilio::TwiML::MessagingResponse do
       expect(doc).to be_equivalent_to(expected_doc).respecting_element_order
     end
 
+    it 'should allow comments' do
+      twiml = Twilio::TwiML::MessagingResponse.new
+      twiml.comment 'This is awesome'
+      expect(twiml.to_xml).to match(/<!--This is awesome-->/)
+    end
+
     it 'should allow populated response' do
       expected_doc = parse <<-XML
         <Response>

data/spec/twiml/voice_response_spec.rb

@@ -30,6 +30,12 @@ describe Twilio::TwiML::VoiceResponse do
       expect(twiml).not_to match(/\A<\?xml version="1.0" encoding="UTF-8"\?>/)
     end
 
+    it 'should allow comments' do
+      twiml = Twilio::TwiML::VoiceResponse.new
+      twiml.comment 'This is awesome'
+      expect(twiml.to_xml).to match(/<!--This is awesome-->/)
+    end
+
     it 'should allow populated response' do
       expected_doc = parse <<-XML
         <Response>

data/twilio-ruby.gemspec

@@ -8,9 +8,9 @@ Gem::Specification.new do |spec|
   spec.name          = 'twilio-ruby'
   spec.version       = Twilio::VERSION
   spec.authors	     = ['Twilio API Team']
-  spec.summary       = 'A simple library for communicating with the Twilio REST API, '\
+  spec.summary       = 'The official library for communicating with the Twilio REST API, '\
                        'building TwiML, and generating Twilio JWT Capability Tokens'
-  spec.description   = 'A simple library for communicating with the Twilio REST API, '\
+  spec.description   = 'The official library for communicating with the Twilio REST API, '\
                        'building TwiML, and generating Twilio JWT Capability Tokens'
   spec.homepage      = 'http://github.com/twilio/twilio-ruby'
   spec.license       = 'MIT'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: twilio-ruby
 version: !ruby/object:Gem::Version
-  version: 5.10.2
+  version: 5.10.3
 platform: ruby
 authors:
 - Twilio API Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-05-25 00:00:00.000000000 Z
+date: 2018-06-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jwt
@@ -106,7 +106,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.9.9
-description: A simple library for communicating with the Twilio REST API, building
+description: The official library for communicating with the Twilio REST API, building
   TwiML, and generating Twilio JWT Capability Tokens
 email: 
 executables: []
@@ -755,8 +755,8 @@ rubyforge_project:
 rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
-summary: A simple library for communicating with the Twilio REST API, building TwiML,
-  and generating Twilio JWT Capability Tokens
+summary: The official library for communicating with the Twilio REST API, building
+  TwiML, and generating Twilio JWT Capability Tokens
 test_files:
 - spec/framework/request_spec.rb
 - spec/framework/serialize_spec.rb