srvx-nightly 0.12.3 → 0.12.4

package/dist/body-limit.d.mts

@@ -26,9 +26,15 @@
  * the body is consumed (`request.text()` / `.json()` / `.arrayBuffer()` /
  * `.body`), matching the streamed-limit behaviour.
  *
+ * Pass {@link BodyLimitOptions.createError | `options.createError`} to throw your
+ * own error on overflow (e.g. a framework's native HTTP error) instead of the
+ * default {@link createBodyTooLargeError | `413`-style error}. It is used for both
+ * the `Content-Length` fast path and the streaming limit, and is forwarded to
+ * `clone()` so clones stay limited with the same error.
+ *
  * @see https://srvx.h3.dev/guide/body-limit
  */
-declare function limitRequestBody<T extends Request>(request: T, maxRequestBodySize: number): T;
+declare function limitRequestBody<T extends Request>(request: T, maxRequestBodySize: number, options?: BodyLimitOptions): T;
 /**
  * Wraps a body `ReadableStream` so the total number of bytes read cannot exceed
  * `maxRequestBodySize`.
@@ -41,9 +47,13 @@ declare function limitRequestBody<T extends Request>(request: T, maxRequestBodyS
  * producing / release the socket). Cancelling the wrapped stream propagates to
  * the upstream stream.
  *
+ * Pass {@link BodyLimitOptions.createError | `options.createError`} to error the
+ * stream with your own error on overflow instead of the default
+ * {@link createBodyTooLargeError | `413`-style error}.
+ *
  * @see https://srvx.h3.dev/guide/body-limit
  */
-declare function limitBodyStream(stream: ReadableStream<Uint8Array>, maxRequestBodySize: number): ReadableStream<Uint8Array>;
+declare function limitBodyStream(stream: ReadableStream<Uint8Array>, maxRequestBodySize: number, options?: BodyLimitOptions): ReadableStream<Uint8Array>;
 /**
  * The canonical error thrown when a request body exceeds `maxRequestBodySize`.
  *
@@ -60,6 +70,24 @@ interface BodyTooLargeError extends Error {
   /** Alias of {@link statusCode}. */
   status: 413;
 }
+/**
+ * Factory for the error thrown when a body exceeds `maxRequestBodySize`, injectable
+ * via {@link BodyLimitOptions.createError} to override the default.
+ *
+ * @see https://srvx.h3.dev/guide/body-limit
+ */
+type BodyLimitErrorFactory = (maxRequestBodySize: number) => unknown;
+/**
+ * Options for {@link limitRequestBody} and {@link limitBodyStream}.
+ *
+ * @see https://srvx.h3.dev/guide/body-limit
+ */
+interface BodyLimitOptions {
+  /**
+   * Factory for the error thrown on overflow. Defaults to {@link createBodyTooLargeError}.
+   */
+  createError?: BodyLimitErrorFactory;
+}
 /**
  * Creates the canonical {@link BodyTooLargeError | `413 Payload Too Large` error}
  * used across srvx when a request body exceeds the configured `maxRequestBodySize`.
@@ -67,4 +95,4 @@ interface BodyTooLargeError extends Error {
  * @see https://srvx.h3.dev/guide/body-limit
  */
 declare function createBodyTooLargeError(maxRequestBodySize: number): BodyTooLargeError;
-export { BodyTooLargeError, createBodyTooLargeError, limitBodyStream, limitRequestBody };
+export { BodyLimitErrorFactory, BodyLimitOptions, BodyTooLargeError, createBodyTooLargeError, limitBodyStream, limitRequestBody };

package/dist/body-limit.mjs

@@ -1,22 +1,24 @@
-function limitRequestBody(request, maxRequestBodySize) {
+function limitRequestBody(request, maxRequestBodySize, options) {
 	if (!request.body) return request;
+	const createError = options?.createError ?? createBodyTooLargeError;
 	const contentLengthHeader = request.headers.get("content-length");
 	const contentLength = contentLengthHeader && /^\d+$/.test(contentLengthHeader) ? Number(contentLengthHeader) : NaN;
 	const initiallyUsed = request.bodyUsed;
 	const overLimit = contentLength > maxRequestBodySize;
-	if (overLimit) request.body.cancel(createBodyTooLargeError(maxRequestBodySize)).catch(() => {});
+	if (overLimit) request.body.cancel(createError(maxRequestBodySize)).catch(() => {});
 	let limited;
-	const limitedBody = () => limited ??= new Response(overLimit ? erroredStream(createBodyTooLargeError(maxRequestBodySize)) : limitBodyStream(request.body, maxRequestBodySize));
+	const limitedBody = () => limited ??= new Response(overLimit ? erroredStream(createError(maxRequestBodySize)) : limitBodyStream(request.body, maxRequestBodySize, options));
 	return new Proxy(request, { get(target, prop) {
 		if (prop === "body") return limitedBody().body;
 		if (prop === "bodyUsed") return initiallyUsed || (limited?.bodyUsed ?? false);
 		if (typeof prop === "string" && bodyReadMethods.has(prop)) return () => limitedBody()[prop]();
-		if (prop === "clone") return () => limitRequestBody(target.clone(), maxRequestBodySize);
+		if (prop === "clone") return () => limitRequestBody(target.clone(), maxRequestBodySize, options);
 		const value = Reflect.get(target, prop, target);
 		return typeof value === "function" ? value.bind(target) : value;
 	} });
 }
-function limitBodyStream(stream, maxRequestBodySize) {
+function limitBodyStream(stream, maxRequestBodySize, options) {
+	const createError = options?.createError ?? createBodyTooLargeError;
 	const reader = stream.getReader();
 	let size = 0;
 	return new ReadableStream({
@@ -28,7 +30,7 @@ function limitBodyStream(stream, maxRequestBodySize) {
 			}
 			size += value.byteLength;
 			if (size > maxRequestBodySize) {
-				const error = createBodyTooLargeError(maxRequestBodySize);
+				const error = createError(maxRequestBodySize);
 				reader.cancel(error).catch(() => {});
 				controller.error(error);
 				return;

package/dist/cli.mjs

@@ -205,7 +205,7 @@ function getResponseFormat(res) {
 }
 const srvxMeta = {
 	name: "srvx-nightly",
-	version: "0.12.3",
+	version: "0.12.4",
 	description: "Universal Server."
 };
 function usage(mainOpts) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "srvx-nightly",
-  "version": "0.12.3",
+  "version": "0.12.4",
   "description": "Universal Server.",
   "homepage": "https://srvx.h3.dev",
   "license": "MIT",