twilio-ruby 5.19.0 → 5.74.2

data/lib/twilio-ruby/rest/wireless/v1/rate_plan.rb

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -84,11 +84,9 @@ module Twilio
                 'Page' => page_number,
                 'PageSize' => page_size,
             })
-            response = @version.page(
-                'GET',
-                @uri,
-                params
-            )
+
+            response = @version.page('GET', @uri, params: params)
+
             RatePlanPage.new(@version, response, @solution)
           end
 
@@ -106,38 +104,43 @@ module Twilio
           end
 
           ##
-          # Retrieve a single page of RatePlanInstance records from the API.
-          # Request is executed immediately.
-          # @param [String] unique_name A user-provided string that uniquely identifies this
-          #   resource as an alternative to the Sid.
-          # @param [String] friendly_name A user-provided string that identifies this
-          #   resource. Non-unique.
-          # @param [Boolean] data_enabled Defines whether SIMs are capable of using
-          #   GPRS/3G/LTE data connectivity.
-          # @param [String] data_limit Network-enforced limit specifying the total Megabytes
-          #   of data usage (download and upload combined) allowed during one month on the
-          #   home network. Metering begins on the day of activation and ends on the same day
-          #   of the following month.  Max value is 2TB.
-          # @param [String] data_metering The model by which to meter data usage, in
-          #   accordance with the two available [data metering
-          #   models](https://www.twilio.com/docs/api/wireless/rest-api/rate-plan#explanation-of-pooled-vs-individual). Valid options are `pooled` and `individual`.
-          # @param [Boolean] messaging_enabled Defines whether SIMs are capable of making
-          #   and sending and receiving SMS messages via either
-          #   [Commands](https://www.twilio.com/docs/wireless/api/commands) or Programmable
-          #   SMS APIs.
-          # @param [Boolean] voice_enabled Defines whether SIMs are capable of making and
-          #   receiving voice calls.
-          # @param [Boolean] national_roaming_enabled Defines whether SIMs can roam onto
-          #   other networks in the SIM's home country. See ['national'
-          #   roaming](https://www.twilio.com/docs/api/wireless/rest-api/rate-plan#national-roaming).
-          # @param [String] international_roaming The international_roaming
-          # @param [String] national_roaming_data_limit Network-enforced limit specifying
-          #   the total Megabytes of national roaming data usage (download and upload
-          #   combined) allowed during one month.  Max value is 2TB. If unspecified, the
-          #   default value is the lesser of `DataLimit` and 1000MB.
-          # @param [String] international_roaming_data_limit The
-          #   international_roaming_data_limit
-          # @return [RatePlanInstance] Newly created RatePlanInstance
+          # Create the RatePlanInstance
+          # @param [String] unique_name An application-defined string that uniquely
+          #   identifies the resource. It can be used in place of the resource's `sid` in the
+          #   URL to address the resource.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the resource. It does not have to be unique.
+          # @param [Boolean] data_enabled Whether SIMs can use GPRS/3G/4G/LTE data
+          #   connectivity.
+          # @param [String] data_limit The total data usage (download and upload combined)
+          #   in Megabytes that the Network allows during one month on the home network
+          #   (T-Mobile USA). The metering period begins the day of activation and ends on the
+          #   same day in the following month. Can be up to 2TB and the default value is
+          #   `1000`.
+          # @param [String] data_metering The model used to meter data usage. Can be: `payg`
+          #   and `quota-1`, `quota-10`, and `quota-50`. Learn more about the available {data
+          #   metering
+          #   models}[https://www.twilio.com/docs/wireless/api/rateplan-resource#payg-vs-quota-data-plans].
+          # @param [Boolean] messaging_enabled Whether SIMs can make, send, and receive SMS
+          #   using {Commands}[https://www.twilio.com/docs/wireless/api/command-resource].
+          # @param [Boolean] voice_enabled Deprecated.
+          # @param [Boolean] national_roaming_enabled Whether SIMs can roam on networks
+          #   other than the home network (T-Mobile USA) in the United States. See {national
+          #   roaming}[https://www.twilio.com/docs/wireless/api/rateplan-resource#national-roaming].
+          # @param [Array[String]] international_roaming The list of services that SIMs
+          #   capable of using GPRS/3G/4G/LTE data connectivity can use outside of the United
+          #   States. Can contain: `data` and `messaging`.
+          # @param [String] national_roaming_data_limit The total data usage (download and
+          #   upload combined) in Megabytes that the Network allows during one month on
+          #   non-home networks in the United States. The metering period begins the day of
+          #   activation and ends on the same day in the following month. Can be up to 2TB.
+          #   See {national
+          #   roaming}[https://www.twilio.com/docs/wireless/api/rateplan-resource#national-roaming]
+          #   for more info.
+          # @param [String] international_roaming_data_limit The total data usage (download
+          #   and upload combined) in Megabytes that the Network allows during one month when
+          #   roaming outside the United States. Can be up to 2TB.
+          # @return [RatePlanInstance] Created RatePlanInstance
           def create(unique_name: :unset, friendly_name: :unset, data_enabled: :unset, data_limit: :unset, data_metering: :unset, messaging_enabled: :unset, voice_enabled: :unset, national_roaming_enabled: :unset, international_roaming: :unset, national_roaming_data_limit: :unset, international_roaming_data_limit: :unset)
             data = Twilio::Values.of({
                 'UniqueName' => unique_name,
@@ -153,11 +156,7 @@ module Twilio
                 'InternationalRoamingDataLimit' => international_roaming_data_limit,
             })
 
