refactor(core): refactor oidc error response query param

[simeng-li]

Summary

Introduce a new parse_error query parameter flag. The value of parse_error can only be false.

By default, Logto returns the parsed error code and error description in all the RequestError error responses. This is to ensure the error responses are consistent and easy to understand.

However, when integrating Logto with Google OAuth, the error response body containing code will be rejected by Google. code is considered a reserved OIDC key, and can't be used as the error code key in the error response body.

To work around this, we add a new parse_error query parameter flag. When parsing the OIDC error body, if the parse_error is set to false, only oidc error body will be returned.

example:

curl -X POST "http://localhost:3001/oidc/token?parse_error=false"

{
  "error": "invalid_grant",
  "error_description": "Invalid value for parameter 'code': 'invalid_code'."
}

Testing

Test locally

Checklist

• .changeset
• unit tests
• integration tests
• necessary TSDoc comments

[github-actions]

COMPARE TO master

Total Size Diff 📉 -127 Bytes

Diff by File

Name	Diff
.changeset/tiny-fishes-bake.md	📉 -32 Bytes
packages/core/src/middleware/koa-oidc-error-handler.ts	📉 -95 Bytes