newshound 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c59db21db9a10838f80bf529e985a4cb1af723bcf86ba4893db0d597b1a10059
-  data.tar.gz: 66a6aa516fc12f6c7003ed286c0ffaef9fc7112c2d659b96a927b09de53c0a54
+  metadata.gz: 79ace59ee869878db3221ca5d851c9bf10ae50354877d6b4a2b57ccc9489319e
+  data.tar.gz: 9a0e6d98ce5ac41b433c19d66ae920b207c090d7550df505645068c46f627feb
 SHA512:
-  metadata.gz: 210e8a10e784ab3a72a34291465faf6c2f213a332eca30d392561609a0316a7c28e30ae532a814bf4eca2f42fb630ed43ce8dcc4c2db458d05267fc14419c5ac
-  data.tar.gz: 6de9641e2cfb691ccb94c4185c54dabaa78d9d92ac57e173eed5087ebb5c0dd5e468c81f79d2ca83b20376bc2d29e9137e766354028493c568c0d24eca615b07
+  metadata.gz: 7124a65e125a08eea643486de24db7e84436c981ccd6e9c6fa12b205b33f1e2e30b062d38c766ab0f9df18bda79fd3d093b5bfccf23b5d9938b0c45e45d6a23e
+  data.tar.gz: d414aa404515671d71525214ebe0f601e456c6704e5bfccf29a49246454ea9f9d83e899576db2903cfe4d0491b8255a915d6b17a4c5cdefb879d5318b0476f66

data/.tool-versions

@@ -1 +1 @@
-ruby 3.4.3
+ruby 4.0.1

data/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.1] - 2026-03-17
+
+### Changed
+
+- The authorize_with initializer will generate with the method inside the configure block. (2d6ef48)
+
+### Added
+
+- Configurable banner links for exceptions, jobs, and warnings via string path patterns (1df1636)
+- Record ID in format_for_banner output for linking to individual records (e06d040)
+
 ## [0.2.8] - 2026-02-10
 
 ### Changed
@@ -30,5 +41,3 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Jobs::Que adapter for Que job backend (c50ba9c)
 - JobReporter that delegates to a configurable job source adapter (c50ba9c)
 - ExceptionReporter#formatted_exception_count and #exception_summary helpers (e440188)
-
-## [0.2.7] - 2026-01-30

data/lib/generators/newshound/install/templates/newshound.rb

@@ -28,14 +28,36 @@ Newshound.configure do |config|
   # Most apps use :current_user (Devise, etc.)
   # Default is :current_user
   config.current_user_method = :current_user
-end
 
-# Advanced: Custom authorization logic
-# If the default role-based authorization doesn't fit your needs,
-# you can provide a custom authorization block:
-#
-# Newshound.authorize_with do |controller|
-#   # Your custom logic here
-#   # Return true to show the banner, false to hide it
-#   controller.current_user&.admin?
-# end
+  # Links for banner items
+  # Configure paths so banner items link to your exception/job dashboards.
+  # Use :id in show paths to interpolate the record ID.
+  #
+  # config.exception_links = {
+  #   index: "/errors",
+  #   show: "/errors/:id"
+  # }
+  #
+  # config.job_links = {
+  #   index: "/background_jobs",
+  #   show: "/background_jobs/jobs/:id",
+  #   scheduled: "/background_jobs/scheduled",
+  #   failed: "/background_jobs/failed",
+  #   completed: "/background_jobs/completed"
+  # }
+  #
+  # config.warning_links = {
+  #   index: "/warnings",
+  #   show: "/warnings/:id"
+  # }
+
+  # Custom authorization logic:
+  # If the default role-based authorization doesn't fit your needs,
+  # you can provide a custom authorization block:
+  #
+  # config.authorize_with do |controller|
+  #   # Your custom logic here
+  #   # Return true to show the banner, false to hide it
+  #   controller.current_user&.admin?
+  # end
+end

data/lib/newshound/configuration.rb

@@ -4,7 +4,8 @@ module Newshound
   class Configuration
     attr_accessor :exception_limit, :enabled, :authorized_roles,
       :current_user_method, :authorization_block, :exception_source,
-      :warning_source, :warning_limit, :job_source
+      :warning_source, :warning_limit, :job_source,
+      :exception_links, :job_links, :warning_links
 
     def initialize
       @exception_limit = 10
@@ -16,6 +17,9 @@ module Newshound
       @warning_source = nil
       @warning_limit = 10
       @job_source = nil
+      @exception_links = {}
+      @job_links = {}
+      @warning_links = {}
     end
 
     # Allow custom authorization logic

data/lib/newshound/exceptions/base.rb

@@ -31,7 +31,7 @@ module Newshound
       # Formats an exception for banner UI display
       #
       # @param exception [Object] Exception record from the tracking system
-      # @return [Hash] Hash with keys: :title, :message, :location, :time
+      # @return [Hash] Hash with keys: :id, :title, :message, :location, :time
       def format_for_banner(exception)
         raise NotImplementedError, "#{self.class} must implement #format_for_banner"
       end

data/lib/newshound/exceptions/exception_track.rb

@@ -23,6 +23,7 @@ module Newshound
         details = parse_exception_details(exception)
 
         {
+          id: exception.try(:id),
           title: details[:title],
           message: details[:message].truncate(100),
           location: details[:location],

data/lib/newshound/exceptions/solid_errors.rb

@@ -23,6 +23,7 @@ module Newshound
         details = parse_exception_details(exception)
 
         {
+          id: exception.try(:error)&.id || exception.try(:id),
           title: details[:title],
           message: details[:message].truncate(100),
           location: details[:location],

data/lib/newshound/middleware/banner_injector.rb

@@ -276,6 +276,20 @@ module Newshound
               text-transform: uppercase;
               letter-spacing: 0.5px;
             }
+            .newshound-link {
+              color: inherit;
+              text-decoration: none;
+            }
+            .newshound-link:hover {
+              text-decoration: underline;
+            }
+            a.newshound-stat {
+              color: inherit;
+              text-decoration: none;
+            }
+            a.newshound-stat:hover {
+              background: rgba(255,255,255,0.2);
+            }
           </style>
         CSS
       end
@@ -309,23 +323,11 @@ module Newshound
           return %(<div class="newshound-section"><div class="newshound-section-title">✅ Exceptions</div><div class="newshound-item">No exceptions in the last 24 hours</div></div>)
         end
 
-        items = exceptions.take(5).map do |ex|
-          <<~HTML
-            <div class="newshound-item">
-              <div class="newshound-item-title">#{escape_html(ex[:title])}</div>
-              <div class="newshound-item-detail">
-                #{escape_html(ex[:message])} • #{escape_html(ex[:location])} • #{escape_html(ex[:time])}
-              </div>
-            </div>
-          HTML
-        end.join
-
-        <<~HTML
-          <div class="newshound-section">
-            <div class="newshound-section-title">⚠️ Recent Exceptions (#{exceptions.length})</div>
-            #{items}
-          </div>
-        HTML
+        render_item_section(
+          items: exceptions,
+          links: Newshound.configuration.exception_links,
+          title: "⚠️ Recent Exceptions (#{exceptions.length})"
+        )
       end
 
       def render_warnings(data)
@@ -333,53 +335,81 @@ module Newshound
 
         return "" if warnings.empty?
 
-        items = warnings.take(5).map do |w|
-          <<~HTML
-            <div class="newshound-item">
-              <div class="newshound-item-title">#{escape_html(w[:title])}</div>
-              <div class="newshound-item-detail">
-                #{escape_html(w[:message])} • #{escape_html(w[:location])} • #{escape_html(w[:time])}
-              </div>
+        render_item_section(
+          items: warnings,
+          links: Newshound.configuration.warning_links,
+          title: "⚠️ Warnings (#{warnings.length})"
+        )
+      end
+
+      def render_item_section(items:, links:, title:)
+        rendered_items = items.take(5).map do |item|
+          item_content = <<~HTML
+            <div class="newshound-item-title">#{escape_html(item[:title])}</div>
+            <div class="newshound-item-detail">
+              #{escape_html(item[:message])} • #{escape_html(item[:location])} • #{escape_html(item[:time])}
             </div>
           HTML
+
+          if links[:show] && item[:id]
+            url = links[:show].gsub(":id", item[:id].to_s)
+            %(<a href="#{escape_html(url)}" class="newshound-link"><div class="newshound-item">#{item_content}</div></a>)
+          else
+            %(<div class="newshound-item">#{item_content}</div>)
+          end
         end.join
 
+        title_html = if links[:index]
+          %(<a href="#{escape_html(links[:index])}" class="newshound-link">#{title}</a>)
+        else
+          title
+        end
+
         <<~HTML
           <div class="newshound-section">
-            <div class="newshound-section-title">⚠️ Warnings (#{warnings.length})</div>
-            #{items}
+            <div class="newshound-section-title">#{title_html}</div>
+            #{rendered_items}
           </div>
         HTML
       end
 
       def render_jobs(data)
         stats = data[:queue_stats] || {}
+        links = Newshound.configuration.job_links
+
+        section_title = "📊 Job Queue Status"
+        title_html = if links[:index]
+          %(<a href="#{escape_html(links[:index])}" class="newshound-link">#{section_title}</a>)
+        else
+          section_title
+        end
 
         <<~HTML
           <div class="newshound-section">
-            <div class="newshound-section-title">📊 Job Queue Status</div>
+            <div class="newshound-section-title">#{title_html}</div>
             <div class="newshound-grid">
-              <div class="newshound-stat">
-                <span class="newshound-stat-value">#{stats[:ready_to_run] || 0}</span>
-                <span class="newshound-stat-label">Ready</span>
-              </div>
-              <div class="newshound-stat">
-                <span class="newshound-stat-value">#{stats[:scheduled] || 0}</span>
-                <span class="newshound-stat-label">Scheduled</span>
-              </div>
-              <div class="newshound-stat">
-                <span class="newshound-stat-value">#{stats[:failed] || 0}</span>
-                <span class="newshound-stat-label">Failed</span>
-              </div>
-              <div class="newshound-stat">
-                <span class="newshound-stat-value">#{stats[:completed_today] || 0}</span>
-                <span class="newshound-stat-label">Completed Today</span>
-              </div>
+              #{render_job_stat(stats[:ready_to_run] || 0, "Ready", links[:index])}
+              #{render_job_stat(stats[:scheduled] || 0, "Scheduled", links[:scheduled])}
+              #{render_job_stat(stats[:failed] || 0, "Failed", links[:failed])}
+              #{render_job_stat(stats[:completed_today] || 0, "Completed Today", links[:completed])}
             </div>
           </div>
         HTML
       end
 
+      def render_job_stat(value, label, link)
+        content = <<~HTML
+          <span class="newshound-stat-value">#{value}</span>
+          <span class="newshound-stat-label">#{label}</span>
+        HTML
+
+        if link
+          %(<a href="#{escape_html(link)}" class="newshound-stat">#{content}</a>)
+        else
+          %(<div class="newshound-stat">#{content}</div>)
+        end
+      end
+
       def escape_html(text)
         return +"" unless text.present?
         text.to_s

data/lib/newshound/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Newshound
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end

data/lib/newshound/warnings/base.rb

@@ -33,7 +33,7 @@ module Newshound
       # Formats a warning for banner UI display
       #
       # @param warning [Object] Warning record from the data source
-      # @return [Hash] Hash with keys: :title, :message, :location, :time
+      # @return [Hash] Hash with keys: :id, :title, :message, :location, :time
       def format_for_banner(warning)
         raise NotImplementedError, "#{self.class} must implement #format_for_banner"
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: newshound
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Savannah Moore
@@ -87,7 +87,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Real-time web UI banner for monitoring background jobs and exception tracking
 test_files: []