twilio-ruby 5.5.1 → 5.58.3

data/lib/twilio-ruby/rest/ip_messaging/v2/service/channel.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -24,8 +26,7 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of ChannelInstance records from the API.
-            # Request is executed immediately.
+            # Create the ChannelInstance
             # @param [String] friendly_name The friendly_name
             # @param [String] unique_name The unique_name
             # @param [String] attributes The attributes
@@ -33,8 +34,10 @@ module Twilio
             # @param [Time] date_created The date_created
             # @param [Time] date_updated The date_updated
             # @param [String] created_by The created_by
-            # @return [ChannelInstance] Newly created ChannelInstance
-            def create(friendly_name: :unset, unique_name: :unset, attributes: :unset, type: :unset, date_created: :unset, date_updated: :unset, created_by: :unset)
+            # @param [channel.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
+            # @return [ChannelInstance] Created ChannelInstance
+            def create(friendly_name: :unset, unique_name: :unset, attributes: :unset, type: :unset, date_created: :unset, date_updated: :unset, created_by: :unset, x_twilio_webhook_enabled: :unset)
               data = Twilio::Values.of({
                   'FriendlyName' => friendly_name,
                   'UniqueName' => unique_name,
@@ -44,21 +47,18 @@ module Twilio
                   'DateUpdated' => Twilio.serialize_iso8601_datetime(date_updated),
                   'CreatedBy' => created_by,
               })
+              headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data, headers: headers)
 
-              ChannelInstance.new(@version, payload, service_sid: @solution[:service_sid])
+              ChannelInstance.new(@version, payload, service_sid: @solution[:service_sid], )
             end
 
             ##
             # Lists ChannelInstance records from the API as a list.
             # Unlike stream(), this operation is eager and will load `limit` records into
             # memory before returning.
-            # @param [channel.ChannelType] type The type
+            # @param [Array[channel.ChannelType]] type The type
             # @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
@@ -74,7 +74,7 @@ module Twilio
             # Streams ChannelInstance records from the API as an Enumerable.
             # This operation lazily loads records as efficiently as possible until the limit
             # is reached.
-            # @param [channel.ChannelType] type The type
+            # @param [Array[channel.ChannelType]] type The type
             # @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
@@ -85,7 +85,7 @@ module Twilio
             def stream(type: :unset, limit: nil, page_size: nil)
               limits = @version.read_limits(limit, page_size)
 
-              page = self.page(type: type, page_size: limits[:page_size])
+              page = self.page(type: type, page_size: limits[:page_size], )
 
               @version.stream(page, limit: limits[:limit], page_limit: limits[:page_limit])
             end
@@ -97,7 +97,7 @@ module Twilio
             def each
               limits = @version.read_limits
 
-              page = self.page(page_size: limits[:page_size])
+              page = self.page(page_size: limits[:page_size], )
 
               @version.stream(page,
                               limit: limits[:limit],
@@ -107,7 +107,7 @@ module Twilio
             ##
             # Retrieve a single page of ChannelInstance records from the API.
             # Request is executed immediately.
-            # @param [channel.ChannelType] type The type
+            # @param [Array[channel.ChannelType]] type The type
             # @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
@@ -119,11 +119,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               ChannelPage.new(@version, response, @solution)
             end
 
@@ -166,7 +164,7 @@ module Twilio
             # @param [Hash] payload Payload response from the API
             # @return [ChannelInstance] ChannelInstance
             def get_instance(payload)
-              ChannelInstance.new(@version, payload, service_sid: @solution[:service_sid])
+              ChannelInstance.new(@version, payload, service_sid: @solution[:service_sid], )
             end
 
             ##
@@ -187,35 +185,34 @@ module Twilio
               super(version)
 
               # Path Solution
-              @solution = {service_sid: service_sid, sid: sid}
+              @solution = {service_sid: service_sid, sid: sid, }
               @uri = "/Services/#{@solution[:service_sid]}/Channels/#{@solution[:sid]}"
 
               # Dependents
               @members = nil
               @messages = nil
               @invites = nil
+              @webhooks = nil
             end
 
             ##
-            # Fetch a ChannelInstance
+            # Fetch the ChannelInstance
             # @return [ChannelInstance] Fetched ChannelInstance
             def fetch
-              params = Twilio::Values.of({})
+              payload = @version.fetch('GET', @uri)
 
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
-
-              ChannelInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid])
+              ChannelInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid], )
             end
 
             ##
