An adapter for dispatching signals to named processes in the Erlang registry.

This adapter implements the Jido.Signal.Dispatch.Adapter behaviour and provides functionality to send signals to processes registered under a name in the Erlang process registry. It supports both synchronous and asynchronous delivery modes.

Configuration Options

• :target - (required) A tuple of {:name, atom()} specifying the registered process name
• :delivery_mode - (optional) Either :sync or :async, defaults to :async
• :timeout - (optional) Timeout for synchronous delivery in milliseconds, defaults to 5000
• :message_format - (optional) Function to format the signal before sending, defaults to wrapping in {:signal, signal}

Delivery Modes

• :async - Uses send/2 to deliver the signal without waiting for a response
• :sync - Uses GenServer.call/3 to deliver the signal and wait for a response

Examples

# Asynchronous delivery to named process
config = {:named, [
  target: {:name, :my_process},
  delivery_mode: :async
]}

# Synchronous delivery with custom timeout
config = {:named, [
  target: {:name, :my_process},
  delivery_mode: :sync,
  timeout: 10_000
]}

# Custom message format
config = {:named, [
  target: {:name, :my_process},
  message_format: fn signal -> {:custom_signal, signal} end
]}

Error Handling

The adapter handles these error conditions:

• :process_not_found - The named process is not registered
• :process_not_alive - The process exists but is not alive
• :timeout - Synchronous delivery timed out
• Other errors from the target process