conversant 1.0.16

data/lib/conversant/v3/services/lms/preset.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Conversant
+  module V3
+    module Services
+      class LMS
+        # Preset service for live transcoding preset management
+        #
+        # Manages transcoding presets which define encoding parameters
+        # such as bitrate, resolution, codec settings for live streams.
+        #
+        # @example Get all transcoding presets
+        #   lms = Conversant::V3.lms(12345)
+        #
+        #   presets = lms.preset.all
+        #   presets.each do |preset|
+        #     puts "#{preset['name']}: #{preset['resolution']} @ #{preset['bitrate']}"
+        #   end
+        #
+        # @since 1.0.8
+        class Preset
+          # @return [LMS] the parent LMS service instance
+          attr_reader :parent
+
+          # Initialize preset service
+          #
+          # @param parent [LMS] the parent LMS service instance
+          def initialize(parent)
+            @parent = parent
+          end
+
+          # Get all available transcoding presets
+          #
+          # Retrieves the list of transcoding presets configured for the customer,
+          # including encoding parameters like resolution, bitrate, codec settings.
+          #
+          # @return [Array<Hash>] array of preset configurations, or empty array on error
+          #
+          # @example Get all presets
+          #   presets = lms.preset.all
+          #   presets.each do |preset|
+          #     puts "#{preset['name']}: #{preset['resolution']} @ #{preset['bitrate']}"
+          #   end
+          #
+          # @since 1.0.8
+          def all
+            response = JSON.parse(@parent.send(:call, 'GET', '/live/preset/list_page'))
+            response&.[]('list') || []
+          rescue StandardError => e
+            @parent.send(:logger).error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
+            []
+          end
+        end
+      end
+    end
+  end
+end

data/lib/conversant/v3/services/lms.rb

