vonage 7.17.0 → 7.19.0.exp.0.1.0

data/lib/vonage/video/streams.rb

@@ -0,0 +1,70 @@
+# typed: true
+# frozen_string_literal: true
+
+module Vonage
+  class Video::Streams < Namespace
+
+    self.authentication = BearerToken
+
+    self.request_body = JSON
+
+    self.host = :video_host
+
+    # Get a list of streams for a specified session.
+    #
+    # @param [optional, String] :application_id (Required unless already set at Client instantiation or set in ENV)
+    #
+    # @param [required, String] :session_id
+    #
+    # TODO: add auto_advance option
+    #
+    # @return [ListResponse]
+    #
+    # @see TODO: add docs link
+    #
+    def list(session_id:)
+      request('/v2/project/' + @config.application_id + '/session/' + session_id + '/stream', response_class: ListResponse)
+    end
+
+    # Get information about a specified stream.
+    #
+    # @param [optional, String] :application_id (Required unless already set at Client instantiation or set in ENV)
+    #
+    # @param [required, String] :session_id
+    #
+    # @param [required, String] :stream_id
+    #
+    # @return [Response]
+    #
+    # @see TODO: add docs link
+    #
+    def info(session_id:, stream_id:)
+      request('/v2/project/' + @config.application_id + '/session/' + session_id + '/stream/' + stream_id)
+    end
+
+    # Change the layout for a list of specified streams.
+    #
+    # @param [optional, String] :application_id (Required unless already set at Client instantiation or set in ENV)
+    #
+    # @param [required, String] :session_id
+    #
+    # @param [optional, Array<Hash>] :items An array of hashes representing streams and the layout classes for those streams
+    #
+    # @option items [required, String] :id The stream ID
+    #
+    # @option items [required, Array<String>] :layoutClassList Array of CSS class names as strings
+    #
+    # @return [Response]
+    #
+    # @see TODO: add docs link
+    #
+    def change_layout(session_id:, **params)
+      # TODO camelcase layout_class_list
+      # if params[:items]
+      #   params[:items] = params[:items].map {|item| camelcase(item)}
+      # end
+
+      request('/v2/project/' + @config.application_id + '/session/' + session_id + '/stream', params: params, type: Put)
+    end
+  end
+end

data/lib/vonage/video.rb

@@ -0,0 +1,109 @@
+# typed: true
+# frozen_string_literal: true
+
+module Vonage
+  class Video < Namespace
+    include Keys
+
+    self.authentication = BearerToken
+
+    self.host = :video_host
+
+    # Generate a new session.
+    #
+    # @example
+    #   session = client.video.create_session({
+    #     archive_mode: 'always',
+    #     location: '10.1.200.30',
+    #     media_mode: 'routed'
+    #   })
+    #
+    # @params [optional, String] :archive_mode (either 'always' or 'manual')
+    #
+    # @param [optional, String] :location
+    #
+    # @params [optional, String] :media_mode (either 'routed' or 'relayed')
+    #
+    # @return [Response]
+    #
+    # @see TODO: Add document link here
+    #
+    def create_session(**params)
+      request_params = params.clone
+      request_params[:archive_mode] ||= 'manual'
+      media_mode = request_params.delete(:media_mode) || 'routed'
+
+      if media_mode == 'relayed' && request_params[:archive_mode] == 'manual'
+        request_params['p2p.preference'] = 'enabled'
+      else
+        request_params['p2p.preference'] = 'disabled'
+      end
+
+      response = request('/session/create', params: camelcase(request_params), type: Post)
+
+      public_response_data = {
+        session_id: response.entity.first.session_id,
+        archive_mode: request_params[:archive_mode],
+        media_mode: media_mode,
+        location: request_params[:location]
+      }
+
+      entity = Entity.new(public_response_data)
+
+      response.class.new(entity, response.http_response)
+    end
+
+    def generate_client_token(session_id:, scope: 'session.connect', role: 'publisher', **params)
+      claims = {
+        application_id: @config.application_id,
+        scope: scope,
+        session_id: session_id,
+        role: role,
+        initial_layout_class_list: '',
+        sub: 'video',
+        acl: {
+          paths: {'/session/**' => {}}
+        }
+      }
+
+
+      claims[:data] = params[:data] if params[:data]
+      claims[:initial_layout_class_list] = params[:initial_layout_class_list].join(' ') if params[:initial_layout_class_list]
+      claims[:exp] = params[:expire_time].to_i if params[:expire_time]
+
+      JWT.generate(claims, @config.private_key)
+    end
+
+    # @return [Archives]
+    #
+    def archives
+      @archives ||= Archives.new(@config)
+    end
+
+    # @return [Broadcasts]
+    #
+    def broadcasts
+      @broadcasts ||= Broadcasts.new(@config)
+    end
+
+    # @return [Moderation]
+    #
+    def moderation
+      @moderation ||= Moderation.new(@config)
+    end
+
+    # @return [Signals]
+    #
+    def signals
+      @signals ||= Signals.new(@config)
+    end
+
+    # @return [Streams]
+    #
+    def streams
+      @streams ||= Streams.new(@config)
+    end
+
+
+  end
+end

