trackguard 0.17.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 79ebac148a49b2b6df9f280c3a8e8e624fa82910ccf0e3d4c608a04ac7f73ced
-  data.tar.gz: a0a0648dacb35df737e19413603d658b1c015f6e5fa60d0a6adc72da497082da
+  metadata.gz: 90c710c8d2149047c75e5b99151b708e9741e29385d17de7c4f101ad9db697cf
+  data.tar.gz: 49aaf485a932c241d9c18986120f639305485f4c316653923e9ad9a018566e01
 SHA512:
-  metadata.gz: 59d2f2a7dde041da4cc0acf29249c77d9f911a76c498f9381293c838a29bd6ac5fec3c875645c7be60b686d77cb99e4731032b45eb7a2a93464dadaac81b04cb
-  data.tar.gz: 5c1bf529774f1af5e8a7e83154e7e21b94e468c95702ac00bed7f0b133b85c092359e544e7f2f615d4e364d904e4512d16ad42d42e3c712d8f8dcb4b60cb81ae
+  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/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/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.17.0".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.17.0
+  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
@@ -80,6 +81,8 @@ files:
 - 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