trackguard 0.16.1 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4c12f652065f915f2b4b906869a232738d8cf96632e6676f7107e84c442ea9d
-  data.tar.gz: a50ce6042ea670cb43486972f7a47a8187273aebd2947bd42f2ccfd4aba67225
+  metadata.gz: 90c710c8d2149047c75e5b99151b708e9741e29385d17de7c4f101ad9db697cf
+  data.tar.gz: 49aaf485a932c241d9c18986120f639305485f4c316653923e9ad9a018566e01
 SHA512:
-  metadata.gz: 4eb185b4afe7cd71d3347afac5d203625a3348ff812647fc3ea6b04cff52bb2ded026d2601d546945900bd5f9a05bb0154fcb78a590ae6f5ec3249f283254b04
-  data.tar.gz: 18a0b707b1c085cab5c43a7249c4a6ed8bf753ba30a3b1e4e5bee00283381de4f2f511af06651009b587e9eeada7d69a860d4664f914adf92dfd2307e16d84f2
+  metadata.gz: b1a17b99009baaacee17c4473bf33b811870df411541cee1c055807f2b8981b4ab09ba0c28eeee15adc0a8ab87081f6b463b494435618cafafb2aea424b95226
+  data.tar.gz: 8da17d592514268ced0ab53cb0c2331671eea10702deaac46264f90874f2af33e60f952a1c89b7c1f920b6ad35ad93297bfe6ab786c796816c3704d35a17424d

data/app/assets/stylesheets/trackguard/admin.css

@@ -7,7 +7,7 @@
   font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Inter", sans-serif;
   font-size: 16px;
   line-height: 1.5;
-  background-color: #07101f;
+  background-color: #0f0909;
   color: #e0e0e0;
   -webkit-font-smoothing: antialiased;
   min-height: 100vh;
@@ -22,8 +22,8 @@
 
 /* ── Header ────────────────────────────────────────────────────────── */
 .tg-header {
-  background: #0d1829;
-  border-bottom: 1px solid #1c2d4a;
+  background: #190e0e;
+  border-bottom: 1px solid #2e1515;
   padding: 0.875rem 0;
 }
 
@@ -40,16 +40,16 @@
   font-size: 0.9375rem;
   font-weight: 600;
   letter-spacing: 0.03em;
-  color: #60a5fa;
+  color: #f87171;
   text-decoration: none;
   flex: 1;
 }
 
 .tg-brand__logo {
   width: 20px;
-  height: 22px;
+  height: auto;
   flex-shrink: 0;
-  filter: drop-shadow(0 0 4px rgba(59, 130, 246, 0.35));
+  filter: drop-shadow(0 0 4px rgba(239, 68, 68, 0.4));
 }
 
 /* ── Back link ─────────────────────────────────────────────────────── */
@@ -76,8 +76,8 @@
 
 /* ── Nav ───────────────────────────────────────────────────────────── */
 .tg-nav {
-  background: #0d1829;
-  border-bottom: 1px solid #1c2d4a;
+  background: #190e0e;
+  border-bottom: 1px solid #2e1515;
 }
 
 .tg-nav > .tg-container {
@@ -97,8 +97,8 @@
 .tg-nav__link:hover { color: #e0e0e0; }
 
 .tg-nav__link--active {
-  color: #60a5fa;
-  border-bottom-color: #60a5fa;
+  color: #f87171;
+  border-bottom-color: #e53e3e;
 }
 
 /* ── Main ──────────────────────────────────────────────────────────── */
@@ -128,8 +128,8 @@
 }
 
 .tg-stat {
-  background: #0d1829;
-  border: 1px solid #1c2d4a;
+  background: #190e0e;
+  border: 1px solid #2e1515;
   border-radius: 8px;
   padding: 1.25rem;
 }
@@ -167,8 +167,8 @@
 }
 
 .tg-panel {
-  background: #0d1829;
-  border: 1px solid #1c2d4a;
+  background: #190e0e;
+  border: 1px solid #2e1515;
   border-radius: 8px;
   padding: 1rem;
   margin-bottom: 1rem;
@@ -211,14 +211,14 @@
   font-size: 0.8125rem;
   color: #e0e0e0;
   text-decoration: none;
-  background: #1c2d4a;
+  background: #2e1515;
 }
 
-.tg-pagination__link:hover { background: #243a5e; }
+.tg-pagination__link:hover { background: #3d1c1c; }
 
 .tg-pagination__link--active {
-  background: #60a5fa;
-  color: #07101f;
+  background: #e53e3e;
+  color: #ffffff;
   font-weight: 600;
 }
 
@@ -249,14 +249,14 @@
   text-transform: uppercase;
   letter-spacing: 0.08em;
   color: #666666;
-  border-bottom: 1px solid #1c2d4a;
+  border-bottom: 1px solid #2e1515;
 }
 
 .tg-th--right { text-align: right; }
 
 .tg-td {
   padding: 0.75rem 0.875rem;
-  border-bottom: 1px solid #1c2d4a;
+  border-bottom: 1px solid #2e1515;
   color: #f0f0f0;
   font-weight: 500;
 }
@@ -271,7 +271,7 @@
 
 .tg-td--bare {
   padding: 0;
-  border-bottom: 1px solid #1c2d4a;
+  border-bottom: 1px solid #2e1515;
 }
 
 /* ── Empty state ───────────────────────────────────────────────────── */
@@ -361,7 +361,7 @@
 /* ── Detail panel ──────────────────────────────────────────────────── */
 .tg-detail {
   padding: 0 1rem 1rem 1rem;
-  background: #0d1829;
+  background: #190e0e;
 }
 
 .tg-detail__grid {
@@ -423,7 +423,7 @@
   align-items: center;
   gap: 0.5rem;
   padding: 0.75rem 0 0;
-  border-top: 1px solid #1c2d4a;
+  border-top: 1px solid #2e1515;
   margin-top: 0.75rem;
 }
 
@@ -436,8 +436,8 @@
 
 .tg-input {
   flex: 1;
-  background: #07101f;
-  border: 1px solid #1c2d4a;
+  background: #0f0909;
+  border: 1px solid #2e1515;
   border-radius: 4px;
   color: #e0e0e0;
   font-size: 0.8125rem;
@@ -445,7 +445,7 @@
   outline: none;
 }
 
-.tg-input:focus { border-color: #60a5fa; }
+.tg-input:focus { border-color: #e53e3e; }
 .tg-input::placeholder { color: #444; }
 
 .tg-btn {
@@ -461,8 +461,8 @@
 .tg-btn--danger { background: #7f1d1d; color: #fca5a5; }
 .tg-btn--danger:hover { background: #991b1b; }
 
-.tg-btn--ghost { background: #1c2d4a; color: #e0e0e0; }
-.tg-btn--ghost:hover { background: #243a5e; }
+.tg-btn--ghost { background: #2e1515; color: #e0e0e0; }
+.tg-btn--ghost:hover { background: #3d1c1c; }
 
 .tg-btn--whitelist { background: #064e3b; color: #6ee7b7; }
 .tg-btn--whitelist:hover { background: #065f46; }
@@ -476,4 +476,4 @@
   .tg-stats { grid-template-columns: 1fr; }
   .tg-detail__grid { grid-template-columns: 1fr; }
   .tg-summary__ip { display: none; }
-}
+}

data/app/controllers/trackguard/admin/visitors_controller.rb

@@ -11,11 +11,13 @@ module Trackguard
         end
       end
 
+      # rubocop:disable Metrics/AbcSize
       def flag
         if @visitor.update(
           flagged_at: Time.current,
           flag_reason: params[:flag_reason].presence,
-          flagged_by: params[:flagged_by].presence || Visitor::FLAGGED_BY.first
+          flagged_by: params[:flagged_by].presence || Visitor::FLAGGED_BY.first,
+          name: params[:name].presence || BlockedUserAgent.matching_pattern(@visitor.user_agent)
         )
           respond_to do |format|
             format.html { redirect_back_or_to dashboard_path }
@@ -28,6 +30,7 @@ module Trackguard
           end
         end
       end
+      # rubocop:enable Metrics/AbcSize
 
       def unflag
         @visitor.update!(flagged_at: nil, flag_reason: nil, flagged_by: nil)

data/app/jobs/trackguard/detect_suspicious_visitors_job.rb

@@ -43,13 +43,15 @@ module Trackguard
       return if count.zero?
       return if visitor.whitelisted_ip&.active?
 
+      name = name_from_ua(visitor.user_agent)
+
       if count >= HARD_FLAG_THRESHOLD
-        flag!(visitor, "#{count} page views in 24h (hard flag threshold)")
+        flag!(visitor, "#{count} page views in 24h (hard flag threshold)", name: name)
         return
       end
 
       if (reason = ua_flag_reason(visitor.user_agent))
-        flag!(visitor, reason)
+        flag!(visitor, reason, name: name)
         return
       end
 
@@ -58,7 +60,7 @@ module Trackguard
       return if count < MIN_VIEWS
 
       if views.all? { |pv| pv.session_id.nil? && pv.referer.nil? && pv.path == "/" }
-        flag!(visitor, "no session, no referrer, single root hit")
+        flag!(visitor, "no session, no referrer, single root hit", name: name)
         return
       end
 
@@ -85,7 +87,7 @@ module Trackguard
 
       return if score < FLAG_SCORE_THRESHOLD
 
-      flag!(visitor, reasons.join("; "))
+      flag!(visitor, reasons.join("; "), name: name)
     end
     # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
 
@@ -107,7 +109,8 @@ module Trackguard
         .where("wi.id IS NULL OR wi.expires_at <= ?", Time.current)
         .distinct
         .each do |visitor|
-          flag!(visitor, "trace_id shared across multiple visitors (cross-visitor bot detected)")
+          flag!(visitor, "trace_id shared across multiple visitors (cross-visitor bot detected)",
+                name: name_from_ua(visitor.user_agent))
         end
     end
 
@@ -115,8 +118,12 @@ module Trackguard
       "blank or minimal user-agent" if user_agent.blank? || user_agent.to_s.length < 10
     end
 
-    def flag!(visitor, reason)
-      visitor.update!(flagged_at: Time.current, flag_reason: reason, flagged_by: "claw:auto")
+    def flag!(visitor, reason, name: nil)
+      visitor.update!(flagged_at: Time.current, flag_reason: reason, flagged_by: "claw:auto", name: name)
+    end
+
+    def name_from_ua(user_agent)
+      BlockedUserAgent.matching_pattern(user_agent)
     end
 
     def blank_ratio(views, attr)

data/app/models/trackguard/blocked_user_agent.rb

@@ -12,5 +12,12 @@ module Trackguard
       end
       patterns.any? { |p| user_agent.to_s.downcase.include?(p.downcase) }
     end
+
+    def self.matching_pattern(user_agent)
+      patterns = Rails.cache.fetch(CACHE_KEY, expires_in: 10.minutes) do
+        pluck(:pattern)
+      end
+      patterns.find { |p| user_agent.to_s.downcase.include?(p.downcase) }
+    end
   end
 end

data/app/services/trackguard/page_view_recorder.rb

@@ -1,13 +1,5 @@
 module Trackguard
   class PageViewRecorder < ApplicationService
-    BOT_REGEX = /
-      Googlebot|Bingbot|Slurp|DuckDuckBot|Baidu|YandexBot|
-      facebookexternalhit|Twitterbot|LinkedInBot|
-      curl|wget|python-requests|python-urllib|
-      Go-http-client|libwww|Java|Ruby|
-      bot|crawl|spider
-    /ix
-
     def initialize(path:, ip:, user_agent:, referer:, session_id:, trace_id:, source: nil, initial: false,
                    http_method: nil)
       @path        = path.to_s
@@ -22,11 +14,11 @@ module Trackguard
     end
 
     def call
-      return if BOT_REGEX.match?(@user_agent)
-      return if BlockedUserAgent.blocked?(@user_agent)
+      adapter = Trackguard.adapter
+      return if adapter.blocked_user_agent?(@user_agent)
       return if @path.blank? || @path.start_with?("/admin")
 
-      TrackPageViewJob.perform_later(
+      adapter.track_page_view(
         path: @path,
         ip: @ip,
         user_agent: @user_agent,

data/app/views/layouts/trackguard/admin.html.erb

@@ -11,27 +11,7 @@
     <div class="tg-container">
       <div class="tg-header__inner">
         <span class="tg-brand">
-          <svg class="tg-brand__logo" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 20 22" aria-hidden="true">
-            <defs>
-              <linearGradient id="tg-shield-grad" x1="0" y1="0" x2="0" y2="1">
-                <stop offset="0%" stop-color="#1e3a5f"/>
-                <stop offset="100%" stop-color="#0d1f3c"/>
-              </linearGradient>
-            </defs>
-            <!-- Shield -->
-            <path d="M10 1L19 4.5V11.5C19 16.4 15 20.3 10 21.5C5 20.3 1 16.4 1 11.5V4.5Z"
-                  fill="url(#tg-shield-grad)" stroke="#3b82f6" stroke-width="1.25" stroke-linejoin="round"/>
-            <!-- Left rail -->
-            <line x1="7.5" y1="6" x2="7.5" y2="17" stroke="#60a5fa" stroke-width="1.6" stroke-linecap="round"/>
-            <!-- Right rail -->
-            <line x1="12.5" y1="6" x2="12.5" y2="17" stroke="#60a5fa" stroke-width="1.6" stroke-linecap="round"/>
-            <!-- Cross-tie 1 -->
-            <line x1="6.25" y1="8"    x2="13.75" y2="8"    stroke="#3b82f6" stroke-width="1.25" stroke-linecap="round"/>
-            <!-- Cross-tie 2 -->
-            <line x1="6.25" y1="11.5" x2="13.75" y2="11.5" stroke="#3b82f6" stroke-width="1.25" stroke-linecap="round"/>
-            <!-- Cross-tie 3 -->
-            <line x1="6.25" y1="15"   x2="13.75" y2="15"   stroke="#3b82f6" stroke-width="1.25" stroke-linecap="round"/>
-          </svg>
+          <%= image_tag "trackguard/logo.png", class: "tg-brand__logo", alt: "Trackguard" %>
           Trackguard
         </span>
 

data/app/views/trackguard/admin/dashboards/show.html.erb

@@ -151,6 +151,7 @@
                           <%= hidden_field_tag :id, visitor.id %>
                           <%= f.submit "Flag", class: "tg-btn tg-btn--danger" %>
                           <%= f.text_field :flag_reason, placeholder: "Flag reason (optional)", class: "tg-input", autocomplete: "off" %>
+                          <%= f.text_field :name, placeholder: "Name (optional, auto-detected if blank)", class: "tg-input", autocomplete: "off" %>
                         <% end %>
                       <% end %>
                     </div>
@@ -175,6 +176,10 @@
                           <span class="tg-dl__term">User agent</span>
                           <span class="tg-dl__def tg-dl__def--break"><%= visitor&.user_agent.presence || "—" %></span>
                         </div>
+                        <div class="tg-dl__row">
+                          <span class="tg-dl__term">Name</span>
+                          <span class="tg-dl__def"><%= visitor&.name.presence || "—" %></span>
+                        </div>
                         <div class="tg-dl__row">
                           <span class="tg-dl__term">Flag status</span>
                           <% if flagged %>

data/app/views/trackguard/admin/visits/index.html.erb

@@ -63,6 +63,7 @@
                           <%= hidden_field_tag :id, visitor.id %>
                           <%= f.submit "Flag", class: "tg-btn tg-btn--danger" %>
                           <%= f.text_field :flag_reason, placeholder: "Flag reason (optional)", class: "tg-input", autocomplete: "off" %>
+                          <%= f.text_field :name, placeholder: "Name (optional, auto-detected if blank)", class: "tg-input", autocomplete: "off" %>
                         <% end %>
                       <% end %>
                     </div>
@@ -87,6 +88,10 @@
                           <span class="tg-dl__term">User agent</span>
                           <span class="tg-dl__def tg-dl__def--break"><%= visitor&.user_agent.presence || "—" %></span>
                         </div>
+                        <div class="tg-dl__row">
+                          <span class="tg-dl__term">Name</span>
+                          <span class="tg-dl__def"><%= visitor&.name.presence || "—" %></span>
+                        </div>
                         <div class="tg-dl__row">
                           <span class="tg-dl__term">Flag status</span>
                           <% if flagged %>

data/db/migrate/20260505191009_add_name_to_trackguard_visitors.rb

@@ -0,0 +1,5 @@
+class AddNameToTrackguardVisitors < ActiveRecord::Migration[8.0]
+  def change
+    add_column :trackguard_visitors, :name, :string
+  end
+end

data/lib/generators/trackguard/templates/add_visitor_name.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+class AddVisitorName < ActiveRecord::Migration[<%= ActiveRecord::Migration.current_version %>]
+  def change
+    add_column :trackguard_visitors, :name, :string
+  end
+end

data/lib/generators/trackguard/upgrade_generator.rb

@@ -15,6 +15,10 @@ module Trackguard
       migration_template "add_trackguard_visits.rb", "db/migrate/add_trackguard_visits.rb"
     end
 
+    def create_visitor_name_migration_file
+      migration_template "add_visitor_name.rb", "db/migrate/add_visitor_name.rb"
+    end
+
     def print_next_steps
       say "\nNext steps:", :green
       say "  1. rails db:migrate"

data/lib/trackguard/adapters/base.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Trackguard
+  module Adapters
+    class Base
+      def blocked_user_agent?(user_agent) = raise NotImplementedError, "#{self.class}#blocked_user_agent?"
+      def whitelisted_ip?(ip)             = raise NotImplementedError, "#{self.class}#whitelisted_ip?"
+      def flagged_visitor?(ip)            = raise NotImplementedError, "#{self.class}#flagged_visitor?"
+
+      def track_page_view(path:, ip:, user_agent:, referer:, session_id:, trace_id:, source:, initial:, http_method:)
+        raise NotImplementedError, "#{self.class}#track_page_view"
+      end
+
+      def track_blocked_request(ip:, user_agent:, path:, http_method:, block_reason:)
+        raise NotImplementedError, "#{self.class}#track_blocked_request"
+      end
+    end
+  end
+end

data/lib/trackguard/adapters/local.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Trackguard
+  module Adapters
+    class Local < Base
+      def blocked_user_agent?(user_agent)
+        BlockedUserAgent.blocked?(user_agent)
+      end
+
+      def whitelisted_ip?(ip)
+        WhitelistedIp.whitelisted?(ip)
+      end
+
+      def flagged_visitor?(ip)
+        Visitor.flagged?(ip)
+      end
+
+      def track_page_view(path:, ip:, user_agent:, referer:, session_id:, trace_id:, source:, initial:, http_method:)
+        TrackPageViewJob.perform_later(
+          path: path,
+          ip: ip,
+          user_agent: user_agent,
+          referer: referer,
+          session_id: session_id,
+          trace_id: trace_id,
+          source: source,
+          initial: initial,
+          http_method: http_method
+        )
+      end
+
+      def track_blocked_request(ip:, user_agent:, path:, http_method:, block_reason:)
+        TrackBlockedRequestJob.perform_later(
+          ip: ip,
+          user_agent: user_agent,
+          path: path,
+          http_method: http_method,
+          block_reason: block_reason
+        )
+      end
+    end
+  end
+end

data/lib/trackguard/rack_attack.rb

@@ -5,20 +5,22 @@ require "rack/attack"
 module Trackguard
   module RackAttack
     def self.configure
+      adapter = Trackguard.adapter
+
       ::Rack::Attack.safelist("trackguard/allow local") do |req|
         [ "127.0.0.1", "::1" ].include?(req.ip)
       end
 
       ::Rack::Attack.safelist("trackguard/allow whitelisted ips") do |req|
-        Trackguard::WhitelistedIp.whitelisted?(req.ip)
+        adapter.whitelisted_ip?(req.ip)
       end
 
       ::Rack::Attack.blocklist("trackguard/block known scanners") do |req|
-        Trackguard::BlockedUserAgent.blocked?(req.user_agent)
+        adapter.blocked_user_agent?(req.user_agent)
       end
 
       ::Rack::Attack.blocklist("trackguard/flagged visitors") do |req|
-        Trackguard::Visitor.flagged?(req.ip)
+        adapter.flagged_visitor?(req.ip)
       end
 
       ::Rack::Attack.throttle(
@@ -27,15 +29,15 @@ module Trackguard
         period: Trackguard.throttle_period, &:ip
       )
 
-      subscribe_to_blocked_requests
+      subscribe_to_blocked_requests(adapter)
     end
 
-    def self.subscribe_to_blocked_requests
+    def self.subscribe_to_blocked_requests(adapter)
       @subscribe_to_blocked_requests ||= ActiveSupport::Notifications.subscribe("rack.attack") do |*, payload|
         req = payload[:request]
         next unless req.env["rack.attack.match_type"] == :blocklist
 
-        Trackguard::TrackBlockedRequestJob.perform_later(
+        adapter.track_blocked_request(
           ip: req.ip,
           user_agent: req.user_agent.to_s,
           path: req.path,

data/lib/trackguard/version.rb

@@ -1,3 +1,3 @@
 module Trackguard
-  VERSION = "0.16.1".freeze
+  VERSION = "0.19.0".freeze
 end

data/lib/trackguard.rb

@@ -3,6 +3,8 @@
 require "trackguard/version"
 require "trackguard/engine"
 require "trackguard/rack_attack"
+require "trackguard/adapters/base"
+require "trackguard/adapters/local"
 
 module Trackguard
   class << self
@@ -36,5 +38,23 @@ module Trackguard
     def throttle_period
       @throttle_period ||= 60
     end
+
+    def adapter
+      @adapter ||= Trackguard::Adapters::Local.new
+    end
+
+    def adapter=(value)
+      @adapter = resolve_adapter(value)
+    end
+
+    private
+
+    def resolve_adapter(value)
+      case value
+      when Symbol then Trackguard::Adapters.const_get(value.to_s.camelize).new
+      when Class  then value.new
+      else             value
+      end
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: trackguard
 version: !ruby/object:Gem::Version
-  version: 0.16.1
+  version: 0.19.0
 platform: ruby
 authors:
 - Krzysztof Rygielski
@@ -43,6 +43,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- app/assets/images/trackguard/logo.png
 - app/assets/javascripts/controllers/page_tracker_controller.js
 - app/assets/stylesheets/trackguard/admin.css
 - app/controllers/concerns/trackguard/page_tracker.rb
@@ -72,12 +73,16 @@ files:
 - app/views/trackguard/admin/visits/index.html.erb
 - config/importmap.rb
 - config/routes.rb
+- db/migrate/20260505191009_add_name_to_trackguard_visitors.rb
 - lib/generators/trackguard/install_generator.rb
 - lib/generators/trackguard/templates/add_trackguard_visits.rb
+- lib/generators/trackguard/templates/add_visitor_name.rb
 - lib/generators/trackguard/templates/create_trackguard_tables.rb
 - lib/generators/trackguard/upgrade_generator.rb
 - lib/tasks/trackguard.rake
 - lib/trackguard.rb
+- lib/trackguard/adapters/base.rb
+- lib/trackguard/adapters/local.rb
 - lib/trackguard/engine.rb
 - lib/trackguard/rack_attack.rb
 - lib/trackguard/version.rb