-            # Deletes the ChannelInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
-            def delete
-              @version.delete('delete', @uri)
+            # Delete the ChannelInstance
+            # @param [channel.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
+            # @return [Boolean] true if delete succeeds, false otherwise
+            def delete(x_twilio_webhook_enabled: :unset)
+              headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
+
+               @version.delete('DELETE', @uri, headers: headers)
             end
 
             ##
@@ -226,8 +223,10 @@ module Twilio
             # @param [Time] date_created The date_created
             # @param [Time] date_updated The date_updated
             # @param [String] created_by The created_by
+            # @param [channel.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
             # @return [ChannelInstance] Updated ChannelInstance
-            def update(friendly_name: :unset, unique_name: :unset, attributes: :unset, date_created: :unset, date_updated: :unset, created_by: :unset)
+            def update(friendly_name: :unset, unique_name: :unset, attributes: :unset, date_created: :unset, date_updated: :unset, created_by: :unset, x_twilio_webhook_enabled: :unset)
               data = Twilio::Values.of({
                   'FriendlyName' => friendly_name,
                   'UniqueName' => unique_name,
@@ -236,14 +235,11 @@ module Twilio
                   'DateUpdated' => Twilio.serialize_iso8601_datetime(date_updated),
                   'CreatedBy' => created_by,
               })
+              headers = Twilio::Values.of({'X-Twilio-Webhook-Enabled' => x_twilio_webhook_enabled, })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data, headers: headers)
 
-              ChannelInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid])
+              ChannelInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid], )
             end
 
             ##
@@ -254,7 +250,7 @@ module Twilio
               raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
               if sid != :unset
-                return MemberContext.new(@version, @solution[:service_sid], @solution[:sid], sid)
+                return MemberContext.new(@version, @solution[:service_sid], @solution[:sid], sid, )
               end
 
               unless @members
@@ -276,7 +272,7 @@ module Twilio
               raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
               if sid != :unset
-                return MessageContext.new(@version, @solution[:service_sid], @solution[:sid], sid)
+                return MessageContext.new(@version, @solution[:service_sid], @solution[:sid], sid, )
               end
 
               unless @messages
@@ -298,7 +294,7 @@ module Twilio
               raise ArgumentError, 'sid cannot be nil' if sid.nil?
 
               if sid != :unset
-                return InviteContext.new(@version, @solution[:service_sid], @solution[:sid], sid)
+                return InviteContext.new(@version, @solution[:service_sid], @solution[:sid], sid, )
               end
 
               unless @invites
@@ -312,12 +308,41 @@ module Twilio
               @invites
             end
 
+            ##
+            # Access the webhooks
+            # @return [WebhookList]
+            # @return [WebhookContext] if sid was passed.
+            def webhooks(sid=:unset)
+              raise ArgumentError, 'sid cannot be nil' if sid.nil?
+
+              if sid != :unset
+                return WebhookContext.new(@version, @solution[:service_sid], @solution[:sid], sid, )
+              end
+
+              unless @webhooks
+                @webhooks = WebhookList.new(
+                    @version,
+                    service_sid: @solution[:service_sid],
+                    channel_sid: @solution[:sid],
+                )
+              end
+
+              @webhooks
+            end
+
             ##
             # Provide a user friendly representation
             def to_s
               context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
               "#<Twilio.IpMessaging.V2.ChannelContext #{context}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+              "#<Twilio.IpMessaging.V2.ChannelContext #{context}>"
+            end
           end
 
           class ChannelInstance < InstanceResource
@@ -351,7 +376,7 @@ module Twilio
 
               # Context
               @instance_context = nil
-              @params = {'service_sid' => service_sid, 'sid' => sid || @properties['sid']}
+              @params = {'service_sid' => service_sid, 'sid' => sid || @properties['sid'], }
             end
 
             ##
@@ -360,7 +385,7 @@ module Twilio
             # @return [ChannelContext] ChannelContext for this ChannelInstance
             def context
               unless @instance_context
-                @instance_context = ChannelContext.new(@version, @params['service_sid'], @params['sid'])
+                @instance_context = ChannelContext.new(@version, @params['service_sid'], @params['sid'], )
               end
               @instance_context
             end
