find_one: awaitable or not awaitable?

[guyzmo]

In the documentation here's how find_one is being used:

[Finding single documents)[https://beanie-odm.dev/tutorial/finding-documents/#finding-single-documents]

bar = await Product.find_one(Product.name == "Peanut Bar")

But when I look at the API documentation it is not explicitely awaitable:

def find_one(
…
) -> Union["FindOne[FindQueryResultType]", "FindOne[FindQueryProjectionType]"]

But when you dig the source code, you see that the FindOne class is actually implementing the __await__ method:

def __await__(
        self,
    ) -> Generator[Coroutine, Any, Optional[FindQueryResultType]]:

So it is actually awaitable!

Buuuuut… In documents.py there are some calls that are not awaited:

        return await self.find_one({"_id": self.id}).delete(
            session=session, bulk_writer=bulk_writer, **pymongo_kwargs
        )

My goal is to wrap Documents to expose a clean and fully typed interface, but the find_one method feels completely messy: why is it not always awaitable? And in what circumstances can it be called without being awaitable?

Can I wrap the find_one method to include the # type: ignore pragma in one place (until #1050 is done), so it is always async?