twilio-ruby 5.69.0 → 5.71.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8dfd0266c044e0696ec36adbe6b650a715bb222c
-  data.tar.gz: 72cdf92cb46568d1b314f2ae67c1d96f9129d0ef
+  metadata.gz: 7d7e60b68cf1a5f9620b2f01e94b16ed38b39af8
+  data.tar.gz: edcf56d0de5fb32699a9b59558b1df3b300a3cd3
 SHA512:
-  metadata.gz: e18aee13b94d15e4a19b152d0c730caf8c7ea176e3ab422584a938e7934f415a868e8b592334fab20ccd8d927e6db0dd476d759c95ea0aa035c64658fe33bf9e
-  data.tar.gz: e482fefb1d0b50b0f7c3b79f829b5c3f899efede7dd85b0b0c10b7ba375efa7a7b4545367d1635e54356c0de6219a6080458dee1cb1fea358b0da8a3b00a204b
+  metadata.gz: 1e5d000f1bcef5af1371aa474d87968fac4320540223516476d577ad7f97970dadb5658e1819cc8f05182ad708901e798f380ebadd9807ef7bd30782ba669310
+  data.tar.gz: 9e7ab524c31d2502af6a0e0619b92308c25964500220f0a1dc67e39b4b462b837621347c0d2ef0cc7334e7f7ff8fd88bc3dc99d16bcdc661f053e24f883a2bb1

data/CHANGES.md

@@ -1,6 +1,48 @@
 twilio-ruby changelog
 =====================
 
