# `Diffo.Unwrap`
[🔗](https://github.com/diffo-dev/diffo/blob/v0.9.0/lib/diffo/unwrap.ex#L5)

`Diffo.Unwrap` is a protocol for extracting the underlying Elixir value from Diffo and Ash
wrapper types. It is defined with `@fallback_to_any true`, so any value without an explicit
implementation is returned unchanged.

By convention, implementations are recursive — each one calls `Diffo.Unwrap.unwrap/1` on its
inner value, so nested wrappers are fully peeled in a single call.

Built-in implementations are provided for `Ash.Union`, `Ash.CiString`, `Ash.NotLoaded`,
`Diffo.Type.Primitive`, `Diffo.Type.Dynamic`, and `List`.

## Examples

Any plain Elixir value is returned as-is:

    iex> Diffo.Unwrap.unwrap(42)
    42

    iex> Diffo.Unwrap.unwrap("hello")
    "hello"

    iex> Diffo.Unwrap.unwrap(nil)
    nil

A `Diffo.Type.Primitive` unwraps to the raw value:

    iex> Diffo.Type.Primitive.wrap("integer", 7) |> Diffo.Unwrap.unwrap()
    7

An `Ash.Union` wrapping a `Diffo.Type.Primitive` unwraps recursively:

    iex> %Ash.Union{type: :integer, value: Diffo.Type.Primitive.wrap("integer", 7)}
    ...> |> Diffo.Unwrap.unwrap()
    7

A list of wrapped values is unwrapped element-by-element:

    iex> [Diffo.Type.Primitive.wrap("integer", 1), Diffo.Type.Primitive.wrap("integer", 2)]
    ...> |> Diffo.Unwrap.unwrap()
    [1, 2]

# `t`

```elixir
@type t() :: term()
```

All the types that implement this protocol.

# `unwrap`

---

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