rails_analytics 1.0.2 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee326c377ebf066fc7c66a085fb07592ddf2fa39f30179eb909d48c65ee33915
-  data.tar.gz: 61f43990d112ed3dd22c4476dd6ededc70a5f765c405231810f644ba2f4487d5
+  metadata.gz: 20ebdf5f4a45c3f8cad6c9e607be2d5eeaccb7669311c6f86b619aa2f76992dd
+  data.tar.gz: 36b3978273cb8d054fec49443cc5f7ea5e3cb83c18a2c63f3a60a706dd402616
 SHA512:
-  metadata.gz: 7e54ba03c1edd581608b4e486549b850946ff71b84aa8efa08f9e304fb42decd48e8e701029adb582177c385ccffd939b2cee37f2b751bf6a076f6fd82609632
-  data.tar.gz: 6acf884e9a7a3e831b90f77ff05c605e5e8322f81b4858d11867aedcb86f072f8e3cf219c5ead4248c560264bd39ec73793ab9c741f5adf5d347f00cecf77399
+  metadata.gz: 15d271dfdeae4344ed730fcc9bf467f962180e6093d219152d2d863f4556e6f1df113b9a91b0bab7b61e0011823a3b3a39890fd953905e7ecccf2e1a761758dc
+  data.tar.gz: 9347e3775bec41f15af5a827ee148da0fd2fbbf91c3429b0cbf6807fc5da4f3208e1fed835a78ba79e9fabc44b66042aec0963d296a62ff6f5a1fec881a37c66

data/README.md

@@ -42,8 +42,8 @@ dependencies.
 3. The engine verifies the token, **masks the IP** (before anything hits disk),
    derives a **daily anonymity key**, and stores a `Visit` row. Custom events are
    stored as `Event` rows linked to the visit.
-4. The **dashboard** in `/rails_analytics` shows aggregated metrics from pure SQL
-   queries in three views: overview, events, and visits.
+4. The **dashboard** at `/analytics` (default `mount_path`) shows aggregated metrics from
+    pure SQL queries in three views: overview, events, and visits.
 
 ## Requirements
 
@@ -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
 
@@ -236,7 +241,8 @@ cd test/dummy
 bin/rails server
 ```
 
-Then open:
+Then open (the bundled dummy mounts the engine at **`/rails_analytics`** as an example of a
+custom mount — the gem's default is `/analytics`):
 
 | URL | What you'll see |
 |-----|-----------------|

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,9 +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 será montado no routes.rb.
-  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.2"
+  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.2
+  version: 1.0.4
 platform: ruby
 authors:
 - br4zz4