conversant 1.0.19 → 1.0.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b0bd892aa072333932ee783013051c4a32fc77875c71b128a080e717bdfca10a
-  data.tar.gz: b79962fb9f3d80b38b966f9eb14e9ae9192e2e97daae9f0ba998e7cfb5a422c0
+  metadata.gz: 428022316d577c54962bff0866371094de01192f3ffd3bdb4bf163dabd7eb55f
+  data.tar.gz: 146d4c61baedbc413f96bbd86262ec893263526956ea659d2d2489cb0e44e8b8
 SHA512:
-  metadata.gz: 5f4ad35b17ed3670a73f71c0b67dc9f20ed09384e15c0c42895ff611f4817a3a1f2cbb2e4af4b534bf953a2e83e3d7a6b067afa937c5e33ec00c8f5709b1b71a
-  data.tar.gz: f47decce579d7da1b863fd8b580b5972970fd266fe623a204ef8c38f96974f6ba87928cfe7d72a7ea5fbcac671d9b72e1a838bf6707b59006c425109aebcab15
+  metadata.gz: 8cec1bf543d749082ce25aaf7a36b9c58083168d4e360b26d559571f85a7110d2572fe261d6743bd505ae2ba90facfd0a1e629e7829a0a7cb78b62ed7f47f8ec
+  data.tar.gz: 246e1ef85cb4705d8dd61e64ae125b49cbb1caf2f93aeffe9d5d0b41c5bc1ae77bfaee393ce9a8bbe46653c29494719d657534447d274ab06104a9c9f460a4ac

data/.gitignore

@@ -49,4 +49,8 @@ Gemfile.lock
 
 # Test artifacts
 /spec/cassettes/
-/spec/fixtures/vcr_cassettes/
+/spec/fixtures/vcr_cassettes/
+/.claude/
+/.repomixignore
+/CLAUDE.md
+/release-manifest.json

data/.gitlab-ci.yml

@@ -7,6 +7,16 @@ stages:
 
 variables:
   BUNDLE_PATH: vendor/bundle
+  GIT_STRATEGY: clone
+  GIT_DEPTH: "20"
+
+# Wipe runner build dir before clone — prevents stale ref conflicts
+# (e.g. "couldn't set 'refs/remotes/origin/rebases/ci'" when
+# a sibling ref like 'rebases' exists from earlier jobs).
+default:
+  hooks:
+    pre_get_sources_script:
+      - rm -rf "$CI_PROJECT_DIR/.git" || true
 
 # Cache dependencies
 cache:
@@ -19,8 +29,9 @@ cache:
 .ruby_template: &ruby_template
   image: ruby:3.0
   before_script:
-    - gem install bundler -v 2.4.0
+    - gem install bundler -v 2.4.22
     - bundle config set --local path 'vendor/bundle'
+    - mkdir -p vendor/bundle
     - bundle install --jobs $(nproc)
 
 # Run tests on multiple Ruby versions

data/.rubocop.yml

@@ -1,16 +1,53 @@
+AllCops:
+  TargetRubyVersion: 2.7
+  NewCops: disable
+  SuggestExtensions: false
+  Exclude:
+    - 'vendor/**/*'
+    - 'tmp/**/*'
+    - 'examples/**/*'   # demo scripts, not production
+    - 'spec/**/*'
+    - 'bin/**/*'
+    - 'exe/**/*'
+
+# --- Layout ---
 Layout/EndOfLine:
-  Enabled: False
+  Enabled: false
+Layout/LineLength:
+  Max: 150          # vendor API URLs / long YARD comments
+
+# --- Metrics — service classes wrap vendor APIs, tend to be long ---
 Metrics/MethodLength:
-  Max: 50
+  Max: 60
 Metrics/AbcSize:
-  Max: 50
+  Max: 70
   CountRepeatedAttributes: false
 Metrics/CyclomaticComplexity:
-  Max: 10
+  Max: 25
+Metrics/PerceivedComplexity:
+  Max: 25
 Metrics/ClassLength:
   Max: 500
+Metrics/ModuleLength:
+  Max: 300
+Metrics/BlockLength:
+  Max: 50
 Metrics/ParameterLists:
   Max: 5
   MaxOptionalParameters: 5
-Metrics/PerceivedComplexity:
-  Max: 10
+
+# --- Style — only disable cops that conflict with codebase reality ---
+Style/Documentation:
+  Enabled: false              # too many classes, low ROI
+Style/GlobalVars:
+  Enabled: false              # $redis is Rails convention
+Style/StringLiterals:
+  EnforcedStyle: single_quotes
+  ConsistentQuotesInMultiline: false
+
+# --- Naming — vendor API forces non-conformant names ---
+Naming/VariableNumber:
+  Enabled: false              # mDataProp_0, bSortable_1 are vendor API params
+Naming/AccessorMethodName:
+  Exclude:
+    - '**/lms/dashboard.rb'   # parses HTML tables, get_X reads better

