twilio-ruby 6.8.0 → 7.10.7

data/lib/twilio-ruby/rest/assistants/v1.rb

@@ -0,0 +1,104 @@
+##
+#    This code was generated by
+#    ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
+#     |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
+#     |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
+#
+#    Twilio - Assistants
+#    This is the public Twilio REST API.
+#
+#    NOTE: This class is auto generated by OpenAPI Generator.
+#    https://openapi-generator.tech
+#    Do not edit the class manually.
+#
+
+module Twilio
+    module REST
+        class Assistants
+            class V1 < Version
+                ##
+                # Initialize the V1 version of Assistants
+                def initialize(domain)
+                    super
+                    @version = 'v1'
+                    @assistants = nil
+                    @knowledge = nil
+                    @policies = nil
+                    @sessions = nil
+                    @tools = nil
+                end
+
+                ##
+                # @param [String] id 
+                # @return [Twilio::REST::Assistants::V1::AssistantContext] if id was passed.
+                # @return [Twilio::REST::Assistants::V1::AssistantList]
+                def assistants(id=:unset)
+                    if id.nil?
+                        raise ArgumentError, 'id cannot be nil'
+                    end
+
+                    if id == :unset
+                        @assistants ||= AssistantList.new self
+                    else
+                        AssistantContext.new(self, id)
+                    end
+                end
+                ##
+                # @param [String] id 
+                # @return [Twilio::REST::Assistants::V1::KnowledgeContext] if id was passed.
+                # @return [Twilio::REST::Assistants::V1::KnowledgeList]
+                def knowledge(id=:unset)
+                    if id.nil?
+                        raise ArgumentError, 'id cannot be nil'
+                    end
+
+                    if id == :unset
+                        @knowledge ||= KnowledgeList.new self
+                    else
+                        KnowledgeContext.new(self, id)
+                    end
+                end
+                ##
+                # @return [Twilio::REST::Assistants::V1::PolicyList]
+                def policies
+                    @policies ||= PolicyList.new self
+                end
+                ##
+                # @param [String] id 
+                # @return [Twilio::REST::Assistants::V1::SessionContext] if id was passed.
+                # @return [Twilio::REST::Assistants::V1::SessionList]
+                def sessions(id=:unset)
+                    if id.nil?
+                        raise ArgumentError, 'id cannot be nil'
+                    end
+
+                    if id == :unset
+                        @sessions ||= SessionList.new self
+                    else
+                        SessionContext.new(self, id)
+                    end
+                end
+                ##
+                # @param [String] id 
+                # @return [Twilio::REST::Assistants::V1::ToolContext] if id was passed.
+                # @return [Twilio::REST::Assistants::V1::ToolList]
+                def tools(id=:unset)
+                    if id.nil?
+                        raise ArgumentError, 'id cannot be nil'
+                    end
+
+                    if id == :unset
+                        @tools ||= ToolList.new self
+                    else
+                        ToolContext.new(self, id)
+                    end
+                end
+                ##
+                # Provide a user friendly representation
+                def to_s
+                    '<Twilio::REST::Assistants::V1>';
+                end
+            end
+        end
+    end
+end

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

@@ -0,0 +1,6 @@
+module Twilio
+    module REST
+      class Assistants < AssistantsBase;
+      end
+    end
+end

data/lib/twilio-ruby/rest/{autopilot_base.rb → assistants_base.rb}

@@ -10,28 +10,28 @@
 # frozen_string_literal: true
 module Twilio
   module REST
-    class AutopilotBase < Domain
+    class AssistantsBase < Domain
       ##
-      # Initialize autopilot domain
+      # Initialize assistants domain
       #
       # @param twilio - The twilio client
       #
       def initialize(twilio)
         super(twilio)
-        @base_url =  "https://autopilot.twilio.com"
-        @host = "autopilot.twilio.com"
+        @base_url =  "https://assistants.twilio.com"
+        @host = "assistants.twilio.com"
         @port = 443
         @v1 = nil
       end
 
       def v1
