@spec attach_reporter([option()]) :: {:ok, term()} | {:error, :missing_dependency}

Attach a TelemetryReporter handler with an explicit event list.

@spec attach_reporter(Pristine.Core.Context.t(), [option()]) ::
  {:ok, term()} | {:error, :missing_dependency}

Attach a TelemetryReporter handler.

When given a Context, this derives the event list from context.telemetry_events unless :events is supplied explicitly.

@spec context([option()]) :: Pristine.Core.Context.t()

Build a Foundation-backed Pristine.Core.Context.

Feature options are supplied at the top level:

• retry
• rate_limit
• circuit_breaker
• telemetry
• admission_control

All other options are forwarded to Pristine.Core.Context.new/1.

@spec default_telemetry_events([atom()]) :: map()

Build the default structured telemetry event map for a namespace.

@spec detach_reporter(term()) ::
  :ok | {:error, :not_found} | {:error, :missing_dependency}

Detach a previously attached TelemetryReporter handler.

@spec reporter_child_spec([option()]) :: Supervisor.child_spec()

Convenience child spec for running a TelemetryReporter instance under supervision.

@spec reporter_events(Pristine.Core.Context.t()) :: [[atom()]]

Return the telemetry events that should be attached to a reporter for a context.

@spec start_reporter([option()]) ::
  GenServer.on_start() | {:error, :missing_dependency}

Start a TelemetryReporter instance directly.