ai-gateway-proxy 0.4.0 → 0.5.0

package/README.md

@@ -230,7 +230,7 @@ createGatewayProxy({
 Both receive `kind` (`"embedding"`, `"image"`, `"video"`, `"speech"`, `"transcription"`, `"reranking"`, `"decision"` or `"batch"`), `path` (such as `video-model/start`), `modelId` (the client's `ai-model-id` header, which is the only place an embedding or image call names its model) and `request`, the parsed JSON body.
 
 - **`beforeRawRequest`:** a returned value replaces the body sent upstream; `undefined` or `null` sends it as is.
-- **`afterRawResponse`:** also receives `response`, the `Response` the proxy would send: the upstream status, `content-type` and the allowlisted headers below, with the upstream body on success (a video call's event stream included) and the `GatewayError` body described under `onError` on a failure. Return a `Response` to send that instead, or nothing to send `response`. The body can be read once, so read `response.clone()` when returning nothing; a hook that reads `response` itself and returns nothing, or returns anything but a `Response`, is a 500. When the hook sends another `Response`, throws or returns an invalid result, the proxy cancels `response`'s body unless the hook read it, piped it or built the returned `Response` on it, so the upstream request ends. It does not run on a redirect or when the upstream request fails.
+- **`afterRawResponse`:** also receives `response`, the `Response` the proxy would send: the upstream status, `content-type` and the allowlisted headers below, with the upstream body on success (a video call's event stream included) and the `GatewayError` body described under `onError` on a failure. Return a `Response` to send that instead, or nothing to send `response`. The body can be read once, so read `response.clone()` when returning nothing; a hook that reads `response` itself and returns nothing, or returns anything but a `Response`, is a failure like a throw. A failure on a successful `response` is a 424, since the gateway has already answered, and billed, the call and an AI SDK client retries a 5xx but not a 424; on an error `response` it is a 500. When the hook sends another `Response`, throws or returns an invalid result, the proxy cancels `response`'s body unless the hook read it, piped it or built the returned `Response` on it, so the upstream request ends. It does not run on a redirect or when the upstream request fails.
 
 ```typescript
 createGatewayProxy({
@@ -255,9 +255,9 @@ Apart from forwarding the gateway's own responses, the handler can answer with a
 | 400 | `invalid_request_error` | `Invalid JSON body` | A request other than `GET` or `HEAD` has a non-empty body that is not JSON. |
 | 400 | `invalid_request_error` | `Invalid request body: a language model call must be a JSON object` | The body is JSON but not an object, such as an array or `null`, on a path that runs `beforeRequest`, `afterResponse` or `onError`, and one of them is set. No hook runs and the gateway is not called. |
 | 499 | none | none | The client aborted the request (`request.signal`) before the handler returned. The signal is passed to the upstream `fetch`, so the abort also cancels the upstream request. |
-| 500 | `proxy_error` | `Error proxying request to AI Gateway` | Anything else that throws: `extractPath`, `beforeRequest`, `beforeRawRequest`, the upstream `fetch` or `afterRawResponse`, or an `afterRawResponse` that read the body and returned no `Response`. |
+| 500 | `proxy_error` | `Error proxying request to AI Gateway` | Anything else that throws: `extractPath`, `beforeRequest`, `beforeRawRequest`, the upstream `fetch`, or an `afterRawResponse` failure on an error response. |
 | 500 | `proxy_error` | `beforeRequest hook returned an invalid request: the result must be an object` | `beforeRequest` returned a value other than an object, `undefined` or `null`. The gateway is not called. |
-| 424 | `proxy_error` | `Error processing the AI Gateway response` | After the gateway answered a non-streamed call with `afterResponse` set: `afterResponse` threw, or the success body was not a JSON object. The status is one AI SDK clients do not retry, since the gateway has billed the call. |
+| 424 | `proxy_error` | `Error processing the AI Gateway response` | After the gateway answered a non-streamed call with `afterResponse` set: `afterResponse` threw, or the success body was not a JSON object. After a successful call with `afterRawResponse` set: the hook threw, returned anything but a `Response` or nothing, or read the body and returned no `Response`. The status is one AI SDK clients do not retry, since the gateway has billed the call. |
 | 424 | `proxy_error` | `afterResponse hook returned an invalid response: <problem>` | `afterResponse` on a non-streamed request returned a result that fails the result validation above. |
 | 500 | `proxy_error` | `No response body` | A successful streamed response arrived without a body. |
 | 502 | `proxy_error` | `Upstream redirected, the proxy does not follow redirects` | The gateway answered with a 3xx status. The proxy sets `redirect: "manual"`, runs no `onError` and forwards no `Location`. |

package/dist/index.cjs

@@ -886,7 +886,20 @@ async function runAfterResponse(res, requestBody, afterResponse) {
 }
 /**
  * Runs afterRawResponse and returns the response to send.
- */ async function applyAfterRawResponse(afterRawResponse, context) {
+ * The gateway has answered, and billed, a successful call, so a failure there gets a status clients do not retry.
+ */ async function applyAfterRawResponse(afterRawResponse, context, signal) {
+    try {
+        return await runAfterRawResponse(afterRawResponse, context);
+    } catch (error) {
+        // The handler answers a client abort with 499, and a failed call costs nothing to retry.
+        if (signal.aborted || !context.response.ok) {
+            throw error;
+        }
+        console.error("AI Gateway proxy failed after the gateway answered:", error);
+        return proxyErrorResponse(ANSWERED_CALL_FAILURE_STATUS, "proxy_error", "Error processing the AI Gateway response");
+    }
+}
+async function runAfterRawResponse(afterRawResponse, context) {
     let result;
     try {
         result = await afterRawResponse(context);
@@ -1014,7 +1027,7 @@ async function runAfterResponse(res, requestBody, afterResponse) {
                     ...rawContext,
                     request: requestBody,
                     response
-                });
+                }, request.signal);
             }
             return response;
         } catch (error) {

package/dist/index.mjs

@@ -884,7 +884,20 @@ async function runAfterResponse(res, requestBody, afterResponse) {
 }
 /**
  * Runs afterRawResponse and returns the response to send.
- */ async function applyAfterRawResponse(afterRawResponse, context) {
+ * The gateway has answered, and billed, a successful call, so a failure there gets a status clients do not retry.
+ */ async function applyAfterRawResponse(afterRawResponse, context, signal) {
+    try {
+        return await runAfterRawResponse(afterRawResponse, context);
+    } catch (error) {
+        // The handler answers a client abort with 499, and a failed call costs nothing to retry.
+        if (signal.aborted || !context.response.ok) {
+            throw error;
+        }
+        console.error("AI Gateway proxy failed after the gateway answered:", error);
+        return proxyErrorResponse(ANSWERED_CALL_FAILURE_STATUS, "proxy_error", "Error processing the AI Gateway response");
+    }
+}
+async function runAfterRawResponse(afterRawResponse, context) {
     let result;
     try {
         result = await afterRawResponse(context);
@@ -1012,7 +1025,7 @@ async function runAfterResponse(res, requestBody, afterResponse) {
                     ...rawContext,
                     request: requestBody,
                     response
-                });
+                }, request.signal);
             }
             return response;
         } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-gateway-proxy",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",