julewire-karafka 1.1.2 → 1.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97d34d8fbe897efb7ce015f2255693f44c09b942e55b8289cb023b197ff134d8
-  data.tar.gz: cac00f978d4c2fcdf288b33dca657a980e7426978162caadf3dcd11e6437e7a2
+  metadata.gz: 26a7119151755c216ae01a615690321a0b3ae64fd3d584073163942c8dd0df49
+  data.tar.gz: 893718199e8e4dc0431fa7f981fe75d3d5628c7de9461808e0c077423f8c3010
 SHA512:
-  metadata.gz: 7f82481e87e01709f27854367d7c0655a46991431520304de1c7c9368c625ec7aa9a516619b63f8668a7ac988d4da4719268c5c52ee8e35641f5e01b8fe2cfa7
-  data.tar.gz: f7ffef746dbda3fdb9ac5892520ff0fcfe0923a8b9fc8b4a75f6a858acf73677683b5c0d091e00ebea3c951194a92db99145af9dcfa76ec0ae9f3a822093fae8
+  metadata.gz: 4779ebb58608a479af2179519b24449f1faa8b5ee1f71336b62540588397e1949af1acc063d3ceb63f4eeda9e4ffd22c681f767fea51463a8675474c29cc077f
+  data.tar.gz: fbf448301c59a4f2c3195cb1e9ebad9e1ce88da6be889046deef941a06413987b8ca30cf3670caedad1e1cf87b0b12bfaab9ef0d90bed02b9ba1dd412481563c

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 ## Unreleased
 
+## 1.1.3 - 2026-08-09
+
+- Quiesce Julewire resources without emitting after Karafka pre-fork preparation.
+- Test against Karafka 2.6 and remove reflective monitor-profile lookup.
+- Require julewire-core 1.1.3.
+- Refresh development tooling and compatibility locksets.
+
 ## 1.1.2 - 2026-08-02
 
 - Refresh development and compatibility dependency locksets.

data/README.md

@@ -45,7 +45,8 @@ Default behavior:
 - important consumer and producer monitor events become point records
 - message headers carry Julewire propagation carriers
 - `with_message` restores message context and adds message attributes
-- Karafka fork hooks call `Julewire.after_fork!`
+- Karafka swarm hooks quiesce Julewire before manager forks and reset it after
+  manager and worker forks
 - text logger listeners are not parsed or deduplicated
 
 Inbound Kafka carriers are trusted by default for internal service traffic. Set

data/docs/consumer-events.md

@@ -4,9 +4,13 @@
 Set `consumer_event_names = :all` to subscribe to Karafka's registered monitor
 events, or pass an explicit event list for application policy. If the monitor
 cannot expose its registered events, `:all` uses the important profile.
+`swarm.manager.before_fork` is reserved for lifecycle preparation and is never
+routed through the generic event listener, even when selected explicitly.
 
 `install!` also subscribes lightweight handlers for
-`swarm.node.after_fork` and `swarm.manager.after_fork`. Those handlers call
+`swarm.manager.before_fork`, `swarm.node.after_fork`, and
+`swarm.manager.after_fork`. The manager hook calls `Julewire.before_fork!` so
+unsafe resources drain before process creation. The after-fork handlers call
 `Julewire.after_fork!` so inherited mutexes, counters, async transports, and
 process-local context are reset in Karafka forked processes.
 

data/julewire-karafka.gemspec

@@ -34,7 +34,7 @@ Gem::Specification.new do |spec|
   spec.executables = []
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "julewire-core", ">= 1.1.0"
+  spec.add_dependency "julewire-core", ">= 1.1.3"
   spec.add_dependency "karafka", ">= 2.5"
   spec.add_dependency "waterdrop", ">= 2.10"
   spec.add_dependency "zeitwerk", ">= 2.8.1"

data/lib/julewire/karafka/event_severity.rb

@@ -12,7 +12,6 @@ module Julewire
       DEBUG_CONSUMER_EVENTS = %w[
         connection.listener.fetch_loop
         statistics.emitted
-        swarm.manager.before_fork
         swarm.manager.control
       ].freeze
 

