sumologic-query 1.3.2 → 1.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fff9b3ee00ddf6f3adfd2bb84fb8488068149fc8e7bfd94a3aa1b9854f7b74f2
-  data.tar.gz: 898d75c6c4ca00c9e78ef21301d1345ec4e2c3806f33a8554b485486f314214a
+  metadata.gz: f674ac09efecc2c167df4d3853be9d9bd5c1c043bf6e0d574f068770e9979a8b
+  data.tar.gz: 4e43daf71638156ad4ac9f72b862daf501f4714037b3cee603aac1a6e8de1efb
 SHA512:
-  metadata.gz: b9d264177ec993228a116d3c17f77cf1ac0b0e16c48d19a3de2b6b6502fcf9d89bfa90dc1046609f5819c18bcccb0a30eeb3c57b7ba00363a94f4e08f2705318
-  data.tar.gz: 252af2f57e025938cbe9607eb5ae32b23140d0e84bbc8c8ecaceb10c06110436e37a096c9c6d21480c2408cbfb3f29a5f322e71655622954c5c7fc5881ac959f
+  metadata.gz: cc1c1a801d4c0dcf282ae281cc4da00eb125095b036f45489cda7c74638e4116fde5ad5c317896fb8e05988fd143887d7b470f31d02fba10426cc3c3c7bd78a0
+  data.tar.gz: 3b360acf874598ea9ca2513d1ddd507c617e970b94f79efb5029fc3a2e37e807b1f8aac2e3e9cbe95793ef0d74f210fd2ab13e9d7d3f0d25fad446014f6f46cb

data/CHANGELOG.md

@@ -1,28 +1,170 @@
-## [1.2.2](https://github.com/patrick204nqh/sumologic-query/compare/v1.2.1...v1.2.2) (2025-11-15)
+# Changelog
 
+All notable changes to this project will be documented in this file.
 
+This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and release notes are automatically generated from commit messages.
+## [1.3.3](https://github.com/patrick204nqh/sumologic-query/compare/v1.3.2...v1.3.3) (2025-11-17)
+
+### 🎉 New Features
+
+- implement modular HTTP client components for improved organization and functionality
+- refactor CLI structure to modular commands and remove deprecated modules
+- update CHANGELOG entry creation to include changelog content directly
+- bump version to 1.3.3
+- add ADR for SSL certificate verification to address connection issues with Sumo Logic API
+- refactor CLI structure into modular components for improved organization and maintainability
+- implement debug logging for HTTP requests and responses
+- enhance release notes generation and update CHANGELOG format for better clarity
 
-## [1.2.1](https://github.com/patrick204nqh/sumologic-query/compare/v1.2.0...v1.2.1) (2025-11-14)
 
 
 
 ## [1.3.2](https://github.com/patrick204nqh/sumologic-query/compare/v1.3.1...v1.3.2) (2025-11-16)
 
-<!-- Release notes generated using configuration in .github/release.yml at main -->
+### 🎉 New Features
+
+- Refactor FzfViewer with modular configuration, formatting, and header building for better maintainability
+- Add modular file structure with separate concerns (Config, Formatter, SearchableBuilder, FzfConfig, HeaderBuilder)
+- Implement module_function for better encapsulation in all FzfViewer modules
+- Add RubyGems download badge to README
+
+### 🐛 Bug Fixes
+
+- Update source field reference in FzfViewer for consistency (use lowercase `_source` field)
+- Fix RuboCop offenses across all FzfViewer modules
+
+### 🔧 Refactoring
+
+- Extract searchable builder methods to reduce complexity
+- Separate FzfViewer into 6 focused modules (~50-100 lines each)
+- Use constants for display configuration (widths, colors, padding)
+- Improve code organization with clear section headers
+
+### 🧹 Maintenance
+
+- Update release notes generation and changelog management in CI pipeline
+
+## [1.3.1](https://github.com/patrick204nqh/sumologic-query/compare/v1.3.0...v1.3.1) (2025-11-15)
+
+### 🧹 Maintenance
+
+- Automated version bump and release preparation
+
+## [1.3.0](https://github.com/patrick204nqh/sumologic-query/compare/v1.2.1...v1.3.0) (2025-11-15)
+
+### 📚 Documentation
+
+- Establish commit message convention using Conventional Commits
+- Update CONTRIBUTING.md for clarity and best practices
+
+### 🧹 Maintenance
+
+- Remove path restriction for version file in release workflow
+- Improve CI/CD pipeline configuration
+
+## [1.2.1](https://github.com/patrick204nqh/sumologic-query/compare/v1.2.0...v1.2.1) (2025-11-14)
+
+### 🎉 New Features
 
