vonage 7.29.1 → 8.0.0.beta

data/lib/vonage/conversation/member.rb

@@ -1,134 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-
-module Vonage
-  class Conversation::Member < Namespace
-    self.authentication = BearerToken
-
-    self.request_body = JSON
-
-    # List members of a conversation
-    #
-    # @example
-    #   response = client.conversation.member.list(conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a')
-    #
-    # @param [required, String] :conversation_id The conversation_id of the conversation to list members for
-    #
-    # @param [Integer] :page_size
-    #   Return this amount of records in the response.
-    #
-    # @param ['asc', 'desc'] :order
-    #   Return the records in ascending or descending order.
-    #
-    # @param [String] :cursor
-    #   The cursor to start returning results from.
-    #
-    # @return [Conversation::Member::ListResponse]
-    #
-    # @see https://developer.vonage.com/en/api/conversation#getMembers
-    #
-    def list(conversation_id:, **params)
-      request("/v1/conversations/#{conversation_id}/members", params: params, response_class: ListResponse)
-    end
-
-    # Create a member.
-    #
-    # @example
-    #   response = client.conversation.member.create(
-    #     conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a',
-    #     user: {
-    #       id: 'USR-82e028d9-5201-4f1e-8188-604b2d3471ec'
-    #     }
-    #   )
-    #
-    # @param [required, String] :conversation_id The conversation_id of the conversation for which to create the member
-    #
-    # @param [String] :state Must be one of ['invited', 'joined']
-    #
-    # @param [Hash] :user (Either :id or :name is required)
-    #   - @option user [String] :id The user_id of the user to add to the conversation
-    #   - @option user [String] :name The name of the user to add to the conversation
-    #
-    # @param [Hash] :channel
-    #   - @option channel [required, String] :type The type of channel
-    #   - @option channel [Hash] :from
-    #     - @option from [String] :type
-    #     - @option from [String] :number
-    #     - @option from [String] :id
-    #   - @option channel [Hash] :to
-    #     - @option from [String] :type 
-    #     - @option from [String] :user
-    #     - @option from [String] :number
-    #     - @option from [String] :id
-    #
-    # @param [Hash] :media
-    #   - @option media [Boolean] :audio
-    #   - @option media [Hash] :audio_settings
-    #     - @option audio_settings [Boolean] :enabled
-    #     - @option audio_settings [Boolean] :earmuffed
-    #     - @option audio_settings [Boolean] :muted
-    #
-    # @param [String] :knocking_id
-    #
-    # @param [String] :member_id_inviting
-    #
-    # @param [String] :from
-    #
-    # @return [Response]
-    #
-    # @see https://developer.vonage.com/en/api/conversation#createMember
-    #
-    def create(conversation_id:, **params)
-      request("/v1/conversations/#{conversation_id}/members", params: params, type: Post)
-    end
-
-    # Retrieve a member
-    #
-    # @example
-    #   response = client.conversation.member.find(
-    #     conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a',
-    #     member_id: 'MEM-63f61863-4a51-4f6b-86e1-46edebio0391'
-    #   )  
-    #
-    # @param [required, String] :conversation_id
-    #
-    # @param [required, String] :member_id
-    #
-    # @return [Response]
-    #
-    # @see https://developer.vonage.com/en/api/conversation#getMember
-    #
-    def find(conversation_id:, member_id:)   
-      request("/v1/conversations/#{conversation_id}/members/#{member_id}", response_class: Vonage::Response)
-    end
-
-    # Update a member
-    #
-    # @example
-    #   response = client.conversation.member.update(
-    #     conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a',
-    #     member_id: 'MEM-63f61863-4a51-4f6b-86e1-46edebio0391',
-    #     state: 'left'
-    #   )  
-    #
-    # @param [required, String] :conversation_id
-    #
-    # @param [required, String] :member_id
-    #
-    # @param [String] :state Must be one of ['joined', 'left']
-    #
-    # @param [String] :from
-    #
-    # @param [Hash] :reason
-    #  - @option reason [String] :code
-    #  - @option reason [String] :text
-    #
-    # @return [Response]
-    #
-    # @see https://developer.vonage.com/en/api/conversation#updateMember
-    #
-    def update(conversation_id:, member_id:, **params)
-      request("/v1/conversations/#{conversation_id}/members/#{member_id}", params: params, type: Patch)
-    end
-  end
-end