data/lib/julewire/karafka/fork_hooks.rb

@@ -4,11 +4,13 @@ module Julewire
   module Karafka
     module ForkHooks
       EVENTS = %w[
+        swarm.manager.before_fork
         swarm.node.after_fork
         swarm.manager.after_fork
       ].freeze
+      BEFORE_FORK_EVENT = "swarm.manager.before_fork"
       INSTALL_STATE = Core::Integration::IvarState.new(:@julewire_karafka_fork_hooks_state)
-      private_constant :EVENTS, :INSTALL_STATE
+      private_constant :BEFORE_FORK_EVENT, :EVENTS, :INSTALL_STATE
 
       class << self
         def subscribe!(monitor, configuration:)
@@ -26,8 +28,12 @@ module Julewire
         end
 
         def handle(event_name, _event)
-          IntegrationHealth.with_failure_health(action: :after_fork, component: :fork_hooks, event: event_name) do
-            Julewire.after_fork!
+          if event_name == BEFORE_FORK_EVENT
+            Julewire.before_fork!
+          else
+            IntegrationHealth.with_failure_health(action: :after_fork, component: :fork_hooks, event: event_name) do
+              Julewire.after_fork!
+            end
           end
         end
 

data/lib/julewire/karafka/installer.rb

@@ -10,7 +10,7 @@ module Julewire
 
           ForkHooks.subscribe!(monitor, configuration: configuration)
           if configuration.consumer_events?
-            MonitorSubscription.install!(monitor, configuration: configuration, profile: :consumer)
+            MonitorSubscription.install!(monitor, configuration: configuration, profile: MonitorProfiles.consumer)
           end
           monitor
         end

data/lib/julewire/karafka/monitor_listener.rb

@@ -3,43 +3,13 @@
 module Julewire
   module Karafka
     class MonitorListener
-      Profile = Data.define(
-        :component,
-        :event_prefix,
-        :logger_name,
-        :messaging_role,
-        :config_method,
-        :important_events,
-        :severity
-      )
-
-      CONSUMER_PROFILE = Profile.new(
-        component: :listener,
-        event_prefix: "karafka",
-        logger_name: "Karafka.monitor",
-        messaging_role: :consumer,
-        config_method: :consumer_event_names,
-        important_events: Configuration::IMPORTANT_CONSUMER_EVENT_NAMES,
-        severity: ->(name, event, payload) { EventSeverity.consumer(name, event: event, payload: payload) }
-      ).freeze
-      PRODUCER_PROFILE = Profile.new(
-        component: :waterdrop_listener,
-        event_prefix: "waterdrop",
-        logger_name: "WaterDrop.monitor",
-        messaging_role: :producer,
-        config_method: :producer_event_names,
-        important_events: Configuration::IMPORTANT_PRODUCER_EVENT_NAMES,
-        severity: ->(name, _event, payload) { EventSeverity.producer(name, payload) }
-      ).freeze
-      private_constant :Profile, :CONSUMER_PROFILE, :PRODUCER_PROFILE
-
       class << self
         def consumer(configuration = Configuration.new)
-          new(configuration, profile: CONSUMER_PROFILE)
+          new(configuration, profile: MonitorProfiles.consumer)
         end
 
         def producer(configuration = Configuration.new)
-          new(configuration, profile: PRODUCER_PROFILE)
+          new(configuration, profile: MonitorProfiles.producer)
         end
       end
 

