behavior_analytics 0.1.0 → 2.0.0

data/lib/behavior_analytics.rb

@@ -8,28 +8,164 @@ require_relative "behavior_analytics/query"
 require_relative "behavior_analytics/storage/adapter"
 require_relative "behavior_analytics/storage/in_memory_adapter"
 require_relative "behavior_analytics/storage/active_record_adapter"
+
+begin
+  require_relative "behavior_analytics/storage/redis_adapter"
+rescue LoadError
+end
+
+begin
+  require_relative "behavior_analytics/storage/elasticsearch_adapter"
+rescue LoadError
+end
+
+begin
+  require_relative "behavior_analytics/storage/kafka_adapter"
+rescue LoadError
+end
 require_relative "behavior_analytics/analytics/engine"
+require_relative "behavior_analytics/analytics/funnels"
+require_relative "behavior_analytics/analytics/cohorts"
+require_relative "behavior_analytics/analytics/retention"
+require_relative "behavior_analytics/hooks/manager"
+require_relative "behavior_analytics/hooks/webhook"
+require_relative "behavior_analytics/hooks/callback"
+require_relative "behavior_analytics/replay/engine"
+require_relative "behavior_analytics/replay/processor"
+require_relative "behavior_analytics/sampling/strategy"
+require_relative "behavior_analytics/throttling/limiter"
+require_relative "behavior_analytics/schema/validator"
+require_relative "behavior_analytics/schema/definition"
+require_relative "behavior_analytics/export/csv_exporter"
+require_relative "behavior_analytics/export/json_exporter"
+require_relative "behavior_analytics/reporting/generator"
+require_relative "behavior_analytics/observability/metrics"
+require_relative "behavior_analytics/observability/tracer"
+require_relative "behavior_analytics/debug/inspector"
+require_relative "behavior_analytics/processors/async_processor"
+require_relative "behavior_analytics/processors/background_job_processor"
+require_relative "behavior_analytics/streaming/event_stream"
 
 begin
   require_relative "behavior_analytics/integrations/rails"
 rescue LoadError
 end
 
+begin
+  require_relative "behavior_analytics/jobs/active_event_job"
+rescue LoadError
+end
+
+begin
+  require_relative "behavior_analytics/jobs/sidekiq_event_job"
+rescue LoadError
+end
+
+begin
+  require_relative "behavior_analytics/jobs/delayed_event_job"
+rescue LoadError
+end
+
 module BehaviorAnalytics
-  class Error < StandardError; end
+  class Error < StandardError
+    attr_reader :context
+
+    def initialize(message, context: nil)
+      super(message)
+      @context = context
+    end
+
+    def to_s
+      base_message = super
+      if @context && BehaviorAnalytics.configuration.debug_mode
+        "#{base_message} (Context: #{@context.inspect})"
+      else
+        base_message
+      end
+    end
+  end
+
+  class ValidationError < Error; end
+  class ConfigurationError < Error; end
+  class StorageError < Error; end
 
   class Configuration
-    attr_accessor :storage_adapter, :batch_size, :flush_interval, :context_resolver, :scoring_weights
+    attr_accessor :storage_adapter, :batch_size, :flush_interval, :context_resolver, :scoring_weights,
+                  :async_processor, :use_async, :event_stream, :environment, :feature_flags,
+                  :hooks_manager, :raise_on_hook_error, :sampling_strategy, :rate_limiter,
+                  :schema_validator, :schema_registry, :tracking_whitelist, :tracking_blacklist,
+                  :skip_bots, :controller_action_filters, :slow_query_threshold, :track_middleware_requests,
+                  :metrics, :tracer, :debug_mode, :logger
 
     def initialize
       @batch_size = 100
       @flush_interval = 300
+      @use_async = false
       @scoring_weights = {
         activity: 0.4,
         unique_users: 0.3,
         feature_diversity: 0.2,
         time_in_trial: 0.1
       }
