twilio-ruby 7.9.1 → 7.10.0

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

@@ -28,6 +28,7 @@ module Twilio
                     # @return [NotificationList] NotificationList
                     def initialize(version, account_sid: nil, call_sid: nil)
                         super(version)
+                        
                         # Path Solution
                         @solution = { account_sid: account_sid, call_sid: call_sid }
                         @uri = "/Accounts/#{@solution[:account_sid]}/Calls/#{@solution[:call_sid]}/Notifications.json"
@@ -88,6 +89,36 @@ module Twilio
                         @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
                     end
 
+                    ##
+                    # Lists NotificationPageMetadata records from the API as a list.
+                      # @param [String] log Only read notifications of the specified log level. Can be:  `0` to read only ERROR notifications or `1` to read only WARNING notifications. By default, all notifications are read.
+                      # @param [Date] message_date Only show notifications for the specified date, formatted as `YYYY-MM-DD`. You can also specify an inequality, such as `<=YYYY-MM-DD` for messages logged at or before midnight on a date, or `>=YYYY-MM-DD` for messages logged at or after midnight on a date.
+                      # @param [Date] message_date_before Only show notifications for the specified date, formatted as `YYYY-MM-DD`. You can also specify an inequality, such as `<=YYYY-MM-DD` for messages logged at or before midnight on a date, or `>=YYYY-MM-DD` for messages logged at or after midnight on a date.
+                      # @param [Date] message_date_after Only show notifications for the specified date, formatted as `YYYY-MM-DD`. You can also specify an inequality, such as `<=YYYY-MM-DD` for messages logged at or before midnight on a date, or `>=YYYY-MM-DD` for messages logged at or after midnight on a date.
+                    # @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_with_metadata(log: :unset, message_date: :unset, message_date_before: :unset, message_date_after: :unset, limit: nil, page_size: nil)
+                        limits = @version.read_limits(limit, page_size)
+                        params = Twilio::Values.of({
+                            'Log' => log,
+                            'MessageDate' =>  Twilio.serialize_iso8601_date(message_date),
+                            'MessageDate<' =>  Twilio.serialize_iso8601_date(message_date_before),
+                            'MessageDate>' =>  Twilio.serialize_iso8601_date(message_date_after),
+                            
+                            'PageSize' => limits[:page_size],
+                        });
+                        headers = Twilio::Values.of({})
+
+                        response = @version.page('GET', @uri, params: params, headers: headers)
+
+                        NotificationPageMetadata.new(@version, response, @solution, limits[:limit])
+                    end
+
                     ##
                     # When passed a block, yields NotificationInstance records from the API.
                     # This operation lazily loads records as efficiently as possible until the limit
@@ -113,7 +144,7 @@ module Twilio
                     # @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 NotificationInstance
