twilio-ruby 7.4.4 → 7.10.4

data/lib/twilio-ruby/framework/rest/page_metadata.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    # Page Base Class
+    class PageMetadata
+      META_KEYS = [
+        'end',
+        'first_page_uri',
+        'next_page_uri',
+        'last_page_uri',
+        'page',
+        'page_size',
+        'previous_page_uri',
+        'total',
+        'num_pages',
+        'start',
+        'uri'
+      ].freeze
+
+      def initialize(version, response)
+        payload = process_response(response)
+
+        @version = version
+        @payload = payload
+        @solution = {}
+        @records = payload
+      end
+
+      def process_response(response)
+        return response if response.status_code == 200
+
+        raise Twilio::REST::RestError.new('Unable to fetch page', response)
+      end
+
+      def get_key(payload)
+        return 'Resources' if payload['Resources']
+
+        return payload['meta']['key'] if payload['meta'] && payload['meta']['key']
+
+        keys = payload.keys
+        key = keys - META_KEYS
+        return key.first if key.size == 1
+
+        raise Twilio::REST::TwilioError, 'Page Records can not be deserialized'
+      end
+
+      def previous_page_url
+        # rubocop:disable Layout/LineLength
+        return @version.domain.absolute_url(URI.parse(@payload['meta']['previous_page_url']).request_uri) if @payload['meta'] && @payload['meta']['previous_page_url']
+        # rubocop:enable Layout/LineLength
+        return @version.domain.absolute_url(@payload['previous_page_uri']) if @payload['previous_page_uri']
+
+        nil
+      end
+
+      def next_page_url
+        # rubocop:disable Layout/LineLength
+        return @version.domain.absolute_url(URI.parse(@payload.body['meta']['next_page_url']).request_uri) if @payload.body['meta'] && @payload.body['meta']['next_page_url']
+        # rubocop:enable Layout/LineLength
+        return @version.domain.absolute_url(@payload.body['next_page_uri']) if @payload.body['next_page_uri']
+
+        nil
+      end
+
+      def previous_page
+        return nil unless previous_page_url
+
+        @version.domain.request('GET', previous_page_url)
+      end
+
+      def next_page
+        return nil unless next_page_url
+
+        @version.domain.request('GET', next_page_url)
+      end
+
+      def to_s
+        '#<PageMetadata>'
+      end
+    end
+  end
+end

data/lib/twilio-ruby/framework/rest/resource.rb

@@ -19,5 +19,21 @@ module Twilio
         @version = version
       end
     end
+
+    class InstanceResourceMetadata
+      def initialize(payload, headers, status_code)
+        @payload = payload
+        @headers = headers
+        @status_code = status_code
+      end
+    end
+
+    class InstanceListResource
+      def initialize(version, headers, status_code)
+        @version = version
+        @headers = headers
+        @status_code = status_code
+      end
+    end
   end
 end

data/lib/twilio-ruby/framework/rest/token_page.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Twilio
+  module REST
+    class TokenPage < Page
+      attr_accessor :key, :page_size, :url
+
+      def initialize(version, response)
+        super(version, response)
+
+        @client = @version.domain.client.http_client
+        @url = ''
+        if @client.last_request
+          full_url = @client.last_request.url
+          uri = URI.parse(full_url)
+          @url = uri.path
+          @params = @client.last_request.params
+        end
+        @page_size = @payload['meta'] && @payload['meta']['pageSize']
+        @next_token = @payload['meta'] && @payload['meta']['nextToken']
+        @previous_token = @payload['meta'] && @payload['meta']['previousToken']
+      end
+
+      def previous_token
+        @payload['meta'] && @payload['meta']['previousToken']
+      end
+
+      def previous_page
+        cached_url = previous_page_url
+        return nil unless cached_url
+
+        response = @version.domain.request('GET', cached_url, @params)
+
+        self.class.new(@version, response, @solution)
+      end
+
+      def next_token
+        @payload['meta'] && @payload['meta']['nextToken']
+      end
+
+      def previous_page_url
+        return nil if previous_token.nil?
+
+        @params['pageToken'] = previous_token
+        @version.domain.absolute_url(@url)
+      end
+
+      def next_page_url
+        token = next_token
+        return nil if token.nil? || token.to_s.empty?
+
+        @params['pageToken'] = token
+        @version.domain.absolute_url(@url)
+      end
+
+      def next_page
+        cached_url = next_page_url
+        return nil unless cached_url
+
+        response = @version.domain.request('GET', cached_url, @params)
+
+        self.class.new(@version, response, @solution)
+      end
+
+      def load_page(payload)
+        @key ||= payload['meta'] && payload['meta']['key']
+        return @payload[@key] if @key && @payload[@key]
+
+        raise Twilio::REST::TwilioError, 'Page Records can not be deserialized'
+      end
+    end
+  end
+end