@@ -0,0 +1,173 @@
+# frozen_string_literal: true
+
+require_relative 'authorization'
+
+module Conversant
+  module V3
+    module Services
+      # Live Media Streaming (LMS) service for managing streaming operations
+      #
+      # Provides comprehensive functionality for live streaming management including:
+      # - Job management for streaming operations
+      # - Domain configuration for streaming endpoints
+      # - Dashboard metrics and monitoring
+      #
+      # @example Basic usage
+      #   lms = Conversant::V3.lms(12345)
+      #
+      #   # Get streaming jobs
+      #   jobs = lms.job.where(status: 'active')
+      #
+      #   # Get dashboard metrics
+      #   live_metrics = lms.dashboard.live
+      #
+      # @since 1.0.0
+      class LMS < ::Conversant::V3::Base
+        include Authorization
+        # Get job management service instance
+        #
+        # @return [Job] job service for streaming job management
+        # @since 1.0.0
+        def job
+          @job ||= Job.new(self)
+        end
+
+        # Get domain management service instance
+        #
+        # @return [Domain] domain service for streaming domain management
+        # @since 1.0.0
+        def domain
+          @domain ||= Domain.new(self)
+        end
+
+        # Get dashboard metrics service instance
+        #
+        # @return [Dashboard] dashboard service for streaming metrics
+        # @since 1.0.0
+        def dashboard
+          @dashboard ||= Dashboard.new(self)
+        end
+
+        # Get preset service instance
+        #
+        # @return [Preset] preset service for transcoding configuration
+        # @since 1.0.8
+        def preset
+          @preset ||= Preset.new(self)
+        end
+
+        # Get partner service instance
+        #
+        # Provides access to partner-level analytics for Live Media Streaming
+        # that aggregate data across multiple customer accounts.
+        #
+        # @return [Partner] partner service for LMS analytics
+        # @since 1.0.12
+        #
+        # @example Access partner analytics
+        #   lms = Conversant::V3.lms(12345)
+        #   duration = lms.partner.analytics.duration(payload)
+        def partner
+          @partner ||= Partner.new(self)
+        end
+
+        # @deprecated Use {#partner} instead
+        # Get partner analytics service instance (deprecated)
+        #
+        # @return [LMS::Partner::Analytics] partner analytics for LMS reporting
+        # @since 1.0.8
+        # @deprecated Use `lms.partner.analytics` instead of `lms.partner_analytics`
+        def partner_analytics
+          @partner_analytics ||= Partner::Analytics.new(self)
+        end
+
+        protected
+
+        def call(method, uri, payload = nil)
+          url = "#{configuration.private_lms_endpoint}#{uri}"
+
+          headers = authorized_headers
+
+          # Check for JSESSIONID in Cookie header
+          if headers['Cookie'].nil? || !headers['Cookie'].include?('JSESSIONID=')
+            logger.error "#{identifier}.METHOD:call.NO_JSESSIONID"
+            raise AuthenticationError, 'Missing JSESSIONID for LMS'
+          end
+
+          code, response = request(method, url, payload, headers)
+
+          if code >= 400
+            logger.error "#{identifier}.METHOD:call.HTTP_ERROR:#{code}"
+            raise ApiError, "LMS API error: #{code}"
+          end
+
+          response.body
+        end
+
+        protected
+
+        def service_endpoint
+          configuration.private_lms_endpoint
+        end
+
+        def session_cookie_name
+          'JSESSIONID'
+        end
+
+        def requires_session?
+          true
+        end
+
+        private
+
+        def fetch_new_session
+          sessions = authenticate
+          return nil unless sessions && sessions[:session] && sessions[:sso_gw_session2]
+
+          timestamp = (Time.now.to_f * 1000).to_i
+          reporting_url = "#{configuration.private_lms_endpoint}/?customerId=#{customer_id}&isHideMenu=f&t=#{timestamp}"
+
+          logger.debug "#{identifier}.METHOD:authorize.REQUESTING_JSESSIONID"
+
+          response = RestClient.get(
+            reporting_url,
+            {
+              authority: URI.parse(configuration.private_lms_endpoint).hostname,
+              referer: portal_endpoint,
+              user_agent: configuration.default_ua,
+              cookies: {
+                'SESSION': sessions[:session],
+                'SSO_GW_SESSION2': sessions[:sso_gw_session2]
+              },
+              timeout: 30,
+              open_timeout: 30
+            }
+          )
+
+          if response.cookies['JSESSIONID']
+            jsessionid = response.cookies['JSESSIONID']
+            redis.set(session_cache_key, jsessionid, ex: configuration.cache_ttl)
+            logger.debug "#{identifier}.METHOD:authorize.JSESSIONID_OBTAINED"
+            jsessionid
+          else
+            logger.error "#{identifier}.METHOD:authorize.NO_JSESSIONID_IN_RESPONSE"
+            nil
+          end
+        rescue RestClient::Unauthorized, RestClient::Forbidden => e
+          logger.error "#{identifier}.METHOD:authorize.AUTH_ERROR:#{e.message}"
+          nil
+        rescue StandardError => e
+          logger.error "#{identifier}.METHOD:authorize.ERROR:#{e.message}"
+          nil
+        end
+      end
+    end
+  end
+end
+
+# Load nested service classes after LMS is defined
+require_relative 'lms/job'
+require_relative 'lms/domain'
+require_relative 'lms/dashboard'
+require_relative 'lms/preset'
+require_relative 'lms/partner'

