twilio-ruby 5.53.0 → 5.56.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2f1293c8cedd9eb9e7c9a5078d1e0ac4bb2e34116056233c1112d31911d7de1
-  data.tar.gz: d4d4a2935c742a0f70a5899963b2b114fd83abc5570e0de72f594f2a9ce34b36
+  metadata.gz: 80e6c32f919f1a2514aafbbb28a11b07f6099e9ffeca5f95dde586e2a717712d
+  data.tar.gz: '09a90113868ce5fc759734f819b76040c96da3c237657a5159912ecc4bd7a871'
 SHA512:
-  metadata.gz: 398824d908de11ffd6449648f01eabc8d8ce97156080c55e4a785fa66caa1a05f38fad0c4fe77521310ebb917bd7482b84c91860c2612a91cb6d322698e5cf84
-  data.tar.gz: 3755621b7a3d180ac82c5b07c88e0bf349099c7d661231247c96b91d3fb726b25d0d01968a653cddc270a816305681a5c941130dedc19a07f9f6253f64afd77a
+  metadata.gz: 456c8ac1a992f24200563b2c754b6b9f9259287b4e4042550420218b18850de8c0a6e1c875c83e3e00b1e487f42c0b9c22a36060f95729a390b957cf34171319
+  data.tar.gz: dfb91366c5e2db2c817db0a782ec67c5290892daa430c0f32279ba7b7a8ae5e25fac42f9801952845d47c026603b1a95f29f5312637e283cb957bfb671dcd4cc

data/.rubocop_todo.yml

@@ -66,7 +66,7 @@ Lint/UnusedBlockArgument:
 Lint/UnusedMethodArgument:
   Exclude:
     - 'lib/twilio-ruby.rb'
-    - 'lib/twilio-ruby/framework/page.rb'
+    - 'lib/twilio-ruby/framework/rest/page.rb'
     - 'spec/holodeck/holodeck.rb'
 
 # Offense count: 1
@@ -130,7 +130,7 @@ Style/FrozenStringLiteralComment:
 # Configuration parameters: MinBodyLength.
 Style/GuardClause:
   Exclude:
-    - 'lib/twilio-ruby/framework/page.rb'
+    - 'lib/twilio-ruby/framework/rest/page.rb'
 
 # Offense count: 1
 # Cop supports --auto-correct.
@@ -144,8 +144,8 @@ Style/HashSyntax:
 # Cop supports --auto-correct.
 Style/IfUnlessModifier:
   Exclude:
-    - 'lib/twilio-ruby/framework/page.rb'
-    - 'lib/twilio-ruby/framework/version.rb'
+    - 'lib/twilio-ruby/framework/rest/page.rb'
+    - 'lib/twilio-ruby/framework/rest/version.rb'
     - 'lib/twilio-ruby/jwt/access_token.rb'
     - 'lib/twilio-ruby/jwt/client_capability.rb'
     - 'lib/twilio-ruby/jwt/jwt.rb'
@@ -168,9 +168,9 @@ Style/RedundantSelf:
 # SupportedStyles: slashes, percent_r, mixed
 Style/RegexpLiteral:
   Exclude:
-    - 'lib/twilio-ruby/framework/domain.rb'
-    - 'lib/twilio-ruby/framework/helper.rb'
-    - 'lib/twilio-ruby/framework/version.rb'
+    - 'lib/twilio-ruby/framework/rest/domain.rb'
+    - 'lib/twilio-ruby/framework/rest/helper.rb'
+    - 'lib/twilio-ruby/framework/rest/version.rb'
     - 'spec/rack/twilio_webhook_authentication_spec.rb'
 
 # Offense count: 5

data/.travis.yml

@@ -19,7 +19,7 @@ matrix:
   fast_finish: true
 deploy:
 - provider: script
-  script: make docker-build && make docker-push
+  script: echo "${DOCKER_PASSWORD}" | docker login -u "${DOCKER_USERNAME}" --password-stdin && make docker-build && make docker-push
   skip_cleanup: true
   on:
     tags: true
@@ -36,4 +36,4 @@ notifications:
     on_success: never
     on_failure: change
     rooms:
-      secure: OkXuxf75AYfH919/hhfY3IZOb6IzN3p74ouG2U860Vdwku1WzXjIutq0PnTeL7frqd+jbQgJmKcc3lbVXFZM0r96t8EsAuvXXx9ZWl7GuxpNUKAxwOqAY80m1b6Os7175MKeRyGnfvW8HTX14O7UmyYIJp5HrfN9dU1D1ZMUTDw=
+      secure: HG7rC5VSDOZiLCkpTsC4ZImh1k59OPi6YEjYKhdGXItybLHa6Yh5C42WvSx3kVW3SeyLOm1CiaMv+pbBZUXStXYsl8eH69MbEZimhDWsPs/m+bh+gEISov22WNUs3ZfUqIXMIb6v18oXPp2Qa1gX5LUEAGoSxHWNmCAcHayWl7M=

data/CHANGES.md

@@ -1,6 +1,68 @@
 twilio-ruby changelog
 =====================
 
+[2021-06-30] Version 5.56.0
+---------------------------
+**Library - Feature**
+- [PR #559](https://github.com/twilio/twilio-ruby/pull/559): Add `Twilio::HTTP::Client#configure_connection`. Thanks to [@darwinShopify](https://github.com/darwinShopify)!
+- [PR #558](https://github.com/twilio/twilio-ruby/pull/558): Autoload Twilio::REST and Twilio::HTTP. Thanks to [@gmcgibbon](https://github.com/gmcgibbon)!
+
+**Conversations**
+- Read-only Conversation Email Binding property `binding`
+
+**Supersim**
+- Add Billing Period resource for the Super Sim Pilot
+- Add List endpoint to Billing Period resource for Super Sim Pilot
+- Add Fetch endpoint to Billing Period resource for Super Sim Pilot
+
+**Taskrouter**
+- Update `transcribe` & `transcription_configuration` form params in Reservation update endpoint to have private visibility **(breaking change)**
+- Add `transcribe` & `transcription_configuration` form params to Reservation update endpoint
+
+**Twiml**
+- Add `modify` event to `statusCallbackEvent` for `<Conference>`.
+
+
+[2021-06-16] Version 5.55.0
+---------------------------
+**Api**
+- Update `status` enum for Messages to include 'canceled'
+- Update `update_status` enum for Messages to include 'canceled'
+
+**Trusthub**
+- Corrected the sid for policy sid in customer_profile_evaluation.json and trust_product_evaluation.json **(breaking change)**
+
+
+[2021-06-02] Version 5.54.1
+---------------------------
+**Events**
+- join Sinks and Subscriptions service
+
+**Verify**
+- Improved the documentation of `challenge` adding the maximum and minimum expected lengths of some fields.
+- Improve documentation regarding `notification` by updating the documentation of the field `ttl`.
+
+
+[2021-05-19] Version 5.54.0
+---------------------------
+**Events**
+- add query param to return types filtered by Schema Id
+- Add query param to return sinks filtered by status
+- Add query param to return sinks used/not used by a subscription
+
+**Messaging**
+- Add fetch and delete instance endpoints to us_app_to_person api **(breaking change)**
+- Remove delete list endpoint from us_app_to_person api **(breaking change)**
+- Update read list endpoint to return a list of us_app_to_person compliance objects **(breaking change)**
+- Add `sid` field to Preregistered US App To Person response
+
+**Supersim**
+- Mark `unique_name` in Sim, Fleet, NAP resources as not PII
+
+**Video**
+- [Composer] GA maturity level
+
+
 [2021-05-05] Version 5.53.0
 ---------------------------
 **Library - Fix**

data/README.md

@@ -35,13 +35,13 @@ This library supports the following Ruby implementations:
 To install using [Bundler][bundler] grab the latest stable version:
 
 ```ruby
-gem 'twilio-ruby', '~> 5.53.0'
+gem 'twilio-ruby', '~> 5.56.0'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.53.0
+gem install twilio-ruby -v 5.56.0
 ```
 
 To build and install the development branch yourself from the latest source:
@@ -158,6 +158,14 @@ message_sid = 'SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
 
 To use a custom HTTP client with this helper library, please see the [Twilio documentation](https://www.twilio.com/docs/libraries/ruby/custom-http-clients).
 
+To apply customizations such as middleware, you can use the `configure_connection` method like so:
+
+```ruby
+@client.http_client.configure_connection do |faraday|
+  faraday.use SomeMiddleware
+end
+```
+
 ### Handling Errors
 
 ```ruby

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/lib/twilio-ruby/http.rb

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

data/lib/twilio-ruby/http/http_client.rb

@@ -16,18 +16,28 @@ module Twilio
         @ssl_ca_file = ssl_ca_file
         @timeout = timeout
         @adapter = Faraday.default_adapter
+        @configure_connection_blocks = []
+      end
+
+      def configure_connection(&block)
+        raise ArgumentError, "#{__method__} must be given a block!" unless block_given?
+
+        @configure_connection_blocks << block
+        nil
       end
 
       def _request(request)
         @connection = Faraday.new(url: request.host + ':' + request.port.to_s, ssl: { verify: true }) do |f|
           f.options.params_encoder = Faraday::FlatParamsEncoder
           f.request :url_encoded
-          f.adapter @adapter
           f.headers = request.headers
           f.basic_auth(request.auth[0], request.auth[1])
           f.proxy = "#{@proxy_prot}://#{@proxy_auth}#{@proxy_path}" if @proxy_prot && @proxy_path
           f.options.open_timeout = request.timeout || @timeout
           f.options.timeout = request.timeout || @timeout
+
+          @configure_connection_blocks.each { |block| block.call(f) }
+          f.adapter @adapter
         end
 
         @last_request = request

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/rest/api/v2010/account/conference/participant.rb

@@ -107,8 +107,8 @@ module Twilio
               #   `POST`.
               # @param [Array[String]] conference_status_callback_event The conference state
               #   changes that should generate a call to `conference_status_callback`. Can be:
-              #   `start`, `end`, `join`, `leave`, `mute`, `hold`, `speaker`, and `announcement`.
-              #   Separate multiple values with a space. Defaults to `start end`.
+              #   `start`, `end`, `join`, `leave`, `mute`, `hold`, `modify`, `speaker`, and
+              #   `announcement`. Separate multiple values with a space. Defaults to `start end`.
               # @param [String] recording_channels The recording channels for the final
               #   recording. Can be: `mono` or `dual` and the default is `mono`.
               # @param [String] recording_status_callback The URL that we should call using the
@@ -130,13 +130,14 @@ module Twilio
               #   `POST` and defaults to `POST`.
               # @param [Array[String]] recording_status_callback_event The recording state
               #   changes that should generate a call to `recording_status_callback`. Can be:
-              #   `in-progress`, `completed`, and `failed`. Separate multiple values with a space.
-              #   The default value is `in-progress completed failed`.
+              #   `started`, `in-progress`, `paused`, `resumed`, `stopped`, `completed`, `failed`,
+              #   and `absent`. Separate multiple values with a space, ex: `'in-progress completed
+              #   failed'`.
               # @param [Array[String]] conference_recording_status_callback_event The conference
               #   recording state changes that generate a call to
-              #   `conference_recording_status_callback`. Can be: `in-progress`, `completed`, and
-              #   `failed`. Separate multiple values with a space. The default value is
-              #   `in-progress completed failed`.
+              #   `conference_recording_status_callback`. Can be: `in-progress`, `completed`,
+              #   `failed`, and `absent`. Separate multiple values with a space, ex: `'in-progress
+              #   completed failed'`
               # @param [Boolean] coaching Whether the participant is coaching another call. Can
               #   be: `true` or `false`. If not present, defaults to `false` unless
               #   `call_sid_to_coach` is defined. If `true`, `call_sid_to_coach` must be defined.

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

@@ -330,7 +330,7 @@ module Twilio
             # @param [String] body The text of the message you want to send. Can be up to
             #   1,600 characters long.
             # @return [MessageInstance] Updated MessageInstance
-            def update(body: nil)
+            def update(body: :unset)
               data = Twilio::Values.of({'Body' => body, })
 
               payload = @version.update('POST', @uri, data: data)
@@ -580,7 +580,7 @@ module Twilio
             # @param [String] body The text of the message you want to send. Can be up to
             #   1,600 characters long.
             # @return [MessageInstance] Updated MessageInstance
-            def update(body: nil)
+            def update(body: :unset)
               context.update(body: body, )
             end
 

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

@@ -37,6 +37,7 @@ module Twilio
         @events = nil
         @fax = nil
         @flex_api = nil
+        @frontline_api = nil
         @insights = nil
         @ip_messaging = nil
         @lookups = nil
@@ -206,6 +207,12 @@ module Twilio
         @flex_api ||= FlexApi.new self
       end
 
+      ##
+      # Access the FrontlineApi Twilio Domain
+      def frontline_api
+        @frontline_api ||= FrontlineApi.new self
+      end
+
       ##
       # Access the Insights Twilio Domain
       def insights

data/lib/twilio-ruby/rest/conversations/v1/conversation.rb

@@ -362,6 +362,7 @@ module Twilio
                 'timers' => payload['timers'],
                 'url' => payload['url'],
                 'links' => payload['links'],
+                'bindings' => payload['bindings'],
             }
 
             # Context
@@ -458,6 +459,12 @@ module Twilio
             @properties['links']
           end
 
+          ##
+          # @return [Hash] The bindings
+          def bindings
+            @properties['bindings']
+          end
+
           ##
           # Update the ConversationInstance
           # @param [String] friendly_name The human-readable name of this conversation,

data/lib/twilio-ruby/rest/conversations/v1/service/conversation.rb

@@ -394,6 +394,7 @@ module Twilio
                   'timers' => payload['timers'],
                   'url' => payload['url'],
                   'links' => payload['links'],
+                  'bindings' => payload['bindings'],
               }
 
               # Context
@@ -490,6 +491,12 @@ module Twilio
               @properties['links']
             end
 
+            ##
+            # @return [Hash] The bindings
+            def bindings
+              @properties['bindings']
+            end
+
             ##
             # Update the ConversationInstance
             # @param [String] friendly_name The human-readable name of this conversation,

data/lib/twilio-ruby/rest/events/v1/event_type.rb

@@ -29,6 +29,8 @@ module Twilio
           # Lists EventTypeInstance records from the API as a list.
           # Unlike stream(), this operation is eager and will load `limit` records into
           # memory before returning.
+          # @param [String] schema_id A string parameter filtering the results to return
+          #   only the Event Types using a given schema.
           # @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
@@ -36,14 +38,16 @@ module Twilio
           #    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
+          def list(schema_id: :unset, limit: nil, page_size: nil)
+            self.stream(schema_id: schema_id, limit: limit, page_size: page_size).entries
           end
 
           ##
           # Streams EventTypeInstance records from the API as an Enumerable.
           # This operation lazily loads records as efficiently as possible until the limit
           # is reached.
+          # @param [String] schema_id A string parameter filtering the results to return
+          #   only the Event Types using a given schema.
           # @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
@@ -51,10 +55,10 @@ module Twilio
           #    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)
+          def stream(schema_id: :unset, limit: nil, page_size: nil)
             limits = @version.read_limits(limit, page_size)
 
-            page = self.page(page_size: limits[:page_size], )
+            page = self.page(schema_id: schema_id, page_size: limits[:page_size], )
 
             @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
           end
@@ -76,12 +80,15 @@ module Twilio
           ##
           # Retrieve a single page of EventTypeInstance records from the API.
           # Request is executed immediately.
+          # @param [String] schema_id A string parameter filtering the results to return
+          #   only the Event Types using a given schema.
           # @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 EventTypeInstance
-          def page(page_token: :unset, page_number: :unset, page_size: :unset)
+          def page(schema_id: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
             params = Twilio::Values.of({
+                'SchemaId' => schema_id,
                 'PageToken' => page_token,
                 'Page' => page_number,
                 'PageSize' => page_size,