+- Add interactive mode with FZF for enhanced log exploration
+- Support real-time log browsing and filtering
+- Add keyboard shortcuts for common operations
 
+### 📚 Documentation
 
-**Full Changelog**: https://github.com/patrick204nqh/sumologic-query/compare/v1.3.1...v1.3.2
+- Update CLI and documentation to support new interactive feature
+- Add usage examples for interactive mode
 
-# [1.2.0](https://github.com/patrick204nqh/sumologic-query/compare/v1.1.2...v1.2.0) (2025-11-14)
+## [1.2.0](https://github.com/patrick204nqh/sumologic-query/compare/v1.1.2...v1.2.0) (2025-11-14)
 
+### 🎉 New Features
 
+- Add ADR 004 for enhanced progress tracking and user experience
+- Implement real-time visibility with callbacks in CLI and fetcher classes
+- Add comprehensive progress indicators for long-running operations
+
+### 🔧 Refactoring
+
+- Implement reusable Worker utility for parallel execution
+- Refactor metadata and search fetching classes to utilize Worker
+- Remove deprecated ParallelFetcher and Paginator
+- Simplify pagination logic
+- Remove streaming APIs for better maintainability
+- Update configuration defaults for optimal performance
+
+### 📚 Documentation
+
+- Reorganize architecture documentation files
+- Add architectural overview and decision records
 
 ## [1.1.2](https://github.com/patrick204nqh/sumologic-query/compare/v1.1.1...v1.1.2) (2025-11-14)
 
+### 🐛 Bug Fixes
+
+- Fix command syntax in tldr.md for listing collectors and sources
+
+### 🎉 New Features
 
+- Add version command to CLI
+
+### 📚 Documentation
+
+- Add quick reference documentation (tldr.md)
+- Refactor documentation structure
+- Remove examples.md and consolidate content
+- Streamline troubleshooting.md
+- Consolidate queries.md with improved examples
 
 ## [1.1.1](https://github.com/patrick204nqh/sumologic-query/compare/v1.1.0...v1.1.1) (2025-11-14)
 
+### 🔧 Refactoring
+
+- Refactor search logging in CLI and Poller classes for improved readability
+- Consolidate attribute accessors in Configuration class
+- Improve CLI options structure
+
+## [1.1.0](https://github.com/patrick204nqh/sumologic-query/compare/v1.0.1...v1.1.0) (2025-11-13)
+
+### 🎉 New Features
+
+- Add CLI support with Thor framework
+- Refactor Sumo Logic client for better usability
+
+### 🔧 Refactoring
+
+- Refine polling logic in Sumo Logic client
+- Improve overall code structure and organization
+
+### 🧹 Maintenance
+
+- Refactor CI and release workflows
+- Streamline version checking and build process
+- Improve release tagging automation
+
+## [1.0.1](https://github.com/patrick204nqh/sumologic-query/compare/v1.0.0...v1.0.1) (2025-11-13)
+
+### 🎉 New Features
+
+- Add CODEOWNERS file for repository management
+
+### 🧹 Maintenance
+
+- Refactor release workflow to generate release notes using GitHub API
+- Update CHANGELOG.md format for better clarity
+- Add changelog extraction for automated versioning
+
+## [1.0.0](https://github.com/patrick204nqh/sumologic-query/releases/tag/v1.0.0) (2025-11-13)
 
+### 🎉 Initial Release
 
+- Initial release of Sumo Logic Query Tool
+- Core search functionality
+- Metadata querying (collectors, sources)
+- Basic CLI interface
+- HTTP client with authentication
+- Automated pagination
+- Search job polling
+- JSON output support

