@rest-vir/run-service 1.6.0 → 1.7.1

package/dist/handle-request/endpoint-handler.js

@@ -1,5 +1,5 @@
 /* node:coverage disable: this file is just types */
-import { setResponseHeaders } from '../util/headers.js';
+import { setRawResponseHeaders, setResponseHeaders } from '../util/headers.js';
 /**
  * Handle the output of a handler without sending the response. Similar to
  * {@link handleHandlerOutput} but this one does not send the response.
@@ -11,6 +11,11 @@ import { setResponseHeaders } from '../util/headers.js';
 export function handleHandlerOutputWithoutSending(result, response) {
     if (result?.headers) {
         setResponseHeaders(response, result.headers);
+        /**
+         * Also set headers on the raw Node response so they survive `response.hijack()`. Fastify
+         * headers set via `response.header()` are lost when the response is hijacked.
+         */
+        setRawResponseHeaders(response.raw, result.headers);
     }
     if (result?.statusCode) {
         response.statusCode = result.statusCode;
@@ -31,6 +36,11 @@ export function handleHandlerOutputWithoutSending(result, response) {
 export function handleHandlerOutput(result, response) {
     if (result?.headers) {
         setResponseHeaders(response, result.headers);
+        /**
+         * Also set headers on the raw Node response so they survive `response.hijack()`. Fastify
+         * headers set via `response.header()` are lost when the response is hijacked.
+         */
+        setRawResponseHeaders(response.raw, result.headers);
     }
     if (result?.statusCode) {
         response.statusCode = result.statusCode;

package/dist/util/headers.d.ts

@@ -1,5 +1,5 @@
 import { type ServerResponse } from '@rest-vir/implement-service';
-import { type OutgoingHttpHeaders } from 'node:http';
+import { type ServerResponse as NodeServerResponse, type OutgoingHttpHeaders } from 'node:http';
 /**
  * Easily apply an object of headers to a Response object. Setting a header to `undefined` removes
  * it.
@@ -9,3 +9,14 @@ import { type OutgoingHttpHeaders } from 'node:http';
  * @package [`@rest-vir/run-service`](https://www.npmjs.com/package/@rest-vir/run-service)
  */
 export declare function setResponseHeaders(response: Readonly<Pick<ServerResponse, 'removeHeader' | 'header'>>, headers: Readonly<OutgoingHttpHeaders>): void;
+/**
+ * Sets headers directly on the raw Node.js `http.ServerResponse`. Unlike headers set via Fastify's
+ * `response.header()`, these survive `response.hijack()` because they are written to the underlying
+ * Node response. When an endpoint later calls `writeHead()`, these headers are merged in, with
+ * `writeHead()` headers taking precedence.
+ *
+ * @category Internal
+ * @category Package : @rest-vir/run-service
+ * @package [`@rest-vir/run-service`](https://www.npmjs.com/package/@rest-vir/run-service)
+ */
+export declare function setRawResponseHeaders(rawResponse: Readonly<Pick<NodeServerResponse, 'setHeader' | 'removeHeader'>>, headers: Readonly<OutgoingHttpHeaders>): void;

package/dist/util/headers.js

@@ -17,3 +17,23 @@ export function setResponseHeaders(response, headers) {
         }
     });
 }
+/**
+ * Sets headers directly on the raw Node.js `http.ServerResponse`. Unlike headers set via Fastify's
+ * `response.header()`, these survive `response.hijack()` because they are written to the underlying
+ * Node response. When an endpoint later calls `writeHead()`, these headers are merged in, with
+ * `writeHead()` headers taking precedence.
+ *
+ * @category Internal
+ * @category Package : @rest-vir/run-service
+ * @package [`@rest-vir/run-service`](https://www.npmjs.com/package/@rest-vir/run-service)
+ */
+export function setRawResponseHeaders(rawResponse, headers) {
+    getObjectTypedEntries(headers).forEach(([name, value,]) => {
+        if (value == undefined) {
+            rawResponse.removeHeader(String(name));
+        }
+        else {
+            rawResponse.setHeader(String(name), value);
+        }
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@rest-vir/run-service",
-    "version": "1.6.0",
+    "version": "1.7.1",
     "description": "Run a service defined by @rest-vir/define-service and implemented by @rest-vir/implement-service.",
     "keywords": [
         "rest",
@@ -44,8 +44,8 @@
         "@augment-vir/node": "^31.68.2",
         "@fastify/compress": "^8.3.1",
         "@fastify/websocket": "^11.2.0",
-        "@rest-vir/define-service": "^1.6.0",
-        "@rest-vir/implement-service": "^1.6.0",
+        "@rest-vir/define-service": "^1.7.1",
+        "@rest-vir/implement-service": "^1.7.1",
         "cluster-vir": "^1.0.1",
         "date-vir": "^8.2.1",
         "fastify": "^5.8.4",