event_store_client 1.4.8 → 2.0.0

data/lib/event_store_client/adapters/grpc/generated/status_pb.rb

@@ -0,0 +1,23 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: status.proto
+
+require 'google/protobuf'
+
+require 'google/protobuf/any_pb'
+require_relative 'code_pb'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("status.proto", :syntax => :proto3) do
+    add_message "google.rpc.Status" do
+      optional :code, :enum, 1, "google.rpc.Code"
+      optional :message, :string, 2
+      optional :details, :message, 3, "google.protobuf.Any"
+    end
+  end
+end
+
+module Google
+  module Rpc
+    Status = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.rpc.Status").msgclass
+  end
+end

data/lib/event_store_client/adapters/grpc/generated/streams_pb.rb

@@ -3,12 +3,14 @@
 
 require 'google/protobuf'
 
-require 'event_store_client/adapters/grpc/generated/shared_pb'
+require_relative 'shared_pb'
+require_relative 'status_pb'
+require 'google/protobuf/duration_pb'
+require 'google/protobuf/empty_pb'
+require 'google/protobuf/timestamp_pb'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("streams.proto", :syntax => :proto3) do
-    ### Read Request definition
-    #
     add_message "event_store.client.streams.ReadReq" do
       optional :options, :message, 1, "event_store.client.streams.ReadReq.Options"
     end
@@ -16,6 +18,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :read_direction, :enum, 3, "event_store.client.streams.ReadReq.Options.ReadDirection"
       optional :resolve_links, :bool, 4
       optional :uuid_option, :message, 9, "event_store.client.streams.ReadReq.Options.UUIDOption"
+      optional :control_option, :message, 10, "event_store.client.streams.ReadReq.Options.ControlOption"
       oneof :stream_option do
         optional :stream, :message, 1, "event_store.client.streams.ReadReq.Options.StreamOptions"
         optional :all, :message, 2, "event_store.client.streams.ReadReq.Options.AllOptions"
@@ -26,22 +29,22 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       end
       oneof :filter_option do
         optional :filter, :message, 7, "event_store.client.streams.ReadReq.Options.FilterOptions"
-        optional :no_filter, :message, 8, "event_store.client.shared.Empty"
+        optional :no_filter, :message, 8, "event_store.client.Empty"
       end
     end
     add_message "event_store.client.streams.ReadReq.Options.StreamOptions" do
-      optional :stream_identifier, :message, 1, "event_store.client.shared.StreamIdentifier"
+      optional :stream_identifier, :message, 1, "event_store.client.StreamIdentifier"
       oneof :revision_option do
         optional :revision, :uint64, 2
-        optional :start, :message, 3, "event_store.client.shared.Empty"
-        optional :end, :message, 4, "event_store.client.shared.Empty"
+        optional :start, :message, 3, "event_store.client.Empty"
+        optional :end, :message, 4, "event_store.client.Empty"
       end
     end
     add_message "event_store.client.streams.ReadReq.Options.AllOptions" do
       oneof :all_option do
         optional :position, :message, 1, "event_store.client.streams.ReadReq.Options.Position"
-        optional :start, :message, 2, "event_store.client.shared.Empty"
-        optional :end, :message, 3, "event_store.client.shared.Empty"
+        optional :start, :message, 2, "event_store.client.Empty"
+        optional :end, :message, 3, "event_store.client.Empty"
       end
     end
     add_message "event_store.client.streams.ReadReq.Options.SubscriptionOptions" do
@@ -58,7 +61,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       end
       oneof :window do
         optional :max, :uint32, 3
-        optional :count, :message, 4, "event_store.client.shared.Empty"
+        optional :count, :message, 4, "event_store.client.Empty"
       end
     end
     add_message "event_store.client.streams.ReadReq.Options.FilterOptions.Expression" do
@@ -67,23 +70,26 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     end
     add_message "event_store.client.streams.ReadReq.Options.UUIDOption" do
       oneof :content do