+      @environment = ENV["RAILS_ENV"] || ENV["RACK_ENV"] || "development"
+      @feature_flags = {}
+      @event_stream = Streaming::EventStream.new
+      @hooks_manager = Hooks::Manager.new
+      @raise_on_hook_error = false
+      @schema_registry = Schema::Registry.new
+      @tracking_whitelist = nil
+      @tracking_blacklist = []
+      @skip_bots = true
+      @controller_action_filters = {}
+      @slow_query_threshold = nil
+      @track_middleware_requests = false
+      @metrics = Observability::Metrics.new
+      @tracer = nil
+      @debug_mode = @environment == "development"
+      @logger = nil
+    end
+
+    def debug(message, context: nil)
+      return unless @debug_mode
+
+      log_message = "[BehaviorAnalytics] #{message}"
+      log_message += " (Context: #{context.inspect})" if context
+
+      if @logger
+        @logger.debug(log_message)
+      elsif defined?(Rails) && Rails.logger
+        Rails.logger.debug(log_message)
+      else
+        puts log_message
+      end
+    end
+
+    def log_error(error, context: nil)
+      error_message = error.message
+      error_message += " (Context: #{context.inspect})" if context
+
+      if @logger
+        @logger.error("[BehaviorAnalytics] #{error_message}")
+        @logger.error(error.backtrace.join("\n")) if error.backtrace
+      elsif defined?(Rails) && Rails.logger
+        Rails.logger.error("[BehaviorAnalytics] #{error_message}")
+        Rails.logger.error(error.backtrace.join("\n")) if error.backtrace
+      else
+        puts "[BehaviorAnalytics ERROR] #{error_message}"
+        puts error.backtrace.join("\n") if error.backtrace
+      end
+    end
+
+    def feature_enabled?(feature)
+      @feature_flags.fetch(feature, false)
+    end
+
+    def enable_feature(feature)
+      @feature_flags[feature] = true
+    end
+
+    def disable_feature(feature)
+      @feature_flags[feature] = false
     end
   end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: behavior_analytics
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 2.0.0
 platform: ruby
 authors:
 - nerdawey
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-01-04 00:00:00.000000000 Z
+date: 2026-01-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -81,22 +81,52 @@ files:
 - Rakefile
 - behavior_analytics.gemspec
 - db/migrate/001_create_behavior_events.rb
+- db/migrate/002_enhance_behavior_events_v2.rb
 - lib/behavior_analytics.rb
+- lib/behavior_analytics/analytics/cohorts.rb
 - lib/behavior_analytics/analytics/engine.rb
+- lib/behavior_analytics/analytics/funnels.rb
+- lib/behavior_analytics/analytics/retention.rb
 - lib/behavior_analytics/context.rb
+- lib/behavior_analytics/debug/inspector.rb
 - lib/behavior_analytics/event.rb
+- lib/behavior_analytics/export/csv_exporter.rb
+- lib/behavior_analytics/export/json_exporter.rb
+- lib/behavior_analytics/hooks/callback.rb
+- lib/behavior_analytics/hooks/manager.rb
+- lib/behavior_analytics/hooks/webhook.rb
 - lib/behavior_analytics/integrations/rails.rb
+- lib/behavior_analytics/integrations/rails/middleware.rb
+- lib/behavior_analytics/jobs/active_event_job.rb
+- lib/behavior_analytics/jobs/delayed_event_job.rb
+- lib/behavior_analytics/jobs/sidekiq_event_job.rb
+- lib/behavior_analytics/observability/metrics.rb
+- lib/behavior_analytics/observability/tracer.rb
+- lib/behavior_analytics/processors/async_processor.rb
+- lib/behavior_analytics/processors/background_job_processor.rb
 - lib/behavior_analytics/query.rb
+- lib/behavior_analytics/replay/engine.rb
+- lib/behavior_analytics/replay/processor.rb
+- lib/behavior_analytics/reporting/generator.rb
+- lib/behavior_analytics/sampling/strategy.rb
+- lib/behavior_analytics/schema/definition.rb
+- lib/behavior_analytics/schema/validator.rb
 - lib/behavior_analytics/storage/active_record_adapter.rb
 - lib/behavior_analytics/storage/adapter.rb
+- lib/behavior_analytics/storage/elasticsearch_adapter.rb
 - lib/behavior_analytics/storage/in_memory_adapter.rb
+- lib/behavior_analytics/storage/kafka_adapter.rb
+- lib/behavior_analytics/storage/redis_adapter.rb
+- lib/behavior_analytics/streaming/event_stream.rb
+- lib/behavior_analytics/throttling/limiter.rb
 - lib/behavior_analytics/tracker.rb
 - lib/behavior_analytics/version.rb
 - lib/generators/behavior_analytics/install_generator.rb
 - lib/generators/behavior_analytics/templates/create_behavior_events.rb
 - sig/behavior_analytics.rbs
 homepage: https://github.com/nerdawey/behavior_analytics
-licenses: []
+licenses:
+- MIT
 metadata:
   homepage_uri: https://github.com/nerdawey/behavior_analytics
   source_code_uri: https://github.com/nerdawey/behavior_analytics