Configuration for running Statifier effects on a host-supplied Oban instance.

Per ADR-0002, this package never owns, starts, or names an Oban instance: the host supplies its own instance's name and every public entry point in this package takes it from here. There is no default - not even Oban's own default name Oban - so a missing instance is a configuration error at the call site, never a silent fallback into whatever instance happens to be running.

Queues are the host's for the same reason (ADR-0002 fixes instance ownership and says each job kind's queue travels here as a further field). :timers_queue names the host queue that delayed-send timer jobs target; it is required with no default, so a job never falls back silently into a host's :default queue.

:invoke_queue names the host queue that invoke-handler jobs (StatifierOban.Invoke.Worker) target. It is optional because a timers-only host has no invoke jobs to queue - but it has no default either: a host whose handlers are built on StatifierOban.Invoke.Handler gets {:error, {:missing_option, :invoke_queue}} from the first perform/2 rather than a silent fallback queue.

The delivery seams are the options with defaults, and each default is a documented choice rather than a fallback: :delivery (the run-liveness seam fired timers go through, StatifierOban.Timer.Delivery) and :invoke_delivery (the seam a completed invoke's done.invoke goes through, StatifierOban.Invoke.Delivery) both default to their Statifier.Session-backed check, which is correct for any host running sessions with the session id as scope. A host answering liveness from its own run store supplies its implementations here.

Examples

iex> StatifierOban.Config.new(oban: MyApp.Oban, timers_queue: :statifier_timers)
{:ok, %StatifierOban.Config{oban: MyApp.Oban, timers_queue: :statifier_timers}}

iex> StatifierOban.Config.new(oban: MyApp.Oban)
{:error, {:missing_option, :timers_queue}}

iex> StatifierOban.Config.new([])
{:error, {:missing_option, :oban}}

iex> StatifierOban.Config.new(oban: MyApp.Oban, timers_queue: :t, queue: :timers)
{:error, {:unknown_options, [:queue]}}

iex> StatifierOban.Config.new(oban: MyApp.Oban, timers_queue: :t, delivery: MyApp.RunStore)
{:ok, %StatifierOban.Config{oban: MyApp.Oban, timers_queue: :t, delivery: MyApp.RunStore}}

iex> StatifierOban.Config.new(oban: MyApp.Oban, timers_queue: :t, delivery: "MyApp.RunStore")
{:error, {:invalid_option, :delivery, "MyApp.RunStore"}}

iex> StatifierOban.Config.new(oban: MyApp.Oban, timers_queue: :t, invoke_queue: :statifier_invokes)
{:ok, %StatifierOban.Config{oban: MyApp.Oban, timers_queue: :t, invoke_queue: :statifier_invokes}}

iex> StatifierOban.Config.new(oban: MyApp.Oban, timers_queue: :t, invoke_queue: 42)
{:error, {:invalid_option, :invoke_queue, 42}}