data/lib/sumologic/cli/commands/base_command.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Sumologic
+  class CLI < Thor
+    module Commands
+      # Base class for all CLI commands
+      # Provides common functionality like client creation, output handling, and formatting
+      class BaseCommand
+        attr_reader :options, :client
+
+        def initialize(options, client)
+          @options = options
+          @client = client
+        end
+
+        private
+
+        def output_json(data)
+          json_output = JSON.pretty_generate(data)
+
+          if options[:output]
+            File.write(options[:output], json_output)
+            warn "\nResults saved to: #{options[:output]}"
+          else
+            puts json_output
+          end
+        end
+
+        def format_collector(collector)
+          {
+            id: collector['id'],
+            name: collector['name'],
+            collectorType: collector['collectorType'],
+            alive: collector['alive'],
+            category: collector['category']
+          }
+        end
+
+        def format_source(source)
+          {
+            id: source['id'],
+            name: source['name'],
+            category: source['category'],
+            sourceType: source['sourceType'],
+            alive: source['alive']
+          }
+        end
+      end
+    end
+  end
+end

data/lib/sumologic/cli/commands/list_collectors_command.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require_relative 'base_command'
+
+module Sumologic
+  class CLI < Thor
+    module Commands
+      # Handles the list-collectors command execution
+      class ListCollectorsCommand < BaseCommand
+        def execute
+          warn 'Fetching collectors...'
+          collectors = client.list_collectors
+
+          output_json(
+            total: collectors.size,
+            collectors: collectors.map { |c| format_collector(c) }
+          )
+        end
+      end
+    end
+  end
+end

data/lib/sumologic/cli/commands/list_sources_command.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require_relative 'base_command'
+
+module Sumologic
+  class CLI < Thor
+    module Commands
+      # Handles the list-sources command execution
+      class ListSourcesCommand < BaseCommand
+        def execute
+          if options[:collector_id]
+            list_sources_for_collector
+          else
+            list_all_sources
+          end
+        end
+
+        private
+
+        def list_sources_for_collector
+          warn "Fetching sources for collector: #{options[:collector_id]}"
+          sources = client.list_sources(collector_id: options[:collector_id])
+
+          output_json(
+            collector_id: options[:collector_id],
+            total: sources.size,
+            sources: sources.map { |s| format_source(s) }
+          )
+        end
+
+        def list_all_sources
+          warn 'Fetching all sources from all collectors...'
+          warn 'This may take a minute...'
+
+          all_sources = client.list_all_sources
+
+          output_json(
+            total_collectors: all_sources.size,
+            total_sources: all_sources.sum { |c| c['sources'].size },
+            data: all_sources.map { |item| format_collector_with_sources(item) }
+          )
+        end
+
+        def format_collector_with_sources(item)
+          {
+            collector: item['collector'],
+            sources: item['sources'].map { |s| format_source(s) }
+          }
+        end
+      end
+    end
+  end
+end

data/lib/sumologic/cli/commands/search_command.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+require_relative 'base_command'
+
+module Sumologic
+  class CLI < Thor
+    module Commands
+      # Handles the search command execution
+      class SearchCommand < BaseCommand
+        def execute
+          log_search_info
+          results = perform_search
+
+          display_results_summary(results)
+
+          if options[:interactive]
+            launch_interactive_mode(results)
+          else
+            output_search_results(results)
+          end
+        end
+
+        private
+
+        def log_search_info
+          warn '=' * 60
+          warn 'Sumo Logic Search Query'
+          warn '=' * 60
+          warn "Time Range: #{options[:from]} to #{options[:to]}"
+          warn "Query: #{options[:query]}"
+          warn "Limit: #{options[:limit] || 'unlimited'}"
+          warn '-' * 60
+          warn 'Creating search job...'
+          $stderr.puts
+        end
+
+        def perform_search
+          client.search(
+            query: options[:query],
+            from_time: options[:from],
+            to_time: options[:to],
+            time_zone: options[:time_zone],
+            limit: options[:limit]
+          )
+        end
+
+        def display_results_summary(results)
+          warn '=' * 60
+          warn "Results: #{results.size} messages"
+          warn '=' * 60
+          $stderr.puts
+        end
+
+        def output_search_results(results)
+          output_json(
+            query: options[:query],
+            from: options[:from],
+            to: options[:to],
+            time_zone: options[:time_zone],
+            message_count: results.size,
+            messages: results
+          )
+        end
+
+        def launch_interactive_mode(results)
+          require_relative '../../interactive'
+
+          formatted_results = build_formatted_results(results)
+          Sumologic::Interactive.launch(formatted_results)
+        rescue Sumologic::Interactive::Error => e
+          warn e.message
+          exit 1
+        end
+
+        def build_formatted_results(results)
+          {
+            'query' => options[:query],
+            'from' => options[:from],
+            'to' => options[:to],
+            'time_zone' => options[:time_zone],
+            'message_count' => results.size,
+            'messages' => results
+          }
+        end
+      end
+    end
+  end
+end