-            payload = @version.create(
-                'POST',
-                @uri,
-                data: data
-            )
+            payload = @version.create('POST', @uri, data: data)
 
             RatePlanInstance.new(@version, payload, )
           end
@@ -202,7 +201,7 @@ module Twilio
           ##
           # Initialize the RatePlanContext
           # @param [Version] version Version that contains the resource
-          # @param [String] sid The sid
+          # @param [String] sid The SID of the RatePlan resource to fetch.
           # @return [RatePlanContext] RatePlanContext
           def initialize(version, sid)
             super(version)
@@ -213,44 +212,35 @@ module Twilio
           end
 
           ##
-          # Fetch a RatePlanInstance
+          # Fetch the RatePlanInstance
           # @return [RatePlanInstance] Fetched RatePlanInstance
           def fetch
-            params = Twilio::Values.of({})
-
-            payload = @version.fetch(
-                'GET',
-                @uri,
-                params,
-            )
+            payload = @version.fetch('GET', @uri)
 
             RatePlanInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
           # Update the RatePlanInstance
-          # @param [String] unique_name A user-provided string that uniquely identifies this
-          #   resource as an alternative to the Sid.
-          # @param [String] friendly_name A user-provided string that identifies this
-          #   resource. Non-unique.
+          # @param [String] unique_name An application-defined string that uniquely
+          #   identifies the resource. It can be used in place of the resource's `sid` in the
+          #   URL to address the resource.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the resource. It does not have to be unique.
           # @return [RatePlanInstance] Updated RatePlanInstance
           def update(unique_name: :unset, friendly_name: :unset)
             data = Twilio::Values.of({'UniqueName' => unique_name, 'FriendlyName' => friendly_name, })
 
-            payload = @version.update(
-                'POST',
-                @uri,
-                data: data,
-            )
+            payload = @version.update('POST', @uri, data: data)
 
             RatePlanInstance.new(@version, payload, sid: @solution[:sid], )
           end
 
           ##
-          # Deletes the RatePlanInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # Delete the RatePlanInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
-            @version.delete('delete', @uri)
+             @version.delete('DELETE', @uri)
           end
 
           ##
@@ -259,6 +249,13 @@ module Twilio
             context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
             "#<Twilio.Wireless.V1.RatePlanContext #{context}>"
           end
+
+          ##
+          # Provide a detailed, user friendly representation
+          def inspect
+            context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+            "#<Twilio.Wireless.V1.RatePlanContext #{context}>"
+          end
         end
 
         class RatePlanInstance < InstanceResource
@@ -266,7 +263,7 @@ module Twilio
           # Initialize the RatePlanInstance
           # @param [Version] version Version that contains the resource
           # @param [Hash] payload payload that contains response from Twilio
-          # @param [String] sid The sid
+          # @param [String] sid The SID of the RatePlan resource to fetch.
           # @return [RatePlanInstance] RatePlanInstance
           def initialize(version, payload, sid: nil)
             super(version)
@@ -279,13 +276,13 @@ module Twilio
                 'friendly_name' => payload['friendly_name'],
                 'data_enabled' => payload['data_enabled'],
                 'data_metering' => payload['data_metering'],
-                'data_limit' => payload['data_limit'].to_i,
+                'data_limit' => payload['data_limit'] == nil ? payload['data_limit'] : payload['data_limit'].to_i,
                 'messaging_enabled' => payload['messaging_enabled'],
                 'voice_enabled' => payload['voice_enabled'],
                 'national_roaming_enabled' => payload['national_roaming_enabled'],
