event_store_client 0.2.8 → 1.0.0

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

@@ -0,0 +1,29 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: streams.proto for package 'event_store.client.streams'
+
+require 'grpc'
+require 'event_store_client/adapters/grpc/generated/streams_pb'
+
+module EventStore
+  module Client
+    module Streams
+      module Streams
+        class Service
+
+          include GRPC::GenericService
+
+          self.marshal_class_method = :encode
+          self.unmarshal_class_method = :decode
+          self.service_name = 'event_store.client.streams.Streams'
+
+          rpc :Read, ::EventStore::Client::Streams::ReadReq, stream(::EventStore::Client::Streams::ReadResp)
+          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
+        end
+
+        Stub = Service.rpc_stub_class
+      end
+    end
+  end
+end

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

@@ -0,0 +1,126 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: users.proto
+
+require 'google/protobuf'
+
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("users.proto", :syntax => :proto3) do
+    add_message "event_store.client.users.CreateReq" do
+      optional :options, :message, 1, "event_store.client.users.CreateReq.Options"
+    end
+    add_message "event_store.client.users.CreateReq.Options" do
+      optional :login_name, :string, 1
+      optional :password, :string, 2
+      optional :full_name, :string, 3
+      repeated :groups, :string, 4
+    end
+    add_message "event_store.client.users.CreateResp" do
+    end
+    add_message "event_store.client.users.UpdateReq" do
+      optional :options, :message, 1, "event_store.client.users.UpdateReq.Options"
+    end
+    add_message "event_store.client.users.UpdateReq.Options" do
+      optional :login_name, :string, 1
+      optional :password, :string, 2
+      optional :full_name, :string, 3
+      repeated :groups, :string, 4
+    end
+    add_message "event_store.client.users.UpdateResp" do
+    end
+    add_message "event_store.client.users.DeleteReq" do
+      optional :options, :message, 1, "event_store.client.users.DeleteReq.Options"
+    end
+    add_message "event_store.client.users.DeleteReq.Options" do
+      optional :login_name, :string, 1
+    end
+    add_message "event_store.client.users.DeleteResp" do
+    end
+    add_message "event_store.client.users.EnableReq" do
+      optional :options, :message, 1, "event_store.client.users.EnableReq.Options"
+    end
+    add_message "event_store.client.users.EnableReq.Options" do
+      optional :login_name, :string, 1
+    end
+    add_message "event_store.client.users.EnableResp" do
+    end
+    add_message "event_store.client.users.DisableReq" do
+      optional :options, :message, 1, "event_store.client.users.DisableReq.Options"
+    end
+    add_message "event_store.client.users.DisableReq.Options" do
+      optional :login_name, :string, 1
+    end
+    add_message "event_store.client.users.DisableResp" do
+    end
+    add_message "event_store.client.users.DetailsReq" do
+      optional :options, :message, 1, "event_store.client.users.DetailsReq.Options"
+    end
+    add_message "event_store.client.users.DetailsReq.Options" do
+      optional :login_name, :string, 1
+    end
+    add_message "event_store.client.users.DetailsResp" do
+      optional :user_details, :message, 1, "event_store.client.users.DetailsResp.UserDetails"
+    end
+    add_message "event_store.client.users.DetailsResp.UserDetails" do
+      optional :login_name, :string, 1
+      optional :full_name, :string, 2
+      repeated :groups, :string, 3
+      optional :last_updated, :message, 4, "event_store.client.users.DetailsResp.UserDetails.DateTime"
+      optional :disabled, :bool, 5
+    end
+    add_message "event_store.client.users.DetailsResp.UserDetails.DateTime" do
+      optional :ticks_since_epoch, :int64, 1
+    end
+    add_message "event_store.client.users.ChangePasswordReq" do
+      optional :options, :message, 1, "event_store.client.users.ChangePasswordReq.Options"
+    end
+    add_message "event_store.client.users.ChangePasswordReq.Options" do
+      optional :login_name, :string, 1
+      optional :current_password, :string, 2
+      optional :new_password, :string, 3
+    end
+    add_message "event_store.client.users.ChangePasswordResp" do
+    end
+    add_message "event_store.client.users.ResetPasswordReq" do
+      optional :options, :message, 1, "event_store.client.users.ResetPasswordReq.Options"
+    end
+    add_message "event_store.client.users.ResetPasswordReq.Options" do
+      optional :login_name, :string, 1
+      optional :new_password, :string, 2
+    end
+    add_message "event_store.client.users.ResetPasswordResp" do
+    end
+  end
+end
+
+module EventStore
+  module Client
+    module Users
+      CreateReq = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.CreateReq").msgclass
+      CreateReq::Options = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.CreateReq.Options").msgclass
+      CreateResp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.CreateResp").msgclass
+      UpdateReq = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.UpdateReq").msgclass
+      UpdateReq::Options = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.UpdateReq.Options").msgclass
+      UpdateResp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.UpdateResp").msgclass
+      DeleteReq = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.DeleteReq").msgclass
+      DeleteReq::Options = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.DeleteReq.Options").msgclass
+      DeleteResp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.DeleteResp").msgclass
+      EnableReq = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.EnableReq").msgclass
+      EnableReq::Options = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.EnableReq.Options").msgclass
+      EnableResp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.EnableResp").msgclass
+      DisableReq = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.DisableReq").msgclass
+      DisableReq::Options = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.DisableReq.Options").msgclass
+      DisableResp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.DisableResp").msgclass
+      DetailsReq = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.DetailsReq").msgclass
+      DetailsReq::Options = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.DetailsReq.Options").msgclass
+      DetailsResp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.DetailsResp").msgclass
+      DetailsResp::UserDetails = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.DetailsResp.UserDetails").msgclass
+      DetailsResp::UserDetails::DateTime = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.DetailsResp.UserDetails.DateTime").msgclass
+      ChangePasswordReq = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.ChangePasswordReq").msgclass
+      ChangePasswordReq::Options = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.ChangePasswordReq.Options").msgclass
+      ChangePasswordResp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.ChangePasswordResp").msgclass
+      ResetPasswordReq = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.ResetPasswordReq").msgclass
+      ResetPasswordReq::Options = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.ResetPasswordReq.Options").msgclass
+      ResetPasswordResp = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("event_store.client.users.ResetPasswordResp").msgclass
+    end
+  end
+end

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

