rubydeako 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6d6be18ddcdcb42020b985fd5af245092b6872e0eb5be863b4c4d56f4fa04a79
+  data.tar.gz: d371706c18a9f3e7bc861247e41a565edf247341f3b3f2c7fc6a0b779a649304
+SHA512:
+  metadata.gz: 75d835d118b5fb7e7274acb20b8b5bf7f3c1bd94ee5b485d6e284c7dbdc16c7610f6e6035b9a3a249c536e03c23fb1dc53e3bf8a26bd697c6b7a1a0ceabf1b5a
+  data.tar.gz: 04136d2da692048d5c2f91753b914f68094cc24345d65cc61f4d6ba4bf5dcd50426efb11167452e112ce4a0bef5ac318369a2827bd25f22b659a8604c5e90120

data/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2025-07-02
+
+### Added
+- Initial implementation of rubydeako library
+- Device discovery via mDNS/Zeroconf
+- Socket-based communication with Deako switches
+- Device control (power on/off, dimming)
+- Real-time state updates and callbacks
+- Automatic connection management with heartbeat
+- Thread-safe operation
+- Complete test suite
+- Comprehensive documentation
+
+### Features
+- Compatible with Deako smart switches
+- Ruby port of the Python pydeako library
+- JSON-based protocol communication
+- Support for dimmable and non-dimmable switches
+- Automatic device discovery on local network

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Aaron Storrer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,139 @@
+# Rubydeako
+
+A Ruby library for interacting with Deako smart switches via local network discovery and control. This is a port of the Python `pydeako` library.
+
+## Features
+
+- Device discovery via mDNS/Zeroconf
+- Real-time device state updates
+- Control power and dimming for compatible devices
+- Thread-safe socket communication
+- Automatic connection management with heartbeat monitoring
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'rubydeako'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install rubydeako
+
+## Usage
+
+### Basic Example
+
+```ruby
+require 'rubydeako'
+
+# Create a discoverer to find Deako devices on the network
+discoverer = Rubydeako::Discover::DeakoDiscoverer.new
+
+# Create the main client
+deako = Rubydeako::Deako.new(
+  discoverer.method(:get_address),
+  client_name: "MyRubyApp"
+)
+
+begin
+  # Connect to a device
+  deako.connect
+  
+  # Discover all devices
+  deako.find_devices
+  
+  # List discovered devices
+  deako.devices.each do |uuid, device|
+    puts "Device: #{device['name']} (#{uuid})"
+    puts "  Power: #{device['state']['power']}"
+    puts "  Dimmable: #{device['dimmable']}"
+  end
+  
+  # Control a device
+  if deako.devices.any?
+    first_uuid = deako.devices.keys.first
+    
+    # Turn on
+    deako.control_device(first_uuid, true)
+    
+    # Dim to 50% (if dimmable)
+    if deako.dimmable?(first_uuid)
+      deako.control_device(first_uuid, true, dim: 50)
+    end
+    
+    # Turn off
+    deako.control_device(first_uuid, false)
+  end
+  
+ensure
+  deako.disconnect
+  discoverer.stop
+end
+```
+
+### Device State Callbacks
+
+```ruby
+# Set up a callback for state changes
+deako.set_state_callback(uuid) do
+  puts "Device #{uuid} state changed!"
+  state = deako.get_state(uuid)
+  puts "Power: #{state['power']}, Dim: #{state['dim']}"
+end
+```
+
+## API Reference
+
+### Main Classes
+
+#### `Rubydeako::Deako`
+
+The main client class for controlling Deako devices.
+
+**Methods:**
+- `connect` - Establish connection to devices
+- `disconnect` - Close all connections
+- `find_devices(timeout: 10)` - Discover devices on network
+- `control_device(uuid, power, dim: nil)` - Control device state
+- `get_name(uuid)` - Get device name
+- `get_state(uuid)` - Get device current state
+- `dimmable?(uuid)` - Check if device supports dimming
+- `set_state_callback(uuid, callback)` - Set state change callback
+
+#### `Rubydeako::Discover::DeakoDiscoverer`
+
+Handles mDNS discovery of Deako devices.
+
+**Methods:**
+- `start` - Begin device discovery
+- `stop` - Stop discovery
+- `get_address` - Get discovered device address
+
+## Dependencies
+
+- `dnssd` - mDNS/Zeroconf service discovery
+- `async` - Asynchronous I/O operations
+- `concurrent-ruby` - Thread-safe collections
+
+## Development
+
+After checking out the repo, run `bundle install` to install dependencies. Then, run `bundle exec rspec` to run the tests.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub.
+
+## License
+
+The gem is available as open source under the [MIT License](https://opensource.org/licenses/MIT).
+
+## Acknowledgments
+
+This library is a Ruby port of the Python [pydeako](https://github.com/DeakoLights/pydeako) library.

data/lib/rubydeako/deako.rb

@@ -0,0 +1,171 @@
+# frozen_string_literal: true
+
+require 'logger'
+require_relative 'manager'
+require_relative 'models/constants'
+
+module Rubydeako
+  class FindDevicesError < StandardError
+    attr_reader :reason
+
+    def initialize(reason = 'unknown')
+      @reason = reason
+      super("Failed to find devices: #{reason}")
+    end
+  end
+
+  class Deako
+    DEVICE_FOUND_TIME_FACTOR_S = 2
+    DEFAULT_DEVICE_LIST_TIMEOUT_S = 10
+    DEVICE_LIST_POLLING_INTERVAL_S = 1
+    DEVICE_FOUND_POLLING_INTERVAL_S = 1
+    CAPABILITY_DIMMABLE = 'dim'
+
+    attr_reader :devices, :expected_devices
+
+    def initialize(get_address_proc, client_name: nil)
+      @connection_manager = Manager.new(
+        get_address_proc,
+        method(:incoming_json),
+        client_name: client_name
+      )
+      @devices = {}
+      @expected_devices = 0
+      @logger = Logger.new($stdout)
+      @logger.level = Logger::DEBUG
+    end
+
+    def connect
+      @connection_manager.init_connection
+    end
+
+    def disconnect
+      @connection_manager.close
+    end
+
+    def find_devices(timeout: DEFAULT_DEVICE_LIST_TIMEOUT_S)
+      @logger.info('Finding devices')
+      success = @connection_manager.send_get_device_list
+
+      raise FindDevicesError, 'Failed to send device list request' unless success
+
+      remaining = timeout
+      # Wait for device list
+      while @expected_devices == 0 && remaining > 0
+        @logger.debug("waiting for device list... time remaining: #{remaining}s")
+        sleep(DEVICE_LIST_POLLING_INTERVAL_S)
+        remaining -= DEVICE_LIST_POLLING_INTERVAL_S
+      end
+
+      # If we get a response, expected_devices will be at least 1
+      raise FindDevicesError, 'Timed out waiting for device list response' if @expected_devices == 0
+
+      remaining = @expected_devices * DEVICE_FOUND_TIME_FACTOR_S
+      while @devices.length != @expected_devices && remaining > 0
+        @logger.debug(
+          "waiting for devices... expected: #{@expected_devices}, " \
+          "received: #{@devices.length}, time remaining: #{remaining}s"
+        )
+        sleep(DEVICE_FOUND_POLLING_INTERVAL_S)
+        remaining -= DEVICE_FOUND_POLLING_INTERVAL_S
+      end
+
+      @logger.debug("found #{@devices.length} devices")
+
+      return unless @devices.length != @expected_devices && remaining == 0
+
+      raise FindDevicesError,
+            'Timed out waiting for devices to be found. Expected ' \
+            "#{@expected_devices} devices but only found #{@devices.length}"
+    end
+
+    def control_device(uuid, power, dim: nil)
+      completed_callback = proc { update_state(uuid, power, dim) }
+      @connection_manager.send_state_change(
+        uuid, power, dim: dim, completed_callback: completed_callback
+      )
+    end
+
+    def get_name(uuid)
+      device_data = @devices[uuid]
+      return nil if device_data.nil?
+
+      device_data['name']
+    end
+
+    def get_state(uuid)
+      device_data = @devices[uuid]
+      return nil if device_data.nil?
+
+      device_data['state']
+    end
+
+    def dimmable?(uuid)
+      device_data = @devices[uuid]
+      return nil if device_data.nil?
+
+      device_data['dimmable']
+    end
+
+    def set_state_callback(uuid, callback)
+      return unless @devices.key?(uuid)
+
+      @devices[uuid]['callback'] = callback
+    end
+
+    def update_state(uuid, power, dim = nil)
+      return unless @devices.key?(uuid)
+
+      @devices[uuid]['state']['power'] = power
+      # Dimmables don't always send dim
+      @devices[uuid]['state']['dim'] = dim || @devices[uuid]['state']['dim']
+
+      @devices[uuid]['callback']&.call
+    end
+
+    private
+
+    def incoming_json(in_data)
+      case in_data['type']
+      when Models::ResponseType::DEVICE_LIST
+        subdata = in_data['data']
+        @expected_devices = subdata['number_of_devices']
+
+      when Models::ResponseType::DEVICE_FOUND
+        subdata = in_data['data']
+        state = subdata['state']
+
+        dimmable = if subdata['capabilities']
+                     subdata['capabilities'].include?(CAPABILITY_DIMMABLE)
+                   else
+                     # Support older local API versions
+                     !state['dim'].nil?
+                   end
+
+        record_device(
+          subdata['name'],
+          subdata['uuid'],
+          dimmable,
+          state['power'],
+          state['dim']
+        )
+
+      when Models::ResponseType::EVENT
+        subdata = in_data['data']
+        state = subdata['state']
+        update_state(subdata['target'], state['power'], state['dim'])
+      end
+    rescue StandardError => e
+      @logger.error("Failed to parse #{in_data}: #{e}")
+    end
+
+    def record_device(name, uuid, dimmable, power, dim = nil)
+      @devices[uuid] ||= { 'state' => {} }
+      @devices[uuid]['name'] = name
+      @devices[uuid]['uuid'] = uuid
+      @devices[uuid]['dimmable'] = dimmable
+      @devices[uuid]['state']['power'] = power
+      @devices[uuid]['state']['dim'] = dim
+    end
+  end
+end

data/lib/rubydeako/discover/address_pool.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'concurrent/map'
+
+module Rubydeako
+  module Discover
+    class EmptyAddressPool < StandardError; end
+
+    class AddressPool
+      def initialize
+        @addresses = Concurrent::Map.new
+        @mutex = Mutex.new
+      end
+
+      def available_addresses
+        @addresses.size
+      end
+
+      def add_address(address, name)
+        @mutex.synchronize do
+          @addresses[address] = name
+        end
+      end
+
+      def get_address
+        @mutex.synchronize do
+          raise EmptyAddressPool if @addresses.empty?
+
+          # Get first key-value pair from Concurrent::Map
+          address = nil
+          name = nil
+          @addresses.each_pair do |addr, n|
+            address = addr
+            name = n
+            break
+          end
+
+          @addresses.delete(address)
+          [address, name]
+        end
+      end
+
+      def remove_address(address)
+        @mutex.synchronize do
+          @addresses.delete(address)
+        end
+      end
+    end
+  end
+end

data/lib/rubydeako/discover/discoverer.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+require 'dnssd'
+require 'socket'
+require 'logger'
+require_relative 'address_pool'
+
+module Rubydeako
+  module Discover
+    DEAKO_TYPE = '_deako._tcp'
+    TIMEOUT_S = 10
+    POLLING_INTERVAL_S = 0.5
+
+    class DevicesNotFoundException < StandardError
+      def initialize(msg = "No devices found via #{DEAKO_TYPE}")
+        super(msg)
+      end
+    end
+
+    class DeakoDiscoverer
+      attr_reader :address_pool
+
+      def initialize
+        @address_pool = AddressPool.new
+        @logger = Logger.new($stdout)
+        @logger.level = Logger::DEBUG
+        @running = false
+        @browse_thread = nil
+      end
+
+      def start
+        return if @running
+
+        @running = true
+        @browse_thread = Thread.new { browse_services }
+      end
+
+      def stop
+        @running = false
+        @browse_thread&.join
+      end
+
+      def get_address
+        start unless @running
+
+        total_time = 0.0
+        while total_time < TIMEOUT_S && @address_pool.available_addresses < 1
+          sleep(POLLING_INTERVAL_S)
+          total_time += POLLING_INTERVAL_S
+        end
+
+        raise DevicesNotFoundException if @address_pool.available_addresses == 0
+
+        address, name = @address_pool.get_address
+        @logger.debug("Got address #{address}, with device name #{name}")
+        [address, name]
+      end
+
+      private
+
+      def browse_services
+        DNSSD.browse(DEAKO_TYPE) do |reply|
+          next unless @running
+
+          begin
+            resolve_service(reply.name, reply.type, reply.domain)
+          rescue StandardError => e
+            @logger.error("Error resolving service: #{e}")
+          end
+        end
+      rescue StandardError => e
+        @logger.error("Error browsing services: #{e}")
+      end
+
+      def resolve_service(name, type, domain)
+        DNSSD.resolve(name, type, domain) do |resolve_reply|
+          get_address_info(resolve_reply.target, resolve_reply.port, name)
+        end
+      end
+
+      def get_address_info(target, port, name)
+        addrinfo = Addrinfo.getaddrinfo(target, port, Socket::AF_INET, Socket::SOCK_STREAM)
+        addrinfo.each do |addr|
+          address = "#{addr.ip_address}:#{port}"
+          @address_pool.add_address(address, name)
+          @logger.debug("Add service with address #{address}, name #{name}")
+        end
+      rescue StandardError => e
+        @logger.error("Error getting address info for #{target}:#{port}: #{e}")
+      end
+    end
+  end
+end

data/lib/rubydeako/manager.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+require 'logger'
+require_relative 'utils/connection'
+require_relative 'request'
+require_relative 'models/request'
+require_relative 'models/constants'
+require_relative 'discover/discoverer'
+
+module Rubydeako
+  class Manager
+    CONNECTED_POLLING_INTERVAL_S = 1
+    CONNECTION_TIMEOUT_S = 10
+    WORKER_WAIT_S = 0.5
+    PING_WORKER_WAIT_S = 10
+
+    attr_reader :connection
+
+    def initialize(get_address_proc, incoming_json_callback, client_name: nil)
+      @get_address_proc = get_address_proc
+      @incoming_json_callback = incoming_json_callback
+      @client_name = client_name
+      @connection = nil
+      @logger = Logger.new($stdout)
+      @logger.level = Logger::DEBUG
+      @connecting = false
+      @canceled = false
+      @pong_received = false
+      @maintain_thread = nil
+      @connection_thread = nil
+    end
+
+    def init_connection
+      return if @connecting
+
+      @connecting = true
+      @connection_thread = Thread.new do
+        address, name = @get_address_proc.call
+        connection = Utils::Connection.new(address, name, method(:incoming_json))
+        connection.start
+
+        timeout = 0
+        while !connection.connected? && timeout < CONNECTION_TIMEOUT_S
+          sleep(CONNECTED_POLLING_INTERVAL_S)
+          timeout += CONNECTED_POLLING_INTERVAL_S
+        end
+
+        if timeout >= CONNECTION_TIMEOUT_S
+          @logger.error('Timeout attempting to connect. Trying again')
+          connection.stop
+          @connecting = false
+          init_connection
+          return
+        end
+
+        @connection = connection
+        start_maintain_worker
+        @connecting = false
+      rescue Discover::DevicesNotFoundException
+        @logger.warn('No devices to connect to')
+        @connecting = false
+        sleep(5) # Wait before retrying
+        init_connection
+      rescue StandardError => e
+        @logger.error("Error during connection initialization: #{e}")
+        @connecting = false
+      end
+    end
+
+    def close
+      @logger.debug('Closing connection and canceling workers')
+      @canceled = true
+
+      @maintain_thread&.kill
+      @connection_thread&.kill
+      @connection&.stop
+      @connection = nil
+    end
+
+    def send_get_device_list
+      request = Request.new(
+        Models::Request.device_list_request(source: @client_name)
+      )
+      send_request(request)
+    end
+
+    def send_state_change(uuid, power, dim: nil, completed_callback: nil)
+      request = Request.new(
+        Models::Request.state_change_request(
+          device_uuid: uuid,
+          power: power,
+          dim: dim,
+          source: @client_name
+        ),
+        completed_callback: completed_callback
+      )
+      send_request(request)
+    end
+
+    def send_request(request)
+      if @connection&.connected?
+        @connection.send_data("#{request.body_str}\r\n")
+        request.complete_callback
+        true
+      else
+        @logger.warn('No connection to send data to')
+        false
+      end
+    end
+
+    private
+
+    def start_maintain_worker
+      return if @maintain_thread&.alive?
+
+      @maintain_thread = Thread.new do
+        sleep(PING_WORKER_WAIT_S)
+
+        until @canceled
+          @pong_received = false
+          @logger.debug('Pinging for responsiveness')
+
+          ping_request = Request.new(
+            Models::Request.device_ping_request(source: @client_name)
+          )
+          send_request(ping_request)
+
+          sleep(PING_WORKER_WAIT_S)
+
+          if @pong_received
+            @logger.debug('Pong received')
+          else
+            @logger.warn('Never received pong! Dumping this connection')
+            close
+            init_connection
+            break
+          end
+        end
+      end
+    end
+
+    def incoming_json(json_data)
+      response_type = json_data['type']
+      if response_type == Models::ResponseType::PONG
+        @pong_received = true
+      else
+        @incoming_json_callback.call(json_data)
+      end
+    end
+  end
+end

data/lib/rubydeako/models/constants.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Rubydeako
+  module Models
+    SOURCE = 'rubydeako_default'
+    DESTINATION = 'deako'
+
+    module RequestType
+      CONTROL = 'CONTROL'
+      DEVICE_LIST = 'DEVICE_LIST'
+      PING = 'PING'
+    end
+
+    module ResponseType
+      DEVICE_FOUND = 'DEVICE_FOUND'
+      DEVICE_LIST = 'DEVICE_LIST'
+      EVENT = 'EVENT'
+      PONG = 'PING'
+    end
+  end
+end

data/lib/rubydeako/models/request.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+require_relative 'constants'
+
+module Rubydeako
+  module Models
+    module Request
+      module_function
+
+      def base_request(destination: nil, source: nil, transaction_id: nil)
+        {
+          'transactionId' => transaction_id || SecureRandom.uuid,
+          'dst' => destination || DESTINATION,
+          'src' => source || SOURCE
+        }
+      end
+
+      def device_ping_request(**kwargs)
+        base_request(**kwargs).merge(
+          'type' => RequestType::PING
+        )
+      end
+
+      def device_list_request(**kwargs)
+        base_request(**kwargs).merge(
+          'type' => RequestType::DEVICE_LIST
+        )
+      end
+
+      def state_change_request(device_uuid:, power:, dim: nil, **kwargs)
+        state = { 'power' => power }
+        state['dim'] = dim unless dim.nil?
+
+        base_request(**kwargs).merge(
+          'type' => RequestType::CONTROL,
+          'data' => {
+            'target' => device_uuid,
+            'state' => state
+          }
+        )
+      end
+    end
+  end
+end

data/lib/rubydeako/request.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'json'
+
+module Rubydeako
+  class Request
+    attr_reader :body, :completed_callback
+
+    def initialize(body, completed_callback: nil)
+      @body = body
+      @completed_callback = completed_callback
+    end
+
+    def body_str
+      JSON.generate(@body)
+    end
+
+    def type
+      @body['type']
+    end
+
+    def complete_callback
+      @completed_callback&.call
+    end
+  end
+end

data/lib/rubydeako/utils/connection.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'logger'
+require_relative 'socket'
+
+module Rubydeako
+  module Utils
+    class UnknownStateException < StandardError; end
+
+    module ConnectionState
+      UNKNOWN = -1
+      NOT_STARTED = 0
+      CONNECTED = 1
+      ERROR = 2
+      CLOSED = 3
+    end
+
+    class Connection
+      attr_reader :address, :name, :state
+
+      def initialize(address, name, on_data_callback)
+        @address = address
+        @name = name
+        @on_data_callback = on_data_callback
+        @state = ConnectionState::NOT_STARTED
+        @message_buffer = ''
+        @socket = SocketConnection.new(address)
+        @logger = Logger.new($stdout)
+        @logger.level = Logger::DEBUG
+        @running = false
+        @thread = nil
+      end
+
+      def start
+        return if @running
+
+        @running = true
+        @thread = Thread.new { run }
+      end
+
+      def stop
+        @running = false
+        close
+        @thread&.join
+      end
+
+      def send_data(data_to_send)
+        @logger.debug("[#{@address}] Sending data: #{data_to_send}")
+        begin
+          @socket.send_bytes(data_to_send.encode('utf-8'))
+        rescue StandardError => e
+          @logger.error("Error sending data: #{e}")
+          @state = ConnectionState::ERROR
+        end
+      end
+
+      def connected?
+        @state == ConnectionState::CONNECTED
+      end
+
+      def format_name
+        "#{@name}@#{@address}"
+      end
+
+      private
+
+      def run
+        while @running
+          case @state
+          when ConnectionState::NOT_STARTED
+            begin
+              @socket.connect_socket
+              @state = ConnectionState::CONNECTED
+              @logger.info("Connected to Deako local integrations with #{format_name}")
+            rescue StandardError => e
+              @logger.error("Failed to connect #{format_name} because #{e}")
+              @state = ConnectionState::ERROR
+            end
+
+          when ConnectionState::CONNECTED
+            begin
+              read_socket
+            rescue StandardError => e
+              @logger.error("Failed to read socket #{format_name} because #{e}")
+              @state = ConnectionState::ERROR
+            end
+
+          when ConnectionState::ERROR
+            begin
+              close
+              @state = ConnectionState::CLOSED
+            rescue StandardError => e
+              @logger.error("Failed to close socket #{format_name} because #{e}")
+              @state = ConnectionState::CLOSED
+            end
+
+          when ConnectionState::CLOSED
+            break
+
+          else
+            error_msg = "Unknown state: #{@state}"
+            @logger.error(error_msg)
+            raise UnknownStateException, error_msg
+          end
+
+          sleep(0.1) # Small delay to prevent busy waiting
+        end
+      end
+
+      def read_socket
+        data = @socket.read_bytes
+        parse_data(data)
+      rescue StandardError => e
+        @logger.error("Error receiving data: #{e}")
+        @state = ConnectionState::ERROR
+      end
+
+      def parse_data(data)
+        raw_string = data.force_encoding('utf-8')
+        @logger.debug("[#{format_name}] Raw message received: #{raw_string}")
+
+        messages = raw_string.strip.split("\r\n")
+        messages.each do |message_str|
+          @message_buffer += message_str
+          begin
+            message_json = JSON.parse(@message_buffer)
+            @on_data_callback.call(message_json)
+            @message_buffer = ''
+          rescue JSON::ParserError
+            @logger.debug("Got partial message: #{@message_buffer}")
+          end
+        end
+      end
+
+      def close
+        @socket.close_socket
+      end
+    end
+  end
+end

data/lib/rubydeako/utils/socket.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require 'socket'
+require 'logger'
+
+module Rubydeako
+  module Utils
+    class NoSocketException < StandardError; end
+
+    class SocketConnection
+      MAX_PACKET_SIZE_BYTES = 2048
+
+      attr_reader :address
+
+      def initialize(address)
+        @address = address
+        @socket = nil
+        @logger = Logger.new($stdout)
+        @logger.level = Logger::DEBUG
+      end
+
+      def connect_socket
+        @socket = Socket.new(Socket::AF_INET, Socket::SOCK_STREAM)
+        @socket.setsockopt(Socket::SOL_SOCKET, Socket::SO_REUSEADDR, 1)
+
+        @logger.info("Connecting to #{@address}")
+        host, port = @address.split(':')
+        @socket.connect(Socket.sockaddr_in(port.to_i, host))
+      end
+
+      def close_socket
+        return unless @socket
+
+        @socket.close
+        @socket = nil
+      end
+
+      def send_bytes(data)
+        raise NoSocketException, 'No socket to send data to' unless @socket
+
+        @socket.write(data)
+      end
+
+      def read_bytes
+        raise NoSocketException, 'No socket to read' unless @socket
+
+        @socket.read_nonblock(MAX_PACKET_SIZE_BYTES)
+      rescue IO::WaitReadable
+        IO.select([@socket])
+        retry
+      end
+
+      def connected?
+        !@socket.nil? && !@socket.closed?
+      end
+    end
+  end
+end

data/lib/rubydeako/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Rubydeako
+  VERSION = '0.1.0'
+end

data/lib/rubydeako.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require_relative 'rubydeako/version'
+require_relative 'rubydeako/models/constants'
+require_relative 'rubydeako/models/request'
+require_relative 'rubydeako/discover/discoverer'
+require_relative 'rubydeako/discover/address_pool'
+require_relative 'rubydeako/utils/connection'
+require_relative 'rubydeako/utils/socket'
+require_relative 'rubydeako/request'
+require_relative 'rubydeako/manager'
+require_relative 'rubydeako/deako'
+
+module Rubydeako
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,132 @@
+--- !ruby/object:Gem::Specification
+name: rubydeako
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Aaron
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-07-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: async-io
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: dnssd
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: A Ruby implementation of the pydeako library for controlling Deako smart
+  switches via local network discovery and control
+email:
+- aaron@storrer.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- lib/rubydeako.rb
+- lib/rubydeako/deako.rb
+- lib/rubydeako/discover/address_pool.rb
+- lib/rubydeako/discover/discoverer.rb
+- lib/rubydeako/manager.rb
+- lib/rubydeako/models/constants.rb
+- lib/rubydeako/models/request.rb
+- lib/rubydeako/request.rb
+- lib/rubydeako/utils/connection.rb
+- lib/rubydeako/utils/socket.rb
+- lib/rubydeako/version.rb
+homepage: https://github.com/astorrer/rubydeako
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/astorrer/rubydeako
+  changelog_uri: https://github.com/astorrer/rubydeako/blob/main/CHANGELOG.md
+  documentation_uri: https://github.com/astorrer/rubydeako/blob/main/README.md
+  bug_tracker_uri: https://github.com/astorrer/rubydeako/issues
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Ruby library for interacting with Deako smart switches
+test_files: []