-        optional :structured, :message, 1, "event_store.client.shared.Empty"
-        optional :string, :message, 2, "event_store.client.shared.Empty"
+        optional :structured, :message, 1, "event_store.client.Empty"
+        optional :string, :message, 2, "event_store.client.Empty"
       end
     end
+    add_message "event_store.client.streams.ReadReq.Options.ControlOption" do
+      optional :compatibility, :uint32, 1
+    end
     add_enum "event_store.client.streams.ReadReq.Options.ReadDirection" do
       value :Forwards, 0
       value :Backwards, 1
     end
-
-    # Read Response definition
-    #
     add_message "event_store.client.streams.ReadResp" do
       oneof :content do
         optional :event, :message, 1, "event_store.client.streams.ReadResp.ReadEvent"
         optional :confirmation, :message, 2, "event_store.client.streams.ReadResp.SubscriptionConfirmation"
         optional :checkpoint, :message, 3, "event_store.client.streams.ReadResp.Checkpoint"
         optional :stream_not_found, :message, 4, "event_store.client.streams.ReadResp.StreamNotFound"
+        optional :first_stream_position, :uint64, 5
+        optional :last_stream_position, :uint64, 6
+        optional :last_all_stream_position, :message, 7, "event_store.client.AllStreamPosition"
       end
     end
     add_message "event_store.client.streams.ReadResp.ReadEvent" do
@@ -91,12 +97,12 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :link, :message, 2, "event_store.client.streams.ReadResp.ReadEvent.RecordedEvent"
       oneof :position do
         optional :commit_position, :uint64, 3
-        optional :no_position, :message, 4, "event_store.client.shared.Empty"
+        optional :no_position, :message, 4, "event_store.client.Empty"
       end
     end
     add_message "event_store.client.streams.ReadResp.ReadEvent.RecordedEvent" do
-      optional :id, :message, 1, "event_store.client.shared.UUID"
-      optional :stream_identifier, :message, 2, "event_store.client.shared.StreamIdentifier"
+      optional :id, :message, 1, "event_store.client.UUID"
+      optional :stream_identifier, :message, 2, "event_store.client.StreamIdentifier"
       optional :stream_revision, :uint64, 3
       optional :prepare_position, :uint64, 4
       optional :commit_position, :uint64, 5
@@ -112,38 +118,29 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :prepare_position, :uint64, 2
     end
     add_message "event_store.client.streams.ReadResp.StreamNotFound" do
-      optional :stream_identifier, :message, 1, "event_store.client.shared.StreamIdentifier"
+      optional :stream_identifier, :message, 1, "event_store.client.StreamIdentifier"
     end
-
-    # Append to stream request
-    #
     add_message "event_store.client.streams.AppendReq" do
       oneof :content do
         optional :options, :message, 1, "event_store.client.streams.AppendReq.Options"
         optional :proposed_message, :message, 2, "event_store.client.streams.AppendReq.ProposedMessage"
       end
     end
-    # first send options message with info to which stream to append
-    # then send the proposed message to the last options request.
-    #
     add_message "event_store.client.streams.AppendReq.Options" do
-      optional :stream_identifier, :message, 1, "event_store.client.shared.StreamIdentifier"
+      optional :stream_identifier, :message, 1, "event_store.client.StreamIdentifier"
       oneof :expected_stream_revision do
         optional :revision, :uint64, 2
-        optional :no_stream, :message, 3, "event_store.client.shared.Empty"
-        optional :any, :message, 4, "event_store.client.shared.Empty"
-        optional :stream_exists, :message, 5, "event_store.client.shared.Empty"
+        optional :no_stream, :message, 3, "event_store.client.Empty"
+        optional :any, :message, 4, "event_store.client.Empty"
+        optional :stream_exists, :message, 5, "event_store.client.Empty"
       end
     end
     add_message "event_store.client.streams.AppendReq.ProposedMessage" do
-      optional :id, :message, 1, "event_store.client.shared.UUID"
+      optional :id, :message, 1, "event_store.client.UUID"
       map :metadata, :string, :string, 2
       optional :custom_metadata, :bytes, 3
       optional :data, :bytes, 4
     end
