valkey 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e2b7ce5f8e5e8d2398b9c9e8c9c8e064e88d165ffb53d408d137deeae7b55520
+  data.tar.gz: fed8dc344aee90bdca008f64b935f89164303679000328024bd63d01b418c95f
+SHA512:
+  metadata.gz: a09a5e4c81ebf875ebc41613679d480e49b08826e233f67f2a0e5d45b8fdb5cc25e0267a2c0fd17cac8a5e638b843c3c0ca62ff440c38d036a0b5fc15ea417f6
+  data.tar.gz: 55a87cfcf18c1f78aa41e0964c3bd95520bc9e3f2369cae958ce095582d547d201a422a9e7f2f0ea3df0255d73561ea05fe01cad66d708f56c1245749f4ee5cd

data/.rubocop.yml

@@ -0,0 +1,12 @@
+AllCops:
+  TargetRubyVersion: 3.1
+  Exclude:
+    - 'lib/valkey/protobuf/**/*.rb'
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+

data/README.md

@@ -0,0 +1,25 @@
+# Valkey
+
+Valkey gem is based on redis-rb and provides a Ruby client for Valkey
+
+## Getting started
+
+Install with:
+
+```
+$ gem install valkey
+```
+
+You can connect to Valkey by instantiating the `Valkey` class:
+
+```ruby
+require "valkey"
+
+valkey = Valkey.new
+
+valkey.set("mykey", "hello world")
+# => "OK"
+
+valkey.get("mykey")
+# => "hello world"
+```

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/lib/valkey/bindings.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+class Valkey
+  module Bindings
+    extend FFI::Library
+
+    ffi_lib File.expand_path("./libglide_ffi.so", __dir__)
+
+    class ClientType < FFI::Struct
+      layout(
+        :tag, :uint # 0 = AsyncClient, 1 = SyncClient
+      )
+    end
+
+    class ConnectionResponse < FFI::Struct
+      layout(
+        :conn_ptr, :pointer, # *const c_void
+        :connection_error_message, :string # *const c_char (null-terminated C string)
+      )
+    end
+
+    class CommandError < FFI::Struct
+      layout(
+        :command_error_message, :string,
+        :command_error_type, :int # Assuming RequestErrorType is repr(C) enum
+      )
+    end
+
+    class CommandResponse < FFI::Struct
+      layout(
+        :response_type, :int,         # Assuming ResponseType is repr(C) enum
+        :int_value, :int64,
+        :float_value, :double,
+        :bool_value, :bool,
+        :string_value, :pointer,      # points to C string
+        :string_value_len, :long,
+        :array_value, :pointer,       # points to CommandResponse array
+        :array_value_len, :long,
+        :map_key, :pointer,           # CommandResponse*
+        :map_value, :pointer,         # CommandResponse*
+        :sets_value, :pointer,        # CommandResponse*
+        :sets_value_len, :long
+      )
+    end
+
+    callback :success_callback, %i[ulong pointer], :void
+    callback :failure_callback, %i[ulong string int], :void
+
+    class AsyncClientData < FFI::Struct
+      layout(
+        :success_callback, :success_callback,
+        :failure_callback, :failure_callback
+      )
+    end
+
+    class ClientData < FFI::Union
+      layout(
+        :async_client, AsyncClientData
+      )
+    end
+
+    class CommandResult < FFI::Struct
+      layout(
+        :response, CommandResponse.by_ref,
+        :command_error, CommandError.by_ref
+      )
+    end
+
+    callback :pubsub_callback, [
+      :ulong, # client_ptr
+      :int,             # kind (PushKind enum)
+      :pointer, :long,  # message + length
+      :pointer, :long,  # channel + length
+      :pointer, :long   # pattern + length
+    ], :void
+
+    attach_function :create_client, [
+      :pointer,        # *const u8 (connection_request_bytes)
+      :ulong,          # usize (connection_request_len)
+      ClientType.by_ref, # *const ClientType
+      :pubsub_callback # callback
+    ], :pointer        # *const ConnectionResponse
+
+    attach_function :command, [
+      :pointer,     # client_adapter_ptr
+      :ulong,       # channel
+      :int,         # command_type
+      :ulong,       # arg_count
+      :pointer,     # args (pointer to usize[])
+      :pointer,     # args_len (pointer to c_ulong[])
+      :pointer,     # route_bytes
+      :ulong        # route_bytes_len
+    ], :pointer     # returns *mut CommandResult
+  end
+end

data/lib/valkey/commands/connection.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+class Valkey
+  module Commands
+    # This module contains commands related to connection management.
+    module Connection
+      # Authenticate to the server.
+      #
+      # @param [Array<String>] args includes both username and password
+      #   or only password
+      # @return [String] `OK`
+      # @see https://redis.io/commands/auth AUTH command
+      def auth(*args)
+        # TODO:
+        # send_command([:auth, *args])
+      end
+
+      # Ping the server.
+      #
+      # @param [optional, String] message
+      # @return [String] `PONG`
+      def ping(message = nil)
+        # TODO:
+        # send_command([:ping, message].compact)
+      end
+
+      # Echo the given string.
+      #
+      # @param [String] value
+      # @return [String]
+      def echo(value)
+        # TODO:
+        # send_command([:echo, value])
+      end
+
+      # Change the selected database for the current connection.
+      #
+      # @param [Integer] db zero-based index of the DB to use (0 to 15)
+      # @return [String] `OK`
+      def select(db)
+        # TODO:
+        # send_command(RequestType::SELECT, [db.to_s])
+      end
+
+      # Close the connection.
+      #
+      # @return [String] `OK`
+      def quit
+        # TODO:
+        # synchronize do |client|
+        #   client.call_v([:quit])
+        # rescue ConnectionError
+        # ensure
+        #   client.close
+        # end
+      end
+    end
+  end
+end

data/lib/valkey/commands/server.rb

@@ -0,0 +1,193 @@
+# frozen_string_literal: true
+
+class Valkey
+  module Commands
+    # This module contains commands related to server config.
+    module Server
+      # Asynchronously rewrite the append-only file.
+      #
+      # @return [String] `OK`
+      def bgrewriteaof
+        # TODO:
+        # send_command([:bgrewriteaof])
+      end
+
+      # Asynchronously save the dataset to disk.
+      #
+      # @return [String] `OK`
+      def bgsave
+        # TODO:
+        # send_command([:bgsave])
+      end
+
+      # Get or set server configuration parameters.
+      #
+      # @param [Symbol] action e.g. `:get`, `:set`, `:resetstat`
+      # @return [String, Hash] string reply, or hash when retrieving more than one
+      #   property with `CONFIG GET`
+      def config(action, *args)
+        send_command([:config, action] + args) do |reply|
+          if reply.is_a?(Array) && action == :get
+            Hashify.call(reply)
+          else
+            reply
+          end
+        end
+      end
+
+      # Manage client connections.
+      #
+      # @param [String, Symbol] subcommand e.g. `kill`, `list`, `getname`, `setname`
+      # @return [String, Hash] depends on subcommand
+      def client(subcommand, *args)
+        send_command([:client, subcommand] + args) do |reply|
+          if subcommand.to_s == "list"
+            reply.lines.map do |line|
+              entries = line.chomp.split(/[ =]/)
+              Hash[entries.each_slice(2).to_a]
+            end
+          else
+            reply
+          end
+        end
+      end
+
+      # Return the number of keys in the selected database.
+      #
+      # @return [Integer]
+      def dbsize
+        send_command([:dbsize])
+      end
+
+      # Remove all keys from all databases.
+      #
+      # @param [Hash] options
+      #   - `:async => Boolean`: async flush (default: false)
+      # @return [String] `OK`
+      def flushall(options = nil)
+        # TODO:
+        # if options && options[:async]
+        #   send_command(%i[flushall async])
+        # else
+        #   send_command([:flushall])
+        # end
+      end
+
+      # Remove all keys from the current database.
+      #
+      # @param [Hash] options
+      #   - `:async => Boolean`: async flush (default: false)
+      # @return [String] `OK`
+      def flushdb(options = nil)
+        # TODO:
+        # if options && options[:async]
+        #   send_command(%i[flushdb async])
+        # else
+        #   send_command([:flushdb])
+        # end
+      end
+
+      # Get information and statistics about the server.
+      #
+      # @param [String, Symbol] cmd e.g. "commandstats"
+      # @return [Hash<String, String>]
+      def info(cmd = nil)
+        send_command([:info, cmd].compact) do |reply|
+          if reply.is_a?(String)
+            reply = HashifyInfo.call(reply)
+
+            if cmd && cmd.to_s == "commandstats"
+              # Extract nested hashes for INFO COMMANDSTATS
+              reply = Hash[reply.map do |k, v|
+                v = v.split(",").map { |e| e.split("=") }
+                [k[/^cmdstat_(.*)$/, 1], Hash[v]]
+              end]
+            end
+          end
+
+          reply
+        end
+      end
+
+      # Get the UNIX time stamp of the last successful save to disk.
+      #
+      # @return [Integer]
+      def lastsave
+        send_command([:lastsave])
+      end
+
+      # Listen for all requests received by the server in real time.
+      #
+      # There is no way to interrupt this command.
+      #
+      # @yield a block to be called for every line of output
+      # @yieldparam [String] line timestamp and command that was executed
+      def monitor
+        synchronize do |client|
+          client = client.pubsub
+          client.call_v([:monitor])
+          loop do
+            yield client.next_event
+          end
+        end
+      end
+
+      # Synchronously save the dataset to disk.
+      #
+      # @return [String]
+      def save
+        send_command([:save])
+      end
+
+      # Synchronously save the dataset to disk and then shut down the server.
+      def shutdown
+        synchronize do |client|
+          client.disable_reconnection do
+            client.call_v([:shutdown])
+          rescue ConnectionError
+            # This means Redis has probably exited.
+            nil
+          end
+        end
+      end
+
+      # Make the server a slave of another instance, or promote it as master.
+      def slaveof(host, port)
+        send_command([:slaveof, host, port])
+      end
+
+      # Interact with the slowlog (get, len, reset)
+      #
+      # @param [String] subcommand e.g. `get`, `len`, `reset`
+      # @param [Integer] length maximum number of entries to return
+      # @return [Array<String>, Integer, String] depends on subcommand
+      def slowlog(subcommand, length = nil)
+        args = [:slowlog, subcommand]
+        args << Integer(length) if length
+        send_command(args)
+      end
+
+      # Internal command used for replication.
+      def sync
+        send_command([:sync])
+      end
+
+      # Return the server time.
+      #
+      # @example
+      #   r.time # => [ 1333093196, 606806 ]
+      #
+      # @return [Array<Integer>] tuple of seconds since UNIX epoch and
+      #   microseconds in the current second
+      def time
+        send_command([:time]) do |reply|
+          reply&.map(&:to_i)
+        end
+      end
+
+      def debug(*args)
+        send_command([:debug] + args)
+      end
+    end
+  end
+end

