Границы транзакции в Nest

Бывает, что два сохранения должны либо оба попасть в таблицу, либо не попасть ни одно. Если вызвать обычный репозиторий дважды, между шагами база уже зафиксирует первую строку отдельно от второй.

Метод transaction у DataSource принимает асинхронный callback и передаёт в него менеджер сущностей текущего блока. Все операции записи внутри callback идут через этот менеджер, и база рассматривает их как один шаг до конца функции.

Покажем на примере постов. Опишем сущность:

import { Column, Entity, PrimaryGeneratedColumn } from 'typeorm';

@Entity()
export class Post {
	@PrimaryGeneratedColumn()
	id: number;

	@Column()
	title: string;
}

Контроллер откроет блок и сохранит две строки через менеджер в одном callback:

import { Controller, Post } from '@nestjs/common';
import { DataSource } from 'typeorm';
import { Post as PostEntity } from '../post.entity.js';

@Controller('posts')
export class PostController {
	dataSource: DataSource;

	constructor(dataSource: DataSource) {
		this.dataSource = dataSource;
	}

	@Post('pair')
	addPair() {
		return this.dataSource.transaction(async (manager) => {
			const first = await manager.save(PostEntity, {
				title: 'Morning note',
			});
			const second = await manager.save(PostEntity, {
				title: 'Evening note',
			});
			return [first, second];
		});
	}
}

Модуль темы регистрирует сущность и контроллер:

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

@Module({
	imports: [TypeOrmModule.forFeature([Post])],
	controllers: [PostController],
})
export class PostsModule {}

Корень поднимает канал к базе и импортирует модуль темы:

import { Module } from '@nestjs/common';
import { TypeOrmModule } from '@nestjs/typeorm';
import { PostsModule } from './posts/posts.module.js';

@Module({
	imports: [
		TypeOrmModule.forRoot({
			type: 'postgres',
			host: 'localhost',
			port: 5432,
			username: 'postgres',
			password: 'postgres',
			database: 'site',
			autoLoadEntities: true,
			synchronize: true,
		}),
		PostsModule,
	],
})
export class AppModule {}

Сохраните две строки работника одним блоком в WorkerController, опишите сущность и соберите WorkersModule с базой в корне.