@@ -450,17 +475,19 @@ module Twilio
             end
 
             ##
-            # Fetch a ChannelInstance
+            # Fetch the ChannelInstance
             # @return [ChannelInstance] Fetched ChannelInstance
             def fetch
               context.fetch
             end
 
             ##
-            # Deletes the ChannelInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
-            def delete
-              context.delete
+            # Delete the ChannelInstance
+            # @param [channel.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
+            # @return [Boolean] true if delete succeeds, false otherwise
+            def delete(x_twilio_webhook_enabled: :unset)
+              context.delete(x_twilio_webhook_enabled: x_twilio_webhook_enabled, )
             end
 
             ##
@@ -471,8 +498,10 @@ module Twilio
             # @param [Time] date_created The date_created
             # @param [Time] date_updated The date_updated
             # @param [String] created_by The created_by
+            # @param [channel.WebhookEnabledType] x_twilio_webhook_enabled The
+            #   X-Twilio-Webhook-Enabled HTTP request header
             # @return [ChannelInstance] Updated ChannelInstance
-            def update(friendly_name: :unset, unique_name: :unset, attributes: :unset, date_created: :unset, date_updated: :unset, created_by: :unset)
+            def update(friendly_name: :unset, unique_name: :unset, attributes: :unset, date_created: :unset, date_updated: :unset, created_by: :unset, x_twilio_webhook_enabled: :unset)
               context.update(
                   friendly_name: friendly_name,
                   unique_name: unique_name,
@@ -480,6 +509,7 @@ module Twilio
                   date_created: date_created,
                   date_updated: date_updated,
                   created_by: created_by,
+                  x_twilio_webhook_enabled: x_twilio_webhook_enabled,
               )
             end
 
@@ -504,6 +534,13 @@ module Twilio
               context.invites
             end
 
+            ##
+            # Access the webhooks
+            # @return [webhooks] webhooks
+            def webhooks
+              context.webhooks
+            end
+
             ##
             # Provide a user friendly representation
             def to_s

data/lib/twilio-ruby/rest/ip_messaging/v2/service/role.rb

@@ -3,6 +3,8 @@
 # \ / _    _  _|   _  _
 #  | (_)\/(_)(_|\/| |(/_  v1.0.0
 #       /       /
+#
+# frozen_string_literal: true
 
 module Twilio
   module REST
@@ -24,12 +26,11 @@ module Twilio
             end
 
             ##
-            # Retrieve a single page of RoleInstance records from the API.
-            # Request is executed immediately.
+            # Create the RoleInstance
             # @param [String] friendly_name The friendly_name
             # @param [role.RoleType] type The type
-            # @param [String] permission The permission
-            # @return [RoleInstance] Newly created RoleInstance
+            # @param [Array[String]] permission The permission
+            # @return [RoleInstance] Created RoleInstance
             def create(friendly_name: nil, type: nil, permission: nil)
               data = Twilio::Values.of({
                   'FriendlyName' => friendly_name,
@@ -37,13 +38,9 @@ module Twilio
                   'Permission' => Twilio.serialize_list(permission) { |e| e },
               })
 
-              payload = @version.create(
-                  'POST',
-                  @uri,
-                  data: data
-              )
+              payload = @version.create('POST', @uri, data: data)
 
-              RoleInstance.new(@version, payload, service_sid: @solution[:service_sid])
+              RoleInstance.new(@version, payload, service_sid: @solution[:service_sid], )
             end
 
             ##
@@ -75,7 +72,7 @@ module Twilio
             def stream(limit: nil, page_size: nil)
               limits = @version.read_limits(limit, page_size)
 
-              page = self.page(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
@@ -87,7 +84,7 @@ module Twilio
             def each
               limits = @version.read_limits
 
-              page = self.page(page_size: limits[:page_size])
+              page = self.page(page_size: limits[:page_size], )
 
               @version.stream(page,
                               limit: limits[:limit],
@@ -107,11 +104,9 @@ module Twilio
                   'Page' => page_number,
                   'PageSize' => page_size,
               })
-              response = @version.page(
-                  'GET',
-                  @uri,
-                  params
-              )
+
+              response = @version.page('GET', @uri, params: params)
+
               RolePage.new(@version, response, @solution)
             end
 