data/lib/sumologic/cli.rb

@@ -2,9 +2,13 @@
 
 require 'thor'
 require 'json'
+require_relative 'cli/commands/search_command'
+require_relative 'cli/commands/list_collectors_command'
+require_relative 'cli/commands/list_sources_command'
 
 module Sumologic
   # Thor-based CLI for Sumo Logic query tool
+  # Delegates commands to specialized command classes
   class CLI < Thor
     class_option :debug, type: :boolean, aliases: '-d', desc: 'Enable debug output'
     class_option :output, type: :string, aliases: '-o', desc: 'Output file (default: stdout)'
@@ -13,6 +17,11 @@ module Sumologic
       true
     end
 
+    def initialize(*args)
+      super
+      $DEBUG = true if options[:debug]
+    end
+
     desc 'search', 'Search Sumo Logic logs'
     long_desc <<~DESC
       Search Sumo Logic logs using a query string.
@@ -39,23 +48,7 @@ module Sumologic
     option :limit, type: :numeric, aliases: '-l', desc: 'Maximum messages to return'
     option :interactive, type: :boolean, aliases: '-i', desc: 'Launch interactive browser (requires fzf)'
     def search
-      $DEBUG = true if options[:debug]
-
-      client = create_client
-
-      log_search_info
-      results = execute_search(client)
-
-      warn '=' * 60
-      warn "Results: #{results.size} messages"
-      warn '=' * 60
-      $stderr.puts
-
-      if options[:interactive]
-        launch_interactive_mode(results)
-      else
-        output_search_results(results)
-      end
+      Commands::SearchCommand.new(options, create_client).execute
     end
 
     desc 'list-collectors', 'List all Sumo Logic collectors'
@@ -66,17 +59,7 @@ module Sumologic
         sumo-query list-collectors --output collectors.json
     DESC
     def list_collectors
-      $DEBUG = true if options[:debug]
-
-      client = create_client
-
-      warn 'Fetching collectors...'
-      collectors = client.list_collectors
-
-      output_json(
-        total: collectors.size,
-        collectors: collectors.map { |c| format_collector(c) }
-      )
+      Commands::ListCollectorsCommand.new(options, create_client).execute
     end
 
     desc 'list-sources', 'List sources from collectors'
@@ -92,15 +75,7 @@ module Sumologic
     DESC
     option :collector_id, type: :string, desc: 'Collector ID to list sources for'
     def list_sources
-      $DEBUG = true if options[:debug]
-
-      client = create_client
-
-      if options[:collector_id]
-        list_sources_for_collector(client, options[:collector_id])
-      else
-        list_all_sources(client)
-      end
+      Commands::ListSourcesCommand.new(options, create_client).execute
     end
 
     desc 'version', 'Show version information'
@@ -127,120 +102,8 @@ module Sumologic
       exit 1
     end
 
-    def list_sources_for_collector(client, collector_id)
-      warn "Fetching sources for collector: #{collector_id}"
-      sources = client.list_sources(collector_id: collector_id)
-
-      output_json(
-        collector_id: collector_id,
-        total: sources.size,
-        sources: sources.map { |s| format_source(s) }
-      )
-    end
-
-    def list_all_sources(client)
-      warn 'Fetching all sources from all collectors...'
-      warn 'This may take a minute...'
-
-      all_sources = client.list_all_sources
-
-      output_json(
-        total_collectors: all_sources.size,
-        total_sources: all_sources.sum { |c| c['sources'].size },
-        data: all_sources.map do |item|
-          {
-            collector: item['collector'],
-            sources: item['sources'].map { |s| format_source(s) }
-          }
-        end
-      )
-    end
-
-    def format_collector(collector)
-      {
-        id: collector['id'],
-        name: collector['name'],
-        collectorType: collector['collectorType'],
-        alive: collector['alive'],
-        category: collector['category']
-      }
-    end
-
-    def format_source(source)
-      {
-        id: source['id'],
-        name: source['name'],
-        category: source['category'],
-        sourceType: source['sourceType'],
-        alive: source['alive']
-      }
-    end
-
-    def output_json(data)
-      json_output = JSON.pretty_generate(data)
-
-      if options[:output]
-        File.write(options[:output], json_output)
-        warn "\nResults saved to: #{options[:output]}"
-      else
-        puts json_output
-      end
-    end
-
     def error(message)
       warn message
     end
