rails_analytics 1.0.3 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f985132b2aa456db104a03635f1d8334772e8a5c8e3902319d111082d7a5f5b5
-  data.tar.gz: 8b4b04a1bab3a4c15b0cff8f44892146f5469713e325266054e8e23131937c8e
+  metadata.gz: 20ebdf5f4a45c3f8cad6c9e607be2d5eeaccb7669311c6f86b619aa2f76992dd
+  data.tar.gz: 36b3978273cb8d054fec49443cc5f7ea5e3cb83c18a2c63f3a60a706dd402616
 SHA512:
-  metadata.gz: 277a1e2be087cae4e5f511af0c3f3d56051ad625fadfe643356ae0697fbe6f353c8eef2a9e59c842899d051abdc232a93eea22f1faa4e631fb8fbe4ee0e29a1f
-  data.tar.gz: c1968ddf6c68fc5dee7856f61ffc94345da3855ee2d0d4188ca04756802ca47afbb252770014e96c567490180be008dedd87244e7c980b669f507c53c44e519a
+  metadata.gz: 15d271dfdeae4344ed730fcc9bf467f962180e6093d219152d2d863f4556e6f1df113b9a91b0bab7b61e0011823a3b3a39890fd953905e7ecccf2e1a761758dc
+  data.tar.gz: 9347e3775bec41f15af5a827ee148da0fd2fbbf91c3429b0cbf6807fc5da4f3208e1fed835a78ba79e9fabc44b66042aec0963d296a62ff6f5a1fec881a37c66

data/README.md