@@ -154,7 +149,7 @@ module Twilio
             # @param [Hash] payload Payload response from the API
             # @return [RoleInstance] RoleInstance
             def get_instance(payload)
-              RoleInstance.new(@version, payload, service_sid: @solution[:service_sid])
+              RoleInstance.new(@version, payload, service_sid: @solution[:service_sid], )
             end
 
             ##
@@ -175,46 +170,36 @@ module Twilio
               super(version)
 
               # Path Solution
-              @solution = {service_sid: service_sid, sid: sid}
+              @solution = {service_sid: service_sid, sid: sid, }
               @uri = "/Services/#{@solution[:service_sid]}/Roles/#{@solution[:sid]}"
             end
 
             ##
-            # Fetch a RoleInstance
+            # Fetch the RoleInstance
             # @return [RoleInstance] Fetched RoleInstance
             def fetch
-              params = Twilio::Values.of({})
-
-              payload = @version.fetch(
-                  'GET',
-                  @uri,
-                  params,
-              )
+              payload = @version.fetch('GET', @uri)
 
-              RoleInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid])
+              RoleInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid], )
             end
 
             ##
-            # Deletes the RoleInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
+            # Delete the RoleInstance
+            # @return [Boolean] true if delete succeeds, false otherwise
             def delete
-              @version.delete('delete', @uri)
+               @version.delete('DELETE', @uri)
             end
 
             ##
             # Update the RoleInstance
-            # @param [String] permission The permission
+            # @param [Array[String]] permission The permission
             # @return [RoleInstance] Updated RoleInstance
             def update(permission: nil)
-              data = Twilio::Values.of({'Permission' => Twilio.serialize_list(permission) { |e| e }})
+              data = Twilio::Values.of({'Permission' => Twilio.serialize_list(permission) { |e| e }, })
 
-              payload = @version.update(
-                  'POST',
-                  @uri,
-                  data: data,
-              )
+              payload = @version.update('POST', @uri, data: data)
 
-              RoleInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid])
+              RoleInstance.new(@version, payload, service_sid: @solution[:service_sid], sid: @solution[:sid], )
             end
 
             ##
@@ -223,6 +208,13 @@ module Twilio
               context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
               "#<Twilio.IpMessaging.V2.RoleContext #{context}>"
             end
+
+            ##
+            # Provide a detailed, user friendly representation
+            def inspect
+              context = @solution.map {|k, v| "#{k}: #{v}"}.join(',')
+              "#<Twilio.IpMessaging.V2.RoleContext #{context}>"
+            end
           end
 
           class RoleInstance < InstanceResource
@@ -251,7 +243,7 @@ module Twilio
 
               # Context
               @instance_context = nil
-              @params = {'service_sid' => service_sid, 'sid' => sid || @properties['sid']}
+              @params = {'service_sid' => service_sid, 'sid' => sid || @properties['sid'], }
             end
 
             ##
@@ -260,7 +252,7 @@ module Twilio
             # @return [RoleContext] RoleContext for this RoleInstance
             def context
               unless @instance_context
-                @instance_context = RoleContext.new(@version, @params['service_sid'], @params['sid'])
+                @instance_context = RoleContext.new(@version, @params['service_sid'], @params['sid'], )
               end
               @instance_context
             end
@@ -296,7 +288,7 @@ module Twilio
             end
 
             ##
-            # @return [String] The permissions
+            # @return [Array[String]] The permissions
             def permissions
               @properties['permissions']
             end
@@ -320,25 +312,25 @@ module Twilio
             end
 
             ##
-            # Fetch a RoleInstance
+            # Fetch the RoleInstance
             # @return [RoleInstance] Fetched RoleInstance
             def fetch
               context.fetch
             end
 
             ##
-            # Deletes the RoleInstance
-            # @return [Boolean] true if delete succeeds, true otherwise
+            # Delete the RoleInstance
+            # @return [Boolean] true if delete succeeds, false otherwise
             def delete
               context.delete
             end
 
             ##
             # Update the RoleInstance
-            # @param [String] permission The permission
+            # @param [Array[String]] permission The permission
             # @return [RoleInstance] Updated RoleInstance
             def update(permission: nil)
-              context.update(permission: permission)
+              context.update(permission: permission, )
             end
 
             ##