# `Insider.Policy`
[🔗](https://github.com/hiivemarkets/insider/blob/v0.1.0/lib/insider/policy.ex#L1)

Pure capability discovery and deny-by-default runtime authorization.

Request identity and environment fields are claims. Only `Context` contains
trusted runtime facts and pre-verified grants.

# `audit`

```elixir
@spec audit(Insider.Policy.Decision.t(), Insider.Protocol.Result.t() | nil) :: map()
```

# `authorize`

```elixir
@spec authorize(Insider.Protocol.Request.t(), Insider.Policy.Context.t() | nil) ::
  {:ok, Insider.Policy.Decision.t()} | {:error, Insider.Protocol.Error.t()}
```

# `capabilities`

```elixir
@spec capabilities(Insider.Policy.Context.t()) :: [map()]
```

# `dispatchable?`

```elixir
@spec dispatchable?(Insider.Policy.Decision.t()) :: boolean()
```

Returns whether an allowed decision is still valid for immediate dispatch.

# `evaluate`

```elixir
@spec evaluate(Insider.Protocol.Request.t(), Insider.Policy.Context.t() | nil) ::
  Insider.Policy.Decision.t()
```

---

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