data/lib/twilio-ruby/framework/rest/version.rb

@@ -3,7 +3,7 @@
 module Twilio
   module REST
     class Version
-      attr_accessor :domain
+      attr_accessor :domain, :version
 
       class RecordStream
         include Enumerable
@@ -48,7 +48,7 @@ module Twilio
 
       def request(method, uri, params = {}, data = {}, headers = {}, auth = nil, timeout = nil)
         url = relative_uri(uri)
-        params = params.delete_if { |_k, v| v.nil? }
+        params.delete_if { |_k, v| v.nil? }
         data = data
         @domain.request(method, url, params, data, headers, auth, timeout)
       end
@@ -94,7 +94,7 @@ module Twilio
         response.body
       end
 
-      def delete(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
+      def patch(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
         response = request(
           method,
           uri,
@@ -106,10 +106,28 @@ module Twilio
         )
 
         if response.status_code < 200 || response.status_code >= 300
+          raise exception(response, 'Unable to patch record')
+        end
+
+        response.body
+      end
+
+      def delete(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
+        response = request(
+          method,
+          uri,
+          params,
+          data,
+          headers,
+          auth,
+          timeout
+        )
+
+        if response.status_code < 200 || response.status_code >= 400
           raise exception(response, 'Unable to delete record')
         end
 
-        response.status_code == 204
+        response.status_code >= 200 && response.status_code < 400
       end
 
       def read_limits(limit = nil, page_size = nil)
@@ -139,6 +157,10 @@ module Twilio
         RecordStream.new(page, limit: limit, page_limit: page_limit)
       end
 
+      def stream_with_metadata(page, limit: nil, page_limit: nil)
+        RecordStream.new(page, limit: limit, page_limit: page_limit)
+      end
+
       def create(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
         response = request(method, uri, params, data, headers, auth, timeout)
 
@@ -148,6 +170,71 @@ module Twilio
 
         response.body
       end
+
+      def create_with_metadata(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
+        response = request(method, uri, params, data, headers, auth, timeout)
+
+        if response.status_code < 200 || response.status_code >= 300
+          raise exception(response, 'Unable to create record')
+        end
+
+        response
+      end
+
+      def fetch_with_metadata(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
+        response = request(
+          method,
+          uri,
+          params,
+          data,
+          headers,
+          auth,
+          timeout
+        )
+
+        # Note that 3XX response codes are allowed for fetches.
+        if response.status_code < 200 || response.status_code >= 400
+          raise exception(response, 'Unable to fetch record')
+        end
+
+        response
+      end
+
+      def update_with_metadata(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
+        response = request(
+          method,
+          uri,
+          params,
+          data,
+          headers,
+          auth,
+          timeout
+        )
+
+        if response.status_code < 200 || response.status_code >= 300
+          raise exception(response, 'Unable to update record')
+        end
+
+        response
+      end
+
+      def delete_with_metadata(method, uri, params: {}, data: {}, headers: {}, auth: nil, timeout: nil)
+        response = request(
+          method,
+          uri,
+          params,
+          data,
+          headers,
+          auth,
+          timeout
+        )
+
+        if response.status_code < 200 || response.status_code >= 400
+          raise exception(response, 'Unable to delete record')
+        end
+
+        response
+      end
     end
   end
 end

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

@@ -19,8 +19,11 @@ module Twilio
 
       def fetch_access_token
         client = Twilio::REST::Client.new
-        token_instance = client.preview_iam.v1.token.create(grant_type: @grant_type,
-                                                            client_id: @client_id, client_secret: @client_secret)
+        token_instance = client.oauth.v2.token.create(
+          grant_type: @grant_type,
+          client_id: @client_id,
+          client_secret: @client_secret
+        )
         token_instance.access_token
       end
     end

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

@@ -19,8 +19,11 @@ module Twilio
 
       def fetch_access_token
         client = Twilio::REST::Client.new
-        token_instance = client.preview_iam.v1.token.create(grant_type: @grant_type,
-                                                            client_id: @client_id, client_secret: @client_secret)
+        token_instance = client.oauth.v2.token.create(
+          grant_type: @grant_type,
+          client_id: @client_id,
+          client_secret: @client_secret
+        )
         token_instance.access_token
       end
     end

data/lib/twilio-ruby/rest/accounts/v1/auth_token_promotion.rb

@@ -25,6 +25,7 @@ module Twilio
                     # @return [AuthTokenPromotionList] AuthTokenPromotionList
                     def initialize(version)
                         super(version)
+                        
                         # Path Solution
                         @solution = {  }
                         
@@ -47,6 +48,7 @@ module Twilio
                     # @return [AuthTokenPromotionContext] AuthTokenPromotionContext
                     def initialize(version)
                         super(version)
+                        
 
                         # Path Solution
                         @solution = {  }
@@ -72,6 +74,30 @@ module Twilio
                         )
                     end
 
+                    ##
+                    # Update the AuthTokenPromotionInstanceMetadata
+                    # @return [AuthTokenPromotionInstance] Updated AuthTokenPromotionInstance
+                    def update_with_metadata
+
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
+                        
+                        
+                        
+                        
+                        
+                        response = @version.update_with_metadata('POST', @uri, headers: headers)
+                        auth_token_promotion_instance = AuthTokenPromotionInstance.new(
+                            @version,
+                            response.body,
+                        )
+                        AuthTokenPromotionInstanceMetadata.new(
+                            @version,
+                            auth_token_promotion_instance,
+                            response.headers,
+                            response.status_code
+                        )
+                    end
+
 
                     ##
                     # Provide a user friendly representation
@@ -88,6 +114,53 @@ module Twilio
                     end
                 end
 
+                class AuthTokenPromotionInstanceMetadata <  InstanceResourceMetadata
+                    ##
+                    # Initializes a new AuthTokenPromotionInstanceMetadata.
+                    # @param [Version] version Version that contains the resource
+                    # @param [}AuthTokenPromotionInstance] auth_token_promotion_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 [AuthTokenPromotionInstanceMetadata] The initialized instance with metadata.
+                    def initialize(version, auth_token_promotion_instance, headers, status_code)
+                        super(version, headers, status_code)
+                        @auth_token_promotion_instance = auth_token_promotion_instance
+                    end
+
+                    def auth_token_promotion
+                        @auth_token_promotion_instance
+                    end
+
+                    def headers
+                        @headers
+                    end
+
+                    def status_code
+                        @status_code
+                    end
+
+                    def to_s
+                      "<Twilio.Api.V2010.AuthTokenPromotionInstanceMetadata status=#{@status_code}>"
+                    end
+                end
+
+                class AuthTokenPromotionListResponse < InstanceListResource
+                    # @param [Array<AuthTokenPromotionInstance>] instance
+                    # @param [Hash{String => Object}] headers
+                    # @param [Integer] status_code
+                    def initialize(version, payload, key)
+                       @auth_token_promotion_instance = payload.body[key].map do |data|
+                        AuthTokenPromotionInstance.new(version, data)
+                       end
+                       @headers = payload.headers
+                       @status_code = payload.status_code
+                    end
+
+                      def auth_token_promotion_instance
+                          @instance
+                      end
+                  end
+
                 class AuthTokenPromotionPage < Page
                     ##
                     # Initialize the AuthTokenPromotionPage
@@ -97,6 +170,7 @@ module Twilio
                     # @return [AuthTokenPromotionPage] AuthTokenPromotionPage
                     def initialize(version, response, solution)
                         super(version, response)
+                        
 
                         # Path Solution
                         @solution = solution
@@ -116,6 +190,66 @@ module Twilio
                         '<Twilio.Accounts.V1.AuthTokenPromotionPage>'
                     end
                 end
+
+                class AuthTokenPromotionPageMetadata < PageMetadata
+                    attr_reader :auth_token_promotion_page
+
+                    def initialize(version, response, solution, limit)
+                        super(version, response)
+                        @auth_token_promotion_page = []
+                        @limit = limit
+                        key = get_key(response.body)
+                        records = 0
+                        while( limit != :unset && records < limit )
+                            @auth_token_promotion_page << AuthTokenPromotionListResponse.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
+                        @auth_token_promotion_page.each do |record|
+                          yield record
+                        end
+                    end
+
+                    def to_s
+                      '<Twilio::REST::Accounts::V1PageMetadata>';
+                    end
+                end
+                class AuthTokenPromotionListResponse < InstanceListResource
+
+                    # @param [Array<AuthTokenPromotionInstance>] 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
+                      @auth_token_promotion = data_list.map do |data|
+                        AuthTokenPromotionInstance.new(version, data)
+                      end
+                      @headers = payload.headers
+                      @status_code = payload.status_code
+                    end
+
+                    def auth_token_promotion
+                        @auth_token_promotion
+                    end
+
+                    def headers
+                      @headers
+                    end
+
+                    def status_code
+                      @status_code
+                    end
+                end
+
                 class AuthTokenPromotionInstance < InstanceResource
                     ##
                     # Initialize the AuthTokenPromotionInstance
@@ -129,6 +263,7 @@ module Twilio
                     def initialize(version, payload )
                         super(version)
                         
+                        
                         # Marshaled Properties
                         @properties = { 
                             'account_sid' => payload['account_sid'],

data/lib/twilio-ruby/rest/accounts/v1/bulk_consents.rb

@@ -25,6 +25,7 @@ module Twilio
                     # @return [BulkConsentsList] BulkConsentsList
                     def initialize(version)
                         super(version)
+                        
                         # Path Solution
                         @solution = {  }
                         @uri = "/Consents/Bulk"
@@ -32,7 +33,7 @@ module Twilio
                     end
                     ##
                     # Create the BulkConsentsInstance
-                    # @param [Array[Hash]] items This is a list of objects that describes a contact's opt-in status. Each object contains the following fields: `contact_id`, which must be a string representing phone number in [E.164 format](https://www.twilio.com/docs/glossary/what-e164); `correlation_id`, a unique 32-character UUID used to uniquely map the request item with the response item; `sender_id`, which can be either a valid messaging service SID or a from phone number; `status`, a string representing the consent status. Can be one of [`opt-in`, `opt-out`]; and `source`, a string indicating the medium through which the consent was collected. Can be one of [`website`, `offline`, `opt-in-message`, `opt-out-message`, `others`].
+                    # @param [Array[Hash]] items This is a list of objects that describes a contact's opt-in status. Each object contains the following fields: `contact_id`, which must be a string representing phone number in [E.164 format](https://www.twilio.com/docs/glossary/what-e164); `correlation_id`, a unique 32-character UUID used to uniquely map the request item with the response item; `sender_id`, which can be either a valid messaging service SID or a from phone number; `status`, a string representing the consent status. Can be one of [`opt-in`, `opt-out`]; `source`, a string indicating the medium through which the consent was collected. Can be one of [`website`, `offline`, `opt-in-message`, `opt-out-message`, `others`]; `date_of_consent`, an optional datetime string field in ISO-8601 format that captures the exact date and time when the user gave or revoked consent. If not provided, it will be empty.
                     # @return [BulkConsentsInstance] Created BulkConsentsInstance
                     def create(
                         items: nil
@@ -55,6 +56,37 @@ module Twilio
                         )
                     end
 
+                    ##
+                    # Create the BulkConsentsInstanceMetadata
+                    # @param [Array[Hash]] items This is a list of objects that describes a contact's opt-in status. Each object contains the following fields: `contact_id`, which must be a string representing phone number in [E.164 format](https://www.twilio.com/docs/glossary/what-e164); `correlation_id`, a unique 32-character UUID used to uniquely map the request item with the response item; `sender_id`, which can be either a valid messaging service SID or a from phone number; `status`, a string representing the consent status. Can be one of [`opt-in`, `opt-out`]; `source`, a string indicating the medium through which the consent was collected. Can be one of [`website`, `offline`, `opt-in-message`, `opt-out-message`, `others`]; `date_of_consent`, an optional datetime string field in ISO-8601 format that captures the exact date and time when the user gave or revoked consent. If not provided, it will be empty.
+                    # @return [BulkConsentsInstance] Created BulkConsentsInstance
+                    def create_with_metadata(
+                      items: nil
+                    )
+
+                        data = Twilio::Values.of({
+                            'Items' => Twilio.serialize_list(items) { |e| Twilio.serialize_object(e) },
+                        })
+
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
+                        
+                        
+                        
+                        
+                        
+                        response = @version.create_with_metadata('POST', @uri, data: data, headers: headers)
+                        bulk_consents_instance = BulkConsentsInstance.new(
+                            @version,
+                            response.body,
+                        )
+                        BulkConsentsInstanceMetadata.new(
+                            @version,
+                            bulk_consents_instance,
+                            response.headers,
+                            response.status_code
+                        )
+                    end
+
                 
 
 
@@ -73,6 +105,7 @@ module Twilio
                     # @return [BulkConsentsPage] BulkConsentsPage
                     def initialize(version, response, solution)
                         super(version, response)
+                        
 
                         # Path Solution
                         @solution = solution
@@ -92,6 +125,66 @@ module Twilio
                         '<Twilio.Accounts.V1.BulkConsentsPage>'
                     end
                 end
+
+                class BulkConsentsPageMetadata < PageMetadata
+                    attr_reader :bulk_consents_page
+
+                    def initialize(version, response, solution, limit)
+                        super(version, response)
+                        @bulk_consents_page = []
+                        @limit = limit
+                        key = get_key(response.body)
+                        records = 0
+                        while( limit != :unset && records < limit )
+                            @bulk_consents_page << BulkConsentsListResponse.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
+                        @bulk_consents_page.each do |record|
+                          yield record
+                        end
+                    end
+
+                    def to_s
+                      '<Twilio::REST::Accounts::V1PageMetadata>';
+                    end
+                end
+                class BulkConsentsListResponse < InstanceListResource
+
+                    # @param [Array<BulkConsentsInstance>] 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
+                      @bulk_consents = data_list.map do |data|
+                        BulkConsentsInstance.new(version, data)
+                      end
+                      @headers = payload.headers
+                      @status_code = payload.status_code
+                    end
+
+                    def bulk_consents
+                        @bulk_consents
+                    end
+
+                    def headers
+                      @headers
+                    end
+
+                    def status_code
+                      @status_code
+                    end
+                end
+
                 class BulkConsentsInstance < InstanceResource
                     ##
                     # Initialize the BulkConsentsInstance
@@ -105,6 +198,7 @@ module Twilio
                     def initialize(version, payload )
                         super(version)
                         
+                        
                         # Marshaled Properties
                         @properties = { 
                             'items' => payload['items'],