-
-    def log_search_info
-      warn '=' * 60
-      warn 'Sumo Logic Search Query'
-      warn '=' * 60
-      warn "Time Range: #{options[:from]} to #{options[:to]}"
-      warn "Query: #{options[:query]}"
-      warn "Limit: #{options[:limit] || 'unlimited'}"
-      warn '-' * 60
-      warn 'Creating search job...'
-      $stderr.puts
-    end
-
-    def execute_search(client)
-      client.search(
-        query: options[:query],
-        from_time: options[:from],
-        to_time: options[:to],
-        time_zone: options[:time_zone],
-        limit: options[:limit]
-      )
-    end
-
-    def output_search_results(results)
-      output_json(
-        query: options[:query],
-        from: options[:from],
-        to: options[:to],
-        time_zone: options[:time_zone],
-        message_count: results.size,
-        messages: results
-      )
-    end
-
-    def launch_interactive_mode(results)
-      require_relative 'interactive'
-
-      # Format results for interactive mode
-      formatted_results = {
-        'query' => options[:query],
-        'from' => options[:from],
-        'to' => options[:to],
-        'time_zone' => options[:time_zone],
-        'message_count' => results.size,
-        'messages' => results
-      }
-
-      Sumologic::Interactive.launch(formatted_results)
-    rescue Sumologic::Interactive::Error => e
-      error e.message
-      exit 1
-    end
   end
 end

data/lib/sumologic/http/client.rb

@@ -1,30 +1,41 @@
 # frozen_string_literal: true
 
-require 'net/http'
-require 'json'
-require 'uri'
 require_relative 'connection_pool'
+require_relative 'debug_logger'
+require_relative 'cookie_jar'
+require_relative 'request_builder'
+require_relative 'response_handler'
 
 module Sumologic
   module Http
-    # Handles HTTP communication with Sumo Logic API
-    # Responsibilities: request execution, error handling, SSL configuration
-    # Uses connection pooling for thread-safe parallel requests
+    # Orchestrates HTTP communication with Sumo Logic API
+    # Delegates to specialized components for request building,
+    # response handling, connection pooling, and cookie management
     class Client
       def initialize(base_url:, authenticator:)
-        @base_url = base_url
-        @authenticator = authenticator
+        @cookie_jar = CookieJar.new
+        @request_builder = RequestBuilder.new(
+          base_url: base_url,
+          authenticator: authenticator,
+          cookie_jar: @cookie_jar
+        )
+        @response_handler = ResponseHandler.new
         @connection_pool = ConnectionPool.new(base_url: base_url, max_connections: 10)
       end
 
       # Execute HTTP request with error handling
       # Uses connection pool for thread-safe parallel execution
       def request(method:, path:, body: nil, query_params: nil)
-        uri = build_uri(path, query_params)
-        request = build_request(method, uri, body)
+        uri = @request_builder.build_uri(path, query_params)
+        request = @request_builder.build_request(method, uri, body)
+
+        DebugLogger.log_request(method, uri, body)
 
         response = execute_request(uri, request)
-        handle_response(response)
+
+        DebugLogger.log_response(response)
+
+        @response_handler.handle(response)
       rescue Errno::ECONNRESET, Errno::EPIPE, EOFError, Net::HTTPBadResponse => e
         # Connection error - raise for retry at higher level
         raise Error, "Connection error: #{e.message}"
@@ -37,49 +48,15 @@ module Sumologic
 
       private
 
