Implement an API reference page

[infomiho]

We want to group all of the per-feature API references into one big API reference page.

If there is some API reference that doesn't belong into any feature page (unlikely) we can write it directly in the API references page.

Implementation

The way we can do it:

1. Wrap each API reference in a React compnent
2. Reuse the component in the feature page (e.g. Email API reference on the Email auth page)
3. Reuse the component in the API reference page

Something like this:

docs/
-- email.md <------ imports EmailAPIReference.jsx
-- EmailAPIReference.jsx
api/
-- api.md <------ imports EmailAPIReference.jsx

[cprecioso]

I was thinking about this, I think we can write a .d.ts file with our API reference (as a more natural representation of our JS api, and probably better for LLMs), and pass it through something like TypeDoc (example output). There are even plugins (link) that include TypeDoc into a Docusaurus site (example).

[Martinsos]

Related to #2519 .