@testboard/mail

简介

@testboard/mail 是 TestBoard 平台的邮件发送模块，基于 NestJS 和 Nodemailer 构建，提供简单可靠的邮件发送功能。

特性

• 集成 NestJS 框架，易于配置和使用
• 基于 Nodemailer 构建，支持多种邮件服务提供商
• 提供验证码发送等常用邮件功能
• 支持 HTML 格式邮件内容
• 完整的类型定义支持

安装

1pnpm add @testboard/mail

快速开始

1. 在 NestJS 模块中导入 MailModule：

1import { Module } from '@nestjs/common';
2import { ConfigModule } from '@nestjs/config';
3import { MailModule } from '@testboard/mail';
4
5@Module({
6  imports: [ConfigModule.forRoot(), MailModule]
7  // ...
8})
9export class AppModule {}

2. 在服务中注入 MailService 并使用：

1import { Injectable } from '@nestjs/common';
2import { MailService } from '@testboard/mail';
3
4@Injectable()
5export class UserService {
6  constructor(private readonly mailService: MailService) {}
7
8  async sendVerification(email: string, code: string) {
9    await this.mailService.sendVerificationCode(email, code);
10  }
11}

文档

详细文档请参阅 docs 目录：

• 使用指南 - 基本使用方法和示例
• 配置详情 - 配置选项和示例
• 高级用法 - 模板化、队列处理和批量发送等高级功能

配置

在 .env 文件中配置邮件服务：

1MAIL_HOST=smtp.example.com
2MAIL_PORT=587
3MAIL_SECURE=false
4MAIL_USER=your-username
5MAIL_PASS=your-password
6MAIL_FROM=TestBoard <noreply@example.com>

API 参考

MailService

sendMail(options: Mail.Options): Promise<void>

发送自定义邮件。

sendVerificationCode(email: string, code: string): Promise<void>

发送验证码邮件。

贡献

欢迎贡献代码、报告问题或提出建议。

许可证

ISC