lib/actors/registry/actor_registry.ex

defmodule Actors.Registry.ActorRegistry do
  @moduledoc """
  The `ActorRegistry` module provides a registry for actor entities.

  It allows for registering and looking up actors and also provides
  methods for adding and removing invocation requests for actors.
  """

  use Retry

  require Logger

  alias Actors.Registry.{HostActor, LoadBalancer}
  alias Eigr.Functions.Protocol.Actors.{Actor, ActorId}
  alias Spawn.Cluster.StateHandoff.Manager, as: StateHandoff

  @doc """
  Register `member` entities to the ActorRegistry.
  Returns `Cluster` with all Host members.
  ## Examples
      iex> hosts = [%HostActor{node: Node.self(), actor: actor, opts: []}}]
      iex> ActorRegistry.register(hosts)
      :ok
  """
  @doc since: "0.1.0"
  @spec register(list(HostActor.t())) :: :ok
  def register(hosts) do
    Enum.each(hosts, fn host ->
      retry with: exponential_backoff() |> randomize |> expiry(10_000),
            atoms: [:error, :too_many_requests],
            rescue_only: [ErlangError] do
        try do
          StateHandoff.set(host.actor.id, host)
        rescue
          e ->
            Logger.error(
              "Error to register actor #{inspect(host.actor.id)} for host #{inspect(host)}: #{inspect(e)}"
            )

            reraise e, __STACKTRACE__
        end
      after
        result -> result
      else
        error -> error
      end
    end)
  end

  @doc """
  Fetch current entities of the service.
  Returns `HostActor` with Host and specific actor.
  """
  @doc since: "0.1.0"
  @spec lookup(ActorId.t(), Keyword.t()) :: {:ok, HostActor.t()} | {:not_found, []}
  def lookup(id, opts \\ []) do
    case StateHandoff.get(id) do
      nil ->
        {:not_found, []}

      state_hosts ->
        parent_name = Keyword.get(opts, :parent, nil)
        filter_by_parent? = Keyword.get(opts, :filter_by_parent, false)

        case filter(state_hosts, filter_by_parent?, id) do
          [] -> {:not_found, []}
          hosts -> choose_hosts(hosts, filter_by_parent?, id, parent_name)
        end
    end
  end

  @doc """
  Retrieves a list of hosts associated with a given actor.
  Parameters

  actor_id (%ActorId{}): The ID of the actor.
  opts (Keyword, optional): Options for the function.
      :parent (boolean): If true, filter hosts by parent; otherwise, filter by name.

  Returns

  {:ok, hosts}: A tuple with :ok and a list of hosts.
  {:not_found, []}: If no hosts are found.

  Examples

  ```elixir
  actor_id = %ActorId{parent: "parent", name: "name"}
  opts = [parent: true]
  {:ok, hosts} = Actors.Registry.ActorRegistry.get_hosts_by_actor(actor_id, opts)

  ```
  """
  @spec get_hosts_by_actor(ActorId.t(), Keyword.t()) :: {:ok, Member.t()} | {:not_found, []}
  def get_hosts_by_actor(
        %ActorId{parent: parent, name: name} = actor_id,
        opts \\ []
      ) do
    parent? = Keyword.get(opts, :parent, false)

    {id, actor_name} =
      if parent? do
        {%ActorId{actor_id | name: parent}, parent}
      else
        {actor_id, name}
      end

    case StateHandoff.get(id) do
      nil ->
        {:not_found, []}

      hosts ->
        Enum.filter(hosts, &(&1.actor.id.name == actor_name))
        |> then(fn
          [] -> {:not_found, []}
          hosts -> {:ok, hosts}
        end)
    end
  end

  # This version combines the conditions into a single expression for brevity while retaining the core logic.
  # It uses the && and || operators to express the conditions more succinctly.
  # It's important to note that this optimization sacrifices some readability for brevity.
  # As always, when prioritizing performance,
  defp filter(hosts, filter_by_parent?, %ActorId{name: actor_name, parent: parent_name}) do
    Enum.filter(hosts, fn ac ->
      (filter_by_parent? && ac.actor.id.parent == parent_name) ||
        (not filter_by_parent? && ac.actor.id.name == actor_name)
    end)
  end

  defp choose_hosts(hosts, filter_by_parent?, %ActorId{name: _actor_name} = _id, parent_name) do
    if filter_by_parent? do
      %HostActor{node: _node, actor: actor, opts: opts} = host = Enum.random(hosts)
      new_actor = %Actor{actor | id: %ActorId{actor.id | name: parent_name}}
      {:ok, %HostActor{host | actor: new_actor, opts: opts}}
    else
      case LoadBalancer.next_host(hosts) do
        {:ok, node_host, _updated_hosts} ->
          {:ok, node_host}

        _ ->
          {:not_found, []}
      end
    end
  end
end