-
-    # Append to stream response
-    #
     add_message "event_store.client.streams.AppendResp" do
       oneof :result do
         optional :success, :message, 1, "event_store.client.streams.AppendResp.Success"
@@ -157,84 +154,121 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "event_store.client.streams.AppendResp.Success" do
       oneof :current_revision_option do
         optional :current_revision, :uint64, 1
-        optional :no_stream, :message, 2, "event_store.client.shared.Empty"
+        optional :no_stream, :message, 2, "event_store.client.Empty"
       end
       oneof :position_option do
         optional :position, :message, 3, "event_store.client.streams.AppendResp.Position"
-        optional :no_position, :message, 4, "event_store.client.shared.Empty"
+        optional :no_position, :message, 4, "event_store.client.Empty"
       end
     end
     add_message "event_store.client.streams.AppendResp.WrongExpectedVersion" do
       oneof :current_revision_option_20_6_0 do
         optional :current_revision_20_6_0, :uint64, 1
-        optional :no_stream_20_6_0, :message, 2, "event_store.client.shared.Empty"
+        optional :no_stream_20_6_0, :message, 2, "event_store.client.Empty"
       end
       oneof :expected_revision_option_20_6_0 do
         optional :expected_revision_20_6_0, :uint64, 3
-        optional :any_20_6_0, :message, 4, "event_store.client.shared.Empty"
-        optional :stream_exists_20_6_0, :message, 5, "event_store.client.shared.Empty"
+        optional :any_20_6_0, :message, 4, "event_store.client.Empty"
+        optional :stream_exists_20_6_0, :message, 5, "event_store.client.Empty"
       end
       oneof :current_revision_option do
         optional :current_revision, :uint64, 6
-        optional :current_no_stream, :message, 7, "event_store.client.shared.Empty"
+        optional :current_no_stream, :message, 7, "event_store.client.Empty"
       end
       oneof :expected_revision_option do
         optional :expected_revision, :uint64, 8
-        optional :expected_any, :message, 9, "event_store.client.shared.Empty"
-        optional :expected_stream_exists, :message, 10, "event_store.client.shared.Empty"
-        optional :expected_no_stream, :message, 11, "event_store.client.shared.Empty"
+        optional :expected_any, :message, 9, "event_store.client.Empty"
+        optional :expected_stream_exists, :message, 10, "event_store.client.Empty"
+        optional :expected_no_stream, :message, 11, "event_store.client.Empty"
+      end
+    end
+    add_message "event_store.client.streams.BatchAppendReq" do
+      optional :correlation_id, :message, 1, "event_store.client.UUID"
+      optional :options, :message, 2, "event_store.client.streams.BatchAppendReq.Options"
+      repeated :proposed_messages, :message, 3, "event_store.client.streams.BatchAppendReq.ProposedMessage"
+      optional :is_final, :bool, 4
+    end
+    add_message "event_store.client.streams.BatchAppendReq.Options" do
+      optional :stream_identifier, :message, 1, "event_store.client.StreamIdentifier"
+      oneof :expected_stream_position do
+        optional :stream_position, :uint64, 2
+        optional :no_stream, :message, 3, "google.protobuf.Empty"
+        optional :any, :message, 4, "google.protobuf.Empty"
+        optional :stream_exists, :message, 5, "google.protobuf.Empty"
+      end
+      oneof :deadline_option do
+        optional :deadline_21_10_0, :message, 6, "google.protobuf.Timestamp"
+        optional :deadline, :message, 7, "google.protobuf.Duration"
+      end
+    end
+    add_message "event_store.client.streams.BatchAppendReq.ProposedMessage" do
+      optional :id, :message, 1, "event_store.client.UUID"
+      map :metadata, :string, :string, 2
+      optional :custom_metadata, :bytes, 3
+      optional :data, :bytes, 4
+    end
+    add_message "event_store.client.streams.BatchAppendResp" do
+      optional :correlation_id, :message, 1, "event_store.client.UUID"
+      optional :stream_identifier, :message, 4, "event_store.client.StreamIdentifier"
+      oneof :result do
+        optional :error, :message, 2, "google.rpc.Status"
+        optional :success, :message, 3, "event_store.client.streams.BatchAppendResp.Success"
+      end
+      oneof :expected_stream_position do
+        optional :stream_position, :uint64, 5
+        optional :no_stream, :message, 6, "google.protobuf.Empty"
+        optional :any, :message, 7, "google.protobuf.Empty"
+        optional :stream_exists, :message, 8, "google.protobuf.Empty"
+      end
+    end
+    add_message "event_store.client.streams.BatchAppendResp.Success" do
+      oneof :current_revision_option do
+        optional :current_revision, :uint64, 1
+        optional :no_stream, :message, 2, "google.protobuf.Empty"
+      end
+      oneof :position_option do
+        optional :position, :message, 3, "event_store.client.AllStreamPosition"
+        optional :no_position, :message, 4, "google.protobuf.Empty"
       end
     end
