GeoGenius.EnqueueError exception (geo_genius v0.2.0)

Copy Markdown View Source

A structured failure to confirm an import runner enqueue.

:certainty distinguishes a definite pre-acceptance rejection from a call whose durable acceptance cannot be proved either way. :acceptance gives the same distinction in operational terms, while :guidance tells the caller how to inspect or safely redeliver the exact attempt.

Summary

Types

acceptance()

@type acceptance() :: :rejected | :unknown

certainty()

@type certainty() :: :not_enqueued | :outcome_unknown

t()

@type t() :: %GeoGenius.EnqueueError{
  __exception__: true,
  acceptance: acceptance(),
  certainty: certainty(),
  guidance: String.t(),
  message: String.t(),
  reason: term(),
  run_id: Ecto.UUID.t(),
  runner_backend: String.t(),
  terminalization: terminalization()
}

terminalization()

@type terminalization() ::
  :recorded_failed | :not_applicable | {:not_recorded, term()}