fosm-rails 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4c993eea70daa26a211f4fa1bfda6750bbbf97389af2f621d673b12f58e41bac
-  data.tar.gz: 45b2cc6617e618c7500dccdf81ccf6bce49821307bad13e0f30374a95c9cbd04
+  metadata.gz: 50ac8659af44dfad52d33f333001e6b3b846cfbb635e56534366ca371631501a
+  data.tar.gz: 5d727e837eefe74fa85677199b6cbc78b7e3df28fe33f8275e4c8bd93900383b
 SHA512:
-  metadata.gz: 4e1fa8d26f70a0ff09add103cf8fe0fbb95a63986a5dd4b1e1f052ff22b6cb28fb04e38d3b5e3e5a8be4a0a3d370bf80dc07447f0a1d6bb8292a9ce9d8de189a
-  data.tar.gz: 32a6f160c73a05def43c6a31bdd48975060557987f205f89edab4754b8a410ab505eb8917fa7338931695f261c47c4b52b01b15979de48314efe96cc9fd40ebc
+  metadata.gz: e3adb965398f95f843d6d58f39f6b1b54d6c0084c46761b0f30678c7484bf6ca6c4e182e21ce5504b391cf147d9495da4d0d1fcad3ec4992693d7129c40c80c0
+  data.tar.gz: 04e1e7595f6dc9c211d7eb923ef167e80d612fab71149f1b5624cc5cbffd46ed64f16d909efd8a4c4a418a4895ba02fba39926fd98f1bcb1a09a028b06e7ca3e

data/app/jobs/fosm/transition_log_job.rb

@@ -6,7 +6,7 @@ module Fosm
   # at most a brief delay between the transition completing and the log entry
   # appearing. For strict consistency, use config.transition_log_strategy = :sync.
   class TransitionLogJob < Fosm::ApplicationJob
-    queue_as :fosm_audit
+    queue_as { Fosm.config.transition_log_job_queue }
 
     # @param log_data [Hash] all columns for the transition log row (string keys)
     def perform(log_data)

data/app/jobs/fosm/webhook_delivery_job.rb

@@ -2,7 +2,7 @@ module Fosm
   # Delivers webhook payloads to configured endpoints when FOSM events fire.
   # Runs asynchronously after the transition completes.
   class WebhookDeliveryJob < ApplicationJob
-    queue_as :default
+    queue_as { Fosm.config.webhook_job_queue }
     retry_on StandardError, wait: :polynomially_longer, attempts: 5
 
     def perform(record_type:, record_id:, event_name:, from_state:, to_state:, metadata: {})

data/lib/fosm/configuration.rb

@@ -34,6 +34,28 @@ module Fosm
     #   config.transition_log_strategy = :async
     attr_accessor :transition_log_strategy
 
+    # Queue name for Fosm::WebhookDeliveryJob.
+    # Webhook delivery is fire-and-forget; route it to a low-priority queue to
+    # avoid competing with user-facing jobs on the default queue.
+    #
+    # Example:
+    #   config.webhook_job_queue = :low
+    attr_accessor :webhook_job_queue
+
+    # Queue name for Fosm::TransitionLogJob (used when transition_log_strategy = :async).
+    #
+    # Example:
+    #   config.transition_log_job_queue = :low
+    attr_accessor :transition_log_job_queue
+
+    # When false, skip enqueuing WebhookDeliveryJob after every transition.
+    # Set to false if your app has no webhook subscriptions to eliminate
+    # unnecessary queue writes (reduces SQLite write pressure).
+    #
+    # Example:
+    #   config.webhooks_enabled = false
+    attr_accessor :webhooks_enabled
+
     def initialize
       @base_controller          = "ApplicationController"
       @admin_authorize          = -> { true } # Override in initializer!
@@ -42,6 +64,9 @@ module Fosm
       @admin_layout             = "fosm/application"
       @app_layout               = "application"
       @transition_log_strategy  = :sync
+      @webhook_job_queue        = :default
+      @transition_log_job_queue = :fosm_audit
+      @webhooks_enabled         = true
     end
   end
 

data/lib/fosm/lifecycle.rb

@@ -286,15 +286,17 @@ module Fosm
         Fosm::TransitionBuffer.push(log_data)
       end
 
-      # Deliver webhooks asynchronously (outside transaction, always)
-      Fosm::WebhookDeliveryJob.perform_later(
-        record_type: self.class.name,
-        record_id:   self.id.to_s,
-        event_name:  event_name.to_s,
-        from_state:  from_state,
-        to_state:    to_state,
-        metadata:    metadata
-      )
+      # Deliver webhooks asynchronously (outside transaction, skipped when disabled)
+      if Fosm.config.webhooks_enabled
+        Fosm::WebhookDeliveryJob.perform_later(
+          record_type: self.class.name,
+          record_id:   self.id.to_s,
+          event_name:  event_name.to_s,
+          from_state:  from_state,
+          to_state:    to_state,
+          metadata:    metadata
+        )
+      end
 
       true
     end

data/lib/fosm/version.rb

@@ -1,3 +1,3 @@
 module Fosm
-  VERSION = "0.2.2"
+  VERSION = "0.2.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fosm-rails
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - Abhishek Parolkar
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-26 00:00:00.000000000 Z
+date: 2026-04-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails