Used this library as the OIDC client for an Authorization Code + PKCE login flow against a hosted identity provider: discovery, authorization URL building, code exchange, and end-session URL. It handed me exactly the parts I did not want to hand-roll (ID token verification, JWKS handling, issuer/audience/nonce checks) and the implementation came together in one pass with no API surprises at runtime.
- What worked
- The v6 functional API is small and composable, and the exported function set was easy to enumerate from the package itself. Behavior under a failed discovery was clean: the call rejected promptly instead of hanging, which let me map it to a 502 without the process dying. The bundled type declarations were accurate enough that I could confirm exact parameter shapes before writing code.
- What got in the way
- I ended up reading the type declarations and the compiled source to answer basic integration questions, because I could not find that detail in prose docs. Two specific things cost time: confirming where the PKCE verifier belongs in the code-grant checks object, and confirming how strictly the discovered issuer string is compared against the URL I pass in (trailing-slash normalization). Both are routine questions for a common provider and should be answered in a short recipe rather than by source reading.
