elysia 2.0.0-beta.10 → 2.0.0-beta.12

package/dist/adapter/bun/index.js

@@ -233,6 +233,7 @@ const BunAdapter = require_adapter_index.createAdapter({
 		};
 		let startupFailure;
 		let forceRequested = false;
+		const force = Promise.withResolvers();
 		let forceDone = false;
 		let nativeStopped = false;
 		let abandoned = false;
@@ -362,7 +363,10 @@ const BunAdapter = require_adapter_index.createAdapter({
 		const stop = (closeActiveConnections, failure) => {
 			const reentrant = epoch.invoking;
 			if (failure) startupFailure ??= failure;
-			if (closeActiveConnections === true && !forceDone) forceRequested = true;
+			if (closeActiveConnections === true) {
+				force.resolve();
+				if (!forceDone) forceRequested = true;
+			}
 			cancelled = true;
 			clearAppServer(app, server);
 			let outcome;
@@ -381,7 +385,7 @@ const BunAdapter = require_adapter_index.createAdapter({
 					try {
 						await Promise.resolve();
 						if (modulesReady) try {
-							await modulesReady;
+							await Promise.race([modulesReady, force.promise]);
 						} catch (error) {
 							startupFailure ??= { error };
 						}
@@ -461,10 +465,10 @@ const BunAdapter = require_adapter_index.createAdapter({
 			publish();
 		};
 		try {
-			ready = (modulesReady = app.modules).then(start);
-			ready = ready.catch((error) => stop(true, { error }));
+			ready = (modulesReady = app.modules).then(start).catch((error) => stop(true, { error }));
 			ready.catch((error) => {
 				console.error("[Elysia] listen() failed:", error);
+				if (typeof process !== "undefined") process.exitCode = 1;
 			});
 		} catch (error) {
 			stop(true, { error }).catch(console.error);

package/dist/adapter/bun/index.mjs

@@ -232,6 +232,7 @@ const BunAdapter = createAdapter({
 		};
 		let startupFailure;
 		let forceRequested = false;
+		const force = Promise.withResolvers();
 		let forceDone = false;
 		let nativeStopped = false;
 		let abandoned = false;
@@ -361,7 +362,10 @@ const BunAdapter = createAdapter({
 		const stop = (closeActiveConnections, failure) => {
 			const reentrant = epoch.invoking;
 			if (failure) startupFailure ??= failure;
-			if (closeActiveConnections === true && !forceDone) forceRequested = true;
+			if (closeActiveConnections === true) {
+				force.resolve();
+				if (!forceDone) forceRequested = true;
+			}
 			cancelled = true;
 			clearAppServer(app, server);
 			let outcome;
@@ -380,7 +384,7 @@ const BunAdapter = createAdapter({
 					try {
 						await Promise.resolve();
 						if (modulesReady) try {
-							await modulesReady;
+							await Promise.race([modulesReady, force.promise]);
 						} catch (error) {
 							startupFailure ??= { error };
 						}
@@ -460,10 +464,10 @@ const BunAdapter = createAdapter({
 			publish();
 		};
 		try {
-			ready = (modulesReady = app.modules).then(start);
-			ready = ready.catch((error) => stop(true, { error }));
+			ready = (modulesReady = app.modules).then(start).catch((error) => stop(true, { error }));
 			ready.catch((error) => {
 				console.error("[Elysia] listen() failed:", error);
+				if (typeof process !== "undefined") process.exitCode = 1;
 			});
 		} catch (error) {
 			stop(true, { error }).catch(console.error);

package/dist/adapter/web-standard/handler.js

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_universal_constants = require('../../universal/constants.js');
 const require_universal_file = require('../../universal/file.js');
 const require_utils = require('../../utils.js');
+const require_universal_is_production = require('../../universal/is-production.js');
 const require_error = require('../../error.js');
 const require_adapter_default_headers = require('../default-headers.js');
 const require_adapter_utils = require('../utils.js');
@@ -46,7 +47,7 @@ function mapResponseWithSet(response, set, request, owned) {
 		case "File":
 		case "Blob": return require_adapter_utils.handleFile(response, set, request);
 		case "ElysiaStatus":
-			set.status = response.code;
+			set.status = response.status;
 			if (response.headers) Object.assign(require_adapter_utils.materializeSetHeaders(set), response.headers);
 			return mapResponseWithSet(response.response, set, request, owned);
 		case void 0: return response ? Response.json(response, set) : new Response(null, set);
@@ -58,11 +59,16 @@ function mapResponseWithSet(response, set, request, owned) {
 		default: return mapFallback(response, set, request, owned);
 	}
 }
+const checkRemovedSetRedirect = !require_universal_is_production.isProduction();
 function mapResponse(response, set, request, owned) {
+	if (checkRemovedSetRedirect && Object.hasOwn(set, "redirect") && !require_universal_is_production.isProduction()) {
+		delete set.redirect;
+		throw new Error("[Elysia] set.redirect was removed in 2.0 — return redirect(url) instead");
+	}
 	const headers = set.headers;
 	if (set.status !== void 0 || set.cookie || headers["\0"] === headers || require_utils.isNotEmpty(headers)) return mapResponseWithSet(response, set, request, owned);
 	if (response instanceof require_error.ElysiaStatus) {
-		set.status = response.code;
+		set.status = response.status;
 		if (response.headers) Object.assign(set.headers, response.headers);
 		return mapResponse(response.response, set, request, owned);
 	}
@@ -84,7 +90,7 @@ function mapCompactResponse(response, request, owned) {
 		case "File":
 		case "Blob": return require_adapter_utils.handleFile(response, void 0, request);
 		case "ElysiaStatus": return mapResponse(response.response, {
-			status: response.code,
+			status: response.status,
 			headers: response.headers ? Object.assign(require_utils.nullObject(), response.headers) : require_utils.nullObject()
 		}, request, owned);
 		case void 0: return response ? Response.json(response) : new Response("");
@@ -121,14 +127,14 @@ function mapFallback(response, set, request, owned = false) {
 	if (response instanceof Promise) return response.then((x) => set ? mapResponse(x, set, request, owned) : mapCompactResponse(x, request, owned));
 	if (response instanceof Error) return errorToResponse(response, set, request, owned);
 	if (response instanceof require_error.ElysiaStatus) if (set) {
-		set.status = response.code;
+		set.status = response.status;
 		if (response.headers) set.headers = {
 			...set.headers,
 			...response.headers
 		};
 		return mapResponse(response.response, set, request, owned);
 	} else return mapResponse(response.response, {
-		status: response.code,
+		status: response.status,
 		headers: response.headers ? { ...response.headers } : {}
 	}, request, owned);
 	if (response instanceof require_universal_file.ElysiaFile) return handleElysiaFile(response, void 0, request);

package/dist/adapter/web-standard/handler.mjs

@@ -1,6 +1,7 @@
 import { isBun } from "../../universal/constants.mjs";
 import { ElysiaFile, mime } from "../../universal/file.mjs";
 import { formToFormData, isElysiaForm, isNotEmpty, nullObject } from "../../utils.mjs";
+import { isProduction } from "../../universal/is-production.mjs";
 import { ElysiaStatus, PROBLEM_JSON, internalServerErrorBody } from "../../error.mjs";
 import { defaultHeaders } from "../default-headers.mjs";
 import { createResponseHandler, createStreamHandler, handleFile, handleSet, materializeSetHeaders } from "../utils.mjs";
@@ -45,7 +46,7 @@ function mapResponseWithSet(response, set, request, owned) {
 		case "File":
 		case "Blob": return handleFile(response, set, request);
 		case "ElysiaStatus":
-			set.status = response.code;
+			set.status = response.status;
 			if (response.headers) Object.assign(materializeSetHeaders(set), response.headers);
 			return mapResponseWithSet(response.response, set, request, owned);
 		case void 0: return response ? Response.json(response, set) : new Response(null, set);
@@ -57,11 +58,16 @@ function mapResponseWithSet(response, set, request, owned) {
 		default: return mapFallback(response, set, request, owned);
 	}
 }
+const checkRemovedSetRedirect = !isProduction();
 function mapResponse(response, set, request, owned) {
+	if (checkRemovedSetRedirect && Object.hasOwn(set, "redirect") && !isProduction()) {
+		delete set.redirect;
+		throw new Error("[Elysia] set.redirect was removed in 2.0 — return redirect(url) instead");
+	}
 	const headers = set.headers;
 	if (set.status !== void 0 || set.cookie || headers["\0"] === headers || isNotEmpty(headers)) return mapResponseWithSet(response, set, request, owned);
 	if (response instanceof ElysiaStatus) {
-		set.status = response.code;
+		set.status = response.status;
 		if (response.headers) Object.assign(set.headers, response.headers);
 		return mapResponse(response.response, set, request, owned);
 	}
@@ -83,7 +89,7 @@ function mapCompactResponse(response, request, owned) {
 		case "File":
 		case "Blob": return handleFile(response, void 0, request);
 		case "ElysiaStatus": return mapResponse(response.response, {
-			status: response.code,
+			status: response.status,
 			headers: response.headers ? Object.assign(nullObject(), response.headers) : nullObject()
 		}, request, owned);
 		case void 0: return response ? Response.json(response) : new Response("");
@@ -120,14 +126,14 @@ function mapFallback(response, set, request, owned = false) {
 	if (response instanceof Promise) return response.then((x) => set ? mapResponse(x, set, request, owned) : mapCompactResponse(x, request, owned));
 	if (response instanceof Error) return errorToResponse(response, set, request, owned);
 	if (response instanceof ElysiaStatus) if (set) {
-		set.status = response.code;
+		set.status = response.status;
 		if (response.headers) set.headers = {
 			...set.headers,
 			...response.headers
 		};
 		return mapResponse(response.response, set, request, owned);
 	} else return mapResponse(response.response, {
-		status: response.code,
+		status: response.status,
 		headers: response.headers ? { ...response.headers } : {}
 	}, request, owned);
 	if (response instanceof ElysiaFile) return handleElysiaFile(response, void 0, request);

package/dist/base.d.ts

@@ -101,6 +101,11 @@ declare class Elysia<const in out BasePath extends string = '', const in out Sco
   '~scopeChild'?: boolean;
   '~scopeChildren'?: AnyElysia[];
   constructor(config?: ElysiaConfig<BasePath, Scope>);
+  /**
+   * Every registered route with its merged hooks.
+   * Development shares a frozen cache. Production rebuilds the list so its
+   * metadata can be released after startup.
+   */
   get routes(): PublicRoute[];
   /**
    * ### decorate

package/dist/base.js

@@ -45,6 +45,42 @@ const mergeExtCallbacks = (target, incoming) => {
 	index.indexedLength = target.length;
 };
 const canRegisterLoose = (path, isDynamic) => !isDynamic && (path.length === 0 || path.charCodeAt(path.length - 1) === 47);
+const isSchemaValue = (value) => {
+	if (value == null || typeof value === "string") return true;
+	if (typeof value !== "object" && typeof value !== "function") return false;
+	return "~kind" in value || "~standard" in value || "~elyAcl" in value || typeof value.Check === "function";
+};
+const hookKeys = new Set([
+	...require_utils.schemaProperties,
+	...require_utils.eventProperties,
+	"detail",
+	"tags"
+]);
+const hasHookKeys = (value) => {
+	for (const key in value) if (hookKeys.has(key)) return true;
+	return false;
+};
+const isPlainObject = (value) => {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
+};
+const assertSchemaShape = (hook, where) => {
+	for (const key in hook) {
+		if (!require_utils.schemaProperties.has(key)) continue;
+		const value = hook[key];
+		if (isSchemaValue(value)) continue;
+		if (key === "response" && isPlainObject(value)) {
+			let isStatusMap = true;
+			for (const status in value) if (status !== "default" && isNaN(+status) || !isSchemaValue(value[status])) {
+				isStatusMap = false;
+				break;
+			}
+			if (isStatusMap) continue;
+		}
+		throw new Error(`[Elysia] ${where}: "${key}" is not a schema — use t.Object({ ... })`);
+	}
+};
 /**
 * Every key a single route must answer to, in registration order.
 *
@@ -173,6 +209,11 @@ var Elysia = class Elysia {
 			if (adapter?.setup) this.#useFn(adapter.setup);
 		} else this["~Prefix"] = void 0;
 	}
+	/**
+	* Every registered route with its merged hooks.
+	* Development shares a frozen cache. Production rebuilds the list so its
+	* metadata can be released after startup.
+	*/
 	get routes() {
 		const generation = this["~generation"];
 		if (this.#isCacheable && this.cachedGeneration === generation && this.cachedEpoch === mutationEpoch && this.cachedRoutes !== void 0) return this.cachedRoutes;
@@ -192,7 +233,8 @@ var Elysia = class Elysia {
 				hooks: merged
 			};
 		});
-		if (this.#isCacheable) {
+		if (this.#isCacheable && !require_universal_is_production.isProduction()) {
+			Object.freeze(routes);
 			this.#cacheRoutes(generation);
 			this.cachedRoutes = routes;
 		}
@@ -428,6 +470,7 @@ var Elysia = class Elysia {
 		return this;
 	}
 	#guard(scope, hook) {
+		if (hook) assertSchemaShape(hook, ".guard()");
 		hook = require_schema_snapshot.snapshotHookSchemas(hook);
 		require_utils.hookToGuard(hook);
 		const trackFn = (fn) => {
@@ -540,13 +583,17 @@ var Elysia = class Elysia {
 		};
 		return this;
 	}
-	macro(macro) {
+	macro(macro, definition) {
 		this.#assertMutable("macro");
 		if (typeof macro === "function") throw new Error("use `.macro({ name: fn })` instead of `.macro(fn)`");
+		if (definition != null || typeof macro === "string") throw new Error("[Elysia] .macro(name, definition) was removed in 2.0 — use .macro({ [name]: definition })");
 		const m = this.#ensureMacroTable();
 		const baseline = this.macroBaseline;
 		for (const key in macro) {
-			if (typeof macro[key] === "object") macro[key] = require_utils.hookToGuard(macro[key]);
+			if (typeof macro[key] === "object") {
+				if (macro[key]) assertSchemaShape(macro[key], `.macro(${key})`);
+				macro[key] = require_utils.hookToGuard(macro[key]);
+			}
 			if (this.hash !== void 0 && !require_utils.macroOrigin.has(macro[key])) require_utils.macroOrigin.set(macro[key], this.hash);
 			if (baseline?.has(key) && key in m && m[key] !== macro[key]) throw new Error(`[Elysia] Macro "${key}" can be only define once`);
 		}
@@ -1047,6 +1094,8 @@ var Elysia = class Elysia {
 	#add(method, path, hookOrFn, fn, hasHook = fn !== void 0) {
 		if (this["~Prefix"]) path = require_utils.joinPath(this["~Prefix"], path);
 		else if (path && path.charCodeAt(0) !== 47) path = "/" + path;
+		if (typeof hookOrFn === "function" && !hasHookKeys(hookOrFn) && isPlainObject(fn) && hasHookKeys(fn)) throw new Error(`[Elysia] .${method === "*" ? "all" : method.toLowerCase()}('${path}', handler, hook) is the 1.x order; Elysia 2 takes (path, hook, handler) — see the 2.0 migration guide`);
+		if (hasHook && hookOrFn) assertSchemaShape(hookOrFn, `${method} ${path}`);
 		const handler = hasHook ? fn : hookOrFn;
 		const hook = hasHook ? require_schema_snapshot.snapshotHookSchemas(hookOrFn) : void 0;
 		const appHook = this["~hookChain"];
@@ -1398,6 +1447,56 @@ var Elysia = class Elysia {
 		}
 		return false;
 	}
+	static #slotHasTypeBox(value, models, record) {
+		if (typeof value === "string") value = models?.[value];
+		if (!value || typeof value !== "object") return false;
+		if ("~kind" in value || "~elyAcl" in value) return true;
+		if (!record || "~standard" in value) return false;
+		for (const status in value) if (Elysia.#slotHasTypeBox(value[status], models)) return true;
+		return false;
+	}
+	static #hookHasTypeBox(h, models) {
+		if (!h || typeof h !== "object") return false;
+		for (const key in h) {
+			if (key === "schemas") {
+				const schemas = h[key];
+				if (Array.isArray(schemas)) {
+					for (let s = 0; s < schemas.length; s++) if (Elysia.#hookHasTypeBox(schemas[s], models)) return true;
+				}
+				continue;
+			}
+			if (require_utils.schemaProperties.has(key) && Elysia.#slotHasTypeBox(h[key], models, key === "response")) return true;
+		}
+		return false;
+	}
+	static #chainHasTypeBox(node, models, seen, resolve) {
+		while (node) {
+			if (seen.has(node)) return false;
+			seen.add(node);
+			if ("added" in node) {
+				if (Elysia.#hookHasTypeBox(resolve ? resolve(node) : node.added, models)) return true;
+				node = node.parent;
+			} else {
+				if (Elysia.#chainHasTypeBox(node.combine, models, seen, resolve)) return true;
+				node = node.over;
+			}
+		}
+		return false;
+	}
+	/**
+	* Scan each route and its inherited hooks for TypeBox schemas.
+	* This may warm TypeBox after a closer schema overrides it, avoiding a full
+	* hook merge during build.
+	*/
+	#hasTypeBoxSchema(table) {
+		const models = this["~ext"]?.models;
+		const resolve = require_compile_handler_index.chainResolver(this);
+		const rootChain = this["~hookChain"];
+		const seen = /* @__PURE__ */ new Set();
+		const { localHook, appHook, inheritedChain, owner } = table;
+		for (let i = 0; i < table.length; i++) if (Elysia.#hookHasTypeBox(localHook[i], models) || Elysia.#chainHasTypeBox(appHook[i], models, seen, resolve) || Elysia.#chainHasTypeBox(inheritedChain[i], models, seen, resolve) || owner[i] !== this && Elysia.#chainHasTypeBox(rootChain, models, seen, resolve)) return true;
+		return false;
+	}
 	#routeMayHaveModelRef(table, i) {
 		const macroScope = table.macroScope?.get(i);
 		const owner = table.owner[i];
@@ -1551,6 +1650,9 @@ var Elysia = class Elysia {
 		const appChain = this["~hookChain"];
 		if (this["~ext"]?.macro || this["~scopeChildren"] || appChain !== void 0 && appChain.refs) for (let i = 0; i < length; i++) this.#assertRouteModelRefs(require_route_table.routeRow(table, i), method[i]);
 		else for (let i = 0; i < length; i++) if (this.#routeMayHaveModelRef(table, i)) this.#assertRouteModelRefs(require_route_table.routeRow(table, i), method[i]);
+		if (length && this.#hasTypeBoxSchema(table)) try {
+			require_type_bridge.warmTypebox();
+		} catch {}
 		let markDuplicates = false;
 		if (length) {
 			const programId = this["~programId"];
@@ -1640,7 +1742,10 @@ var Elysia = class Elysia {
 	}
 	listen(options, callback) {
 		const listen = (this["~config"]?.adapter ?? (require_universal_constants.isBun ? require_adapter_bun_index.BunAdapter : void 0))?.listen;
-		if (!listen) throw new Error("No adapter provided for listen()");
+		if (!listen) {
+			const deno = typeof Deno !== "undefined";
+			throw new Error(`[Elysia] listen() requires an adapter on ${deno ? "Deno" : typeof process === "undefined" ? "this runtime" : "Node.js"} — https://elysiajs.com/integrations/${deno ? "deno" : "node"}`);
+		}
 		if (!require_compile_aot.Capture.isAotBuildEnv()) listen(this, options, callback);
 		return this;
 	}

package/dist/base.mjs

@@ -1,10 +1,10 @@
 import { isBun } from "./universal/constants.mjs";
 import { clonePlainDecorators, clonePlainDeep, coalesceSchemas, createErrorEventHandler, eventProperties, fnOrigin, fnv1a, getLoosePath, guardNonPlainLeaves, hookToGuard, invalidateMacroEpoch, isEmpty, isNotEmpty, isRecordNumber, joinPath, macroOrigin, mapDeriveEntry, mergeDeep, mergeResponse, nullObject, pushField, schemaProperties, serializeMacroSeed, throwLifecycleErrors } from "./utils.mjs";
-import { Ref } from "./type/bridge.mjs";
+import { Ref, warmTypebox } from "./type/bridge.mjs";
 import { isProduction } from "./universal/is-production.mjs";
 import { Capture, Compiled, beginCompilerSession, createAotFingerprint, endCompilerSession } from "./compile/aot.mjs";
 import { traceCapabilityRequired, wsCapabilityRequired } from "./generation.mjs";
-import { compileHandler, composeRouteHook, localMacroRoot, resolveLocalHook } from "./compile/handler/index.mjs";
+import { chainResolver, compileHandler, composeRouteHook, localMacroRoot, resolveLocalHook } from "./compile/handler/index.mjs";
 import { RouteFlag, buildRouteTable, routeRow } from "./route-table.mjs";
 import { BunAdapter } from "./adapter/bun/index.mjs";
 import { clearContextCache } from "./context.mjs";
@@ -42,6 +42,42 @@ const mergeExtCallbacks = (target, incoming) => {
 	index.indexedLength = target.length;
 };
 const canRegisterLoose = (path, isDynamic) => !isDynamic && (path.length === 0 || path.charCodeAt(path.length - 1) === 47);
+const isSchemaValue = (value) => {
+	if (value == null || typeof value === "string") return true;
+	if (typeof value !== "object" && typeof value !== "function") return false;
+	return "~kind" in value || "~standard" in value || "~elyAcl" in value || typeof value.Check === "function";
+};
+const hookKeys = new Set([
+	...schemaProperties,
+	...eventProperties,
+	"detail",
+	"tags"
+]);
+const hasHookKeys = (value) => {
+	for (const key in value) if (hookKeys.has(key)) return true;
+	return false;
+};
+const isPlainObject = (value) => {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
+};
+const assertSchemaShape = (hook, where) => {
+	for (const key in hook) {
+		if (!schemaProperties.has(key)) continue;
+		const value = hook[key];
+		if (isSchemaValue(value)) continue;
+		if (key === "response" && isPlainObject(value)) {
+			let isStatusMap = true;
+			for (const status in value) if (status !== "default" && isNaN(+status) || !isSchemaValue(value[status])) {
+				isStatusMap = false;
+				break;
+			}
+			if (isStatusMap) continue;
+		}
+		throw new Error(`[Elysia] ${where}: "${key}" is not a schema — use t.Object({ ... })`);
+	}
+};
 /**
 * Every key a single route must answer to, in registration order.
 *
@@ -170,6 +206,11 @@ var Elysia = class Elysia {
 			if (adapter?.setup) this.#useFn(adapter.setup);
 		} else this["~Prefix"] = void 0;
 	}
+	/**
+	* Every registered route with its merged hooks.
+	* Development shares a frozen cache. Production rebuilds the list so its
+	* metadata can be released after startup.
+	*/
 	get routes() {
 		const generation = this["~generation"];
 		if (this.#isCacheable && this.cachedGeneration === generation && this.cachedEpoch === mutationEpoch && this.cachedRoutes !== void 0) return this.cachedRoutes;
@@ -189,7 +230,8 @@ var Elysia = class Elysia {
 				hooks: merged
 			};
 		});
-		if (this.#isCacheable) {
+		if (this.#isCacheable && !isProduction()) {
+			Object.freeze(routes);
 			this.#cacheRoutes(generation);
 			this.cachedRoutes = routes;
 		}
@@ -425,6 +467,7 @@ var Elysia = class Elysia {
 		return this;
 	}
 	#guard(scope, hook) {
+		if (hook) assertSchemaShape(hook, ".guard()");
 		hook = snapshotHookSchemas(hook);
 		hookToGuard(hook);
 		const trackFn = (fn) => {
@@ -537,13 +580,17 @@ var Elysia = class Elysia {
 		};
 		return this;
 	}
-	macro(macro) {
+	macro(macro, definition) {
 		this.#assertMutable("macro");
 		if (typeof macro === "function") throw new Error("use `.macro({ name: fn })` instead of `.macro(fn)`");
+		if (definition != null || typeof macro === "string") throw new Error("[Elysia] .macro(name, definition) was removed in 2.0 — use .macro({ [name]: definition })");
 		const m = this.#ensureMacroTable();
 		const baseline = this.macroBaseline;
 		for (const key in macro) {
-			if (typeof macro[key] === "object") macro[key] = hookToGuard(macro[key]);
+			if (typeof macro[key] === "object") {
+				if (macro[key]) assertSchemaShape(macro[key], `.macro(${key})`);
+				macro[key] = hookToGuard(macro[key]);
+			}
 			if (this.hash !== void 0 && !macroOrigin.has(macro[key])) macroOrigin.set(macro[key], this.hash);
 			if (baseline?.has(key) && key in m && m[key] !== macro[key]) throw new Error(`[Elysia] Macro "${key}" can be only define once`);
 		}
@@ -1044,6 +1091,8 @@ var Elysia = class Elysia {
 	#add(method, path, hookOrFn, fn, hasHook = fn !== void 0) {
 		if (this["~Prefix"]) path = joinPath(this["~Prefix"], path);
 		else if (path && path.charCodeAt(0) !== 47) path = "/" + path;
+		if (typeof hookOrFn === "function" && !hasHookKeys(hookOrFn) && isPlainObject(fn) && hasHookKeys(fn)) throw new Error(`[Elysia] .${method === "*" ? "all" : method.toLowerCase()}('${path}', handler, hook) is the 1.x order; Elysia 2 takes (path, hook, handler) — see the 2.0 migration guide`);
+		if (hasHook && hookOrFn) assertSchemaShape(hookOrFn, `${method} ${path}`);
 		const handler = hasHook ? fn : hookOrFn;
 		const hook = hasHook ? snapshotHookSchemas(hookOrFn) : void 0;
 		const appHook = this["~hookChain"];
@@ -1395,6 +1444,56 @@ var Elysia = class Elysia {
 		}
 		return false;
 	}
+	static #slotHasTypeBox(value, models, record) {
+		if (typeof value === "string") value = models?.[value];
+		if (!value || typeof value !== "object") return false;
+		if ("~kind" in value || "~elyAcl" in value) return true;
+		if (!record || "~standard" in value) return false;
+		for (const status in value) if (Elysia.#slotHasTypeBox(value[status], models)) return true;
+		return false;
+	}
+	static #hookHasTypeBox(h, models) {
+		if (!h || typeof h !== "object") return false;
+		for (const key in h) {
+			if (key === "schemas") {
+				const schemas = h[key];
+				if (Array.isArray(schemas)) {
+					for (let s = 0; s < schemas.length; s++) if (Elysia.#hookHasTypeBox(schemas[s], models)) return true;
+				}
+				continue;
+			}
+			if (schemaProperties.has(key) && Elysia.#slotHasTypeBox(h[key], models, key === "response")) return true;
+		}
+		return false;
+	}
+	static #chainHasTypeBox(node, models, seen, resolve) {
+		while (node) {
+			if (seen.has(node)) return false;
+			seen.add(node);
+			if ("added" in node) {
+				if (Elysia.#hookHasTypeBox(resolve ? resolve(node) : node.added, models)) return true;
+				node = node.parent;
+			} else {
+				if (Elysia.#chainHasTypeBox(node.combine, models, seen, resolve)) return true;
+				node = node.over;
+			}
+		}
+		return false;
+	}
+	/**
+	* Scan each route and its inherited hooks for TypeBox schemas.
+	* This may warm TypeBox after a closer schema overrides it, avoiding a full
+	* hook merge during build.
+	*/
+	#hasTypeBoxSchema(table) {
+		const models = this["~ext"]?.models;
+		const resolve = chainResolver(this);
+		const rootChain = this["~hookChain"];
+		const seen = /* @__PURE__ */ new Set();
+		const { localHook, appHook, inheritedChain, owner } = table;
+		for (let i = 0; i < table.length; i++) if (Elysia.#hookHasTypeBox(localHook[i], models) || Elysia.#chainHasTypeBox(appHook[i], models, seen, resolve) || Elysia.#chainHasTypeBox(inheritedChain[i], models, seen, resolve) || owner[i] !== this && Elysia.#chainHasTypeBox(rootChain, models, seen, resolve)) return true;
+		return false;
+	}
 	#routeMayHaveModelRef(table, i) {
 		const macroScope = table.macroScope?.get(i);
 		const owner = table.owner[i];
@@ -1548,6 +1647,9 @@ var Elysia = class Elysia {
 		const appChain = this["~hookChain"];
 		if (this["~ext"]?.macro || this["~scopeChildren"] || appChain !== void 0 && appChain.refs) for (let i = 0; i < length; i++) this.#assertRouteModelRefs(routeRow(table, i), method[i]);
 		else for (let i = 0; i < length; i++) if (this.#routeMayHaveModelRef(table, i)) this.#assertRouteModelRefs(routeRow(table, i), method[i]);
+		if (length && this.#hasTypeBoxSchema(table)) try {
+			warmTypebox();
+		} catch {}
 		let markDuplicates = false;
 		if (length) {
 			const programId = this["~programId"];
@@ -1637,7 +1739,10 @@ var Elysia = class Elysia {
 	}
 	listen(options, callback) {
 		const listen = (this["~config"]?.adapter ?? (isBun ? BunAdapter : void 0))?.listen;
-		if (!listen) throw new Error("No adapter provided for listen()");
+		if (!listen) {
+			const deno = typeof Deno !== "undefined";
+			throw new Error(`[Elysia] listen() requires an adapter on ${deno ? "Deno" : typeof process === "undefined" ? "this runtime" : "Node.js"} — https://elysiajs.com/integrations/${deno ? "deno" : "node"}`);
+		}
 		if (!Capture.isAotBuildEnv()) listen(this, options, callback);
 		return this;
 	}

package/dist/compile/aot-capture.d.ts

@@ -1,24 +1,13 @@
-import { CaptureImpl, CapturedHandler, CapturedValidator, CompiledSnapshot } from "./aot.js";
+import { CapturedHandler, CapturedValidator, CompiledSnapshot } from "./aot.js";
 
 //#region src/compile/aot-capture.d.ts
-declare function resetCompactErrorWarnings(): void;
 declare function beginValidatorCapture(): void;
 declare function abortCapture(): void;
 declare function endValidatorCapture(): CapturedValidator[];
 declare function endHandlerCapture(): CapturedHandler[];
-/** @internal deterministic session/capture assertions. */
-declare const getCompilerSessionDiagnostics: () => {
-  active: boolean;
-  appAttached: boolean;
-  validators: number;
-  handlers: number;
-  sucrose: number;
-};
 /** @internal preserve registry around in-process AOT analysis */
 declare const snapshotCompiled: () => CompiledSnapshot;
 /** @internal restore registry after in-process AOT analysis */
 declare function restoreCompiled(snapshot: CompiledSnapshot): void;
-declare const impl: CaptureImpl;
-declare function installCaptureImpl(): void;
 //#endregion
-export { abortCapture, beginValidatorCapture, impl as captureImplementation, endHandlerCapture, endValidatorCapture, getCompilerSessionDiagnostics, installCaptureImpl, resetCompactErrorWarnings, restoreCompiled, snapshotCompiled };
+export { abortCapture, beginValidatorCapture, endHandlerCapture, endValidatorCapture, restoreCompiled, snapshotCompiled };