Make errors more usable

[Nevon]

Describe the feature request?

Currently the verifier throws generic instances of Error when verifying tokens. The only way to act on these errors is by looking at the error messages, which can of course change and are generally difficult to work with. The worst offender is the claims verifier, which returns a single error with each claim "error" string concatenated together.

I would suggest instead extending the Error class with your own Error classes, as you are doing for ConfigurationValidationError, so that we can disambiguate between different types of errors. For cases where you want to throw multiple errors, such as for the claims verifier, extend AggregateError and have the errors be instances of InvalidClaimError (or whatever you want to call that error).

New or Affected Resource(s)

I don't know what a resource is in this context...

Provide a documentation link

No response

Additional Information?

No response