[GH-ISSUE #7180] Docs mismatch: scope type documented as string[]? but code expects string #19384

Closed
opened 2026-04-15 18:25:39 -05:00 by GiteaMirror · 2 comments
Owner

Originally created by @juliuslipp on GitHub (Jan 7, 2026).
Original GitHub issue: https://github.com/better-auth/better-auth/issues/7180

Description

The documentation for the OAuth Provider plugin incorrectly states the scope field type as string[]? (optional string array), while the actual implementation expects a string.

References

Originally created by @juliuslipp on GitHub (Jan 7, 2026). Original GitHub issue: https://github.com/better-auth/better-auth/issues/7180 ### Description The documentation for the OAuth Provider plugin incorrectly states the `scope` field type as `string[]?` (optional string array), while the actual implementation expects a `string`. ### References - **Documentation:** [`oauth-provider.mdx` L1496](https://github.com/better-auth/better-auth/blob/b057064e922d5d6f1c69ea2f20e1b73675d7eb7a/docs/content/docs/plugins/oauth-provider.mdx?plain=1#L1496) — shows `string[]?` - **Code:** [`schema.ts` L72](https://github.com/better-auth/better-auth/blob/b057064e922d5d6f1c69ea2f20e1b73675d7eb7a/packages/oauth-provider/src/schema.ts#L72) — expects `string`
GiteaMirror added the locked label 2026-04-15 18:25:39 -05:00
Author
Owner

@better-auth-agent[bot] commented on GitHub (Jan 7, 2026):

Thank you for raising the issue regarding the documentation mismatch on the scope field type in the OAuth Provider plugin. You're correct that the documentation states it as string[]? (optional string array), but the code actually expects it to be a string.

To proceed, I recommend submitting a pull request to update the documentation to align with the code implementation. This will help prevent confusion for users who rely on the documentation for configuration insights. If you're not sure how to draft that PR or if you need any further assistance, please feel free to tag @bekacru or @ping__, and they will be happy to assist you further.

What other details would you like to explore or clarify about the authentication framework or the specific implementation?

If you need more help, tag @better-auth-agent in a comment so I can respond.

DiagramDiscordGitHub

Diagram Join Star

<!-- gh-comment-id:3720448886 --> @better-auth-agent[bot] commented on GitHub (Jan 7, 2026): Thank you for raising the issue regarding the documentation mismatch on the `scope` field type in the OAuth Provider plugin. You're correct that the documentation states it as `string[]?` (optional string array), but the code actually expects it to be a `string`. To proceed, I recommend submitting a pull request to update the documentation to align with the code implementation. This will help prevent confusion for users who rely on the documentation for configuration insights. If you're not sure how to draft that PR or if you need any further assistance, please feel free to tag @bekacru or @ping__, and they will be happy to assist you further. What other details would you like to explore or clarify about the authentication framework or the specific implementation? _If you need more help, tag @better-auth-agent in a comment so I can respond._ <!-- bot:webhook reply v1 --> [Diagram](https://repodiagrams.s3.eu-north-1.amazonaws.com/skyvern_ultra_detailed_interactive.html) • [Discord](https://discord.gg/fG2XXEuQX3) • [GitHub](https://github.com/Skyvern-AI/Skyvern) [![Diagram](https://img.shields.io/badge/Diagram-2b3137?style=flat-square)](https://repodiagrams.s3.eu-north-1.amazonaws.com/skyvern_ultra_detailed_interactive.html) [![Join](https://img.shields.io/badge/join-5865F2?logo=discord&logoColor=white&style=flat-square)](https://discord.gg/fG2XXEuQX3) [![Star](https://img.shields.io/badge/star-181717?logo=github&logoColor=white&style=flat-square)](https://github.com/Skyvern-AI/Skyvern)
Author
Owner

@GautamBytes commented on GitHub (Jan 8, 2026):

Will fix it!

<!-- gh-comment-id:3722564308 --> @GautamBytes commented on GitHub (Jan 8, 2026): Will fix it!
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/better-auth#19384