data/lib/conversant/v3/services/oss/partner/analytics.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+module Conversant
+  module V3
+    module Services
+      class OSS
+        class Partner
+          # OSS (Object Storage Service) analytics for partner-level reporting
+          #
+          # Provides partner-level analytics and reporting for Object Storage Service
+          # including storage usage metrics for S3-compatible storage across multiple
+          # customer accounts.
+          #
+          # @since 1.0.12
+          class Analytics
+            # @return [Conversant::V3::Services::OSS] the parent OSS service instance
+            attr_reader :parent
+
+            # Initialize partner OSS analytics service
+            #
+            # Note: OSS analytics uses the CDN service endpoint for API calls.
+            #
+            # @param parent [Conversant::V3::Services::OSS] the parent OSS service instance
+            def initialize(parent)
+              @parent = parent
+            end
+
+            # Get storage usage metrics for OSS (full year data)
+            #
+            # Retrieves Object Storage Service usage data including storage capacity,
+            # bandwidth usage, and request counts aggregated by month for billing
+            # and capacity planning purposes. Returns all months for the specified year.
+            #
+            # @param year [String, Integer] year in YYYY format
+            # @param params [Hash] optional query parameters
+            # @option params [String] :end end date for the report
+            #
+            # @return [Array<Hash>] array of monthly storage usage data, or empty array on error
+            #
+            # @example Get OSS storage usage for a year
+            #   usages = oss.partner.analytics.usages("2025")
+            #   usages.each do |month|
+            #     puts "#{month['month']}: #{month['diskUsage']} bytes"
+            #   end
+            #
+            # @since 1.0.8
+            def usages(year, params = {})
+              query_string = params.map { |k, v| "#{k}=#{v}" }.join('&')
+              uri = "/oss/storage_usages/#{year}"
+              uri += "?#{query_string}" unless query_string.empty?
+              response = @parent.send(:call, 'GET', uri)
+              JSON.parse(response) || []
+            rescue StandardError => e
+              @parent.send(:logger).error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
+              []
+            end
+
+            # Get storage usage for current month
+            #
+            # Retrieves disk usage for the month containing the specified date (or current month).
+            # This is useful for getting current month's storage usage for billing purposes.
+            #
+            # @param payload [Hash] Parameters for the usage query
+            # @option payload [Date, String, Time] :end End date for the query (defaults to current date)
+            #
+            # @return [Integer, nil] Disk usage in bytes, or nil on error
+            #
+            # @example Get current month's storage usage
+            #   usage = oss.partner.analytics.current_month_usage
+            #   puts "Current usage: #{usage / 1_073_741_824.0} GB"
+            #
+            # @example Get specific month's storage usage
+            #   usage = oss.partner.analytics.current_month_usage(end: '2025-04-30')
+            #   puts "April 2025 usage: #{usage / 1_073_741_824.0} GB"
+            #
+            # @since 1.0.12
+            def current_month_usage(payload = {})
+              require 'date'
+
+              # Extract the end date from the payload, defaulting to the current date
+              today = if payload.[](:end) || payload.[]('end')
+                        (payload[:end] || payload['end']).to_date
+                      else
+                        Date.today
+                      end
+
+              # Fetch storage usage data for the year containing the end date
+              yearly_data = usages(today.year.to_s)
+              return 0 if yearly_data.nil? || yearly_data.empty?
+
+              # Find the storage usage for the specific month
+              today_month_format = today.strftime('%Y-%m')
+              month_data = yearly_data.find { |item| item&.[]('month') == today_month_format }
+
+              month_data&.[]('diskUsage') || 0
+            rescue StandardError => e
+              @parent.send(:logger).error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
+              nil
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/conversant/v3/services/oss/partner.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Conversant
+  module V3
+    module Services
+      class OSS
+        # Partner service for OSS partner-level operations
+        #
+        # Provides access to partner-level analytics for Object Storage Service
+        # that aggregate data across multiple customer accounts.
+        #
+        # @example Access partner analytics
+        #   oss = Conversant::V3.oss(12345)
+        #
+        #   # Partner-level OSS storage analytics
+        #   usages = oss.partner.analytics.usages("2025", end: "2025-12-31")
+        #   puts "Total storage: #{usages['total_storage']} GB"
+        #
+        # @since 1.0.12
+        class Partner
+          # @return [OSS] the parent OSS service instance
+          attr_reader :parent
+
+          # Initialize partner service
+          #
+          # @param parent [OSS] the parent OSS service instance
+          def initialize(parent)
+            @parent = parent
+          end
+
+          # Get partner analytics service instance
+          #
+          # Provides partner-level analytics for OSS services including storage
+          # usage, capacity metrics, and bandwidth across multiple customers.
+          #
+          # @return [Analytics] OSS partner analytics service
+          # @since 1.0.12
+          def analytics
+            @analytics ||= Analytics.new(@parent)
+          end
+        end
+      end
+    end
+  end
+end
+
+# Load nested analytics class after Partner is defined
+require_relative 'partner/analytics'