data/lib/vonage/conversation/user/conversations_list_response.rb

@@ -1,11 +0,0 @@
-# typed: true
-
-class Vonage::Conversation::User::ConversationsListResponse < Vonage::Response
-  include Enumerable
-
-  def each
-    return enum_for(:each) unless block_given?
-
-    @entity._embedded.conversations.each { |item| yield item }
-  end
-end

data/lib/vonage/conversation/user/sessions_list_response.rb

@@ -1,11 +0,0 @@
-# typed: true
-
-class Vonage::Conversation::User::SessionsListResponse < Vonage::Response
-  include Enumerable
-
-  def each
-    return enum_for(:each) unless block_given?
-
-    @entity._embedded.sessions.each { |item| yield item }
-  end
-end

data/lib/vonage/conversation/user.rb

@@ -1,67 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-
-module Vonage
-  class Conversation::User < Namespace
-    self.authentication = BearerToken
-
-    # List conversations associated with a user.
-    #
-    # @example
-    #   response = client.conversation.user.list_conversations(user_id: 'USR-82e028d9-5201-4f1e-8188-604b2d3471ec')
-    #
-    # @param [required, String] :user_id The user_id of the user to list conversations for
-    #
-    # @param [String] :state Must be one of ['INVITED', 'JOINED', 'LEFT']
-    #
-    # @param [String] :order_by Must be one of ['created', 'custom_sort_key']
-    #
-    # @param [Boolean] :include_custom_data
-    # @param [String] :date_start
-    #   Return the records that occurred after this point in time.
-    #
-    # @param [String] :date_start
-    #   Return the records that occurred after this point in time.
-    #
-    # @param [Integer] :page_size
-    #   Return this amount of records in the response.
-    #
-    # @param ['asc', 'desc'] :order
-    #   Return the records in ascending or descending order.
-    #
-    # @param [String] :cursor
-    #   The cursor to start returning results from.
-    #
-    # @return [Conversation::User::ConversationsListResponse]
-    #
-    # @see https://developer.vonage.com/en/api/conversation#getuserConversations
-    #
-    def list_conversations(user_id:, **params)
-      request("/v1/users/#{user_id}/conversations", params: params, response_class: ConversationsListResponse)
-    end
-
-    # List conversations associated with a user.
-    #
-    # @example
-    #   response = client.conversation.user.list_sessions(user_id: 'USR-82e028d9-5201-4f1e-8188-604b2d3471ec')
-    #
-    # @param [required, String] :user_id The user_id of the user to list sessions for
-    #
-    # @param [Integer] :page_size
-    #   Return this amount of records in the response.
-    #
-    # @param ['asc', 'desc'] :order
-    #   Return the records in ascending or descending order.
-    #
-    # @param [String] :cursor
-    #   The cursor to start returning results from.
-    #
-    # @return [Conversation::User::SessionsListResponse]
-    #
-    # @see https://developer.vonage.com/en/api/conversation#getuserSessions
-    #
-    def list_sessions(user_id:, **params)
-      request("/v1/users/#{user_id}/sessions", params: params, response_class: SessionsListResponse)
-    end
-  end
-end

data/lib/vonage/conversation.rb