-        @v1 ||= Autopilot::V1.new self
+        @v1 ||= Assistants::V1.new self
       end
 
       ##
       # Provide a user friendly representation
       def to_s
-        '<Twilio::REST::Autopilot::V1>';
+        '<Twilio::REST::Assistants::V1>';
       end
     end
   end

data/lib/twilio-ruby/rest/bulkexports/v1/export/day.rb

@@ -20,12 +20,14 @@ module Twilio
                 class ExportContext < InstanceContext
 
                      class DayList < ListResource
+                
                     ##
                     # Initialize the DayList
                     # @param [Version] version Version that contains the resource
                     # @return [DayList] DayList
                     def initialize(version, resource_type: nil)
                         super(version)
+                        
                         # Path Solution
                         @solution = { resource_type: resource_type }
                         @uri = "/Exports/#{@solution[:resource_type]}/Days"
@@ -67,7 +69,33 @@ module Twilio
                         page = self.page(
                             page_size: limits[:page_size], )
 
-                        @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
+                        return [].each if page.nil?
+
+                        result = @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
+                        return [].each if result.nil?
+                        result
+                    end
+
+                    ##
+                    # Lists DayPageMetadata records from the API as a list.
+                    # @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(limit: nil, page_size: nil)
+                        limits = @version.read_limits(limit, page_size)
+                        params = Twilio::Values.of({
+                            
+                            'PageSize' => limits[:page_size],
+                        });
+                        headers = Twilio::Values.of({})
+
+                        response = @version.page('GET', @uri, params: params, headers: headers)
+
+                        DayPageMetadata.new(@version, response, @solution, limits[:limit])
                     end
 
                     ##
@@ -79,9 +107,13 @@ module Twilio
 
                         page = self.page(page_size: limits[:page_size], )
 
-                        @version.stream(page,
+                        return [].each if page.nil?
+
+                        result = @version.stream(page,
                             limit: limits[:limit],
-                            page_limit: limits[:page_limit]).each {|x| yield x}
+                            page_limit: limits[:page_limit])
+                        return [].each if result.nil?
+                        result.each {|x| yield x}
                     end
 
                     ##
@@ -91,14 +123,17 @@ 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 DayInstance
-                    def page(page_token: :unset, page_number: :unset, page_size: :unset)
+                    def page(page_token: :unset, page_number: :unset,page_size: :unset)
                         params = Twilio::Values.of({
                             'PageToken' => page_token,
                             'Page' => page_number,
                             'PageSize' => page_size,
                         })
+                        headers = Twilio::Values.of({})
+                        
+                        
 
-                        response = @version.page('GET', @uri, params: params)
+                        response = @version.page('GET', @uri, params: params, headers: headers)
 
                         DayPage.new(@version, response, @solution)
                     end
@@ -134,6 +169,7 @@ module Twilio
                     # @return [DayContext] DayContext
                     def initialize(version, resource_type, day)
                         super(version)
+                        
 
                         # Path Solution
                         @solution = { resource_type: resource_type, day: day,  }
@@ -146,7 +182,13 @@ module Twilio
                     # @return [DayInstance] Fetched DayInstance
                     def fetch
 
-                        payload = @version.fetch('GET', @uri)
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
+                        
+                        
+                        
+                        
+                        
+                        payload = @version.fetch('GET', @uri, headers: headers)
                         DayInstance.new(
                             @version,
                             payload,
@@ -155,6 +197,32 @@ module Twilio
                         )
                     end
 
+                    ##
+                    # Fetch the DayInstanceMetadata
+                    # @return [DayInstance] Fetched DayInstance
+                    def fetch_with_metadata
+
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
+                        
+                        
+                        
+                        
+                        
+                        response = @version.fetch_with_metadata('GET', @uri, headers: headers)
+                        day_instance = DayInstance.new(
+                            @version,
+                            response.body,
+                            resource_type: @solution[:resource_type],
+                            day: @solution[:day],
+                        )
+                        DayInstanceMetadata.new(
+                            @version,
+                            day_instance,
+                            response.headers,
+                            response.status_code
+                        )
+                    end
+
 
                     ##
                     # Provide a user friendly representation
