@wooksjs/event-http 0.7.25 → 0.7.26

package/dist/index.cjs

@@ -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
@@ -1474,7 +1497,7 @@ function escapeHtml(value) {
 //#endregion
 //#region packages/event-http/src/response/wooks-http-response.ts
 let framework = {
-	version: "0.7.25",
+	version: "0.7.26",
 	poweredBy: "wooksjs",
 	link: "https://wooks.moost.org/",
 	image: "https://wooks.moost.org/wooks-full-logo.svg"
@@ -1884,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) {
@@ -2088,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);
 }
 
@@ -2113,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: {
@@ -773,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

@@ -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
@@ -1445,7 +1468,7 @@ function escapeHtml(value) {
 //#endregion
 //#region packages/event-http/src/response/wooks-http-response.ts
 let framework = {
-	version: "0.7.25",
+	version: "0.7.26",
 	poweredBy: "wooksjs",
 	link: "https://wooks.moost.org/",
 	image: "https://wooks.moost.org/wooks-full-logo.svg"
@@ -1855,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) {
@@ -2059,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.25",
+  "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.25",
-    "wooks": "^0.7.25"
+    "@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.25",
-    "wooks": "^0.7.25"
+    "@wooksjs/event-core": "^0.7.26",
+    "wooks": "^0.7.26"
   },
   "scripts": {
     "build": "rolldown -c ../../rolldown.config.mjs"