data/lib/valkey/commands/strings.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+class Valkey
+  module Commands
+    # This module contains commands related to strings.
+    module Strings
+      # Set the string value of a key.
+      #
+      # @param [String] key
+      # @param [String] value
+      # @param [Hash] options
+      #   - `:ex => Integer`: Set the specified expire time, in seconds.
+      #   - `:px => Integer`: Set the specified expire time, in milliseconds.
+      #   - `:exat => Integer` : Set the specified Unix time at which the key will expire, in seconds.
+      #   - `:pxat => Integer` : Set the specified Unix time at which the key will expire, in milliseconds.
+      #   - `:nx => true`: Only set the key if it does not already exist.
+      #   - `:xx => true`: Only set the key if it already exist.
+      #   - `:keepttl => true`: Retain the time to live associated with the key.
+      #   - `:get => true`: Return the old string stored at key, or nil if key did not exist.
+      # @return [String, Boolean] `"OK"` or true, false if `:nx => true` or `:xx => true`
+      def set(key, value, ex: nil, px: nil, exat: nil, pxat: nil, nx: nil, xx: nil, keepttl: nil, get: nil)
+        args = [key, value.to_s]
+        args << "EX" << Integer(ex) if ex
+        args << "PX" << Integer(px) if px
+        args << "EXAT" << Integer(exat) if exat
+        args << "PXAT" << Integer(pxat) if pxat
+        args << "NX" if nx
+        args << "XX" if xx
+        args << "KEEPTTL" if keepttl
+        args << "GET" if get
+
+        if nx || xx
+          send_command(RequestType::SET(args, &BoolifySet))
+        else
+          send_command(RequestType::SET, args)
+        end
+      end
+
+      # Get the value of a key.
+      #
+      # @param [String] key
+      # @return [String]
+      def get(key)
+        send_command(RequestType::GET, [key])
+      end
+    end
+  end
+end

data/lib/valkey/commands.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "valkey/commands/strings"
+require "valkey/commands/connection"
+require "valkey/commands/server"
+
+class Valkey
+  module Commands
+    include Strings
+    include Connection
+    include Server
+  end
+end

data/lib/valkey/errors.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+class Valkey
+  class BaseError < StandardError; end
+
+  class ProtocolError < BaseError
+    def initialize(reply_type)
+      super(<<-EOS.gsub(/(?:^|\n)\s*/, " "))
+        Got '#{reply_type}' as initial reply byte.
+        If you're in a forking environment, such as Unicorn, you need to
+        connect to Valkey after forking.
+      EOS
+    end
+  end
+
+  class CommandError < BaseError; end
+
+  class PermissionError < CommandError; end
+
+  class WrongTypeError < CommandError; end
+
+  class OutOfMemoryError < CommandError; end
+
+  class NoScriptError < CommandError; end
+
+  class BaseConnectionError < BaseError; end
+
+  class CannotConnectError < BaseConnectionError; end
+
+  class ConnectionError < BaseConnectionError; end
+
+  class TimeoutError < BaseConnectionError; end
+
+  class InheritedError < BaseConnectionError; end
+
+  class ReadOnlyError < BaseConnectionError; end
+
+  class InvalidClientOptionError < BaseError; end
+
+  class SubscriptionError < BaseError; end
+end

