twilio-ruby 5.10.1 → 5.10.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 44813fd91c7b8d7e409fd23e388303f45aa62e7d
-  data.tar.gz: 0ea68a8fc4e46fa080f369ebab9c88cf4e5fd32e
+  metadata.gz: b8f3bb7818ab79d0310f3aa52a686aa21a0404c0
+  data.tar.gz: f21379efc9736fc94cff5e7d456730b19284313e
 SHA512:
-  metadata.gz: 1c5affb763dba791e78bd3d859dc61845050107455657d6df3a13881a9835d844098085e7d666c0573062897935cd0f4cd64426138774b866c9268364097bea8
-  data.tar.gz: c93c228d311ff2645ee0aa3f1a481230ae5acbf612088ec44069c307897fde527eca9861413d827fdbd1b4930c2d46e582f6daf4bd3b8d886dc7f7232109a550
+  metadata.gz: d0368ed2a1c4b9cdd40ed62e86e59e5aeac6fc4db02e48c4d9b935923f4e1f64cd45ad0202442b586002cb23e403eb4e60d29a817df90085c75fde850ef09a7b
+  data.tar.gz: 8f713191f1498c852389dd3b3d683c14367fb7302bc56ebe17100696c226a5f0deb31d70491ccdbdd73e887a636540a76cbb939ccc544d881cb7263c3222c7cd

data/CHANGES.md

@@ -1,6 +1,12 @@
 twilio-ruby changelog
 =====================
 
+[2018-05-25] Version 5.10.2
+----------------------------
+**Studio**
+- Add endpoint to delete engagements
+
+
 [2018-05-18] Version 5.10.1
 ----------------------------
 **Api**

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.1'
+gem 'twilio-ruby', '~> 5.10.2'
 ```
 
 To manually install `twilio-ruby` via [Rubygems][rubygems] simply gem install:
 
 ```bash
-gem install twilio-ruby -v 5.10.1
+gem install twilio-ruby -v 5.10.2
 ```
 
 To build and install the development branch yourself from the latest source:

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

@@ -70,9 +70,7 @@ module Twilio
             #   to URL-encode this string, since the '`#`' character has special meaning in a
             #   URL. If both `SendDigits` and `MachineDetection` parameters are provided, then
             #   `MachineDetection` will be ignored.
-            # @param [String] if_machine Tell Twilio to try and determine if a machine (like
-            #   voicemail) or a human has answered the call. Possible value are `Continue` and
-            #   `Hangup`.
+            # @param [String] if_machine The if_machine
             # @param [String] timeout The integer number of seconds that Twilio should allow
             #   the phone to ring before assuming there is no answer. Default is `60` seconds,
             #   the maximum is `600` seconds. For some call flows Twilio will add a 5 second

data/lib/twilio-ruby/rest/studio/v1/flow/engagement.rb

@@ -206,6 +206,13 @@ module Twilio
               EngagementInstance.new(@version, payload, flow_sid: @solution[:flow_sid], sid: @solution[:sid], )
             end
 
+            ##
+            # Deletes the EngagementInstance
+            # @return [Boolean] true if delete succeeds, true otherwise
+            def delete
+              @version.delete('delete', @uri)
+            end
+
             ##
             # Access the steps
             # @return [StepList]
@@ -357,6 +364,13 @@ module Twilio
               context.fetch
             end
 
+            ##
+            # Deletes the EngagementInstance
+            # @return [Boolean] true if delete succeeds, true otherwise
+            def delete
+              context.delete
+            end
+
             ##
             # Access the steps
             # @return [steps] steps

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

@@ -145,15 +145,49 @@ module Twilio
           ##
           # Retrieve a single page of CompositionInstance records from the API.
           # Request is executed immediately.
-          # @param [String] room_sid The room_sid
-          # @param [Hash] video_layout The video_layout
-          # @param [String] audio_sources The audio_sources
-          # @param [String] audio_sources_excluded The audio_sources_excluded
-          # @param [String] resolution The resolution
-          # @param [composition.Format] format The format
-          # @param [String] status_callback The status_callback
-          # @param [String] status_callback_method The status_callback_method
-          # @param [Boolean] trim The trim
+          # @param [String] room_sid Group Room SID owning the media tracks to be used as
+          #   Composition sources.
+          # @param [Hash] video_layout A JSON object defining the video layout of the
+          #   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>
+          # @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>
+          # @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`.
+          # @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`
+          #   element containing a valid `video_sources` list, otherwise an error is fired.
+          #   Defaults to `webm`.
+          # @param [String] status_callback A URL that Twilio sends asynchronous webhook
+          #   requests to on every composition event. If not provided, status callback events
+          #   will not be dispatched.
+          # @param [String] status_callback_method HTTP method Twilio should use when
+          #   requesting the above URL. Defaults to `POST`.
+          # @param [Boolean] trim When activated, clips all the Composition intervals where
+          #   there is no active media. This results in shorter compositions in cases when the
+          #   Room was created but no Participant joined for some time, or if all the
+          #   Participants left the room and joined at a later stage, as those gaps will be
+          #   removed. You can find further information in the [Managing Video
+          #   Layouts](#managing-video-layouts) section. Defaults to `true`.
           # @return [CompositionInstance] Newly created CompositionInstance
           def create(room_sid: :unset, video_layout: :unset, audio_sources: :unset, audio_sources_excluded: :unset, resolution: :unset, format: :unset, status_callback: :unset, status_callback_method: :unset, trim: :unset)
             data = Twilio::Values.of({

data/lib/twilio-ruby/version.rb

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

data/spec/integration/studio/v1/flow/engagement_spec.rb

@@ -140,4 +140,32 @@ describe 'Engagement' do
 
     expect(actual).to_not eq(nil)
   end
+
+  it "can delete" do
+    @holodeck.mock(Twilio::Response.new(500, ''))
+
+    expect {
+      @client.studio.v1.flows('FWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                       .engagements('FNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').delete()
+    }.to raise_exception(Twilio::REST::TwilioError)
+
+    values = {}
+    expect(
+    @holodeck.has_request?(Holodeck::Request.new(
+        method: 'delete',
+        url: 'https://studio.twilio.com/v1/Flows/FWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Engagements/FNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',
+    ))).to eq(true)
+  end
+
+  it "receives delete responses" do
+    @holodeck.mock(Twilio::Response.new(
+        204,
+      nil,
+    ))
+
+    actual = @client.studio.v1.flows('FWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX') \
+                              .engagements('FNXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX').delete()
+
+    expect(actual).to eq(true)
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: twilio-ruby
 version: !ruby/object:Gem::Version
-  version: 5.10.1
+  version: 5.10.2
 platform: ruby
 authors:
 - Twilio API Team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-05-18 00:00:00.000000000 Z
+date: 2018-05-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jwt