ExSwan.Plug.CeremonyStore behaviour (exswan_plug v0.1.0)

Storage contract for expiring, single-use WebAuthn ceremony state.

consume/2 must atomically remove and return a live entry. Concurrent consumers must never both receive the same ceremony.

Summary

ceremony()

Serializable server-only ceremony state.

context()

Adapter-specific process, connection, or namespace.

error()

token()

Opaque, caller-visible lookup token.

Atomically removes and returns a live ceremony.

Stores ceremony state until the monotonic deadline in milliseconds.

@type ceremony() :: term()

Serializable server-only ceremony state.

@type context() :: term()

Adapter-specific process, connection, or namespace.

@type error() :: :not_found | :expired | term()

@type token() :: String.t()

Opaque, caller-visible lookup token.

@callback consume(context(), token(), integer()) :: {:ok, ceremony()} | {:error, error()}

Atomically removes and returns a live ceremony.

@callback put(context(), token(), ceremony(), integer()) :: :ok | {:error, term()}

Stores ceremony state until the monotonic deadline in milliseconds.