data/lib/conversant/v3/services/oss.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+require_relative 'authorization'
+
+module Conversant
+  module V3
+    module Services
+      # Object Storage Service (OSS) for S3-compatible storage operations
+      #
+      # Provides comprehensive functionality for object storage operations including:
+      # - Storage usage metrics and analytics
+      # - Partner-level reporting across multiple customers
+      # - Capacity planning and billing data
+      #
+      # @example Basic usage
+      #   oss = Conversant::V3.oss(12345)
+      #
+      #   # Get storage usage for a year
+      #   usages = oss.partner.analytics.usages("2025")
+      #
+      # @since 1.0.12
+      class OSS < ::Conversant::V3::Base
+        include Authorization
+
+        # Get partner service instance
+        #
+        # Provides access to partner-level analytics for Object Storage Service
+        # that aggregate data across multiple customer accounts.
+        #
+        # @return [Partner] partner service for OSS analytics
+        # @since 1.0.12
+        #
+        # @example Access partner analytics
+        #   oss = Conversant::V3.oss(12345)
+        #   usages = oss.partner.analytics.usages("2025")
+        def partner
+          @partner ||= Partner.new(self)
+        end
+
+        protected
+
+        def call(method, uri, payload = nil)
+          # OSS API calls use PRIVATE_OSS_ENDPOINT
+          url = "#{configuration.private_oss_endpoint}#{uri}"
+
+          # Get authorized headers (SESSION cookie from OSS)
+          headers = authorized_headers
+
+          # Check for SESSION in Cookie header
+          if headers['Cookie'].nil? || !headers['Cookie'].include?('SESSION=')
+            logger.error "#{identifier}.METHOD:call.NO_SESSION"
+            raise AuthenticationError, 'Missing SESSION for OSS'
+          end
+
+          code, response = request(method, url, payload, headers)
+
+          if code >= 400
+            logger.error "#{identifier}.METHOD:call.HTTP_ERROR:#{code}"
+            raise ApiError, "OSS API error: #{code}"
+          end
+
+          response.body
+        end
+
+        private
+
+        def fetch_new_session
+          sessions = authenticate
+          return nil unless sessions && sessions[:session] && sessions[:sso_gw_session2]
+
+          # OSS has its own authorization URL
+          timestamp = (Time.now.to_f * 1000).to_i
+          signature_url = "#{configuration.private_oss_endpoint}/?customerId=#{customer_id}&isHideMenu=f&t=#{timestamp}"
+          logger.debug "#{identifier}.METHOD:authorize.REQUESTING_SESSION"
+
+          response = RestClient.get(
+            signature_url,
+            {
+              authority: URI.parse(configuration.private_oss_endpoint).hostname,
+              referer: portal_endpoint,
+              user_agent: configuration.default_ua,
+              cookies: {
+                'SESSION': sessions[:session],
+                'SSO_GW_SESSION2': sessions[:sso_gw_session2]
+              },
+              timeout: 30,
+              open_timeout: 30
+            }
+          )
+
+          if response.cookies['SESSION']
+            session_cookie = response.cookies['SESSION']
+            redis.set(session_cache_key, session_cookie, ex: configuration.cache_ttl)
+            logger.debug "#{identifier}.METHOD:authorize.SESSION_OBTAINED"
+            session_cookie
+          else
+            logger.error "#{identifier}.METHOD:authorize.NO_SESSION_IN_RESPONSE"
+            nil
+          end
+        rescue RestClient::Unauthorized, RestClient::Forbidden => e
+          logger.error "#{identifier}.METHOD:authorize.AUTH_ERROR:#{e.message}"
+          nil
+        rescue StandardError => e
+          logger.error "#{identifier}.METHOD:authorize.ERROR:#{e.message}"
+          nil
+        end
+
+        protected
+
+        def service_endpoint
+          # OSS uses its own endpoint for both authentication and API calls
+          configuration.private_oss_endpoint
+        end
+
+        def session_cookie_name
+          'SESSION'
+        end
+
+        def requires_session?
+          true
+        end
+      end
+    end
+  end
+end
+
+# Load nested service classes after OSS is defined
+require_relative 'oss/partner'