@@ -0,0 +1,33 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: users.proto for package 'event_store.client.users'
+
+require 'grpc'
+require 'users_pb'
+
+module EventStore
+  module Client
+    module Users
+      module Users
+        class Service
+
+          include GRPC::GenericService
+
+          self.marshal_class_method = :encode
+          self.unmarshal_class_method = :decode
+          self.service_name = 'event_store.client.users.Users'
+
+          rpc :Create, ::EventStore::Client::Users::CreateReq, ::EventStore::Client::Users::CreateResp
+          rpc :Update, ::EventStore::Client::Users::UpdateReq, ::EventStore::Client::Users::UpdateResp
+          rpc :Delete, ::EventStore::Client::Users::DeleteReq, ::EventStore::Client::Users::DeleteResp
+          rpc :Disable, ::EventStore::Client::Users::DisableReq, ::EventStore::Client::Users::DisableResp
+          rpc :Enable, ::EventStore::Client::Users::EnableReq, ::EventStore::Client::Users::EnableResp
+          rpc :Details, ::EventStore::Client::Users::DetailsReq, stream(::EventStore::Client::Users::DetailsResp)
+          rpc :ChangePassword, ::EventStore::Client::Users::ChangePasswordReq, ::EventStore::Client::Users::ChangePasswordResp
+          rpc :ResetPassword, ::EventStore::Client::Users::ResetPasswordReq, ::EventStore::Client::Users::ResetPasswordResp
+        end
+
+        Stub = Service.rpc_stub_class
+      end
+    end
+  end
+end

