Packages
ex_esdb
0.7.7
0.11.0
0.10.0
0.9.0
0.8.0
0.7.8
0.7.7
0.7.6
0.7.5
0.7.4
0.7.3
0.7.2
0.7.1
0.7.0
0.6.1
0.6.0
0.5.1
0.5.0
0.4.8
0.4.7
0.4.6
0.4.5
0.4.4
0.4.3
0.4.2
0.4.1
0.4.0
0.3.3
0.3.2
0.3.1
0.3.0
0.2.5
0.2.4
0.2.3
0.2.2
0.2.1
0.2.0
0.1.7
0.1.6
0.1.5
0.1.4
0.1.3
0.1.2
0.1.1
0.1.0
0.0.20
0.0.19
0.0.18
0.0.17
0.0.16
0.0.15
0.0.14-alpha
0.0.13-alpha
0.0.12-alpha
0.0.11-alpha
0.0.10-alpha
0.0.9-alpha
0.0.8-alpha
0.0.6-alpha
0.0.5-alpha
0.0.4-alpha
0.0.3-alpha
0.0.2-alfa
0.0.1-alfa
ExESDB is a reincarnation of rabbitmq/khepri, specialized for use as a BEAM-native event store.
Current section
Files
Jump to
Current section
Files
lib/ex_esdb/store.ex
defmodule ExESDB.Store do
@moduledoc """
A GenServer wrapper around :khepri to act as a distributed event store.
"""
use GenServer
require Logger
alias ExESDB.Themes, as: Themes
alias ExESDB.StoreNaming
defp start_khepri(opts) do
store = opts[:store_id]
timeout = opts[:timeout]
data_dir = opts[:data_dir]
:khepri.start(data_dir, store, timeout)
end
# Client API
@doc """
Get the current state of the store.
## Returns
- `{:ok, state}` if successful.
- `{:error, reason}` if unsuccessful.
"""
def get_state(store_id \\ nil),
do:
GenServer.call(
StoreNaming.genserver_name(__MODULE__, store_id),
{:get_state}
)
@doc """
Get the store-specific GenServer name.
This function returns the name used to register this store GenServer,
allowing multiple stores to run on the same node.
## Parameters
* `store_id` - The store identifier (optional)
## Examples
iex> ExESDB.Store.store_name("my_store")
{:ex_esdb_store, "my_store"}
iex> ExESDB.Store.store_name(nil)
ExESDB.Store
"""
def store_name(store_id), do: StoreNaming.genserver_name(__MODULE__, store_id)
## CALLBACKS
@impl true
def handle_call({:get_state}, _from, state) do
{:reply, {:ok, state}, state}
end
#### PLUMBING
def child_spec(opts) do
store_id = StoreNaming.extract_store_id(opts)
%{
id: StoreNaming.child_spec_id(__MODULE__, store_id),
start: {__MODULE__, :start_link, [opts]},
restart: :permanent,
shutdown: 10_000,
type: :worker
}
end
def start_link(opts) do
store_id = StoreNaming.extract_store_id(opts)
name = StoreNaming.genserver_name(__MODULE__, store_id)
GenServer.start_link(
__MODULE__,
opts,
name: name
)
end
# Server Callbacks
@impl true
def init(opts) do
IO.puts("#{Themes.store(self(), "is UP.")}")
Process.flag(:trap_exit, true)
case start_khepri(opts) do
{:ok, store} ->
{:ok, [config: opts, store: store]}
reason ->
Logger.error("Failed to start Khepri store. Reason: #{inspect(reason)}")
{:error, [config: opts, store: nil]}
end
end
@impl true
def terminate(reason, [config: opts, store: store]) do
IO.puts("#{Themes.store(self(), "⚠️ Shutting down gracefully. Reason: #{inspect(reason)}")}")
# Stop Khepri store gracefully if it was started
if store do
store_id = opts[:store_id]
case :khepri.stop(store_id) do
:ok -> :ok
{:error, reason} ->
Logger.warning("Failed to stop Khepri store #{inspect(store_id)}: #{inspect(reason)}")
other ->
Logger.warning("Unexpected response stopping Khepri store #{inspect(store_id)}: #{inspect(other)}")
end
end
:ok
end
def terminate(reason, _state) do
IO.puts("#{Themes.store(self(), "⚠️ Shutting down gracefully. Reason: #{inspect(reason)}")}")
:ok
end
end