data/lib/conversant/v3/services/portal/dashboard.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+module Conversant
+  module V3
+    module Services
+      class Portal
+        # Dashboard service for Portal customer metadata and reporting
+        #
+        # Provides access to customer-related metadata including product usage,
+        # geographic distribution, industry classification, and organizational hierarchy.
+        #
+        # @since 1.0.8
+        class Dashboard
+          # @return [Portal] the parent Portal service instance
+          attr_reader :parent
+
+          # Initialize dashboard service
+          #
+          # @param parent [Portal] the parent Portal service instance
+          def initialize(parent)
+            @parent = parent
+          end
+
+          # Get product usage report for a customer
+          #
+          # Retrieves information about which products (CDN, LMS, VMS, OSS) the customer
+          # is using and their usage statistics.
+          #
+          # @param params [Hash] query parameters
+          # @option params [String, Integer] :customerId customer ID
+          # @option params [Integer] :_ timestamp in milliseconds (for cache busting)
+          #
+          # @return [Hash] product report data, or empty hash on error
+          #
+          # @example Get product report
+          #   report = portal.dashboard.products(customerId: "31723", _: Time.now.to_i * 1000)
+          #   puts "CDN enabled: #{report['cdn_enabled']}"
+          #
+          # @since 1.0.8
+          def products(params = {})
+            query_string = params.map { |k, v| "#{k}=#{v}" }.join('&')
+            response = @parent.send(:call, 'GET', "/getProductReport?#{query_string}")
+            JSON.parse(response)
+          rescue StandardError => e
+            @parent.send(:logger).error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
+            {}
+          end
+
+          # Get list of countries
+          #
+          # Retrieves the list of countries available in the system, typically used
+          # for filtering or categorizing customers by geographic location.
+          #
+          # @return [Array<Hash>] array of country data, or empty array on error
+          #
+          # @example Get all countries
+          #   countries = portal.dashboard.countries
+          #   countries.each { |country| puts "#{country['name']} (#{country['code']})" }
+          #
+          # @since 1.0.8
+          def countries
+            response = @parent.send(:call, 'GET', '/getCountry')
+            JSON.parse(response)
+          rescue StandardError => e
+            @parent.send(:logger).error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
+            []
+          end
+
+          # Get list of industries
+          #
+          # Retrieves the list of industry classifications available in the system,
+          # used for categorizing customers by business sector.
+          #
+          # @return [Array<Hash>] array of industry data, or empty array on error
+          #
+          # @example Get all industries
+          #   industries = portal.dashboard.industries
+          #   industries.each { |industry| puts "#{industry['name']}" }
+          #
+          # @since 1.0.8
+          def industries
+            response = @parent.send(:call, 'GET', '/getIndustry')
+            JSON.parse(response)
+          rescue StandardError => e
+            @parent.send(:logger).error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
+            []
+          end
+
+          # Get customer organizational tree view
+          #
+          # Retrieves the hierarchical organization structure showing parent-child
+          # relationships between customers, useful for partner/reseller views.
+          #
+          # @param payload [Hash] tree view query parameters (optional)
+          #
+          # @return [Hash] tree structure data, or empty hash on error
+          #
+          # @example Get customer tree
+          #   tree = portal.dashboard.tree_view
+          #   puts "Root customers: #{tree['children'].length}"
+          #
+          # @since 1.0.8
+          def tree_view(payload = {})
+            response = @parent.send(:call, 'POST', '/customer/tree_view/', payload)
+            JSON.parse(response)
+          rescue StandardError => e
+            @parent.send(:logger).error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
+            {}
+          end
+        end
+      end
+    end
+  end
+end