@nestjs-modules/mailer を 3.x から 4.x へアップグレード

@nestjs-modules/mailer 3.0.2 と 4.0.0 の公開 API を、TypeScript の型から自動的に比較したものです。シグネチャの変更は破壊的変更の候補であり、確定ではありません。

概要

削除されたインポートパス	0
削除されたエクスポート	0
変更されたシグネチャ	0
削除されたクラス／インターフェースのメンバー	1
変更されたクラス／インターフェースのメンバー	3
新たに非推奨	0
要件の変更（engines、peer 依存関係）	3
新しいエクスポート	64

削除されたエクスポート

検出されませんでした。

変更されたシグネチャ

検出されませんでした。

削除されたクラス／インターフェースのメンバー

member	import	変更前
`MailerService.executeSend`	`@nestjs-modules/mailer`	`any`

変更されたクラス／インターフェースのメンバー

member	変更前	変更後
`MailerService.constructor`	`(mailerOptions: MailerOptions, transportFactory: MailerTransportFactory, eventService?: MailerEventService \| undefined): MailerService`	`(mailerOptions: MailerOptions, transportFactory?: MailerTransportFactory \| undefined, eventService?: MailerEventService \| undefined, moduleRef?: any): MailerService`
`MailerTestModule.static register`	`(options?: Partial<{ template: { dir?: string \| undefined; adapter?: any; options?: any; }; }> \| undefined): DynamicModule`	`(options?: Omit<MailerOptions, "transport" \| "transports"> \| undefined): DynamicModule`
`MailerEventService.constructor`	`(eventEmitter?: any): MailerEventService`	`(eventEmitter?: MailerEventEmitter \| undefined, moduleRef?: any): MailerEventService`

新たに非推奨

検出されませんでした。

要件の変更（engines、peer 依存関係）

	変更前	変更後
`peerDependencies.handlebars`	`>=4.7.9`	`>=4.7.10`
`peerDependencies.@nestjs/mail`	`—`	`>=0.0.1`
`peerDependencies.@nestjs/outbox`	`—`	`>=0.1.3`

新しいエクスポート (64)

import	export	kind
`@nestjs-modules/mailer`	`html`	function
`@nestjs-modules/mailer`	`signV4`	function
`@nestjs-modules/mailer`	`Mailable`	interface
`@nestjs-modules/mailer`	`SafeHtml`	class
`@nestjs-modules/mailer`	`MailQuery`	interface
`@nestjs-modules/mailer`	`htmlToText`	function
`@nestjs-modules/mailer`	`isSafeHtml`	function
`@nestjs-modules/mailer`	`unsafeHtml`	function
`@nestjs-modules/mailer`	`MailerError`	class
`@nestjs-modules/mailer`	`TestMailbox`	class
`@nestjs-modules/mailer`	`CapturedMail`	class
`@nestjs-modules/mailer`	`LogTransport`	class
`@nestjs-modules/mailer`	`MailableData`	type
`@nestjs-modules/mailer`	`RenderedMail`	interface
`@nestjs-modules/mailer`	`SesTransport`	class
`@nestjs-modules/mailer`	`SigV4Options`	interface
`@nestjs-modules/mailer`	`SigV4Request`	interface
`@nestjs-modules/mailer`	`FileTransport`	class
`@nestjs-modules/mailer`	`MailerPreview`	type
`@nestjs-modules/mailer`	`toMailerError`	function
`@nestjs-modules/mailer`	`AwsCredentials`	interface
`@nestjs-modules/mailer`	`BrevoTransport`	class
`@nestjs-modules/mailer`	`SigV4Signature`	interface
`@nestjs-modules/mailer`	`LOCAL_TRANSPORT`	variable
`@nestjs-modules/mailer`	`MailableContent`	type
`@nestjs-modules/mailer`	`MailableContext`	interface
`@nestjs-modules/mailer`	`MailerSmtpError`	class
`@nestjs-modules/mailer`	`ResendTransport`	class
`@nestjs-modules/mailer`	`parseRetryAfter`	function
`@nestjs-modules/mailer`	`validateMessage`	function
`@nestjs-modules/mailer`	`InterceptOptions`	interface
`@nestjs-modules/mailer`	`MailgunTransport`	class
`@nestjs-modules/mailer`	`isTransientError`	function
`@nestjs-modules/mailer`	`MailerEventRecord`	interface
`@nestjs-modules/mailer`	`PostmarkTransport`	class
`@nestjs-modules/mailer`	`SendGridTransport`	class
`@nestjs-modules/mailer`	`mailerChannelName`	function
`@nestjs-modules/mailer`	`MailerEventEmitter`	interface
`@nestjs-modules/mailer`	`MailerMessageError`	class
`@nestjs-modules/mailer`	`MailerRetryOptions`	interface
`@nestjs-modules/mailer`	`MailerTimeoutError`	class
`@nestjs-modules/mailer`	`UnsubscribeOptions`	interface
`@nestjs-modules/mailer`	`HttpSentMessageInfo`	interface
`@nestjs-modules/mailer`	`LogTransportOptions`	interface
`@nestjs-modules/mailer`	`MailableSendOptions`	type
`@nestjs-modules/mailer`	`MailerPreviewModule`	class
`@nestjs-modules/mailer`	`MailerProviderError`	class
`@nestjs-modules/mailer`	`MailerTemplateError`	class
`@nestjs-modules/mailer`	`SesTransportOptions`	interface
`@nestjs-modules/mailer`	`FileTransportOptions`	interface
`@nestjs-modules/mailer`	`HttpTransportOptions`	interface
`@nestjs-modules/mailer`	`MAILER_EVENT_EMITTER`	variable
`@nestjs-modules/mailer`	`MailerPreviewOptions`	interface
`@nestjs-modules/mailer`	`mayHaveBeenDelivered`	function
`@nestjs-modules/mailer`	`BrevoTransportOptions`	interface
`@nestjs-modules/mailer`	`HttpProviderTransport`	class
`@nestjs-modules/mailer`	`MailerConnectionError`	class
`@nestjs-modules/mailer`	`SuppressedMessageInfo`	interface
`@nestjs-modules/mailer`	`MAILER_PREVIEW_OPTIONS`	variable
`@nestjs-modules/mailer`	`ResendTransportOptions`	interface
`@nestjs-modules/mailer`	`MailgunTransportOptions`	interface
`@nestjs-modules/mailer`	`PostmarkTransportOptions`	interface
`@nestjs-modules/mailer`	`SendGridTransportOptions`	interface
`@nestjs-modules/mailer`	`MailerRecipientsRejectedError`	class

