acts_as_active 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4cbd00213b63afb3d4d25559eaa07f4055e6399a6970a6787ae39fb15836ea47
-  data.tar.gz: 55cc1dd443c1a269660177a6d97c369c22c6b9a312ac8f7e5214358843382d9a
+  metadata.gz: 8d77b8db36fd55b8e5a5fd11c5d3c66086ca2edc782802accbc6dd868f7edd0e
+  data.tar.gz: c815c49b4daaa44a2b2dc752c744016ca3125a31be46700342053270759be6b6
 SHA512:
-  metadata.gz: dfa7ac68afbba0acee383721b9409add97fe339ecb37958d13d136fa0fff0d63589153f77f01805bca11faa0914eef2fe0e9ae44c66ef71eafad3145be9a2eff
-  data.tar.gz: 3a0ed275fcbd798ff021cc2689e0c54b5dc43cd1f212dd28f149cb3ef619ff394d126388408c31bc00625762bf266c1b7aef194f3866b8a8d9828376cf2db183
+  metadata.gz: f2bd60fd0f26c0e240179e2980c552aa69a83907742a33e3d979530ac4613e0227ce3c7357017ff22baa81019617809997e7af9e8fe9e2d19375dc385e89002d
+  data.tar.gz: 4fad00c674233c6b94b4eb4f2dbd1fe6011ac414cfa5946c85c9f2d31596dcf207c034d58c15c61c81be93a3981b95ff613fc44979af0ecfc3f50819d187849a

data/README.md

@@ -1,6 +1,8 @@
 # ActsAsActive
 
-Acts As Active adds plug-and-play activity tracking to any ActiveRecord model, giving you instant daily stats, streak analytics, and heat-map–ready data.
+Acts As Active adds plug-and-play activity tracking to any ActiveRecord model, giving you instant daily stats, streak analytics, and heatmap-ready data.
+
+It works by automatically establishing a polymorphic association with your model and generating an Activity record for each specified lifecycle event.
 
 ## Installation
 
@@ -20,15 +22,16 @@ gem install acts_as_active
 
 ```ruby
 class Record < ApplicationRecord
-  acts_as_active on: [:create, :update],          # ➜ track different actions
-                 if:     -> { track_activity? },  # ➜ on different conditions
-                 unless: -> { skip_tracking? }
+  acts_as_active on: [:create, :update],                 # ➜ Track different actions
+                 if:           -> { track_activity? },   # ➜ On different conditions
+                 unless:       -> { skip_tracking? },
+                 after_record: -> ( activity ) { puts "Modified: #{activity}" }   # ➜ Hook: runs after an activity is created or updated
 end
 ```
 
 ```ruby
-record = Record.create!(title: "First draft")   # ➜ records activity for today
-record.update!(title: "Second draft")           # ➜ activity count for today = 2
+record = Record.create!(title: "First draft")   # ➜ Records activity for today
+record.update!(title: "Second draft")           # ➜ Activity count for today = 2
  
 
 record.active_today?                # => true
@@ -44,6 +47,22 @@ record.longest_streak   # => 3   (e.g. active 1-3 Aug)
 record.current_streak   # => 2   (e.g. active 5-6 Aug, still “on a streak” today)
 ```
 
+## Accessing Activities
+
+```ruby
+record = Record.find(1) 
+record.activities  # Accessing activities for a model that includes ActsAsActive
+
+ActsAsActive::Activity.where(trackable: record)  # Query the namespaced model directly
+ActsAsActive::Activity.all                       # Get all activities across all trackable types
+```
+
+## Run Tests
+
+```bash
+ruby -Ilib:ruby test/test_acts_as_active.rb
+```
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/amitleshed/acts_as_active. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/amitleshed/acts_as_active/blob/main/CODE_OF_CONDUCT.md).

data/lib/acts_as_active/activable.rb

@@ -12,9 +12,11 @@ module ActsAsActive
     SUPPORTED_EVENTS = %i[create update destroy].freeze
 
     def acts_as_active(options = {})
-      has_many :activities, as: :trackable, class_name: "Activity"
+      has_many :activities, as: :trackable, class_name: "ActsAsActive::Activity"
+
+      @acts_as_active_after_record = options[:after_record]
+      events = Array(options[:on] || SUPPORTED_EVENTS) & SUPPORTED_EVENTS
 
-      events      = Array(options[:on] || SUPPORTED_EVENTS) & SUPPORTED_EVENTS
       events.each do |ev|
         after_commit on: ev do |_ignored|
           should_run = true
@@ -25,6 +27,10 @@ module ActsAsActive
         end
       end
     end
+
+    def acts_as_active_after_record
+      @acts_as_active_after_record
+    end
   end
 
 
@@ -35,6 +41,11 @@ module ActsAsActive
     activity.count ||= 0
     activity.count  += 1
     activity.save!
+
+    hook = self.class.acts_as_active_after_record
+    hook&.call(activity)
+    
+    activity
   end
 end
 

data/lib/acts_as_active/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActsAsActive
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/acts_as_active.rb

@@ -6,5 +6,4 @@ require "acts_as_active/railtie" if defined?(Rails)
 
 module ActsAsActive
   class Error < StandardError; end
-  # Your code goes here...
 end

data/lib/generators/acts_as_active/install_generator.rb

@@ -19,9 +19,14 @@ module ActsAsActive
       end
 
       def create_model
-        create_file "app/models/activity.rb", <<~RUBY
-          class Activity < ApplicationRecord
-            belongs_to :trackable, polymorphic: true, class_name: "Activity"
+        create_file "app/models/acts_as_active/activity.rb", <<~RUBY
+          module ActsAsActive
+            class Activity < ApplicationRecord
+              self.table_name = "acts_as_active_activities"
+
+              belongs_to :trackable, polymorphic: true
+              belongs_to :actor, polymorphic: true, optional: true
+            end
           end
         RUBY
       end

data/lib/generators/acts_as_active/templates/create_activities.rb

@@ -1,14 +1,15 @@
 class CreateActivities < ActiveRecord::Migration[7.1]
   def change
-    create_table :activities do |t|
-      t.string  :trackable_type, null: false
-      t.bigint  :trackable_id,   null: false
-      t.date    :occurred_on,    null: false
-      t.integer :count,          null: false, default: 0
+    create_table :acts_as_active_activities do |t|
+      t.string     :trackable_type, null: false
+      t.bigint     :trackable_id,   null: false
+      t.references :actor, polymorphic: true, null: true
+      t.date       :occurred_on,    null: false
+      t.integer    :count,          null: false, default: 0
 
       t.timestamps
     end
 
-    add_index :activities, [:trackable_type, :trackable_id, :occurred_on], unique: true, name: "index_activities_on_trackable_and_occurred_on"
+    add_index :acts_as_active_activities, [:trackable_type, :trackable_id, :occurred_on], unique: true, name: "index_activities_on_trackable_and_occurred_on"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: acts_as_active
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Amit Leshed
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-08 00:00:00.000000000 Z
+date: 2025-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -71,12 +71,12 @@ files:
 - lib/generators/acts_as_active/install_generator.rb
 - lib/generators/acts_as_active/templates/create_activities.rb
 - sig/acts_as_active.rbs
-homepage: https://github.com/amitleshed/acts_as_active
+homepage: https://www.amitleshed.com
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/amitleshed/acts_as_active
-  source_code_uri: https://www.amitleshed.com
+  homepage_uri: https://www.amitleshed.com
+  source_code_uri: https://github.com/amitleshed/acts_as_active
 post_install_message:
 rdoc_options: []
 require_paths: