timelines 0.3.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f48e1bf0dfd0471248184f1039e1a1b4d3d338c9891369c5462756f8587f4da1
-  data.tar.gz: ddf9d3c52ca93eac3f4435b12ded8db25fb32fb746f283cb08b5982efd4043ea
+  metadata.gz: 0eff14a1838b467534d2d35233a9a2026958cc4f62f9cdb782f5ccbd9d7185d0
+  data.tar.gz: 785b4ca671477ad7e6f9b339407d377fb0ab1c8f51a4ed36655dced6464c659e
 SHA512:
-  metadata.gz: f854359a07cc0007336d067e028f5f88f3415b5203511422d784c3036183fe5f7857ab6079da9018ecb27075b6da097410bce57018732c504dc3e70e880537e2
-  data.tar.gz: 6f3cd805f1ef214f135e3a0d2856e806ccf4fbaedd20c414c1b7fe0f0bfd34246fb74b33e4f7fb37a184789319267422abb9df904ff4b7ab206039fe4ae7c11b
+  metadata.gz: a6eca22beb642e9b503235aa829c6a8f97fc399ee59c7082cd77f664ef7e38ef49d2fd5993fd30aeb8da973cde3bbeb27b510e5fa4989502a631f614ecec10bc
+  data.tar.gz: c6022bf2a2ef87372fcc5d85ff54e3702a2a7c193b62766b2e3cb95b7d5b29f7a828b6c3458efaffe844bb63d9452eaa16d23327a1edec147a72beb5534eb02a

data/README.md

@@ -47,6 +47,18 @@ And the following Class methods:
 .self.destroy_all
 ```
 
+Enables defining conditions for automated logging of events for a record's many lifecycle events, which are logged through an ActiveJob adapter.
+
+The parameters are 4 procs that define the resource, actor, event, and conditions for logging the event. Conditions can be used to ensure an event only fires on a new record, or on a record that has been updated in a specific way/meets certain criteria to be eligible to log the event.
+```ruby
+include Timelines::TracksEvents
+tracks_timelines_event :create_event,
+  resource: ->(instance) { instance },
+  actor: ->(instance) { instance.created_by },
+  event: ->(instance) { "instance::create" },
+  conditions: ->(instance) { instance.new_record? }
+```
+
 ## Installation
 Add this line to your application's Gemfile:
 

data/lib/timelines/jobs/event_logger.rb

@@ -0,0 +1,16 @@
+module Timelines
+  class EventLogger < ::ActiveJob::Base
+    queue_as :default
+
+    def perform(actor_type, actor_id, resource_klass, resource_id, event, timestamp = Time.current)
+      actor = actor_type.constantize.find_by(id: actor_id)
+      resource = resource_klass.constantize.find_by(id: resource_id)
+      return unless actor.present? && resource.present? && event.present?
+
+      ::Timelines::Event.create!(actor: actor, resource: resource, event: event, created_at: timestamp)
+    rescue => e
+      Rails.logger.error("Failed to log event: #{e.message} - #{actor_type} #{actor_id} - #{resource_klass} #{resource_id} - #{event}")
+      raise e
+    end
+  end
+end

data/lib/timelines/models/concerns/ephemeral.rb

@@ -6,12 +6,12 @@ module Timelines
 
     included do
       scope :draft, -> { where(started_at: nil) }
-      scope :active, -> { where(ended_at: nil, started_at: [..Time.current]) }
-      scope :active_at, ->(date) { where("started_at <= ? AND (ended_at IS ? OR ended_at >= ?)", date, nil, date) }
+      scope :active, -> { active_at(Time.current) }
+      scope :active_at, ->(date) { where(started_at: [..date], ended_at: nil).or(where(started_at: [..date], ended_at: [date..])) }
       scope :with_deleted, -> { unscope(where: :ended_at) }
-      scope :ended, -> { where.not(ended_at: nil) }
+      scope :ended, -> { where(ended_at: [..Time.current]) }
       scope :deleted, -> { ended }
-      scope :not_deleted, -> { where(ended_at: nil) }
+      scope :not_deleted, -> { where(ended_at: nil).or(where(ended_at: [Time.current..])) }
 
       def active?
         started? && !ended?
@@ -32,7 +32,7 @@ module Timelines
       end
 
       def end!
-        return self if ended_at.present?
+        return self if ended_at.present? && ended_at.past?
 
         result = ActiveRecord::Base.transaction do
           run_callbacks(:destroy) do

data/lib/timelines/models/concerns/has_audit_trail.rb

@@ -6,6 +6,7 @@ module Timelines
 
     included do
       include ::Timelines::HasEvents
+      include ::Timelines::TracksEvents
 
       def audit_trail(reverse: false)
         ::Timelines::AuditTrail.new(resource: self, reverse: reverse)

data/lib/timelines/models/concerns/tracks_events.rb

@@ -0,0 +1,26 @@
+require "active_support/concern"
+
+module Timelines
+  module TracksEvents
+    extend ActiveSupport::Concern
+
+    included do
+      def self.tracks_timelines_event(name, actor:, resource:, event:, conditions:)
+        method_name = "track_#{name}_event"
+        define_method method_name.to_sym do
+          event_should_be_logged = conditions.call(self)
+          return unless event_should_be_logged
+
+          event_actor = actor.call(self)
+          event_resource = resource.call(self)
+          event_summary = event.call(self)
+          return unless event_actor.present? && event_resource.present? && event_summary.present?
+
+          ::Timelines::EventLogger.perform_later(event_actor.class.name, event_actor.id, event_resource.class.name, event_resource.id, event_summary, Time.current)
+        end
+
+        before_save method_name.to_sym
+      end
+    end
+  end
+end

data/lib/timelines/version.rb

@@ -1,3 +1,3 @@
 module Timelines
-  VERSION = "0.3.1"
+  VERSION = "1.0.0"
 end

data/lib/timelines.rb

@@ -1,7 +1,9 @@
 require "timelines/version"
+require "timelines/jobs/event_logger"
 require "timelines/models/concerns/ephemeral"
 require "timelines/models/concerns/has_events"
 require "timelines/models/concerns/has_audit_trail"
+require "timelines/models/concerns/tracks_events"
 require "timelines/models/concerns/audit_trail"
 require "timelines/models/event"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: timelines
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 1.0.0
 platform: ruby
 authors:
 - Craig Gilchrist
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-18 00:00:00.000000000 Z
+date: 2024-08-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -39,10 +39,12 @@ files:
 - lib/generators/timelines/install/templates/create_timelines_events.rb
 - lib/tasks/timelines_tasks.rake
 - lib/timelines.rb
+- lib/timelines/jobs/event_logger.rb
 - lib/timelines/models/concerns/audit_trail.rb
 - lib/timelines/models/concerns/ephemeral.rb
 - lib/timelines/models/concerns/has_audit_trail.rb
 - lib/timelines/models/concerns/has_events.rb
+- lib/timelines/models/concerns/tracks_events.rb
 - lib/timelines/models/event.rb
 - lib/timelines/version.rb
 homepage: https://github.com/Craggar/timelines