userpattern 0.2.0

data/lib/userpattern/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module UserPattern
+  VERSION = '0.2.0'
+end

data/lib/userpattern/violation_recorder.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'openssl'
+
+module UserPattern
+  # Persists threshold violations with an anonymized user identifier.
+  # The raw user ID is NEVER stored — only a one-way HMAC hash.
+  class ViolationRecorder
+    def self.record!(violation)
+      Violation.create!(
+        model_type: violation.model_type,
+        endpoint: violation.endpoint,
+        period: violation.period,
+        count: violation.count,
+        limit: violation.limit,
+        user_identifier: anonymize_user_id(violation.user_id, violation.model_type),
+        occurred_at: Time.current
+      )
+    rescue StandardError => e
+      Rails.logger.error("[UserPattern] Violation record error: #{e.message}")
+    end
+
+    def self.anonymize_user_id(user_id, model_type)
+      salt = UserPattern.configuration.anonymous_salt
+      OpenSSL::HMAC.hexdigest('SHA256', salt, "#{model_type}:#{user_id}")[0, 16]
+    end
+  end
+end

data/lib/userpattern.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+require 'userpattern/version'
+require 'userpattern/configuration'
+
+module UserPattern
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def buffer
+      @buffer ||= begin
+        require 'userpattern/buffer'
+        Buffer.new
+      end
+    end
+
+    attr_reader :threshold_cache, :rate_limiter
+
+    def start_alert_mode!
+      require 'userpattern/threshold_cache'
+      require 'userpattern/rate_limiter'
+
+      @threshold_cache = ThresholdCache.new
+      store = configuration.rate_limiter_store || default_cache_store
+      @rate_limiter = RateLimiter.new(store: store, threshold_cache: @threshold_cache)
+    end
+
+    def enabled?
+      configuration.enabled
+    end
+
+    def cleanup!
+      require 'userpattern/request_event_cleanup'
+      RequestEventCleanup.run!
+    end
+
+    def reset!
+      @buffer&.shutdown
+      @threshold_cache&.shutdown
+      @configuration = Configuration.new
+      @buffer = nil
+      @threshold_cache = nil
+      @rate_limiter = nil
+    end
+
+    private
+
+    def default_cache_store
+      if defined?(Rails) && Rails.respond_to?(:cache) && Rails.cache
+        Rails.cache
+      else
+        ActiveSupport::Cache::MemoryStore.new
+      end
+    end
+  end
+end
+
+# :nocov:
+require 'userpattern/engine' if defined?(Rails::Engine)
+# :nocov:

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: userpattern
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- UserPattern Contributors
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+description: Track and analyze endpoint usage patterns of logged-in users with full
+  anonymization. Provides a sortable dashboard with per-model-type frequency statistics.
+email: []
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- app/assets/stylesheets/user_pattern/dashboard.css
+- app/controllers/user_pattern/dashboard_controller.rb
+- app/models/user_pattern/request_event.rb
+- app/models/user_pattern/violation.rb
+- app/views/user_pattern/dashboard/index.html.erb
+- app/views/user_pattern/dashboard/violations.html.erb
+- config/routes.rb
+- lib/generators/userpattern/install_generator.rb
+- lib/generators/userpattern/templates/create_userpattern_request_events.rb.erb
+- lib/generators/userpattern/templates/create_userpattern_violations.rb.erb
+- lib/generators/userpattern/templates/initializer.rb
+- lib/tasks/userpattern.rake
+- lib/userpattern.rb
+- lib/userpattern/anonymizer.rb
+- lib/userpattern/buffer.rb
+- lib/userpattern/configuration.rb
+- lib/userpattern/controller_tracking.rb
+- lib/userpattern/engine.rb
+- lib/userpattern/path_normalizer.rb
+- lib/userpattern/rate_limiter.rb
+- lib/userpattern/request_event_cleanup.rb
+- lib/userpattern/stats_calculator.rb
+- lib/userpattern/threshold_cache.rb
+- lib/userpattern/threshold_exceeded.rb
+- lib/userpattern/version.rb
+- lib/userpattern/violation_recorder.rb
+homepage: https://github.com/userpattern/userpattern
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.7
+specification_version: 4
+summary: Anonymized usage pattern analysis for Rails applications
+test_files: []