@mastra/nestjs 0.2.26 → 0.2.27-alpha.5

package/README.md

@@ -35,7 +35,7 @@ import { NestFactory } from '@nestjs/core';
 import { AppModule } from './app.module';
 
 async function bootstrap() {
-  const app = await NestFactory.create(AppModule);
+  const app = await NestFactory.create(AppModule, { bodyParser: false });
   await app.listen(3000);
 }
 
@@ -48,6 +48,8 @@ bootstrap();
 
 The module registers Mastra routes under `/api` by default. Because it uses a catch-all NestJS controller, either import `MastraModule` last or assign a dedicated prefix such as `/api/mastra`.
 
+Disable NestJS's default body parser when creating the application. `MastraModule` installs its own JSON parser so body limits, DELETE request bodies, scalar JSON, and route schema validation use the same adapter behavior.
+
 - [NestJS adapter reference](https://mastra.ai/reference/server/nestjs-adapter)
 
 ## Changelog

package/dist/_types/rxjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/filters/mastra-exception.filter.d.ts

@@ -15,7 +15,7 @@ import type { ArgumentsHost, ExceptionFilter } from '@nestjs/common';
  */
 export declare class MastraExceptionFilter implements ExceptionFilter {
     private readonly logger;
-    catch(exception: unknown, host: ArgumentsHost): void;
+    catch(exception: unknown, host: ArgumentsHost): Promise<void>;
     /**
      * Normalize any error type to a consistent format.
      */

package/dist/filters/mastra-exception.filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mastra-exception.filter.d.ts","sourceRoot":"","sources":["../../src/filters/mastra-exception.filter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAYrE;;;;;;;;;;;;;GAaG;AACH,qBACa,qBAAsB,YAAW,eAAe;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IAEjE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAgCnD;IAED;;OAEG;IACH,OAAO,CAAC,cAAc;IAgHtB;;OAEG;IACH,OAAO,CAAC,YAAY;CAkCrB"}
+{"version":3,"file":"mastra-exception.filter.d.ts","sourceRoot":"","sources":["../../src/filters/mastra-exception.filter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAYrE;;;;;;;;;;;;;GAaG;AACH,qBACa,qBAAsB,YAAW,eAAe;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IAE3D,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAyDlE;IAED;;OAEG;IACH,OAAO,CAAC,cAAc;IAgHtB;;OAEG;IACH,OAAO,CAAC,YAAY;CAkCrB"}

package/dist/index.cjs

@@ -86,6 +86,27 @@ function __decorate(decorators, target, key, desc) {
 //#endregion
 //#region src/services/route-handler.service.ts
 var _RouteHandlerService;
+const VALIDATION_CONTEXT_LABELS = {
+	query: "query parameters",
+	body: "request body",
+	path: "path parameters"
+};
+function getSchemaTypeName(schema) {
+	if (!schema || typeof schema !== "object") return;
+	const definition = schema._def ?? schema.def;
+	return definition?.typeName ?? definition?.type;
+}
+function unwrapOptionalNullable(schema) {
+	let inner = schema;
+	let typeName = getSchemaTypeName(inner);
+	while (typeName === "ZodOptional" || typeName === "optional" || typeName === "ZodNullable" || typeName === "nullable") {
+		const definition = inner?._def ?? inner?.def;
+		if (!definition?.innerType) return inner;
+		inner = definition.innerType;
+		typeName = getSchemaTypeName(inner);
+	}
+	return inner;
+}
 let RouteHandlerService = _RouteHandlerService = class RouteHandlerService {
 	mastra;
 	options;
@@ -103,10 +124,14 @@ let RouteHandlerService = _RouteHandlerService = class RouteHandlerService {
 		this.mastra = mastra;
 		this.options = options;
 		this.routeMap = /* @__PURE__ */ new Map();
-		for (const route of _mastra_server_server_adapter.SERVER_ROUTES) {
-			const key = this.getRouteKey(route.method, route.path);
-			this.routeMap.set(key, route);
-		}
+		for (const route of _mastra_server_server_adapter.SERVER_ROUTES) this.registerRoute(route);
+	}
+	/**
+	* Register a route with the catch-all NestJS controller.
+	*/
+	registerRoute(route) {
+		const key = this.getRouteKey(route.method, route.path);
+		this.routeMap.set(key, route);
 	}
 	/**
 	* Find a route by exact method and path pattern.
@@ -133,7 +158,7 @@ let RouteHandlerService = _RouteHandlerService = class RouteHandlerService {
 				route: exactRoute,
 				pathParams: {}
 			};
-			for (const route of _mastra_server_server_adapter.SERVER_ROUTES) {
+			for (const route of this.routeMap.values()) {
 				if (route.method.toUpperCase() !== checkMethod) continue;
 				const pathParams = this.matchPath(route.path, path);
 				if (pathParams) return {
@@ -148,7 +173,7 @@ let RouteHandlerService = _RouteHandlerService = class RouteHandlerService {
 	* Get all routes (for dynamic controller generation).
 	*/
 	getAllRoutes() {
-		return _mastra_server_server_adapter.SERVER_ROUTES;
+		return Array.from(this.routeMap.values());
 	}
 	/**
 	* Match a path against a route pattern.
@@ -182,21 +207,21 @@ let RouteHandlerService = _RouteHandlerService = class RouteHandlerService {
 		if (route.pathParamSchema) try {
 			validatedPathParams = await route.pathParamSchema.parseAsync(params.pathParams);
 		} catch (error) {
-			if ((0, _mastra_server_server_adapter.isZodError)(error)) throw new ValidationError("Invalid path parameters", error);
+			if ((0, _mastra_server_server_adapter.isZodError)(error)) throw this.createValidationError(route, error, "path");
 			throw error;
 		}
 		let validatedQueryParams = params.queryParams;
 		if (route.queryParamSchema) try {
 			validatedQueryParams = await route.queryParamSchema.parseAsync(params.queryParams);
 		} catch (error) {
-			if ((0, _mastra_server_server_adapter.isZodError)(error)) throw new ValidationError("Invalid query parameters", error);
+			if ((0, _mastra_server_server_adapter.isZodError)(error)) throw this.createValidationError(route, error, "query");
 			throw error;
 		}
 		let validatedBody = params.body;
-		if (route.bodySchema && params.body !== void 0) try {
-			validatedBody = await route.bodySchema.parseAsync(params.body);
+		if (route.bodySchema) try {
+			validatedBody = await this.parseBody(route, params.body);
 		} catch (error) {
-			if ((0, _mastra_server_server_adapter.isZodError)(error)) throw new ValidationError("Invalid request body", error);
+			if ((0, _mastra_server_server_adapter.isZodError)(error)) throw this.createValidationError(route, error, "body");
 			throw error;
 		}
 		const context = {
@@ -221,6 +246,31 @@ let RouteHandlerService = _RouteHandlerService = class RouteHandlerService {
 			sseFlushOnConnect: route.sseFlushOnConnect
 		};
 	}
+	async parseBody(route, body) {
+		const bodySchema = route.bodySchema;
+		if (!bodySchema) return body;
+		if (body === void 0) {
+			const omitted = await bodySchema.safeParseAsync(void 0);
+			if (omitted.success) return omitted.data;
+			const schemaType = getSchemaTypeName(unwrapOptionalNullable(bodySchema));
+			if (schemaType === "object" || schemaType === "ZodObject") {
+				const emptyObject = await bodySchema.safeParseAsync({});
+				if (emptyObject.success) return emptyObject.data;
+			}
+			throw omitted.error;
+		}
+		return bodySchema.parseAsync(body);
+	}
+	createValidationError(route, error, context) {
+		const hook = route.onValidationError ?? this.mastra.getServer()?.onValidationError;
+		if (hook) try {
+			const result = hook(error, context);
+			if (result) return new ValidationError(`Invalid ${VALIDATION_CONTEXT_LABELS[context]}`, error, result.status, result.body);
+		} catch (hookError) {
+			this.logger.error("Error in custom onValidationError hook", hookError);
+		}
+		return new ValidationError(`Invalid ${VALIDATION_CONTEXT_LABELS[context]}`, error, 400, (0, _mastra_server_handlers_error.formatZodError)(error, VALIDATION_CONTEXT_LABELS[context]));
+	}
 	getRouteKey(method, path) {
 		return `${method.toUpperCase()}:${path}`;
 	}
@@ -254,9 +304,13 @@ RouteHandlerService = _RouteHandlerService = __decorate([
 */
 var ValidationError = class extends Error {
 	zodError;
-	constructor(message, zodError) {
+	status;
+	body;
+	constructor(message, zodError, status = 400, body = (0, _mastra_server_handlers_error.formatZodError)(zodError, "request")) {
 		super(message);
 		this.zodError = zodError;
+		this.status = status;
+		this.body = body;
 		this.name = "ValidationError";
 	}
 };
@@ -265,11 +319,29 @@ var ValidationError = class extends Error {
 var _MastraExceptionFilter;
 let MastraExceptionFilter = _MastraExceptionFilter = class MastraExceptionFilter {
 	logger = new _nestjs_common.Logger(_MastraExceptionFilter.name);
-	catch(exception, host) {
+	async catch(exception, host) {
 		const ctx = host.switchToHttp();
 		const response = ctx.getResponse();
 		const request = ctx.getRequest();
 		if (response.headersSent) return;
+		if (exception instanceof ValidationError) {
+			response.status(exception.status).json(exception.body);
+			return;
+		}
+		const customResponse = (0, _mastra_server_server_adapter.getCustomHTTPExceptionResponse)(exception);
+		if (customResponse) {
+			customResponse.headers.forEach((value, name) => {
+				if (name.toLowerCase() !== "set-cookie") response.setHeader(name, value);
+			});
+			const setCookies = customResponse.headers.getSetCookie();
+			if (setCookies.length > 0) response.setHeader("set-cookie", setCookies);
+			response.status(customResponse.status).send(Buffer.from(await customResponse.arrayBuffer()));
+			return;
+		}
+		if (exception instanceof _mastra_server_server_adapter.HTTPException) {
+			response.status(exception.status).json({ error: exception.message });
+			return;
+		}
 		const normalized = this.normalizeError(exception);
 		const rawRequestId = request.headers["x-request-id"];
 		const requestId = (Array.isArray(rawRequestId) ? rawRequestId[0] : rawRequestId) || request.mastraRequestId;
@@ -10841,7 +10913,8 @@ let MastraController = class MastraController {
 		if (![
 			"POST",
 			"PUT",
-			"PATCH"
+			"PATCH",
+			"DELETE"
 		].includes(req.method)) return;
 		if ((req.headers["content-type"] || "").includes("multipart/form-data")) {
 			const maxFileSize = route.maxBodySize ?? this.options.bodyLimitOptions?.maxFileSize;
@@ -10851,7 +10924,7 @@ let MastraController = class MastraController {
 				allowedMimeTypes
 			});
 		}
-		return req.body;
+		return req.body === void 0 ? {} : req.body;
 	}
 };
 __decorate([
@@ -11051,15 +11124,20 @@ MastraAuthGuard = _MastraAuthGuard = __decorate([
 //#endregion
 //#region src/mastra-server.adapter.ts
 /**
-* Minimal Mastra server adapter wrapper for NestJS.
-* Provides MastraServerBase compatibility so getServerApp() works.
+* Mastra server adapter wrapper for NestJS.
+* Provides app access and delegates dynamic route registration to the catch-all controller.
 */
 var NestMastraServer = class extends _mastra_core_server.MastraServerBase {
-	constructor(app) {
+	routeHandler;
+	constructor(app, routeHandler) {
 		super({
 			app,
 			name: "NestMastraServer"
 		});
+		this.routeHandler = routeHandler;
+	}
+	async registerRoute(_app, route, _options) {
+		this.routeHandler.registerRoute(route);
 	}
 };
 //#endregion
@@ -11070,20 +11148,31 @@ let MastraService = _MastraService = class MastraService {
 	options;
 	shutdownService;
 	httpAdapterHost;
+	routeHandler;
 	logger = new _nestjs_common.Logger(_MastraService.name);
 	serverAdapter;
-	constructor(mastra, options, shutdownService, httpAdapterHost) {
+	constructor(mastra, options, shutdownService, httpAdapterHost, routeHandler) {
 		this.mastra = mastra;
 		this.options = options;
 		this.shutdownService = shutdownService;
 		this.httpAdapterHost = httpAdapterHost;
+		this.routeHandler = routeHandler;
+		this.initializeServerAdapter();
+	}
+	onModuleInit() {
+		this.initializeServerAdapter();
+	}
+	initializeServerAdapter() {
+		if (this.serverAdapter) return;
 		const adapterType = this.httpAdapterHost?.httpAdapter?.getType?.();
 		if (adapterType && adapterType !== "express") throw new Error(`MastraModule requires NestJS to use the Express HTTP adapter. Received "${adapterType}". Install @nestjs/platform-express and bootstrap with the Express platform.`);
 		const app = this.httpAdapterHost?.httpAdapter?.getInstance?.();
-		if (app) {
-			this.serverAdapter = new NestMastraServer(app);
-			this.mastra.setMastraServer(this.serverAdapter);
-		} else this.logger.warn("Unable to register Mastra server adapter: HTTP adapter instance not available");
+		if (!app) {
+			this.logger.warn("Unable to register Mastra server adapter: HTTP adapter instance not available");
+			return;
+		}
+		this.serverAdapter = new NestMastraServer(app, this.routeHandler);
+		this.mastra.setMastraServer(this.serverAdapter);
 	}
 	/**
 	* Get the Mastra instance.
@@ -11122,11 +11211,13 @@ MastraService = _MastraService = __decorate([
 	__decorateParam(1, (0, _nestjs_common.Inject)(MASTRA_OPTIONS)),
 	__decorateParam(2, (0, _nestjs_common.Inject)(ShutdownService)),
 	__decorateParam(3, (0, _nestjs_common.Inject)(_nestjs_core.HttpAdapterHost)),
+	__decorateParam(4, (0, _nestjs_common.Inject)(RouteHandlerService)),
 	__decorateMetadata("design:paramtypes", [
 		Object,
 		Object,
 		typeof ShutdownService === "undefined" ? Object : ShutdownService,
-		typeof _nestjs_core.HttpAdapterHost === "undefined" ? Object : _nestjs_core.HttpAdapterHost
+		typeof _nestjs_core.HttpAdapterHost === "undefined" ? Object : _nestjs_core.HttpAdapterHost,
+		typeof RouteHandlerService === "undefined" ? Object : RouteHandlerService
 	])
 ], MastraService);
 //#endregion
@@ -11175,11 +11266,12 @@ let JsonBodyMiddleware = class JsonBodyMiddleware {
 		const maxSize = options.bodyLimitOptions?.maxSize ?? 10485760;
 		this.jsonParser = express.default.json({
 			limit: maxSize,
+			strict: false,
 			type: ["application/json", "application/*+json"]
 		});
 	}
 	use(req, res, next) {
-		if (req.body !== void 0 && Object.keys(req.body).length > 0) {
+		if (req.body !== void 0) {
 			next();
 			return;
 		}