@@ -1,164 +0,0 @@
-# typed: strict
-# frozen_string_literal: true
-
-module Vonage
-  class Conversation < Namespace
-    extend T::Sig
-
-    self.authentication = BearerToken
-
-    self.request_body = JSON
-
-    # List conversations associated with a Vonage application.
-    #
-    # @example
-    #   response = client.conversation.list
-    #
-    # @param [String] :date_start
-    #   Return the records that occurred after this point in time.
-    #
-    # @param [String] :date_end
-    #   Return the records that occurred before this point in time.
-    #
-    # @param [Integer] :page_size
-    #   Return this amount of records in the response.
-    #
-    # @param ['asc', 'desc'] :order
-    #   Return the records in ascending or descending order.
-    #
-    # @param [String] :cursor
-    #   The cursor to start returning results from.
-    #  
-    # @return [Conversation::ListResponse]
-    #
-    # @see https://developer.vonage.com/en/api/conversation#listConversations
-    #
-    def list(**params)
-      request('/v1/conversations', params: params, response_class: ListResponse)
-    end
-
-    # Create a conversation.
-    #
-    # @example
-    #   response = client.conversation.create(name: 'Example Conversation', display_name: 'Example Display Name')
-    #
-    # @param [String] :name
-    #   Your internal conversation name. Must be unique.
-    #
-    # @param [String] :display_name
-    #   The public facing name of the conversation.
-    #
-    # @param [String] :image_url
-    #   An image URL that you associate with the conversation
-    #
-    # @param [Hash] :properties
-    #   - :ttl (Integer) After how many seconds an empty conversation is deleted
-    #   - :type (String)
-    #   - :custom_sort_key (String)
-    #   - :custom_data (Hash) Custom key/value pairs to be included with conversation data
-    #
-    # @option params [Array] :numbers An array of Hashes containing number information for different channels.
-    #
-    # @option params [Hash] :callback
-    #   - @option callback :url (String)
-    #   - @option callback :event_mask (String)
-    #   - @option callback :params (Hash)
-    #     - @option params :applicationId (String)
-    #     - @option params :ncco_url (String)
-    #   - @option callback :method (String) Must be one of ['POST', 'GET']
-    #
-    # @return [Response]
-    #
-    # @see https://developer.vonage.com/en/api/conversation#createConversation
-    #
-    def create(**params)
-      request('/v1/conversations', params: params, type: Post)
-    end
-
-    # Retrieve a conversation.
-    #
-    # @example
-    #   response = client.conversation.find(conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a')
-    #
-    # @param [String] :conversation_id
-    #
-    # @return [Response]
-    #
-    # @see https://developer.vonage.com/en/api/conversation#retrieveConversation
-    #
-    def find(conversation_id:)
-      request("/v1/conversations/#{conversation_id}")
-    end
-
-    # Update a conversation.
-    #
-    # @example
-    #   response = client.conversation.update(conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a', display_name: 'Updated conversation')
-    #
-    # @param [String] :name
-    #   Your internal conversation name. Must be unique.
-    #
-    # @param [String] :display_name
-    #   The public facing name of the conversation.
-    #
-    # @param [String] :image_url
-    #   An image URL that you associate with the conversation
-    #
-    # @param [Hash] :properties
-    #   - @option properties :ttl (Integer) After how many seconds an empty conversation is deleted
-    #   - @option properties :type (String)
-    #   - @option properties :custom_sort_key (String)
-    #   - @option properties :custom_data (Hash) Custom key/value pairs to be included with conversation data
-    #
-    # @param [Array] :numbers An array of Hashes containing number information for different channels.
-    #
-    # @option params [Hash] :callback
-    #   - @option callback :url (String)
-    #   - @option callback :event_mask (String)
-    #   - @option callback :params (Hash)
-    #     - @option params :applicationId (String)
-    #     - @option params :ncco_url (String)
-    #   - @option callback :method (String) Must be one of ['POST', 'GET']
-    #
-    # @return [Response]
-    #
-    # @see https://developer.vonage.com/en/api/conversation#replaceConversation
-    #
-    def update(conversation_id:, **params)
-      request("/v1/conversations/#{conversation_id}", params: params, type: Put)
-    end
-
-    # Delete a conversation.
-    #
-    # @example
-    #   response = client.conversation.delete(conversation_id: 'CON-d66d47de-5bcb-4300-94f0-0c9d4b948e9a')
-    #
-    # @param [String] :conversation_id
-    #
-    # @return [Response]
-    #
-    # @see https://developer.vonage.com/en/api/conversation#deleteConversation
-    #
-    def delete(conversation_id:)
-      request("/v1/conversations/#{conversation_id}", type: Delete)
-    end
-
-    # @return [Conversation::User]
-    sig { returns(T.nilable(Vonage::Conversation::User)) }
-    def user
-      @user ||= User.new(@config)
-    end
-
-    # @return [Conversation::Member]
-    sig { returns(T.nilable(Vonage::Conversation::Member)) }
-    def member
-      @member ||= Member.new(@config)
-    end
-
-    # @return [Conversation::Event]
-    sig { returns(T.nilable(Vonage::Conversation::Event)) }
-    def event
-      @event ||= Event.new(@config)
-    end
-  end
-end