data/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.20] - 2026-07-04
+
+### Fixed
+- **SSO Login URL hardcoded to dead domain**: `V3::HttpClient` used a hardcoded `LOGIN_URL = 'https://console.swiftfederation.com/'` constant, ignoring configuration. After the domain migration to `flashcone.com`, SSO login failed with `Connection refused`, producing `Missing SESSION for CDN` and empty usages responses.
+  - Removed the `LOGIN_URL` constant; added private `#login_url` resolving from `configuration.portal_endpoint` (ENV-driven: `PRIVATE_PORTAL_ENDPOINT` / `PORTAL_ROOT_HOSTNAME`), normalized with a single trailing slash
+  - Login page URL is now fully config/ENV-driven — no base domain hardcoded
+
+### Changed
+- **Default portal/SSO hostnames** in `Configuration` updated from the retired `*.swiftfederation.com` to `console.flashcone.com` / `sso2.flashcone.com` (only used when ENV is unset)
+- Updated RBS in `sig/conversant/v3.rbs`: removed `LOGIN_URL` constant, added `login_url` method signature
+
 ## [1.0.19] - 2026-02-06
 
 ### Fixed

data/Gemfile

@@ -9,4 +9,4 @@ gemspec
 group :development, :test do
   gem 'pry-byebug'
   gem 'simplecov', require: false
-end
+end

data/Rakefile

@@ -18,4 +18,4 @@ task :console do
   require 'conversant'
   require 'pry'
   Pry.start
-end
+end

data/conversant.gemspec

@@ -9,7 +9,12 @@ Gem::Specification.new do |spec|
   spec.email         = ['tho.nguyen@vnetwork.vn']
 
   spec.summary       = 'Ruby client for Conversant CDN API (V3)'
-  spec.description   = 'A Ruby gem providing a clean interface to interact with Conversant/SwiftFederation CDN services including Portal, CDN, and LMS APIs with V3 authentication support. Features zero-configuration setup, automatic ENV detection, and seamless integration with existing Conversant implementations.'
+  spec.description   = <<~DESC
+    A Ruby gem providing a clean interface to interact with Conversant/SwiftFederation
+    CDN services including Portal, CDN, and LMS APIs with V3 authentication support.
+    Features zero-configuration setup, automatic ENV detection, and seamless integration
+    with existing Conversant implementations.
+  DESC
   spec.homepage      = 'https://gitlab.vnetwork.dev/gems/conversant'
   spec.license       = 'MIT'
   spec.required_ruby_version = '>= 2.7.0'
@@ -39,7 +44,7 @@ Gem::Specification.new do |spec|
 
   # Development dependencies
   spec.add_development_dependency 'bundler', '~> 2.0'
-  spec.add_development_dependency 'pry', '~> 0.14'
+  spec.add_development_dependency 'pry', '~> 0.14.0'
   spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.12'
   spec.add_development_dependency 'rubocop', '~> 1.50'

data/examples/inheritance_integration.rb

@@ -193,10 +193,7 @@ module Utils
 
         private
 
-        def configuration
-          ::Conversant.configuration
-        end
-
+        # `configuration` is already provided by the Authentication mixin (private).
         def logger
           configuration.logger
         end

data/lib/conversant/configuration.rb

@@ -26,8 +26,8 @@ module Conversant
       # Users only need to override if they want different values
 
       # Portal configuration - defaults from ENV
-      @portal_root_hostname = ENV['PORTAL_ROOT_HOSTNAME'] || 'console.swiftfederation.com'
-      @portal_sso_hostname = ENV['PORTAL_SSO_HOSTNAME'] || 'sso.swiftfederation.com'
+      @portal_root_hostname = ENV['PORTAL_ROOT_HOSTNAME'] || 'console.flashcone.com'
+      @portal_sso_hostname = ENV['PORTAL_SSO_HOSTNAME'] || 'sso2.flashcone.com'
 
       # API Endpoints - defaults from ENV (matching existing CONVERSANT setup)
       @private_cdn_endpoint = ENV['PRIVATE_CDN_ENDPOINT']
@@ -56,14 +56,12 @@ module Conversant
 
       # Redis - auto-detect from global $redis or ENV
       @redis = if defined?($redis) && $redis
