Elysia 1.4: Weirs

CHANGELOG.md

@@ -1,3 +1,26 @@
+# 1.4.0 - 13 Sep 2025
+Feature:
+- standard validator
+- macro schema, macro extension, macro detail
+- lifecycle type soundness
+- type inference reduced by ~11%
+- [#861](https://github.com/elysiajs/elysia/issues/861) missing HEAD method when register route with GET
+
+Improvement
+- [#861](https://github.com/elysiajs/elysia/issues/861) automatically add HEAD method when defining GET route
+
+Change
+- ObjectString/ArrayString no longer produce default value by default due to security reasons
+- Cookie now dynamically parse when format is likely JSON
+- export `fileType` for external file type validation for accurate response
+- ObjectString/ArrayString no longer produce default value by default due to security reasons
+- Cookie now dynamically parse when format is likely JSON
+
+Breaking Change
+- remove macro v1 due to non type soundness
+- remove `error` function, use `status` instead
+- deprecation notice for `response` in `mapResponse`, `afterResponse`, use `responseValue` instead
+
 # 1.3.22 - 6 Sep 2025
 Bug fix:
 - safely unwrap t.Record

example/a.ts

@@ -1,11 +1,16 @@
-import { Elysia, t } from '../src'
-import { req } from '../test/utils'
+import { Elysia, t } from 'elysia'
 
-const app = new Elysia()
-	.get('/', () => 'SAFE', {
-		query: t.Record(t.String(), t.String())
-	})
-
-const response = await app.handle(req('/?x=1'))
-
-console.log(response.status)
+new Elysia().group(
+	'/id/:id',
+	{
+		params: t.Object({
+			id: t.Number()
+		})
+	},
+	(app) =>
+		app.get('/:name', ({ params }) => params, {
+			params: t.Object({
+				name: t.String()
+			})
+		})
+)

example/custom-response.ts

@@ -5,7 +5,7 @@ const prettyJson = new Elysia()
 		if (response instanceof Object)
 			return new Response(JSON.stringify(response, null, 4))
 	})
-	.as('plugin')
+	.as('scoped')
 
 new Elysia()
 	.use(prettyJson)

example/openapi.ts

@@ -0,0 +1,76 @@
+import { Elysia, t } from '../src'
+import { openapi as OpenAPI } from '@elysiajs/openapi'
+import { fromTypes } from '@elysiajs/openapi/gen'
+
+const openapi = (a: any) =>
+	new Elysia().use((app) => {
+		app.use(
+			// @ts-ignore
+			OpenAPI(a)
+		)
+
+		return app
+	})
+
+// Elysia 1.4: lifecycle event type soundness
+export const app = new Elysia()
+	.use(
+		openapi({
+			references: fromTypes('example/openapi.ts')
+		})
+	)
+	.macro({
+		auth: {
+			response: {
+				409: t.Literal('Conflict')
+			},
+			beforeHandle({ status }) {
+				if (Math.random() < 0.05) return status(410)
+			},
+			resolve: () => ({ a: 'a' })
+		}
+	})
+	.onError(({ status }) => {
+		if (Math.random() < 0.05) return status(400)
+	})
+	.resolve(({ status }) => {
+		if (Math.random() < 0.05) return status(401)
+	})
+	.onBeforeHandle([
+		({ status }) => {
+			if (Math.random() < 0.05) return status(402)
+		},
+		({ status }) => {
+			if (Math.random() < 0.05) return status(403)
+		}
+	])
+	.guard({
+		beforeHandle: [
+			({ status }) => {
+				if (Math.random() < 0.05) return status(405)
+			},
+			({ status }) => {
+				if (Math.random() < 0.05) return status(406)
+			}
+		],
+		afterHandle({ status }) {
+			if (Math.random() < 0.05) return status(407)
+		},
+		error({ status }) {
+			if (Math.random() < 0.05) return status(408)
+		}
+	})
+	.post(
+		'/',
+		({ status }) =>
+			Math.random() < 0.05 ? status(409, 'Conflict') : 'Type Soundness',
+		{
+			auth: true,
+			response: {
+				411: t.Literal('Length Required')
+			}
+		}
+	)
+	.listen(3000)
+
+// app['~Routes']['post']['response']

example/websocket.ts

