From 9bd22cca698588f4b24bc21acdc68c33cc2aca0e Mon Sep 17 00:00:00 2001
From: Reuben Tier <64310361+TheOtterlord@users.noreply.github.com>
Date: Wed, 17 Jan 2024 21:39:49 +0000
Subject: [PATCH] Revert "Adapter enhancements in Astro 4.2"

---
 .../docs/en/reference/adapter-reference.mdx   | 48 ++-----------------
 1 file changed, 4 insertions(+), 44 deletions(-)

diff --git a/src/content/docs/en/reference/adapter-reference.mdx b/src/content/docs/en/reference/adapter-reference.mdx
index 3dd96383161dc..04a4e574ad87b 100644
--- a/src/content/docs/en/reference/adapter-reference.mdx
+++ b/src/content/docs/en/reference/adapter-reference.mdx
@@ -194,7 +194,7 @@ export function start(manifest) {
 
 The following methods are provided:
 
-##### `app.render(request: Request, options?: RenderOptions)`
+##### `app.render(request, { routeData, locals })`
 
 This method calls the Astro page that matches the request, renders it, and returns a Promise to a [Response](https://developer.mozilla.org/en-US/docs/Web/API/Response) object. This also works for API routes that do not render pages.
 
@@ -202,39 +202,13 @@ This method calls the Astro page that matches the request, renders it, and retur
 const response = await app.render(request);
 ```
 
-##### `RenderOptions`
+The method accepts a mandatory `request` argument, and an optional argument for [`routeData`](/en/reference/integrations-reference/#routedata-type-reference) and [`locals`](/en/reference/api-reference/#astrolocals).
 
-The `app.render()` method accepts a mandatory `request` argument, and an optional `RenderOptions` object for [`addCookieHeader`](#addcookieheader), [`clientAddress`](#clientaddress), [`locals`](#locals), and [`routeData`](#routedata).
-
-###### `addCookieHeader`
-
-Whether or not to automatically add all cookies written by `Astro.cookie.set()` to the response headers.
-
-When set to `true`, they will be added to the `Set-Cookie` header of the response as comma separated key-value pairs. You can use the standard `response.headers.getSetCookie()` API to read them individually.
-When set to `false`(default), the cookies will only be available from `App.getSetCookieFromResponse(response)`.
-
-```js
-const response = await app.render(request, { addCookieHeader: true });
-```
-
-###### `clientAddress`
-
-The client IP address that will be made available as [`Astro.clientAddress`](/en/reference/api-reference/#astroclientaddress) in pages, and as `ctx.clientAddress` in API routes and middleware.
-
-The example below reads the `x-forwarded-for` header and passes it as `clientAddress`. This value becomes available to the user as `Astro.clientAddress`.
-
-```js "clientAddress"
-const clientAddress = request.headers.get("x-forwarded-for");
-const response = await app.render(request, { clientAddress });
-```
-
-###### `locals`
-
-The [`context.locals` object](/en/reference/api-reference/#contextlocals) used to store and access information during the lifecycle of a request.
+Provide a value for `routeData` if you already know the route to render. Doing so will bypass the internal call to [`app.match`](#appmatchrequest) to determine the route to render.
 
 The example below reads a header named `x-private-header`, attempts to parse it as an object and pass it to `locals`, which can then be passed to any [middleware function](/en/guides/middleware/).
 
-```js "locals"
+```js
 const privateHeader = request.headers.get("x-private-header");
 let locals = {};
 try {
@@ -246,20 +220,6 @@ try {
 }
 ```
 
-###### `routeData`
-
-Provide a value for [`routeData`](/en/reference/integrations-reference/#routedata-type-reference) if you already know the route to render. Doing so will bypass the internal call to [`app.match`](#appmatchrequest) to determine the route to render.
-
-```js "routeData"
-const routeData = app.match(request);
-if (routeData) {
-    return app.render(request, { routeData });
-} else {
-    /* adapter-specific 404 response */
-    return new Response(..., { status: 404 });
-}
-```
-
 ##### `app.match(request)`
 
 This method is used to determine if a request is matched by the Astro app's routing rules.