data/lib/vonage/meetings/applications.rb

@@ -1,28 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-
-module Vonage
-  class Meetings::Applications < Namespace
-    extend T::Sig
-
-    self.authentication = BearerToken
-
-    self.request_body = JSON
-
-    self.host = :vonage_host
-
-    # Update an existing application.
-    #
-    # @deprecated
-    #
-    # @param [required, String] :default_theme_id The id of the theme to set as application default theme
-    #
-    # @return [Response]
-    #
-    # @see https://developer.vonage.com/en/api/meetings#updateApplication
-    def update(default_theme_id:)
-      logger.info('This method is deprecated and will be removed in a future release.')
-      request("/v1/meetings/applications", params: {update_details: {default_theme_id: default_theme_id}}, type: Patch)
-    end
-  end
-end

data/lib/vonage/meetings/dial_in_numbers/list_response.rb

@@ -1,11 +0,0 @@
-# typed: true
-
-class Vonage::Meetings::DialInNumbers::ListResponse < Vonage::Response
-  include Enumerable
-
-  def each
-    return enum_for(:each) unless block_given?
-
-    @entity.each { |item| yield item }
-  end
-end

data/lib/vonage/meetings/dial_in_numbers.rb

@@ -1,26 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-
-module Vonage
-  class Meetings::DialInNumbers < Namespace
-    extend T::Sig
-
-    self.authentication = BearerToken
-
-    self.request_body = JSON
-
-    self.host = :vonage_host
-
-    # Get numbers that can be used to dial into a meeting.
-    #
-    # @deprecated
-    #
-    # @return [ListResponse]
-    #
-    # @see https://developer.vonage.com/en/api/meetings#getDialInNumbers
-    def list
-      logger.info('This method is deprecated and will be removed in a future release.')
-      request("/v1/meetings/dial-in-numbers", response_class: ListResponse)
-    end
-  end
-end

data/lib/vonage/meetings/recordings.rb

@@ -1,42 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-
-module Vonage
-  class Meetings::Recordings < Namespace
-    extend T::Sig
-
-    self.authentication = BearerToken
-
-    self.request_body = JSON
-
-    self.host = :vonage_host
-
-    # Return information for specified recording.
-    #
-    # @deprecated
-    #
-    # @param [required, String] recording_id The id of the recoring for which the info should be returned
-    #
-    # @return [Response]
-    #
-    # @see https://developer.vonage.com/en/api/meetings#getRecording
-    def info(recording_id:)
-      logger.info('This method is deprecated and will be removed in a future release.')
-      request("/v1/meetings/recordings/" + recording_id)
-    end
-
-    # Delete a specified recording.
-    #
-    # @deprecated
-    #
-    # @param [required, String] recording_id The id of the recoring to be deleted
-    #
-    # @return [Response]
-    #
-    # @see https://developer.vonage.com/en/api/meetings#deleteRecording
-    def delete(recording_id:)
-      logger.info('This method is deprecated and will be removed in a future release.')
-      request("/v1/meetings/recordings/" + recording_id, type: Delete)
-    end
-  end
-end

data/lib/vonage/meetings/rooms/list_response.rb

