Broadcasts HawkEx business events through the host application's PubSub.

Events are only broadcast when config :hawk_ex, pubsub: is set. Without it, emit/2 and subscribe/0 are silent no-ops so the library can be used without Phoenix PubSub.

Topic

All events are broadcast on a single topic: "hawk_ex:events".

Subscribing

HawkEx.Events.subscribe()

# Then handle in a GenServer or LiveView:
def handle_info({HawkEx.Events, event, payload}, state) do
  ...
end

Event names

String dot-notation:

"subscription.created"
"subscription.canceled"
"subscription.plan_changed"

Payload

Each event carries a map with at minimum:

%{account_id: uuid, ...event-specific fields}