prosody 0.6.1-aarch64-linux → 0.7.0-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f64b2d7a89ae90d89183bfb8c51776361b3fc5be5e22dd19f8f100f266237bd0
-  data.tar.gz: '08ae725ad97a6824b52cc3d9fc0c1716ea8e63e2a0936eb6efff5b8aa62fd668'
+  metadata.gz: 759cb93b1bcd48f0bc4b57d0ac1c20103d1e17dc903f13f77309019ccf193538
+  data.tar.gz: 5c5c348620bbc3356efb8d782a4eed335d0a23865729d646bce2fe613b48d05a
 SHA512:
-  metadata.gz: d4d9ab323efd376b59e70646eef953804d57114926644de335c103f32cee59bed9a2c467dc7be0eb68b0aaf54e50574dd55470f6f2bb94de56aff24c4e607e26
-  data.tar.gz: b935c1c4d29dc5f3f635c1feb202cdb3d7538534f5f8f1592e5eca6aaf5096dc6a124103deee31b10faa75814788cfaee975b367b390cc886f36f428b685af38
+  metadata.gz: 53dd24306a97686ec0fbb47032f05f95b19bc297fc3dd4f13b9bec3e60b479ac7b9b68dd03d9076d595258578978e8d5652b7bdeb43e30ce6ff9671f47c49651
+  data.tar.gz: f7c7347d8caebe25e5b25d5acedfa246fe6d18d78414cc4c1a76329272f4eb229c084aafcf22fceed1b4cff86afed77c49c207c712d477d2f0eb479d9951bd7e

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.6.1"
+  ".": "0.7.0"
 }

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.7.0](https://github.com/prosody-events/prosody-rb/compare/prosody/v0.6.1...prosody/v0.7.0) (2026-11-13)
+
+
+### Features
+
+* **deps:** upgrade prosody to 0.8.0 ([#65](https://github.com/prosody-events/prosody-rb/issues/65)) ([2e2c81f](https://github.com/prosody-events/prosody-rb/commit/2e2c81fa7253e6c4eecbf822897f6ebf3ace13fb))
+
+
+### Bug Fixes
+
+* **deps:** upgrade dependencies ([#63](https://github.com/prosody-events/prosody-rb/issues/63)) ([eaca537](https://github.com/prosody-events/prosody-rb/commit/eaca53706bcbd9118fa5dfbb0296b9505bb11a24))
+
 ## [0.6.1](https://github.com/prosody-events/prosody-rb/compare/prosody/v0.6.0...prosody/v0.6.1) (2026-10-13)
 
 

data/CONFIGURATION.md

@@ -40,14 +40,17 @@ Set `subsystem` to make this client answer requests. Without it, the client cons
 | Option / Environment Variable           | Description                                          | Default                |
 |-----------------------------------------|------------------------------------------------------|------------------------|
 | `max_concurrency` / `PROSODY_MAX_CONCURRENCY` | Max messages being processed simultaneously     | 32                     |
-| `max_uncommitted` / `PROSODY_MAX_UNCOMMITTED` | Max in-flight messages; at the limit, only a partition with a waiting message pauses | 64                     |
+| `max_uncommitted` / `PROSODY_MAX_UNCOMMITTED` | Max decoded messages in flight across all partitions; at the limit, partitions stop reading | 64                     |
 | `timeout` / `PROSODY_TIMEOUT`           | Cancel handler if it runs longer than this           | 80% of stall threshold |
-| `commit_interval` / `PROSODY_COMMIT_INTERVAL` | How often to save progress to Kafka            | 1s                     |
+| `commit_interval` / `PROSODY_COMMIT_INTERVAL` | How often to save progress to Kafka | 1s |
 | `poll_interval` / `PROSODY_POLL_INTERVAL` | How often to fetch new messages from Kafka         | 100ms                  |
 | `shutdown_timeout` / `PROSODY_SHUTDOWN_TIMEOUT` | Shutdown budget; handlers run freely until cancellation fires near the end of the timeout | 30s |
 | `stall_threshold` / `PROSODY_STALL_THRESHOLD` | Report unhealthy if no progress for this long  | 5m                     |
 | `probe_port` / `PROSODY_PROBE_PORT`     | HTTP port for health checks; use `false`, `:disabled`, or the environment value `none` to disable | 8000 |
-| `statistics_interval` / `PROSODY_STATISTICS_INTERVAL` | How often librdkafka reports client statistics; must be between 1ms and 24h | 5s |
+| `statistics_interval` / `PROSODY_STATISTICS_INTERVAL` | How often librdkafka reports client statistics | 5s |
+| `partition_prefetch` / `PROSODY_PARTITION_PREFETCH` | Bytes of fetched records that wait for each assigned partition; accepts sizes such as `128 KiB`. Fetched memory grows with the number of assigned partitions (about two times this value, plus one batch, per partition) | 128 KiB |
+| `fetch_max_bytes` / `PROSODY_FETCH_MAX_BYTES` | Maximum bytes in one fetch response from one broker; accepts sizes such as `50 MiB` | 50 MiB |
+| `fetch_wait` / `PROSODY_FETCH_WAIT` | How long a broker can hold a fetch request when no new records are available. A shorter wait lowers the delay for a partition that is behind, but an idle consumer sends more fetch requests | 500ms |
 | `failure_topic` / `PROSODY_FAILURE_TOPIC` | Send unprocessable messages here (dead letter queue) | -                     |
 | `idempotence_cache_size` / `PROSODY_IDEMPOTENCE_CACHE_SIZE` | Capacity of the producer idempotence cache and of the consumer deduplication cache. Consumer deduplication cannot be turned off, so the value must be at least 1 | 8192 |
 | `idempotence_version` / `PROSODY_IDEMPOTENCE_VERSION` | Version string for cache-busting dedup hashes | 1              |

data/README.md

@@ -12,7 +12,7 @@ strategies, and integrated OpenTelemetry support for distributed tracing.
 - **Keyed State**: Per-key value/map/deque collections that survive across events, transactional by default
 - **Quality of Service**: Fair scheduling limits concurrency and prevents failures from starving fresh traffic. Pipeline mode adds deferred retry and monopolization detection
 - **Distributed Tracing**: OpenTelemetry integration for tracing message flow across services
-- **Backpressure**: Pauses partitions when handlers fall behind
+- **Backpressure**: Stops reading a partition when handlers fall behind
 - **Mocking**: In-memory Kafka broker for tests (`mock: true`)
 - **Failure Handling**: Pipeline (retry forever), Low-Latency (dead letter), Best-Effort (log and skip)
 
@@ -36,6 +36,15 @@ State definitions carry their item types through `context.state`. A bare handler
 message, definition, or state handle uses `Prosody::json_value`. See the
 [typed examples](examples/) for Ruby and companion RBS files checked by Steep.
 
+### Kafka version
+
+Prosody requires Kafka 4.0 or later. Consumers use the broker-side consumer
+group protocol (KIP-848). The broker assigns partitions, and a rebalance
+changes only the members whose partitions move. Brokers older than 4.0 do
+not support this protocol, and the client does not fall back to the classic
+protocol. A consumer that connects to an older broker logs a fatal error and
+gets no partitions, so its readiness probe stays unready.
+
 ## Quick Start
 
 ```ruby
@@ -110,7 +119,7 @@ Prosody enables efficient, parallel processing of Kafka messages while maintaini
 - **Partition-Level Parallelism**: Separate management of each Kafka partition
 - **Key-Based Queuing**: Ordered processing for each key within a partition
 - **Concurrent Processing**: Simultaneous processing of different keys
-- **Backpressure Management**: Pause consumption from backed-up partitions
+- **Backpressure Management**: Stop reading from backed-up partitions
 
 ## Quality of Service
 
@@ -627,7 +636,7 @@ State operations look synchronous. They yield the current fiber while Prosody pe
 
 | Collection | JSON payload | Kafka message | Main operations |
 | --- | --- | --- | --- |
-| Value | `Prosody.value` | `Prosody.message_value` | `get`, `set`, `clear` |
+| Value | `Prosody.value` | `Prosody.message_value` | `get`, `exist?`, `set`, `clear` |
 | Ordered string map | `Prosody.map` | `Prosody.message_map` | `get`, `get_many`, `key?`, `contains_many`, `empty?`, `set`, `delete`, `each_pair`, `each_key`, `clear` |
 | Ordered string set | `Prosody.set` | - | `add` / `<<`, `delete`, `include?`, `contains_many`, `empty?`, `each`, `clear` |
 | Deque | `Prosody.deque` | `Prosody.message_deque` | `push`, `unshift`, `pop`, `shift`, `get`, `length`, `each`, `clear` |
@@ -1265,7 +1274,7 @@ Definition constructors (each returns a frozen definition object used both in `C
 
 Each constructor returns a `StateDefinition`. It exposes `name`, `kind`, `payload`, all supplied options, and `to_state_config`.
 
-Published readers take the user key as their first argument. `Prosody::PublishedValue` provides `get`.
+Published readers take the user key as their first argument. `Prosody::PublishedValue` provides `get` and `exist?`.
 
 `Prosody::PublishedMap` provides `get`, `get_many`, `key?`, `has_key?`, `include?`, `member?`, `contains_many`, and `empty?`.
 
@@ -1279,7 +1288,7 @@ Traversal methods return an `Enumerator` without a block. Every traversal accept
 
 `Prosody::ValueState`:
 
-- `get` / `value`, `set(value)` / `value=`, `clear`, `commit`, and `rollback`
+- `get` / `value`, `exist?`, `set(value)` / `value=`, `clear`, `commit`, and `rollback`
 
 `Prosody::MapState` (keys are `String`):
 

data/lib/prosody/3.2/prosody.so

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: data/lib/prosody/3.2/prosody.so
-size: 37185312 bytes
-sha256: 7276c929ebae7bfeba7437c278e6d501df656ce73b41637f3475a3bc3724860c
+size: 37990664 bytes
+sha256: 9833ae65a879d0ed8c8efe9be81ce6d475514e048eb323b1564540aeceeab3c6

data/lib/prosody/3.3/prosody.so

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: data/lib/prosody/3.3/prosody.so
-size: 37185312 bytes
-sha256: 3cf39f59ea0ec2654fd108da5c1dd19ef9e7696fcc962ae34f8d7822d2c6bbf3
+size: 38003144 bytes
+sha256: 42f8eea6248fec902c829d0eae3cc81bae1dbc1a2191a18ee32092c5133ad08a

data/lib/prosody/3.4/prosody.so

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: data/lib/prosody/3.4/prosody.so
-size: 37189432 bytes
-sha256: 4cf4079124f87fe9d19bccae4c0b042f97f95abe22f834eace71cd76d91c7714
+size: 37978008 bytes
+sha256: 93dcdc7aad88187cd07476fe2a9798ae32420c35b5a047e09818cba029f7eef5

data/lib/prosody/configuration.rb

@@ -128,6 +128,22 @@ module Prosody
     # Env: PROSODY_STATISTICS_INTERVAL. Default: 5 seconds.
     config_param :statistics_interval, converter: ->(v) { duration_converter(v) }
 
+    # Bytes of fetched records that wait for each assigned partition, such as
+    # "128 KiB". Fetched memory grows with the number of assigned partitions:
+    # about two times this value, plus one batch, per partition.
+    # Env: PROSODY_PARTITION_PREFETCH. Default: 128 KiB.
+    config_param :partition_prefetch, converter: lambda(&:to_s)
+
+    # Maximum bytes in one fetch response from one broker, such as "50 MiB".
+    # Env: PROSODY_FETCH_MAX_BYTES. Default: 50 MiB.
+    config_param :fetch_max_bytes, converter: lambda(&:to_s)
+
+    # How long a broker can hold a fetch request when no new records are
+    # available (in seconds). A shorter wait lowers the delay for a partition
+    # that is behind, but an idle consumer sends more fetch requests.
+    # Env: PROSODY_FETCH_WAIT. Default: 0.5 seconds.
+    config_param :fetch_wait, converter: ->(v) { duration_converter(v) }
+
     # Base delay for retry operations (in seconds).
     config_param :retry_base, converter: ->(v) { duration_converter(v) }
 

data/lib/prosody/state/value.rb

@@ -16,6 +16,13 @@ module Prosody
     # @return [Object, nil] the stored value, or `nil` when absent
     def get = @native.get
 
+    # Returns true when the handle holds a value, including a buffered write.
+    # The check does not decode the value. For a message value, it does not
+    # fetch the Kafka message.
+    #
+    # @return [Boolean]
+    def exist? = @native.contains
+
     # Buffers a write of the value.
     #
     # @param value [Object] the value to store (JSON, or a message)
@@ -54,5 +61,12 @@ module Prosody
     # @param key [String] the user key
     # @return [Object, nil] the value, or +nil+ when it is absent
     def get(key) = @native.get(key)
+
+    # Returns true when a committed value exists for +key+. The check does not
+    # decode the value.
+    #
+    # @param key [String] the user key
+    # @return [Boolean]
+    def exist?(key) = @native.contains(key)
   end
 end

data/lib/prosody/version.rb

@@ -6,5 +6,5 @@ module Prosody
   # This version number follows semantic versioning and is used by the
   # gem system to identify the library version. It should be updated
   # according to semver guidelines when making releases.
-  VERSION = "0.6.1"
+  VERSION = "0.7.0"
 end

data/sig/configuration.rbs

@@ -67,6 +67,21 @@ module Prosody
     def statistics_interval: () -> Float?
     def statistics_interval=: (Numeric) -> Float
 
+    # Bytes of fetched records that wait for each assigned partition. Accepts
+    # a human-readable size. Uses PROSODY_PARTITION_PREFETCH when omitted.
+    def partition_prefetch: () -> String?
+    def partition_prefetch=: (String | _ToS) -> String
+
+    # Maximum bytes in one fetch response from one broker. Accepts a
+    # human-readable size. Uses PROSODY_FETCH_MAX_BYTES when omitted.
+    def fetch_max_bytes: () -> String?
+    def fetch_max_bytes=: (String | _ToS) -> String
+
+    # How long a broker can hold a fetch request when no new records are
+    # available (seconds). Uses PROSODY_FETCH_WAIT when omitted.
+    def fetch_wait: () -> Float?
+    def fetch_wait=: (Numeric) -> Float
+
     # Base delay for retry operations (seconds)
     def retry_base: () -> Float?
     def retry_base=: (Numeric) -> Float

data/sig/published.rbs

@@ -2,6 +2,7 @@ module Prosody
   # --- published-state readers, opened by Client#state -------------------
   class NativePublishedValue
     def get: (String key) -> json_value?
+    def contains: (String key) -> bool
   end
 
   class NativePublishedMap
@@ -32,6 +33,7 @@ module Prosody
 
   class PublishedValue[T = json_value]
     def get: (String key) -> T?
+    def exist?: (String key) -> bool
 
     private
     def initialize: (NativePublishedValue native) -> void

data/sig/state.rbs

@@ -110,6 +110,7 @@ module Prosody
   # Every op is fiber-yield async: it looks blocking but never blocks the thread.
   class ValueState[T = json_value] < State::Handle
     def get: () -> T?
+    def exist?: () -> bool
     def set: (T value) -> void
     def clear: () -> void
 
@@ -230,6 +231,7 @@ module Prosody
 
   interface _NativeValueHandle[T]
     def get: () -> T?
+    def contains: () -> bool
     def set: (T value) -> void
     def clear: () -> void
     def commit: () -> store_outcome

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: prosody
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: aarch64-linux
 authors:
 - Joshua Griffith
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-10-13 00:00:00.000000000 Z
+date: 2026-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: async
@@ -86,14 +86,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.2'
 description: |
   Prosody offers Ruby bindings to the Prosody Kafka client, providing features
   for message production and consumption, including configurable retry