@@ -1,11 +0,0 @@
-# typed: true
-
-class Vonage::Meetings::Rooms::ListResponse < Vonage::Response
-  include Enumerable
-
-  def each
-    return enum_for(:each) unless block_given?
-
-    @entity._embedded.each { |item| yield item }
-  end
-end

data/lib/vonage/meetings/rooms.rb

@@ -1,167 +0,0 @@
-# typed: true
-# frozen_string_literal: true
-
-module Vonage
-  class Meetings::Rooms < Namespace
-    extend T::Sig
-
-    self.authentication = BearerToken
-
-    self.request_body = JSON
-
-    self.host = :vonage_host
-
-    # Get a list of rooms associated with the Vonage application.
-    #
-    # @deprecated
-    #
-    # @param [optional, Integer] :start_id
-    #
-    # @param [optional, Integer] :end_id
-    #
-    # @param [optional, Integer] :page_size
-    #
-    # @return [ListResponse]
-    #
-    # @see https://developer.vonage.com/en/api/meetings#getRooms
-    def list(**params)
-      logger.info('This method is deprecated and will be removed in a future release.')
-      path = "/v1/meetings/rooms"
-      path += "?#{Params.encode(params)}" unless params.empty?
-
-      request(path, response_class: ListResponse)
-    end
-
-    # Return information for specified room.
-    #
-    # @deprecated
-    #
-    # @param [required, String] room_id
-    #   The id of the room for which the info should be returned
-    #
-    # @return [Response]
-    #
-    # @see https://developer.vonage.com/en/api/meetings#getRoom
-    def info(room_id:)
-      logger.info('This method is deprecated and will be removed in a future release.')
-      request("/v1/meetings/rooms/" + room_id)
-    end
-
-    # Create a new room.
-    #
-    # @deprecated
-    #
-    # @param [required, String] :display_name
-    #
-    # @param [optional, String] :metadata
-    #   Free text that can be attached to a room. This will be passed in the form of a header in events related to this room.
-    #
-    # @param [optional, String] :type
-    #   The type of room. Must be one of `instant` (the default) or `long_term`.
-    #
-    # @param [String(date)] :expires_at
-    #   The time for when the room will be expired, expressed in ISO 8601 format.
-    #   The value must be greater than 10 minutes from now.
-    #   Must be set if `type` is `long_term`. Should not be set if `type` is `instant`
-    #
-    # @param [optional, Boolean] :expire_after_use
-    #   Close the room after a session ends. Only relevant for rooms where the `type` is `long_term`
-    #
-    # @param [optional, string(uuid)] :theme_id
-    #   When specified, the meeting room will use the theme indicated by the ID.
-    #
-    # @param [optional, String] :join_approval_level
-    #   The level of approval needed to join the meeting in the room. Must be one of: `none`, `after_owner_only`, `explicit_approval`
-    #
-    # @param [optional, Hash] :recording_options
-    #   @option :recording_options [Boolean] :auto_record Automatically record all sessions in this room. Recording cannot be stopped when this is set to `true`.
-    #   @option :recording_options [Boolean] :record_only_owner Record only the owner screen or any share screen of the video.
-    #
-    # @param [optional, Hash] :initial_join_options
-    #   @option :initial_join_options [String] :microphone_state
-    #     Set the default microphone option for users in the pre-join screen of this room.
-    #     Must be one of: `on`, `off`, `default`
-    #
-    # @param [optional, Hash] :callback_urls Provides callback URLs to listen to events. If specified, over-rides the callback URLs specified at Application-level
-    #   @option :callback_urls [String] :rooms_callback_url Callback url for rooms events
-    #   @option :callback_urls [String] :sessions_callback_url Callback url for sessions events
-    #   @option :callback_urls [String] :recordings_callback_url Callback url for recordings events
-    #
-    # @param [optional, Hash] :available_features
-    #   @option :available_features [Boolean] :is_recording_available Determine if recording feature is available in the UI (default `true`)
-    #   @option :available_features [Boolean] :is_chat_available Determine if chat feature is available in the UI (default `true`)
-    #   @option :available_features [Boolean] :is_whiteboard_available Determine if whiteboard feature is available in the UI (default `true`)
-    #   @option :available_features [Boolean] :is_locale_switcher_available Determine if locale switche feature is available in the UI (default `true`)
-    #   @option :available_features [Boolean] :is_captions_available Determine if captions feature is available in the UI
-    #
-    # @param [optional, Hash] :ui_settings Provides options to customize the user interface
-    #   @option :ui_settings [String] :language
-    #     The desired language of the UI. The default is `en` (English).
-    #     Must be one of: `ar`, `pt-br`, `ca`, `zh-tw`, `zh-cn`, `en`, `fr`, `de`, `he`, `it`, `es`
-    #
-    # @return [Response]
-    #
-    # @see https://developer.vonage.com/en/api/meetings#createRoom
-    def create(display_name:, **params)
-      logger.info('This method is deprecated and will be removed in a future release.')
-      request(
-        "/v1/meetings/rooms",
-        params: params.merge({ display_name: display_name }),
-        type: Post
-      )
-    end
-
-    # Update an existing room.
-    # Although paramaters (other than `room_id`) are optional, at least one other parameter must be provided or an error
-    #   response will be received.
-    #
-    # @deprecated
-    #
-    # @param [required, String] room_id The ID of the Room to be updated
-    #
-    # @param [optional, String(date)] :expires_at
-    #   The time for when the room will be expired, expressed in ISO 8601 format.
-    #   Only relevant for rooms where the `type` is `long_term``
-    #
-    # @param [optional, Boolean] :expire_after_use
-    #   Close the room after a session ends. Only relevant for rooms where the `type` is `long_term`
-    #
-    # @param [optional, string(uuid)] :theme_id
-    #   When specified, the meeting room will use the theme indicated by the ID.
-    #
-    # @param [optional, String] :join_approval_level
-    #   The level of approval needed to join the meeting in the room. Must be one of: `none`, `after_owner_only`, `explicit_approval`
-    #
-    # @param [optional, Hash] :initial_join_options
-    #   @option :initial_join_options [String] :microphone_state
-    #     Set the default microphone option for users in the pre-join screen of this room.
-    #     Must be one of: `on`, `off`, `default`
-    #
-    # @param [optional, Hash] :callback_urls Provides callback URLs to listen to events. If specified, over-rides the callback URLs specified at Application-level
-    #   @option :callback_urls [String] :rooms_callback_url Callback url for rooms events
-    #   @option :callback_urls [String] :sessions_callback_url Callback url for sessions events
-    #   @option :callback_urls [String] :recordings_callback_url Callback url for recordings events
-    #
-    # @param [optional, Hash] :available_features
-    #   @option :available_features [Boolean] :is_recording_available Determine if recording feature is available in the UI (default `true`)
-    #   @option :available_features [Boolean] :is_chat_available Determine if chat feature is available in the UI (default `true`)
-    #   @option :available_features [Boolean] :is_whiteboard_available Determine if whiteboard feature is available in the UI (default `true`)
-    #   @option :available_features [Boolean] :is_locale_switcher_available Determine if locale switche feature is available in the UI (default `true`)
-    #   @option :available_features [Boolean] :is_captions_available Determine if captions feature is available in the UI
-    #
-    # @return [Response]
-    #
-    # @see https://developer.vonage.com/en/api/meetings#updateRoom
-    def update(room_id:, **params)
-      logger.info('This method is deprecated and will be removed in a future release.')
-      raise ArgumentError, 'must provide at least one other param in addition to :room_id' if params.empty?
-      request(
-        "/v1/meetings/rooms/" + room_id,
-        params: {
-          update_details: params
-        },
-        type: Patch
-      )
-    end
-  end
-end

data/lib/vonage/meetings/sessions/list_response.rb

@@ -1,11 +0,0 @@
-# typed: true
-
-class Vonage::Meetings::Sessions::ListResponse < Vonage::Response
-  include Enumerable
-
-  def each
-    return enum_for(:each) unless block_given?
-
-    @entity._embedded.recordings.each { |item| yield item }
-  end
-end