An adapter for dispatching signals via HTTP requests using Erlang's built-in :httpc client.

This adapter implements the Jido.Signal.Dispatch.Adapter behaviour and provides functionality to send signals as HTTP requests to specified endpoints. It uses the built-in :httpc client to avoid external dependencies.

Configuration Options

• :url - (required) The URL to send the request to
• :method - (optional) HTTP method to use, one of [:post, :put, :patch], defaults to :post
• :headers - (optional) List of headers to include in the request
• :timeout - (optional) Request timeout in milliseconds, defaults to 5000
• :retry - (optional) Retry configuration map with keys:
  • :max_attempts - Maximum number of retry attempts (default: 3)
  • :base_delay - Base delay between retries in milliseconds (default: 1000)
  • :max_delay - Maximum delay between retries in milliseconds (default: 5000)

Examples

# Basic POST request
config = {:http, [
  url: "https://api.example.com/events",
]}

# Custom configuration
config = {:http, [
  url: "https://api.example.com/events",
  method: :put,
  headers: [{"content-type", "application/json"}, {"x-api-key", "secret"}],
  timeout: 10_000,
  retry: %{
    max_attempts: 5,
    base_delay: 2000,
    max_delay: 10000
  }
]}

Error Handling

The adapter handles these error conditions:

• :invalid_url - The URL is not valid
• :connection_error - Failed to establish connection
• :timeout - Request timed out
• :retry_failed - All retry attempts failed
• Other HTTP status codes and errors