-spec build_nsinfo(#xmlNamespace{}, #xmlElement{}) -> #xmlElement{}.

-spec decode_authn_request(Doc :: string() | #xmlElement{}) ->
                        {ok, #saml_authnreq{}} |
                        {error, bad_issuer} |
                        {error, missing_consumer_location} |
                        {error, term()}.

-spec decode_logout_request(Doc :: string() | #xmlElement{}) ->
                         {ok, #saml_logout_request{}} | {error, bad_issuer} | {error, term()}.

-spec decode_logout_response(Doc :: string() | #xmlElement{}) ->
                          {ok, #saml_logout_request{}} | {error, bad_issuer} | {error, term()}.

-spec decode_sp_metadata(Doc :: string() | #xmlElement{}) -> {ok, #saml_sp_metadata{}} | {error, term()}.

-spec sign_xml(Xml :: #xmlDocument{}, Path :: string(), fun((xml_thing()) -> xml_thing())) ->
            {ok, #xmlDocument{}} | {error, term()}.

-spec to_xml(Data :: hund:saml_record()) -> #xmlElement{}.