meshtastic 0.0.182 → 0.0.184

data/lib/meshtastic/rtttl.rb

@@ -11,11 +11,25 @@ module Meshtastic
     end
 
     public_class_method def self.set(opts = {})
-      Admin.send(opts.merge(set_ringtone_message: opts.fetch(:ringtone)))
+      Admin.send(admin_options(opts).merge(set_ringtone_message: opts.fetch(:ringtone)))
     end
 
     public_class_method def self.get(opts = {})
-      Admin.send(opts.merge(get_ringtone_request: true))
+      Admin.send(admin_options(opts).merge(get_ringtone_request: true))
+    end
+
+    # Keep the external transport aliases out of the Admin API.
+    private_class_method def self.admin_options(opts = {})
+      options = opts.merge({})
+      keys = %i[transport_obj serial_obj bluetooth_obj tcp_obj mqtt_obj]
+      selected = keys.reject { |name| options[name].nil? }
+      raise ArgumentError, 'provide exactly one transport connection' if selected.length > 1
+
+      key = selected.first
+      connection = options[key] if key
+      keys.each { |name| options.delete(name) }
+      options[:transport_obj] = connection if key
+      options
     end
 
     public_class_method def self.authors
@@ -28,10 +42,14 @@ module Meshtastic
         #{self}.encode
 
         # Run the set class method for this module.
-        #{self}.set
+        #{self}.set(transport_obj: connection, ringtone: ringtone)
 
         # Run the get class method for this module.
-        #{self}.get
+        #{self}.get(transport_obj: connection)
+
+        # Legacy serial_obj:, bluetooth_obj:, tcp_obj:, mqtt_obj: remain accepted.
+        # Supply one non-nil connection only; mixed connection options are rejected.
+        # Remote setters inherit Admin automatic sessions, not persistence readback.
 
         # Run the authors class method for this module.
         #{self}.authors

data/lib/meshtastic/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Meshtastic
-  VERSION = '0.0.182'
+  VERSION = '0.0.184'
 end