@wooksjs/event-http 0.7.24 → 0.7.26

package/dist/index.cjs

@@ -198,12 +198,12 @@ async function uncompressBodyStream(encodings, src) {
 
 //#endregion
 //#region packages/event-http/src/compressor/zlib-compressors.ts
-const pipeline = node_stream.pipeline;
+const pipeline$1 = node_stream.pipeline;
 function iterableToReadable(src) {
 	return node_stream.Readable.from(src, { objectMode: false });
 }
 function pump(src, transform) {
-	pipeline(iterableToReadable(src), transform, (err) => {
+	pipeline$1(iterableToReadable(src), transform, (err) => {
 		if (err) transform.destroy(err);
 	});
 	return transform;
@@ -428,7 +428,7 @@ const isCompressedSlot = (0, _wooksjs_event_core.cached)((ctx) => {
 	].includes(p)) return true;
 	return false;
 });
-/** @internal Exported for test pre-seeding via `ctx.set(rawBodySlot, ...)`. */
+/** @internal Exported for test pre-seeding — use {@link seedRawBody} instead. */
 const rawBodySlot = (0, _wooksjs_event_core.cached)(async (ctx) => {
 	const req = ctx.get(httpKind.keys.req);
 	const encs = ctx.get(contentEncodingsSlot);
@@ -568,6 +568,29 @@ const useRequest = (0, _wooksjs_event_core.defineWook)((ctx) => {
 		setMaxRatio
 	};
 });
+/**
+* Seeds the raw request body of `ctx`: `useRequest(ctx).rawBody()` resolves to `raw` instead of
+* reading the incoming request stream. To seed what `useBody()` (`@wooksjs/http-body`) parses,
+* use its `seedBody()` — a parent's already parsed body is otherwise read through.
+*
+* Use it for a child event context (`new EventContext({ logger, parent })`) that runs a handler
+* with its own payload: the child still reads everything else (request, headers, auth) through
+* its parent, but never the parent's body. Call it before anything in the child reads the body.
+*
+* @param ctx - The context to seed — usually a child of the current HTTP event
+* @param raw - The body bytes (a string is encoded as UTF-8)
+*
+* @example
+* ```ts
+* const child = new EventContext({ logger: parent.logger, parent })
+* seedRawBody(child, JSON.stringify({ ids: [1, 2] }))
+* await run(child, () => useRequest().rawBody()) // Buffer of '{"ids":[1,2]}'
+* ```
+*/
+function seedRawBody(ctx, raw) {
+	ctx.setOwn(rawBodySlot, Promise.resolve(buffer.Buffer.isBuffer(raw) ? raw : buffer.Buffer.from(raw)));
+	if (ctx.parent) ctx.getOwn(useRequest._slot);
+}
 
 //#endregion
 //#region packages/event-http/src/composables/headers.ts
@@ -1057,46 +1080,41 @@ var HttpResponse = class {
 		}
 		this._status = defaultStatus[this._req.method] || EHttpStatusCode.OK;
 	}
-	sendStream(stream$1, method) {
+	sendStream(source, method) {
 		this.autoStatus(true);
 		this._res.writeHead(this._status, this._headers);
-		this._req.once("close", () => {
-			stream$1.destroy();
-		});
 		if (method === "HEAD") {
-			stream$1.destroy();
+			source.destroy();
 			this._res.end();
 			return Promise.resolve();
 		}
-		return new Promise((resolve, reject) => {
-			stream$1.on("error", (e) => {
-				this._logger.error("Stream error", e);
-				stream$1.destroy();
-				this._res.end();
-				reject(e);
-			});
-			stream$1.on("close", () => {
-				stream$1.destroy();
+		return this.pipeToResponse(source, "Stream error");
+	}
+	/**
+	* Pipes `source` into the response. `pipeline` destroys the source when the RESPONSE
+	* closes first (the client disconnected — the request's own 'close' fires as soon as its
+	* body is read, so it can't signal that) and destroys the response when the source fails,
+	* so a truncated body never looks complete. A source error is logged, never rethrown:
+	* headers are already sent, and a sync handler's send() is not awaited (an unhandled
+	* rejection would take the process down).
+	*/
+	pipeToResponse(source, errorLabel) {
+		return new Promise((resolve) => {
+			(0, stream.pipeline)(source, this._res, (error) => {
+				if (error && error.code !== "ERR_STREAM_PREMATURE_CLOSE") this._logger.error(errorLabel, error);
 				resolve();
 			});
-			stream$1.pipe(this._res);
 		});
 	}
 	async sendFetchResponse(fetchResponse, method) {
 		this._status = this._status || fetchResponse.status;
 		this.mergeFetchResponseHeaders(fetchResponse);
 		this._res.writeHead(this._status, this._headers);
-		if (method === "HEAD") {
+		if (method === "HEAD" || !fetchResponse.body) {
 			this._res.end();
 			return;
 		}
-		const fetchBody = fetchResponse.body;
-		if (fetchBody) try {
-			for await (const chunk of fetchBody) this._res.write(chunk);
-		} catch (error) {
-			this._logger.error("Error streaming fetch response body", error);
-		}
-		if (!this._res.writableEnded) this._res.end();
+		return this.pipeToResponse(stream.Readable.fromWeb(fetchResponse.body), "Error streaming fetch response body");
 	}
 	sendRegular(method) {
 		const renderedBody = this.renderBody();
@@ -1479,7 +1497,7 @@ function escapeHtml(value) {
 //#endregion
 //#region packages/event-http/src/response/wooks-http-response.ts
 let framework = {
-	version: "0.7.24",
+	version: "0.7.26",
 	poweredBy: "wooksjs",
 	link: "https://wooks.moost.org/",
 	image: "https://wooks.moost.org/wooks-full-logo.svg"
@@ -1889,7 +1907,7 @@ var WooksHttp = class extends wooks.WooksAdapterBase {
 			requestLimits
 		}, async () => {
 			const ctx = (0, _wooksjs_event_core.current)();
-			if (bodyBuffer) ctx.set(rawBodySlot, Promise.resolve(bodyBuffer));
+			if (bodyBuffer) seedRawBody(ctx, bodyBuffer);
 			try {
 				const handlers = this.wooks.lookupHandlers(method, pathname, ctx);
 				if (handlers) {
@@ -2093,10 +2111,7 @@ function prepareTestHttpContext(options) {
 		requestLimits: options.requestLimits
 	});
 	if (options.params) ctx.set(_wooksjs_event_core.routeParamsKey, options.params);
-	if (options.rawBody !== void 0) {
-		const buf = buffer.Buffer.isBuffer(options.rawBody) ? options.rawBody : buffer.Buffer.from(options.rawBody);
-		ctx.set(rawBodySlot, Promise.resolve(buf));
-	}
+	if (options.rawBody !== void 0) seedRawBody(ctx, options.rawBody);
 	return (cb) => (0, _wooksjs_event_core.run)(ctx, cb);
 }
 
@@ -2118,6 +2133,7 @@ exports.rawBodySlot = rawBodySlot;
 exports.recordToWebHeaders = recordToWebHeaders;
 exports.renderCacheControl = renderCacheControl;
 exports.securityHeaders = securityHeaders;
+exports.seedRawBody = seedRawBody;
 exports.useAccept = useAccept;
 exports.useAuthorization = useAuthorization;
 exports.useCookies = useCookies;

package/dist/index.d.ts

@@ -69,7 +69,7 @@ declare const DEFAULT_LIMITS: {
     readonly maxRatio: 100;
     readonly readTimeoutMs: 10000;
 };
-/** @internal Exported for test pre-seeding via `ctx.set(rawBodySlot, ...)`. */
+/** @internal Exported for test pre-seeding — use {@link seedRawBody} instead. */
 declare const rawBodySlot: _wooksjs_event_core.Cached<Promise<Buffer<ArrayBufferLike>>>;
 /**
  * Provides access to the incoming HTTP request (method, url, headers, body, IP).
@@ -103,6 +103,26 @@ declare const useRequest: _wooksjs_event_core.WookComposable<{
     getMaxRatio: () => number;
     setMaxRatio: (limit: number) => void;
 }>;
+/**
+ * Seeds the raw request body of `ctx`: `useRequest(ctx).rawBody()` resolves to `raw` instead of
+ * reading the incoming request stream. To seed what `useBody()` (`@wooksjs/http-body`) parses,
+ * use its `seedBody()` — a parent's already parsed body is otherwise read through.
+ *
+ * Use it for a child event context (`new EventContext({ logger, parent })`) that runs a handler
+ * with its own payload: the child still reads everything else (request, headers, auth) through
+ * its parent, but never the parent's body. Call it before anything in the child reads the body.
+ *
+ * @param ctx - The context to seed — usually a child of the current HTTP event
+ * @param raw - The body bytes (a string is encoded as UTF-8)
+ *
+ * @example
+ * ```ts
+ * const child = new EventContext({ logger: parent.logger, parent })
+ * seedRawBody(child, JSON.stringify({ ids: [1, 2] }))
+ * await run(child, () => useRequest().rawBody()) // Buffer of '{"ids":[1,2]}'
+ * ```
+ */
+declare function seedRawBody(ctx: EventContext, raw: Buffer | string): void;
 
 /** Maps numeric HTTP status codes to their human-readable descriptions. */
 declare const httpStatusCodes: {
@@ -450,6 +470,15 @@ declare class HttpResponse {
     private finalizeCookies;
     private autoStatus;
     private sendStream;
+    /**
+     * Pipes `source` into the response. `pipeline` destroys the source when the RESPONSE
+     * closes first (the client disconnected — the request's own 'close' fires as soon as its
+     * body is read, so it can't signal that) and destroys the response when the source fails,
+     * so a truncated body never looks complete. A source error is logged, never rethrown:
+     * headers are already sent, and a sync handler's send() is not awaited (an unhandled
+     * rejection would take the process down).
+     */
+    private pipeToResponse;
     private sendFetchResponse;
     private sendRegular;
 }
@@ -764,5 +793,5 @@ interface TTestHttpContext {
  */
 declare function prepareTestHttpContext(options: TTestHttpContext): <T>(cb: (...a: any[]) => T) => T;
 
-export { DEFAULT_FORWARD_HEADERS, DEFAULT_LIMITS, EHttpStatusCode, HttpError, HttpResponse, WooksHttp, WooksHttpResponse, WooksURLSearchParams, createHttpApp, createHttpContext, httpKind, httpStatusCodes, prepareTestHttpContext, rawBodySlot, recordToWebHeaders, renderCacheControl, securityHeaders, useAccept, useAuthorization, useCookies, useHeaders, useHttpContext, useRequest, useResponse, useUrlParams };
+export { DEFAULT_FORWARD_HEADERS, DEFAULT_LIMITS, EHttpStatusCode, HttpError, HttpResponse, WooksHttp, WooksHttpResponse, WooksURLSearchParams, createHttpApp, createHttpContext, httpKind, httpStatusCodes, prepareTestHttpContext, rawBodySlot, recordToWebHeaders, renderCacheControl, securityHeaders, seedRawBody, useAccept, useAuthorization, useCookies, useHeaders, useHttpContext, useRequest, useResponse, useUrlParams };
 export type { KnownAcceptType, KnownAuthType, SecurityHeadersOptions, TCacheControl, TCookieAttributes, TCookieAttributesInput, THttpEventData, TRequestLimits, TSetCookieData, TTestHttpContext, TWooksErrorBody, TWooksErrorBodyExt, TWooksHttpOptions };

package/dist/index.mjs

@@ -5,7 +5,7 @@ import { promisify } from "node:util";
 import { createBrotliCompress, createBrotliDecompress, createDeflate, createGunzip, createGzip, createInflate } from "node:zlib";
 import { URLSearchParams } from "url";
 import http, { IncomingMessage, ServerResponse } from "http";
-import { Duplex, Readable as Readable$1 } from "stream";
+import { Duplex, Readable as Readable$1, pipeline as pipeline$1 } from "stream";
 import { WooksAdapterBase } from "wooks";
 import { Socket } from "net";
 
@@ -169,12 +169,12 @@ async function uncompressBodyStream(encodings, src) {
 
 //#endregion
 //#region packages/event-http/src/compressor/zlib-compressors.ts
-const pipeline$1 = pipeline;
+const pipeline$2 = pipeline;
 function iterableToReadable(src) {
 	return Readable.from(src, { objectMode: false });
 }
 function pump(src, transform) {
-	pipeline$1(iterableToReadable(src), transform, (err) => {
+	pipeline$2(iterableToReadable(src), transform, (err) => {
 		if (err) transform.destroy(err);
 	});
 	return transform;
@@ -399,7 +399,7 @@ const isCompressedSlot = cached((ctx) => {
 	].includes(p)) return true;
 	return false;
 });
-/** @internal Exported for test pre-seeding via `ctx.set(rawBodySlot, ...)`. */
+/** @internal Exported for test pre-seeding — use {@link seedRawBody} instead. */
 const rawBodySlot = cached(async (ctx) => {
 	const req = ctx.get(httpKind.keys.req);
 	const encs = ctx.get(contentEncodingsSlot);
@@ -539,6 +539,29 @@ const useRequest = defineWook((ctx) => {
 		setMaxRatio
 	};
 });
+/**
+* Seeds the raw request body of `ctx`: `useRequest(ctx).rawBody()` resolves to `raw` instead of
+* reading the incoming request stream. To seed what `useBody()` (`@wooksjs/http-body`) parses,
+* use its `seedBody()` — a parent's already parsed body is otherwise read through.
+*
+* Use it for a child event context (`new EventContext({ logger, parent })`) that runs a handler
+* with its own payload: the child still reads everything else (request, headers, auth) through
+* its parent, but never the parent's body. Call it before anything in the child reads the body.
+*
+* @param ctx - The context to seed — usually a child of the current HTTP event
+* @param raw - The body bytes (a string is encoded as UTF-8)
+*
+* @example
+* ```ts
+* const child = new EventContext({ logger: parent.logger, parent })
+* seedRawBody(child, JSON.stringify({ ids: [1, 2] }))
+* await run(child, () => useRequest().rawBody()) // Buffer of '{"ids":[1,2]}'
+* ```
+*/
+function seedRawBody(ctx, raw) {
+	ctx.setOwn(rawBodySlot, Promise.resolve(Buffer$1.isBuffer(raw) ? raw : Buffer$1.from(raw)));
+	if (ctx.parent) ctx.getOwn(useRequest._slot);
+}
 
 //#endregion
 //#region packages/event-http/src/composables/headers.ts
@@ -1028,46 +1051,41 @@ var HttpResponse = class {
 		}
 		this._status = defaultStatus[this._req.method] || EHttpStatusCode.OK;
 	}
-	sendStream(stream, method) {
+	sendStream(source, method) {
 		this.autoStatus(true);
 		this._res.writeHead(this._status, this._headers);
-		this._req.once("close", () => {
-			stream.destroy();
-		});
 		if (method === "HEAD") {
-			stream.destroy();
+			source.destroy();
 			this._res.end();
 			return Promise.resolve();
 		}
-		return new Promise((resolve, reject) => {
-			stream.on("error", (e) => {
-				this._logger.error("Stream error", e);
-				stream.destroy();
-				this._res.end();
-				reject(e);
-			});
-			stream.on("close", () => {
-				stream.destroy();
+		return this.pipeToResponse(source, "Stream error");
+	}
+	/**
+	* Pipes `source` into the response. `pipeline` destroys the source when the RESPONSE
+	* closes first (the client disconnected — the request's own 'close' fires as soon as its
+	* body is read, so it can't signal that) and destroys the response when the source fails,
+	* so a truncated body never looks complete. A source error is logged, never rethrown:
+	* headers are already sent, and a sync handler's send() is not awaited (an unhandled
+	* rejection would take the process down).
+	*/
+	pipeToResponse(source, errorLabel) {
+		return new Promise((resolve) => {
+			pipeline$1(source, this._res, (error) => {
+				if (error && error.code !== "ERR_STREAM_PREMATURE_CLOSE") this._logger.error(errorLabel, error);
 				resolve();
 			});
-			stream.pipe(this._res);
 		});
 	}
 	async sendFetchResponse(fetchResponse, method) {
 		this._status = this._status || fetchResponse.status;
 		this.mergeFetchResponseHeaders(fetchResponse);
 		this._res.writeHead(this._status, this._headers);
-		if (method === "HEAD") {
+		if (method === "HEAD" || !fetchResponse.body) {
 			this._res.end();
 			return;
 		}
-		const fetchBody = fetchResponse.body;
-		if (fetchBody) try {
-			for await (const chunk of fetchBody) this._res.write(chunk);
-		} catch (error) {
-			this._logger.error("Error streaming fetch response body", error);
-		}
-		if (!this._res.writableEnded) this._res.end();
+		return this.pipeToResponse(Readable$1.fromWeb(fetchResponse.body), "Error streaming fetch response body");
 	}
 	sendRegular(method) {
 		const renderedBody = this.renderBody();
@@ -1450,7 +1468,7 @@ function escapeHtml(value) {
 //#endregion
 //#region packages/event-http/src/response/wooks-http-response.ts
 let framework = {
-	version: "0.7.24",
+	version: "0.7.26",
 	poweredBy: "wooksjs",
 	link: "https://wooks.moost.org/",
 	image: "https://wooks.moost.org/wooks-full-logo.svg"
@@ -1860,7 +1878,7 @@ var WooksHttp = class extends WooksAdapterBase {
 			requestLimits
 		}, async () => {
 			const ctx = current();
-			if (bodyBuffer) ctx.set(rawBodySlot, Promise.resolve(bodyBuffer));
+			if (bodyBuffer) seedRawBody(ctx, bodyBuffer);
 			try {
 				const handlers = this.wooks.lookupHandlers(method, pathname, ctx);
 				if (handlers) {
@@ -2064,12 +2082,9 @@ function prepareTestHttpContext(options) {
 		requestLimits: options.requestLimits
 	});
 	if (options.params) ctx.set(routeParamsKey, options.params);
-	if (options.rawBody !== void 0) {
-		const buf = Buffer$1.isBuffer(options.rawBody) ? options.rawBody : Buffer$1.from(options.rawBody);
-		ctx.set(rawBodySlot, Promise.resolve(buf));
-	}
+	if (options.rawBody !== void 0) seedRawBody(ctx, options.rawBody);
 	return (cb) => run(ctx, cb);
 }
 
 //#endregion
-export { DEFAULT_FORWARD_HEADERS, DEFAULT_LIMITS, EHttpStatusCode, HttpError, HttpResponse, WooksHttp, WooksHttpResponse, WooksURLSearchParams, createHttpApp, createHttpContext, httpKind, httpStatusCodes, prepareTestHttpContext, rawBodySlot, recordToWebHeaders, renderCacheControl, securityHeaders, useAccept, useAuthorization, useCookies, useHeaders, useHttpContext, useLogger, useRequest, useResponse, useRouteParams, useUrlParams };
+export { DEFAULT_FORWARD_HEADERS, DEFAULT_LIMITS, EHttpStatusCode, HttpError, HttpResponse, WooksHttp, WooksHttpResponse, WooksURLSearchParams, createHttpApp, createHttpContext, httpKind, httpStatusCodes, prepareTestHttpContext, rawBodySlot, recordToWebHeaders, renderCacheControl, securityHeaders, seedRawBody, useAccept, useAuthorization, useCookies, useHeaders, useHttpContext, useLogger, useRequest, useResponse, useRouteParams, useUrlParams };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wooksjs/event-http",
-  "version": "0.7.24",
+  "version": "0.7.26",
   "description": "@wooksjs/event-http",
   "keywords": [
     "api",
@@ -42,14 +42,14 @@
   "devDependencies": {
     "typescript": "^5.9.3",
     "vitest": "^3.2.7",
-    "@wooksjs/event-core": "^0.7.24",
-    "wooks": "^0.7.24"
+    "@wooksjs/event-core": "^0.7.26",
+    "wooks": "^0.7.26"
   },
   "peerDependencies": {
     "@prostojs/logger": "^0.4.3",
     "@prostojs/router": "^0.3.4",
-    "@wooksjs/event-core": "^0.7.24",
-    "wooks": "^0.7.24"
+    "@wooksjs/event-core": "^0.7.26",
+    "wooks": "^0.7.26"
   },
   "scripts": {
     "build": "rolldown -c ../../rolldown.config.mjs"