これらのバージョン間の changelog

パッケージ作者が公開したテキストをそのまま表示しています。

4.0.0

### Major Changes

- [#1353](https://github.com/nest-modules/mailer/pull/1353) [`c8c0423`](https://github.com/nest-modules/mailer/commit/c8c0423749bd8f0f7d0f247e62ee5ab7a55f6535) Thanks [@juandav](https://github.com/juandav)! - v4: everything the official `@nestjs/mail` offers and more, without dropping anything v3 supports. Every capability is optional: use nodemailer, the built-in HTTP providers or `@nestjs/mail`'s transports; send directly, through BullMQ or through `@nestjs/outbox`; call `sendMail`, mail classes or the official `Mailer` over this module.
  
  **Breaking changes** (see the [migration guide](https://nest-modules.github.io/mailer/guide/migration)):
  
  - Transient failures are retried by default (3 attempts with backoff); `retry: false` restores v3. A timeout or a dropped connection while the message was being handed over is retried only when the email has a stable Message-ID (`idempotencyKey`), so nothing is sent twice. `sendTimeout` applies per attempt.
  - Errors from transports are typed (`MailerSmtpError`, `MailerTimeoutError`, … all `MailerError`), keeping nodemailer's fields and the original as `cause`; `wrapErrors: false` restores v3.
  - Emails without a text part get one derived from the HTML (`textFromHtml: false` to opt out), and messages are validated before sending (`validate: false` to opt out).
  - `MailerTestModule` delivers to a `TestMailbox` (no stream transport; `info.message` uses CRLF line endings) and defaults `retry` to `false`.
  - `MailerPreviewModule` is on by default only when `NODE_ENV` is `development` or `test`.
  - Event payloads carry `attempt`, `permanent`, `transporterName` and `durationMs`; `MailerEventService` takes its emitter through `MAILER_EVENT_EMITTER`, and `EventEmitter2` is found automatically (in v3 it was never injected).
  - `MailableContext.to` is `{ name?, address }[]`, the same shape as `@nestjs/mail`.
  
  **New**
  
  - Mail classes (`mailerService.send(WelcomeMail, { to, data })`) compatible with `@nestjs/mail`'s, with dependencies resolved from the whole app, and `render()` to render without sending.
  - Retries with backoff and error classification (nodemailer, HTTP and AWS SDK errors), failover between transporters, `AbortSignal`, `idempotencyKey`, and graceful shutdown that waits for sends in flight (`shutdownTimeout`).
  - Zero-dependency HTTP transports: Resend, Postmark, SendGrid, SES (SigV4), Mailgun and Brevo.
  - The `html` tagged template (`unsafeHtml()` for trusted markup), `htmlToText()` and message validation.
  - `intercept` (redirect recipients in staging), `suppress` (suppression lists) and one-click `unsubscribe` (RFC 8058).
  - `TestMailbox` with assertions, `FileTransport` and `LogTransport` (with a warning when used in production) and `MailerPreviewModule` to preview emails in the browser.
  - `events$`, `node:diagnostics_channel` publishing (credentials redacted), and `RETRY`, `FAILOVER` and `SUPPRESSED` events.
  - BullMQ: permanent failures fail the j

このデータを AI エージェントに渡す

Vigia は無料の MCP サーバーです。コーディングエージェントがコードを書く前に、バージョン・破壊的変更・脆弱性を確認できます。登録も API キーも不要です。

claude mcp add --transport http vigia https://vigia.coredls.cloud/mcp

Cursor に追加 VS Code に追加 ★ GitHub でスターを付ける

その他の MCP クライアント

{ "mcpServers": { "vigia": { "url": "https://vigia.coredls.cloud/mcp" } } }

エージェント用スキル (SKILL.md)：Vigia を使うタイミングをエージェントに伝えます · プルリクエスト用 GitHub Action

よくある質問

@nestjs-modules/mailer を 3 から 4 にアップグレードする際の破壊的変更は？

@nestjs-modules/mailer 3.0.2 と 4.0.0 の間で、Vigia は削除されたエクスポートを 0 件、変更されたシグネチャを 0 件、削除または変更されたクラス／インターフェースのメンバーを 4 件検出しました。

@nestjs-modules/mailer 4 で非推奨になったものは？

@nestjs-modules/mailer 4.0.0 では 0 件のエクスポートまたはメンバーが新たに非推奨になりました。

エージェント向け

GET https://vigia.coredls.cloud/v1/packages/npm/@nestjs-modules/mailer/upgrade?from=3.0.2&to=4.0.0