@@ -171,6 +239,53 @@ module Twilio
                     end
                 end
 
+                class DayInstanceMetadata <  InstanceResourceMetadata
+                    ##
+                    # Initializes a new DayInstanceMetadata.
+                    # @param [Version] version Version that contains the resource
+                    # @param [}DayInstance] day_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 [DayInstanceMetadata] The initialized instance with metadata.
+                    def initialize(version, day_instance, headers, status_code)
+                        super(version, headers, status_code)
+                        @day_instance = day_instance
+                    end
+
+                    def day
+                        @day_instance
+                    end
+
+                    def headers
+                        @headers
+                    end
+
+                    def status_code
+                        @status_code
+                    end
+
+                    def to_s
+                      "<Twilio.Api.V2010.DayInstanceMetadata status=#{@status_code}>"
+                    end
+                end
+
+                class DayListResponse < InstanceListResource
+                    # @param [Array<DayInstance>] instance
+                    # @param [Hash{String => Object}] headers
+                    # @param [Integer] status_code
+                    def initialize(version, payload, key)
+                       @day_instance = payload.body[key].map do |data|
+                        DayInstance.new(version, data)
+                       end
+                       @headers = payload.headers
+                       @status_code = payload.status_code
+                    end
+
+                      def day_instance
+                          @instance
+                      end
+                  end
+
                 class DayPage < Page
                     ##
                     # Initialize the DayPage
@@ -180,6 +295,7 @@ module Twilio
                     # @return [DayPage] DayPage
                     def initialize(version, response, solution)
                         super(version, response)
+                        
 
                         # Path Solution
                         @solution = solution
@@ -199,6 +315,66 @@ module Twilio
                         '<Twilio.Bulkexports.V1.DayPage>'
                     end
                 end
+
+                class DayPageMetadata < PageMetadata
+                    attr_reader :day_page
+
+                    def initialize(version, response, solution, limit)
+                        super(version, response)
+                        @day_page = []
+                        @limit = limit
+                        key = get_key(response.body)
+                        records = 0
+                        while( limit != :unset && records < limit )
+                            @day_page << DayListResponse.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
+                        @day_page.each do |record|
+                          yield record
+                        end
+                    end
+
+                    def to_s
+                      '<Twilio::REST::Bulkexports::V1PageMetadata>';
+                    end
+                end
+                class DayListResponse < InstanceListResource
+
+                    # @param [Array<DayInstance>] 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
+                      @day = data_list.map do |data|
+                        DayInstance.new(version, data)
+                      end
+                      @headers = payload.headers
+                      @status_code = payload.status_code
+                    end
+
+                    def day
+                        @day
+                    end
+
+                    def headers
+                      @headers
+                    end
+
+                    def status_code
+                      @status_code
+                    end
+                end
+
                 class DayInstance < InstanceResource
                     ##
                     # Initialize the DayInstance
@@ -212,6 +388,7 @@ module Twilio
                     def initialize(version, payload , resource_type: nil, day: nil)
                         super(version)
                         
