# `Pixir.Provider.OpenResponsesSchema`
[🔗](https://github.com/Ranvier-Technologies/pixir/blob/main/lib/pixir/provider/open_responses_schema.ex#L1)

Total, bounded validator for the pinned Open Responses HTTP/SSE event profile.

Schemas are compiled into `OpenResponsesSchema.Generated`; validation never reads a
file, resolves an external reference, parses a schema, or performs network I/O at
runtime. Each schema/instance evaluation consumes the frozen event budget, including
union branches. Draft 2020-12 integer semantics include decoded integral floats such
as `1.0` and `-0.0`; local policy may constrain their value after schema validation.
Diagnostics are fixed atoms and never retain Provider values.

# `reason`

```elixir
@type reason() :: :invalid_event_shape | :validation_budget_exceeded
```

A fixed validation failure safe for Provider diagnostics.

# `validate`

```elixir
@spec validate(String.t(), term()) :: :ok | {:error, reason()}
```

Validate one decoded known event against its generated pinned root schema.

---

*Consult [api-reference.md](api-reference.md) for complete listing*