-                'national_roaming_data_limit' => payload['national_roaming_data_limit'].to_i,
+                'national_roaming_data_limit' => payload['national_roaming_data_limit'] == nil ? payload['national_roaming_data_limit'] : payload['national_roaming_data_limit'].to_i,
                 'international_roaming' => payload['international_roaming'],
-                'international_roaming_data_limit' => payload['international_roaming_data_limit'].to_i,
+                'international_roaming_data_limit' => payload['international_roaming_data_limit'] == nil ? payload['international_roaming_data_limit'] : payload['international_roaming_data_limit'].to_i,
                 'date_created' => Twilio.deserialize_iso8601_datetime(payload['date_created']),
                 'date_updated' => Twilio.deserialize_iso8601_datetime(payload['date_updated']),
                 'url' => payload['url'],
@@ -308,103 +305,103 @@ module Twilio
           end
 
           ##
-          # @return [String] A 34 character string that uniquely identifies this resource.
+          # @return [String] The unique string that identifies the resource
           def sid
             @properties['sid']
           end
 
           ##
-          # @return [String] A user-provided string that uniquely identifies this resource as an alternative to the sid.
+          # @return [String] An application-defined string that uniquely identifies the resource
           def unique_name
             @properties['unique_name']
           end
 
           ##
-          # @return [String] The unique id of the Account that this Rate Plan belongs to.
+          # @return [String] The SID of the Account that created the resource
           def account_sid
             @properties['account_sid']
           end
 
           ##
-          # @return [String] A user-provided string that identifies this resource.
+          # @return [String] The string that you assigned to describe the resource
           def friendly_name
             @properties['friendly_name']
           end
 
           ##
-          # @return [Boolean] Defines whether SIMs are capable of using GPRS/3G/4G/LTE data connectivity.
+          # @return [Boolean] Whether SIMs can use GPRS/3G/4G/LTE data connectivity
           def data_enabled
             @properties['data_enabled']
           end
 
           ##
-          # @return [String] The model by which to meter data usage, in accordance with the two available data metering models.
+          # @return [String] The model used to meter data usage
           def data_metering
             @properties['data_metering']
           end
 
           ##
-          # @return [String] Network-enforced limit specifying the total Megabytes of data usage allowed during one month on the home network.
+          # @return [String] The total data usage in Megabytes that the Network allows during one month on the home network
           def data_limit
             @properties['data_limit']
           end
 
           ##
-          # @return [Boolean] Defines whether SIMs are capable of making and sending and receiving SMS via Commands.
+          # @return [Boolean] Whether SIMs can make, send, and receive SMS using Commands
           def messaging_enabled
             @properties['messaging_enabled']
           end
 
           ##
-          # @return [Boolean] Defines whether SIMs are capable of making and receiving voice calls.
+          # @return [Boolean] Deprecated. Whether SIMs can make and receive voice calls
           def voice_enabled
             @properties['voice_enabled']
           end
 
           ##
-          # @return [Boolean] Defines whether SIMs can roam onto other networks in the SIM's home country.
+          # @return [Boolean] Whether SIMs can roam on networks other than the home network in the United States
           def national_roaming_enabled
             @properties['national_roaming_enabled']
           end
 
           ##
-          # @return [String] Network-enforced limit specifying the total Megabytes of national roaming data usage allowed during one month.
+          # @return [String] The total data usage in Megabytes that the Network allows during one month on non-home networks in the United States
           def national_roaming_data_limit
             @properties['national_roaming_data_limit']
           end
 
           ##
-          # @return [String] The international_roaming
+          # @return [Array[String]] The services that SIMs capable of using GPRS/3G/4G/LTE data connectivity can use outside of the United States
           def international_roaming
             @properties['international_roaming']
           end
 
           ##
-          # @return [String] The international_roaming_data_limit
+          # @return [String] The total data usage (download and upload combined) in Megabytes that the Network allows during one month when roaming outside the United States
           def international_roaming_data_limit
             @properties['international_roaming_data_limit']
           end
 
           ##
-          # @return [Time] The date that this resource was created, given as GMT in ISO 8601 format.
+          # @return [Time] The date when the resource was created, given as GMT in ISO 8601 format
           def date_created
             @properties['date_created']
           end
 
           ##
-          # @return [Time] The date that this resource was last updated, given as GMT in ISO 8601 format.
+          # @return [Time] The date when the resource was last updated, given as GMT in ISO 8601 format
           def date_updated
             @properties['date_updated']
           end
 
           ##
-          # @return [String] The URL for this resource.
+          # @return [String] The absolute URL of the resource
           def url
             @properties['url']
           end
 
           ##
