twilio-ruby 4.13.0 → 5.6.4

data/lib/twilio-ruby/{util → security}/request_validator.rb

@@ -1,14 +1,14 @@
 module Twilio
-  module Util
+  module Security
     class RequestValidator
-
       def initialize(auth_token = nil)
         @auth_token = auth_token || Twilio.auth_token
         raise ArgumentError, 'Auth token is required' if @auth_token.nil?
       end
 
       def validate(url, params, signature)
-        expected = build_signature_for url, params
+        params_hash = params_to_hash(params)
+        expected = build_signature_for(url, params_hash)
         secure_compare(expected, signature)
       end
 
@@ -30,7 +30,24 @@ module Twilio
 
         res = 0
         b.each_byte { |byte| res |= byte ^ l.shift }
-        res == 0
+        res.zero?
+      end
+
+      # `ActionController::Parameters` no longer, as of Rails 5, inherits
+      # from `Hash` so the `sort` method, used above in `build_signature_for`
+      # is deprecated.
+      #
+      # `to_unsafe_h` was introduced in Rails 4.2.1, before then it is still
+      # possible to sort on an ActionController::Parameters object.
+      #
+      # We use `to_unsafe_h` as `to_h` returns a hash of the permitted
+      # parameters only and we need all the parameters to create the signature.
+      def params_to_hash(params)
+        if params.respond_to?(:to_unsafe_h)
+          params.to_unsafe_h
+        else
+          params
+        end
       end
     end
   end

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

@@ -0,0 +1,40 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+
+module Twilio
+  module TwiML
+    ##
+    # <Response> TwiML for Faxes
+    class FaxResponse < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Response'
+
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Receive> element
+      # action:: Receive action URL
+      # method:: Receive action URL method
+      # keyword_args:: additional attributes
+      def receive(action: nil, method: nil, **keyword_args)
+        append(Receive.new(action: action, method: method, **keyword_args))
+      end
+    end
+
+    ##
+    # <Receive> TwiML Verb
+    class Receive < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Receive'
+
+        yield(self) if block_given?
+      end
+    end
+  end
+end

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

@@ -0,0 +1,105 @@
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+
+module Twilio
+  module TwiML
+    ##
+    # <Response> TwiML for Messages
+    class MessagingResponse < TwiML
+      def initialize(**keyword_args)
+        super(**keyword_args)
+        @name = 'Response'
+
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Message> element
+      # body:: Message Body
+      # to:: Phone Number to send Message to
+      # from:: Phone Number to send Message from
+      # action:: Action URL
+      # method:: Action URL Method
+      # status_callback:: Status callback URL. Deprecated in favor of action.
+      # keyword_args:: additional attributes
+      def message(body: nil, to: nil, from: nil, action: nil, method: nil, status_callback: nil, **keyword_args)
+        message = Message.new(body: body, to: to, from: from, action: action, method: method, status_callback: status_callback, **keyword_args)
+
+        yield(message) if block_given?
+        append(message)
+      end
+
+      ##
+      # Create a new <Redirect> element
+      # url:: Redirect URL
+      # method:: Redirect URL method
+      # keyword_args:: additional attributes
+      def redirect(url, method: nil, **keyword_args)
+        append(Redirect.new(url, method: method, **keyword_args))
+      end
+    end
+
+    ##
+    # <Redirect> TwiML Verb
+    class Redirect < TwiML
+      def initialize(url, **keyword_args)
+        super(**keyword_args)
+        @name = 'Redirect'
+        @value = url
+        yield(self) if block_given?
+      end
+    end
+
+    ##
+    # <Message> TwiML Verb
+    class Message < TwiML
+      def initialize(body: nil, **keyword_args)
+        super(**keyword_args)
+        @name = 'Message'
+        @value = body unless body.nil?
+        yield(self) if block_given?
+      end
+
+      ##
+      # Create a new <Body> element
+      # message:: Message Body
+      # keyword_args:: additional attributes
+      def body(message, **keyword_args)
+        append(Body.new(message, **keyword_args))
+      end
+
+      ##
+      # Create a new <Media> element
+      # url:: Media URL
+      # keyword_args:: additional attributes
+      def media(url, **keyword_args)
+        append(Media.new(url, **keyword_args))
+      end
+    end
+
+    ##
+    # <Media> TwiML Noun
+    class Media < TwiML
+      def initialize(url, **keyword_args)
+        super(**keyword_args)
+        @name = 'Media'
+        @value = url
+        yield(self) if block_given?
+      end
+    end
+
+    ##
+    # <Body> TwiML Noun
+    class Body < TwiML
+      def initialize(message, **keyword_args)
+        super(**keyword_args)
+        @name = 'Body'
+        @value = message
+        yield(self) if block_given?
+      end
+    end
+  end
+end

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

@@ -0,0 +1,75 @@
+require 'nokogiri'
+
+##
+# This code was generated by
+# \ / _    _  _|   _  _
+#  | (_)\/(_)(_|\/| |(/_  v1.0.0
+#       /       /
+
+module Twilio
+  module TwiML
+    class TwiMLError < StandardError; end
+
+    class TwiML
+        attr_accessor :name
+
+        def initialize(**keyword_args)
+          @name = self.class.name.split('::').last
+          @value = nil
+          @verbs = []
+          @attrs = {}
+
+          keyword_args.each do |key, val|
+            @attrs[TwiML.to_lower_camel_case(key)] = val unless val.nil?
+          end
+        end
+
+        def self.to_lower_camel_case(symbol)
+          # Symbols don't have the .split method, so convert to string first
+          result = symbol.to_s
+          if result.include? '_'
+            result = result.split('_').map(&:capitalize).join
+          end
+          result[0].downcase + result[1..result.length]
+        end
+
+        def to_s(xml_declaration = true)
+          opts = { encoding: 'UTF-8', indent: 0 }
+          document = Nokogiri::XML::Document.new
+          xml = self.xml(document).to_xml(opts).gsub(/\n/, '')
+          return ('<?xml version="1.0" encoding="UTF-8"?>' + xml) if xml_declaration
+          xml
+        end
+
+        def xml(document)
+          # create XML element
+          value = (@value.is_a?(String) or @value == nil) ? @value : JSON.generate(@value)
+          elem = Nokogiri::XML::Node.new(@name, document)
+          elem.content = value
+          # set element attributes
+          keys = @attrs.keys.sort
+          keys.each do |key|
+            value = @attrs[key]
+
+            value_is_boolean = value.is_a?(TrueClass) || value.is_a?(FalseClass)
+            elem[key] = value_is_boolean ? value.to_s.downcase : value.to_s
+          end
+
+          @verbs.each do |verb|
+            elem << verb.xml(document)
+          end
+
+          elem
+        end
+
+        def append(verb)
+          raise TwiMLError, 'Only appending of TwiML is allowed' unless verb.is_a?(TwiML)
+
+          @verbs << verb
+          self
+        end
+
+      alias to_xml to_s
+    end
+  end
+end