-        $redis
-      elsif defined?(::Redis) && ENV['REDIS_URL']
-        ::Redis.new(url: ENV['REDIS_URL'])
-      elsif defined?(::Redis)
-        ::Redis.new
-      else
-        nil
-      end
+                 $redis
+               elsif defined?(::Redis) && ENV['REDIS_URL']
+                 ::Redis.new(url: ENV['REDIS_URL'])
+               elsif defined?(::Redis)
+                 ::Redis.new
+               end
     end
 
     def portal_endpoint
@@ -79,18 +77,18 @@ module Conversant
 
       # Only require credentials if not auto-configured
       unless auto_configured?
-        required_fields += [
-          :swiftserve_identifier_id,
-          :swiftserve_identifier_hash
+        required_fields += %i[
+          swiftserve_identifier_id
+          swiftserve_identifier_hash
         ]
       end
 
       # Always require endpoints
-      required_fields += [
-        :private_cdn_endpoint,
-        :private_lms_endpoint,
-        :private_vms_endpoint,
-        :redis
+      required_fields += %i[
+        private_cdn_endpoint
+        private_lms_endpoint
+        private_vms_endpoint
+        redis
       ]
 
       missing_fields = required_fields.select { |field| send(field).nil? || send(field).to_s.empty? }
@@ -129,4 +127,4 @@ module Conversant
       config
     end
   end
-end
+end

data/lib/conversant/v3/base.rb

@@ -44,4 +44,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/http_client.rb

@@ -20,9 +20,6 @@ module Conversant
     #
     # @since 1.0.0
     module HttpClient
-      # Default login URL for SSO authentication
-      LOGIN_URL = 'https://console.swiftfederation.com/'
-
       # Redis key for storing portal SESSION cookie
       PORTAL_SESSION_REDIS_KEY = 'CONVERSANT.V3.PORTAL.SESSION'
 
@@ -115,8 +112,8 @@ module Conversant
           self.cookie_jar = {}
 
           # Step 1: Get login page and extract form action
-          debug_log "[SSO Login - Step 1] Fetching login page: #{LOGIN_URL}"
-          login_page_response = http_get(LOGIN_URL)
+          debug_log "[SSO Login - Step 1] Fetching login page: #{login_url}"
+          login_page_response = http_get(login_url)
           return nil unless login_page_response
 
           debug_log "Login page loaded, status: #{login_page_response[:status]}"
@@ -139,8 +136,8 @@ module Conversant
 
           debug_log '[SSO Login - Step 3] Submitting login form...'
           login_response = http_post(form_action, form_data, {
-            'Content-Type' => 'application/x-www-form-urlencoded'
-          })
+                                       'Content-Type' => 'application/x-www-form-urlencoded'
+                                     })
 
           return nil unless login_response
 
@@ -165,7 +162,6 @@ module Conversant
 
           debug_log 'New SSO login failed - no valid sessions obtained'
           nil
-
         rescue StandardError => e
           configuration.logger.error "Conversant::V3 - SSO login error: #{e.message}"
           nil
@@ -191,13 +187,11 @@ module Conversant
       def authenticate
         result = sso_login
 
-        if result && result[:session]
-          redis.set(PORTAL_SESSION_REDIS_KEY, result[:session], ex: configuration.cache_ttl)
-          redis.set(SSO_GW_SESSION2_REDIS_KEY, result[:sso_gw_session2], ex: configuration.cache_ttl) if result[:sso_gw_session2]
-          result
-        else
-          nil
-        end
+        return unless result && result[:session]
+
+        redis.set(PORTAL_SESSION_REDIS_KEY, result[:session], ex: configuration.cache_ttl)
+        redis.set(SSO_GW_SESSION2_REDIS_KEY, result[:sso_gw_session2], ex: configuration.cache_ttl) if result[:sso_gw_session2]
+        result
       end
 
       # Makes an authenticated HTTP request
@@ -224,9 +218,7 @@ module Conversant
         debug_log "[Request] Headers: #{headers.inspect}" if configuration.debug_mode
 
         # Check Content-Type using string key (headers are now plain hash with string keys)
-        if headers&.[]('Content-Type') == configuration.default_content_type
-          payload = payload&.to_json
-        end
+        payload = payload&.to_json if headers&.[]('Content-Type') == configuration.default_content_type
 
         request = RestClient::Request.new(
           method: method,
@@ -270,7 +262,7 @@ module Conversant
           headers: headers,
           verify_ssl: configuration.verify_ssl,
           max_redirects: 10
-        ) do |resp, request, result|
+        ) do |resp, _request, _result|
           update_cookie_jar(resp)
 
           case resp.code