-          # Fetch a RatePlanInstance
+          # Fetch the RatePlanInstance
           # @return [RatePlanInstance] Fetched RatePlanInstance
           def fetch
             context.fetch
@@ -412,18 +409,19 @@ module Twilio
 
           ##
           # Update the RatePlanInstance
-          # @param [String] unique_name A user-provided string that uniquely identifies this
-          #   resource as an alternative to the Sid.
-          # @param [String] friendly_name A user-provided string that identifies this
-          #   resource. Non-unique.
+          # @param [String] unique_name An application-defined string that uniquely
+          #   identifies the resource. It can be used in place of the resource's `sid` in the
+          #   URL to address the resource.
+          # @param [String] friendly_name A descriptive string that you create to describe
+          #   the resource. It does not have to be unique.
           # @return [RatePlanInstance] Updated RatePlanInstance
           def update(unique_name: :unset, friendly_name: :unset)
             context.update(unique_name: unique_name, friendly_name: friendly_name, )
           end
 
           ##
-          # Deletes the RatePlanInstance
-          # @return [Boolean] true if delete succeeds, true otherwise
+          # Delete the RatePlanInstance
+          # @return [Boolean] true if delete succeeds, false otherwise
           def delete
             context.delete
           end

data/lib/twilio-ruby/rest/wireless/v1/sim/data_session.rb

@@ -3,7 +3,7 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
-# 
+#
 # frozen_string_literal: true
 
 module Twilio
@@ -15,9 +15,9 @@ module Twilio
             ##
             # Initialize the DataSessionList
             # @param [Version] version Version that contains the resource
-            # @param [String] sim_sid The unique id of the
-            #   [SIM](https://www.twilio.com/docs/api/wireless/rest-api/sim) resource that this
-            #   Data Session is for.
+            # @param [String] sim_sid The SID of the {Sim
+            #   resource}[https://www.twilio.com/docs/wireless/api/sim-resource] that the Data
+            #   Session is for.
             # @return [DataSessionList] DataSessionList
             def initialize(version, sim_sid: nil)
               super(version)
@@ -31,8 +31,6 @@ module Twilio
             # Lists DataSessionInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
-            # @param [Time] end_ The end
-            # @param [Time] start The start
             # @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
@@ -40,16 +38,14 @@ module Twilio
             #    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(end_: :unset, start: :unset, limit: nil, page_size: nil)
-              self.stream(end_: end_, start: start, limit: limit, page_size: page_size).entries
+            def list(limit: nil, page_size: nil)
+              self.stream(limit: limit, page_size: page_size).entries
             end
 
             ##
             # Streams DataSessionInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
-            # @param [Time] end_ The end
-            # @param [Time] start The start
             # @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
@@ -57,10 +53,10 @@ module Twilio
             #    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(end_: :unset, start: :unset, limit: nil, page_size: nil)
+            def stream(limit: nil, page_size: nil)
               limits = @version.read_limits(limit, page_size)
 
-              page = self.page(end_: end_, start: start, page_size: limits[:page_size], )
+              page = self.page(page_size: limits[:page_size], )
 
               @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
             end
@@ -82,25 +78,19 @@ module Twilio
             ##
             # Retrieve a single page of DataSessionInstance records from the API.
             # Request is executed immediately.
-            # @param [Time] end_ The end
-            # @param [Time] start The start
             # @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 DataSessionInstance
