Squidie.Runtime.DispatchNotifier behaviour (squidie v0.1.2)

Boundary for live dispatch wakeups emitted after durable scheduling.

Wakeups are hints only. Durable dispatch entries remain the source of truth, so a notifier failure must not roll back or hide a scheduled attempt.

Summary

attempt()

Emits a live wakeup hint for a scheduled attempt through the configured notifier.

@type attempt() :: %{
  run_id: String.t(),
  runnable_key: String.t(),
  queue: String.t(),
  visible_at: DateTime.t()
}

@callback notify_attempt_scheduled(
  attempt(),
  keyword()
) :: :ok | {:error, term()}

@spec notify_attempt_scheduled(module(), attempt(), keyword()) ::
  :ok | {:error, term()}

Emits a live wakeup hint for a scheduled attempt through the configured notifier.