kubemq 1.0.0

data/lib/kubemq/proto/kubemq_pb.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: kubemq.proto
+
+require 'google/protobuf'
+
+
+descriptor_data = "\n\x0ckubemq.proto\x12\x06kubemq\"a\n\nPingResult\x12\x0c\n\x04Host\x18\x01 \x01(\t\x12\x0f\n\x07Version\x18\x02 \x01(\t\x12\x17\n\x0fServerStartTime\x18\x03 \x01(\x03\x12\x1b\n\x13ServerUpTimeSeconds\x18\x04 \x01(\x03\"\x07\n\x05\x45mpty\"6\n\x06Result\x12\x0f\n\x07\x45ventID\x18\x01 \x01(\t\x12\x0c\n\x04Sent\x18\x02 \x01(\x08\x12\r\n\x05\x45rror\x18\x03 \x01(\t\"\xbe\x01\n\x05\x45vent\x12\x0f\n\x07\x45ventID\x18\x01 \x01(\t\x12\x10\n\x08\x43lientID\x18\x02 \x01(\t\x12\x0f\n\x07\x43hannel\x18\x03 \x01(\t\x12\x10\n\x08Metadata\x18\x04 \x01(\t\x12\x0c\n\x04\x42ody\x18\x05 \x01(\x0c\x12\r\n\x05Store\x18\x06 \x01(\x08\x12%\n\x04Tags\x18\x07 \x03(\x0b\x32\x17.kubemq.Event.TagsEntry\x1a+\n\tTagsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xd0\x01\n\x0c\x45ventReceive\x12\x0f\n\x07\x45ventID\x18\x01 \x01(\t\x12\x0f\n\x07\x43hannel\x18\x02 \x01(\t\x12\x10\n\x08Metadata\x18\x03 \x01(\t\x12\x0c\n\x04\x42ody\x18\x04 \x01(\x0c\x12\x11\n\tTimestamp\x18\x05 \x01(\x03\x12\x10\n\x08Sequence\x18\x06 \x01(\x04\x12,\n\x04Tags\x18\x07 \x03(\x0b\x32\x1e.kubemq.EventReceive.TagsEntry\x1a+\n\tTagsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xe3\x03\n\tSubscribe\x12:\n\x11SubscribeTypeData\x18\x01 \x01(\x0e\x32\x1f.kubemq.Subscribe.SubscribeType\x12\x10\n\x08\x43lientID\x18\x02 \x01(\t\x12\x0f\n\x07\x43hannel\x18\x03 \x01(\t\x12\r\n\x05Group\x18\x04 \x01(\t\x12>\n\x13\x45ventsStoreTypeData\x18\x05 \x01(\x0e\x32!.kubemq.Subscribe.EventsStoreType\x12\x1c\n\x14\x45ventsStoreTypeValue\x18\x06 \x01(\x03\"c\n\rSubscribeType\x12\x1a\n\x16SubscribeTypeUndefined\x10\x00\x12\n\n\x06\x45vents\x10\x01\x12\x0f\n\x0b\x45ventsStore\x10\x02\x12\x0c\n\x08\x43ommands\x10\x03\x12\x0b\n\x07Queries\x10\x04\"\xa4\x01\n\x0f\x45ventsStoreType\x12\x1c\n\x18\x45ventsStoreTypeUndefined\x10\x00\x12\x10\n\x0cStartNewOnly\x10\x01\x12\x12\n\x0eStartFromFirst\x10\x02\x12\x11\n\rStartFromLast\x10\x03\x12\x13\n\x0fStartAtSequence\x10\x04\x12\x0f\n\x0bStartAtTime\x10\x05\x12\x14\n\x10StartAtTimeDelta\x10\x06\"\x83\x03\n\x07Request\x12\x11\n\tRequestID\x18\x01 \x01(\t\x12\x34\n\x0fRequestTypeData\x18\x02 \x01(\x0e\x32\x1b.kubemq.Request.RequestType\x12\x10\n\x08\x43lientID\x18\x03 \x01(\t\x12\x0f\n\x07\x43hannel\x18\x04 \x01(\t\x12\x10\n\x08Metadata\x18\x05 \x01(\t\x12\x0c\n\x04\x42ody\x18\x06 \x01(\x0c\x12\x14\n\x0cReplyChannel\x18\x07 \x01(\t\x12\x0f\n\x07Timeout\x18\x08 \x01(\x05\x12\x10\n\x08\x43\x61\x63heKey\x18\t \x01(\t\x12\x10\n\x08\x43\x61\x63heTTL\x18\n \x01(\x05\x12\x0c\n\x04Span\x18\x0b \x01(\x0c\x12\'\n\x04Tags\x18\x0c \x03(\x0b\x32\x19.kubemq.Request.TagsEntry\x1a+\n\tTagsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"=\n\x0bRequestType\x12\x16\n\x12RequestTypeUnknown\x10\x00\x12\x0b\n\x07\x43ommand\x10\x01\x12\t\n\x05Query\x10\x02\"\x90\x02\n\x08Response\x12\x10\n\x08\x43lientID\x18\x01 \x01(\t\x12\x11\n\tRequestID\x18\x02 \x01(\t\x12\x14\n\x0cReplyChannel\x18\x03 \x01(\t\x12\x10\n\x08Metadata\x18\x04 \x01(\t\x12\x0c\n\x04\x42ody\x18\x05 \x01(\x0c\x12\x10\n\x08\x43\x61\x63heHit\x18\x06 \x01(\x08\x12\x11\n\tTimestamp\x18\x07 \x01(\x03\x12\x10\n\x08\x45xecuted\x18\x08 \x01(\x08\x12\r\n\x05\x45rror\x18\t \x01(\t\x12\x0c\n\x04Span\x18\n \x01(\x0c\x12(\n\x04Tags\x18\x0b \x03(\x0b\x32\x1a.kubemq.Response.TagsEntry\x1a+\n\tTagsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x9f\x02\n\x0cQueueMessage\x12\x11\n\tMessageID\x18\x01 \x01(\t\x12\x10\n\x08\x43lientID\x18\x02 \x01(\t\x12\x0f\n\x07\x43hannel\x18\x03 \x01(\t\x12\x10\n\x08Metadata\x18\x04 \x01(\t\x12\x0c\n\x04\x42ody\x18\x05 \x01(\x0c\x12,\n\x04Tags\x18\x06 \x03(\x0b\x32\x1e.kubemq.QueueMessage.TagsEntry\x12\x32\n\nAttributes\x18\x07 \x01(\x0b\x32\x1e.kubemq.QueueMessageAttributes\x12*\n\x06Policy\x18\x08 \x01(\x0b\x32\x1a.kubemq.QueueMessagePolicy\x1a+\n\tTagsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"T\n\x19QueueMessagesBatchRequest\x12\x0f\n\x07\x42\x61tchID\x18\x01 \x01(\t\x12&\n\x08Messages\x18\x02 \x03(\x0b\x32\x14.kubemq.QueueMessage\"r\n\x1aQueueMessagesBatchResponse\x12\x0f\n\x07\x42\x61tchID\x18\x01 \x01(\t\x12/\n\x07Results\x18\x02 \x03(\x0b\x32\x1e.kubemq.SendQueueMessageResult\x12\x12\n\nHaveErrors\x18\x03 \x01(\x08\"\xbc\x01\n\x16QueueMessageAttributes\x12\x11\n\tTimestamp\x18\x01 \x01(\x03\x12\x10\n\x08Sequence\x18\x02 \x01(\x04\x12\x11\n\tMD5OfBody\x18\x03 \x01(\t\x12\x14\n\x0cReceiveCount\x18\x04 \x01(\x05\x12\x10\n\x08ReRouted\x18\x05 \x01(\x08\x12\x19\n\x11ReRoutedFromQueue\x18\x06 \x01(\t\x12\x14\n\x0c\x45xpirationAt\x18\x07 \x01(\x03\x12\x11\n\tDelayedTo\x18\x08 \x01(\x03\"w\n\x12QueueMessagePolicy\x12\x19\n\x11\x45xpirationSeconds\x18\x01 \x01(\x05\x12\x14\n\x0c\x44\x65laySeconds\x18\x02 \x01(\x05\x12\x17\n\x0fMaxReceiveCount\x18\x03 \x01(\x05\x12\x17\n\x0fMaxReceiveQueue\x18\x04 \x01(\t\"\x84\x01\n\x16SendQueueMessageResult\x12\x11\n\tMessageID\x18\x01 \x01(\t\x12\x0e\n\x06SentAt\x18\x02 \x01(\x03\x12\x14\n\x0c\x45xpirationAt\x18\x03 \x01(\x03\x12\x11\n\tDelayedTo\x18\x04 \x01(\x03\x12\x0f\n\x07IsError\x18\x05 \x01(\x08\x12\r\n\x05\x45rror\x18\x06 \x01(\t\"\x99\x01\n\x1bReceiveQueueMessagesRequest\x12\x11\n\tRequestID\x18\x01 \x01(\t\x12\x10\n\x08\x43lientID\x18\x02 \x01(\t\x12\x0f\n\x07\x43hannel\x18\x03 \x01(\t\x12\x1b\n\x13MaxNumberOfMessages\x18\x04 \x01(\x05\x12\x17\n\x0fWaitTimeSeconds\x18\x05 \x01(\x05\x12\x0e\n\x06IsPeak\x18\x06 \x01(\x08\"\xbc\x01\n\x1cReceiveQueueMessagesResponse\x12\x11\n\tRequestID\x18\x01 \x01(\t\x12&\n\x08Messages\x18\x02 \x03(\x0b\x32\x14.kubemq.QueueMessage\x12\x18\n\x10MessagesReceived\x18\x03 \x01(\x05\x12\x17\n\x0fMessagesExpired\x18\x04 \x01(\x05\x12\x0e\n\x06IsPeak\x18\x05 \x01(\x08\x12\x0f\n\x07IsError\x18\x06 \x01(\x08\x12\r\n\x05\x45rror\x18\x07 \x01(\t\"k\n\x1a\x41\x63kAllQueueMessagesRequest\x12\x11\n\tRequestID\x18\x01 \x01(\t\x12\x10\n\x08\x43lientID\x18\x02 \x01(\t\x12\x0f\n\x07\x43hannel\x18\x03 \x01(\t\x12\x17\n\x0fWaitTimeSeconds\x18\x04 \x01(\x05\"j\n\x1b\x41\x63kAllQueueMessagesResponse\x12\x11\n\tRequestID\x18\x01 \x01(\t\x12\x18\n\x10\x41\x66\x66\x65\x63tedMessages\x18\x02 \x01(\x04\x12\x0f\n\x07IsError\x18\x03 \x01(\x08\x12\r\n\x05\x45rror\x18\x04 \x01(\t\"\x84\x02\n\x1aStreamQueueMessagesRequest\x12\x11\n\tRequestID\x18\x01 \x01(\t\x12\x10\n\x08\x43lientID\x18\x02 \x01(\t\x12\x38\n\x15StreamRequestTypeData\x18\x03 \x01(\x0e\x32\x19.kubemq.StreamRequestType\x12\x0f\n\x07\x43hannel\x18\x04 \x01(\t\x12\x19\n\x11VisibilitySeconds\x18\x05 \x01(\x05\x12\x17\n\x0fWaitTimeSeconds\x18\x06 \x01(\x05\x12\x13\n\x0bRefSequence\x18\x07 \x01(\x04\x12-\n\x0fModifiedMessage\x18\x08 \x01(\x0b\x32\x14.kubemq.QueueMessage\"\xb1\x01\n\x1bStreamQueueMessagesResponse\x12\x11\n\tRequestID\x18\x01 \x01(\t\x12\x38\n\x15StreamRequestTypeData\x18\x02 \x01(\x0e\x32\x19.kubemq.StreamRequestType\x12%\n\x07Message\x18\x03 \x01(\x0b\x32\x14.kubemq.QueueMessage\x12\x0f\n\x07IsError\x18\x04 \x01(\x08\x12\r\n\x05\x45rror\x18\x05 \x01(\t\"R\n\x15QueuesUpstreamRequest\x12\x11\n\tRequestID\x18\x01 \x01(\t\x12&\n\x08Messages\x18\x02 \x03(\x0b\x32\x14.kubemq.QueueMessage\"\x7f\n\x16QueuesUpstreamResponse\x12\x14\n\x0cRefRequestID\x18\x01 \x01(\t\x12/\n\x07Results\x18\x02 \x03(\x0b\x32\x1e.kubemq.SendQueueMessageResult\x12\x0f\n\x07IsError\x18\x03 \x01(\x08\x12\r\n\x05\x45rror\x18\x04 \x01(\t\"\x80\x03\n\x17QueuesDownstreamRequest\x12\x11\n\tRequestID\x18\x01 \x01(\t\x12\x10\n\x08\x43lientID\x18\x02 \x01(\t\x12<\n\x0fRequestTypeData\x18\x03 \x01(\x0e\x32#.kubemq.QueuesDownstreamRequestType\x12\x0f\n\x07\x43hannel\x18\x04 \x01(\t\x12\x10\n\x08MaxItems\x18\x05 \x01(\x05\x12\x13\n\x0bWaitTimeout\x18\x06 \x01(\x05\x12\x0f\n\x07\x41utoAck\x18\x07 \x01(\x08\x12\x16\n\x0eReQueueChannel\x18\x08 \x01(\t\x12\x15\n\rSequenceRange\x18\t \x03(\x03\x12\x18\n\x10RefTransactionId\x18\n \x01(\t\x12?\n\x08Metadata\x18\x0c \x03(\x0b\x32-.kubemq.QueuesDownstreamRequest.MetadataEntry\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\xf4\x02\n\x18QueuesDownstreamResponse\x12\x15\n\rTransactionId\x18\x01 \x01(\t\x12\x14\n\x0cRefRequestId\x18\x02 \x01(\t\x12<\n\x0fRequestTypeData\x18\x03 \x01(\x0e\x32#.kubemq.QueuesDownstreamRequestType\x12&\n\x08Messages\x18\x04 \x03(\x0b\x32\x14.kubemq.QueueMessage\x12\x15\n\rActiveOffsets\x18\x05 \x03(\x03\x12\x0f\n\x07IsError\x18\x06 \x01(\x08\x12\r\n\x05\x45rror\x18\x07 \x01(\t\x12\x1b\n\x13TransactionComplete\x18\x08 \x01(\x08\x12@\n\x08Metadata\x18\t \x03(\x0b\x32..kubemq.QueuesDownstreamResponse.MetadataEntry\x1a/\n\rMetadataEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01*\xaa\x01\n\x11StreamRequestType\x12\x1c\n\x18StreamRequestTypeUnknown\x10\x00\x12\x12\n\x0eReceiveMessage\x10\x01\x12\x0e\n\nAckMessage\x10\x02\x12\x11\n\rRejectMessage\x10\x03\x12\x14\n\x10ModifyVisibility\x10\x04\x12\x11\n\rResendMessage\x10\x05\x12\x17\n\x13SendModifiedMessage\x10\x06*\xea\x01\n\x1bQueuesDownstreamRequestType\x12\x1a\n\x16PollRequestTypeUnknown\x10\x00\x12\x07\n\x03Get\x10\x01\x12\n\n\x06\x41\x63kAll\x10\x02\x12\x0c\n\x08\x41\x63kRange\x10\x03\x12\x0b\n\x07NAckAll\x10\x04\x12\r\n\tNAckRange\x10\x05\x12\x0e\n\nReQueueAll\x10\x06\x12\x10\n\x0cReQueueRange\x10\x07\x12\x11\n\rActiveOffsets\x10\x08\x12\x15\n\x11TransactionStatus\x10\t\x12\x11\n\rCloseByClient\x10\n\x12\x11\n\rCloseByServer\x10\x0b\x32\x93\x08\n\x06kubemq\x12,\n\tSendEvent\x12\r.kubemq.Event\x1a\x0e.kubemq.Result\"\x00\x12\x37\n\x10SendEventsStream\x12\r.kubemq.Event\x1a\x0e.kubemq.Result\"\x00(\x01\x30\x01\x12@\n\x11SubscribeToEvents\x12\x11.kubemq.Subscribe\x1a\x14.kubemq.EventReceive\"\x00\x30\x01\x12=\n\x13SubscribeToRequests\x12\x11.kubemq.Subscribe\x1a\x0f.kubemq.Request\"\x00\x30\x01\x12\x32\n\x0bSendRequest\x12\x0f.kubemq.Request\x1a\x10.kubemq.Response\"\x00\x12\x31\n\x0cSendResponse\x12\x10.kubemq.Response\x1a\r.kubemq.Empty\"\x00\x12J\n\x10SendQueueMessage\x12\x14.kubemq.QueueMessage\x1a\x1e.kubemq.SendQueueMessageResult\"\x00\x12\x61\n\x16SendQueueMessagesBatch\x12!.kubemq.QueueMessagesBatchRequest\x1a\".kubemq.QueueMessagesBatchResponse\"\x00\x12\x63\n\x14ReceiveQueueMessages\x12#.kubemq.ReceiveQueueMessagesRequest\x1a$.kubemq.ReceiveQueueMessagesResponse\"\x00\x12\x63\n\x12StreamQueueMessage\x12\".kubemq.StreamQueueMessagesRequest\x1a#.kubemq.StreamQueueMessagesResponse\"\x00(\x01\x30\x01\x12`\n\x13\x41\x63kAllQueueMessages\x12\".kubemq.AckAllQueueMessagesRequest\x1a#.kubemq.AckAllQueueMessagesResponse\"\x00\x12+\n\x04Ping\x12\r.kubemq.Empty\x1a\x12.kubemq.PingResult\"\x00\x12[\n\x10QueuesDownstream\x12\x1f.kubemq.QueuesDownstreamRequest\x1a .kubemq.QueuesDownstreamResponse\"\x00(\x01\x30\x01\x12U\n\x0eQueuesUpstream\x12\x1d.kubemq.QueuesUpstreamRequest\x1a\x1e.kubemq.QueuesUpstreamResponse\"\x00(\x01\x30\x01\x62\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module Kubemq
+  PingResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.PingResult").msgclass
+  Empty = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.Empty").msgclass
+  Result = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.Result").msgclass
+  Event = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.Event").msgclass
+  EventReceive = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.EventReceive").msgclass
+  Subscribe = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.Subscribe").msgclass
+  Subscribe::SubscribeType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.Subscribe.SubscribeType").enummodule
+  Subscribe::EventsStoreType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.Subscribe.EventsStoreType").enummodule
+  Request = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.Request").msgclass
+  Request::RequestType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.Request.RequestType").enummodule
+  Response = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.Response").msgclass
+  QueueMessage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.QueueMessage").msgclass
+  QueueMessagesBatchRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.QueueMessagesBatchRequest").msgclass
+  QueueMessagesBatchResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.QueueMessagesBatchResponse").msgclass
+  QueueMessageAttributes = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.QueueMessageAttributes").msgclass
+  QueueMessagePolicy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.QueueMessagePolicy").msgclass
+  SendQueueMessageResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.SendQueueMessageResult").msgclass
+  ReceiveQueueMessagesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.ReceiveQueueMessagesRequest").msgclass
+  ReceiveQueueMessagesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.ReceiveQueueMessagesResponse").msgclass
+  AckAllQueueMessagesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.AckAllQueueMessagesRequest").msgclass
+  AckAllQueueMessagesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.AckAllQueueMessagesResponse").msgclass
+  StreamQueueMessagesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.StreamQueueMessagesRequest").msgclass
+  StreamQueueMessagesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.StreamQueueMessagesResponse").msgclass
+  QueuesUpstreamRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.QueuesUpstreamRequest").msgclass
+  QueuesUpstreamResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.QueuesUpstreamResponse").msgclass
+  QueuesDownstreamRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.QueuesDownstreamRequest").msgclass
+  QueuesDownstreamResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.QueuesDownstreamResponse").msgclass
+  StreamRequestType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.StreamRequestType").enummodule
+  QueuesDownstreamRequestType = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("kubemq.QueuesDownstreamRequestType").enummodule
+end

data/lib/kubemq/proto/kubemq_services_pb.rb

@@ -0,0 +1,35 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: kubemq.proto for package 'kubemq'
+
+require 'grpc'
+require_relative 'kubemq_pb'
+
+module Kubemq
+  module Kubemq
+    class Service
+
+      include ::GRPC::GenericService
+
+      self.marshal_class_method = :encode
+      self.unmarshal_class_method = :decode
+      self.service_name = 'kubemq.kubemq'
+
+      rpc :SendEvent, ::Kubemq::Event, ::Kubemq::Result
+      rpc :SendEventsStream, stream(::Kubemq::Event), stream(::Kubemq::Result)
+      rpc :SubscribeToEvents, ::Kubemq::Subscribe, stream(::Kubemq::EventReceive)
+      rpc :SubscribeToRequests, ::Kubemq::Subscribe, stream(::Kubemq::Request)
+      rpc :SendRequest, ::Kubemq::Request, ::Kubemq::Response
+      rpc :SendResponse, ::Kubemq::Response, ::Kubemq::Empty
+      rpc :SendQueueMessage, ::Kubemq::QueueMessage, ::Kubemq::SendQueueMessageResult
+      rpc :SendQueueMessagesBatch, ::Kubemq::QueueMessagesBatchRequest, ::Kubemq::QueueMessagesBatchResponse
+      rpc :ReceiveQueueMessages, ::Kubemq::ReceiveQueueMessagesRequest, ::Kubemq::ReceiveQueueMessagesResponse
+      rpc :StreamQueueMessage, stream(::Kubemq::StreamQueueMessagesRequest), stream(::Kubemq::StreamQueueMessagesResponse)
+      rpc :AckAllQueueMessages, ::Kubemq::AckAllQueueMessagesRequest, ::Kubemq::AckAllQueueMessagesResponse
+      rpc :Ping, ::Kubemq::Empty, ::Kubemq::PingResult
+      rpc :QueuesDownstream, stream(::Kubemq::QueuesDownstreamRequest), stream(::Kubemq::QueuesDownstreamResponse)
+      rpc :QueuesUpstream, stream(::Kubemq::QueuesUpstreamRequest), stream(::Kubemq::QueuesUpstreamResponse)
+    end
+
+    Stub = Service.rpc_stub_class
+  end
+end

data/lib/kubemq/pubsub/client.rb

@@ -0,0 +1,475 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+
+module KubeMQ
+  # Client for KubeMQ pub/sub messaging — events (fire-and-forget) and
+  # events store (durable with replay).
+  #
+  # Inherits connection management and channel CRUD from {BaseClient}.
+  # Subscription methods run on background threads and accept a block for
+  # incoming messages.
+  #
+  # @example Send and subscribe to events
+  #   client = KubeMQ::PubSubClient.new(address: "localhost:50000")
+  #
+  #   token = KubeMQ::CancellationToken.new
+  #   sub = KubeMQ::PubSub::EventsSubscription.new(channel: "notifications")
+  #   client.subscribe_to_events(sub, cancellation_token: token) do |event|
+  #     puts "Received: #{event.body}"
+  #   end
+  #
+  #   client.send_event(
+  #     KubeMQ::PubSub::EventMessage.new(channel: "notifications", body: "hello")
+  #   )
+  #   sleep 1
+  #   token.cancel
+  #   client.close
+  #
+  # @see PubSub::EventMessage
+  # @see PubSub::EventsSubscription
+  # @see PubSub::EventsStoreSubscription
+  class PubSubClient < BaseClient
+    def initialize(**kwargs)
+      super
+      @senders = []
+      @senders_mutex = Mutex.new
+    end
+
+    # Sends a single event to a channel. Fire-and-forget semantics — the
+    # server does not guarantee persistence.
+    #
+    # @param message [PubSub::EventMessage] event to send
+    #
+    # @return [PubSub::EventSendResult] send confirmation with error status
+    #
+    # @raise [ValidationError] if channel name or content is invalid
+    # @raise [ClientClosedError] if the client has been closed
+    # @raise [ConnectionError] if unable to reach the broker
+    #
+    # @example
+    #   msg = KubeMQ::PubSub::EventMessage.new(
+    #     channel: "events.orders",
+    #     metadata: "order-created",
+    #     body: '{"id": 42}',
+    #     tags: { "env" => "production" }
+    #   )
+    #   result = client.send_event(msg)
+    #   puts "Sent: #{result.id}" if result.sent
+    #
+    # @see PubSub::EventMessage
+    # @see PubSub::EventSendResult
+    def send_event(message)
+      Validator.validate_channel!(message.channel, allow_wildcards: false)
+      Validator.validate_content!(message.metadata, message.body)
+      ensure_connected!
+
+      proto = Transport::Converter.event_to_proto(message, @config.client_id, store: false)
+      result = @transport.kubemq_client.send_event(proto)
+      hash = Transport::Converter.proto_to_event_result(result)
+      PubSub::EventSendResult.new(**hash)
+    end
+
+    # Creates a streaming event sender for high-throughput publishing.
+    #
+    # The sender holds a persistent gRPC stream open. Close it explicitly
+    # when finished, or it will be closed when the client is closed.
+    #
+    # @param on_error [Proc, nil] callback receiving {Error} on stream failures
+    #
+    # @return [PubSub::EventSender] streaming sender bound to this client
+    #
+    # @raise [ClientClosedError] if the client has been closed
+    # @raise [ConnectionError] if unable to reach the broker
+    #
+    # @see PubSub::EventSender
+    def create_events_sender(on_error: nil)
+      ensure_connected!
+      sender = PubSub::EventSender.new(transport: @transport, client_id: @config.client_id, on_error: on_error)
+      senders_mutex.synchronize { senders_list << sender }
+      sender
+    end
+
+    # Subscribes to real-time events on a channel. Runs on a background
+    # thread; incoming events are delivered to the provided block.
+    #
+    # The subscription automatically reconnects with exponential backoff on
+    # transient failures. Use the returned {Subscription} or the
+    # +cancellation_token+ to stop.
+    #
+    # @param subscription [PubSub::EventsSubscription] channel and group config
+    # @param cancellation_token [CancellationToken, nil] token for cooperative
+    #   cancellation (auto-created if nil)
+    # @param on_error [Proc, nil] callback receiving {Error} on stream or
+    #   callback failures
+    # @yield [event] called for each received event on a background thread
+    # @yieldparam event [PubSub::EventReceived] the received event
+    #
+    # @return [Subscription] handle to check status, cancel, or join
+    #
+    # @raise [ArgumentError] if no block is given
+    # @raise [ValidationError] if the subscription channel is invalid
+    # @raise [ClientClosedError] if the client has been closed
+    #
+    # @note Wildcard channels (containing +*+ or +>+) are supported for events.
+    #
+    # @example
+    #   token = KubeMQ::CancellationToken.new
+    #   sub_config = KubeMQ::PubSub::EventsSubscription.new(
+    #     channel: "events.>", group: "workers"
+    #   )
+    #   subscription = client.subscribe_to_events(sub_config, cancellation_token: token) do |event|
+    #     puts "#{event.channel}: #{event.body}"
+    #   end
+    #   # later...
+    #   token.cancel
+    #   subscription.wait(5)
+    #
+    # @see PubSub::EventsSubscription
+    # @see PubSub::EventReceived
+    # @see CancellationToken
+    # @see Subscription
+    # rubocop:disable Metrics/AbcSize, Metrics/MethodLength -- subscription with auto-reconnect loop
+    def subscribe_to_events(subscription, cancellation_token: nil, on_error: nil, &block)
+      raise ArgumentError, 'Block required for subscribe_to_events' unless block
+
+      Validator.validate_channel!(subscription.channel, allow_wildcards: true)
+      ensure_connected!
+
+      cancellation_token ||= CancellationToken.new
+      nil
+
+      thread = Thread.new do
+        @transport.register_subscription(Thread.current)
+        Thread.current[:cancellation_token] = cancellation_token
+        reconnect_attempts = 0
+        begin
+          loop do
+            break if cancellation_token.cancelled?
+
+            begin
+              @transport.ensure_connected!
+              proto_sub = Transport::Converter.subscribe_to_proto(subscription, @config.client_id)
+              stream = @transport.kubemq_client.subscribe_to_events(proto_sub)
+              Thread.current[:grpc_call] = stream
+              reconnect_attempts = 0
+              stream.each do |event_receive|
+                break if cancellation_token.cancelled?
+
+                hash = Transport::Converter.proto_to_event_received(event_receive)
+                received = PubSub::EventReceived.new(**hash)
+                begin
+                  block.call(received)
+                rescue StandardError => e
+                  begin
+                    on_error&.call(Error.new("Callback error: #{e.message}", code: ErrorCode::CALLBACK_ERROR))
+                  rescue StandardError => nested
+                    Kernel.warn("[kubemq] on_error callback raised: #{nested.message}")
+                  end
+                end
+              end
+            rescue CancellationError
+              break
+            rescue GRPC::BadStatus, StandardError => e
+              @transport.on_disconnect! if e.is_a?(GRPC::Unavailable) || e.is_a?(GRPC::DeadlineExceeded)
+              reconnect_attempts += 1
+              begin
+                if e.is_a?(GRPC::BadStatus)
+                  on_error&.call(ErrorMapper.map_grpc_error(e, operation: 'subscribe_events'))
+                else
+                  on_error&.call(Error.new(e.message, code: ErrorCode::STREAM_BROKEN))
+                end
+              rescue StandardError => cb_err
+                Kernel.warn("[kubemq] on_error callback raised: #{cb_err.message}")
+              end
+              delay = [@config.reconnect_policy.base_interval *
+                (@config.reconnect_policy.multiplier**(reconnect_attempts - 1)),
+                       @config.reconnect_policy.max_delay].min
+              sleep(delay) unless cancellation_token.cancelled?
+            end
+          end
+        rescue StandardError => e
+          Thread.current[:kubemq_subscription]&.mark_error(e)
+        ensure
+          begin; Thread.current[:grpc_call]&.cancel; rescue StandardError; end
+          Thread.current[:kubemq_subscription]&.mark_closed
+          @transport.unregister_subscription(Thread.current)
+        end
+      end
+
+      sub_wrapper = KubeMQ::Subscription.new(thread: thread, cancellation_token: cancellation_token)
+      thread[:kubemq_subscription] = sub_wrapper
+      sub_wrapper
+    end
+    # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
+
+    # Sends a single event to a durable events store channel.
+    #
+    # Unlike {#send_event}, the broker persists events store messages and
+    # supports replay via {#subscribe_to_events_store}.
+    #
+    # @param message [PubSub::EventStoreMessage] event store message to send
+    #
+    # @return [PubSub::EventStoreResult] send confirmation with error status
+    #
+    # @raise [ValidationError] if channel name or content is invalid
+    # @raise [ClientClosedError] if the client has been closed
+    # @raise [ConnectionError] if unable to reach the broker
+    #
+    # @example
+    #   msg = KubeMQ::PubSub::EventStoreMessage.new(
+    #     channel: "orders.created",
+    #     body: '{"id": 42}'
+    #   )
+    #   result = client.send_event_store(msg)
+    #   puts "Stored: #{result.id}" if result.sent
+    #
+    # @see PubSub::EventStoreMessage
+    # @see PubSub::EventStoreResult
+    def send_event_store(message)
+      Validator.validate_channel!(message.channel, allow_wildcards: false)
+      Validator.validate_content!(message.metadata, message.body)
+      ensure_connected!
+
+      proto = Transport::Converter.event_to_proto(message, @config.client_id, store: true)
+      result = @transport.kubemq_client.send_event(proto)
+      hash = Transport::Converter.proto_to_event_result(result)
+      PubSub::EventStoreResult.new(**hash)
+    end
+
+    # Creates a streaming events store sender for high-throughput publishing
+    # with synchronous per-message confirmation.
+    #
+    # Close the sender explicitly when finished, or it will be closed when
+    # the client is closed.
+    #
+    # @return [PubSub::EventStoreSender] streaming sender bound to this client
+    #
+    # @raise [ClientClosedError] if the client has been closed
+    # @raise [ConnectionError] if unable to reach the broker
+    #
+    # @see PubSub::EventStoreSender
+    def create_events_store_sender
+      ensure_connected!
+      sender = PubSub::EventStoreSender.new(transport: @transport, client_id: @config.client_id)
+      senders_mutex.synchronize { senders_list << sender }
+      sender
+    end
+
+    # Subscribes to durable events store messages on a channel. Runs on a
+    # background thread; incoming events are delivered to the provided block.
+    #
+    # The subscription automatically reconnects with exponential backoff on
+    # transient failures. On reconnect, playback resumes from the last
+    # received sequence number to avoid duplicates.
+    #
+    # @param subscription [PubSub::EventsStoreSubscription] channel, group,
+    #   and start position config
+    # @param cancellation_token [CancellationToken, nil] token for cooperative
+    #   cancellation (auto-created if nil)
+    # @param on_error [Proc, nil] callback receiving {Error} on stream or
+    #   callback failures
+    # @yield [event] called for each received event on a background thread
+    # @yieldparam event [PubSub::EventStoreReceived] the received event
+    #
+    # @return [Subscription] handle to check status, cancel, or join
+    #
+    # @raise [ArgumentError] if no block is given
+    # @raise [ValidationError] if the subscription channel or start position
+    #   is invalid
+    # @raise [ClientClosedError] if the client has been closed
+    #
+    # @note On reconnect the subscription automatically resumes from the last
+    #   received sequence number, overriding the original start position.
+    #
+    # @example Subscribe from the beginning
+    #   sub = KubeMQ::PubSub::EventsStoreSubscription.new(
+    #     channel: "orders",
+    #     start_position: KubeMQ::PubSub::EventStoreStartPosition::START_FROM_FIRST
+    #   )
+    #   token = KubeMQ::CancellationToken.new
+    #   client.subscribe_to_events_store(sub, cancellation_token: token) do |event|
+    #     puts "seq=#{event.sequence}: #{event.body}"
+    #   end
+    #
+    # @see PubSub::EventsStoreSubscription
+    # @see PubSub::EventStoreReceived
+    # @see PubSub::EventStoreStartPosition
+    # @see CancellationToken
+    # rubocop:disable Metrics/AbcSize, Metrics/MethodLength -- subscription with auto-reconnect + sequence tracking
+    def subscribe_to_events_store(subscription, cancellation_token: nil, on_error: nil, &block)
+      raise ArgumentError, 'Block required for subscribe_to_events_store' unless block
+
+      Validator.validate_channel!(subscription.channel, allow_wildcards: false)
+      Validator.validate_events_store_subscription!(
+        subscription.start_position, subscription.start_position_value
+      )
+      ensure_connected!
+
+      cancellation_token ||= CancellationToken.new
+      nil
+
+      thread = Thread.new do
+        @transport.register_subscription(Thread.current)
+        Thread.current[:cancellation_token] = cancellation_token
+        last_sequence = 0
+        reconnect_attempts = 0
+        begin
+          loop do
+            break if cancellation_token.cancelled?
+
+            begin
+              @transport.ensure_connected!
+              proto_sub = Transport::Converter.subscribe_to_proto(subscription, @config.client_id)
+              if last_sequence.positive?
+                proto_sub.EventsStoreTypeData = PubSub::EventStoreStartPosition::START_AT_SEQUENCE
+                proto_sub.EventsStoreTypeValue = last_sequence + 1
+              end
+              stream = @transport.kubemq_client.subscribe_to_events(proto_sub)
+              Thread.current[:grpc_call] = stream
+              reconnect_attempts = 0
+              stream.each do |event_receive|
+                break if cancellation_token.cancelled?
+
+                hash = Transport::Converter.proto_to_event_received(event_receive)
+                received = PubSub::EventStoreReceived.new(**hash)
+                last_sequence = received.sequence if received.sequence.positive?
+                begin
+                  block.call(received)
+                rescue StandardError => e
+                  begin
+                    on_error&.call(Error.new("Callback error: #{e.message}", code: ErrorCode::CALLBACK_ERROR))
+                  rescue StandardError => nested
+                    Kernel.warn("[kubemq] on_error callback raised: #{nested.message}")
+                  end
+                end
+              end
+            rescue CancellationError
+              break
+            rescue GRPC::BadStatus, StandardError => e
+              @transport.on_disconnect! if e.is_a?(GRPC::Unavailable) || e.is_a?(GRPC::DeadlineExceeded)
+              reconnect_attempts += 1
+              begin
+                if e.is_a?(GRPC::BadStatus)
+                  on_error&.call(ErrorMapper.map_grpc_error(e, operation: 'subscribe_events_store'))
+                else
+                  on_error&.call(Error.new(e.message, code: ErrorCode::STREAM_BROKEN))
+                end
+              rescue StandardError => cb_err
+                Kernel.warn("[kubemq] on_error callback raised: #{cb_err.message}")
+              end
+              delay = [@config.reconnect_policy.base_interval *
+                (@config.reconnect_policy.multiplier**(reconnect_attempts - 1)),
+                       @config.reconnect_policy.max_delay].min
+              sleep(delay) unless cancellation_token.cancelled?
+            end
+          end
+        rescue StandardError => e
+          Thread.current[:kubemq_subscription]&.mark_error(e)
+        ensure
+          begin; Thread.current[:grpc_call]&.cancel; rescue StandardError; end
+          Thread.current[:kubemq_subscription]&.mark_closed
+          @transport.unregister_subscription(Thread.current)
+        end
+      end
+
+      sub_wrapper = KubeMQ::Subscription.new(thread: thread, cancellation_token: cancellation_token)
+      thread[:kubemq_subscription] = sub_wrapper
+      sub_wrapper
+    end
+    # rubocop:enable Metrics/AbcSize, Metrics/MethodLength
+
+    # Closes the client, all open senders, and releases resources.
+    #
+    # Closes any {PubSub::EventSender} or {PubSub::EventStoreSender}
+    # instances created through this client before closing the transport.
+    # This method is idempotent.
+    #
+    # @return [void]
+    def close
+      senders_mutex.synchronize do
+        senders_list.each do |s|
+          s.close
+        rescue StandardError
+          nil
+        end
+        senders_list.clear
+      end
+      super
+    end
+
+    # Creates an events channel on the broker.
+    #
+    # @param channel_name [String] name for the new channel
+    # @return [Boolean] +true+ on success
+    # @raise [ClientClosedError] if the client has been closed
+    # @raise [ChannelError] if the broker rejects the operation
+    # @see BaseClient#create_channel
+    def create_events_channel(channel_name:)
+      create_channel(channel_name: channel_name, channel_type: ChannelType::EVENTS)
+    end
+
+    # Creates an events store channel on the broker.
+    #
+    # @param channel_name [String] name for the new channel
+    # @return [Boolean] +true+ on success
+    # @raise [ClientClosedError] if the client has been closed
+    # @raise [ChannelError] if the broker rejects the operation
+    # @see BaseClient#create_channel
+    def create_events_store_channel(channel_name:)
+      create_channel(channel_name: channel_name, channel_type: ChannelType::EVENTS_STORE)
+    end
+
+    # Deletes an events channel from the broker.
+    #
+    # @param channel_name [String] name of the channel to delete
+    # @return [Boolean] +true+ on success
+    # @raise [ClientClosedError] if the client has been closed
+    # @raise [ChannelError] if the broker rejects the operation
+    # @see BaseClient#delete_channel
+    def delete_events_channel(channel_name:)
+      delete_channel(channel_name: channel_name, channel_type: ChannelType::EVENTS)
+    end
+
+    # Deletes an events store channel from the broker.
+    #
+    # @param channel_name [String] name of the channel to delete
+    # @return [Boolean] +true+ on success
+    # @raise [ClientClosedError] if the client has been closed
+    # @raise [ChannelError] if the broker rejects the operation
+    # @see BaseClient#delete_channel
+    def delete_events_store_channel(channel_name:)
+      delete_channel(channel_name: channel_name, channel_type: ChannelType::EVENTS_STORE)
+    end
+
+    # Lists events channels, with optional name filtering.
+    #
+    # @param search [String, nil] substring filter for channel names
+    # @return [Array<ChannelInfo>] matching channels with metadata
+    # @raise [ClientClosedError] if the client has been closed
+    # @see BaseClient#list_channels
+    def list_events_channels(search: nil)
+      list_channels(channel_type: ChannelType::EVENTS, search: search)
+    end
+
+    # Lists events store channels, with optional name filtering.
+    #
+    # @param search [String, nil] substring filter for channel names
+    # @return [Array<ChannelInfo>] matching channels with metadata
+    # @raise [ClientClosedError] if the client has been closed
+    # @see BaseClient#list_channels
+    def list_events_store_channels(search: nil)
+      list_channels(channel_type: ChannelType::EVENTS_STORE, search: search)
+    end
+
+    private
+
+    def senders_list
+      @senders_list ||= []
+    end
+
+    def senders_mutex
+      @senders_mutex ||= Mutex.new
+    end
+  end
+end

data/lib/kubemq/pubsub/event_message.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+
+module KubeMQ
+  module PubSub
+    # Outbound event message for fire-and-forget pub/sub.
+    #
+    # Construct an +EventMessage+ and pass it to {PubSubClient#send_event}
+    # or {PubSub::EventSender#publish}. Events are not persisted — use
+    # {EventStoreMessage} for durable delivery.
+    #
+    # @example
+    #   msg = KubeMQ::PubSub::EventMessage.new(
+    #     channel: "notifications.email",
+    #     metadata: "user-signup",
+    #     body: '{"user_id": 42}',
+    #     tags: { "priority" => "high" }
+    #   )
+    #   result = client.send_event(msg)
+    #
+    # @see PubSubClient#send_event
+    # @see EventSender#publish
+    # @see EventStoreMessage
+    class EventMessage
+      # @!attribute [rw] id
+      #   @return [String] unique message identifier (auto-generated UUID if not provided)
+      # @!attribute [rw] channel
+      #   @return [String] target channel name
+      # @!attribute [rw] metadata
+      #   @return [String, nil] arbitrary metadata string
+      # @!attribute [rw] body
+      #   @return [String, nil] message payload (binary-safe)
+      # @!attribute [rw] tags
+      #   @return [Hash{String => String}] user-defined key-value tags
+      attr_accessor :id, :channel, :metadata, :body, :tags
+
+      # @param channel [String] target channel name (required)
+      # @param metadata [String, nil] arbitrary metadata
+      # @param body [String, nil] message payload
+      # @param tags [Hash{String => String}, nil] key-value tags (default: +{}+)
+      # @param id [String, nil] message ID (default: auto-generated UUID)
+      def initialize(channel:, metadata: nil, body: nil, tags: nil, id: nil)
+        @id = id || SecureRandom.uuid
+        @channel = channel
+        @metadata = metadata
+        @body = body
+        @tags = tags || {}
+      end
+    end
+  end
+end

data/lib/kubemq/pubsub/event_received.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module KubeMQ
+  module PubSub
+    # An event received from a pub/sub subscription.
+    #
+    # Delivered to the block passed to {PubSubClient#subscribe_to_events}.
+    # This is a read-only snapshot — modifying attributes has no effect
+    # on the broker.
+    #
+    # @see PubSubClient#subscribe_to_events
+    # @see EventsSubscription
+    class EventReceived
+      # @!attribute [r] id
+      #   @return [String] unique event identifier
+      # @!attribute [r] channel
+      #   @return [String] the channel the event was published to
+      # @!attribute [r] metadata
+      #   @return [String] event metadata
+      # @!attribute [r] body
+      #   @return [String] event payload (binary)
+      # @!attribute [r] timestamp
+      #   @return [Integer] broker-assigned timestamp (Unix nanoseconds)
+      # @!attribute [r] sequence
+      #   @return [Integer] broker-assigned sequence number
+      # @!attribute [r] tags
+      #   @return [Hash{String => String}] user-defined key-value tags
+      attr_reader :id, :channel, :metadata, :body, :timestamp, :sequence, :tags
+
+      # @param id [String] event identifier
+      # @param channel [String] source channel name
+      # @param metadata [String] event metadata
+      # @param body [String] event payload
+      # @param timestamp [Integer] broker timestamp (Unix nanoseconds)
+      # @param sequence [Integer] broker sequence number
+      # @param tags [Hash{String => String}, nil] key-value tags
+      def initialize(id:, channel:, metadata:, body:, timestamp:, sequence:, tags:)
+        @id = id
+        @channel = channel
+        @metadata = metadata
+        @body = body
+        @timestamp = timestamp
+        @sequence = sequence
+        @tags = tags || {}
+      end
+    end
+  end
+end