data/lib/julewire/karafka/monitor_profiles.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Julewire
+  module Karafka
+    module MonitorProfiles
+      Profile = Data.define(
+        :component,
+        :event_prefix,
+        :logger_name,
+        :messaging_role,
+        :config_method,
+        :important_events,
+        :reserved_events,
+        :severity
+      )
+
+      CONSUMER = Profile.new(
+        component: :listener,
+        event_prefix: "karafka",
+        logger_name: "Karafka.monitor",
+        messaging_role: :consumer,
+        config_method: :consumer_event_names,
+        important_events: Configuration::IMPORTANT_CONSUMER_EVENT_NAMES,
+        reserved_events: %w[swarm.manager.before_fork].freeze,
+        severity: ->(name, event, payload) { EventSeverity.consumer(name, event: event, payload: payload) }
+      ).freeze
+      PRODUCER = Profile.new(
+        component: :waterdrop_listener,
+        event_prefix: "waterdrop",
+        logger_name: "WaterDrop.monitor",
+        messaging_role: :producer,
+        config_method: :producer_event_names,
+        important_events: Configuration::IMPORTANT_PRODUCER_EVENT_NAMES,
+        reserved_events: [].freeze,
+        severity: ->(name, _event, payload) { EventSeverity.producer(name, payload) }
+      ).freeze
+      private_constant :Profile, :CONSUMER, :PRODUCER
+
+      class << self
+        def consumer = CONSUMER
+
+        def producer = PRODUCER
+      end
+    end
+
+    private_constant :MonitorProfiles
+  end
+end

data/lib/julewire/karafka/monitor_subscription.rb

@@ -3,12 +3,6 @@
 module Julewire
   module Karafka
     module MonitorSubscription
-      PROFILE_CONSTANTS = {
-        consumer: :CONSUMER_PROFILE,
-        producer: :PRODUCER_PROFILE
-      }.freeze
-      private_constant :PROFILE_CONSTANTS
-
       class << self
         def subscribe(monitor, event_name, component:, &)
           return false unless monitor.respond_to?(:subscribe)
@@ -20,7 +14,6 @@ module Julewire
         end
 
         def install!(monitor, profile:, configuration:)
-          profile = monitor_listener_profile(profile)
           state = subscription_state(monitor, profile)
           listener = listener_for(state, configuration, profile)
           subscriptions = subscriptions_for(state)
@@ -41,11 +34,6 @@ module Julewire
 
         private
 
-        def monitor_listener_profile(profile)
-          constant_name = PROFILE_CONSTANTS.fetch(profile)
-          MonitorListener.const_get(constant_name)
-        end
-
         def listener_for(state, configuration, profile)
           listener = state&.fetch(:listener)
           if listener
@@ -83,16 +71,17 @@ module Julewire
 
         def event_names(monitor, configuration, profile)
           configured = configuration.public_send(profile.config_method)
-          return profile.important_events if configured == :important
-
-          if all_events?(configured)
-            available_events = available_events_for(monitor)
-            return available_events unless available_events.empty?
-
-            return profile.important_events
-          end
+          selected_events =
+            if configured == :important
+              profile.important_events
+            elsif all_events?(configured)
+              available_events = available_events_for(monitor)
+              available_events.empty? ? profile.important_events : available_events
+            else
+              Array(configured)
+            end
 
-          Array(configured)
+          selected_events - profile.reserved_events
         end
 
         def available_events_for(monitor)

data/lib/julewire/karafka/version.rb

@@ -2,6 +2,6 @@
 
 module Julewire
   module Karafka
-    VERSION = "1.1.2"
+    VERSION = "1.1.3"
   end
 end

data/lib/julewire/karafka/waterdrop_installer.rb

@@ -41,7 +41,7 @@ module Julewire
           return unless producer.respond_to?(:monitor)
 
           monitor = producer.monitor
-          MonitorSubscription.install!(monitor, configuration: configuration, profile: :producer)
+          MonitorSubscription.install!(monitor, configuration: configuration, profile: MonitorProfiles.producer)
         rescue StandardError => e
           IntegrationHealth.record_failure(e, action: :install, component: :waterdrop_installer)
         end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: julewire-karafka
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.1.3
 platform: ruby
 authors:
 - Alexander Grebennik
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 1.1.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.0
+        version: 1.1.3
 - !ruby/object:Gem::Dependency
   name: karafka
   requirement: !ruby/object:Gem::Requirement
@@ -95,6 +95,7 @@ files:
 - lib/julewire/karafka/message_execution.rb
 - lib/julewire/karafka/messaging_attributes.rb
 - lib/julewire/karafka/monitor_listener.rb
+- lib/julewire/karafka/monitor_profiles.rb
 - lib/julewire/karafka/monitor_subscription.rb
 - lib/julewire/karafka/payload_reader.rb
 - lib/julewire/karafka/version.rb