host/com.erfangholami.androidsolidservices.host.authorize/AuthorizeProtocol

AuthorizeProtocol

The host's half of the SolidAuthorization Intent protocol.

A consent activity reads the request with requestFrom, lets the user decide, resolves what they approved into entries with entriesFor, and finishes with one of the three results. The SDK's AuthorizeWithSolid contract is the other half.

Functions

cancelledResult

fun cancelledResult(): AuthorizeResult

RESULT_CANCELED: the user dismissed without granting.

entriesFor

fun entriesFor(request: AccessRequest, storageRoots: List<String>): List<GrantEntry>

The entries a request becomes once the account is known: the whole pod, each path resolved against every storage root in storageRoots, and each module. Paths that cannot be placed are dropped, and duplicates collapse.

errorResult

fun errorResult(code: Int, message: String): AuthorizeResult

RESULT_ERROR with an ExceptionsErrorCode value and a message.

grantedResult

fun grantedResult(webId: String, grant: AppGrant): AuthorizeResult

RESULT_OK with the chosen WebID and the grant the user approved.

requestFrom

fun requestFrom(intent: Intent?): AccessRequest

The request the calling app sent, or AccessRequest.DEFAULT when it sent none.