gem "rails-persona", "~> 0.2.7"

class User < ApplicationRecord
  include Persona::Trackable

  persona do
    track :login
    track :export_report
    track :view_dashboard
    track :upgrade_plan
  end
end

# In a controller, service, or job:
current_user.track!(:login)
current_user.track!(:upgrade_plan, metadata: { plan: "pro", amount: 49 })

user.action_count(:login)          # => 42
user.most_frequent_action          # => :login
user.least_frequent_action         # => :upgrade_plan
user.top_actions(3)                # => { login: 42, view_dashboard: 18, export_report: 5 }
user.last_action                   # => :export_report
user.last_active_at                # => 2024-05-30 14:22 UTC
user.first_action                  # => :login
user.first_active_at               # => 2023-01-10 08:00 UTC
user.inactive_since?               # => false  (default threshold: 30 days)
user.inactive_since?(7)            # => false  (custom: 7 days)
user.days_since_last_activity      # => 2
user.ever_did?(:export_report)     # => true
user.never_did?(:upgrade_plan)     # => false
user.action_share(:login)          # => 64.6  (% of all events)
user.total_events                  # => 65

user.persona_summary
# => { login: 42, view_dashboard: 18, export_report: 5, upgrade_plan: 1 }

user.actions_between(1.week.ago, Time.current)
# => { login: 7, view_dashboard: 3 }

user.activity_log(5)
# => [
#      { action: :export_report, at: 2024-05-30 14:22:00, metadata: {} },
#      { action: :login,         at: 2024-05-30 09:01:00, metadata: {} },
#    ]

user.daily_activity(30)
# => { "2024-05-28" => 4, "2024-05-29" => 7, "2024-05-30" => 2 }

user.peak_hour
# => 14  (2pm is when this user is most active)

# Top 10 most active users
User.persona_leaderboard(limit: 10)
# => [
#      { record: #<User id=4>, total_events: 128 },
#      { record: #<User id=9>, total_events: 97 },
#    ]

# App-wide breakdown of all user actions
User.persona_class_summary
# => { login: 8420, view_dashboard: 5210, export_report: 820 }

user.bulk_track!([:login, :view_dashboard, :export_report])
user.bulk_track!([:login, :login, :login])  # track repeated actions

# config/initializers/persona.rb
Persona.configure do |config|
  config.async = true   # fires a Sidekiq job instead of writing inline
end

class Post < ApplicationRecord
  include Persona::Trackable

  persona do
    open_tracking!  # any string is valid — no UntrackedActionError raised
  end
end

post.track!("custom_#{SecureRandom.hex(4)}")  # works fine

class Post < ApplicationRecord
  include Persona::Trackable

  persona do
    track :viewed
    track :shared
    track :bookmarked
  end
end

post.track!(:viewed)
post.action_count(:viewed)     # => 128
post.most_frequent_action      # => :viewed
Post.persona_class_summary     # => { viewed: 50_420, shared: 890, bookmarked: 210 }

# config/initializers/persona.rb
Persona.configure do |config|
  config.inactivity_threshold_days = 14     # default: 30
  config.max_events_per_record     = 500    # default: nil (unlimited)
  config.async                     = true   # default: false
  config.auto_prune_after_days     = 90     # default: nil (no auto-prune)
end

# Delete events older than 60 days for all records
Persona::Pruner.prune_older_than(60)

namespace :persona do
  desc "Prune old persona events"
  task prune: :environment do
    Persona::Pruner.prune_older_than(Persona.configuration.auto_prune_after_days || 90)
    puts "Pruned old persona events"
  end
end