# `Insider.Sentinel.Sandbox.Provider`
[🔗](https://github.com/hiivemarkets/insider/blob/v0.1.0/tools/insider_lab/lib/insider/sentinel/sandbox/provider.ex#L1)

Behaviour for trusted disposable-target adapters.

Providers must register every resource under `owner_id` before creating it,
make cleanup idempotent, and support cleanup by owner even when acquisition
did not return. Provider modules are trusted runtime configuration and must
never be selected by converting wire strings to atoms.

# `deadline`

```elixir
@type deadline() :: integer()
```

# `owner_id`

```elixir
@type owner_id() :: binary()
```

# `resource_reference`

```elixir
@type resource_reference() :: %{required(String.t()) =&gt; String.t()}
```

# `acquire`

```elixir
@callback acquire(owner_id(), Insider.Sentinel.Sandbox.Target.t(), deadline()) ::
  :ok | {:error, atom()}
```

# `cleanup`

```elixir
@callback cleanup(owner_id(), deadline()) :: :ok | {:error, atom()}
```

# `identity`

```elixir
@callback identity() :: map()
```

# `inventory`

```elixir
@callback inventory(owner_id(), deadline()) ::
  {:ok, [resource_reference()]} | {:error, atom()}
```

# `observe`

```elixir
@callback observe(owner_id(), deadline()) :: {:ok, map()} | {:error, atom()}
```

---

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