X-Git-Url: http://git.squeep.com/?p=squeep-indieauth-helper;a=blobdiff_plain;f=README.md;h=fe3e36296cee72e413ba9d4b382c4a24c0f1a0ba;hp=e2df28d1b7e24391845b58cbd588c4661d2d226c;hb=HEAD;hpb=cf9590ecbcd4b0a7c01f153cacade619518f84f0 diff --git a/README.md b/README.md index e2df28d..9a67a6d 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # IndieAuth Helper -Just some abstractions for interacting with IndieAuth sites, basically wrapping axios and mf2 parsing. +Just some abstractions for interacting with IndieAuth sites, basically wrapping `got` and `microformats-parser` mf2 parsing, performing various validations according to the specification, and some other fiddly bits. This is currently quite opinionated, and likely is only really useful in the context of Squeep Framework Applications. @@ -9,6 +9,9 @@ Notable methods on the Communication class: - `static async generatePKCE(length)` Create a code and verifier for use in an IndieAuth transaction. +- `async validateProfile(url)` + Check that a url meets specification requirements to be a profile. + - `async fetchProfile(urlObject)` Retrieve profile information from an endpoint. @@ -23,3 +26,15 @@ Notable methods on the Communication class: - `async fetchJSON(urlObject)` Retrieve json from an endpoint. + +- `async redeemCode(urlObj, code, codeVerifier, clientId, redirectURI)` + Submit a code to get a profile or ticket response. + +- `async introspectToken(introspectionUrlObj, authenticationHeader, token)` + Submit a token for introspection. + +- `async deliverTicket(ticketEndpointUrlObj, resourceUrlObj, subjectUrlObj, ticket)` + Submit a ticket offer. + +- `async redeemTicket(ticket, resourceUrlObj, issuerUrlObj)` + Exchange a ticket for an access token to the given resource.