omq-backend-rust 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f12671673afe657015b59cf65873132c88c5cbb15cf34962b54318fb944310c
-  data.tar.gz: 3b7de77e6e01dc461fa0aa969870472442a2f9b3b4657fa5b35ca1fe90bd8940
+  metadata.gz: ed979a32dfef182642cb03dba149e36843c9e37fed1e75032c439b35d769d145
+  data.tar.gz: bd80cf78e629a3b4af1bec1ec6646ea9df635be16c096b1a9d597aed05918d79
 SHA512:
-  metadata.gz: 77dda34fcf69ef4d048d74276b1ae5cd455b23086de0a826f751862014e0d048dd8f27ccc2042f5332ff91a5410f11243f687450ca0093e58ab19377b64ec9dd
-  data.tar.gz: 2536562047da85d828e732a03c5a551a85b2b0774821f3ada32f890ba48f4453696c0243ef5e66248cbdee763623d1cf0f9b45bb74ac5e9aedba6aab014558ed
+  metadata.gz: fe616024d998eeae83b17b81bfedba2e49bc542a16b8fb6a4f13df4e6a21f768603e497276817c722a5dd1308c54979ad6b615af0d944d692f2faf78c9c77efc
+  data.tar.gz: be283792e7d988030b6d13859b206e10c6c8ae355285809a9282ff40c7b14ae4a7b35fa908a24a3e5daa122040c82073c7f022569d163ce451b80ebb8d37faa5

data/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## [Unreleased]
 
+## [0.3.1] - 2026-10-15
+
+### Fixed
+
+- Resolve RADIO subscriber readiness on `join_received` monitor events.
+- Reject unsupported security mechanisms instead of silently using NULL.
+- Forward CURVE authenticators on MRI, TruffleRuby, and JRuby, preserving the
+  Ruby `PeerInfo` and crypto public-key types.
+- Reject JRuby authenticator configuration when the OMQ.java callback classes
+  are missing from the JVM classpath.
+
+### Changed
+
+- Require `omq-rs >= 0.2.5` for native authentication callbacks and REQ/REP
+  fixes: reject unrelated REQ replies and bodyless REP requests, and preserve
+  REP reply destinations across prefetched requests and disconnects.
+
 ## [0.3.0] - 2026-08-26
 
 ### Added

data/README.md

@@ -12,8 +12,11 @@ MRI and TruffleRuby, or through OMQ.java on JRuby.
 
 ## Install
 
-The `omq-rs` dependency compiles OMQ.rs during installation on MRI and
-TruffleRuby. JRuby uses OMQ.java on Java 25 or newer. The Java gem selects the
+The `omq-rs >= 0.2.5` dependency compiles OMQ.rs during installation on MRI
+and TruffleRuby. This minimum includes the REQ/REP envelope and reply-routing
+fixes in `omq-tokio` 0.28.1 and `omq-proto` 0.32.1.
+
+JRuby uses OMQ.java on Java 25 or newer. The Java gem selects the
 matching OMQ.java artifact on Linux x86_64, macOS aarch64, macOS x86_64, and
 Windows x86_64.
 
@@ -48,8 +51,7 @@ ensure
 end
 ```
 
-The `:rust` backend is fully interoperable with the default `:ruby` backend.
-Mix backends freely within the same process.
+Select a backend per socket to exchange ZMTP messages with Ruby and other peers.
 
 ## Supported socket types
 
@@ -62,6 +64,23 @@ SCATTER/GATHER, CHANNEL.
 - **NULL** (default)
 - **CURVE** (CurveZMQ, via [Nuckle](https://github.com/paddor/nuckle))
 
+CURVE authenticators receive `Protocol::ZMTP::PeerInfo`, including a public key
+from the configured crypto backend. As with the Ruby engine, the identity is
+empty during authentication.
+
+On JRuby, OMQ.java 0.3.0's JNI callback threads require the platform jar on the
+JVM `CLASSPATH`. For example:
+
+```sh
+CLASSPATH="$HOME/.m2/repository/io/github/paddor/omq-java/0.3.0/omq-java-0.3.0-linux-x86_64.jar" jruby app.rb
+```
+
+Without it, configuring a CURVE authenticator raises `ArgumentError` before
+opening a connection. CURVE without an authenticator does not need this workaround.
+
+PLAIN and custom mechanisms raise `ArgumentError` before binding, connecting,
+or sending. They are not supported by this adapter.
+
 ## Compressed transports
 
 The Rust backend supports `lz4+tcp://` and `zstd+tcp://`. Compression

data/lib/omq/rust/engine.rb

