Асинхронное правило в Nest

Пусть решение о приёме данных нужно получить из сети или подождать готовности внешнего сервиса. Синхронной функции на схеме для этого не хватит, хотя тип поля уже описан верно.

Асинхронное правило задают через refine с функцией, которая возвращает обещание. Standard Schema дождётся результата, а канал уже ждёт ответ схемы и передаст значение в метод или откажет клиенту.

Покажем на примере постов:

import { BadRequestException, Injectable, PipeTransform } from '@nestjs/common';

@Injectable()
export class SchemaPipe implements PipeTransform {
	constructor(private schema: { '~standard': { validate: (value: unknown) => Promise<{ value?: unknown; issues?: { message: string }[] }> | { value?: unknown; issues?: { message: string }[] } } }) {}
	async transform(value: unknown) {
		const result = await this.schema['~standard'].validate(value);
		if (result.issues) {
			throw new BadRequestException(result.issues[0].message);
		}
		return result.value;
	}
}

Код записи проверим асинхронным правилом:

import { z } from 'zod';

export const createPostSchema = z
	.object({
		code: z.string(),
	})
	.refine(
		async (data) => {
			await Promise.resolve();
			return data.code.length >= 2;
		},
		{ error: 'Code is invalid' },
	);

На маршруте создания передаём схему в канал и возвращаем проверенный код клиенту:

import { Body, Controller, Post } from '@nestjs/common';
import { createPostSchema } from './create-post.schema.js';
import { SchemaPipe } from './schema.pipe.js';

@Controller('posts')
export class PostController {
	@Post()
	createPost(@Body(new SchemaPipe(createPostSchema)) body: { code: string }) {
		return body.code;
	}
}

Подключим контроллер в корневом модуле:

import { Module } from '@nestjs/common';
import { PostController } from './post.controller.js';

@Module({
	controllers: [PostController],
})
export class AppModule {}

Сделайте создание работника с асинхронным правилом в схеме в контроллере WorkerController и подключите его к корневому модулю.