patch: 1.4.16

.github/workflows/ci.yml

@@ -27,6 +27,9 @@ jobs:
             - name: Test
               run: bun run test
 
+            - name: Test
+              run: bun run test:cf
+
             - name: Publish Preview
               if: github.event_name == 'pull_request'
               run: bunx pkg-pr-new publish

.github/workflows/publish.yml

@@ -43,6 +43,9 @@ jobs:
       - name: Test
         run: bun run test
 
+      - name: Test
+        run: bun run test:cf
+
       - name: 'Publish'
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

CHANGELOG.md

@@ -1,3 +1,12 @@
+# 1.4.16 - 5 Nov 2025
+Improvement:
+- ValidationError: add `messageValue` as an alias of `errorValue`
+- ValidationError.detail now accept optional 2nd parameter `allowUnsafeValidatorDetails`
+
+Bug fix:
+- [#1528](https://github.com/elysiajs/elysia/issues/1528) error in parsing request body validation errors with Zod
+- [#1527](https://github.com/elysiajs/elysia/issues/1527) bracket handling in exact mirror
+
 # 1.4.15 - 3 Nov 2025
 Bug fix:
 - 1.4.14 regression with Eden Treaty, and OpenAPI type gen

example/a.ts

@@ -1,21 +1,27 @@
-import Elysia, { t } from '../src'
+import { Elysia } from '../src'
+import { req } from '../test/utils'
 
 new Elysia()
-	.post(
-		'/mirror',
-		async ({ status, body }) => status(201, { success: false }),
-		{
-			body: t.Object({
-				code: t.String()
-			}),
-			response: {
-				200: t.Object({
-					success: t.Literal(true)
-				}),
-				201: t.Object({
-					success: t.Literal(false)
-				})
-			}
-		}
-	)
-	.listen(3333)
+  .ws("/", {
+    ping() {
+      console.log("onping")
+    },
+
+    pong() {
+      console.log("onpong")
+    },
+
+    async message(ws) {
+      console.log("onmessage")
+      console.log(ws.body)
+    },
+  })
+  .listen(3005)
+
+const ws = new WebSocket("ws://localhost:3005")
+
+ws.addEventListener("open", () => {
+  ws.ping()
+  ws.send("df")
+  ws.ping()
+})

package.json

@@ -178,7 +178,7 @@
 	],
 	"license": "MIT",
 	"scripts": {
-		"test": "bun run test:functionality && bun run test:types && bun run test:node && bun run test:cf",
+		"test": "bun run test:functionality && bun run test:types && bun run test:node",
 		"test:functionality": "bun test && bun run test:imports",
 		"test:imports": "bun run test/type-system/import.ts",
 		"test:types": "tsc --project tsconfig.test.json",
@@ -191,7 +191,7 @@
 	},
 	"dependencies": {
 		"cookie": "^1.0.2",
-		"exact-mirror": "0.2.2",
+		"exact-mirror": "0.2.3",
 		"fast-decode-uri-component": "^1.0.1",
 		"memoirist": "^0.4.0"
 	},

src/adapter/bun/index.ts

@@ -10,7 +10,7 @@ import { createBunRouteHandler } from './compose'
 import { createNativeStaticHandler } from './handler-native'
 
 import { serializeCookie } from '../../cookies'
-import { isProduction, ValidationError } from '../../error'
+import { isProduction, status, ValidationError } from '../../error'
 import { getSchemaValidator } from '../../schema'
 import {
 	hasHeaderShorthand,
@@ -627,8 +627,7 @@ export const BunAdapter: ElysiaAdapter = {
 				)
 					return
 
-				set.status = 400
-				return 'Expected a websocket connection'
+				return status(400, 'Expected a websocket connection')
 			},
 			{
 				...rest,

src/error.ts

@@ -153,9 +153,15 @@ export const mapValueError = (error: ValueError | undefined): MapValueError => {
 			summary: undefined
 		}
 
-	const { message, path, value, type } = error
+	let { message, path, value, type } = error
+
+	if (Array.isArray(path)) path = path[0]
+
+	const property =
+		typeof path === 'string'
+			? path.slice(1).replaceAll('/', '.')
+			: 'unknown'
 
-	const property = path.slice(1).replaceAll('/', '.')
 	const isRoot = path === ''
 
 	switch (type) {
@@ -271,8 +277,29 @@ export class ValidationError extends Error {
 	code = 'VALIDATION'
 	status = 422
 
+	/**
+	 * An actual value of `message`
+	 *
+	 * Since `message` is string
+	 * use this instead of message
+	 */
 	valueError?: ValueError
+
+	/**
+	 * Alias of `valueError`
+	 */
+	get messageValue() {
+		return this.valueError
+	}
+
+	/**
+	 * Expected value of the schema
+	 */
 	expected?: unknown
+
+	/**
+	 * Custom error if provided
+	 */
 	customError?: string
 
 	constructor(
@@ -282,6 +309,9 @@ export class ValidationError extends Error {
 			| TypeCheck<any>
 			| ElysiaTypeCheck<any>
 			| StandardSchemaV1Like,
+		/**
+		 * Input value
+		 */
 		public value: unknown,
 		private allowUnsafeValidationDetails = false,
 		errors?: ValueErrorIterator
@@ -535,15 +565,17 @@ export class ValidationError extends Error {
 	 *		})
 	 * ```
 	 */
-	detail(message: unknown) {
+	detail(
+		message: unknown,
+		allowUnsafeValidatorDetails = this.allowUnsafeValidationDetails
+	) {
 		if (!this.customError) return this.message
 
-		const validator = this.validator
 		const value = this.value
 		const expected = this.expected
 		const errors = this.all
 
-		return isProduction && !this.allowUnsafeValidationDetails
+		return isProduction && !allowUnsafeValidatorDetails
 			? {
 					type: 'validation',
 					on: this.type,

src/ws/index.ts

@@ -27,6 +27,12 @@ export const websocket: WebSocketHandler<any> = {
 	},
 	close(ws, code, reason) {
 		ws.data.close?.(ws, code, reason)
+	},
+	ping(ws) {
+		ws.data.ping?.(ws)
+	},
+	pong(ws) {
+		ws.data.pong?.(ws)
 	}
 }
 

test/extends/error.test.ts

@@ -2,7 +2,8 @@
 import { Elysia, t } from '../../src'
 
 import { describe, expect, it } from 'bun:test'
-import { req } from '../utils'
+import { post, req } from '../utils'
+import z from 'zod'
 
 class CustomError extends Error {
 	constructor() {
@@ -90,4 +91,38 @@ describe('Error', () => {
 		expect(response.status).toBe(422)
 		expect(response.headers.get('content-type')).toBe('application/json')
 	})
+
+	it('validation error should handle Standard Schema with error.detail', async () => {
+		const sendOtpEmailSchema = z.object({
+			channel: z.literal('email'),
+			otpTo: z.email({ error: 'Must be a valid email address' })
+		})
+
+		const sendOtpSmsSchema = z.object({
+			channel: z.literal('sms'),
+			otpTo: z.e164({
+				error: 'Must be a valid phone number with country code'
+			})
+		})
+
+		const sendOtpSchema = z.discriminatedUnion('channel', [
+			sendOtpEmailSchema,
+			sendOtpSmsSchema
+		])
+
+		const app = new Elysia()
+			.onError(({ code, error, status }) => {
+				switch (code) {
+					case 'VALIDATION':
+						return error.detail(error.message)
+				}
+			})
+			.post('/', ({ body, set }) => 'ok', {
+				body: sendOtpSchema
+			})
+
+		const response = await app.handle(post('/', {}))
+
+		expect(response.status).toBe(422)
+	})
 })

test/ws/connection.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'bun:test'
-import { Elysia } from '../../src'
+import { Elysia, t } from '../../src'
 import { newWebsocket, wsOpen, wsClose, wsClosed } from './utils'
 import { req } from '../utils'
 
@@ -173,4 +173,41 @@ describe('WebSocket connection', () => {
 			name: 'Jane Doe'
 		})
 	})
+
+	it('call ping/pong', async () => {
+		let pinged = false
+		let ponged = false
+
+		const app = new Elysia()
+			.ws('/', {
+				ping() {
+					pinged = true
+				},
+				pong() {
+					ponged = true
+				},
+				async message(ws) {
+				}
+			})
+			.listen(0)
+
+		const ws = new WebSocket(`ws://localhost:${app.server?.port}`)
+
+		await new Promise<void>((resolve) => {
+			ws.addEventListener('open', () => {
+				ws.ping()
+				ws.send('df')
+				ws.pong()
+
+				resolve()
+			}, {
+				once: true
+			})
+		})
+
+		await Bun.sleep(3)
+
+		expect(pinged).toBe(true)
+		expect(ponged).toBe(true)
+	})
 })

test/ws/utils.ts

@@ -1,6 +1,6 @@
 import type { Server } from 'bun'
 
-export const newWebsocket = (server: Server, path = '/ws') =>
+export const newWebsocket = (server: Server<any>, path = '/ws') =>
 	new WebSocket(`ws://${server.hostname}:${server.port}${path}`, {})
 
 export const wsOpen = (ws: WebSocket) =>