acts_as_active 0.1.3 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f32379b025f2eecaca909f9ea2fa6289cd353f480141fe8494e4179f339254b8
-  data.tar.gz: be503eaf4cbf750cd66ab8eab07323050d6fee1e172e7eb5d01678418969cb0f
+  metadata.gz: c452d929cd97ab9aa78b33e2b6f470c05e54ef62771b5ab4b7894c567dfd0549
+  data.tar.gz: 26205d4a6a40162ee0ca68a9e0d622d802aecf4de082dc324ebb4403be3c1db5
 SHA512:
-  metadata.gz: a546e8ca4ba37b06556559b763fae3433a8a23fa7eb1e2d2a5e3c845cd3b8072b95226463c3329cb390fbde29484f86a834932555cdc4be98aa1f775896411bb
-  data.tar.gz: dfaae1ec7b0ce78e65bd218dcd01eac9e8048f90ec8597feeaea9ecbc311b397a303d11714b62ca4d2910563e9d573017cf73775525efefabec7b0e2b1e383f0
+  metadata.gz: ebc15ecf2c2ba7b55c53c6bce2d32b8c37b15602e0cf4685425337e66e42d9df5c0f11ee58c5d8813d637fd290706230b233df5c87982808ccebe9d22e871abd
+  data.tar.gz: 1043c825d41ad29fa487ade82b69be49cecb1810c05229282b1e1ff1fdd28a95d0a6190d58918b21344f722bac8911a916e27224396275e47c3e5d7739bc9ac0

data/README.md

@@ -18,19 +18,26 @@ If bundler is not being used to manage dependencies, install the gem by executin
 gem install acts_as_active
 ```
 
+Generators: ActsAsActive supports a metadata field in either json or jsonb format, depending on your database and preference (MySQL or PostgreSQL).
+
+```bash
+rails g acts_as_active:install --metadata=json/jsonb/auto
+```
+
 ## Usage
 
 ```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) { activity.update(metadata: {be: "BOP!"}) }   # ➜ 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
@@ -46,6 +53,50 @@ 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
+```
+
+## Metadata usage
+
+PostgreSQL
+
+```ruby
+# Where metadata contains key/value
+ActsAsActive::Activity.where("metadata @> ?", { source: "api" }.to_json)
+
+# Where nested key/value
+ActsAsActive::Activity.where("metadata @> ?", { user: { id: 42 } }.to_json)
+```
+
+MySQL/SQLite
+
+```ruby
+# MySQL: Find where metadata->source == 'api'
+ActsAsActive::Activity.where("JSON_UNQUOTE(JSON_EXTRACT(metadata, '$.source')) = ?", "api")
+
+# SQLite (with JSON1 extension):
+ActsAsActive::Activity.where("json_extract(metadata, '$.source') = ?", "api")
+```
+
+Writing to metadata
+
+```ruby
+activity.update!(
+  metadata: {
+    source: "api",
+    user: { id: 42, name: "Amit" },
+    tags: ["Dig", "Be", "Bop"]
+  }
+)
+```
+
 ## Run Tests
 
 ```bash

data/lib/acts_as_active/activable.rb

@@ -14,7 +14,9 @@ module ActsAsActive
     def acts_as_active(options = {})
       has_many :activities, as: :trackable, class_name: "ActsAsActive::Activity"
 
-      events      = Array(options[:on] || SUPPORTED_EVENTS) & SUPPORTED_EVENTS
+      @acts_as_active_after_record = options[:after_record]
+      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.3"
+  VERSION = "0.3.0"
 end

data/lib/generators/acts_as_active/install_generator.rb

@@ -4,17 +4,21 @@ require "rails/generators/migration"
 module ActsAsActive
   module Generators
     class InstallGenerator < Rails::Generators::Base
+      desc "Generates the migration for ActsAsActive"
       include Rails::Generators::Migration
 
+      class_option :metadata, type: :string, default: "auto", desc: "jsonb|json|none|auto"
       source_root File.expand_path("templates", __dir__)
-      desc "Generates the migration for ActsAsActive"
 
       def self.next_migration_number(dirname)
         Time.now.utc.strftime("%Y%m%d%H%M%S")
       end
 
       def copy_migration
-        migration_template "create_activities.rb", "db/migrate/create_activities.rb"
+        @metadata_choice = normalize_metadata_choice(options[:metadata])
+        puts "!!! metadata_choice #{@metadata_choice}"
+        @adapter_name    = (ActiveRecord::Base.connection.adapter_name rescue "Unknown")
+        migration_template "create_acts_as_active_activities.rb.erb", "db/migrate/create_acts_as_active_activities.rb"
         create_model
       end
 
@@ -30,6 +34,15 @@ module ActsAsActive
           end
         RUBY
       end
+
+      private
+
+      def normalize_metadata_choice(choice)
+        case choice&.downcase
+        when "jsonb", "json", "none" then choice.downcase
+        else "auto"
+        end
+      end
     end
   end
 end

data/lib/generators/acts_as_active/templates/create_acts_as_active_activities.rb.erb

@@ -0,0 +1,40 @@
+ class CreateActsAsActiveActivities < ActiveRecord::Migration[7.1]
+  def change
+    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
+<%
+  adapter = @adapter_name.to_s
+  choice  = @metadata_choice
+
+  def pg?(name) = name =~ /PostgreSQL/i
+  col_type =
+    if choice == "jsonb" || (choice == "auto" && pg?(adapter))
+      :jsonb
+    elsif choice == "json"
+      :json
+    elsif choice == "auto"
+      :json
+    else
+      nil
+    end
+%>
+
+<% if col_type %>
+      t.<%= col_type %> :metadata, null: false, default: {}
+<% end %>
+      t.timestamps
+    end
+
+    add_index :acts_as_active_activities,
+              %i[trackable_type trackable_id occurred_on],
+              unique: true, name: "idx_aaa_trackable_on_day"
+<% if col_type == :jsonb && pg?(@adapter_name) %>
+    add_index :acts_as_active_activities, :metadata, using: :gin
+<% end %>
+
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: acts_as_active
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.3.0
 platform: ruby
 authors:
 - Amit Leshed
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-11 00:00:00.000000000 Z
+date: 2025-08-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -69,7 +69,7 @@ files:
 - lib/acts_as_active/railtie.rb
 - lib/acts_as_active/version.rb
 - lib/generators/acts_as_active/install_generator.rb
-- lib/generators/acts_as_active/templates/create_activities.rb
+- lib/generators/acts_as_active/templates/create_acts_as_active_activities.rb.erb
 - sig/acts_as_active.rbs
 homepage: https://www.amitleshed.com
 licenses:

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

@@ -1,15 +0,0 @@
-class CreateActivities < ActiveRecord::Migration[7.1]
-  def change
-    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 :acts_as_active_activities, [:trackable_type, :trackable_id, :occurred_on], unique: true, name: "index_activities_on_trackable_and_occurred_on"
-  end
-end