-
-    # Delete stream request
-    #
     add_message "event_store.client.streams.DeleteReq" do
       optional :options, :message, 1, "event_store.client.streams.DeleteReq.Options"
     end
     add_message "event_store.client.streams.DeleteReq.Options" do
-      optional :stream_identifier, :message, 1, "event_store.client.shared.StreamIdentifier"
+      optional :stream_identifier, :message, 1, "event_store.client.StreamIdentifier"
       oneof :expected_stream_revision do
         optional :revision, :uint64, 2
-        optional :no_stream, :message, 3, "event_store.client.shared.Empty"
-        optional :any, :message, 4, "event_store.client.shared.Empty"
-        optional :stream_exists, :message, 5, "event_store.client.shared.Empty"
+        optional :no_stream, :message, 3, "event_store.client.Empty"
+        optional :any, :message, 4, "event_store.client.Empty"
+        optional :stream_exists, :message, 5, "event_store.client.Empty"
       end
     end
-
-    # Delete stream response
-    #
     add_message "event_store.client.streams.DeleteResp" do
       oneof :position_option do
         optional :position, :message, 1, "event_store.client.streams.DeleteResp.Position"
-        optional :no_position, :message, 2, "event_store.client.shared.Empty"
+        optional :no_position, :message, 2, "event_store.client.Empty"
       end
     end
     add_message "event_store.client.streams.DeleteResp.Position" do
       optional :commit_position, :uint64, 1
       optional :prepare_position, :uint64, 2
     end
-
-    # Tombstone stream request
-    #
     add_message "event_store.client.streams.TombstoneReq" do
       optional :options, :message, 1, "event_store.client.streams.TombstoneReq.Options"
     end
     add_message "event_store.client.streams.TombstoneReq.Options" do
-      optional :stream_identifier, :message, 1, "event_store.client.shared.StreamIdentifier"
+      optional :stream_identifier, :message, 1, "event_store.client.StreamIdentifier"
       oneof :expected_stream_revision do
         optional :revision, :uint64, 2
-        optional :no_stream, :message, 3, "event_store.client.shared.Empty"
-        optional :any, :message, 4, "event_store.client.shared.Empty"
-        optional :stream_exists, :message, 5, "event_store.client.shared.Empty"
+        optional :no_stream, :message, 3, "event_store.client.Empty"
+        optional :any, :message, 4, "event_store.client.Empty"
+        optional :stream_exists, :message, 5, "event_store.client.Empty"
       end
     end
-
-    # Tombstone stream response
-    #
     add_message "event_store.client.streams.TombstoneResp" do
       oneof :position_option do
         optional :position, :message, 1, "event_store.client.streams.TombstoneResp.Position"
-        optional :no_position, :message, 2, "event_store.client.shared.Empty"
+        optional :no_position, :message, 2, "event_store.client.Empty"
       end
     end
     add_message "event_store.client.streams.TombstoneResp.Position" do
@@ -256,6 +290,7 @@ module EventStore
       ReadReq::Options::FilterOptions = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.ReadReq.Options.FilterOptions").msgclass
       ReadReq::Options::FilterOptions::Expression = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.ReadReq.Options.FilterOptions.Expression").msgclass
       ReadReq::Options::UUIDOption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.ReadReq.Options.UUIDOption").msgclass