-                    def page(log: :unset, message_date: :unset, message_date_before: :unset, message_date_after: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
+                    def page(log: :unset, message_date: :unset, message_date_before: :unset, message_date_after: :unset, page_token: :unset, page_number: :unset,page_size: :unset)
                         params = Twilio::Values.of({
                             'Log' => log,
                             'MessageDate' =>  Twilio.serialize_iso8601_date(message_date),
@@ -164,6 +195,7 @@ module Twilio
                     # @return [NotificationContext] NotificationContext
                     def initialize(version, account_sid, call_sid, sid)
                         super(version)
+                        
 
                         # Path Solution
                         @solution = { account_sid: account_sid, call_sid: call_sid, sid: sid,  }
@@ -192,6 +224,33 @@ module Twilio
                         )
                     end
 
+                    ##
+                    # Fetch the NotificationInstanceMetadata
+                    # @return [NotificationInstance] Fetched NotificationInstance
+                    def fetch_with_metadata
+
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
+                        
+                        
+                        
+                        
+                        
+                        response = @version.fetch_with_metadata('GET', @uri, headers: headers)
+                        notification_instance = NotificationInstance.new(
+                            @version,
+                            response.body,
+                            account_sid: @solution[:account_sid],
+                            call_sid: @solution[:call_sid],
+                            sid: @solution[:sid],
+                        )
+                        NotificationInstanceMetadata.new(
+                            @version,
+                            notification_instance,
+                            response.headers,
+                            response.status_code
+                        )
+                    end
+
 
                     ##
                     # Provide a user friendly representation
@@ -208,6 +267,53 @@ module Twilio
                     end
                 end
 
+                class NotificationInstanceMetadata <  InstanceResourceMetadata
+                    ##
+                    # Initializes a new NotificationInstanceMetadata.
+                    # @param [Version] version Version that contains the resource
+                    # @param [}NotificationInstance] notification_instance The instance associated with the metadata.
+                    # @param [Hash] headers Header object with response headers.
+                    # @param [Integer] status_code The HTTP status code of the response.
+                    # @return [NotificationInstanceMetadata] The initialized instance with metadata.
+                    def initialize(version, notification_instance, headers, status_code)
+                        super(version, headers, status_code)
+                        @notification_instance = notification_instance
+                    end
+
+                    def notification
+                        @notification_instance
+                    end
+
+                    def headers
+                        @headers
+                    end
+
+                    def status_code
+                        @status_code
+                    end
+
+                    def to_s
+                      "<Twilio.Api.V2010.NotificationInstanceMetadata status=#{@status_code}>"
+                    end
+                end
+
+                class NotificationListResponse < InstanceListResource
+                    # @param [Array<NotificationInstance>] instance
+                    # @param [Hash{String => Object}] headers
+                    # @param [Integer] status_code
+                    def initialize(version, payload, key)
+                       @notification_instance = payload.body[key].map do |data|
+                        NotificationInstance.new(version, data)
+                       end
+                       @headers = payload.headers
+                       @status_code = payload.status_code
+                    end
+
+                      def notification_instance
+                          @instance
+                      end
+                  end
+
                 class NotificationPage < Page
                     ##
                     # Initialize the NotificationPage
@@ -217,6 +323,7 @@ module Twilio
                     # @return [NotificationPage] NotificationPage
                     def initialize(version, response, solution)
                         super(version, response)
+                        
 
                         # Path Solution
                         @solution = solution
@@ -236,6 +343,66 @@ module Twilio
                         '<Twilio.Api.V2010.NotificationPage>'
                     end
                 end
+
+                class NotificationPageMetadata < PageMetadata
+                    attr_reader :notification_page
+
+                    def initialize(version, response, solution, limit)
+                        super(version, response)
+                        @notification_page = []
+                        @limit = limit
+                        key = get_key(response.body)
+                        records = 0
+                        while( limit != :unset && records < limit )
+                            @notification_page << NotificationListResponse.new(version, @payload, key, limit - records)
+                            @payload = self.next_page
+                            break unless @payload
+                            records += @payload.body[key].size
+                        end
+                        # Path Solution
+                        @solution = solution
+                    end
+
+                    def each
+                        @notification_page.each do |record|
+                          yield record
+                        end
+                    end
+
+                    def to_s
+                      '<Twilio::REST::Api::V2010PageMetadata>';
+                    end
+                end
+                class NotificationListResponse < InstanceListResource
+
+                    # @param [Array<NotificationInstance>] instance
+                    # @param [Hash{String => Object}] headers
+                    # @param [Integer] status_code
+                    def initialize(version, payload, key, limit = :unset)
+                      data_list = payload.body[key]
+                      if limit != :unset
+                        data_list = data_list[0, limit]
+                      end
+                      @notification = data_list.map do |data|
+                        NotificationInstance.new(version, data)
+                      end
+                      @headers = payload.headers
+                      @status_code = payload.status_code
+                    end
+
+                    def notification
+                        @notification
+                    end
+
+                    def headers
+                      @headers
+                    end
+
+                    def status_code
+                      @status_code
+                    end
+                end
+
                 class NotificationInstance < InstanceResource
                     ##
                     # Initialize the NotificationInstance
@@ -249,6 +416,7 @@ module Twilio
                     def initialize(version, payload , account_sid: nil, call_sid: nil, sid: nil)
                         super(version)
                         
+                        
                         # Marshaled Properties
                         @properties = { 
                             'account_sid' => payload['account_sid'],

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

@@ -28,6 +28,7 @@ module Twilio
                     # @return [PaymentList] PaymentList
                     def initialize(version, account_sid: nil, call_sid: nil)
                         super(version)
+                        
                         # Path Solution
                         @solution = { account_sid: account_sid, call_sid: call_sid }
                         @uri = "/Accounts/#{@solution[:account_sid]}/Calls/#{@solution[:call_sid]}/Payments.json"
@@ -105,6 +106,84 @@ module Twilio
                         )
                     end
 
+                    ##
+                    # Create the PaymentInstanceMetadata
+                    # @param [String] idempotency_key A unique token that will be used to ensure that multiple API calls with the same information do not result in multiple transactions. This should be a unique string value per API call and can be a randomly generated.
+                    # @param [String] status_callback Provide an absolute or relative URL to receive status updates regarding your Pay session. Read more about the [expected StatusCallback values](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback)
+                    # @param [BankAccountType] bank_account_type 
+                    # @param [Float] charge_amount A positive decimal value less than 1,000,000 to charge against the credit card or bank account. Default currency can be overwritten with `currency` field. Leave blank or set to 0 to tokenize.
+                    # @param [String] currency The currency of the `charge_amount`, formatted as [ISO 4127](http://www.iso.org/iso/home/standards/currency_codes.htm) format. The default value is `USD` and all values allowed from the Pay Connector are accepted.
+                    # @param [String] description The description can be used to provide more details regarding the transaction. This information is submitted along with the payment details to the Payment Connector which are then posted on the transactions.
+                    # @param [String] input A list of inputs that should be accepted. Currently only `dtmf` is supported. All digits captured during a pay session are redacted from the logs.
+                    # @param [String] min_postal_code_length A positive integer that is used to validate the length of the `PostalCode` inputted by the user. User must enter this many digits.
+                    # @param [Object] parameter A single-level JSON object used to pass custom parameters to payment processors. (Required for ACH payments). The information that has to be included here depends on the <Pay> Connector. [Read more](https://www.twilio.com/console/voice/pay-connectors).
+                    # @param [String] payment_connector This is the unique name corresponding to the Pay Connector installed in the Twilio Add-ons. Learn more about [<Pay> Connectors](https://www.twilio.com/console/voice/pay-connectors). The default value is `Default`.
+                    # @param [PaymentMethod] payment_method 
+                    # @param [Boolean] postal_code Indicates whether the credit card postal code (zip code) is a required piece of payment information that must be provided by the caller. The default is `true`.
+                    # @param [Boolean] security_code Indicates whether the credit card security code is a required piece of payment information that must be provided by the caller. The default is `true`.
+                    # @param [String] timeout The number of seconds that <Pay> should wait for the caller to press a digit between each subsequent digit, after the first one, before moving on to validate the digits captured. The default is `5`, maximum is `600`.
+                    # @param [TokenType] token_type 
+                    # @param [String] valid_card_types Credit card types separated by space that Pay should accept. The default value is `visa mastercard amex`
+                    # @return [PaymentInstance] Created PaymentInstance
+                    def create_with_metadata(
+                      idempotency_key: nil, 
+                      status_callback: nil, 
+                      bank_account_type: :unset, 
+                      charge_amount: :unset, 
+                      currency: :unset, 
+                      description: :unset, 
+                      input: :unset, 
+                      min_postal_code_length: :unset, 
+                      parameter: :unset, 
+                      payment_connector: :unset, 
+                      payment_method: :unset, 
+                      postal_code: :unset, 
+                      security_code: :unset, 
+                      timeout: :unset, 
+                      token_type: :unset, 
+                      valid_card_types: :unset
+                    )
+
+                        data = Twilio::Values.of({
+                            'IdempotencyKey' => idempotency_key,
+                            'StatusCallback' => status_callback,
+                            'BankAccountType' => bank_account_type,
+                            'ChargeAmount' => charge_amount,
+                            'Currency' => currency,
+                            'Description' => description,
+                            'Input' => input,
+                            'MinPostalCodeLength' => min_postal_code_length,
+                            'Parameter' => Twilio.serialize_object(parameter),
+                            'PaymentConnector' => payment_connector,
+                            'PaymentMethod' => payment_method,
+                            'PostalCode' => postal_code,
+                            'SecurityCode' => security_code,
+                            'Timeout' => timeout,
+                            'TokenType' => token_type,
+                            'ValidCardTypes' => valid_card_types,
+                        })
+
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
+                        
+                        
+                        
+                        
+                        
+                        response = @version.create_with_metadata('POST', @uri, data: data, headers: headers)
+                        payment_instance = PaymentInstance.new(
+                            @version,
+                            response.body,
+                            account_sid: @solution[:account_sid],
+                            call_sid: @solution[:call_sid],
+                        )
+                        PaymentInstanceMetadata.new(
+                            @version,
+                            payment_instance,
+                            response.headers,
+                            response.status_code
+                        )
+                    end
+
                 
 
 
@@ -125,6 +204,7 @@ module Twilio
                     # @return [PaymentContext] PaymentContext
                     def initialize(version, account_sid, call_sid, sid)
                         super(version)
+                        
 
                         # Path Solution
                         @solution = { account_sid: account_sid, call_sid: call_sid, sid: sid,  }
@@ -169,6 +249,49 @@ module Twilio
                         )
                     end
 
+                    ##
+                    # Update the PaymentInstanceMetadata
+                    # @param [String] idempotency_key A unique token that will be used to ensure that multiple API calls with the same information do not result in multiple transactions. This should be a unique string value per API call and can be a randomly generated.
+                    # @param [String] status_callback Provide an absolute or relative URL to receive status updates regarding your Pay session. Read more about the [Update](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-update) and [Complete/Cancel](https://www.twilio.com/docs/voice/api/payment-resource#statuscallback-cancelcomplete) POST requests.
+                    # @param [Capture] capture 
+                    # @param [Status] status 
+                    # @return [PaymentInstance] Updated PaymentInstance
+                    def update_with_metadata(
+                      idempotency_key: nil, 
+                      status_callback: nil, 
+                      capture: :unset, 
+                      status: :unset
+                    )
+
+                        data = Twilio::Values.of({
+                            'IdempotencyKey' => idempotency_key,
+                            'StatusCallback' => status_callback,
+                            'Capture' => capture,
+                            'Status' => status,
+                        })
+
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
+                        
+                        
+                        
+                        
+                        
+                        response = @version.update_with_metadata('POST', @uri, data: data, headers: headers)
+                        payment_instance = PaymentInstance.new(
+                            @version,
+                            response.body,
+                            account_sid: @solution[:account_sid],
+                            call_sid: @solution[:call_sid],
+                            sid: @solution[:sid],
+                        )
+                        PaymentInstanceMetadata.new(
+                            @version,
+                            payment_instance,
+                            response.headers,
+                            response.status_code
+                        )
+                    end
+
 
                     ##
                     # Provide a user friendly representation
@@ -185,6 +308,53 @@ module Twilio
                     end
                 end
 
+                class PaymentInstanceMetadata <  InstanceResourceMetadata
+                    ##
+                    # Initializes a new PaymentInstanceMetadata.
+                    # @param [Version] version Version that contains the resource
+                    # @param [}PaymentInstance] payment_instance The instance associated with the metadata.
+                    # @param [Hash] headers Header object with response headers.
+                    # @param [Integer] status_code The HTTP status code of the response.
+                    # @return [PaymentInstanceMetadata] The initialized instance with metadata.
+                    def initialize(version, payment_instance, headers, status_code)
+                        super(version, headers, status_code)
+                        @payment_instance = payment_instance
+                    end
+
+                    def payment
+                        @payment_instance
+                    end
+
+                    def headers
+                        @headers
+                    end
+
+                    def status_code
+                        @status_code
+                    end
+
+                    def to_s
+                      "<Twilio.Api.V2010.PaymentInstanceMetadata status=#{@status_code}>"
+                    end
+                end
+
+                class PaymentListResponse < InstanceListResource
+                    # @param [Array<PaymentInstance>] instance
+                    # @param [Hash{String => Object}] headers
+                    # @param [Integer] status_code
+                    def initialize(version, payload, key)
+                       @payment_instance = payload.body[key].map do |data|
+                        PaymentInstance.new(version, data)
+                       end
+                       @headers = payload.headers
+                       @status_code = payload.status_code
+                    end
+
+                      def payment_instance
+                          @instance
+                      end
+                  end
+
                 class PaymentPage < Page
                     ##
                     # Initialize the PaymentPage
@@ -194,6 +364,7 @@ module Twilio
                     # @return [PaymentPage] PaymentPage
                     def initialize(version, response, solution)
                         super(version, response)
+                        
 
                         # Path Solution
                         @solution = solution
@@ -213,6 +384,66 @@ module Twilio
                         '<Twilio.Api.V2010.PaymentPage>'
                     end
                 end
+
+                class PaymentPageMetadata < PageMetadata
+                    attr_reader :payment_page
+
+                    def initialize(version, response, solution, limit)
+                        super(version, response)
+                        @payment_page = []
+                        @limit = limit
+                        key = get_key(response.body)
+                        records = 0
+                        while( limit != :unset && records < limit )
+                            @payment_page << PaymentListResponse.new(version, @payload, key, limit - records)
+                            @payload = self.next_page
+                            break unless @payload
+                            records += @payload.body[key].size
+                        end
+                        # Path Solution
+                        @solution = solution
+                    end
+
+                    def each
+                        @payment_page.each do |record|
+                          yield record
+                        end
+                    end
+
+                    def to_s
+                      '<Twilio::REST::Api::V2010PageMetadata>';
+                    end
+                end
+                class PaymentListResponse < InstanceListResource
+
+                    # @param [Array<PaymentInstance>] instance
+                    # @param [Hash{String => Object}] headers
+                    # @param [Integer] status_code
+                    def initialize(version, payload, key, limit = :unset)
+                      data_list = payload.body[key]
+                      if limit != :unset
+                        data_list = data_list[0, limit]
+                      end
+                      @payment = data_list.map do |data|
+                        PaymentInstance.new(version, data)
+                      end
+                      @headers = payload.headers
+                      @status_code = payload.status_code
+                    end
+
+                    def payment
+                        @payment
+                    end
+
+                    def headers
+                      @headers
+                    end
+
+                    def status_code
+                      @status_code
+                    end
+                end
+
                 class PaymentInstance < InstanceResource
                     ##
                     # Initialize the PaymentInstance
@@ -226,6 +457,7 @@ module Twilio
                     def initialize(version, payload , account_sid: nil, call_sid: nil, sid: nil)
                         super(version)
                         
+                        
                         # Marshaled Properties
                         @properties = { 
                             'account_sid' => payload['account_sid'],