beaconable 0.3.3 → 1.0.0.alpha

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91d63120af45f37b54ab3020114dd38b0d4e0b713905502a8f00c0897d998a70
-  data.tar.gz: 83665ce72cf9935939f831fac3b71c1182185dea3afe03087ff56e5b083a3c61
+  metadata.gz: 9802334bbbb09aa5c2e3645edccd67de7a0a275b90db63378bea6c1109db6cd9
+  data.tar.gz: '08c9da8e967b8db445922ff804d7ea9f1e61e47ff2a680bad5747a1f46e583ca'
 SHA512:
-  metadata.gz: 1c4e95173a8da6acb6ee8f7b9776ade78a074b3578c8127b6b97da6433110a191ad6fab8df609ee851005d3893d35cd305adf6d14068163a33d1b431b6947f99
-  data.tar.gz: 329e7e0710ec294b3f243116ea61b2afe9d823f853669eb7b24492e81a21e751afe98ea801f68b34e9fc2dab0186e0eb5c467bfbb08c03d40c923b5795af05f5
+  metadata.gz: 3e9f16be4ca9624b41e3763e40241709401a0bbcf530d5b3ee1b40006793bfba7187904b4eb732d51202d110b49187484954fc27d24a81a11997a5f46755b5f7
+  data.tar.gz: 331fe6033b16a1739f05ff33b509073b088640defe59144d4b010be30696d9f841593b208b77a11239c76fa4bfbc008d23c5f5f70e0d50e31c7152312e6a7c0d

data/.github/workflows/test.yml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        ruby-version: ['3.2', '3.3']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+
+      - name: Run tests
+        run: bundle exec rake test
+
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.3'
+          bundler-cache: true
+
+      - name: Run RuboCop
+        run: bundle exec rubocop

data/.rubocop.yml

@@ -0,0 +1,32 @@
+AllCops:
+  NewCops: enable
+  TargetRubyVersion: 3.2
+  SuggestExtensions: false
+  Exclude:
+    - "vendor/**/*"
+    - "bin/*"
+    - "*.gemspec"
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Style/Documentation:
+  Enabled: false
+
+Metrics/BlockLength:
+  Exclude:
+    - 'test/**/*'
+
+Metrics/ClassLength:
+  Exclude:
+    - 'test/**/*'
+
+Metrics/MethodLength:
+  Max: 15
+
+# We intentionally memoize @object_was in save_for_beacon
+Naming/MemoizedInstanceVariableName:
+  Enabled: false

data/CHANGELOG.md

@@ -1,3 +1,31 @@
+## 1.0.0.alpha (2025-12-17)
+
+### Breaking Changes
+
+- **Minimum Ruby version:** 3.2.0
+- **Minimum Rails version:** 7.0
+
+### Changed
+
+- Replaced `OpenStruct` with new `AttributeSnapshot` class for better performance and explicit immutability
+- `ObjectWas` now uses modern Rails 7+ dirty tracking API (`changes_to_save`) instead of iterating columns with `_was` methods
+- Updated development dependencies to modern versions
+- Fixed typo in gemspec: "patern" → "pattern"
+
+### Why this change?
+
+- `OpenStruct` is no longer auto-loaded in Ruby 3.2+ and shows deprecation warnings
+- Modern Rails provides cleaner dirty tracking APIs
+- This release marks the gem as stable and production-ready
+
+---
+
+## 0.3.4 (2022-03-14)
+
+### Improvements
+
+- Add `#beacon_metadata` & `#beacon_metadata=` method to included classes
+
 ## 0.3.3 (2020-11-02)
 
 -  Fixes a bug that causes an error when a beaconable was touch by an association without changes

data/Gemfile

@@ -1,6 +1,8 @@
+# frozen_string_literal: true
+
 source "https://rubygems.org"
 
-git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 
 # Specify your gem's dependencies in beaconable.gemspec
 gemspec

data/Gemfile.lock

@@ -1,69 +1,123 @@
 PATH
   remote: .
   specs:
