Add new fields to API route context

[bluwy]

Changes

Add new site, generator, url, clientAddress, props and redirect fields to API route context to match closer to Astro global API.

Support second optional parameter status for redirect() (both api and Astro global).

Also fixes: #4920

Refactored internally to share types between Astro global too.

Testing

Added a test in ssr-api-routes.

Docs

Docs: withastro/docs#1731

Added links in jsdoc referencing the new docs.

[changeset-bot]

🦋 Changeset detected

Latest commit: 4118636

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

This PR is blocked because it contains a minor changeset. A reviewer will merge this at the next release if approved.

[matthewp]

Should also have:

• props Static APIRoutes can't receive props from getStaticPaths #4920
• redirect (assuming Response.redirect() requires a domain)

[bluwy]

This is ready for review 👍 Added the props and redirect fields, and updated the PR description.

[delucis]

Awesome work @bluwy! These are some really great quality-of-life improvements for API routes. Left some suggestions — I may have misunderstood some features so feel free to discard suggestions if they’re not correct.

[bluwy]

All great suggestions @delucis. Thanks!

Today is merge day