data/lib/valkey/protobuf/command_request_pb.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: command_request.proto
+
+descriptor_data = "\n\x15\x63ommand_request.proto\x12\x0f\x63ommand_request\"M\n\x0bSlotIdRoute\x12-\n\tslot_type\x18\x01 \x01(\x0e\x32\x1a.command_request.SlotTypes\x12\x0f\n\x07slot_id\x18\x02 \x01(\x05\"O\n\x0cSlotKeyRoute\x12-\n\tslot_type\x18\x01 \x01(\x0e\x32\x1a.command_request.SlotTypes\x12\x10\n\x08slot_key\x18\x02 \x01(\t\",\n\x0e\x42yAddressRoute\x12\x0c\n\x04host\x18\x01 \x01(\t\x12\x0c\n\x04port\x18\x02 \x01(\x05\"\xf6\x01\n\x06Routes\x12\x36\n\rsimple_routes\x18\x01 \x01(\x0e\x32\x1d.command_request.SimpleRoutesH\x00\x12\x37\n\x0eslot_key_route\x18\x02 \x01(\x0b\x32\x1d.command_request.SlotKeyRouteH\x00\x12\x35\n\rslot_id_route\x18\x03 \x01(\x0b\x32\x1c.command_request.SlotIdRouteH\x00\x12;\n\x10\x62y_address_route\x18\x04 \x01(\x0b\x32\x1f.command_request.ByAddressRouteH\x00\x42\x07\n\x05value\"\xb6\x01\n\x07\x43ommand\x12\x32\n\x0crequest_type\x18\x01 \x01(\x0e\x32\x1c.command_request.RequestType\x12\x38\n\nargs_array\x18\x02 \x01(\x0b\x32\".command_request.Command.ArgsArrayH\x00\x12\x1a\n\x10\x61rgs_vec_pointer\x18\x03 \x01(\x04H\x00\x1a\x19\n\tArgsArray\x12\x0c\n\x04\x61rgs\x18\x01 \x03(\x0c\x42\x06\n\x04\x61rgs\"\x80\x01\n\x18ScriptInvocationPointers\x12\x0c\n\x04hash\x18\x01 \x01(\t\x12\x19\n\x0ckeys_pointer\x18\x02 \x01(\x04H\x00\x88\x01\x01\x12\x19\n\x0c\x61rgs_pointer\x18\x03 \x01(\x04H\x01\x88\x01\x01\x42\x0f\n\r_keys_pointerB\x0f\n\r_args_pointer\"<\n\x10ScriptInvocation\x12\x0c\n\x04hash\x18\x01 \x01(\t\x12\x0c\n\x04keys\x18\x02 \x03(\x0c\x12\x0c\n\x04\x61rgs\x18\x03 \x03(\x0c\"9\n\x0bTransaction\x12*\n\x08\x63ommands\x18\x01 \x03(\x0b\x32\x18.command_request.Command\"\xb4\x01\n\x0b\x43lusterScan\x12\x0e\n\x06\x63ursor\x18\x01 \x01(\t\x12\x1a\n\rmatch_pattern\x18\x02 \x01(\x0cH\x00\x88\x01\x01\x12\x12\n\x05\x63ount\x18\x03 \x01(\x03H\x01\x88\x01\x01\x12\x18\n\x0bobject_type\x18\x04 \x01(\tH\x02\x88\x01\x01\x12\x1f\n\x17\x61llow_non_covered_slots\x18\x05 \x01(\x08\x42\x10\n\x0e_match_patternB\x08\n\x06_countB\x0e\n\x0c_object_type\"V\n\x18UpdateConnectionPassword\x12\x15\n\x08password\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x16\n\x0eimmediate_auth\x18\x02 \x01(\x08\x42\x0b\n\t_password\"\xda\x03\n\x0e\x43ommandRequest\x12\x14\n\x0c\x63\x61llback_idx\x18\x01 \x01(\r\x12\x32\n\x0esingle_command\x18\x02 \x01(\x0b\x32\x18.command_request.CommandH\x00\x12\x33\n\x0btransaction\x18\x03 \x01(\x0b\x32\x1c.command_request.TransactionH\x00\x12>\n\x11script_invocation\x18\x04 \x01(\x0b\x32!.command_request.ScriptInvocationH\x00\x12O\n\x1ascript_invocation_pointers\x18\x05 \x01(\x0b\x32).command_request.ScriptInvocationPointersH\x00\x12\x34\n\x0c\x63luster_scan\x18\x06 \x01(\x0b\x32\x1c.command_request.ClusterScanH\x00\x12O\n\x1aupdate_connection_password\x18\x07 \x01(\x0b\x32).command_request.UpdateConnectionPasswordH\x00\x12&\n\x05route\x18\x08 \x01(\x0b\x32\x17.command_request.RoutesB\t\n\x07\x63ommand*:\n\x0cSimpleRoutes\x12\x0c\n\x08\x41llNodes\x10\x00\x12\x10\n\x0c\x41llPrimaries\x10\x01\x12\n\n\x06Random\x10\x02*%\n\tSlotTypes\x12\x0b\n\x07Primary\x10\x00\x12\x0b\n\x07Replica\x10\x01*\xc7/\n\x0bRequestType\x12\x12\n\x0eInvalidRequest\x10\x00\x12\x11\n\rCustomCommand\x10\x01\x12\x0c\n\x08\x42itCount\x10\x65\x12\x0c\n\x08\x42itField\x10\x66\x12\x14\n\x10\x42itFieldReadOnly\x10g\x12\t\n\x05\x42itOp\x10h\x12\n\n\x06\x42itPos\x10i\x12\n\n\x06GetBit\x10j\x12\n\n\x06SetBit\x10k\x12\x0b\n\x06\x41sking\x10\xc9\x01\x12\x14\n\x0f\x43lusterAddSlots\x10\xca\x01\x12\x19\n\x14\x43lusterAddSlotsRange\x10\xcb\x01\x12\x15\n\x10\x43lusterBumpEpoch\x10\xcc\x01\x12\x1f\n\x1a\x43lusterCountFailureReports\x10\xcd\x01\x12\x1b\n\x16\x43lusterCountKeysInSlot\x10\xce\x01\x12\x14\n\x0f\x43lusterDelSlots\x10\xcf\x01\x12\x19\n\x14\x43lusterDelSlotsRange\x10\xd0\x01\x12\x14\n\x0f\x43lusterFailover\x10\xd1\x01\x12\x16\n\x11\x43lusterFlushSlots\x10\xd2\x01\x12\x12\n\rClusterForget\x10\xd3\x01\x12\x19\n\x14\x43lusterGetKeysInSlot\x10\xd4\x01\x12\x10\n\x0b\x43lusterInfo\x10\xd5\x01\x12\x13\n\x0e\x43lusterKeySlot\x10\xd6\x01\x12\x11\n\x0c\x43lusterLinks\x10\xd7\x01\x12\x10\n\x0b\x43lusterMeet\x10\xd8\x01\x12\x10\n\x0b\x43lusterMyId\x10\xd9\x01\x12\x15\n\x10\x43lusterMyShardId\x10\xda\x01\x12\x11\n\x0c\x43lusterNodes\x10\xdb\x01\x12\x14\n\x0f\x43lusterReplicas\x10\xdc\x01\x12\x15\n\x10\x43lusterReplicate\x10\xdd\x01\x12\x11\n\x0c\x43lusterReset\x10\xde\x01\x12\x16\n\x11\x43lusterSaveConfig\x10\xdf\x01\x12\x1a\n\x15\x43lusterSetConfigEpoch\x10\xe0\x01\x12\x13\n\x0e\x43lusterSetslot\x10\xe1\x01\x12\x12\n\rClusterShards\x10\xe2\x01\x12\x12\n\rClusterSlaves\x10\xe3\x01\x12\x11\n\x0c\x43lusterSlots\x10\xe4\x01\x12\r\n\x08ReadOnly\x10\xe5\x01\x12\x0e\n\tReadWrite\x10\xe6\x01\x12\t\n\x04\x41uth\x10\xad\x02\x12\x12\n\rClientCaching\x10\xae\x02\x12\x12\n\rClientGetName\x10\xaf\x02\x12\x13\n\x0e\x43lientGetRedir\x10\xb0\x02\x12\r\n\x08\x43lientId\x10\xb1\x02\x12\x0f\n\nClientInfo\x10\xb2\x02\x12\x15\n\x10\x43lientKillSimple\x10\xb3\x02\x12\x0f\n\nClientKill\x10\xb4\x02\x12\x0f\n\nClientList\x10\xb5\x02\x12\x12\n\rClientNoEvict\x10\xb6\x02\x12\x12\n\rClientNoTouch\x10\xb7\x02\x12\x10\n\x0b\x43lientPause\x10\xb8\x02\x12\x10\n\x0b\x43lientReply\x10\xb9\x02\x12\x12\n\rClientSetInfo\x10\xba\x02\x12\x12\n\rClientSetName\x10\xbb\x02\x12\x13\n\x0e\x43lientTracking\x10\xbc\x02\x12\x17\n\x12\x43lientTrackingInfo\x10\xbd\x02\x12\x12\n\rClientUnblock\x10\xbe\x02\x12\x12\n\rClientUnpause\x10\xbf\x02\x12\t\n\x04\x45\x63ho\x10\xc0\x02\x12\n\n\x05Hello\x10\xc1\x02\x12\t\n\x04Ping\x10\xc2\x02\x12\t\n\x04Quit\x10\xc3\x02\x12\n\n\x05Reset\x10\xc4\x02\x12\x0b\n\x06Select\x10\xc5\x02\x12\t\n\x04\x43opy\x10\x91\x03\x12\x08\n\x03\x44\x65l\x10\x92\x03\x12\t\n\x04\x44ump\x10\x93\x03\x12\x0b\n\x06\x45xists\x10\x94\x03\x12\x0b\n\x06\x45xpire\x10\x95\x03\x12\r\n\x08\x45xpireAt\x10\x96\x03\x12\x0f\n\nExpireTime\x10\x97\x03\x12\t\n\x04Keys\x10\x98\x03\x12\x0c\n\x07Migrate\x10\x99\x03\x12\t\n\x04Move\x10\x9a\x03\x12\x13\n\x0eObjectEncoding\x10\x9b\x03\x12\x0f\n\nObjectFreq\x10\x9c\x03\x12\x13\n\x0eObjectIdleTime\x10\x9d\x03\x12\x13\n\x0eObjectRefCount\x10\x9e\x03\x12\x0c\n\x07Persist\x10\x9f\x03\x12\x0c\n\x07PExpire\x10\xa0\x03\x12\x0e\n\tPExpireAt\x10\xa1\x03\x12\x10\n\x0bPExpireTime\x10\xa2\x03\x12\t\n\x04PTTL\x10\xa3\x03\x12\x0e\n\tRandomKey\x10\xa4\x03\x12\x0b\n\x06Rename\x10\xa5\x03\x12\r\n\x08RenameNX\x10\xa6\x03\x12\x0c\n\x07Restore\x10\xa7\x03\x12\t\n\x04Scan\x10\xa8\x03\x12\t\n\x04Sort\x10\xa9\x03\x12\x11\n\x0cSortReadOnly\x10\xaa\x03\x12\n\n\x05Touch\x10\xab\x03\x12\x08\n\x03TTL\x10\xac\x03\x12\t\n\x04Type\x10\xad\x03\x12\x0b\n\x06Unlink\x10\xae\x03\x12\t\n\x04Wait\x10\xaf\x03\x12\x0c\n\x07WaitAof\x10\xb0\x03\x12\x0b\n\x06GeoAdd\x10\xf5\x03\x12\x0c\n\x07GeoDist\x10\xf6\x03\x12\x0c\n\x07GeoHash\x10\xf7\x03\x12\x0b\n\x06GeoPos\x10\xf8\x03\x12\x0e\n\tGeoRadius\x10\xf9\x03\x12\x16\n\x11GeoRadiusReadOnly\x10\xfa\x03\x12\x16\n\x11GeoRadiusByMember\x10\xfb\x03\x12\x1e\n\x19GeoRadiusByMemberReadOnly\x10\xfc\x03\x12\x0e\n\tGeoSearch\x10\xfd\x03\x12\x13\n\x0eGeoSearchStore\x10\xfe\x03\x12\t\n\x04HDel\x10\xd9\x04\x12\x0c\n\x07HExists\x10\xda\x04\x12\t\n\x04HGet\x10\xdb\x04\x12\x0c\n\x07HGetAll\x10\xdc\x04\x12\x0c\n\x07HIncrBy\x10\xdd\x04\x12\x11\n\x0cHIncrByFloat\x10\xde\x04\x12\n\n\x05HKeys\x10\xdf\x04\x12\t\n\x04HLen\x10\xe0\x04\x12\n\n\x05HMGet\x10\xe1\x04\x12\n\n\x05HMSet\x10\xe2\x04\x12\x0f\n\nHRandField\x10\xe3\x04\x12\n\n\x05HScan\x10\xe4\x04\x12\t\n\x04HSet\x10\xe5\x04\x12\x0b\n\x06HSetNX\x10\xe6\x04\x12\x0c\n\x07HStrlen\x10\xe7\x04\x12\n\n\x05HVals\x10\xe8\x04\x12\n\n\x05PfAdd\x10\xbd\x05\x12\x0c\n\x07PfCount\x10\xbe\x05\x12\x0c\n\x07PfMerge\x10\xbf\x05\x12\x0b\n\x06\x42LMove\x10\xa1\x06\x12\x0b\n\x06\x42LMPop\x10\xa2\x06\x12\n\n\x05\x42LPop\x10\xa3\x06\x12\n\n\x05\x42RPop\x10\xa4\x06\x12\x0f\n\nBRPopLPush\x10\xa5\x06\x12\x0b\n\x06LIndex\x10\xa6\x06\x12\x0c\n\x07LInsert\x10\xa7\x06\x12\t\n\x04LLen\x10\xa8\x06\x12\n\n\x05LMove\x10\xa9\x06\x12\n\n\x05LMPop\x10\xaa\x06\x12\t\n\x04LPop\x10\xab\x06\x12\t\n\x04LPos\x10\xac\x06\x12\n\n\x05LPush\x10\xad\x06\x12\x0b\n\x06LPushX\x10\xae\x06\x12\x0b\n\x06LRange\x10\xaf\x06\x12\t\n\x04LRem\x10\xb0\x06\x12\t\n\x04LSet\x10\xb1\x06\x12\n\n\x05LTrim\x10\xb2\x06\x12\t\n\x04RPop\x10\xb3\x06\x12\x0e\n\tRPopLPush\x10\xb4\x06\x12\n\n\x05RPush\x10\xb5\x06\x12\x0b\n\x06RPushX\x10\xb6\x06\x12\x0f\n\nPSubscribe\x10\x85\x07\x12\x0c\n\x07Publish\x10\x86\x07\x12\x13\n\x0ePubSubChannels\x10\x87\x07\x12\x11\n\x0cPubSubNumPat\x10\x88\x07\x12\x11\n\x0cPubSubNumSub\x10\x89\x07\x12\x18\n\x13PubSubShardChannels\x10\x8a\x07\x12\x16\n\x11PubSubShardNumSub\x10\x8b\x07\x12\x11\n\x0cPUnsubscribe\x10\x8c\x07\x12\r\n\x08SPublish\x10\x8d\x07\x12\x0f\n\nSSubscribe\x10\x8e\x07\x12\x0e\n\tSubscribe\x10\x8f\x07\x12\x11\n\x0cSUnsubscribe\x10\x90\x07\x12\x10\n\x0bUnsubscribe\x10\x91\x07\x12\t\n\x04\x45val\x10\xe9\x07\x12\x11\n\x0c\x45valReadOnly\x10\xea\x07\x12\x0c\n\x07\x45valSha\x10\xeb\x07\x12\x14\n\x0f\x45valShaReadOnly\x10\xec\x07\x12\n\n\x05\x46\x43\x61ll\x10\xed\x07\x12\x12\n\rFCallReadOnly\x10\xee\x07\x12\x13\n\x0e\x46unctionDelete\x10\xef\x07\x12\x11\n\x0c\x46unctionDump\x10\xf0\x07\x12\x12\n\rFunctionFlush\x10\xf1\x07\x12\x11\n\x0c\x46unctionKill\x10\xf2\x07\x12\x11\n\x0c\x46unctionList\x10\xf3\x07\x12\x11\n\x0c\x46unctionLoad\x10\xf4\x07\x12\x14\n\x0f\x46unctionRestore\x10\xf5\x07\x12\x12\n\rFunctionStats\x10\xf6\x07\x12\x10\n\x0bScriptDebug\x10\xf7\x07\x12\x11\n\x0cScriptExists\x10\xf8\x07\x12\x10\n\x0bScriptFlush\x10\xf9\x07\x12\x0f\n\nScriptKill\x10\xfa\x07\x12\x0f\n\nScriptLoad\x10\xfb\x07\x12\x0f\n\nScriptShow\x10\xfc\x07\x12\x0b\n\x06\x41\x63lCat\x10\xcd\x08\x12\x0f\n\nAclDelUser\x10\xce\x08\x12\x0e\n\tAclDryRun\x10\xcf\x08\x12\x0f\n\nAclGenPass\x10\xd0\x08\x12\x0f\n\nAclGetUser\x10\xd1\x08\x12\x0c\n\x07\x41\x63lList\x10\xd2\x08\x12\x0c\n\x07\x41\x63lLoad\x10\xd3\x08\x12\x0b\n\x06\x41\x63lLog\x10\xd4\x08\x12\x0c\n\x07\x41\x63lSave\x10\xd5\x08\x12\x0f\n\nAclSetSser\x10\xd6\x08\x12\r\n\x08\x41\x63lUsers\x10\xd7\x08\x12\x0e\n\tAclWhoami\x10\xd8\x08\x12\x11\n\x0c\x42gRewriteAof\x10\xd9\x08\x12\x0b\n\x06\x42gSave\x10\xda\x08\x12\r\n\x08\x43ommand_\x10\xdb\x08\x12\x11\n\x0c\x43ommandCount\x10\xdc\x08\x12\x10\n\x0b\x43ommandDocs\x10\xdd\x08\x12\x13\n\x0e\x43ommandGetKeys\x10\xde\x08\x12\x1b\n\x16\x43ommandGetKeysAndFlags\x10\xdf\x08\x12\x10\n\x0b\x43ommandInfo\x10\xe0\x08\x12\x10\n\x0b\x43ommandList\x10\xe1\x08\x12\x0e\n\tConfigGet\x10\xe2\x08\x12\x14\n\x0f\x43onfigResetStat\x10\xe3\x08\x12\x12\n\rConfigRewrite\x10\xe4\x08\x12\x0e\n\tConfigSet\x10\xe5\x08\x12\x0b\n\x06\x44\x42Size\x10\xe6\x08\x12\r\n\x08\x46\x61ilOver\x10\xe7\x08\x12\r\n\x08\x46lushAll\x10\xe8\x08\x12\x0c\n\x07\x46lushDB\x10\xe9\x08\x12\t\n\x04Info\x10\xea\x08\x12\r\n\x08LastSave\x10\xeb\x08\x12\x12\n\rLatencyDoctor\x10\xec\x08\x12\x11\n\x0cLatencyGraph\x10\xed\x08\x12\x15\n\x10LatencyHistogram\x10\xee\x08\x12\x13\n\x0eLatencyHistory\x10\xef\x08\x12\x12\n\rLatencyLatest\x10\xf0\x08\x12\x11\n\x0cLatencyReset\x10\xf1\x08\x12\x0b\n\x06Lolwut\x10\xf2\x08\x12\x11\n\x0cMemoryDoctor\x10\xf3\x08\x12\x16\n\x11MemoryMallocStats\x10\xf4\x08\x12\x10\n\x0bMemoryPurge\x10\xf5\x08\x12\x10\n\x0bMemoryStats\x10\xf6\x08\x12\x10\n\x0bMemoryUsage\x10\xf7\x08\x12\x0f\n\nModuleList\x10\xf8\x08\x12\x0f\n\nModuleLoad\x10\xf9\x08\x12\x11\n\x0cModuleLoadEx\x10\xfa\x08\x12\x11\n\x0cModuleUnload\x10\xfb\x08\x12\x0c\n\x07Monitor\x10\xfc\x08\x12\n\n\x05PSync\x10\xfd\x08\x12\r\n\x08ReplConf\x10\xfe\x08\x12\x0e\n\tReplicaOf\x10\xff\x08\x12\x12\n\rRestoreAsking\x10\x80\t\x12\t\n\x04Role\x10\x81\t\x12\t\n\x04Save\x10\x82\t\x12\r\n\x08ShutDown\x10\x83\t\x12\x0c\n\x07SlaveOf\x10\x84\t\x12\x0f\n\nSlowLogGet\x10\x85\t\x12\x0f\n\nSlowLogLen\x10\x86\t\x12\x11\n\x0cSlowLogReset\x10\x87\t\x12\x0b\n\x06SwapDb\x10\x88\t\x12\t\n\x04Sync\x10\x89\t\x12\t\n\x04Time\x10\x8a\t\x12\t\n\x04SAdd\x10\xb1\t\x12\n\n\x05SCard\x10\xb2\t\x12\n\n\x05SDiff\x10\xb3\t\x12\x0f\n\nSDiffStore\x10\xb4\t\x12\x0b\n\x06SInter\x10\xb5\t\x12\x0f\n\nSInterCard\x10\xb6\t\x12\x10\n\x0bSInterStore\x10\xb7\t\x12\x0e\n\tSIsMember\x10\xb8\t\x12\r\n\x08SMembers\x10\xb9\t\x12\x0f\n\nSMIsMember\x10\xba\t\x12\n\n\x05SMove\x10\xbb\t\x12\t\n\x04SPop\x10\xbc\t\x12\x10\n\x0bSRandMember\x10\xbd\t\x12\t\n\x04SRem\x10\xbe\t\x12\n\n\x05SScan\x10\xbf\t\x12\x0b\n\x06SUnion\x10\xc0\t\x12\x10\n\x0bSUnionStore\x10\xc1\t\x12\x0b\n\x06\x42ZMPop\x10\x95\n\x12\r\n\x08\x42ZPopMax\x10\x96\n\x12\r\n\x08\x42ZPopMin\x10\x97\n\x12\t\n\x04ZAdd\x10\x98\n\x12\n\n\x05ZCard\x10\x99\n\x12\x0b\n\x06ZCount\x10\x9a\n\x12\n\n\x05ZDiff\x10\x9b\n\x12\x0f\n\nZDiffStore\x10\x9c\n\x12\x0c\n\x07ZIncrBy\x10\x9d\n\x12\x0b\n\x06ZInter\x10\x9e\n\x12\x0f\n\nZInterCard\x10\x9f\n\x12\x10\n\x0bZInterStore\x10\xa0\n\x12\x0e\n\tZLexCount\x10\xa1\n\x12\n\n\x05ZMPop\x10\xa2\n\x12\x0c\n\x07ZMScore\x10\xa3\n\x12\x0c\n\x07ZPopMax\x10\xa4\n\x12\x0c\n\x07ZPopMin\x10\xa5\n\x12\x10\n\x0bZRandMember\x10\xa6\n\x12\x0b\n\x06ZRange\x10\xa7\n\x12\x10\n\x0bZRangeByLex\x10\xa8\n\x12\x12\n\rZRangeByScore\x10\xa9\n\x12\x10\n\x0bZRangeStore\x10\xaa\n\x12\n\n\x05ZRank\x10\xab\n\x12\t\n\x04ZRem\x10\xac\n\x12\x13\n\x0eZRemRangeByLex\x10\xad\n\x12\x14\n\x0fZRemRangeByRank\x10\xae\n\x12\x15\n\x10ZRemRangeByScore\x10\xaf\n\x12\x0e\n\tZRevRange\x10\xb0\n\x12\x13\n\x0eZRevRangeByLex\x10\xb1\n\x12\x15\n\x10ZRevRangeByScore\x10\xb2\n\x12\r\n\x08ZRevRank\x10\xb3\n\x12\n\n\x05ZScan\x10\xb4\n\x12\x0b\n\x06ZScore\x10\xb5\n\x12\x0b\n\x06ZUnion\x10\xb6\n\x12\x10\n\x0bZUnionStore\x10\xb7\n\x12\t\n\x04XAck\x10\xf9\n\x12\t\n\x04XAdd\x10\xfa\n\x12\x0f\n\nXAutoClaim\x10\xfb\n\x12\x0b\n\x06XClaim\x10\xfc\n\x12\t\n\x04XDel\x10\xfd\n\x12\x11\n\x0cXGroupCreate\x10\xfe\n\x12\x19\n\x14XGroupCreateConsumer\x10\xff\n\x12\x16\n\x11XGroupDelConsumer\x10\x80\x0b\x12\x12\n\rXGroupDestroy\x10\x81\x0b\x12\x10\n\x0bXGroupSetId\x10\x82\x0b\x12\x13\n\x0eXInfoConsumers\x10\x83\x0b\x12\x10\n\x0bXInfoGroups\x10\x84\x0b\x12\x10\n\x0bXInfoStream\x10\x85\x0b\x12\t\n\x04XLen\x10\x86\x0b\x12\r\n\x08XPending\x10\x87\x0b\x12\x0b\n\x06XRange\x10\x88\x0b\x12\n\n\x05XRead\x10\x89\x0b\x12\x0f\n\nXReadGroup\x10\x8a\x0b\x12\x0e\n\tXRevRange\x10\x8b\x0b\x12\x0b\n\x06XSetId\x10\x8c\x0b\x12\n\n\x05XTrim\x10\x8d\x0b\x12\x0b\n\x06\x41ppend\x10\xdd\x0b\x12\t\n\x04\x44\x65\x63r\x10\xde\x0b\x12\x0b\n\x06\x44\x65\x63rBy\x10\xdf\x0b\x12\x08\n\x03Get\x10\xe0\x0b\x12\x0b\n\x06GetDel\x10\xe1\x0b\x12\n\n\x05GetEx\x10\xe2\x0b\x12\r\n\x08GetRange\x10\xe3\x0b\x12\x0b\n\x06GetSet\x10\xe4\x0b\x12\t\n\x04Incr\x10\xe5\x0b\x12\x0b\n\x06IncrBy\x10\xe6\x0b\x12\x10\n\x0bIncrByFloat\x10\xe7\x0b\x12\x08\n\x03LCS\x10\xe8\x0b\x12\t\n\x04MGet\x10\xe9\x0b\x12\t\n\x04MSet\x10\xea\x0b\x12\x0b\n\x06MSetNX\x10\xeb\x0b\x12\x0b\n\x06PSetEx\x10\xec\x0b\x12\x08\n\x03Set\x10\xed\x0b\x12\n\n\x05SetEx\x10\xee\x0b\x12\n\n\x05SetNX\x10\xef\x0b\x12\r\n\x08SetRange\x10\xf0\x0b\x12\x0b\n\x06Strlen\x10\xf1\x0b\x12\x0b\n\x06Substr\x10\xf2\x0b\x12\x0c\n\x07\x44iscard\x10\xc1\x0c\x12\t\n\x04\x45xec\x10\xc2\x0c\x12\n\n\x05Multi\x10\xc3\x0c\x12\x0c\n\x07UnWatch\x10\xc4\x0c\x12\n\n\x05Watch\x10\xc5\x0c\x12\x12\n\rJsonArrAppend\x10\xd1\x0f\x12\x11\n\x0cJsonArrIndex\x10\xd2\x0f\x12\x12\n\rJsonArrInsert\x10\xd3\x0f\x12\x0f\n\nJsonArrLen\x10\xd4\x0f\x12\x0f\n\nJsonArrPop\x10\xd5\x0f\x12\x10\n\x0bJsonArrTrim\x10\xd6\x0f\x12\x0e\n\tJsonClear\x10\xd7\x0f\x12\x0e\n\tJsonDebug\x10\xd8\x0f\x12\x0c\n\x07JsonDel\x10\xd9\x0f\x12\x0f\n\nJsonForget\x10\xda\x0f\x12\x0c\n\x07JsonGet\x10\xdb\x0f\x12\r\n\x08JsonMGet\x10\xdc\x0f\x12\x12\n\rJsonNumIncrBy\x10\xdd\x0f\x12\x12\n\rJsonNumMultBy\x10\xde\x0f\x12\x10\n\x0bJsonObjKeys\x10\xdf\x0f\x12\x0f\n\nJsonObjLen\x10\xe0\x0f\x12\r\n\x08JsonResp\x10\xe1\x0f\x12\x0c\n\x07JsonSet\x10\xe2\x0f\x12\x12\n\rJsonStrAppend\x10\xe3\x0f\x12\x0f\n\nJsonStrLen\x10\xe4\x0f\x12\x0f\n\nJsonToggle\x10\xe5\x0f\x12\r\n\x08JsonType\x10\xe6\x0f\x12\x0b\n\x06\x46tList\x10\xb5\x10\x12\x10\n\x0b\x46tAggregate\x10\xb6\x10\x12\x0f\n\nFtAliasAdd\x10\xb7\x10\x12\x0f\n\nFtAliasDel\x10\xb8\x10\x12\x10\n\x0b\x46tAliasList\x10\xb9\x10\x12\x12\n\rFtAliasUpdate\x10\xba\x10\x12\r\n\x08\x46tCreate\x10\xbb\x10\x12\x10\n\x0b\x46tDropIndex\x10\xbc\x10\x12\x0e\n\tFtExplain\x10\xbd\x10\x12\x11\n\x0c\x46tExplainCli\x10\xbe\x10\x12\x0b\n\x06\x46tInfo\x10\xbf\x10\x12\x0e\n\tFtProfile\x10\xc0\x10\x12\r\n\x08\x46tSearch\x10\xc1\x10\x62\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require "google/protobuf/descriptor_pb"
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = []
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module CommandRequest
+  SlotIdRoute = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("command_request.SlotIdRoute").msgclass
+  SlotKeyRoute = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("command_request.SlotKeyRoute").msgclass
+  ByAddressRoute = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("command_request.ByAddressRoute").msgclass
+  Routes = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("command_request.Routes").msgclass
+  Command = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("command_request.Command").msgclass
+  Command::ArgsArray = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("command_request.Command.ArgsArray").msgclass
+  ScriptInvocationPointers = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("command_request.ScriptInvocationPointers").msgclass
+  ScriptInvocation = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("command_request.ScriptInvocation").msgclass
+  Transaction = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("command_request.Transaction").msgclass
+  ClusterScan = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("command_request.ClusterScan").msgclass
+  UpdateConnectionPassword = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("command_request.UpdateConnectionPassword").msgclass
+  CommandRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("command_request.CommandRequest").msgclass
+  SimpleRoutes = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("command_request.SimpleRoutes").enummodule
+  SlotTypes = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("command_request.SlotTypes").enummodule
+  RequestType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("command_request.RequestType").enummodule
+end