+      ReadReq::Options::ControlOption = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.ReadReq.Options.ControlOption").msgclass
       ReadReq::Options::ReadDirection = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.ReadReq.Options.ReadDirection").enummodule
       ReadResp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.ReadResp").msgclass
       ReadResp::ReadEvent = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.ReadResp.ReadEvent").msgclass
@@ -270,6 +305,11 @@ module EventStore
       AppendResp::Position = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.AppendResp.Position").msgclass
       AppendResp::Success = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.AppendResp.Success").msgclass
       AppendResp::WrongExpectedVersion = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.AppendResp.WrongExpectedVersion").msgclass
+      BatchAppendReq = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.BatchAppendReq").msgclass
+      BatchAppendReq::Options = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.BatchAppendReq.Options").msgclass
+      BatchAppendReq::ProposedMessage = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.BatchAppendReq.ProposedMessage").msgclass
+      BatchAppendResp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.BatchAppendResp").msgclass
+      BatchAppendResp::Success = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.BatchAppendResp.Success").msgclass
       DeleteReq = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.DeleteReq").msgclass
       DeleteReq::Options = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.DeleteReq.Options").msgclass
       DeleteResp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.streams.DeleteResp").msgclass

data/lib/event_store_client/adapters/grpc/generated/streams_services_pb.rb

@@ -2,7 +2,7 @@
 # Source: streams.proto for package 'event_store.client.streams'
 
 require 'grpc'
-require 'event_store_client/adapters/grpc/generated/streams_pb'
+require_relative 'streams_pb'
 
 module EventStore
   module Client
@@ -10,7 +10,7 @@ module EventStore
       module Streams
         class Service
 
-          include GRPC::GenericService
+          include ::GRPC::GenericService
 
           self.marshal_class_method = :encode
           self.unmarshal_class_method = :decode
@@ -20,6 +20,7 @@ module EventStore
           rpc :Append, stream(::EventStore::Client::Streams::AppendReq), ::EventStore::Client::Streams::AppendResp
           rpc :Delete, ::EventStore::Client::Streams::DeleteReq, ::EventStore::Client::Streams::DeleteResp
           rpc :Tombstone, ::EventStore::Client::Streams::TombstoneReq, ::EventStore::Client::Streams::TombstoneResp
+          rpc :BatchAppend, stream(::EventStore::Client::Streams::BatchAppendReq), stream(::EventStore::Client::Streams::BatchAppendResp)
         end
 
         Stub = Service.rpc_stub_class

data/lib/event_store_client/adapters/grpc/generated/users_services_pb.rb

@@ -2,7 +2,7 @@
 # Source: users.proto for package 'event_store.client.users'
 
 require 'grpc'
-require 'users_pb'
+require_relative 'users_pb'
 
 module EventStore
   module Client
@@ -10,7 +10,7 @@ module EventStore
       module Users
         class Service
 
-          include GRPC::GenericService
+          include ::GRPC::GenericService
 
           self.marshal_class_method = :encode
           self.unmarshal_class_method = :decode

data/lib/event_store_client/adapters/grpc/options/streams/read_options.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+# rubocop:disable Metrics/AbcSize
+
+require 'event_store_client/adapters/grpc/generated/shared_pb'
+
+module EventStoreClient
+  module GRPC
+    module Options
+      module Streams
+        class ReadOptions
+          include Configuration
+
+          attr_reader :options, :stream_name
+          private :options, :stream_name
+
+          # @param stream_name [String]
+          # @param options [Hash]
+          # @option [String] :direction 'Forwards' or 'Backwards'
+          # @option [Integer] :max_count
+          # @option [Boolean] :resolve_link_tos
+          # @option [Symbol] :from_revision :start or :end. Works only for regular streams.
+          # @option [Integer] :from_revision revision number to start from. Remember, that all reads
+          #   are inclusive and all subscribes are exclusive. This means if you provide revision
+          #   number when reading from stream - the first event will be an event of revision number
+          #   you provided. And, when subscribing on stream - the first event will be an event next
+          #   to the event of revision number you provided. Works only for regular streams.
+          # @option [Symbol] :from_position :start or :end. Works only for $all streams.
+          # @option [Hash] :from_position provided a hash with either both :commit_position and
+          #   :prepare_position keys or with one of them to define the starting position. Remember,
+          #   that all reads are inclusive and all subscribes are exclusive. This means if you
+          #   provide position number when reading from stream - the first event will be an event of
+          #   position number you provided. And, when subscribing on stream - the first event will
+          #   be an event next to the event of position number you provided. Works only for $all
+          #   streams. Unlike :from_revision - :commit_position and :prepare_position should contain
+          #   values of existing event.
+          #   Example:
+          #     ```ruby
+          #     new('some-stream', from_position: { commit_position: 1024, prepare_position: 1024 })
+          #     ```
+          # @option [Hash] :filter see
+          #   {EventStoreClient::GRPC::Shared::Options::FilterOptions#initialize} for available
+          #   values
+          def initialize(stream_name, options)
+            @stream_name = stream_name
+            @options = options
+          end
+
+          # @return [Hash] see event_store.client.streams.ReadReq.Options for available options
+          def request_options
+            request_options = {}
+            request_options.merge!(
+              Shared::Options::StreamOptions.new(stream_name, options).request_options
+            )
+            request_options[:read_direction] = options[:direction]
+            request_options[:count] = options[:max_count] || config.per_page
+            request_options[:resolve_links] = options[:resolve_link_tos]
+            request_options.merge!(
+              Shared::Options::FilterOptions.new(options[:filter]).request_options
+            )
+            # This option means how event#id would look like in the response. If you provided
+            # :string key, then #id will be a normal UUID string. If you provided :structured
+            # key, then #id will be an instance of EventStore::Client::UUID::Structured class.
+            # Note: for some reason if you don't provide this option - the request hangs forever
+            # Examples:
+            #   <EventStore::Client::UUID::Structured:
+            #     most_significant_bits: 1266766466329758182,
+            #     least_significant_bits: -8366670759139390653>
+            #   <EventStore::Client::UUID: string: "f0e1771c-334b-4b8d-ad88-c2024ccbe141">
+            request_options[:uuid_option] = { string: EventStore::Client::Empty.new }
+            request_options
+          end
+        end
+      end
+    end
+  end
+end
+# rubocop:enable Metrics/AbcSize

data/lib/event_store_client/adapters/grpc/options/streams/write_options.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require 'event_store_client/adapters/grpc/generated/shared_pb'
+
+module EventStoreClient
+  module GRPC
+    module Options
+      module Streams
+        class WriteOptions
+          attr_reader :stream_name, :options
+          private :stream_name, :options
+
+          # @param stream_name [String]
+          # @param options [Hash]
+          # @option [Integer] :expected_revision
+          # @option [Symbol] :expected_revision either :any, :no_stream or :stream_exists
+          def initialize(stream_name, options)
+            @stream_name = stream_name
+            @options = options
+          end
+
+          # @return [Hash] see event_store.client.streams.AppendReq.Options for available options
+          def request_options
+            revision_opt =
+              case options[:expected_revision]
+              when :any, :no_stream, :stream_exists
+                { options[:expected_revision] => EventStore::Client::Empty.new }
+              when Integer
+                { revision: options[:expected_revision] }
+              else
+                { any: EventStore::Client::Empty.new }
+              end
+            revision_opt.merge(stream_identifier: { stream_name: stream_name })
+          end
+        end
+      end
+    end
+  end
+end

