Отправка email в NestJS через SMTP

npm install @nestjs-modules/mailer nodemailer handlebars
npm install -D @types/nodemailer

// src/mail/mail.module.ts
import { Module } from "@nestjs/common";
import { ConfigModule, ConfigService } from "@nestjs/config";
import { MailerModule } from "@nestjs-modules/mailer";
import { HandlebarsAdapter } from "@nestjs-modules/mailer/dist/adapters/handlebars.adapter";
import { join } from "path";
import { MailService } from "./mail.service";

@Module({
  imports: [
    MailerModule.forRootAsync({
      imports: [ConfigModule],
      inject: [ConfigService],
      useFactory: (config: ConfigService) => ({
        transport: {
          host: "smtp.fmailer.ru",
          port: 587,
          secure: false,        // STARTTLS на 587
          requireTLS: true,
          auth: {
            user: config.getOrThrow("SMTP_USER"),
            pass: config.getOrThrow("SMTP_PASS"),   // "pass", не "password"
          },
        },
        defaults: {
          from: '"Магазин" <noreply@mail.example.ru>',
        },
        template: {
          dir: join(__dirname, "templates"),
          adapter: new HandlebarsAdapter(),
          options: { strict: true },
        },
      }),
    }),
  ],
  providers: [MailService],
  exports: [MailService],
})
export class MailModule {}

// src/mail/mail.service.ts
import { Injectable, Logger } from "@nestjs/common";
import { MailerService } from "@nestjs-modules/mailer";

@Injectable()
export class MailService {
  private readonly logger = new Logger(MailService.name);

  constructor(private readonly mailer: MailerService) {}

  async sendConfirmation(user: User, token: string): Promise<void> {
    try {
      await this.mailer.sendMail({
        to: user.email,
        subject: "Подтверждение адреса",
        template: "./confirmation",     // templates/confirmation.hbs
        context: {
          name: user.name,
          url: `https://example.ru/confirm?token=${token}`,
        },
      });
    } catch (error) {
      this.logger.error(`Письмо на ${user.email} не отправлено`, error);
      throw error;
    }
  }
}

// nest-cli.json — файлы .hbs не компилируются, их нужно скопировать в dist
{
  "compilerOptions": {
    "assets": [{ "include": "mail/templates/**/*", "outDir": "dist" }],
    "watchAssets": true
  }
}

// Отправка внутри запроса привязывает ответ к задержкам SMTP.
// Кладём письмо в очередь BullMQ.
@Injectable()
export class UsersService {
  constructor(@InjectQueue("mail") private readonly mailQueue: Queue) {}

  async register(dto: RegisterDto): Promise<User> {
    const user = await this.repo.save(dto);
    await this.mailQueue.add(
      "confirmation",
      { userId: user.id },
      { attempts: 3, backoff: { type: "exponential", delay: 2000 } },
    );
    return user;
  }
}