@@ -319,7 +311,7 @@ module Conversant
           headers: headers,
           verify_ssl: configuration.verify_ssl,
           max_redirects: 10
-        ) do |resp, request, result|
+        ) do |resp, _request, _result|
           update_cookie_jar(resp)
 
           case resp.code
@@ -387,10 +379,10 @@ module Conversant
           end
         end
 
-        if response.respond_to?(:cookies) && response.cookies.is_a?(Hash)
-          response.cookies.each do |name, value|
-            cookie_jar[name.to_s] = value.to_s
-          end
+        return unless response.respond_to?(:cookies) && response.cookies.is_a?(Hash)
+
+        response.cookies.each do |name, value|
+          cookie_jar[name.to_s] = value.to_s
         end
       end
 
@@ -425,19 +417,25 @@ module Conversant
 
         # Parse HTML to find form action URL
         match = html_body.match(/form[^>]*id=["']kc-form-login["'][^>]*action=["']([^"']*)["']/)
-        if match
-          return CGI.unescapeHTML(match[1])
-        end
+        return CGI.unescapeHTML(match[1]) if match
 
         # Fallback: look for any form with action
         match = html_body.match(/form[^>]*action=["']([^"']*)["']/)
-        if match
-          return CGI.unescapeHTML(match[1])
-        end
+        return CGI.unescapeHTML(match[1]) if match
 
         nil
       end
 
+      # Returns the SSO login page URL (portal console root)
+      #
+      # Resolved from configuration (ENV-driven) so the base domain is never
+      # hardcoded. Always normalized with a single trailing slash.
+      #
+      # @return [String] Login page URL, e.g. "https://console.flashcone.com/"
+      def login_url
+        "#{configuration.portal_endpoint.chomp('/')}/"
+      end
+
       # Returns the global Conversant configuration
       #
       # @return [Conversant::Configuration] Configuration instance
@@ -453,4 +451,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/mixins/authentication.rb

@@ -218,4 +218,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/services/cdn/analytics.rb

@@ -75,7 +75,7 @@ module Conversant
             if response&.[]('bandwidth')
               {
                 averageThroughput: response&.[]('averageThroughput'),
-                data: response&.[]('bandwidth'),
+                data: response&.[]('bandwidth')
               }
             end
           rescue StandardError => e
@@ -170,7 +170,7 @@ module Conversant
                 avgQuantity: response['avgQuantity'],
                 httpTotalQuantity: response['httpTotalQuantity'],
                 httpsTotalQuantity: response['httpsTotalQuantity'],
-                data: response['datas'],
+                data: response['datas']
               }
             end
           rescue StandardError => e
@@ -312,8 +312,7 @@ module Conversant
           # @since 1.0.8
           def request_hit_rate(params)
             query_string = URI.encode_www_form(params)
-            response = JSON.parse(@parent.send(:call, 'GET', "/api/hit_rate_chart_data?#{query_string}", nil))
-            response
+            JSON.parse(@parent.send(:call, 'GET', "/api/hit_rate_chart_data?#{query_string}", nil))
           rescue StandardError => e
             @parent.send(:logger).error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
             nil
@@ -326,8 +325,7 @@ module Conversant
           # @since 1.0.8
           def byte_hit_rate(params)
             query_string = URI.encode_www_form(params)
-            response = JSON.parse(@parent.send(:call, 'GET', "/api/byte_rate_chart_data?#{query_string}", nil))
-            response
+            JSON.parse(@parent.send(:call, 'GET', "/api/byte_rate_chart_data?#{query_string}", nil))
           rescue StandardError => e
             @parent.send(:logger).error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
             nil
@@ -379,8 +377,7 @@ module Conversant
           # @return [Hash, nil] total referrer data, or nil on error
           # @since 1.0.8
           def referrer_total_by_domain(payload)
-            response = JSON.parse(@parent.send(:call, 'POST', '/api/report/getReferrerTotalByDomain', payload))
-            response
+            JSON.parse(@parent.send(:call, 'POST', '/api/report/getReferrerTotalByDomain', payload))
           rescue StandardError => e
             @parent.send(:logger).error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
             nil
@@ -392,8 +389,7 @@ module Conversant
           # @return [String, nil] CSV data, or nil on error
           # @since 1.0.8
           def referrer_csv_by_domain(payload)
-            response = @parent.send(:call, 'POST', '/api/report/getReferrerCsvByDomain', payload)
-            response
+            @parent.send(:call, 'POST', '/api/report/getReferrerCsvByDomain', payload)
           rescue StandardError => e
             @parent.send(:logger).error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
             nil
@@ -405,8 +401,7 @@ module Conversant
           # @return [Hash, nil] total URL data, or nil on error
           # @since 1.0.8
           def popular_content_url_total_by_domain(payload)
-            response = JSON.parse(@parent.send(:call, 'POST', '/api/report/getUrlTotalByDomain', payload))
-            response
+            JSON.parse(@parent.send(:call, 'POST', '/api/report/getUrlTotalByDomain', payload))
           rescue StandardError => e
             @parent.send(:logger).error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
             nil
@@ -418,8 +413,7 @@ module Conversant
           # @return [String, nil] CSV data, or nil on error
           # @since 1.0.8
           def popular_content_url_csv_by_domain(payload)
-            response = @parent.send(:call, 'POST', '/api/report/getUrlCsvByDomain', payload)
-            response
+            @parent.send(:call, 'POST', '/api/report/getUrlCsvByDomain', payload)
           rescue StandardError => e
             @parent.send(:logger).error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
             nil
@@ -431,8 +425,7 @@ module Conversant
           # @return [Hash, nil] request/visit statistics, or nil on error
           # @since 1.0.8
           def request_visit_number(payload)
-            response = JSON.parse(@parent.send(:call, 'POST', '/api/report/request_visit_number', payload))
-            response
+            JSON.parse(@parent.send(:call, 'POST', '/api/report/request_visit_number', payload))
           rescue StandardError => e
             @parent.send(:logger).error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
             nil
@@ -470,8 +463,7 @@ module Conversant
           # @return [String, nil] CSV data, or nil on error
           # @since 1.0.8
           def user_agent_csv(payload)
-            response = @parent.send(:call, 'POST', '/api/report/domain/userAgentCsv', payload)
-            response
+            @parent.send(:call, 'POST', '/api/report/domain/userAgentCsv', payload)
           rescue StandardError => e
             @parent.send(:logger).error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
             nil
@@ -480,4 +472,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/services/cdn/audit.rb

@@ -68,4 +68,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/services/cdn/certificate.rb

@@ -177,4 +177,4 @@ module Conversant
       end
     end
   end
-end
+end

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

@@ -106,4 +106,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/services/cdn/domain.rb

@@ -64,12 +64,11 @@ module Conversant
               return [] if response.nil?
 
               response = JSON.parse(response)
-              if response&.[]('list')
-                domains = response['list'].to_json
-                redis.set(key, domains, ex: 600)
-              else
-                return []
-              end
+              return [] unless response&.[]('list')
+
+              domains = response['list'].to_json
+              redis.set(key, domains, ex: 600)
+
             end
 
             JSON.parse(domains).map do |item|
@@ -220,4 +219,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/services/cdn/monitoring.rb

@@ -62,4 +62,4 @@ module Conversant
       end
     end
   end
-end
+end

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

@@ -230,4 +230,4 @@ module Conversant
       end
     end
   end
-end
+end

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

@@ -57,4 +57,4 @@ module Conversant
 end
 
 # Load nested analytics class after Partner is defined
-require_relative 'partner/analytics'
+require_relative 'partner/analytics'

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

@@ -56,9 +56,9 @@ module Conversant
             table = doc.at('table')
             return [] if table.nil?
 
-            jobs = table.search('tr').map do |row|
+            table.search('tr').map do |row|
               cells = row.search('td')
-              next [] if cells.length.zero?
+              next [] if cells.empty?
 
               app_name, stream_name, type, created, started, recording, status = cells
 
@@ -72,8 +72,6 @@ module Conversant
                 status: status&.text&.strip
               }
             end.flatten.compact
-
-            jobs
           rescue StandardError => e
             logger.error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
             []
@@ -96,4 +94,4 @@ module Conversant
       end
     end
   end
-end
+end

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

@@ -105,4 +105,4 @@ module Conversant
       end
     end
   end
-end
+end

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

@@ -81,6 +81,7 @@ module Conversant
           #   all_jobs = lms.job.where
           #
           # @since 1.0.0
+          # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
           def where(**params)
             response = JSON.parse(@parent.send(:call, 'GET', "/v4/streams?#{params.to_query}"))
             return nil unless response
@@ -122,6 +123,7 @@ module Conversant
             @parent.send(:logger).error "LMS::Job.where error: #{e.message}"
             nil
           end
+          # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
 
           private
 

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

@@ -263,4 +263,4 @@ module Conversant
       end
     end
   end
-end
+end

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

@@ -55,4 +55,4 @@ end
 # Load nested analytics class after Partner is defined
 require_relative 'partner/analytics'
 require_relative 'partner/report'
-require_relative 'partner/business'
+require_relative 'partner/business'

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

@@ -54,4 +54,4 @@ module Conversant
       end
     end
   end
-end
+end

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

@@ -104,8 +104,6 @@ module Conversant
           response.body
         end
 
-        protected
-
         def service_endpoint
           configuration.private_lms_endpoint
         end

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

@@ -102,4 +102,4 @@ module Conversant
       end
     end
   end
-end
+end

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

@@ -45,4 +45,4 @@ module Conversant
 end
 
 # Load nested analytics class after Partner is defined
-require_relative 'partner/analytics'
+require_relative 'partner/analytics'

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

@@ -125,4 +125,4 @@ module Conversant
 end
 
 # Load nested service classes after OSS is defined
-require_relative 'oss/partner'
+require_relative 'oss/partner'

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

@@ -111,4 +111,4 @@ module Conversant
       end
     end
   end
-end
+end

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

@@ -84,7 +84,7 @@ module Conversant
                 deleted: item['deleted'],
                 pop: item['pop'],
                 volume: item['volume'],
-                federation: item['federationVolume'],
+                federation: item['federationVolume']
               }
             end.to_json
 