-    beaconable (0.3.3)
-      activerecord (>= 4.0)
+    beaconable (1.0.0.alpha)
+      activerecord (>= 7.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activemodel (6.0.3.1)
-      activesupport (= 6.0.3.1)
-    activerecord (6.0.3.1)
-      activemodel (= 6.0.3.1)
-      activesupport (= 6.0.3.1)
-    activesupport (6.0.3.1)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 0.7, < 2)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-      zeitwerk (~> 2.2, >= 2.2.2)
+    activemodel (8.1.1)
+      activesupport (= 8.1.1)
+    activerecord (8.1.1)
+      activemodel (= 8.1.1)
+      activesupport (= 8.1.1)
+      timeout (>= 0.4.0)
+    activesupport (8.1.1)
+      base64
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      json
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
     ansi (1.5.0)
-    ast (2.4.0)
-    builder (3.2.3)
-    byebug (10.0.2)
-    concurrent-ruby (1.1.6)
-    i18n (1.8.2)
+    ast (2.4.3)
+    base64 (0.3.0)
+    bigdecimal (4.0.0)
+    builder (3.3.0)
+    concurrent-ruby (1.3.6)
+    connection_pool (3.0.2)
+    date (3.5.1)
+    debug (1.11.0)
+      irb (~> 1.10)
+      reline (>= 0.3.8)
+    drb (2.2.3)
+    erb (6.0.1)
+    i18n (1.14.7)
       concurrent-ruby (~> 1.0)
-    jaro_winkler (1.5.3)
-    minitest (5.11.3)
-    minitest-reporters (1.3.8)
+    io-console (0.8.2)
+    irb (1.16.0)
+      pp (>= 0.6.0)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    json (2.18.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    logger (1.7.0)
+    minitest (5.27.0)
+    minitest-reporters (1.7.1)
       ansi
       builder
       minitest (>= 5.0)
       ruby-progressbar
-    parallel (1.17.0)
-    parser (2.6.3.0)
-      ast (~> 2.4.0)
-    rainbow (3.0.0)
-    rake (13.0.1)
-    rubocop (0.74.0)
-      jaro_winkler (~> 1.5.1)
+    parallel (1.27.0)
+    parser (3.3.10.0)
+      ast (~> 2.4.1)
+      racc
+    pp (0.6.3)
+      prettyprint
+    prettyprint (0.2.0)
+    prism (1.6.0)
+    psych (5.3.1)
+      date
+      stringio
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    rdoc (6.17.0)
+      erb
+      psych (>= 4.0.0)
+      tsort
+    regexp_parser (2.11.3)
+    reline (0.6.3)
+      io-console (~> 0.5)
+    rubocop (1.82.0)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
       parallel (~> 1.10)
-      parser (>= 2.6)
+      parser (>= 3.3.0.2)
       rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.48.0, < 2.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (>= 1.4.0, < 1.7)
-    ruby-progressbar (1.10.1)
-    sqlite3 (1.4.1)
-    thread_safe (0.3.6)
-    tzinfo (1.2.7)
-      thread_safe (~> 0.1)
-    unicode-display_width (1.6.0)
-    zeitwerk (2.3.0)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.48.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.4)
+    ruby-progressbar (1.13.0)
+    securerandom (0.4.1)
+    sqlite3 (2.8.1-arm64-darwin)
+    sqlite3 (2.8.1-x86_64-linux-gnu)
+    stringio (3.2.0)
+    timeout (0.6.0)
+    tsort (0.2.0)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.1.0)
+    uri (1.1.1)
 
 PLATFORMS
-  ruby
+  arm64-darwin-24
+  x86_64-linux
 
 DEPENDENCIES
   beaconable!
-  bundler (~> 1.16)
-  byebug (~> 10.0)
+  bundler (>= 2.0)
+  debug (~> 1.8)
   minitest (~> 5.0)
-  minitest-reporters (~> 1.3)
+  minitest-reporters (~> 1.6)
   rake (~> 13.0)