data/lib/valkey/protobuf/connection_request_pb.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: connection_request.proto
+
+require "google/protobuf"
+
+descriptor_data = "\n\x18\x63onnection_request.proto\x12\x12\x63onnection_request\")\n\x0bNodeAddress\x12\x0c\n\x04host\x18\x01 \x01(\t\x12\x0c\n\x04port\x18\x02 \x01(\r\"8\n\x12\x41uthenticationInfo\x12\x10\n\x08password\x18\x01 \x01(\t\x12\x10\n\x08username\x18\x02 \x01(\t\"7\n\x1cPeriodicChecksManualInterval\x12\x17\n\x0f\x64uration_in_sec\x18\x01 \x01(\r\"\x18\n\x16PeriodicChecksDisabled\"8\n\x18PubSubChannelsOrPatterns\x12\x1c\n\x14\x63hannels_or_patterns\x18\x01 \x03(\x0c\"\xf1\x01\n\x13PubSubSubscriptions\x12k\n\x1c\x63hannels_or_patterns_by_type\x18\x01 \x03(\x0b\x32\x45.connection_request.PubSubSubscriptions.ChannelsOrPatternsByTypeEntry\x1am\n\x1d\x43hannelsOrPatternsByTypeEntry\x12\x0b\n\x03key\x18\x01 \x01(\r\x12;\n\x05value\x18\x02 \x01(\x0b\x32,.connection_request.PubSubChannelsOrPatterns:\x02\x38\x01\"\x8f\x06\n\x11\x43onnectionRequest\x12\x32\n\taddresses\x18\x01 \x03(\x0b\x32\x1f.connection_request.NodeAddress\x12-\n\x08tls_mode\x18\x02 \x01(\x0e\x32\x1b.connection_request.TlsMode\x12\x1c\n\x14\x63luster_mode_enabled\x18\x03 \x01(\x08\x12\x17\n\x0frequest_timeout\x18\x04 \x01(\r\x12/\n\tread_from\x18\x05 \x01(\x0e\x32\x1c.connection_request.ReadFrom\x12N\n\x19\x63onnection_retry_strategy\x18\x06 \x01(\x0b\x32+.connection_request.ConnectionRetryStrategy\x12\x43\n\x13\x61uthentication_info\x18\x07 \x01(\x0b\x32&.connection_request.AuthenticationInfo\x12\x13\n\x0b\x64\x61tabase_id\x18\x08 \x01(\r\x12\x35\n\x08protocol\x18\t \x01(\x0e\x32#.connection_request.ProtocolVersion\x12\x13\n\x0b\x63lient_name\x18\n \x01(\t\x12[\n\x1fperiodic_checks_manual_interval\x18\x0b \x01(\x0b\x32\x30.connection_request.PeriodicChecksManualIntervalH\x00\x12N\n\x18periodic_checks_disabled\x18\x0c \x01(\x0b\x32*.connection_request.PeriodicChecksDisabledH\x00\x12\x45\n\x14pubsub_subscriptions\x18\r \x01(\x0b\x32\'.connection_request.PubSubSubscriptions\x12\x1f\n\x17inflight_requests_limit\x18\x0e \x01(\r\x12\x11\n\tclient_az\x18\x0f \x01(\tB\x11\n\x0fperiodic_checks\"[\n\x17\x43onnectionRetryStrategy\x12\x19\n\x11number_of_retries\x18\x01 \x01(\r\x12\x0e\n\x06\x66\x61\x63tor\x18\x02 \x01(\r\x12\x15\n\rexponent_base\x18\x03 \x01(\r*M\n\x08ReadFrom\x12\x0b\n\x07Primary\x10\x00\x12\x11\n\rPreferReplica\x10\x01\x12\x11\n\rLowestLatency\x10\x02\x12\x0e\n\nAZAffinity\x10\x03*4\n\x07TlsMode\x12\t\n\x05NoTls\x10\x00\x12\r\n\tSecureTls\x10\x01\x12\x0f\n\x0bInsecureTls\x10\x02*\'\n\x0fProtocolVersion\x12\t\n\x05RESP3\x10\x00\x12\t\n\x05RESP2\x10\x01*8\n\x11PubSubChannelType\x12\t\n\x05\x45xact\x10\x00\x12\x0b\n\x07Pattern\x10\x01\x12\x0b\n\x07Sharded\x10\x02\x62\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require "google/protobuf/descriptor_pb"
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = []
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module ConnectionRequest
+  NodeAddress = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("connection_request.NodeAddress").msgclass
+  AuthenticationInfo = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("connection_request.AuthenticationInfo").msgclass
+  PeriodicChecksManualInterval = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("connection_request.PeriodicChecksManualInterval").msgclass
+  PeriodicChecksDisabled = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("connection_request.PeriodicChecksDisabled").msgclass
+  PubSubChannelsOrPatterns = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("connection_request.PubSubChannelsOrPatterns").msgclass
+  PubSubSubscriptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("connection_request.PubSubSubscriptions").msgclass
+  ConnectionRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("connection_request.ConnectionRequest").msgclass
+  ConnectionRetryStrategy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("connection_request.ConnectionRetryStrategy").msgclass
+  ReadFrom = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("connection_request.ReadFrom").enummodule
+  TlsMode = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("connection_request.TlsMode").enummodule
+  ProtocolVersion = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("connection_request.ProtocolVersion").enummodule
+  PubSubChannelType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("connection_request.PubSubChannelType").enummodule
+end

