prop/lib/microwaveprop_web/controllers/api/v1/token_json.ex
Graham McIntire c6d2c48264
feat: secure /api/v1 REST API for regular-user actions
Adds bearer-token authenticated REST API at /api/v1 covering every
action a non-admin user can perform on the website: contact + beacon
submission, beacon-monitor management, propagation queries, profile
read/update, and self-service API token issuance/revocation.

Security: SHA-256-hashed bearer tokens (mwp_ prefix, plaintext shown
once at creation), RFC 9457 problem+json error responses, RFC 9651
RateLimit-* headers backed by an ETS bucket (600/min per token,
60/min per anonymous IP, 30/min on /auth/tokens), private-contact
filtering by viewer.

Docs at docs/api/README.md (prose reference) and docs/api/openapi.yaml
(OpenAPI 3.1 spec covering every endpoint, response, and schema).

Tests: 124 new tests across schema, plug, error renderer, rate
limiter, fallback, and every controller. 16/17 API modules at 100%
line coverage; FallbackController at 87.5% (one defmodule line, an
Erlang-cover artifact for action_fallback-only modules).
2026-05-09 08:59:54 -05:00

29 lines
818 B
Elixir

defmodule MicrowavepropWeb.Api.V1.TokenJSON do
@moduledoc "Renders user API token responses."
alias Microwaveprop.Accounts.UserApiToken
@doc "Token list view (no plaintext — never recoverable after creation)."
def index(%{tokens: tokens}) do
%{data: Enum.map(tokens, &data/1)}
end
@doc "Single token without plaintext."
def show(%{token: token}), do: %{data: data(token)}
@doc "Single token including the one-time plaintext value at the top level."
def show_with_plaintext(%UserApiToken{} = token, plaintext) do
%{data: data(token), token: plaintext}
end
defp data(%UserApiToken{} = t) do
%{
id: t.id,
name: t.name,
inserted_at: t.inserted_at,
last_used_at: t.last_used_at,
expires_at: t.expires_at,
revoked_at: t.revoked_at
}
end
end