+                        
                         # Marshaled Properties
                         @properties = { 
                             'redirect_to' => payload['redirect_to'],

data/lib/twilio-ruby/rest/bulkexports/v1/export/export_custom_job.rb

@@ -20,12 +20,14 @@ module Twilio
                 class ExportContext < InstanceContext
 
                      class ExportCustomJobList < ListResource
+                
                     ##
                     # Initialize the ExportCustomJobList
                     # @param [Version] version Version that contains the resource
                     # @return [ExportCustomJobList] ExportCustomJobList
                     def initialize(version, resource_type: nil)
                         super(version)
+                        
                         # Path Solution
                         @solution = { resource_type: resource_type }
                         @uri = "/Exports/#{@solution[:resource_type]}/Jobs"
@@ -41,12 +43,12 @@ module Twilio
                     # @param [String] email The optional email to send the completion notification to. You can set both webhook, and email, or one or the other. If you set neither, the job will run but you will have to query to determine your job's status.
                     # @return [ExportCustomJobInstance] Created ExportCustomJobInstance
                     def create(
-                        start_day: nil, 
-                        end_day: nil, 
-                        friendly_name: nil, 
-                        webhook_url: :unset, 
-                        webhook_method: :unset, 
-                        email: :unset
+                      start_day: nil, 
+                      end_day: nil, 
+                      friendly_name: nil, 
+                      webhook_url: :unset, 
+                      webhook_method: :unset, 
+                      email: :unset
                     )
 
                         data = Twilio::Values.of({
@@ -58,7 +60,13 @@ module Twilio
                             'Email' => email,
                         })
 
-                        payload = @version.create('POST', @uri, data: data)
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
+                        
+                        
+                        
+                        
+                        
+                        payload = @version.create('POST', @uri, data: data, headers: headers)
                         ExportCustomJobInstance.new(
                             @version,
                             payload,
@@ -66,6 +74,53 @@ module Twilio
                         )
                     end
 
+                    ##
+                    # Create the ExportCustomJobInstanceMetadata
+                    # @param [String] start_day The start day for the custom export specified as a string in the format of yyyy-mm-dd
+                    # @param [String] end_day The end day for the custom export specified as a string in the format of yyyy-mm-dd. End day is inclusive and must be 2 days earlier than the current UTC day.
+                    # @param [String] friendly_name The friendly name specified when creating the job
+                    # @param [String] webhook_url The optional webhook url called on completion of the job. If this is supplied, `WebhookMethod` must also be supplied. If you set neither webhook nor email, you will have to check your job's status manually.
+                    # @param [String] webhook_method This is the method used to call the webhook on completion of the job. If this is supplied, `WebhookUrl` must also be supplied.
+                    # @param [String] email The optional email to send the completion notification to. You can set both webhook, and email, or one or the other. If you set neither, the job will run but you will have to query to determine your job's status.
+                    # @return [ExportCustomJobInstance] Created ExportCustomJobInstance
+                    def create_with_metadata(
+                      start_day: nil, 
+                      end_day: nil, 
+                      friendly_name: nil, 
+                      webhook_url: :unset, 
+                      webhook_method: :unset, 
+                      email: :unset
+                    )
+
+                        data = Twilio::Values.of({
+                            'StartDay' => start_day,
+                            'EndDay' => end_day,
+                            'FriendlyName' => friendly_name,
+                            'WebhookUrl' => webhook_url,
+                            'WebhookMethod' => webhook_method,
+                            'Email' => email,
+                        })
+
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
+                        
+                        
+                        
+                        
+                        
+                        response = @version.create_with_metadata('POST', @uri, data: data, headers: headers)
+                        export_custom_job_instance = ExportCustomJobInstance.new(
+                            @version,
+                            response.body,
+                            resource_type: @solution[:resource_type],
+                        )
+                        ExportCustomJobInstanceMetadata.new(
+                            @version,
+                            export_custom_job_instance,
+                            response.headers,
+                            response.status_code
+                        )
+                    end
+
                 
                     ##
                     # Lists ExportCustomJobInstance records from the API as a list.
@@ -102,7 +157,33 @@ module Twilio
                         page = self.page(
                             page_size: limits[:page_size], )
 
-                        @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
+                        return [].each if page.nil?
+
+                        result = @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
+                        return [].each if result.nil?
+                        result
+                    end
+
+                    ##
+                    # Lists ExportCustomJobPageMetadata records from the API as a list.
+                    # @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(limit: nil, page_size: nil)
+                        limits = @version.read_limits(limit, page_size)
+                        params = Twilio::Values.of({
+                            
+                            'PageSize' => limits[:page_size],
+                        });
+                        headers = Twilio::Values.of({})
+
+                        response = @version.page('GET', @uri, params: params, headers: headers)
+
+                        ExportCustomJobPageMetadata.new(@version, response, @solution, limits[:limit])
                     end
 
                     ##
@@ -114,9 +195,13 @@ module Twilio
 
                         page = self.page(page_size: limits[:page_size], )
 
-                        @version.stream(page,
+                        return [].each if page.nil?
+
+                        result = @version.stream(page,
                             limit: limits[:limit],
-                            page_limit: limits[:page_limit]).each {|x| yield x}
+                            page_limit: limits[:page_limit])
+                        return [].each if result.nil?
+                        result.each {|x| yield x}
                     end
 
                     ##
@@ -126,14 +211,17 @@ 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 ExportCustomJobInstance
-                    def page(page_token: :unset, page_number: :unset, page_size: :unset)
+                    def page(page_token: :unset, page_number: :unset,page_size: :unset)
                         params = Twilio::Values.of({
                             'PageToken' => page_token,
                             'Page' => page_number,
                             'PageSize' => page_size,
                         })
+                        headers = Twilio::Values.of({})
+                        
+                        
 
-                        response = @version.page('GET', @uri, params: params)
+                        response = @version.page('GET', @uri, params: params, headers: headers)
 
                         ExportCustomJobPage.new(@version, response, @solution)
                     end
@@ -168,6 +256,7 @@ module Twilio
                     # @return [ExportCustomJobPage] ExportCustomJobPage
                     def initialize(version, response, solution)
                         super(version, response)
+                        
 
                         # Path Solution
                         @solution = solution
@@ -187,6 +276,66 @@ module Twilio
                         '<Twilio.Bulkexports.V1.ExportCustomJobPage>'
                     end
                 end
+
+                class ExportCustomJobPageMetadata < PageMetadata
+                    attr_reader :export_custom_job_page
+
+                    def initialize(version, response, solution, limit)
+                        super(version, response)
+                        @export_custom_job_page = []
+                        @limit = limit
+                        key = get_key(response.body)
+                        records = 0
+                        while( limit != :unset && records < limit )
+                            @export_custom_job_page << ExportCustomJobListResponse.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
+                        @export_custom_job_page.each do |record|
+                          yield record
+                        end
+                    end
+
+                    def to_s
+                      '<Twilio::REST::Bulkexports::V1PageMetadata>';
+                    end
+                end
+                class ExportCustomJobListResponse < InstanceListResource
+
+                    # @param [Array<ExportCustomJobInstance>] 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
+                      @export_custom_job = data_list.map do |data|
+                        ExportCustomJobInstance.new(version, data)
+                      end
+                      @headers = payload.headers
+                      @status_code = payload.status_code
+                    end
+
+                    def export_custom_job
+                        @export_custom_job
+                    end
+
+                    def headers
+                      @headers
+                    end
+
+                    def status_code
+                      @status_code
+                    end
+                end
+
                 class ExportCustomJobInstance < InstanceResource
                     ##
                     # Initialize the ExportCustomJobInstance
@@ -200,6 +349,7 @@ module Twilio
                     def initialize(version, payload , resource_type: nil)
                         super(version)
                         
+                        
                         # Marshaled Properties
                         @properties = { 
                             'friendly_name' => payload['friendly_name'],
@@ -266,7 +416,7 @@ module Twilio
                     end
                     
                     ##
-                    # @return [Hash] The details of a job which is an object that contains an array of status grouped by `status` state.  Each `status` object has a `status` string, a count which is the number of days in that `status`, and list of days in that `status`. The day strings are in the format yyyy-MM-dd. As an example, a currently running job may have a status object for COMPLETED and a `status` object for SUBMITTED each with its own count and list of days.
+                    # @return [Array<Hash>] The details of a job which is an object that contains an array of status grouped by `status` state.  Each `status` object has a `status` string, a count which is the number of days in that `status`, and list of days in that `status`. The day strings are in the format yyyy-MM-dd. As an example, a currently running job may have a status object for COMPLETED and a `status` object for SUBMITTED each with its own count and list of days.
                     def details
                         @properties['details']
                     end