data/lib/valkey/protobuf/response_pb.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: response.proto
+
+require "google/protobuf"
+
+descriptor_data = "\n\x0eresponse.proto\x12\x08response\"I\n\x0cRequestError\x12(\n\x04type\x18\x01 \x01(\x0e\x32\x1a.response.RequestErrorType\x12\x0f\n\x07message\x18\x02 \x01(\t\"\xd5\x01\n\x08Response\x12\x14\n\x0c\x63\x61llback_idx\x18\x01 \x01(\r\x12\x16\n\x0cresp_pointer\x18\x02 \x01(\x04H\x00\x12\x37\n\x11\x63onstant_response\x18\x03 \x01(\x0e\x32\x1a.response.ConstantResponseH\x00\x12/\n\rrequest_error\x18\x04 \x01(\x0b\x32\x16.response.RequestErrorH\x00\x12\x17\n\rclosing_error\x18\x05 \x01(\tH\x00\x12\x0f\n\x07is_push\x18\x06 \x01(\x08\x42\x07\n\x05value*O\n\x10RequestErrorType\x12\x0f\n\x0bUnspecified\x10\x00\x12\r\n\tExecAbort\x10\x01\x12\x0b\n\x07Timeout\x10\x02\x12\x0e\n\nDisconnect\x10\x03*\x1a\n\x10\x43onstantResponse\x12\x06\n\x02OK\x10\x00\x62\x06proto3"
+
+pool = Google::Protobuf::DescriptorPool.generated_pool
+
+begin
+  pool.add_serialized_file(descriptor_data)
+rescue TypeError
+  # Compatibility code: will be removed in the next major version.
+  require "google/protobuf/descriptor_pb"
+  parsed = Google::Protobuf::FileDescriptorProto.decode(descriptor_data)
+  parsed.clear_dependency
+  serialized = parsed.class.encode(parsed)
+  file = pool.add_serialized_file(serialized)
+  warn "Warning: Protobuf detected an import path issue while loading generated file #{__FILE__}"
+  imports = []
+  imports.each do |type_name, expected_filename|
+    import_file = pool.lookup(type_name).file_descriptor
+    if import_file.name != expected_filename
+      warn "- #{file.name} imports #{expected_filename}, but that import was loaded as #{import_file.name}"
+    end
+  end
+  warn "Each proto file must use a consistent fully-qualified name."
+  warn "This will become an error in the next major version."
+end
+
+module Response
+  RequestError = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("response.RequestError").msgclass
+  Response = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("response.Response").msgclass
+  RequestErrorType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("response.RequestErrorType").enummodule
+  ConstantResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("response.ConstantResponse").enummodule
+end