data/lib/conversant/v3/services/vms/analytics.rb

@@ -111,4 +111,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/services/vms/business.rb

@@ -187,4 +187,4 @@ module Conversant
       end
     end
   end
-end
+end

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

@@ -130,4 +130,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3/services/vms/transcoding.rb

@@ -108,7 +108,7 @@ module Conversant
             response = @parent.send(:call, 'GET', "/v2/jobs?#{merged_payload.to_query}")
             return [] if response.nil?
 
-            JSON.parse(response)&.[]("list") || []
+            JSON.parse(response)&.[]('list') || []
           rescue StandardError => e
             logger.error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
             []
@@ -163,7 +163,7 @@ module Conversant
             response = @parent.send(:call, 'GET', "/v2/osp/presets?#{merged_payload.to_query}")
             return [] if response.nil?
 
-            JSON.parse(response)&.[]("list") || []
+            JSON.parse(response)&.[]('list') || []
           rescue StandardError => e
             logger.error "#{@parent.send(:identifier)}.METHOD:#{__method__}.EXCEPTION:#{e.message}"
             []
@@ -181,4 +181,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/v3.rb

@@ -33,4 +33,4 @@ module Conversant
       end
     end
   end
-end
+end

data/lib/conversant/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Conversant
-  VERSION = '1.0.19'
+  VERSION = '1.0.20'
 end

