balda 0.0.68 → 0.0.70

package/lib/index.d.cts

@@ -346,12 +346,29 @@ declare class Request<Params extends Record<string, string> = Record<string, str
      * @internal
      */
     private static getOrCompileSchema;
+    /**
+     * Maps Zod validation issues to AJV-compatible ErrorObject[] so that the
+     * existing catch blocks (which check `error instanceof ValidationError`)
+     * produce structured, JSON-serializable error responses instead of `{}`.
+     *
+     * @internal
+     */
+    private static zodIssuesToAjvErrors;
     /**
      * Compiles and validates the request data against the input schema.
+     *
+     * **Zod schemas** are validated with Zod's native `safeParse()` instead of
+     * the AJV path.  This correctly applies transforms (`.transform(Number)`),
+     * coercions (`z.coerce.number()`, `z.coerce.date()`), and refinements — all
+     * of which the AJV path cannot handle because `z.toJSONSchema()` throws for
+     * these constructs.  The returned `data` is the fully parsed/coerced value.
+     *
+     * **TypeBox and plain JSON schemas** continue to use the AJV path.
+     *
      * @param inputSchema - The schema to validate the request data against (Zod, TypeBox, or plain JSON schema).
      * @param data - The request data to validate.
      * @param throwErrorOnValidationFail - If true, throws ValidationError on validation failure. If false, returns the original data.
-     * @returns The validated data.
+     * @returns The validated (and potentially transformed/coerced) data.
      */
     private static compileAndValidate;
     /**
@@ -2328,8 +2345,9 @@ interface JsonOptions {
      */
     sizeLimit?: `${number}mb` | `${number}kb`;
     /**
-     * If true, the JSON body will be parsed as an empty object if it is empty.
-     * Default: false (body will be undefined)
+     * If true, the JSON body will be parsed as an empty object (`{}`) if it is empty.
+     * If false, an empty body leaves `req.body` as `undefined`.
+     * Default: true
      */
     parseEmptyBodyAsObject?: boolean;
     /**

package/lib/index.d.ts

@@ -346,12 +346,29 @@ declare class Request<Params extends Record<string, string> = Record<string, str
      * @internal
      */
     private static getOrCompileSchema;
+    /**
+     * Maps Zod validation issues to AJV-compatible ErrorObject[] so that the
+     * existing catch blocks (which check `error instanceof ValidationError`)
+     * produce structured, JSON-serializable error responses instead of `{}`.
+     *
+     * @internal
+     */
+    private static zodIssuesToAjvErrors;
     /**
      * Compiles and validates the request data against the input schema.
+     *
+     * **Zod schemas** are validated with Zod's native `safeParse()` instead of
+     * the AJV path.  This correctly applies transforms (`.transform(Number)`),
+     * coercions (`z.coerce.number()`, `z.coerce.date()`), and refinements — all
+     * of which the AJV path cannot handle because `z.toJSONSchema()` throws for
+     * these constructs.  The returned `data` is the fully parsed/coerced value.
+     *
+     * **TypeBox and plain JSON schemas** continue to use the AJV path.
+     *
      * @param inputSchema - The schema to validate the request data against (Zod, TypeBox, or plain JSON schema).
      * @param data - The request data to validate.
      * @param throwErrorOnValidationFail - If true, throws ValidationError on validation failure. If false, returns the original data.
-     * @returns The validated data.
+     * @returns The validated (and potentially transformed/coerced) data.
      */
     private static compileAndValidate;
     /**
@@ -2328,8 +2345,9 @@ interface JsonOptions {
      */
     sizeLimit?: `${number}mb` | `${number}kb`;
     /**
-     * If true, the JSON body will be parsed as an empty object if it is empty.
-     * Default: false (body will be undefined)
+     * If true, the JSON body will be parsed as an empty object (`{}`) if it is empty.
+     * If false, an empty body leaves `req.body` as `undefined`.
+     * Default: true
      */
     parseEmptyBodyAsObject?: boolean;
     /**