feat: rewrite enumerated literals as Enums

[juancarlospaco]

What kind of change does this PR introduce?

• Rewrite enumerated string literals as actual Enums.

[grdsdev]

@juancarlospaco what's the benefits of using the StrEnum instead of Literal?

[juancarlospaco]

It can check if the value is in the range of the enum, for extra safety.
eg. Provider("INVALID") will complain etc.

Enum can be a more correct representation of "enumerated string values".

[silentworks]

I'm going to leave this PR parked as when I test it locally in my existing app which makes use of the literals for type hint it breaks the type checking. This is a big breaking change and should be done at the next major version change.

[silentworks]

Example of breaking changes:

# this is now broken because "provider" is expecting a enum class instance
resp = await supabase.auth.link_identity(
        {
            "provider": "google",
            "options": {"redirect_to": f"{request.base_url}auth/callback"},
        }
    )

now becomes

resp = await supabase.auth.link_identity(
        {
            "provider": Provider("google"),
            "options": {"redirect_to": f"{request.base_url}auth/callback"},
        }
    )

And a more full FastAPI function that uses hinting inside of the params

async def confirm(
    request: Request,
    token_hash: str,
    type: EmailOtpType = "email",
    supabase: AClient = Depends(create_supabase),
):
    try:
        if token_hash and type:
            if type == "recovery":
                request.session["password_update_required"] = True
            await supabase.auth.verify_otp(
                params={"token_hash": token_hash, "type": type}
            )

        return {"message": "User signed in successfully."}
 ...

now becomes

async def confirm(
   request: Request,
   token_hash: str,
   type: EmailOtpType | None = None,
   supabase: AClient = Depends(create_supabase),
):
   try:
       if not isinstance(type, EmailOtpType):
           type = EmailOtpType("email" if type is None else type)

       if token_hash and type:
           if type.value == "recovery":
               request.session["password_update_required"] = True
           await supabase.auth.verify_otp(
               params={"token_hash": token_hash, "type": type}
           )

       return {"message": "User signed in successfully."}
...

[juancarlospaco]

I agree with the parking, it can sleep for a while. 👍