-  rubocop (~> 0.74.0)
-  sqlite3 (~> 1.3)
+  rubocop (~> 1.50)
+  sqlite3 (~> 2.0)
 
 BUNDLED WITH
-   1.17.2
+   2.4.19

data/README.md

@@ -1,8 +1,26 @@
 # Beaconable
 
-[![Build Status](https://travis-ci.org/Lastimoso/beaconable.svg?branch=master)](https://travis-ci.org/Lastimoso/beaconable) [![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/dwyl/esta/issues)
+[![Gem Version](https://badge.fury.io/rb/beaconable.svg)](https://badge.fury.io/rb/beaconable) [![CI](https://github.com/Lastimoso/beaconable/actions/workflows/test.yml/badge.svg)](https://github.com/Lastimoso/beaconable/actions/workflows/test.yml) [![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/Lastimoso/beaconable/issues)
 
-Small OO patern to isolate side-effects and callbacks for your ActiveRecord Models.
+A lightweight Ruby gem that provides an elegant, object-oriented pattern for isolating side-effects and callbacks from your ActiveRecord models.
+
+## Why Beaconable?
+
+ActiveRecord callbacks (`after_save`, `after_commit`, etc.) are convenient, but they can quickly turn your models into tangled messes of business logic, external API calls, and notification triggers. Before you know it, your `User` model is sending emails, syncing with Salesforce, updating Elasticsearch, and making your tests take forever.
+
+**Beaconable solves this by:**
+
+- **Separating concerns** — Side-effects live in dedicated Beacon classes, not your models
+- **Improving testability** — Test your model logic and side-effects independently
+- **Providing context** — Your Beacon knows exactly what changed (`object_was` vs `object`)
+- **Keeping models lean** — Your ActiveRecord models stay focused on data and validations
+- **Offering flexibility** — Skip beacons when needed, pass metadata for conditional logic
+
+
+## Requirements
+
+- Ruby >= 3.2.0
+- Rails >= 7.0
 
 ## Installation
 
@@ -58,6 +76,145 @@ class UserBeacon < Beaconable::BaseBeacon
 end
 ```
 
+### Avoid firing a beacon
+
+You can skip beacon calls if you pass true to the method `#skip_beacon`. I.E:
+```
+...
+ user.update(user_params)
+ user.skip_beacon = true
+ user.save # The user beacon won't be fired.
+```
+
+### Beacon metadata
+
+You can pass `beacon_metadata` to the `object` that will be available on the **Beacon**.
+
+Some uses might be:
+
+- to determine whether a certain action should be performed or not. For example when creating users in batch actions or in through the console you might want to skip just the welcome email but still perform all the other side effects associated with the user creation.
+- to pass information that is generated / available in memory, will not be persisted in the model but is relevant in the side effects. For example, if you want to implement your own event logging system you could pass the current user id from the controller action to the beacon where you are going to create the Event.
+
+```ruby
+User.create(
+  email: "new_user@email.com",
+  beacon_metadata: {
+    skip_welcome_user_job: true,
+    triggered_by: "admin@myapp.com"
+  }
+)
+
+# app/beacons/user_beacon.rb
+class UserBeacon < Beaconable::BaseBeacon
+  alias user object
+  alias user_was object_was
+
+  def call
+    WelcomeUserJob.perform_later(self.id) if should_perform_welcome_user_job?
+    UpdateExternalServiceJob.perform_later(self.id) if field_changed? :email
+    Event.create do |event|
+      event.content = UserSerializer.new(user).event_content
+      event.ocurred_at = user.updated_at
+      if beacon_metadata.present?
+        event.triggered_by = beacon_metadata.dig(:triggered_by)
+        event.source = beacon_metadata.dig(:source)
+      end
+    end
+  end
+
+  private
+
+  def should_perform_welcome_user_job?
+    new_entry? && !skip_welcome_user_job?
+  end
+
+  def skip_welcome_user_job?
+    beacon_metadata[:skip_welcome_user_job] if beacon_metadata.present?
+  end
+end
+```
+
+**Important**: once the beacon has been _fired_ the `beacon_metadata` will be cleared.
+
+### Multiple saves in a transaction (a.k.a. "Please don't do this")
+
+> **Fair warning:** If you're doing multiple saves on the same record within a single transaction, you might want to reconsider your life choices. But hey, we don't judge — we just handle it gracefully.
+
+Beaconable captures the state of your object at the **first** `before_save` and holds onto it until `after_commit`. This means that if you do something like this:
+
+```ruby
+ActiveRecord::Base.transaction do
+  user.update!(status: 'pending')
+  user.update!(status: 'verified')
+  user.update!(status: 'active')
+end
+```
+
+Your beacon will see:
+- `object.status` → `'active'` (the final value)
+- `object_was.status` → whatever it was **before** the transaction started
+
+This is intentional! We track the change from the **original state** to the **final committed state**, not the intermediate chaos in between.
+
+```ruby
+# In your beacon:
+def call
+  if field_changed?(:status)
+    # This will be true if status changed from its original value
+    # to the final committed value — regardless of how many
+    # intermediate updates happened
+    NotifyStatusChange.perform_later(user.id)
+  end
+end
+```
+
+**Why?** Because Rails' native `saved_changes` only shows the last save, which would miss the fact that `status` changed at all if only the first update modified it. We've got your back.
+
+## Known Limitations
+
+### Encrypted columns with non-deterministic encryption
+
+If you're using Rails encrypted attributes with a non-deterministic algorithm, `field_changed?` will return `true` even when the plaintext value hasn't changed. This happens because the ciphertext changes on every save:
+
+```ruby
+bank_account.routing_number = bank_account.routing_number  # Same value!
+bank_account.changes_to_save
+# => {"routing_number_ciphertext" => ["QnPUYDD...", "IDZIchs..."]}
+```
+
+The underlying ciphertext is different, so Rails (and Beaconable) sees it as a change. If this is a problem for your use case, consider using deterministic encryption for those columns, or handle the comparison manually in your beacon.
+
+### Store accessor attributes
+
+Attributes defined via `store_accessor` are not directly supported by `field_changed?`. Rails tracks changes on the underlying store column, not on individual accessor keys:
+
+```ruby
+# Given: store_accessor :data_store, :a_store_attribute
+
+user.a_store_attribute = "hello"
+user.changes_to_save
+# => {"data_store" => [{}, {"a_store_attribute" => "hello"}]}
+
+# In your beacon:
+field_changed?(:a_store_attribute)  # => false (won't work)
+field_changed?(:data_store)         # => true (works, but less precise)
+```
+
+**Workaround:** Check the underlying store column and inspect its contents:
+
+```ruby
+def call
+  if field_changed?(:data_store)
+    old_store = object_was[:data_store] || {}
+    new_store = object.data_store || {}
+
+    if old_store["a_store_attribute"] != new_store["a_store_attribute"]
+      # Handle the change
+    end
+  end
+end
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
@@ -66,7 +223,7 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/beaconable. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+Bug reports and pull requests are welcome on GitHub at https://github.com/Lastimoso/beaconable. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
 ## License
 
@@ -74,4 +231,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Beaconable project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/beaconable/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Beaconable project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/Lastimoso/beaconable/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require "bundler/gem_tasks"
 require "rake/testtask"
 
@@ -7,4 +9,4 @@ Rake::TestTask.new(:test) do |t|
   t.test_files = FileList["test/**/*_test.rb"]
 end
 
-task :default => :test
+task default: :test

data/beaconable.gemspec

@@ -9,8 +9,8 @@ Gem::Specification.new do |spec|
   spec.authors       = ["Gerardo Raiden"]
   spec.email         = ["gerardoraiden@gmail.com"]
 
-  spec.summary       = %q{Small OO patern to isolate side-effects and callbacks for your ActiveRecord Models}
-  spec.description   = %q{Small OO patern to isolate side-effects and callbacks for your ActiveRecord Models}
+  spec.summary       = %q{Small OO pattern to isolate side-effects and callbacks for your ActiveRecord Models}
+  spec.description   = %q{Small OO pattern to isolate side-effects and callbacks for your ActiveRecord Models}
   spec.homepage      = "https://github.com/Lastimoso/beaconable"
   spec.license       = "MIT"
 
@@ -30,13 +30,15 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_dependency 'activerecord', '>= 4.0'
+  spec.required_ruby_version = '>= 3.2.0'
 
-  spec.add_development_dependency 'bundler', '~> 1.16'
+  spec.add_dependency 'activerecord', '>= 7.0'
+
+  spec.add_development_dependency 'bundler', '>= 2.0'
   spec.add_development_dependency 'minitest', '~> 5.0'
-  spec.add_development_dependency 'minitest-reporters', '~> 1.3'
+  spec.add_development_dependency 'minitest-reporters', '~> 1.6'
   spec.add_development_dependency 'rake', '~> 13.0'
-  spec.add_development_dependency 'rubocop', '~> 0.74.0'
-  spec.add_development_dependency 'sqlite3', '~> 1.3'
-  spec.add_development_dependency 'byebug', '~> 10.0'
+  spec.add_development_dependency 'sqlite3', '~> 2.0'
+  spec.add_development_dependency 'debug', '~> 1.8'
+  spec.add_development_dependency 'rubocop', '~> 1.50'
 end

data/lib/beaconable/attribute_snapshot.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Beaconable
+  # Immutable snapshot of an ActiveRecord object's attributes at a point in time.
+  # Replaces OpenStruct for better performance and explicit immutability.
+  class AttributeSnapshot
+    def initialize(attributes)
+      @attributes = attributes.freeze
+    end
+
+    def method_missing(method_name, *args)
+      key = method_name.to_sym
+      return @attributes[key] if @attributes.key?(key)
+
+      super
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      @attributes.key?(method_name.to_sym) || super
+    end
+
+    # Direct hash-style access for attribute values
+    def [](key)
+      @attributes[key.to_sym]
+    end
+
+    # Returns a copy of the attributes hash (for debugging/inspection)
+    def to_h
+      @attributes.dup
+    end
+
+    def inspect
+      "#<#{self.class.name} #{@attributes.inspect}>"
+    end
+  end
+end

data/lib/beaconable/base_beacon.rb

@@ -2,11 +2,12 @@
 
 module Beaconable
   class BaseBeacon
-    attr_reader :object, :object_was
+    attr_reader :object, :object_was, :beacon_metadata
 
     def initialize(object, object_was)
       @object = object
       @object_was = object_was
+      @beacon_metadata = object.beacon_metadata
     end
 
     def field_changed(field)
@@ -46,6 +47,5 @@ module Beaconable
     def new_entry?
       object_was.created_at.nil?
     end
-
   end
 end

data/lib/beaconable/object_was.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 module Beaconable
+  # Captures the database state of an ActiveRecord object before changes.
+  # Used to track what changed during a save/transaction.
   class ObjectWas
     attr_reader :object
 
@@ -8,13 +10,40 @@ module Beaconable
       @object = object
     end
 
+    # Captures the current database state and returns an immutable snapshot.
+    # For new records, returns a snapshot with nil values for all columns.
     def call
-      hashed_object = {}
-      symbolized_column_names = object.class.column_names.map(&:to_sym)
-      symbolized_column_names.each do |column_name|
-        hashed_object[column_name] = object.send("#{column_name}_was")
+      AttributeSnapshot.new(build_attributes)
+    end
+
+    private
+
+    def build_attributes
+      if object.new_record?
+        build_new_record_attributes
+      else
+        build_persisted_record_attributes
+      end
+    end
+
+    # For new records, all "was" values are nil
+    # This preserves backward compatibility with new_entry? detection
+    def build_new_record_attributes
+      object.class.column_names.each_with_object({}) do |column, hash|
+        hash[column.to_sym] = nil
+      end
+    end
+
+    # For persisted records, capture database values before current changes
+    # Uses modern Rails 7+ dirty tracking API
+    def build_persisted_record_attributes
+      # Start with current attributes (which equal DB values for unchanged attrs)
+      result = object.attributes.symbolize_keys
+      # Replace changed attributes with their original database values
+      object.changes_to_save.each do |attr, (old_value, _new_value)|
+        result[attr.to_sym] = old_value
       end
-      OpenStruct.new(hashed_object)
+      result
     end
   end
 end

data/lib/beaconable/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Beaconable
-  VERSION = "0.3.3"
+  VERSION = "1.0.0.alpha"
 end

data/lib/beaconable.rb

@@ -1,13 +1,16 @@
 # frozen_string_literal: true
 
-require 'beaconable/version'
-require 'beaconable/object_was'
-require 'beaconable/base_beacon'
-require 'active_record'
+require "beaconable/version"
+require "beaconable/attribute_snapshot"
+require "beaconable/object_was"
+require "beaconable/base_beacon"
+require "active_record"
 
 module Beaconable
   extend ActiveSupport::Concern
+
   included do
+    attr_accessor :beacon_metadata
     attr_accessor :skip_beacon
 
     before_save :save_for_beacon, unless: :skip_beacon
@@ -25,5 +28,6 @@ module Beaconable
   def fire_beacon
     "#{self.class.name}Beacon".constantize.new(self, @object_was).call
     @object_was = nil
+    self.beacon_metadata = nil
   end
 end

data/lib/generators/beacon/beacon_generator.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
-require 'rails/generators/base'
+require "rails/generators/base"
 
 class BeaconGenerator < Rails::Generators::NamedBase
-  source_root File.expand_path('templates', __dir__)
+  source_root File.expand_path("templates", __dir__)
 
   def create_beacon_file
-    template 'beacon.rb.tt', File.join('app', 'beacons', class_path, "#{file_name}_beacon.rb")
+    template "beacon.rb.tt", File.join("app", "beacons", class_path, "#{file_name}_beacon.rb")
   end
 
   def insert_inclusion_into_model_file

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: beaconable
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 1.0.0.alpha
 platform: ruby
 authors:
 - Gerardo Raiden
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-11-02 00:00:00.000000000 Z
+date: 2025-12-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -16,28 +16,28 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '7.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '4.0'
+        version: '7.0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -58,14 +58,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.6'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -81,48 +81,48 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '13.0'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.74.0
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.74.0
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: sqlite3
+  name: debug
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.8'
 - !ruby/object:Gem::Dependency
-  name: byebug
+  name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '1.50'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
-description: Small OO patern to isolate side-effects and callbacks for your ActiveRecord
+        version: '1.50'
+description: Small OO pattern to isolate side-effects and callbacks for your ActiveRecord
   Models
 email:
 - gerardoraiden@gmail.com
@@ -130,8 +130,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/test.yml"
 - ".gitignore"
-- ".travis.yml"
+- ".rubocop.yml"
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
 - Gemfile
@@ -139,10 +140,12 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- beaconable-0.3.4.gem
 - beaconable.gemspec
 - bin/console
 - bin/setup
 - lib/beaconable.rb
+- lib/beaconable/attribute_snapshot.rb
 - lib/beaconable/base_beacon.rb
 - lib/beaconable/object_was.rb
 - lib/beaconable/version.rb
@@ -154,7 +157,7 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -162,16 +165,16 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
-summary: Small OO patern to isolate side-effects and callbacks for your ActiveRecord
+summary: Small OO pattern to isolate side-effects and callbacks for your ActiveRecord
   Models
 test_files: []

data/.travis.yml

@@ -1,8 +0,0 @@
-sudo: false
-language: ruby
-rvm:
-  - 2.5.3
-  - 2.6.3
-before_install: gem install bundler -v 1.17.2
-script:
-  - bundle exec rake