@@ -88,20 +88,25 @@ Done — collection is automatic and the dashboard lives at **`/analytics`** (or
 
 ## Mounting
 
-You can mount the engine at any path:
+The engine's mount point is **a single configuration** — the `mount` line in
+`config/routes.rb`. There is no separate `mount_path` to keep in sync: the tracker tag,
+the dashboard CSS and the collect endpoint all derive their URLs from the engine's own
+route helpers at runtime, so they follow whatever path you mount the engine at.
 
 ```ruby
 # config/routes.rb
-mount RailsAnalytics::Engine => "/analytics"
+mount RailsAnalytics::Engine => "/analytics"   # default
+# mount RailsAnalytics::Engine => "/admin/analytics"  # any custom path works
 ```
 
 ```erb
 <!-- layout -->
-<%= rails_analytics_tracker_tag endpoint: "/analytics" %>
+<%= rails_analytics_tracker_tag %>
 ```
 
-> The `endpoint:` passed to the helper must match the path the engine is mounted at.
-> You can also set a global default via `RailsAnalytics.configure { |c| c.mount_path = "/analytics" }`.
+> No need to pass an `endpoint:` to the helper — it resolves the mount automatically.
+> The only exception is serving the tracker from a CDN:
+> `<%= rails_analytics_tracker_tag endpoint: "/cdn/path" %>`.
 
 ## Authentication
 

data/app/helpers/rails_analytics/application_helper.rb

@@ -2,9 +2,15 @@
 
 module RailsAnalytics
   module ApplicationHelper
+    # Single source of truth: the engine's mount point is whatever the host
+    # declared in routes.rb (`mount RailsAnalytics::Engine => "/..."`). We derive
+    # the tracker endpoint from the engine's own route helper, so there is no
+    # separate `mount_path` to keep in sync. `options[:endpoint]` still allows an
+    # explicit override (e.g. when serving the tracker from a CDN).
     def rails_analytics_tracker_tag(options = {})
-      endpoint = options[:endpoint] || RailsAnalytics.config.mount_path
-      tag.script(src: "#{endpoint}/tracker.js",
+      tracker = options[:tracker] || rails_analytics.tracker_path
+      endpoint = options[:endpoint] || rails_analytics.root_path.chomp("/")
+      tag.script(src: tracker,
                  data: { rails_analytics: true, endpoint: endpoint },
                  defer: true)
     end

data/config/routes.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 RailsAnalytics::Engine.routes.draw do
-  get "tracker.js" => "analytics#tracker"
+  get "tracker.js" => "analytics#tracker", as: "tracker"
   get "dashboard.css" => "analytics#dashboard_css", as: "dashboard_css"
   post "collect" => "analytics#collect"
   get  "token" => "analytics#token"

data/lib/generators/rails_analytics/install/install_generator.rb

@@ -6,6 +6,11 @@ module RailsAnalytics
       source_root File.expand_path("templates", __dir__)
       desc "Instala o rails_analytics: copia migrations, monta engine, cria initializer e pina tracker no importmap."
 
+      # The only mount configuration that matters is the `mount` line this generator
+      # writes into config/routes.rb. Changing that line is enough — the tracker and
+      # dashboard derive their URLs from the engine's route helpers at runtime.
+      DEFAULT_MOUNT_PATH = "/analytics"
+
       def copy_migrations
         migrations_dir = RailsAnalytics::Engine.root.join("db/migrate")
         Dir["#{migrations_dir}/*.rb"].sort.each do |migration|
@@ -21,20 +26,20 @@ module RailsAnalytics
       end
 
       def mount_engine
-        route %(mount RailsAnalytics::Engine => RailsAnalytics.config.mount_path)
-        say_status :ok, "Engine montada em config/routes.rb"
+        route %(mount RailsAnalytics::Engine => "#{DEFAULT_MOUNT_PATH}")
+        say_status :ok, "Engine montada em config/routes.rb (montada em #{DEFAULT_MOUNT_PATH})"
       end
 
       def pin_tracker
         importmap_path = "config/importmap.rb"
         if File.exist?(importmap_path)
           unless File.read(importmap_path).include?("rails_analytics/tracker")
-            append_to_file importmap_path, %(\npin "rails_analytics/tracker", to: RailsAnalytics.config.mount_path + "/tracker.js"\n)
+            append_to_file importmap_path, %(\npin "rails_analytics/tracker", to: "#{DEFAULT_MOUNT_PATH}/tracker.js"\n)
             say_status :ok, "Tracker pinado em config/importmap.rb"
           end
         else
           say_status :skipped, "config/importmap.rb não encontrado — adicione manualmente:", :yellow
-          say %(  Adicione ao seu layout: <script src="<%= RailsAnalytics.config.mount_path %>/tracker.js" defer></script>), :yellow
+          say %(  Adicione ao seu layout: <script src="#{DEFAULT_MOUNT_PATH}/tracker.js" defer></script>), :yellow
         end
       end
 
@@ -42,7 +47,7 @@ module RailsAnalytics
         say "\n✅ rails_analytics instalado! Próximos passos:", :green
         say "  1. bin/rails db:migrate"
         say "  2. Configure a autenticação no initializer: config/initializers/rails_analytics.rb"
-        say "  3. Acesse o dashboard em #{RailsAnalytics.config.mount_path}"
+        say "  3. Acesse o dashboard em #{DEFAULT_MOUNT_PATH} (se quiser outro path, edite o mount em config/routes.rb)"
         say ""
       end
     end

data/lib/generators/rails_analytics/install/templates/initializer.rb

@@ -5,10 +5,6 @@ RailsAnalytics.configure do |config|
   # Pode ser um Symbol (ex: :authenticate_admin!) ou um callable (ex: -> { current_user&.admin? }).
   config.auth_callback = :authenticate_admin!
 
-  # Caminho onde o engine é montado (debe coincidir com el mount en config/routes.rb).
-  # Padrão: "/analytics". Puedes cambiarlo libremente (ex: "/admin/analytics").
-  config.mount_path = "/analytics"
-
   # Período padrão para as consultas do dashboard (ex: 30.days).
   config.since_default = 30.days
 end

data/lib/rails_analytics/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsAnalytics
-  VERSION = "1.0.3"
+  VERSION = "1.0.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_analytics
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.0.4
 platform: ruby
 authors:
 - br4zz4