-      def build_uri(path, query_params)
-        uri = URI("#{@base_url}#{path}")
-        uri.query = URI.encode_www_form(query_params) if query_params
-        uri
-      end
-
-      def build_request(method, uri, body)
-        request_class = case method
-                        when :get then Net::HTTP::Get
-                        when :post then Net::HTTP::Post
-                        when :delete then Net::HTTP::Delete
-                        else raise ArgumentError, "Unsupported HTTP method: #{method}"
-                        end
-
-        request = request_class.new(uri)
-        request['Authorization'] = @authenticator.auth_header
-        request['Accept'] = 'application/json'
-
-        if body
-          request['Content-Type'] = 'application/json'
-          request.body = body.to_json
-        end
-
-        request
-      end
-
       def execute_request(uri, request)
-        @connection_pool.with_connection(uri) do |http|
+        response = @connection_pool.with_connection(uri) do |http|
           http.request(request)
         end
-      end
 
-      def handle_response(response)
-        case response.code.to_i
-        when 200..299
-          JSON.parse(response.body)
-        when 401, 403
-          raise AuthenticationError, "Authentication failed: #{response.body}"
-        when 429
-          raise Error, "Rate limit exceeded: #{response.body}"
-        else
-          raise Error, "HTTP #{response.code}: #{response.body}"
-        end
+        # Store cookies from response for subsequent requests
+        @cookie_jar.store_from_response(response)
+
+        response
       end
     end
   end

data/lib/sumologic/http/connection_pool.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'openssl'
+
 module Sumologic
   module Http
     # Thread-safe connection pool for HTTP clients
@@ -84,10 +86,22 @@ module Sumologic
         http.read_timeout = READ_TIMEOUT
         http.open_timeout = OPEN_TIMEOUT
         http.keep_alive_timeout = 30
+
+        # SSL configuration
+        http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+        http.cert_store = ssl_cert_store
+
         http.start
         http
       end
 
+      def ssl_cert_store
+        # Use system's default certificate store
+        store = OpenSSL::X509::Store.new
+        store.set_default_paths
+        store
+      end
+
       def create_temporary_connection(uri)
         # Fallback: create a temporary connection if pool is exhausted
         create_connection(uri)

data/lib/sumologic/http/cookie_jar.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+module Sumologic
+  module Http
+    # Simple cookie jar for storing and managing HTTP cookies
+    # Handles Set-Cookie response headers and Cookie request headers
+    class CookieJar
+      def initialize
+        @cookies = {}
+      end
+
+      # Store cookies from response Set-Cookie headers
+      def store_from_response(response)
+        return unless response['Set-Cookie']
+
+        Array(response['Set-Cookie']).each do |cookie_header|
+          parse_and_store(cookie_header)
+        end
+      end
+
+      # Format cookies for Cookie request header
+      # Returns nil if no cookies stored
+      def to_header
+        return nil if @cookies.empty?
+
+        @cookies.map { |name, value| "#{name}=#{value}" }.join('; ')
+      end
+
+      # Check if any cookies are stored
+      def any?
+        @cookies.any?
+      end
+
+      # Clear all stored cookies
+      def clear
+        @cookies.clear
+      end
+
+      private
+
+      def parse_and_store(cookie_header)
+        # Parse cookie name=value (ignore path, domain, expires, etc.)
+        # Example: "session_id=abc123; Path=/; HttpOnly"
+        return unless cookie_header =~ /^([^=]+)=([^;]+)/
+
+        name = Regexp.last_match(1).strip
+        value = Regexp.last_match(2).strip
+        @cookies[name] = value
+      end
+    end
+  end
+end

data/lib/sumologic/http/debug_logger.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module Sumologic
+  module Http
+    # Handles debug logging for HTTP requests and responses
+    # Only logs when $DEBUG is enabled
+    module DebugLogger
+      module_function
+
+      def log_request(method, uri, body)
+        return unless $DEBUG
+
+        warn "\n[DEBUG] API Request:"
+        warn "  Method: #{method.to_s.upcase}"
+        warn "  URL: #{uri}"
+        log_request_body(body) if body
+        warn ''
+      end
+
+      def log_response(response)
+        return unless $DEBUG
+
+        warn '[DEBUG] API Response:'
+        warn "  Status: #{response.code} #{response.message}"
+        log_response_body(response.body)
+        warn ''
+      end
+
+      def log_request_body(body)
+        warn "  Body: #{JSON.pretty_generate(body)}"
+      rescue JSON::GeneratorError
+        warn "  Body: #{body.inspect}"
+      end
+
+      def log_response_body(body)
+        truncated = body.length > 500
+        display_body = truncated ? "#{body[0..500]}..." : body
+        warn "  Body: #{display_body}"
+        warn "  (truncated, full length: #{body.length} characters)" if truncated
+      end
+    end
+  end
+end

