feat: find user by email address

[JKFSOM]

What kind of change does this PR introduce?

Feature: find user by their email address.

What is the current behaviour?

Users cannot be found via their email address.

What is the new behaviour?

Users can be found via their email address using a new endpoint: GET /admin/users/find.

The new endpoint also supports returning a user by ID. Whilst it's already possible to return a user by their ID (GET /admin/users/{userId}/), owing to the structure of the endpoint, it cannot cleanly be extended to handle email (and likely telephone numbers in the future). It is logical that /find also services user IDs, and therefore it has been added.

/admin/users/{userId}/ remains to prevent breaking changes.

Additional context

https://github.com/orgs/supabase/discussions/19315#discussioncomment-7712527

[JKFSOM]

@kangmingtay do you have any information on whether this will be reviewed?

[kangmingtay]

hi @JKFSOM, thanks for taking the time to contribute but i don't think we'll be adding this endpoint in - the GET /admin/users endpoint actually allows you to filter for a user's email address already:

for example:

curl -X GET "http://localhost:9999/admin/users?filter=<user_email_address>" -H "Authorization: Bearer ADMIN_JWT"