-            def page(end_: :unset, start: :unset, page_token: :unset, page_number: :unset, page_size: :unset)
+            def page(page_token: :unset, page_number: :unset, page_size: :unset)
               params = Twilio::Values.of({
-                  'End' => Twilio.serialize_iso8601_datetime(end_),
-                  'Start' => Twilio.serialize_iso8601_datetime(start),
                   'PageToken' => page_token,
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               DataSessionPage.new(@version, response, @solution)
             end
 
@@ -158,9 +148,9 @@ module Twilio
             # Initialize the DataSessionInstance
             # @param [Version] version Version that contains the resource
             # @param [Hash] payload payload that contains response from Twilio
-            # @param [String] sim_sid The unique id of the
-            #   [SIM](https://www.twilio.com/docs/api/wireless/rest-api/sim) resource that this
-            #   Data Session is for.
+            # @param [String] sim_sid The SID of the {Sim
+            #   resource}[https://www.twilio.com/docs/wireless/api/sim-resource] that the Data
+            #   Session is for.
             # @return [DataSessionInstance] DataSessionInstance
             def initialize(version, payload, sim_sid: nil)
               super(version)
@@ -177,104 +167,111 @@ module Twilio
                   'operator_name' => payload['operator_name'],
                   'cell_id' => payload['cell_id'],
                   'cell_location_estimate' => payload['cell_location_estimate'],
-                  'packets_uploaded' => payload['packets_uploaded'].to_i,
-                  'packets_downloaded' => payload['packets_downloaded'].to_i,
+                  'packets_uploaded' => payload['packets_uploaded'] == nil ? payload['packets_uploaded'] : payload['packets_uploaded'].to_i,
+                  'packets_downloaded' => payload['packets_downloaded'] == nil ? payload['packets_downloaded'] : payload['packets_downloaded'].to_i,
                   'last_updated' => Twilio.deserialize_iso8601_datetime(payload['last_updated']),
                   'start' => Twilio.deserialize_iso8601_datetime(payload['start']),
                   'end_' => Twilio.deserialize_iso8601_datetime(payload['end']),
+                  'imei' => payload['imei'],
               }
             end
 
             ##
-            # @return [String] The unique id of the Data Session resource that this Data Record is for.
+            # @return [String] The unique string that identifies the resource
             def sid
               @properties['sid']
             end
 
             ##
-            # @return [String] The unique id of the SIM resource that this Data Session is for.
+            # @return [String] The SID of the Sim resource that the Data Session is for
             def sim_sid
               @properties['sim_sid']
             end
 
             ##
-            # @return [String] The unique id of the Account that the SIM belongs to.
+            # @return [String] The SID of the Account that created the resource
             def account_sid
               @properties['account_sid']
             end
 
             ##
-            # @return [String] The generation of wireless technology that the device was attached to the cellular tower using.
+            # @return [String] The generation of wireless technology that the device was using
             def radio_link
               @properties['radio_link']
             end
 
             ##
-            # @return [String] The 'mobile country code' is the unique id of the home country where the Data Session took place.
+            # @return [String] The 'mobile country code' is the unique ID of the home country where the Data Session took place
             def operator_mcc
               @properties['operator_mcc']
             end
 
             ##
-            # @return [String] The 'mobile network code' is the unique id specific to the mobile operator network where the Data Session took place.
+            # @return [String] The 'mobile network code' is the unique ID specific to the mobile operator network where the Data Session took place
             def operator_mnc
               @properties['operator_mnc']
             end
 
             ##
-            # @return [String] The three letter country code representing where the device's Data Session took place.
+            # @return [String] The three letter country code representing where the device's Data Session took place
             def operator_country
               @properties['operator_country']
             end
 
             ##
-            # @return [String] The friendly name of the mobile operator network that the SIM-connected device is attached to.
+            # @return [String] The friendly name of the mobile operator network that the SIM-connected device is attached to
             def operator_name
               @properties['operator_name']
             end
 
             ##
-            # @return [String] The unique id of the cellular tower that the device was attached to at the moment when the Data Session was last updated.
+            # @return [String] The unique ID of the cellular tower that the device was attached to at the moment when the Data Session was last updated
             def cell_id
               @properties['cell_id']
             end
 
             ##
-            # @return [Hash] An object representing the estimated location where the device's Data Session took place.
+            # @return [Hash] An object with the estimated location where the device's Data Session took place
             def cell_location_estimate
               @properties['cell_location_estimate']
             end
 
             ##
-            # @return [String] The number of packets uploaded by the device between the start time and when the Data Session was last updated.
+            # @return [String] The number of packets uploaded by the device between the start time and when the Data Session was last updated
             def packets_uploaded
               @properties['packets_uploaded']
             end
 
             ##
-            # @return [String] The number of packets downloaded by the device between the start time and when the Data Session was last updated.
+            # @return [String] The number of packets downloaded by the device between the start time and when the Data Session was last updated
             def packets_downloaded
               @properties['packets_downloaded']
             end
 
             ##
-            # @return [Time] The date that this resource was last updated, given as GMT in ISO 8601 format.
+            # @return [Time] The date that the resource was last updated, given as GMT in ISO 8601 format
             def last_updated
               @properties['last_updated']
             end
 
             ##
-            # @return [Time] The date that this Data Session started, given as GMT in ISO 8601 format.
+            # @return [Time] The date that the Data Session started, given as GMT in ISO 8601 format
             def start
               @properties['start']
             end
 
             ##
-            # @return [Time] The date that this record ended, given as GMT in ISO 8601 format.
+            # @return [Time] The date that the record ended, given as GMT in ISO 8601 format
             def end_
               @properties['end_']
             end
 
+            ##
+            # @return [String] The unique ID of the device using the SIM to connect
+            def imei
+              @properties['imei']
+            end
+
             ##
             # Provide a user friendly representation
             def to_s