+[2022-08-24] Version 5.71.0
+---------------------------
+**Library - Test**
+- [PR #615](https://github.com/twilio/twilio-ruby/pull/615): add test-docker rule. Thanks to [@beebzz](https://github.com/beebzz)!
+
+**Api**
+- Remove `beta feature` from scheduling params and remove optimize parameters. **(breaking change)**
+
+**Routes**
+- Remove Duplicate Create Method - Update Method will work even if Inbound Processing Region is currently empty/404. **(breaking change)**
+
+**Twiml**
+- Add new Polly Neural voices
+- Add new languages to SSML `<lang>`.
+
+
+[2022-08-10] Version 5.70.1
+---------------------------
+**Library - Fix**
+- [PR #614](https://github.com/twilio/twilio-ruby/pull/614): Make RequestValidator#validate fail if URL has no query params. Thanks to [@haffla](https://github.com/haffla)!
+
+**Routes**
+- Inbound Proccessing Region API - Public GA
+
+**Supersim**
+- Allow updating `DataLimit` on a Fleet
+
+
+[2022-07-21] Version 5.70.0
+---------------------------
+**Flex**
+- Add `status`, `error_code`, and `error_message` fields to Interaction `Channel`
+- Adding `messenger` and `gbm` as supported channels for Interactions API
+
+**Messaging**
+- Update alpha_sender docs with new valid characters
+
+**Verify**
+- Reorder Verification Check parameters so `code` stays as the first parameter **(breaking change)**
+- Rollback List Attempts API V2 back to pilot stage.
+
+
 [2022-07-13] Version 5.69.0
 ---------------------------
 **Library - Fix**
@@ -20,7 +62,7 @@ twilio-ruby changelog
 
 **Verify**
 - Changed summary param `service_sid` to `verify_service_sid` to be consistent with list attempts API **(breaking change)**
-- Make `code` optional on Verification check to support `sna` attempts.
+- Make `code` optional on Verification check to support `sna` attempts. **(breaking change)**
 
 
 [2022-06-29] Version 5.68.0

data/Makefile

@@ -1,4 +1,4 @@
-.PHONY: githooks install test lint docs docker-build docker-push
+.PHONY: githooks install test test-docker lint docs docker-build docker-push
 
 githooks:
 	ln -sf ../../githooks/pre-commit .git/hooks/pre-commit
@@ -9,6 +9,10 @@ install:
 test:
 	bundle exec rake spec
 
+test-docker:
+	docker build -t twilio/twilio-ruby .
+	docker run twilio/twilio-ruby bundle exec rake spec
+
 docs:
 	bundle exec yard doc --output-dir ./doc
 
@@ -17,7 +21,7 @@ authors:
 	git log --raw | grep "^Author: " | cut -d ' ' -f2- | cut -d '<' -f1 | sed 's/^/- /' | sort | uniq >> AUTHORS.md
 
 API_DEFINITIONS_SHA=$(shell git log --oneline | grep Regenerated | head -n1 | cut -d ' ' -f 5)
-CURRENT_TAG=$(shell [[ "${GITHUB_TAG}" == *"-rc"* ]] && echo "rc" || echo "latest")
+CURRENT_TAG=$(shell expr "${GITHUB_TAG}" : ".*-rc.*" >/dev/null && echo "rc" || echo "latest")
 docker-build:
 	docker build -t twilio/twilio-ruby .
 	docker tag twilio/twilio-ruby twilio/twilio-ruby:${GITHUB_TAG}

data/README.md

@@ -34,13 +34,13 @@ This library supports the following Ruby implementations:
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.69.0'
+gem 'twilio-ruby', '~> 5.71.0'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.69.0
+gem install twilio-ruby -v 5.71.0
 ```
 
 To build and install the development branch yourself from the latest source:

data/lib/twilio-ruby/rest/api/v2010/account/sip/ip_access_control_list/ip_address.rb

@@ -113,7 +113,7 @@ module Twilio
                 ##
                 # Create the IpAddressInstance
                 # @param [String] friendly_name A human readable descriptive text for this
-                #   resource, up to 64 characters long.
+                #   resource, up to 255 characters long.
                 # @param [String] ip_address An IP address in dotted decimal notation from which
                 #   you want to accept traffic. Any SIP requests from this IP address will be
                 #   allowed by Twilio. IPv4 only supported today.
@@ -224,7 +224,7 @@ module Twilio
                 #   you want to accept traffic. Any SIP requests from this IP address will be
                 #   allowed by Twilio. IPv4 only supported today.
                 # @param [String] friendly_name A human readable descriptive text for this
-                #   resource, up to 64 characters long.
+                #   resource, up to 255 characters long.
                 # @param [String] cidr_prefix_length An integer representing the length of the
                 #   CIDR prefix to use with this IP address when accepting traffic. By default the
                 #   entire IP address is used.
@@ -335,7 +335,7 @@ module Twilio
                 end
 
                 ##
-                # @return [String] A human readable descriptive text for this resource, up to 64 characters long.
+                # @return [String] A human readable descriptive text for this resource, up to 255 characters long.
                 def friendly_name
                   @properties['friendly_name']
                 end
@@ -389,7 +389,7 @@ module Twilio
                 #   you want to accept traffic. Any SIP requests from this IP address will be
                 #   allowed by Twilio. IPv4 only supported today.
                 # @param [String] friendly_name A human readable descriptive text for this
-                #   resource, up to 64 characters long.
+                #   resource, up to 255 characters long.
                 # @param [String] cidr_prefix_length An integer representing the length of the
                 #   CIDR prefix to use with this IP address when accepting traffic. By default the
                 #   entire IP address is used.

data/lib/twilio-ruby/rest/api/v2010/account/sip/ip_access_control_list.rb

@@ -110,7 +110,7 @@ module Twilio
               ##
               # Create the IpAccessControlListInstance
               # @param [String] friendly_name A human readable descriptive text that describes
-              #   the IpAccessControlList, up to 64 characters long.
+              #   the IpAccessControlList, up to 255 characters long.
               # @return [IpAccessControlListInstance] Created IpAccessControlListInstance
               def create(friendly_name: nil)
                 data = Twilio::Values.of({'FriendlyName' => friendly_name, })
@@ -193,7 +193,7 @@ module Twilio
 
               ##
               # Update the IpAccessControlListInstance
-              # @param [String] friendly_name A human readable descriptive text, up to 64
+              # @param [String] friendly_name A human readable descriptive text, up to 255
               #   characters long.
               # @return [IpAccessControlListInstance] Updated IpAccessControlListInstance
               def update(friendly_name: nil)
@@ -344,7 +344,7 @@ module Twilio
 
               ##
               # Update the IpAccessControlListInstance
-              # @param [String] friendly_name A human readable descriptive text, up to 64
+              # @param [String] friendly_name A human readable descriptive text, up to 255
               #   characters long.
               # @return [IpAccessControlListInstance] Updated IpAccessControlListInstance
               def update(friendly_name: nil)

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

@@ -49,6 +49,7 @@ module Twilio
         @preview = nil
         @pricing = nil
         @proxy = nil
+        @routes = nil
         @serverless = nil
         @studio = nil
         @sync = nil
@@ -61,6 +62,7 @@ module Twilio
         @wireless = nil
         @supersim = nil
         @bulkexports = nil
+        @microvisor = nil
       end
 
       ##
@@ -275,6 +277,12 @@ module Twilio
         @proxy ||= Proxy.new self
       end
 
+      ##
+      # Access the Routes Twilio Domain
+      def routes
+        @routes ||= Routes.new self
+      end
+
       ##
       # Access the Serverless Twilio Domain
       def serverless
@@ -347,6 +355,12 @@ module Twilio
         @bulkexports ||= Bulkexports.new self
       end
 
+      ##
+      # Access the Microvisor Twilio Domain
+      def microvisor
+        @microvisor ||= Microvisor.new self
+      end
+
       ##
       # @param [String] sid The unique string that that we created to identify the
       #   Address resource.

data/lib/twilio-ruby/rest/flex_api/v1/interaction/interaction_channel.rb

@@ -275,6 +275,9 @@ module Twilio
                   'sid' => payload['sid'],
                   'interaction_sid' => payload['interaction_sid'],
                   'type' => payload['type'],
+                  'status' => payload['status'],
+                  'error_code' => payload['error_code'] == nil ? payload['error_code'] : payload['error_code'].to_i,
+                  'error_message' => payload['error_message'],
                   'url' => payload['url'],
                   'links' => payload['links'],
               }
@@ -306,7 +309,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The unique string that identifies the resource
+            # @return [String] The unique string that identifies the resource.
             def interaction_sid
               @properties['interaction_sid']
             end
@@ -317,6 +320,24 @@ module Twilio
               @properties['type']
             end
 
+            ##
+            # @return [interaction_channel.ChannelStatus] The status of this channel.
+            def status
+              @properties['status']
+            end
+
+            ##
+            # @return [String] The Twilio error code for a failed channel.
+            def error_code
+              @properties['error_code']
+            end
+
+            ##
+            # @return [String] The error message for a failed channel.
+            def error_message
+              @properties['error_message']
+            end
+
             ##
             # @return [String] The url
             def url

data/lib/twilio-ruby/rest/media/v1/player_streamer.rb

@@ -33,10 +33,10 @@ module Twilio
           # @param [String] status_callback_method The HTTP method Twilio should use to call
           #   the `status_callback` URL. Can be `POST` or `GET` and the default is `POST`.
           # @param [String] max_duration The maximum time, in seconds, that the
-          #   PlayerStreamer can run before automatically ends. The default value is 300
-          #   seconds, and the maximum value is 90000 seconds. Once this maximum duration is
-          #   reached, Twilio will end the PlayerStreamer, regardless of whether media is
-          #   still streaming.
+          #   PlayerStreamer is active (`created` or `started`) before automatically ends. The
+          #   default value is 300 seconds, and the maximum value is 90000 seconds. Once this
+          #   maximum duration is reached, Twilio will end the PlayerStreamer, regardless of
+          #   whether media is still streaming.
           # @return [PlayerStreamerInstance] Created PlayerStreamerInstance
           def create(video: :unset, status_callback: :unset, status_callback_method: :unset, max_duration: :unset)
             data = Twilio::Values.of({

data/lib/twilio-ruby/rest/messaging/v1/service/alpha_sender.rb

@@ -32,8 +32,8 @@ module Twilio
             ##
             # Create the AlphaSenderInstance
             # @param [String] alpha_sender The Alphanumeric Sender ID string. Can be up to 11
-            #   characters long. Valid characters are A-Z, a-z, 0-9, space, and hyphen `-`. This
-            #   value cannot contain only numbers.
+            #   characters long. Valid characters are A-Z, a-z, 0-9, space, hyphen `-`, plus
+            #   `+`, underscore `_` and ampersand `&`. This value cannot contain only numbers.
             # @return [AlphaSenderInstance] Created AlphaSenderInstance
             def create(alpha_sender: nil)
               data = Twilio::Values.of({'AlphaSender' => alpha_sender, })

data/lib/twilio-ruby/rest/microvisor/v1/app.rb

@@ -0,0 +1,305 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+#
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class Microvisor < Domain
+      class V1 < Version
+        ##
+        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+        class AppList < ListResource
+          ##
+          # Initialize the AppList
+          # @param [Version] version Version that contains the resource
+          # @return [AppList] AppList
+          def initialize(version)
+            super(version)
+
+            # Path Solution
+            @solution = {}
+            @uri = "/Apps"
+          end
+
+          ##
+          # Lists AppInstance records from the API as a list.
+          # Unlike stream(), this operation is eager and will load `limit` records into
+          # memory before returning.
+          # @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
+          #    not set will use the default value of 50 records.  If no page_size is defined
+          #    but a limit is defined, stream() will attempt to read the limit with the most
+          #    efficient page size, i.e. min(limit, 1000)
+          # @return [Array] Array of up to limit results
+          def list(limit: nil, page_size: nil)
+            self.stream(limit: limit, page_size: page_size).entries
+          end
+
+          ##
+          # Streams AppInstance records from the API as an Enumerable.
+          # This operation lazily loads records as efficiently as possible until the limit
+          # is reached.
+          # @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
+          #    not set will use the default value of 50 records. If no page_size is defined
+          #    but a limit is defined, stream() will attempt to read the limit with the most
+          #    efficient page size, i.e. min(limit, 1000)
+          # @return [Enumerable] Enumerable that will yield up to limit results
+          def stream(limit: nil, page_size: nil)
+            limits = @version.read_limits(limit, page_size)
+
+            page = self.page(page_size: limits[:page_size], )
+
+            @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
+          end
+
+          ##
+          # When passed a block, yields AppInstance records from the API.
+          # This operation lazily loads records as efficiently as possible until the limit
+          # is reached.
+          def each
+            limits = @version.read_limits
+
+            page = self.page(page_size: limits[:page_size], )
+
+            @version.stream(page,
+                            limit: limits[:limit],
+                            page_limit: limits[:page_limit]).each {|x| yield x}
+          end
+
+          ##
+          # Retrieve a single page of AppInstance records from the API.
+          # Request is executed immediately.
+          # @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
+          # @return [Page] Page of AppInstance
+          def page(page_token: :unset, page_number: :unset, page_size: :unset)
+            params = Twilio::Values.of({
+                'PageToken' => page_token,
+                'Page' => page_number,
+                'PageSize' => page_size,
+            })
+
+            response = @version.page('GET', @uri, params: params)
+
+            AppPage.new(@version, response, @solution)
+          end
+
+          ##
+          # Retrieve a single page of AppInstance records from the API.
+          # Request is executed immediately.
+          # @param [String] target_url API-generated URL for the requested results page
+          # @return [Page] Page of AppInstance
+          def get_page(target_url)
+            response = @version.domain.request(
+                'GET',
+                target_url
+            )
+            AppPage.new(@version, response, @solution)
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '#<Twilio.Microvisor.V1.AppList>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+        class AppPage < Page
+          ##
+          # Initialize the AppPage
+          # @param [Version] version Version that contains the resource
+          # @param [Response] response Response from the API
+          # @param [Hash] solution Path solution for the resource
+          # @return [AppPage] AppPage
+          def initialize(version, response, solution)
+            super(version, response)
+
+            # Path Solution
+            @solution = solution
+          end
+
+          ##
+          # Build an instance of AppInstance
+          # @param [Hash] payload Payload response from the API
+          # @return [AppInstance] AppInstance
+          def get_instance(payload)
+            AppInstance.new(@version, payload, )
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            '<Twilio.Microvisor.V1.AppPage>'
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+        class AppContext < InstanceContext
+          ##
+          # Initialize the AppContext
+          # @param [Version] version Version that contains the resource
+          # @param [String] sid A 34-character string that uniquely identifies this App.
+          # @return [AppContext] AppContext
+          def initialize(version, sid)
+            super(version)
+
+            # Path Solution
+            @solution = {sid: sid, }
+            @uri = "/Apps/#{@solution[:sid]}"
+          end
+
+          ##
+          # Fetch the AppInstance
+          # @return [AppInstance] Fetched AppInstance
+          def fetch
+            payload = @version.fetch('GET', @uri)
+
+            AppInstance.new(@version, payload, sid: @solution[:sid], )
+          end
+
+          ##
+          # Delete the AppInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
+          def delete
+             @version.delete('DELETE', @uri)
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Microvisor.V1.AppContext #{context}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Microvisor.V1.AppContext #{context}>"
+          end
+        end
+
+        ##
+        # PLEASE NOTE that this class contains preview products that are subject to change. Use them with caution. If you currently do not have developer preview access, please contact help@twilio.com.
+        class AppInstance < InstanceResource
+          ##
+          # Initialize the AppInstance
+          # @param [Version] version Version that contains the resource
+          # @param [Hash] payload payload that contains response from Twilio
+          # @param [String] sid A 34-character string that uniquely identifies this App.
+          # @return [AppInstance] AppInstance
+          def initialize(version, payload, sid: nil)
+            super(version)
+
+            # Marshaled Properties
+            @properties = {
+                'sid' => payload['sid'],
+                'account_sid' => payload['account_sid'],
+                'hash' => payload['hash'],
+                'unique_name' => payload['unique_name'],
+                'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
+                'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
+                'url' => payload['url'],
+            }
+
+            # Context
+            @instance_context = nil
+            @params = {'sid' => sid || @properties['sid'], }
+          end
+
+          ##
+          # Generate an instance context for the instance, the context is capable of
+          # performing various actions.  All instance actions are proxied to the context
+          # @return [AppContext] AppContext for this AppInstance
+          def context
+            unless @instance_context
+              @instance_context = AppContext.new(@version, @params['sid'], )
+            end
+            @instance_context
+          end
+
+          ##
+          # @return [String] A string that uniquely identifies this App.
+          def sid
+            @properties['sid']
+          end
+
+          ##
+          # @return [String] The Account SID.
+          def account_sid
+            @properties['account_sid']
+          end
+
+          ##
+          # @return [String] App manifest hash represented as hash_algorithm:hash_value.
+          def hash
+            @properties['hash']
+          end
+
+          ##
+          # @return [String] An developer-defined string that uniquely identifies the App.
+          def unique_name
+            @properties['unique_name']
+          end
+
+          ##
+          # @return [Time] The date that this App was created.
+          def date_created
+            @properties['date_created']
+          end
+
+          ##
+          # @return [Time] The date that this App was last updated.
+          def date_updated
+            @properties['date_updated']
+          end
+
+          ##
+          # @return [String] The URL of this resource.
+          def url
+            @properties['url']
+          end
+
+          ##
+          # Fetch the AppInstance
+          # @return [AppInstance] Fetched AppInstance
+          def fetch
+            context.fetch
+          end
+
+          ##
+          # Delete the AppInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
+          def delete
+            context.delete
+          end
+
+          ##
+          # Provide a user friendly representation
+          def to_s
+            values = @params.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Microvisor.V1.AppInstance #{values}>"
+          end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            values = @properties.map{|k, v| "#{k}: #{v}"}.join(" ")
+            "<Twilio.Microvisor.V1.AppInstance #{values}>"
+          end
+        end
+      end
+    end
+  end
+end