defmodule MailKite do
  @moduledoc """
  The official MailKite library for Elixir — receive email as a webhook, send over
  a verified domain, and give an AI agent its own inbox.

  Build a client with `new/1` (or `MailKite.Client.new/1,2`) and call the API
  through `MailKite.Methods`:

      mk = MailKite.new(System.get_env("MAILKITE_API_KEY"))
      {:ok, res} = MailKite.Methods.send(mk, %{
        "from" => "hello@app.mailkite.dev",
        "to" => "ada@example.com",
        "subject" => "Hi",
        "text" => "It works."
      })

  Local helpers (no network call): `MailKite.Webhook` (verify signatures, reply
  bodies) and `MailKite.Crypto` (at-rest encrypt/decrypt).
  """

  @doc "Build a client. See `MailKite.Client.new/1`."
  defdelegate new(token_or_opts), to: MailKite.Client

  @doc "Build a client from a token and a custom base URL. See `MailKite.Client.new/2`."
  defdelegate new(token, base_url), to: MailKite.Client
end