data/lib/event_store_client/adapters/grpc/shared/event_deserializer.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+# rubocop:disable Metrics/AbcSize
+
+module EventStoreClient
+  module GRPC
+    module Shared
+      class EventDeserializer
+        include Configuration
+
+        # @param raw_event [
+        #   Array<EventStore::Client::Streams::ReadResp::ReadEvent::RecordedEvent>,
+        #   Array<EventStore::Client::PersistentSubscriptions::ReadResp::ReadEvent::RecordedEvent>
+        # ]
+        # @param skip_decryption [Boolean]
+        # @return [EventStoreClient::DeserializedEvent]
+        def call(raw_event, skip_decryption: false)
+          data = normalize_serialized(raw_event.data)
+          custom_metadata = normalize_serialized(raw_event.custom_metadata)
+
+          metadata =
+            JSON.parse(custom_metadata).merge(raw_event.metadata.to_h).to_json
+
+          event = EventStoreClient::Event.new(
+            id: raw_event.id.string,
+            title: "#{raw_event.stream_revision}@#{raw_event.stream_identifier.stream_name}",
+            type: raw_event.metadata['type'],
+            data: data,
+            metadata: metadata,
+            stream_revision: raw_event.stream_revision,
+            commit_position: raw_event.commit_position,
+            prepare_position: raw_event.prepare_position,
+            stream_name: raw_event.stream_identifier.stream_name
+          )
+
+          config.mapper.deserialize(event, skip_decryption: skip_decryption)
+        end
+
+        private
+
+        # @param raw_data [String, nil]
+        # @return [String]
+        def normalize_serialized(raw_data)
+          return {}.to_json if raw_data.nil? || raw_data.empty?
+
+          raw_data
+        end
+      end
+    end
+  end
+end
+# rubocop:enable Metrics/AbcSize

data/lib/event_store_client/adapters/grpc/shared/options/filter_options.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require 'event_store_client/adapters/grpc/generated/shared_pb'
+
+module EventStoreClient
+  module GRPC
+    module Shared
+      module Options
+        class FilterOptions
+          attr_reader :options
+          private :options
+
+          # See event_store.client.streams.ReadReq.Options.FilterOptions in streams_pb.rb generated
+          # file for more info(for persisted subscription the structure is the same)
+          # @param filter_options [Hash, nil]
+          # @option [Integer] :checkpointIntervalMultiplier
+          # @option [Integer] :max
+          # @option [Boolean] :count
+          # @option [Hash] :stream_identifier filter events by stream name using Regexp or String.
+          #   Examples:
+          #   ```ruby
+          #   # Return events streams names of which end with number
+          #   new(stream_identifier: { regex: /.*\d$/.to_s })
+          #   # Return events streams names of which start from 'some-stream-1' or 'some-stream-2'
+          #   # strings
+          #   new(stream_identifier: { prefix: ['some-stream-1', 'some-stream-2'] })
+          #   ```
+          # @option [Hash] :event_type filter events by event name using Regexp or String.
+          #   Examples:
+          #   ```ruby
+          #   # Return events names of which end with number
+          #   new(event_type: { regex: /.*\d$/.to_s })
+          #   # Return events names of which start from 'some-event-1' or 'some-event-2'
+          #   # strings
+          #   new(event_type: { prefix: ['some-event-1', 'some-event-2'] })
+          #   ```
+          def initialize(filter_options)
+            @options = filter_options
+          end
+
+          # See :filter_option in persistent_pb.rb or in streams_pb.rb generated files
+          # @return [Hash]
+          def request_options
+            request_options = {}
+            case options
+            in { stream_identifier: { regex: String } } | { stream_identifier: { prefix: Array } } |
+              { event_type: { regex: String } } | { event_type: { prefix: Array } }
+              request_options[:filter] = options
+              add_window_options(request_options)
+            else
+              request_options[:no_filter] = EventStore::Client::Empty.new
+            end
+            request_options
+          end
+
+          private
+
+          # Define how frequently "checkpoint" event should be produced. Its value is calculated
+          # by multiplying max by checkpointIntervalMultiplier.
+          #   Example:
+          #     Given max 32 and multiplier 2 - "checkpoint" event will be produced on each
+          #     64' event
+          # These options are only useful when subscribing to the stream
+          # @return [void]
+          def add_window_options(request_options)
+            request_options[:filter][:max] ||= 100
+            if request_options[:filter][:count]
+              request_options[:filter][:count] = EventStore::Client::Empty.new
+            end
+            request_options[:filter][:checkpointIntervalMultiplier] ||= 1
+          end
+        end
+      end
+    end
+  end
+end