data/lib/event_store_client/adapters/http.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require 'event_store_client/adapters/http/commands/command'
+
+require 'event_store_client/adapters/http/commands/persistent_subscriptions/create'
+require 'event_store_client/adapters/http/commands/persistent_subscriptions/read'
+
+require 'event_store_client/adapters/http/commands/projections/create'
+
+require 'event_store_client/adapters/http/commands/streams/append'
+require 'event_store_client/adapters/http/commands/streams/delete'
+require 'event_store_client/adapters/http/commands/streams/link_to'
+require 'event_store_client/adapters/http/commands/streams/read'
+require 'event_store_client/adapters/http/commands/streams/tombstone'
+
+require 'event_store_client/adapters/http/client'

data/lib/event_store_client/adapters/http/README.md

@@ -0,0 +1,16 @@
+### HTTP adapter
+
+This adapter targets the EventstoreDB version `>= "5.*"
+
+For detailed docs about the http protocol see [EventStoreDB Http Documentation](https://developers.eventstore.com/server/5.0.8/http-api/)
+
+### Configuration
+
+As by default EventStoreClient uses gRPC adapter, to switch to http you need to configure it first.
+Place the snippet below in your initializer or when you boot your application.
+
+```ruby
+EventStoreClient.configure do |config|
+  config.adapter = :api
+end
+```

data/lib/event_store_client/adapters/http/client.rb

@@ -0,0 +1,160 @@
+# frozen_string_literal: true
+
+require 'event_store_client/adapters/http/connection'
+require 'dry/monads/result'
+
+module EventStoreClient
+  module HTTP
+    class Client
+      include Configuration
+      include Dry::Monads[:result]
+      # Appends given events to the stream
+      # @param [String] Stream name to append events to
+      # @param [Array](each: EventStoreClient::DeserializedEvent) list of events to publish
+      # @return Dry::Monads::Result::Success or Dry::Monads::Result::Failure
+      #
+      def append_to_stream(stream_name, events, options: {})
+        Commands::Streams::Append.new(connection).call(
+          stream_name, events, options: options
+        )
+      end
+
+      # Softly deletes the given stream
+      # @param [String] Stream name to delete
+      # @param options [Hash] additional options to the request
+      # @return Dry::Monads::Result::Success or Dry::Monads::Result::Failure
+      #
+      def delete_stream(stream_name, options: {})
+        Commands::Streams::Delete.new(connection).call(
+          stream_name, options: options
+        )
+      end
+
+      # Completely removes the given stream
+      # @param [String] Stream name to delete
+      # @param options [Hash] additional options to the request
+      # @return Dry::Monads::Result::Success or Dry::Monads::Result::Failure
+      #
+      def tombstone_stream(stream_name, options: {})
+        Commands::Streams::Tombstone.new(connection).call(
+          stream_name, options: options
+        )
+      end
+
+      # Reads a page of events from the given stream
+      # @param [String] Stream name to read events from
+      # @param options [Hash] additional options to the request
+      # @return Dry::Monads::Result::Success with returned events or Dry::Monads::Result::Failure
+      #
+      def read(stream_name, options: {})
+        Commands::Streams::Read.new(connection).call(
+          stream_name, options: options
+        )
+      end
+
+      # Reads all events from the given stream
+      # @param [String] Stream name to read events from
+      # @param options [Hash] additional options to the request
+      # @return Dry::Monads::Result::Success with returned events or Dry::Monads::Result::Failure
+      #
+      def read_all_from_stream(stream_name, options: {})
+        start ||= options[:start] || 0
+        count ||= options[:count] || 20
+        events = []
+        failed_requests_count = 0
+
+        while failed_requests_count < 3
+          res = read(stream_name, options: options.merge(start: start, count: count))
+          if res.failure?
+            failed_requests_count += 1
+          else
+            break if res.value!.empty?
+            events += res.value!
+            failed_requests_count = 0
+            start += count
+          end
+        end
+        return Failure(:connection_failed) if failed_requests_count >= 3
+
+        Success(events)
+      end
+
+      # Creates the subscription for the given stream
+      # @param [EventStoreClient::Subscription] subscription to observe
+      # @param options [Hash] additional options to the request
+      # @return Dry::Monads::Result::Success or Dry::Monads::Result::Failure
+      #
+      def subscribe_to_stream(subscription, options: {})
+        join_streams(subscription.name, subscription.observed_streams)
+        Commands::PersistentSubscriptions::Create.new(connection).call(
+          subscription.stream,
+          subscription.name,
+          options: options
+        )
+      end
+
+      # Links given events with the given stream
+      # @param [String] Stream name to link events to
+      # @param [Array](each: EventStoreClient::DeserializedEvent) a list of events to link
+      # @param expected_version [Integer] expected number of events in the stream
+      # @return Dry::Monads::Result::Success or Dry::Monads::Result::Failure
+      #
+      def link_to(stream_name, events, options: {})
+        Commands::Streams::LinkTo.new(connection).call(
+          stream_name, events, options: options
+        )
+      end
+
+      # Runs the persistent subscription indeinitely
+      # @param [EventStoreClient::Subscription] subscription to observe
+      # @param options [Hash] additional options to the request
+      # @return - Nothing, it is a blocking operation, yields the given block with event instead
+      #
+      def listen(subscription, options: {})
+        loop do
+          begin
+            consume_feed(subscription) do |event|
+              yield event if block_given?
+            end
+          rescue StandardError => e
+            config.error_handler&.call(e)
+          end
+          sleep(options[:interval] || 5) # wait for events to be processed
+        end
+      end
+
+      private
+
+      attr_reader :connection
+
+      def initialize
+        @connection =
+          Connection.new(config.eventstore_url, ssl: { verify: config.verify_ssl })
+      end
+
+      # @api private
+      # Joins multiple streams into the new one under the given name
+      # @param [String] Name of the stream containing the ones to join
+      # @param [Array] (each: String) list of streams to join together
+      # @return Dry::Monads::Result::Success or Dry::Monads::Result::Failure
+      #
+      def join_streams(name, streams, options: {})
+        Commands::Projections::Create.new(connection).call(name, streams, options: options)
+      end
+
+      # @api private
+      # Consumes the new events from the subscription
+      # @param [EventStoreClient::Subscription] subscription to observe
+      # @param options [Hash] additional options to the request
+      # @return Dry::Monads::Result::Success or Dry::Monads::Result::Failure
+      #
+      def consume_feed(subscription, options: {})
+        Commands::PersistentSubscriptions::Read.new(connection).call(
+          subscription.stream, subscription.name, options: options
+        ) do |event|
+          yield event if block_given?
+        end
+      end
+    end
+  end
+end

data/lib/event_store_client/adapters/http/commands/command.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require 'dry-monads'
+require 'event_store_client/adapters/grpc/command_registrar'
+
+module EventStoreClient
+  module HTTP
+    module Commands
+      class Command
+        def self.inherited(klass)
+          super
+          klass.class_eval do
+            include Dry::Monads[:result]
+          end
+        end
+
+        protected
+
+        attr_reader :connection
+
+        def initialize(connection)
+          @connection = connection
+        end
+      end
+    end
+  end
+end

data/lib/event_store_client/adapters/http/commands/persistent_subscriptions/ack.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module EventStoreClient
+  module HTTP
+    module Commands
+      module PersistentSubscriptions
+        class Ack < Command
+          def call(url)
+            connection.call(:post, url)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/event_store_client/adapters/http/commands/persistent_subscriptions/create.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module EventStoreClient
+  module HTTP
+    module Commands
+      module PersistentSubscriptions
+        class Create < Command
+          def call(stream_name, subscription_name, options: {})
+            stats = options[:stats] || true
+            start = options[:start] || 0
+            retries = options[:retries] || 5
+
+            connection.call(
+              :put,
+              "/subscriptions/#{stream_name}/#{subscription_name}",
+              body: {
+                extraStatistics: stats,
+                startFrom: start,
+                maxRetryCount: retries,
+                resolveLinkTos: true
+              },
+              headers: {
+                'Content-Type' => 'application/json'
+              }
+            )
+          end
+        end
+      end
+    end
+  end
+end