data/plans/templates/bug-fix-template.md

@@ -0,0 +1,69 @@
+# [Bug Fix] Implementation Plan
+
+**Date**: YYYY-MM-DD  
+**Type**: Bug Fix  
+**Priority**: [Critical/High/Medium/Low]  
+**Context Tokens**: <150 words
+
+## Executive Summary
+Brief description of the bug and its impact.
+
+## Issue Analysis
+### Symptoms
+- [ ] Symptom 1
+- [ ] Symptom 2
+
+### Root Cause
+Brief explanation of the underlying cause.
+
+### Evidence
+- **Logs**: Reference to log files (don't include full logs)
+- **Error Messages**: Key error patterns
+- **Affected Components**: List of impacted files/modules
+
+## Context Links
+- **Related Issues**: [GitHub issue numbers]
+- **Recent Changes**: [Relevant commits or PRs]
+- **Dependencies**: [Related systems]
+
+## Solution Design
+### Approach
+High-level fix strategy in 2-3 sentences.
+
+### Changes Required
+1. **File 1** (`path/to/file.ts`): Brief change description
+2. **File 2** (`path/to/file.ts`): Brief change description
+
+### Testing Changes
+- [ ] Update existing tests
+- [ ] Add new test cases
+- [ ] Validate fix doesn't break existing functionality
+
+## Implementation Steps
+1. [ ] Step 1 - file: `path/to/file.ts`
+2. [ ] Step 2 - file: `path/to/file.ts`
+3. [ ] Run test suite
+4. [ ] Validate fix in relevant environments
+
+## Verification Plan
+### Test Cases
+- [ ] Test case 1: Expected behavior
+- [ ] Test case 2: Edge case handling
+- [ ] Regression test: Ensure no new issues
+
+### Rollback Plan
+If the fix causes issues:
+1. Revert commit: `git revert <commit-hash>`
+2. Restore previous behavior in files X, Y, Z
+
+## Risk Assessment
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| Risk 1 | Medium | Mitigation plan |
+
+## TODO Checklist
+- [ ] Implement fix
+- [ ] Update tests
+- [ ] Run full test suite
+- [ ] Code review
+- [ ] Deploy and verify

data/plans/templates/feature-implementation-template.md

@@ -0,0 +1,84 @@
+# [Feature Name] Implementation Plan
+
+**Date**: YYYY-MM-DD  
+**Type**: Feature Implementation  
+**Status**: Planning  
+**Context Tokens**: <200 words
+
+## Executive Summary
+Brief 2-3 sentence description of the feature and its business value.
+
+## Context Links
+- **Related Plans**: [List other plan files - no full content]
+- **Dependencies**: [External systems, APIs, existing features]
+- **Reference Docs**: [Link to docs in ./docs directory]
+
+## Requirements
+### Functional Requirements
+- [ ] Requirement 1
+- [ ] Requirement 2
+
+### Non-Functional Requirements  
+- [ ] Performance target
+- [ ] Security requirement
+- [ ] Scalability requirement
+
+## Architecture Overview
+```mermaid
+[Simple component diagram]
+```
+
+### Key Components
+- **Component 1**: Brief description
+- **Component 2**: Brief description
+
+### Data Models
+- **Model 1**: Key fields
+- **Model 2**: Key fields
+
+## Implementation Phases
+
+### Phase 1: [Name] (Est: X days)
+**Scope**: Specific boundaries
+**Tasks**:
+1. [ ] Task 1 - file: `path/to/file.ts`
+2. [ ] Task 2 - file: `path/to/file.ts`
+
+**Acceptance Criteria**:
+- [ ] Criteria 1
+- [ ] Criteria 2
+
+### Phase 2: [Name] (Est: X days)
+[Repeat structure]
+
+## Testing Strategy
+- **Unit Tests**: Specific test coverage targets
+- **Integration Tests**: Key interaction points
+- **E2E Tests**: Critical user flows
+
+## Security Considerations
+- [ ] Security item 1
+- [ ] Security item 2
+
+## Risk Assessment
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| Risk 1 | High | Mitigation strategy |
+
+## Quick Reference
+### Key Commands
+```bash
+npm run command
+```
+
+### Configuration Files
+- `config/file.ts`: Purpose
+- `.env.example`: Environment variables
+
+## TODO Checklist
+- [ ] Phase 1 Task 1
+- [ ] Phase 1 Task 2
+- [ ] Phase 2 Task 1
+- [ ] Testing complete
+- [ ] Documentation updated
+- [ ] Code review passed

data/plans/templates/refactor-template.md

@@ -0,0 +1,82 @@
+# [Component/Module] Refactoring Plan
+
+**Date**: YYYY-MM-DD  
+**Type**: Refactoring  
+**Scope**: [Module/Component/System level]  
+**Context Tokens**: <200 words
+
+## Executive Summary
+Brief description of what is being refactored and why.
+
+## Current State Analysis
+### Issues with Current Implementation
+- [ ] Issue 1: Performance bottleneck
+- [ ] Issue 2: Code maintainability
+- [ ] Issue 3: Technical debt
+
+### Metrics (Before)
+- **Performance**: Current benchmarks
+- **Code Quality**: Complexity metrics
+- **Test Coverage**: Current percentage
+
+## Context Links
+- **Affected Modules**: [List without full content]
+- **Dependencies**: [Other systems impacted]
+- **Related Documentation**: [Links to docs]
+
+## Refactoring Strategy
+### Approach
+High-level strategy for the refactoring in 2-3 sentences.
+
+### Architecture Changes
+```mermaid
+[Before/After comparison diagram]
+```
+
+### Key Improvements
+- **Improvement 1**: Brief description
+- **Improvement 2**: Brief description
+
+## Implementation Plan
+
+### Phase 1: Preparation (Est: X days)
+**Scope**: Setup and preparation work
+1. [ ] Create comprehensive tests for current functionality
+2. [ ] Document current behavior
+3. [ ] Identify all dependencies
+
+### Phase 2: Core Refactoring (Est: X days)
+**Scope**: Main refactoring work
+1. [ ] Refactor component A - file: `path/to/file.ts`
+2. [ ] Refactor component B - file: `path/to/file.ts`
+3. [ ] Update integration points
+
+### Phase 3: Integration & Testing (Est: X days)
+**Scope**: Validation and cleanup
+1. [ ] Integration testing
+2. [ ] Performance validation
+3. [ ] Documentation updates
+
+## Backward Compatibility
+- **Breaking Changes**: [List any breaking changes]
+- **Migration Path**: [Steps for users/systems]
+- **Deprecation Timeline**: [If applicable]
+
+## Success Metrics (After)
+- **Performance**: Target improvements
+- **Code Quality**: Target metrics
+- **Test Coverage**: Target percentage
+
+## Risk Assessment
+| Risk | Impact | Mitigation |
+|------|--------|------------|
+| Breaking changes | High | Comprehensive testing |
+| Performance regression | Medium | Benchmarking |
+
+## TODO Checklist
+- [ ] Phase 1: Preparation complete
+- [ ] Phase 2: Core refactoring complete  
+- [ ] Phase 3: Integration complete
+- [ ] Performance benchmarks validated
+- [ ] Documentation updated
+- [ ] Code review passed

data/plans/templates/template-usage-guide.md

@@ -0,0 +1,58 @@
+# Plan Template Usage Guide
+
+## Template Selection
+
+### Feature Implementation Template
+**Use when**: Adding new functionality, endpoints, services, or modules
+**File**: `feature-implementation-template.md`
+**Size**: Medium to large scope changes
+
+### Bug Fix Template  
+**Use when**: Fixing specific issues, errors, or broken functionality
+**File**: `bug-fix-template.md`
+**Size**: Small to medium scope changes
+
+### Refactoring Template
+**Use when**: Improving code structure, performance, or maintainability without changing functionality
+**File**: `refactor-template.md` 
+**Size**: Medium to large scope changes
+
+## Context Management Best Practices
+
+### Keep Plans Focused
+- **Executive Summary**: Max 3 sentences
+- **Context Links**: Reference files, don't include full content
+- **Tasks**: Max 10 per phase
+- **Context Tokens**: Target <200 words for summaries
+
+### Template Adaptation
+1. Copy the appropriate template to `plans/YYMMDD-feature-name-plan.md`
+2. Replace bracketed placeholders with actual content
+3. Remove sections not relevant to your specific use case
+4. Keep the core structure intact for consistency
+
+### Cross-References Instead of Duplication
+- Link to existing documentation in `./docs/`
+- Reference other plans without copying content
+- Use file paths instead of code blocks where possible
+- Focus on "what" and "why", not detailed "how"
+
+## Quality Checklist
+
+Before finalizing any plan:
+- [ ] Executive summary is clear and concise
+- [ ] Tasks are specific and actionable
+- [ ] File paths are included for implementation tasks
+- [ ] Success criteria are measurable
+- [ ] Context links are used instead of full content
+- [ ] TODO checklist is complete and realistic
+
+## Context Refresh Triggers
+
+Use these templates when:
+- Starting a new development phase
+- Switching between different types of work (feature → bugfix)
+- After major context accumulation (>8000 tokens)
+- When agent handoffs occur
+
+This ensures each plan starts with fresh, focused context optimized for the specific task type.

data/sig/conversant/v3.rbs

@@ -29,7 +29,6 @@ module Conversant
 
     # HTTP client module
     module HttpClient
-      LOGIN_URL: String
       PORTAL_SESSION_REDIS_KEY: String
       SSO_GW_SESSION2_REDIS_KEY: String
 
@@ -48,6 +47,7 @@ module Conversant
       def update_cookie_jar: (untyped response) -> void
       def parse_cookie_to_jar: (String cookie_string) -> void
       def extract_form_action: (String html_body) -> String?
+      def login_url: () -> String
       def configuration: () -> Conversant::Configuration
       def redis: () -> untyped
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: conversant
 version: !ruby/object:Gem::Version
-  version: 1.0.19
+  version: 1.0.20
 platform: ruby
 authors:
 - Tho Nguyen
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-06 00:00:00.000000000 Z
+date: 2026-07-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -72,14 +72,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.14'
+        version: 0.14.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.14'
+        version: 0.14.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -164,7 +164,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
-description: A Ruby gem providing a clean interface to interact with Conversant/SwiftFederation
+description: |
+  A Ruby gem providing a clean interface to interact with Conversant/SwiftFederation
   CDN services including Portal, CDN, and LMS APIs with V3 authentication support.
   Features zero-configuration setup, automatic ENV detection, and seamless integration
   with existing Conversant implementations.
@@ -228,6 +229,10 @@ files:
 - lib/conversant/v3/services/vms/partner/business.rb
 - lib/conversant/v3/services/vms/transcoding.rb
 - lib/conversant/version.rb
+- plans/templates/bug-fix-template.md
+- plans/templates/feature-implementation-template.md
+- plans/templates/refactor-template.md
+- plans/templates/template-usage-guide.md
 - publish.sh
 - sig/conversant.rbs
 - sig/conversant/v3.rbs
@@ -260,7 +265,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.5.10
 signing_key:
 specification_version: 4
 summary: Ruby client for Conversant CDN API (V3)