data/lib/valkey/request_type.rb

@@ -0,0 +1,421 @@
+# frozen_string_literal: true
+
+class Valkey
+  module RequestType
+    INVALID_REQUEST = 0
+    CUSTOM_COMMAND = 1
+
+    # Bitmap commands
+    BIT_COUNT = 101
+    BIT_FIELD = 102
+    BIT_FIELD_READ_ONLY = 103
+    BIT_OP = 104
+    BIT_POS = 105
+    GET_BIT = 106
+    SET_BIT = 107
+
+    # Cluster commands
+    ASKING = 201
+    CLUSTER_ADD_SLOTS = 202
+    CLUSTER_ADD_SLOTS_RANGE = 203
+    CLUSTER_BUMP_EPOCH = 204
+    CLUSTER_COUNT_FAILURE_REPORTS = 205
+    CLUSTER_COUNT_KEYS_IN_SLOT = 206
+    CLUSTER_DEL_SLOTS = 207
+    CLUSTER_DEL_SLOTS_RANGE = 208
+    CLUSTER_FAILOVER = 209
+    CLUSTER_FLUSH_SLOTS = 210
+    CLUSTER_FORGET = 211
+    CLUSTER_GET_KEYS_IN_SLOT = 212
+    CLUSTER_INFO = 213
+    CLUSTER_KEY_SLOT = 214
+    CLUSTER_LINKS = 215
+    CLUSTER_MEET = 216
+    CLUSTER_MY_ID = 217
+    CLUSTER_MY_SHARD_ID = 218
+    CLUSTER_NODES = 219
+    CLUSTER_REPLICAS = 220
+    CLUSTER_REPLICATE = 221
+    CLUSTER_RESET = 222
+    CLUSTER_SAVE_CONFIG = 223
+    CLUSTER_SET_CONFIG_EPOCH = 224
+    CLUSTER_SETSLOT = 225
+    CLUSTER_SHARDS = 226
+    CLUSTER_SLAVES = 227
+    CLUSTER_SLOTS = 228
+    READ_ONLY = 229
+    READ_WRITE = 230
+
+    # Connection Management commands
+    AUTH = 301
+    CLIENT_CACHING = 302
+    CLIENT_GET_NAME = 303
+    CLIENT_GET_REDIR = 304
+    CLIENT_ID = 305
+    CLIENT_INFO = 306
+    CLIENT_KILL_SIMPLE = 307
+    CLIENT_KILL = 308
+    CLIENT_LIST = 309
+    CLIENT_NO_EVICT = 310
+    CLIENT_NO_TOUCH = 311
+    CLIENT_PAUSE = 312
+    CLIENT_REPLY = 313
+    CLIENT_SET_INFO = 314
+    CLIENT_SET_NAME = 315
+    CLIENT_TRACKING = 316
+    CLIENT_TRACKING_INFO = 317
+    CLIENT_UNBLOCK = 318
+    CLIENT_UNPAUSE = 319
+    ECHO = 320
+    HELLO = 321
+    PING = 322
+    QUIT = 323 # deprecated in 7.2.0
+    RESET = 324
+    SELECT = 325
+
+    # Generic commands
+    COPY = 401
+    DEL = 402
+    DUMP = 403
+    EXISTS = 404
+    EXPIRE = 405
+    EXPIRE_AT = 406
+    EXPIRE_TIME = 407
+    KEYS = 408
+    MIGRATE = 409
+    MOVE = 410
+    OBJECT_ENCODING = 411
+    OBJECT_FREQ = 412
+    OBJECT_IDLE_TIME = 413
+    OBJECT_REF_COUNT = 414
+    PERSIST = 415
+    PEXPIRE = 416
+    PEXPIRE_AT = 417
+    PEXPIRE_TIME = 418
+    PTTL = 419
+    RANDOM_KEY = 420
+    RENAME = 421
+    RENAME_NX = 422
+    RESTORE = 423
+    SCAN = 424
+    SORT = 425
+    SORT_READ_ONLY = 426
+    TOUCH = 427
+    TTL = 428
+    TYPE = 429
+    UNLINK = 430
+    WAIT = 431
+    WAIT_AOF = 432
+
+    # Geospatial indices commands
+    GEO_ADD = 501
+    GEO_DIST = 502
+    GEO_HASH = 503
+    GEO_POS = 504
+    GEO_RADIUS = 505
+    GEO_RADIUS_READ_ONLY = 506 # deprecated in 6.2.0
+    GEO_RADIUS_BY_MEMBER = 507
+    GEO_RADIUS_BY_MEMBER_READ_ONLY = 508 # deprecated in 6.2.0
+    GEO_SEARCH = 509
+    GEO_SEARCH_STORE = 510
+
+    # Hash commands
+    HDEL = 601
+    HEXISTS = 602
+    HGET = 603
+    HGET_ALL = 604
+    HINCR_BY = 605
+    HINCR_BY_FLOAT = 606
+    HKEYS = 607
+    HLEN = 608
+    HMGET = 609
+    HMSET = 610
+    HRAND_FIELD = 611
+    HSCAN = 612
+    HSET = 613
+    HSET_NX = 614
+    HSTRLEN = 615
+    HVALS = 616
+
+    # HyperLogLog commands
+    PFADD = 701
+    PFCOUNT = 702
+    PFMERGE = 703
+
+    # List commands
+    BLMOVE = 801
+    BLMPop = 802
+    BLPOP = 803
+    BRPOP = 804
+    BRPOPLPUSH = 805 # deprecated in 6.2.0
+    LINDEX = 806
+    LINSERT = 807
+    LLEN = 808
+    LMOVE = 809
+    LMPOP = 810
+    LPOP = 811
+    LPOS = 812
+    LPUSH = 813
+    LPUSHX = 814
+    LRANGE = 815
+    LREM = 816
+    LSET = 817
+    LTRIM = 818
+    RPOP = 819
+    RPOPLPUSH = 820 # deprecated in 6.2.0
+    RPUSH = 821
+    RPUSHX = 822
+
+    # Pub/Sub commands
+    PSUBSCRIBE = 901
+    PUBLISH = 902
+    PUBSUB_CHANNELS = 903
+    PUBSUB_NUM_PAT = 904
+    PUBSUB_NUM_SUB = 905
+    PUBSUB_SHARD_CHANNELS = 906
+    PUBSUB_SHARD_NUM_SUB = 907
+    PUNSUBSCRIBE = 908
+    SPUBLISH = 909
+    SSUBSCRIBE = 910
+    SUBSCRIBE = 911
+    SUNSUBSCRIBE = 912
+    UNSUBSCRIBE = 913
+
+    # Scripting and Functions commands
+    EVAL = 1001
+    EVAL_READ_ONLY = 1002
+    EVAL_SHA = 1003
+    EVAL_SHA_READ_ONLY = 1004
+    FCALL = 1005
+    FCALL_READ_ONLY = 1006
+    FUNCTION_DELETE = 1007
+    FUNCTION_DUMP = 1008
+    FUNCTION_FLUSH = 1009
+    FUNCTION_KILL = 1010
+    FUNCTION_LIST = 1011
+    FUNCTION_LOAD = 1012
+    FUNCTION_RESTORE = 1013
+    FUNCTION_STATS = 1014
+    SCRIPT_DEBUG = 1015
+    SCRIPT_EXISTS = 1016
+    SCRIPT_FLUSH = 1017
+    SCRIPT_KILL = 1018
+    SCRIPT_LOAD = 1019
+    SCRIPT_SHOW = 1020
+
+    # Server management commands
+    ACL_CAT = 1101
+    ACL_DEL_USER = 1102
+    ACL_DRY_RUN = 1103
+    ACL_GEN_PASS = 1104
+    ACL_GET_USER = 1105
+    ACL_LIST = 1106
+    ACL_LOAD = 1107
+    ACL_LOG = 1108
+    ACL_SAVE = 1109
+    ACL_SET_USER = 1110
+    ACL_USERS = 1111
+    ACL_WHOAMI = 1112
+    BG_REWRITE_AOF = 1113
+    BG_SAVE = 1114
+    COMMAND_ = 1115 # Command - renamed to avoid collisions
+    COMMAND_COUNT = 1116
+    COMMAND_DOCS = 1117
+    COMMAND_GET_KEYS = 1118
+    COMMAND_GET_KEYS_AND_FLAGS = 1119
+    COMMAND_INFO = 1120
+    COMMAND_LIST = 1121
+    CONFIG_GET = 1122
+    CONFIG_RESET_STAT = 1123
+    CONFIG_REWRITE = 1124
+    CONFIG_SET = 1125
+    DB_SIZE = 1126
+    FAIL_OVER = 1127
+    FLUSH_ALL = 1128
+    FLUSH_DB = 1129
+    INFO = 1130
+    LAST_SAVE = 1131
+    LATENCY_DOCTOR = 1132
+    LATENCY_GRAPH = 1133
+    LATENCY_HISTOGRAM = 1134
+    LATENCY_HISTORY = 1135
+    LATENCY_LATEST = 1136
+    LATENCY_RESET = 1137
+    LOLWUT = 1138
+    MEMORY_DOCTOR = 1139
+    MEMORY_MALLOC_STATS = 1140
+    MEMORY_PURGE = 1141
+    MEMORY_STATS = 1142
+    MEMORY_USAGE = 1143
+    MODULE_LIST = 1144
+    MODULE_LOAD = 1145
+    MODULE_LOAD_EX = 1146
+    MODULE_UNLOAD = 1147
+    MONITOR = 1148
+    PSYNC = 1149
+    REPL_CONF = 1150
+    REPLICA_OF = 1151
+    RESTORE_ASKING = 1152
+    ROLE = 1153
+    SAVE = 1154
+    SHUT_DOWN = 1155
+    SLAVE_OF = 1156
+    SLOWLOG_GET = 1157
+    SLOWLOG_LEN = 1158
+    SLOWLOG_RESET = 1159
+    SWAP_DB = 1160
+    SYNC = 1161
+    TIME = 1162
+
+    # Set commands
+    SADD = 1201
+    SCARD = 1202
+    SDIFF = 1203
+    SDIFF_STORE = 1204
+    SINTER = 1205
+    SINTER_CARD = 1206
+    SINTER_STORE = 1207
+    SISMEMBER = 1208
+    SMEMBERS = 1209
+    SMISMEMBER = 1210
+
+    # Set commands
+    S_MOVE = 1211
+    S_POP = 1212
+    S_RAND_MEMBER = 1213
+    S_REM = 1214
+    S_SCAN = 1215
+    S_UNION = 1216
+    S_UNION_STORE = 1217
+
+    # Sorted set commands
+    BZ_MPOP = 1301
+    BZ_POP_MAX = 1302
+    BZ_POP_MIN = 1303
+    Z_ADD = 1304
+    Z_CARD = 1305
+    Z_COUNT = 1306
+    Z_DIFF = 1307
+    Z_DIFF_STORE = 1308
+    Z_INCR_BY = 1309
+    Z_INTER = 1310
+    Z_INTER_CARD = 1311
+    Z_INTER_STORE = 1312
+    Z_LEX_COUNT = 1313
+    Z_MPOP = 1314
+    Z_MSCORE = 1315
+    Z_POP_MAX = 1316
+    Z_POP_MIN = 1317
+    Z_RAND_MEMBER = 1318
+    Z_RANGE = 1319
+    Z_RANGE_BY_LEX = 1320
+    Z_RANGE_BY_SCORE = 1321
+    Z_RANGE_STORE = 1322
+    Z_RANK = 1323
+    Z_REM = 1324
+    Z_REM_RANGE_BY_LEX = 1325
+    Z_REM_RANGE_BY_RANK = 1326
+    Z_REM_RANGE_BY_SCORE = 1327
+    Z_REV_RANGE = 1328
+    Z_REV_RANGE_BY_LEX = 1329
+    Z_REV_RANGE_BY_SCORE = 1330
+    Z_REV_RANK = 1331
+    Z_SCAN = 1332
+    Z_SCORE = 1333
+    Z_UNION = 1334
+    Z_UNION_STORE = 1335
+
+    # Stream commands
+    X_ACK = 1401
+    X_ADD = 1402
+    X_AUTO_CLAIM = 1403
+    X_CLAIM = 1404
+    X_DEL = 1405
+    X_GROUP_CREATE = 1406
+    X_GROUP_CREATE_CONSUMER = 1407
+    X_GROUP_DEL_CONSUMER = 1408
+    X_GROUP_DESTROY = 1409
+    X_GROUP_SET_ID = 1410
+    X_INFO_CONSUMERS = 1411
+    X_INFO_GROUPS = 1412
+    X_INFO_STREAM = 1413
+    X_LEN = 1414
+    X_PENDING = 1415
+    X_RANGE = 1416
+    X_READ = 1417
+    X_READ_GROUP = 1418
+    X_REV_RANGE = 1419
+    X_SET_ID = 1420
+    X_TRIM = 1421
+
+    # String commands
+    APPEND = 1501
+    DECR = 1502
+    DECR_BY = 1503
+    GET = 1504
+    GET_DEL = 1505
+    GET_EX = 1506
+    GET_RANGE = 1507
+    GET_SET = 1508 # deprecated in 6.2.0
+    INCR = 1509
+    INCR_BY = 1510
+    INCR_BY_FLOAT = 1511
+    LCS = 1512
+    MGET = 1513
+    MSET = 1514
+    MSET_NX = 1515
+    PSET_EX = 1516 # deprecated in 2.6.12
+    SET = 1517
+    SET_EX = 1518 # deprecated in 2.6.12
+    SET_NX = 1519 # deprecated in 2.6.12
+    SET_RANGE = 1520
+    STRLEN = 1521
+    SUBSTR = 1522
+
+    # Transaction commands
+    DISCARD = 1601
+    EXEC = 1602
+    MULTI = 1603
+    UNWATCH = 1604
+    WATCH = 1605
+
+    # JSON commands
+    JSON_ARR_APPEND = 2001
+    JSON_ARR_INDEX = 2002
+    JSON_ARR_INSERT = 2003
+    JSON_ARR_LEN = 2004
+    JSON_ARR_POP = 2005
+    JSON_ARR_TRIM = 2006
+    JSON_CLEAR = 2007
+    JSON_DEBUG = 2008
+    JSON_DEL = 2009
+    JSON_FORGET = 2010
+    JSON_GET = 2011
+    JSON_MGET = 2012
+    JSON_NUM_INCR_BY = 2013
+    JSON_NUM_MULT_BY = 2014
+    JSON_OBJ_KEYS = 2015
+    JSON_OBJ_LEN = 2016
+    JSON_RESP = 2017
+    JSON_SET = 2018
+    JSON_STR_APPEND = 2019
+    JSON_STR_LEN = 2020
+    JSON_TOGGLE = 2021
+    JSON_TYPE = 2022
+
+    # Vector Search commands
+    FT_LIST = 2101
+    FT_AGGREGATE = 2102
+    FT_ALIAS_ADD = 2103
+    FT_ALIAS_DEL = 2104
+    FT_ALIAS_LIST = 2105
+    FT_ALIAS_UPDATE = 2106
+    FT_CREATE = 2107
+    FT_DROP_INDEX = 2108
+    FT_EXPLAIN = 2109
+    FT_EXPLAIN_CLI = 2110
+    FT_INFO = 2111
+    FT_PROFILE = 2112
+    FT_SEARCH = 2113
+  end
+end

