An adapter for dispatching signals through Phoenix.PubSub.

This adapter implements the Jido.Signal.Dispatch.Adapter behaviour and provides functionality to broadcast signals through Phoenix.PubSub to all subscribers of a specific topic. It integrates with Phoenix's pub/sub system for distributed message broadcasting.

Configuration Options

• :target - (required) An atom specifying the PubSub server name
• :topic - (required) A string specifying the topic to broadcast on

Phoenix.PubSub Integration

The adapter uses Phoenix.PubSub.broadcast/3 to:

• Broadcast signals to all subscribers of a topic
• Handle distributed message delivery across nodes
• Manage subscription-based message routing

Examples

# Basic usage
config = {:pubsub, [
  target: :my_app_pubsub,
  topic: "events"
]}

# Using with specific event topics
config = {:pubsub, [
  target: :my_app_pubsub,
  topic: "user:123:events"
]}

Error Handling

The adapter handles these error conditions:

• :pubsub_not_found - The target PubSub server is not running
• Other errors from the Phoenix.PubSub system

Notes

• Ensure the PubSub server is started in your application supervision tree
• Topics can be any string, but consider using consistent naming patterns
• Messages are broadcast to all subscribers, so consider message volume