julewire-karafka 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 32290d2a9bb3d886763322d94fded8636dfe961d1c5378a265293acb36d7b932
-  data.tar.gz: 131b772cff7114eed297cebfa075c785c8b7bfc2afbb480684aab813acefc763
+  metadata.gz: 2348fa4e2f74ae14416481646fb82ca838306ba5f637b3ee21d38d8e25d7f1c3
+  data.tar.gz: 937a2babb22b4ed2bcc277c12d008568646a0dcef77dac25cbfb9c829b516c57
 SHA512:
-  metadata.gz: 56184e4abdb26392059b31b5f29323311c331374350d1c88969f98ce3fb3e4c8d3c1eb2d4dd26913244245777236f5d3d1e796ba661b65c354ac499b62088da8
-  data.tar.gz: 2693077aabaa0e6ad1bd28e9fe176e533e8e860d244fcc943a3a632a34b4972270713206bf594ad72f5c72206a82ed305882cbed3906bd744a5a6970694bbbe6
+  metadata.gz: c1ea911dce21f4ae508f70f8a8d47a9beebe35c44d235ca3d0e5a27753996634ca15f123b4c431f04c4f3fadfe1c2d1d63adfe79bdb56cf11c3a03cb45dfb516
+  data.tar.gz: db66dcbf0c4faaccd8b10a1240bdb045f307ddbc842bf375d5e2718119edef8cf5411164e58afe9c3a3e9330c0cacc8c8541d6e90ef027ad1abd8feaa1a6b314

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 ## Unreleased
 
+## 1.0.1 - 2026-06-25
+
+- Default propagation carrier byte limits to 64 KiB and record health when
+  oversized or malformed message carriers are ignored on restore.
+- Require julewire-core 1.0.1.
+
 ## 1.0.0 - 2026-06-21
 
 - Initial release: Karafka and WaterDrop event capture, message execution

data/docs/configuration.md

@@ -14,7 +14,7 @@
 
 | Option | Default | Purpose |
 | --- | --- | --- |
-| `carrier_max_bytes` | `nil` | Omit oversized carriers from Kafka headers. |
+| `carrier_max_bytes` | `65_536` | Omit oversized carriers from Kafka headers. |
 | `carrier_filter` | `nil` | Optional inbound header filter before restoring a message carrier. |
 | `consumer_event_names` | `:important` | Consumer monitor event profile or explicit event list. |
 | `producer_event_names` | `:important` | Producer monitor event profile or explicit event list. |

data/docs/waterdrop.md

@@ -16,9 +16,9 @@ its registered events, `:all` uses the important profile. WaterDrop event
 severity is read from the event payload when present; otherwise errors are
 error and normal producer events are info.
 
-Set `carrier_max_bytes` to omit oversized propagation carriers from Kafka
-headers. When omitted, the message is still produced normally; it just does not
-carry upstream Julewire context.
+`carrier_max_bytes` defaults to `65_536`. Oversized propagation carriers are
+omitted from Kafka headers and ignored on restore. The message still moves
+normally; it just does not carry upstream Julewire context.
 
 Message keys, headers, and payload fields are raw unless an application installs
 a processor policy before output.

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.0"
+  spec.add_dependency "julewire-core", ">= 1.0.1"
   spec.add_dependency "karafka", ">= 2.5"
   spec.add_dependency "waterdrop", ">= 2.10"
   spec.add_dependency "zeitwerk", ">= 2.8.1"

data/lib/julewire/karafka/configuration.rb

@@ -43,7 +43,8 @@ module Julewire
       setting :propagation, default: true, predicate: true
       setting :carrier_filter
       setting :carrier_key, default: Julewire::Core::Propagation::Carrier::DEFAULT_KEY
-      setting :carrier_max_bytes, validate: byte_limit
+      setting :carrier_max_bytes, default: Julewire::Core::Propagation::Carrier::DEFAULT_MAX_BYTES,
+                                  validate: byte_limit
       setting :source, default: "karafka"
       setting :consumer_event_names, default: :important
       setting :producer_event_names, default: :important

data/lib/julewire/karafka/message_context.rb

@@ -10,7 +10,14 @@ module Julewire
           fields ||= PayloadReader.message_payload(message)
           carrier = carrier_for(fields, configuration)
 
-          Julewire::Core::Propagation::Carrier.restore(carrier, key: configuration.carrier_key) do
+          result = Julewire::Core::Propagation::Carrier.extract_result(
+            carrier,
+            key: configuration.carrier_key,
+            max_bytes: configuration.carrier_max_bytes
+          )
+          record_carrier_restore_failure(result)
+
+          Julewire::Core::Propagation.restore(result.envelope, owned: true) do
             Julewire::Core::Integration::Facade.with_neutral(message_neutral(fields)) do
               Julewire::Core::Integration::Facade.with_attributes(message_attributes(fields), &)
             end
@@ -19,6 +26,18 @@ module Julewire
 
         private
 
+        def record_carrier_restore_failure(result)
+          return unless result.failure?
+
+          IntegrationHealth.record_failure(
+            result.error,
+            action: :carrier_restore,
+            component: :message_context,
+            status: result.status,
+            reason: result.reason
+          )
+        end
+
         def carrier_for(fields, configuration)
           return {} unless configuration.propagation?
 

data/lib/julewire/karafka/version.rb

@@ -2,6 +2,6 @@
 
 module Julewire
   module Karafka
-    VERSION = "1.0.0"
+    VERSION = "1.0.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: julewire-karafka
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Alexander Grebennik
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.0.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: 1.0.1
 - !ruby/object:Gem::Dependency
   name: karafka
   requirement: !ruby/object:Gem::Requirement