# Autonoma Elixir SDK

Elixir implementation of the Autonoma Environment Factory SDK.

## Packages

| Package | Description |
|---------|-------------|
| `:autonoma` | Core protocol (HMAC, refs, graph, handler, schema) |
| `:autonoma_plug` | Plug server handler |

## Quick Start

### Install

Add to your `mix.exs` deps:

```elixir
defp deps do
  [
    {:autonoma, "~> 0.2"}
  ]
end
```

### Plug + Factories

```elixir
# In your router
factories = %{
  "Organization" => Autonoma.Factory.define(
    fn data, ctx ->
      org = MyApp.Repo.insert!(%MyApp.Organization{name: data["name"]})
      %{"id" => org.id, "name" => org.name}
    end,
    [%Autonoma.FieldInfo{name: "name", type: "string", is_required: true}],
    fn record, ctx ->
      MyApp.Repo.delete!(%MyApp.Organization{id: record["id"]})
    end
  )
}

config = %{
  scope_field: "organization_id",
  shared_secret: System.get_env("AUTONOMA_SHARED_SECRET"),
  signing_secret: System.get_env("AUTONOMA_SIGNING_SECRET"),
  factories: factories,
  auth: fn user, _context ->
    token = MyApp.Auth.create_session_token(user["id"])
    %{"headers" => %{"Authorization" => "Bearer #{token}"}}
  end
}

forward "/api/autonoma", Autonoma.Plug.Handler, config
```

## Commands

```bash
mix deps.get   # install dependencies
mix test        # run tests
```

## Documentation

For protocol-level documentation, see the root [`protocol/`](../../protocol/) directory. For a runnable example, see [`examples/elixir/phoenix-ecto/`](../../examples/elixir/phoenix-ecto/).