@@ -246,7 +246,7 @@ module OMQ
           if @had_peer && @connections.empty? && !@all_peers_gone.resolved?
             @all_peers_gone.resolve(true)
           end
-        when :subscribe_received
+        when :subscribe_received, :join_received
           @subscriber_joined.resolve(true) unless @subscriber_joined.resolved?
         end
 
@@ -372,14 +372,12 @@ module OMQ
 
       def extract_mechanism(h)
         mech = @options.mechanism
-        case mech
-        when Protocol::ZMTP::Mechanism::Null
+        if mech.nil? || mech.instance_of?(Protocol::ZMTP::Mechanism::Null)
           h["mechanism_type"] = "null"
+        elsif defined?(Protocol::ZMTP::Mechanism::Curve) && mech.instance_of?(Protocol::ZMTP::Mechanism::Curve)
+          extract_curve_mechanism(h, mech)
         else
-          klass = mech.class.name
-          if klass&.include?("Curve")
-            extract_curve_mechanism(h, mech)
-          end
+          raise ArgumentError, "Rust backend does not support security mechanism #{mech.class}"
         end
       end
 
@@ -397,6 +395,15 @@ module OMQ
           srv_key = mech.instance_variable_get(:@server_public)
           h["mechanism_server_key"] = srv_key.to_s.b if srv_key
         end
+
+        if (authenticator = mech.instance_variable_get(:@authenticator))
+          require "protocol/zmtp/z85"
+          crypto = mech.instance_variable_get(:@crypto)
+          h["curve_auth"] = lambda do |peer|
+            public_key = crypto::PublicKey.new(Protocol::ZMTP::Z85.decode(peer.public_key))
+            authenticator.call(Protocol::ZMTP::PeerInfo.new(public_key: public_key, identity: ""))
+          end
+        end
       end
 
 

data/lib/omq/rust/java/engine.rb

@@ -426,8 +426,11 @@ module OMQ
 
         def apply_mechanism(builder)
           mech = @options.mechanism
-          klass = mech.class.name
-          return unless klass&.include?("Curve")
+          return if mech.nil? || mech.instance_of?(Protocol::ZMTP::Mechanism::Null)
+
+          unless defined?(Protocol::ZMTP::Mechanism::Curve) && mech.instance_of?(Protocol::ZMTP::Mechanism::Curve)
+            raise ArgumentError, "Rust backend does not support security mechanism #{mech.class}"
+          end
 
           require "protocol/zmtp/z85"
 
@@ -437,13 +440,32 @@ module OMQ
           )
 
           if mech.instance_variable_get(:@as_server)
-            builder.curveServer(keypair)
+            if (authenticator = mech.instance_variable_get(:@authenticator))
+              validate_authenticator_classpath!
+              crypto = mech.instance_variable_get(:@crypto)
+              callback = lambda do |peer|
+                public_key = crypto::PublicKey.new(Protocol::ZMTP::Z85.decode(peer.publicKey.orElse(nil)))
+                !!authenticator.call(Protocol::ZMTP::PeerInfo.new(public_key: public_key, identity: ""))
+              end
+              builder.curveServer(keypair, callback)
+            else
+              builder.curveServer(keypair)
+            end
           else
             builder.curveClient(keypair, z85_key(mech.instance_variable_get(:@server_public), "server key"))
           end
         end
 
 
+        # OMQ.java's JNI callback threads resolve PeerInfo through the JVM
+        # system class loader, which cannot see JRuby's dynamically loaded jars.
+        def validate_authenticator_classpath!
+          ::Java::JavaLang::Class.forName("io.omq.PeerInfo", false, ::Java::JavaLang::ClassLoader.getSystemClassLoader)
+        rescue ::Java::JavaLang::ClassNotFoundException
+          raise ArgumentError, "JRuby CURVE authenticators require the OMQ.java jar on the JVM CLASSPATH"
+        end
+
+
         def z85_key(key, label)
           raw = key&.to_s&.b
           raise ArgumentError, "#{label} must be exactly 32 bytes" unless raw&.bytesize == 32

data/lib/omq/rust/version.rb

@@ -3,7 +3,7 @@
 module OMQ
   module Backend
     module Rust
-      VERSION = "0.3.0"
+      VERSION = "0.3.1"
     end
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: omq-backend-rust
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Patrik Wenger
@@ -29,14 +29,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.5
 description: Drop-in Rust backend for OMQ. Same socket API (REQ/REP, PUB/SUB, PUSH/PULL,
   DEALER/ROUTER, and all draft types), backed by the first-class omq-rs Ruby binding.
   Fully interoperable with the default Ruby engine.
@@ -73,7 +79,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: OMQ.rs backend for OMQ.rb
 test_files: []