data/lib/sumologic/http/request_builder.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+require 'uri'
+
+module Sumologic
+  module Http
+    # Builds HTTP requests with proper headers, authentication, and cookies
+    class RequestBuilder
+      def initialize(base_url:, authenticator:, cookie_jar:)
+        @base_url = base_url
+        @authenticator = authenticator
+        @cookie_jar = cookie_jar
+      end
+
+      # Build complete URI from path and query parameters
+      def build_uri(path, query_params = nil)
+        uri = URI("#{@base_url}#{path}")
+        uri.query = URI.encode_www_form(query_params) if query_params
+        uri
+      end
+
+      # Build HTTP request with all necessary headers
+      def build_request(method, uri, body = nil)
+        request = create_request_object(method, uri)
+        add_headers(request)
+        add_body(request, body) if body
+        request
+      end
+
+      private
+
+      def create_request_object(method, uri)
+        request_class = request_class_for(method)
+        request_class.new(uri)
+      end
+
+      def request_class_for(method)
+        case method
+        when :get then Net::HTTP::Get
+        when :post then Net::HTTP::Post
+        when :delete then Net::HTTP::Delete
+        else raise ArgumentError, "Unsupported HTTP method: #{method}"
+        end
+      end
+
+      def add_headers(request)
+        request['Authorization'] = @authenticator.auth_header
+        request['Accept'] = 'application/json'
+
+        # Add cookies if available
+        cookie_header = @cookie_jar.to_header
+        request['Cookie'] = cookie_header if cookie_header
+      end
+
+      def add_body(request, body)
+        request['Content-Type'] = 'application/json'
+        request.body = body.to_json
+      end
+    end
+  end
+end

data/lib/sumologic/http/response_handler.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module Sumologic
+  module Http
+    # Handles HTTP response parsing and error handling
+    class ResponseHandler
+      # Parse response and handle errors
+      def handle(response)
+        case response.code.to_i
+        when 200..299
+          parse_success(response)
+        when 401, 403
+          handle_authentication_error(response)
+        when 429
+          handle_rate_limit_error(response)
+        else
+          handle_generic_error(response)
+        end
+      end
+
+      private
+
+      def parse_success(response)
+        JSON.parse(response.body)
+      end
+
+      def handle_authentication_error(response)
+        raise AuthenticationError, "Authentication failed: #{response.body}"
+      end
+
+      def handle_rate_limit_error(response)
+        raise Error, "Rate limit exceeded: #{response.body}"
+      end
+
+      def handle_generic_error(response)
+        raise Error, "HTTP #{response.code}: #{response.body}"
+      end
+    end
+  end
+end

data/lib/sumologic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Sumologic
-  VERSION = '1.3.2'
+  VERSION = '1.3.3'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sumologic-query
 version: !ruby/object:Gem::Version
-  version: 1.3.2
+  version: 1.3.3
 platform: ruby
 authors:
 - patrick204nqh
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-16 00:00:00.000000000 Z
+date: 2025-11-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -97,11 +97,19 @@ files:
 - bin/sumo-query
 - lib/sumologic.rb
 - lib/sumologic/cli.rb
+- lib/sumologic/cli/commands/base_command.rb
+- lib/sumologic/cli/commands/list_collectors_command.rb
+- lib/sumologic/cli/commands/list_sources_command.rb
+- lib/sumologic/cli/commands/search_command.rb
 - lib/sumologic/client.rb
 - lib/sumologic/configuration.rb
 - lib/sumologic/http/authenticator.rb
 - lib/sumologic/http/client.rb
 - lib/sumologic/http/connection_pool.rb
+- lib/sumologic/http/cookie_jar.rb
+- lib/sumologic/http/debug_logger.rb
+- lib/sumologic/http/request_builder.rb
+- lib/sumologic/http/response_handler.rb
 - lib/sumologic/interactive.rb
 - lib/sumologic/interactive/fzf_viewer.rb
 - lib/sumologic/interactive/fzf_viewer/config.rb