@@ -12,7 +12,7 @@ const app = new Elysia()
 		},
 		message(ws, message) {
 			ws.publish('asdf', message)
-			ws.send('asdf', message)
+			ws.send(message)
 		}
 	})
 	.get('/publish/:publish', ({ params: { publish: text } }) => {

package.json

@@ -1,7 +1,7 @@
 {
 	"name": "elysia",
 	"description": "Ergonomic Framework for Human",
-	"version": "1.3.21",
+	"version": "1.4.0",
 	"author": {
 		"name": "saltyAom",
 		"url": "https://github.com/SaltyAom",
@@ -184,35 +184,38 @@
 	},
 	"dependencies": {
 		"cookie": "^1.0.2",
-		"exact-mirror": "0.1.6",
+		"exact-mirror": "0.2.2",
 		"fast-decode-uri-component": "^1.0.1"
 	},
 	"devDependencies": {
+		"@elysiajs/openapi": "^1.3.11",
 		"@types/bun": "^1.2.16",
 		"@types/cookie": "^1.0.0",
 		"@types/fast-decode-uri-component": "^1.0.0",
 		"@typescript-eslint/eslint-plugin": "^8.30.1",
 		"@typescript-eslint/parser": "^8.30.1",
+		"arktype": "^2.1.22",
 		"eslint": "^9.24.0",
 		"eslint-plugin-security": "^3.0.1",
 		"eslint-plugin-sonarjs": "^3.0.2",
 		"expect-type": "^1.2.1",
 		"file-type": "^20.4.1",
 		"memoirist": "^0.4.0",
-		"mitata": "^1.0.34",
 		"prettier": "^3.5.3",
 		"tsup": "^8.4.0",
-		"typescript": "^5.8.3"
+		"typescript": "^5.8.3",
+		"valibot": "^1.1.0",
+		"zod": "^4.1.5"
 	},
 	"peerDependencies": {
-		"@sinclair/typebox": ">= 0.34.0",
+		"@sinclair/typebox": ">= 0.34.0 < 1",
 		"exact-mirror": ">= 0.0.9",
 		"file-type": ">= 20.0.0",
 		"openapi-types": ">= 12.0.0",
 		"typescript": ">= 5.0.0"
 	},
 	"optionalDependencies": {
-		"@sinclair/typebox": "^0.34.33",
-		"openapi-types": "^12.1.3"
+		"@sinclair/typebox": ">= 0.34.0 < 1",
+		"openapi-types": ">= 12.0.0"
 	}
 }

src/adapter/bun/compose.ts

@@ -7,7 +7,7 @@ import { status } from '../../error'
 import { ELYSIA_TRACE } from '../../trace'
 
 import type { AnyElysia } from '../..'
-import type { InternalRoute } from '../../types'
+import type { InternalRoute, InputSchema } from '../../types'
 
 const allocateIf = (value: string, condition: unknown) =>
 	condition ? value : ''
@@ -38,7 +38,9 @@ const createContext = (
 	const needsQuery =
 		inference.query ||
 		!!route.hooks.query ||
-		!!route.standaloneValidators?.find((x) => x.query) ||
+		!!(route.hooks.standaloneValidator as InputSchema[])?.find(
+			(x) => x.query
+		) ||
 		app.event.request?.length
 
 	if (needsQuery) fnLiteral += getQi
@@ -65,7 +67,6 @@ const createContext = (
 			hasTrace || inference.url || needsQuery
 		) +
 		`redirect,` +
-		`error:status,` +
 		`status,` +
 		`set:{headers:` +
 		(isNotEmpty(defaultHeaders)
@@ -131,7 +132,9 @@ export const createBunRouteHandler = (app: AnyElysia, route: InternalRoute) => {
 	const needsQuery =
 		inference.query ||
 		!!route.hooks.query ||
-		!!route.standaloneValidators?.find((x) => x.query)
+		!!(route.hooks.standaloneValidator as InputSchema[])?.find(
+			(x) => x.query
+		)
 
 	// inference.query require declaring const 'qi'
 	if (hasTrace || needsQuery || app.event.request?.length) {

src/adapter/bun/index.ts

@@ -485,7 +485,7 @@ export const BunAdapter: ElysiaAdapter = {
 					) as any
 
 				const handleResponse = createHandleWSResponse(validateResponse)
-				const parseMessage = createWSMessageParser(parse)
+				const parseMessage = createWSMessageParser(parse as any)
 
 				let _id: string | undefined
 

src/adapter/web-standard/index.ts

@@ -107,7 +107,6 @@ export const WebStandardAdapter: ElysiaAdapter = {
 				`path:p,` +
 				`url:u,` +
 				`redirect,` +
-				`error:status,` +
 				`status,` +
 				`set:{headers:`