data/lib/vonage/voice/actions/conversation.rb

@@ -1,7 +1,7 @@
 # typed: true
 # frozen_string_literal: true
- 
- module Vonage 
+
+module Vonage
   class Voice::Actions::Conversation
     attr_accessor :name, :musicOnHoldUrl, :startOnEnter, :endOnExit, :record, :canSpeak, :canHear, :mute
 

data/lib/vonage/voice.rb

@@ -279,5 +279,16 @@ module Vonage
     def dtmf
       @dtmf ||= DTMF.new(@config)
     end
+
+    # Validate a JSON Web Token from a Voice API Webhook.
+    #
+    # @param [String, required] :token The JWT from the Webhook's Authorization header
+    # @param [String, optional] :signature_secret The account signature secret. Required, unless `signature_secret`
+    #   is set in `Config`
+    #
+    # @return [Boolean] true, if the JWT is verified, false otherwise
+    def verify_webhook_token(token:, signature_secret: @config.signature_secret)
+      JWT.verify_hs256_signature(token: token, signature_secret: signature_secret)
+    end
   end
 end

data/lib/vonage.rb

@@ -13,6 +13,7 @@ module Vonage
     'http' => 'HTTP',
     'json' => 'JSON',
     'jwt' => 'JWT',
+    'sip' => 'SIP',
     'sms' => 'SMS',
     'mms' => 'MMS',
     'tfa' => 'TFA',

data/vonage.gemspec

@@ -12,10 +12,11 @@ Gem::Specification.new do |s|
   s.summary = 'This is the Ruby Server SDK for Vonage APIs. To use it you\'ll need a Vonage account. Sign up for free at https://www.vonage.com'
   s.files = Dir.glob('lib/**/*.rb') + %w(LICENSE.txt README.md vonage.gemspec)
   s.required_ruby_version = '>= 2.5.0'
-  s.add_dependency('vonage-jwt', '~> 0.1.3')
+  s.add_dependency('vonage-jwt', '~> 0.2.0')
   s.add_dependency('zeitwerk', '~> 2', '>= 2.2')
   s.add_dependency('sorbet-runtime', '~> 0.5')
   s.add_dependency('multipart-post', '~> 2.0')
+  s.add_dependency('net-http-persistent', '~> 4.0', '>= 4.0.2')
   s.add_runtime_dependency('rexml')
   s.add_runtime_dependency('phonelib')
   s.require_path = 'lib'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vonage
 version: !ruby/object:Gem::Version
-  version: 7.17.0
+  version: 7.19.0.exp.0.1.0
 platform: ruby
 authors:
 - Vonage
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-23 00:00:00.000000000 Z
+date: 2024-01-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: vonage-jwt
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 0.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 0.2.0
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -72,6 +72,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: net-http-persistent
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.0.2
 - !ruby/object:Gem::Dependency
   name: rexml
   requirement: !ruby/object:Gem::Requirement
@@ -161,6 +181,7 @@ files:
 - lib/vonage/messaging/message.rb
 - lib/vonage/namespace.rb
 - lib/vonage/number_insight.rb
+- lib/vonage/number_insight_2.rb
 - lib/vonage/numbers.rb
 - lib/vonage/numbers/list_response.rb
 - lib/vonage/numbers/response.rb
@@ -205,6 +226,16 @@ files:
 - lib/vonage/verify2/workflow.rb
 - lib/vonage/verify2/workflow_builder.rb
 - lib/vonage/version.rb
+- lib/vonage/video.rb
+- lib/vonage/video/archives.rb
+- lib/vonage/video/archives/list_response.rb
+- lib/vonage/video/broadcasts.rb
+- lib/vonage/video/broadcasts/list_response.rb
+- lib/vonage/video/moderation.rb
+- lib/vonage/video/signals.rb
+- lib/vonage/video/sip.rb
+- lib/vonage/video/streams.rb
+- lib/vonage/video/streams/list_response.rb
 - lib/vonage/voice.rb
 - lib/vonage/voice/actions/connect.rb
 - lib/vonage/voice/actions/conversation.rb
@@ -243,7 +274,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.3
 signing_key: 
 specification_version: 4
 summary: This is the Ruby Server SDK for Vonage APIs. To use it you'll need a Vonage