data/lib/valkey/response_type.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+class Valkey
+  module ResponseType
+    NULL = 0
+    INT = 1
+    FLOAT = 2
+    BOOL = 3
+    STRING = 4
+    ARRAY = 5
+    MAP = 6
+    SETS = 7
+    OK = 8
+    ERROR = 9
+  end
+end

data/lib/valkey/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+class Valkey
+  VERSION = "0.1.0"
+end

data/lib/valkey.rb

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+
+require "ffi"
+require "google/protobuf"
+
+require "valkey/version"
+require "valkey/request_type"
+require "valkey/response_type"
+require "valkey/protobuf/command_request_pb"
+require "valkey/protobuf/connection_request_pb"
+require "valkey/protobuf/response_pb"
+require "valkey/bindings"
+require "valkey/commands"
+require "valkey/errors"
+
+class Valkey
+  extend Bindings
+  include Commands
+
+  def your_pubsub_callback(_client_ptr, kind, msg_ptr, msg_len, chan_ptr, chan_len, pat_ptr, pat_len)
+    puts "PubSub received kind=#{kind}, message=#{msg_ptr.read_string(msg_len)}, channel=#{chan_ptr.read_string(chan_len)}, pattern=#{pat_ptr.read_string(pat_len)}"
+  end
+
+  def send_command(command_type, command_args = [])
+    channel = 0
+    route = "" # empty or some serialized route bytes
+
+    arg_ptrs = FFI::MemoryPointer.new(:pointer, command_args.size)
+    arg_lens = FFI::MemoryPointer.new(:ulong, command_args.size)
+    buffers = []
+
+    command_args.each_with_index do |arg, i|
+      buf = FFI::MemoryPointer.from_string(arg)
+      buffers << buf # prevent garbage collection
+      arg_ptrs.put_pointer(i * FFI::Pointer.size, buf)
+      arg_lens.put_ulong(i * 8, arg.bytesize)
+    end
+
+    route_buf = FFI::MemoryPointer.from_string(route)
+
+    res = Bindings.command(
+      @connection, # Assuming @connection is set after create
+      channel,
+      command_type,
+      command_args.size,
+      arg_ptrs,
+      arg_lens,
+      route_buf,
+      route.bytesize
+    )
+
+    result = Bindings::CommandResult.new(res)[:response]
+
+    case result[:response_type]
+    when ResponseType::STRING
+      result[:string_value].read_string(result[:string_value_len])
+    when ResponseType::OK
+      "OK"
+    end
+  end
+
+  # TODO: use options
+  def initialize(_options = {})
+    request = ConnectionRequest::ConnectionRequest.new(
+      addresses: [ConnectionRequest::NodeAddress.new(host: "127.0.0.1", port: 6379)]
+    )
+
+    client_type = Bindings::ClientType.new
+    client_type[:tag] = 1 # AsyncClient
+
+    request_str = ConnectionRequest::ConnectionRequest.encode(request)
+    request_buf = FFI::MemoryPointer.new(:char, request_str.bytesize)
+    request_buf.put_bytes(0, request_str)
+
+    request_len = request_str.bytesize
+
+    response_ptr = Bindings.create_client(
+      request_buf,
+      request_len,
+      client_type,
+      method(:your_pubsub_callback) # Pass the pubsub callback
+    )
+
+    res = Bindings::ConnectionResponse.new(response_ptr)
+
+    @connection = res[:conn_ptr]
+  end
+
+  def close
+    # TODO: handle closing the connection properly
+  end
+
+  alias disconnect! close
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification
+name: valkey
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Mohsen Alizadeh
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-07-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.17.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.17.0
+- !ruby/object:Gem::Dependency
+  name: google-protobuf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.29.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.29.2
+description: A Ruby client library for Valkey based on redis-rb.
+email:
+- mohsen@alizadeh.us
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- README.md
+- Rakefile
+- lib/valkey.rb
+- lib/valkey/bindings.rb
+- lib/valkey/commands.rb
+- lib/valkey/commands/connection.rb
+- lib/valkey/commands/server.rb
+- lib/valkey/commands/strings.rb
+- lib/valkey/errors.rb
+- lib/valkey/libglide_ffi.so
+- lib/valkey/protobuf/command_request_pb.rb
+- lib/valkey/protobuf/connection_request_pb.rb
+- lib/valkey/protobuf/response_pb.rb
+- lib/valkey/request_type.rb
+- lib/valkey/response_type.rb
+- lib/valkey/version.rb
+homepage: https://github.com/mohsen-alizadeh/valkey-rb
+licenses: []
+metadata:
+  homepage_uri: https://github.com/mohsen-alizadeh/valkey-rb
+  source_code_uri: https://github.com/mohsen-alizadeh/valkey-rb
+  changelog_uri: https://github.com/mohsen-alizadeh/valkey-rb
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.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: A Ruby client library for Valkey based on redis-rb.
+test_files: []