@callback complete(String.t(), map(), map()) :: {:ok, [String.t()]} | :unsupported

Returns URI template variable completion suggestions.

Return :unsupported when the resource does not expose completions for the given variable.

@callback description() :: String.t() | nil

Returns the description for the resource module.

@callback read(uri :: String.t(), context :: map()) ::
  {:reply, [map()], map()}
  | {:error,
     :not_found | {:forbidden, String.t()} | {:internal_error, String.t()}}

Reads a concrete resource URI.

Return {:error, :not_found} when the resource does not handle the URI.

@callback resources() :: [map()]

Returns concrete resources shown in resources/list.

@callback templates() :: [map()]

Returns URI templates shown in resources/templates/list.