twilio-ruby 5.77.0 → 7.3.3

data/lib/twilio-ruby/rest/numbers/v1/signing_request_configuration.rb

@@ -0,0 +1,273 @@
+##
+#    This code was generated by
+#    ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
+#     |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
+#     |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
+#
+#    Twilio - Numbers
+#    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 Numbers < NumbersBase
+            class V1 < Version
+                class SigningRequestConfigurationList < ListResource
+                
+                    ##
+                    # Initialize the SigningRequestConfigurationList
+                    # @param [Version] version Version that contains the resource
+                    # @return [SigningRequestConfigurationList] SigningRequestConfigurationList
+                    def initialize(version)
+                        super(version)
+                        # Path Solution
+                        @solution = {  }
+                        @uri = "/SigningRequest/Configuration"
+                        
+                    end
+                    ##
+                    # Create the SigningRequestConfigurationInstance
+                    # @param [Object] body 
+                    # @return [SigningRequestConfigurationInstance] Created SigningRequestConfigurationInstance
+                    def create(body: :unset
+                    )
+
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
+                        headers['Content-Type'] = 'application/json'
+                        payload = @version.create('POST', @uri, headers: headers, data: body.to_json)
+                        SigningRequestConfigurationInstance.new(
+                            @version,
+                            payload,
+                        )
+                    end
+
+                
+                    ##
+                    # Lists SigningRequestConfigurationInstance records from the API as a list.
+                    # Unlike stream(), this operation is eager and will load `limit` records into
+                    # memory before returning.
+                    # @param [String] country The country ISO code to apply this configuration, this is an optional field, Example: US, MX
+                    # @param [String] product The product or service for which is requesting the signature, this is an optional field, Example: Porting, Hosting
+                    # @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(country: :unset, product: :unset, limit: nil, page_size: nil)
+                        self.stream(
+                            country: country,
+                            product: product,
+                            limit: limit,
+                            page_size: page_size
+                        ).entries
+                    end
+
+                    ##
+                    # Streams Instance records from the API as an Enumerable.
+                    # This operation lazily loads records as efficiently as possible until the limit
+                    # is reached.
+                    # @param [String] country The country ISO code to apply this configuration, this is an optional field, Example: US, MX
+                    # @param [String] product The product or service for which is requesting the signature, this is an optional field, Example: Porting, Hosting
+                    # @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 [Enumerable] Enumerable that will yield up to limit results
+                    def stream(country: :unset, product: :unset, limit: nil, page_size: nil)
+                        limits = @version.read_limits(limit, page_size)
+
+                        page = self.page(
+                            country: country,
+                            product: product,
+                            page_size: limits[:page_size], )
+
+                        @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
+                    end
+
+                    ##
+                    # When passed a block, yields SigningRequestConfigurationInstance records from the API.
+                    # This operation lazily loads records as efficiently as possible until the limit
+                    # is reached.
+                    def each
+                        limits = @version.read_limits
+
+                        page = self.page(page_size: limits[:page_size], )
+
+                        @version.stream(page,
+                            limit: limits[:limit],
+                            page_limit: limits[:page_limit]).each {|x| yield x}
+                    end
+
+                    ##
+                    # Retrieve a single page of SigningRequestConfigurationInstance records from the API.
+                    # Request is executed immediately.
+                    # @param [String] country The country ISO code to apply this configuration, this is an optional field, Example: US, MX
+                    # @param [String] product The product or service for which is requesting the signature, this is an optional field, Example: Porting, Hosting
+                    # @param [String] page_token PageToken provided by the API
+                    # @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 SigningRequestConfigurationInstance
+                    def page(country: :unset, product: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
+                        params = Twilio::Values.of({
+                            'Country' => country,
+                            'Product' => product,
+                            'PageToken' => page_token,
+                            'Page' => page_number,
+                            'PageSize' => page_size,
+                        })
+
+                        response = @version.page('GET', @uri, params: params)
+
+                        SigningRequestConfigurationPage.new(@version, response, @solution)
+                    end
+
+                    ##
+                    # Retrieve a single page of SigningRequestConfigurationInstance records from the API.
+                    # Request is executed immediately.
+                    # @param [String] target_url API-generated URL for the requested results page
+                    # @return [Page] Page of SigningRequestConfigurationInstance
+                    def get_page(target_url)
+                        response = @version.domain.request(
+                            'GET',
+                            target_url
+                        )
+                    SigningRequestConfigurationPage.new(@version, response, @solution)
+                    end
+                    
+
+
+                    # Provide a user friendly representation
+                    def to_s
+                        '#<Twilio.Numbers.V1.SigningRequestConfigurationList>'
+                    end
+                end
+
+                class SigningRequestConfigurationPage < Page
+                    ##
+                    # Initialize the SigningRequestConfigurationPage
+                    # @param [Version] version Version that contains the resource
+                    # @param [Response] response Response from the API
+                    # @param [Hash] solution Path solution for the resource
+                    # @return [SigningRequestConfigurationPage] SigningRequestConfigurationPage
+                    def initialize(version, response, solution)
+                        super(version, response)
+
+                        # Path Solution
+                        @solution = solution
+                    end
+
+                    ##
+                    # Build an instance of SigningRequestConfigurationInstance
+                    # @param [Hash] payload Payload response from the API
+                    # @return [SigningRequestConfigurationInstance] SigningRequestConfigurationInstance
+                    def get_instance(payload)
+                        SigningRequestConfigurationInstance.new(@version, payload)
+                    end
+
+                    ##
+                    # Provide a user friendly representation
+                    def to_s
+                        '<Twilio.Numbers.V1.SigningRequestConfigurationPage>'
+                    end
+                end
+                class SigningRequestConfigurationInstance < InstanceResource
+                    ##
+                    # Initialize the SigningRequestConfigurationInstance
+                    # @param [Version] version Version that contains the resource
+                    # @param [Hash] payload payload that contains response from Twilio
+                    # @param [String] account_sid The SID of the
+                    #   {Account}[https://www.twilio.com/docs/iam/api/account] that created this SigningRequestConfiguration
+                    #   resource.
+                    # @param [String] sid The SID of the Call resource to fetch.
+                    # @return [SigningRequestConfigurationInstance] SigningRequestConfigurationInstance
+                    def initialize(version, payload )
+                        super(version)
+                        
+                        # Marshaled Properties
+                        @properties = { 
+                            'logo_sid' => payload['logo_sid'],
+                            'friendly_name' => payload['friendly_name'],
+                            'product' => payload['product'],
+                            'country' => payload['country'],
+                            'email_subject' => payload['email_subject'],
+                            'email_message' => payload['email_message'],
+                            'url_redirection' => payload['url_redirection'],
+                            'url' => payload['url'],
+                        }
+                    end
+
+                    
+                    ##
+                    # @return [String] The SID of the document  that includes the logo that will appear in the LOA. To upload documents follow the following guide: https://www.twilio.com/docs/phone-numbers/regulatory/getting-started/create-new-bundle-public-rest-apis#supporting-document-create 
+                    def logo_sid
+                        @properties['logo_sid']
+                    end
+                    
+                    ##
+                    # @return [String] This is the string that you assigned as a friendly name for describing the creation of the configuration.
+                    def friendly_name
+                        @properties['friendly_name']
+                    end
+                    
+                    ##
+                    # @return [String] The product or service for which is requesting the signature.
+                    def product
+                        @properties['product']
+                    end
+                    
+                    ##
+                    # @return [String] The country ISO code to apply the configuration.
+                    def country
+                        @properties['country']
+                    end
+                    
+                    ##
+                    # @return [String] Subject of the email that the end client will receive ex: “Twilio Hosting Request”, maximum length of 255 characters.
+                    def email_subject
+                        @properties['email_subject']
+                    end
+                    
+                    ##
+                    # @return [String] Content of the email that the end client will receive ex: “This is a Hosting request from Twilio, please check the document and sign it”, maximum length of 5,000 characters.
+                    def email_message
+                        @properties['email_message']
+                    end
+                    
+                    ##
+                    # @return [String] Url the end client will be redirected after signing a document.
+                    def url_redirection
+                        @properties['url_redirection']
+                    end
+                    
+                    ##
+                    # @return [String] 
+                    def url
+                        @properties['url']
+                    end
+                    
+                    ##
+                    # Provide a user friendly representation
+                    def to_s
+                        "<Twilio.Numbers.V1.SigningRequestConfigurationInstance>"
+                    end
+
+                    ##
+                    # Provide a detailed, user friendly representation
+                    def inspect
+                        "<Twilio.Numbers.V1.SigningRequestConfigurationInstance>"
+                    end
+                end
+
+            end
+        end
+    end
+end

data/lib/twilio-ruby/rest/numbers/v1/webhook.rb

@@ -0,0 +1,161 @@
+##
+#    This code was generated by
+#    ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
+#     |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
+#     |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
+#
+#    Twilio - Numbers
+#    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 Numbers < NumbersBase
+            class V1 < Version
+                class WebhookList < ListResource
+                
+                    ##
+                    # Initialize the WebhookList
+                    # @param [Version] version Version that contains the resource
+                    # @return [WebhookList] WebhookList
+                    def initialize(version)
+                        super(version)
+                        # Path Solution
+                        @solution = {  }
+                        @uri = "/Porting/Configuration/Webhook"
+                        
+                    end
+                    ##
+                    # Fetch the WebhookInstance
+                    # @return [WebhookInstance] Fetched WebhookInstance
+                    def fetch
+
+                        headers = Twilio::Values.of({'Content-Type' => 'application/x-www-form-urlencoded', })
+                        
+                        payload = @version.fetch('GET', @uri, headers: headers)
+                        WebhookInstance.new(
+                            @version,
+                            payload,
+                        )
+                    end
+
+                
+
+
+                    # Provide a user friendly representation
+                    def to_s
+                        '#<Twilio.Numbers.V1.WebhookList>'
+                    end
+                end
+
+                class WebhookPage < Page
+                    ##
+                    # Initialize the WebhookPage
+                    # @param [Version] version Version that contains the resource
+                    # @param [Response] response Response from the API
+                    # @param [Hash] solution Path solution for the resource
+                    # @return [WebhookPage] WebhookPage
+                    def initialize(version, response, solution)
+                        super(version, response)
+
+                        # Path Solution
+                        @solution = solution
+                    end
+
+                    ##
+                    # Build an instance of WebhookInstance
+                    # @param [Hash] payload Payload response from the API
+                    # @return [WebhookInstance] WebhookInstance
+                    def get_instance(payload)
+                        WebhookInstance.new(@version, payload)
+                    end
+
+                    ##
+                    # Provide a user friendly representation
+                    def to_s
+                        '<Twilio.Numbers.V1.WebhookPage>'
+                    end
+                end
+                class WebhookInstance < InstanceResource
+                    ##
+                    # Initialize the WebhookInstance
+                    # @param [Version] version Version that contains the resource
+                    # @param [Hash] payload payload that contains response from Twilio
+                    # @param [String] account_sid The SID of the
+                    #   {Account}[https://www.twilio.com/docs/iam/api/account] that created this Webhook
+                    #   resource.
+                    # @param [String] sid The SID of the Call resource to fetch.
+                    # @return [WebhookInstance] WebhookInstance
+                    def initialize(version, payload )
+                        super(version)
+                        
+                        # Marshaled Properties
+                        @properties = { 
+                            'url' => payload['url'],
+                            'port_in_target_url' => payload['port_in_target_url'],
+                            'port_out_target_url' => payload['port_out_target_url'],
+                            'notifications_of' => payload['notifications_of'],
+                            'port_in_target_date_created' => Twilio.deserialize_iso8601_datetime(payload['port_in_target_date_created']),
+                            'port_out_target_date_created' => Twilio.deserialize_iso8601_datetime(payload['port_out_target_date_created']),
+                        }
+                    end
+
+                    
+                    ##
+                    # @return [String] The URL of the webhook configuration request
+                    def url
+                        @properties['url']
+                    end
+                    
+                    ##
+                    # @return [String] The complete webhook url that will be called when a notification event for port in request or port in phone number happens
+                    def port_in_target_url
+                        @properties['port_in_target_url']
+                    end
+                    
+                    ##
+                    # @return [String] The complete webhook url that will be called when a notification event for a port out phone number happens.
+                    def port_out_target_url
+                        @properties['port_out_target_url']
+                    end
+                    
+                    ##
+                    # @return [Array<String>] A list to filter what notification events to receive for this account and its sub accounts. If it is an empty list, then it means that there are no filters for the notifications events to send in each webhook and all events will get sent.
+                    def notifications_of
+                        @properties['notifications_of']
+                    end
+                    
+                    ##
+                    # @return [Time] Creation date for the port in webhook configuration
+                    def port_in_target_date_created
+                        @properties['port_in_target_date_created']
+                    end
+                    
+                    ##
+                    # @return [Time] Creation date for the port out webhook configuration
+                    def port_out_target_date_created
+                        @properties['port_out_target_date_created']
+                    end
+                    
+                    ##
+                    # Provide a user friendly representation
+                    def to_s
+                        "<Twilio.Numbers.V1.WebhookInstance>"
+                    end
+
+                    ##
+                    # Provide a detailed, user friendly representation
+                    def inspect
+                        "<Twilio.Numbers.V1.WebhookInstance>"
+                    end
+                end
+
+            end
+        end
+    end
+end

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

@@ -1,35 +1,155 @@
 ##
-# This code was generated by
-# \ / _    _  _|   _  _
-#  | (_)\/(_)(_|\/| |(/_  v1.0.0
-#       /       /
+#    This code was generated by
+#    ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
+#     |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
+#     |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
+#
+#    Twilio - Numbers
+#    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.
 #
-# frozen_string_literal: true
 
 module Twilio
-  module REST
-    class Numbers
-      class V1 < Version
-        ##
-        # Initialize the V1 version of Numbers
-        def initialize(domain)
-          super
-          @version = 'v1'
-          @eligibilities = nil
-        end
-
-        ##
-        # @return [Twilio::REST::Numbers::V1::EligibilityContext]
-        def eligibilities
-          @eligibilities ||= EligibilityList.new self
-        end
+    module REST
+        class Numbers
+            class V1 < Version
+                ##
+                # Initialize the V1 version of Numbers
+                def initialize(domain)
+                    super
+                    @version = 'v1'
+                    @bulk_eligibilities = nil
+                    @eligibilities = nil
+                    @porting_port_ins = nil
+                    @porting_port_in_phone_number = nil
+                    @porting_portabilities = nil
+                    @porting_webhook_configurations = nil
+                    @porting_webhook_configurations_delete = nil
+                    @signing_request_configurations = nil
+                    @webhook = nil
+                end
 
-        ##
-        # Provide a user friendly representation
-        def to_s
-          '<Twilio::REST::Numbers::V1>'
+                ##
+                # @param [String] request_id The SID of the bulk eligibility check that you want to know about.
+                # @return [Twilio::REST::Numbers::V1::BulkEligibilityContext] if requestId was passed.
+                # @return [Twilio::REST::Numbers::V1::BulkEligibilityList]
+                def bulk_eligibilities(request_id=:unset)
+                    if request_id.nil?
+                        raise ArgumentError, 'request_id cannot be nil'
+                    end
+                    if request_id == :unset
+                        @bulk_eligibilities ||= BulkEligibilityList.new self
+                    else
+                        BulkEligibilityContext.new(self, request_id)
+                    end
+                end
+                ##
+                # @return [Twilio::REST::Numbers::V1::EligibilityList]
+                def eligibilities
+                    @eligibilities ||= EligibilityList.new self
+                end
+                ##
+                # @param [String] port_in_request_sid The SID of the Port In request. This is a unique identifier of the port in request.
+                # @return [Twilio::REST::Numbers::V1::PortingPortInContext] if portInRequestSid was passed.
+                # @return [Twilio::REST::Numbers::V1::PortingPortInList]
+                def porting_port_ins(port_in_request_sid=:unset)
+                    if port_in_request_sid.nil?
+                        raise ArgumentError, 'port_in_request_sid cannot be nil'
+                    end
+                    if port_in_request_sid == :unset
+                        @porting_port_ins ||= PortingPortInList.new self
+                    else
+                        PortingPortInContext.new(self, port_in_request_sid)
+                    end
+                end
+                ##
+                # @param [String] port_in_request_sid The SID of the Port In request. This is a unique identifier of the port in request.
+                # @param [String] phone_number_sid The SID of the Phone number. This is a unique identifier of the phone number.
+                # @return [Twilio::REST::Numbers::V1::PortingPortInPhoneNumberContext] if portInRequestSid was passed.
+                # @return [Twilio::REST::Numbers::V1::PortingPortInPhoneNumberList]
+                def porting_port_in_phone_number(port_in_request_sid=:unset, phone_number_sid=:unset)
+                    if port_in_request_sid.nil?
+                        raise ArgumentError, 'port_in_request_sid cannot be nil'
+                    end
+                    if phone_number_sid.nil?
+                        raise ArgumentError, 'phone_number_sid cannot be nil'
+                    end
+                    if port_in_request_sid == :unset && phone_number_sid == :unset
+                        @porting_port_in_phone_number ||= PortingPortInPhoneNumberList.new self
+                    else
+                        PortingPortInPhoneNumberContext.new(self, port_in_request_sid, phone_number_sid)
+                    end
+                end
+                ##
+                # @param [String] port_in_request_sid The SID of the Port In request. This is a unique identifier of the port in request.
+                # @param [String] phone_number_sid The SID of the Phone number. This is a unique identifier of the phone number.
+                # @return [Twilio::REST::Numbers::V1::PortingPortInPhoneNumberContext] if phoneNumberSid was passed.
+                # @return [Twilio::REST::Numbers::V1::PortingPortInPhoneNumberList]
+                def porting_port_in_phone_number(port_in_request_sid=:unset, phone_number_sid=:unset)
+                    if port_in_request_sid.nil?
+                        raise ArgumentError, 'port_in_request_sid cannot be nil'
+                    end
+                    if phone_number_sid.nil?
+                        raise ArgumentError, 'phone_number_sid cannot be nil'
+                    end
+                    if port_in_request_sid == :unset && phone_number_sid == :unset
+                        @porting_port_in_phone_number ||= PortingPortInPhoneNumberList.new self
+                    else
+                        PortingPortInPhoneNumberContext.new(self, port_in_request_sid, phone_number_sid)
+                    end
+                end
+                ##
+                # @param [String] phone_number Phone number to check portability in e164 format.
+                # @return [Twilio::REST::Numbers::V1::PortingPortabilityContext] if phoneNumber was passed.
+                # @return [Twilio::REST::Numbers::V1::PortingPortabilityList]
+                def porting_portabilities(phone_number=:unset)
+                    if phone_number.nil?
+                        raise ArgumentError, 'phone_number cannot be nil'
+                    end
+                    if phone_number == :unset
+                        @porting_portabilities ||= PortingPortabilityList.new self
+                    else
+                        PortingPortabilityContext.new(self, phone_number)
+                    end
+                end
+                ##
+                # @return [Twilio::REST::Numbers::V1::PortingWebhookConfigurationList]
+                def porting_webhook_configurations
+                    @porting_webhook_configurations ||= PortingWebhookConfigurationList.new self
+                end
+                ##
+                # @param [String] webhook_type The webhook type for the configuration to be delete. `PORT_IN`, `PORT_OUT`
+                # @return [Twilio::REST::Numbers::V1::PortingWebhookConfigurationDeleteContext] if webhookType was passed.
+                # @return [Twilio::REST::Numbers::V1::PortingWebhookConfigurationDeleteList]
+                def porting_webhook_configurations_delete(webhook_type=:unset)
+                    if webhook_type.nil?
+                        raise ArgumentError, 'webhook_type cannot be nil'
+                    end
+                    if webhook_type == :unset
+                        @porting_webhook_configurations_delete ||= PortingWebhookConfigurationDeleteList.new self
+                    else
+                        PortingWebhookConfigurationDeleteContext.new(self, webhook_type)
+                    end
+                end
+                ##
+                # @return [Twilio::REST::Numbers::V1::SigningRequestConfigurationList]
+                def signing_request_configurations
+                    @signing_request_configurations ||= SigningRequestConfigurationList.new self
+                end
+                ##
+                # @return [Twilio::REST::Numbers::V1::WebhookList]
+                def webhook
+                    @webhook ||= WebhookList.new self
+                end
+                ##
+                # Provide a user friendly representation
+                def to_s
+                    '<Twilio::REST::Numbers::V1>';
+                end
+            end
         end
-      end
     end
-  end
-end
+end