@forinda/kickjs-mailer 1.2.10 → 1.2.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.js +1 -229
- package/package.json +5 -5
- package/dist/index.js.map +0 -1
package/dist/index.js
CHANGED
|
@@ -1,229 +1 @@
|
|
|
1
|
-
var
|
|
2
|
-
var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
|
|
3
|
-
|
|
4
|
-
// src/index.ts
|
|
5
|
-
import "reflect-metadata";
|
|
6
|
-
|
|
7
|
-
// src/mailer.service.ts
|
|
8
|
-
import { Logger } from "@forinda/kickjs-core";
|
|
9
|
-
var log = Logger.for("Mailer");
|
|
10
|
-
var MAILER = /* @__PURE__ */ Symbol("MailerService");
|
|
11
|
-
var MailerService = class {
|
|
12
|
-
static {
|
|
13
|
-
__name(this, "MailerService");
|
|
14
|
-
}
|
|
15
|
-
provider;
|
|
16
|
-
defaultFrom;
|
|
17
|
-
templateEngine;
|
|
18
|
-
enabled;
|
|
19
|
-
constructor(options) {
|
|
20
|
-
this.provider = options.provider;
|
|
21
|
-
this.defaultFrom = options.defaultFrom;
|
|
22
|
-
this.templateEngine = options.templateEngine;
|
|
23
|
-
this.enabled = options.enabled ?? true;
|
|
24
|
-
}
|
|
25
|
-
/**
|
|
26
|
-
* Send an email message.
|
|
27
|
-
* Applies defaultFrom if no from address is set.
|
|
28
|
-
*/
|
|
29
|
-
async send(message) {
|
|
30
|
-
const msg = {
|
|
31
|
-
...message
|
|
32
|
-
};
|
|
33
|
-
if (!msg.from && this.defaultFrom) {
|
|
34
|
-
msg.from = this.defaultFrom;
|
|
35
|
-
}
|
|
36
|
-
if (!this.enabled) {
|
|
37
|
-
log.info(`[dry-run] \u2192 ${formatRecipient(msg.to)} | ${msg.subject}`);
|
|
38
|
-
return {
|
|
39
|
-
messageId: "dry-run",
|
|
40
|
-
accepted: true
|
|
41
|
-
};
|
|
42
|
-
}
|
|
43
|
-
try {
|
|
44
|
-
const result = await this.provider.send(msg);
|
|
45
|
-
log.info(`Sent \u2192 ${formatRecipient(msg.to)} | ${msg.subject} [${result.messageId}]`);
|
|
46
|
-
return result;
|
|
47
|
-
} catch (err) {
|
|
48
|
-
log.error({
|
|
49
|
-
err
|
|
50
|
-
}, `Failed \u2192 ${formatRecipient(msg.to)} | ${msg.subject}`);
|
|
51
|
-
throw err;
|
|
52
|
-
}
|
|
53
|
-
}
|
|
54
|
-
/**
|
|
55
|
-
* Render a template and send the resulting HTML as an email.
|
|
56
|
-
* Requires a templateEngine to be configured.
|
|
57
|
-
*
|
|
58
|
-
* @param template - Template name (resolved by the engine)
|
|
59
|
-
* @param message - Mail message (html will be overwritten by the rendered template)
|
|
60
|
-
* @param data - Template variables
|
|
61
|
-
*/
|
|
62
|
-
async sendTemplate(template, message, data) {
|
|
63
|
-
if (!this.templateEngine) {
|
|
64
|
-
throw new Error("MailerService: templateEngine is required for sendTemplate(). Pass one in MailerOptions or use send() with raw HTML.");
|
|
65
|
-
}
|
|
66
|
-
const html = await this.templateEngine.render(template, data);
|
|
67
|
-
return this.send({
|
|
68
|
-
...message,
|
|
69
|
-
html
|
|
70
|
-
});
|
|
71
|
-
}
|
|
72
|
-
/** Get the underlying provider (for advanced use) */
|
|
73
|
-
getProvider() {
|
|
74
|
-
return this.provider;
|
|
75
|
-
}
|
|
76
|
-
/** Shutdown the provider */
|
|
77
|
-
async shutdown() {
|
|
78
|
-
if (this.provider.shutdown) {
|
|
79
|
-
await this.provider.shutdown();
|
|
80
|
-
}
|
|
81
|
-
}
|
|
82
|
-
};
|
|
83
|
-
function formatRecipient(to) {
|
|
84
|
-
if (Array.isArray(to)) {
|
|
85
|
-
return to.map((r) => typeof r === "string" ? r : r.address).join(", ");
|
|
86
|
-
}
|
|
87
|
-
return typeof to === "string" ? to : to.address;
|
|
88
|
-
}
|
|
89
|
-
__name(formatRecipient, "formatRecipient");
|
|
90
|
-
|
|
91
|
-
// src/adapter.ts
|
|
92
|
-
import { Logger as Logger2 } from "@forinda/kickjs-core";
|
|
93
|
-
var log2 = Logger2.for("MailerAdapter");
|
|
94
|
-
var MailerAdapter = class {
|
|
95
|
-
static {
|
|
96
|
-
__name(this, "MailerAdapter");
|
|
97
|
-
}
|
|
98
|
-
options;
|
|
99
|
-
name = "MailerAdapter";
|
|
100
|
-
mailer;
|
|
101
|
-
constructor(options) {
|
|
102
|
-
this.options = options;
|
|
103
|
-
this.mailer = new MailerService(options);
|
|
104
|
-
}
|
|
105
|
-
afterStart(_server, container) {
|
|
106
|
-
container.registerInstance(MAILER, this.mailer);
|
|
107
|
-
log2.info(`Mail provider: ${this.options.provider.name}${this.options.enabled === false ? " (disabled)" : ""}`);
|
|
108
|
-
}
|
|
109
|
-
async shutdown() {
|
|
110
|
-
await this.mailer.shutdown();
|
|
111
|
-
log2.info("Mailer shut down");
|
|
112
|
-
}
|
|
113
|
-
};
|
|
114
|
-
|
|
115
|
-
// src/providers/smtp.provider.ts
|
|
116
|
-
var SmtpProvider = class {
|
|
117
|
-
static {
|
|
118
|
-
__name(this, "SmtpProvider");
|
|
119
|
-
}
|
|
120
|
-
options;
|
|
121
|
-
name = "smtp";
|
|
122
|
-
transporter;
|
|
123
|
-
constructor(options) {
|
|
124
|
-
this.options = options;
|
|
125
|
-
}
|
|
126
|
-
async ensureTransporter() {
|
|
127
|
-
if (this.transporter) return;
|
|
128
|
-
try {
|
|
129
|
-
const nodemailer = await import("nodemailer");
|
|
130
|
-
const createTransport = nodemailer.createTransport ?? nodemailer.default?.createTransport;
|
|
131
|
-
this.transporter = createTransport({
|
|
132
|
-
host: this.options.host,
|
|
133
|
-
port: this.options.port ?? 587,
|
|
134
|
-
secure: this.options.secure ?? this.options.port === 465,
|
|
135
|
-
auth: this.options.auth,
|
|
136
|
-
connectionTimeout: this.options.connectionTimeout ?? 1e4
|
|
137
|
-
});
|
|
138
|
-
} catch {
|
|
139
|
-
throw new Error('SmtpProvider requires "nodemailer" package. Install: pnpm add nodemailer');
|
|
140
|
-
}
|
|
141
|
-
}
|
|
142
|
-
async send(message) {
|
|
143
|
-
await this.ensureTransporter();
|
|
144
|
-
const result = await this.transporter.sendMail({
|
|
145
|
-
from: formatAddress(message.from),
|
|
146
|
-
to: formatRecipients(message.to),
|
|
147
|
-
cc: message.cc ? formatRecipients(message.cc) : void 0,
|
|
148
|
-
bcc: message.bcc ? formatRecipients(message.bcc) : void 0,
|
|
149
|
-
replyTo: message.replyTo ? formatAddress(message.replyTo) : void 0,
|
|
150
|
-
subject: message.subject,
|
|
151
|
-
text: message.text,
|
|
152
|
-
html: message.html,
|
|
153
|
-
attachments: message.attachments,
|
|
154
|
-
headers: message.headers
|
|
155
|
-
});
|
|
156
|
-
return {
|
|
157
|
-
messageId: result.messageId,
|
|
158
|
-
accepted: (result.accepted?.length ?? 0) > 0,
|
|
159
|
-
raw: result
|
|
160
|
-
};
|
|
161
|
-
}
|
|
162
|
-
async shutdown() {
|
|
163
|
-
if (this.transporter) {
|
|
164
|
-
this.transporter.close();
|
|
165
|
-
}
|
|
166
|
-
}
|
|
167
|
-
};
|
|
168
|
-
function formatAddress(addr) {
|
|
169
|
-
if (!addr) return void 0;
|
|
170
|
-
if (typeof addr === "string") return addr;
|
|
171
|
-
return addr.name ? `"${addr.name}" <${addr.address}>` : addr.address;
|
|
172
|
-
}
|
|
173
|
-
__name(formatAddress, "formatAddress");
|
|
174
|
-
function formatRecipients(recipients) {
|
|
175
|
-
if (!recipients) return "";
|
|
176
|
-
if (typeof recipients === "string") return recipients;
|
|
177
|
-
if (Array.isArray(recipients)) {
|
|
178
|
-
return recipients.map((r) => formatAddress(r)).join(", ");
|
|
179
|
-
}
|
|
180
|
-
return formatAddress(recipients) ?? "";
|
|
181
|
-
}
|
|
182
|
-
__name(formatRecipients, "formatRecipients");
|
|
183
|
-
|
|
184
|
-
// src/providers/console.provider.ts
|
|
185
|
-
import { Logger as Logger3 } from "@forinda/kickjs-core";
|
|
186
|
-
var log3 = Logger3.for("ConsoleMail");
|
|
187
|
-
var counter = 0;
|
|
188
|
-
var ConsoleProvider = class {
|
|
189
|
-
static {
|
|
190
|
-
__name(this, "ConsoleProvider");
|
|
191
|
-
}
|
|
192
|
-
name = "console";
|
|
193
|
-
async send(message) {
|
|
194
|
-
const id = `console-${++counter}`;
|
|
195
|
-
const to = Array.isArray(message.to) ? message.to.map((r) => typeof r === "string" ? r : r.address).join(", ") : typeof message.to === "string" ? message.to : message.to.address;
|
|
196
|
-
log3.info(`\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
|
|
197
|
-
log3.info(`From: ${formatAddr(message.from)}`);
|
|
198
|
-
log3.info(`To: ${to}`);
|
|
199
|
-
if (message.cc) log3.info(`CC: ${formatAddr(message.cc)}`);
|
|
200
|
-
if (message.bcc) log3.info(`BCC: ${formatAddr(message.bcc)}`);
|
|
201
|
-
log3.info(`Subject: ${message.subject}`);
|
|
202
|
-
if (message.text) log3.info(`Text: ${message.text.slice(0, 200)}${message.text.length > 200 ? "..." : ""}`);
|
|
203
|
-
if (message.html) log3.info(`HTML: ${message.html.slice(0, 200)}${message.html.length > 200 ? "..." : ""}`);
|
|
204
|
-
if (message.attachments?.length) {
|
|
205
|
-
log3.info(`Attach: ${message.attachments.map((a) => a.filename).join(", ")}`);
|
|
206
|
-
}
|
|
207
|
-
log3.info(`ID: ${id}`);
|
|
208
|
-
log3.info(`\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`);
|
|
209
|
-
return {
|
|
210
|
-
messageId: id,
|
|
211
|
-
accepted: true
|
|
212
|
-
};
|
|
213
|
-
}
|
|
214
|
-
};
|
|
215
|
-
function formatAddr(addr) {
|
|
216
|
-
if (!addr) return "(none)";
|
|
217
|
-
if (typeof addr === "string") return addr;
|
|
218
|
-
if (Array.isArray(addr)) return addr.map(formatAddr).join(", ");
|
|
219
|
-
return addr.name ? `"${addr.name}" <${addr.address}>` : addr.address;
|
|
220
|
-
}
|
|
221
|
-
__name(formatAddr, "formatAddr");
|
|
222
|
-
export {
|
|
223
|
-
ConsoleProvider,
|
|
224
|
-
MAILER,
|
|
225
|
-
MailerAdapter,
|
|
226
|
-
MailerService,
|
|
227
|
-
SmtpProvider
|
|
228
|
-
};
|
|
229
|
-
//# sourceMappingURL=index.js.map
|
|
1
|
+
var w=Object.defineProperty;var o=(r,t)=>w(r,"name",{value:t,configurable:!0});import"reflect-metadata";import{Logger as b}from"@forinda/kickjs-core";var u=b.for("Mailer"),d=Symbol("MailerService"),a=class{static{o(this,"MailerService")}provider;defaultFrom;templateEngine;enabled;constructor(t){this.provider=t.provider,this.defaultFrom=t.defaultFrom,this.templateEngine=t.templateEngine,this.enabled=t.enabled??!0}async send(t){let e={...t};if(!e.from&&this.defaultFrom&&(e.from=this.defaultFrom),!this.enabled)return u.info(`[dry-run] \u2192 ${h(e.to)} | ${e.subject}`),{messageId:"dry-run",accepted:!0};try{let i=await this.provider.send(e);return u.info(`Sent \u2192 ${h(e.to)} | ${e.subject} [${i.messageId}]`),i}catch(i){throw u.error({err:i},`Failed \u2192 ${h(e.to)} | ${e.subject}`),i}}async sendTemplate(t,e,i){if(!this.templateEngine)throw new Error("MailerService: templateEngine is required for sendTemplate(). Pass one in MailerOptions or use send() with raw HTML.");let s=await this.templateEngine.render(t,i);return this.send({...e,html:s})}getProvider(){return this.provider}async shutdown(){this.provider.shutdown&&await this.provider.shutdown()}};function h(r){return Array.isArray(r)?r.map(t=>typeof t=="string"?t:t.address).join(", "):typeof r=="string"?r:r.address}o(h,"formatRecipient");import{Logger as v}from"@forinda/kickjs-core";var $=v.for("MailerAdapter"),m=class{static{o(this,"MailerAdapter")}options;name="MailerAdapter";mailer;constructor(t){this.options=t,this.mailer=new a(t)}afterStart(t,e){e.registerInstance(d,this.mailer),$.info(`Mail provider: ${this.options.provider.name}${this.options.enabled===!1?" (disabled)":""}`)}async shutdown(){await this.mailer.shutdown(),$.info("Mailer shut down")}};var c=class{static{o(this,"SmtpProvider")}options;name="smtp";transporter;constructor(t){this.options=t}async ensureTransporter(){if(!this.transporter)try{let t=await import("nodemailer"),e=t.createTransport??t.default?.createTransport;this.transporter=e({host:this.options.host,port:this.options.port??587,secure:this.options.secure??this.options.port===465,auth:this.options.auth,connectionTimeout:this.options.connectionTimeout??1e4})}catch{throw new Error('SmtpProvider requires "nodemailer" package. Install: pnpm add nodemailer')}}async send(t){await this.ensureTransporter();let e=await this.transporter.sendMail({from:f(t.from),to:y(t.to),cc:t.cc?y(t.cc):void 0,bcc:t.bcc?y(t.bcc):void 0,replyTo:t.replyTo?f(t.replyTo):void 0,subject:t.subject,text:t.text,html:t.html,attachments:t.attachments,headers:t.headers});return{messageId:e.messageId,accepted:(e.accepted?.length??0)>0,raw:e}}async shutdown(){this.transporter&&this.transporter.close()}};function f(r){if(r)return typeof r=="string"?r:r.name?`"${r.name}" <${r.address}>`:r.address}o(f,"formatAddress");function y(r){return r?typeof r=="string"?r:Array.isArray(r)?r.map(t=>f(t)).join(", "):f(r)??"":""}o(y,"formatRecipients");import{Logger as x}from"@forinda/kickjs-core";var n=x.for("ConsoleMail"),A=0,l=class{static{o(this,"ConsoleProvider")}name="console";async send(t){let e=`console-${++A}`,i=Array.isArray(t.to)?t.to.map(s=>typeof s=="string"?s:s.address).join(", "):typeof t.to=="string"?t.to:t.to.address;return n.info("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"),n.info(`From: ${p(t.from)}`),n.info(`To: ${i}`),t.cc&&n.info(`CC: ${p(t.cc)}`),t.bcc&&n.info(`BCC: ${p(t.bcc)}`),n.info(`Subject: ${t.subject}`),t.text&&n.info(`Text: ${t.text.slice(0,200)}${t.text.length>200?"...":""}`),t.html&&n.info(`HTML: ${t.html.slice(0,200)}${t.html.length>200?"...":""}`),t.attachments?.length&&n.info(`Attach: ${t.attachments.map(s=>s.filename).join(", ")}`),n.info(`ID: ${e}`),n.info("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"),{messageId:e,accepted:!0}}};function p(r){return r?typeof r=="string"?r:Array.isArray(r)?r.map(p).join(", "):r.name?`"${r.name}" <${r.address}>`:r.address:"(none)"}o(p,"formatAddr");export{l as ConsoleProvider,d as MAILER,m as MailerAdapter,a as MailerService,c as SmtpProvider};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@forinda/kickjs-mailer",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.12",
|
|
4
4
|
"description": "Pluggable email sending for KickJS — nodemailer, Resend, SES, and custom providers",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"kickjs",
|
|
@@ -28,10 +28,10 @@
|
|
|
28
28
|
],
|
|
29
29
|
"dependencies": {
|
|
30
30
|
"reflect-metadata": "^0.2.2",
|
|
31
|
-
"@forinda/kickjs-core": "1.2.
|
|
31
|
+
"@forinda/kickjs-core": "1.2.12"
|
|
32
32
|
},
|
|
33
33
|
"peerDependencies": {
|
|
34
|
-
"nodemailer": ">=
|
|
34
|
+
"nodemailer": ">=7.0.11"
|
|
35
35
|
},
|
|
36
36
|
"peerDependenciesMeta": {
|
|
37
37
|
"nodemailer": {
|
|
@@ -40,8 +40,8 @@
|
|
|
40
40
|
},
|
|
41
41
|
"devDependencies": {
|
|
42
42
|
"@types/node": "^24.5.2",
|
|
43
|
-
"@types/nodemailer": "^
|
|
44
|
-
"nodemailer": "^
|
|
43
|
+
"@types/nodemailer": "^7.0.11",
|
|
44
|
+
"nodemailer": "^8.0.3",
|
|
45
45
|
"tsup": "^8.5.0",
|
|
46
46
|
"typescript": "^5.9.2",
|
|
47
47
|
"vitest": "^3.2.4"
|
package/dist/index.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts","../src/mailer.service.ts","../src/adapter.ts","../src/providers/smtp.provider.ts","../src/providers/console.provider.ts"],"sourcesContent":["import 'reflect-metadata'\n\n// Types\nexport {\n type MailProvider,\n type MailMessage,\n type MailResult,\n type MailAddress,\n type MailRecipient,\n type MailAttachment,\n type MailTemplateEngine,\n type MailerOptions,\n} from './types'\n\n// Service\nexport { MailerService, MAILER } from './mailer.service'\n\n// Adapter\nexport { MailerAdapter } from './adapter'\n\n// Built-in providers\nexport { SmtpProvider, ConsoleProvider, type SmtpOptions } from './providers'\n","import { Logger } from '@forinda/kickjs-core'\nimport type {\n MailProvider,\n MailMessage,\n MailResult,\n MailRecipient,\n MailTemplateEngine,\n MailerOptions,\n} from './types'\n\nconst log = Logger.for('Mailer')\n\n/** DI token for resolving MailerService from the container */\nexport const MAILER = Symbol('MailerService')\n\n/**\n * Central mail service — send emails through any provider.\n *\n * @example\n * ```ts\n * @Service()\n * class UserService {\n * constructor(@Inject(MAILER) private mailer: MailerService) {}\n *\n * async sendWelcome(user: User) {\n * await this.mailer.send({\n * to: user.email,\n * subject: 'Welcome!',\n * html: '<h1>Welcome to our app</h1>',\n * })\n * }\n *\n * // Or with templates:\n * async sendInvoice(user: User, invoice: Invoice) {\n * await this.mailer.sendTemplate('invoice', {\n * to: user.email,\n * subject: `Invoice #${invoice.number}`,\n * }, { user, invoice })\n * }\n * }\n * ```\n */\nexport class MailerService {\n private provider: MailProvider\n private defaultFrom?: MailRecipient\n private templateEngine?: MailTemplateEngine\n private enabled: boolean\n\n constructor(options: MailerOptions) {\n this.provider = options.provider\n this.defaultFrom = options.defaultFrom\n this.templateEngine = options.templateEngine\n this.enabled = options.enabled ?? true\n }\n\n /**\n * Send an email message.\n * Applies defaultFrom if no from address is set.\n */\n async send(message: MailMessage): Promise<MailResult> {\n const msg = { ...message }\n\n // Apply default from\n if (!msg.from && this.defaultFrom) {\n msg.from = this.defaultFrom\n }\n\n if (!this.enabled) {\n log.info(`[dry-run] → ${formatRecipient(msg.to)} | ${msg.subject}`)\n return { messageId: 'dry-run', accepted: true }\n }\n\n try {\n const result = await this.provider.send(msg)\n log.info(`Sent → ${formatRecipient(msg.to)} | ${msg.subject} [${result.messageId}]`)\n return result\n } catch (err: any) {\n log.error({ err }, `Failed → ${formatRecipient(msg.to)} | ${msg.subject}`)\n throw err\n }\n }\n\n /**\n * Render a template and send the resulting HTML as an email.\n * Requires a templateEngine to be configured.\n *\n * @param template - Template name (resolved by the engine)\n * @param message - Mail message (html will be overwritten by the rendered template)\n * @param data - Template variables\n */\n async sendTemplate(\n template: string,\n message: Omit<MailMessage, 'html'>,\n data: Record<string, any>,\n ): Promise<MailResult> {\n if (!this.templateEngine) {\n throw new Error(\n 'MailerService: templateEngine is required for sendTemplate(). ' +\n 'Pass one in MailerOptions or use send() with raw HTML.',\n )\n }\n\n const html = await this.templateEngine.render(template, data)\n return this.send({ ...message, html })\n }\n\n /** Get the underlying provider (for advanced use) */\n getProvider(): MailProvider {\n return this.provider\n }\n\n /** Shutdown the provider */\n async shutdown(): Promise<void> {\n if (this.provider.shutdown) {\n await this.provider.shutdown()\n }\n }\n}\n\nfunction formatRecipient(to: MailRecipient | MailRecipient[]): string {\n if (Array.isArray(to)) {\n return to.map((r) => (typeof r === 'string' ? r : r.address)).join(', ')\n }\n return typeof to === 'string' ? to : to.address\n}\n","import { Logger, type AppAdapter, type Container } from '@forinda/kickjs-core'\nimport { MailerService, MAILER } from './mailer.service'\nimport type { MailerOptions } from './types'\n\nconst log = Logger.for('MailerAdapter')\n\n/**\n * Mailer adapter — registers MailerService in the DI container.\n *\n * @example\n * ```ts\n * import { MailerAdapter, SmtpProvider } from '@forinda/kickjs-mailer'\n *\n * bootstrap({\n * adapters: [\n * new MailerAdapter({\n * provider: new SmtpProvider({ host: 'smtp.gmail.com', port: 587, auth: { ... } }),\n * defaultFrom: { name: 'My App', address: 'noreply@myapp.com' },\n * }),\n * ],\n * })\n * ```\n */\nexport class MailerAdapter implements AppAdapter {\n name = 'MailerAdapter'\n private mailer: MailerService\n\n constructor(private options: MailerOptions) {\n this.mailer = new MailerService(options)\n }\n\n afterStart(_server: any, container: Container): void {\n container.registerInstance(MAILER, this.mailer)\n log.info(\n `Mail provider: ${this.options.provider.name}${this.options.enabled === false ? ' (disabled)' : ''}`,\n )\n }\n\n async shutdown(): Promise<void> {\n await this.mailer.shutdown()\n log.info('Mailer shut down')\n }\n}\n","import type { MailProvider, MailMessage, MailResult } from '../types'\n\nexport interface SmtpOptions {\n /** SMTP host (e.g. 'smtp.gmail.com', 'smtp.resend.com') */\n host: string\n /** SMTP port (default: 587) */\n port?: number\n /** Use TLS (default: true for port 465, false otherwise) */\n secure?: boolean\n /** Authentication credentials */\n auth?: {\n user: string\n pass: string\n }\n /** Connection timeout in ms (default: 10000) */\n connectionTimeout?: number\n}\n\n/**\n * SMTP mail provider using nodemailer.\n *\n * Requires `nodemailer` as a peer dependency:\n * ```bash\n * pnpm add nodemailer @types/nodemailer\n * ```\n *\n * @example\n * ```ts\n * // Gmail\n * new SmtpProvider({\n * host: 'smtp.gmail.com',\n * port: 587,\n * auth: { user: 'you@gmail.com', pass: 'app-password' },\n * })\n *\n * // Resend via SMTP\n * new SmtpProvider({\n * host: 'smtp.resend.com',\n * port: 465,\n * secure: true,\n * auth: { user: 'resend', pass: process.env.RESEND_API_KEY! },\n * })\n *\n * // Mailpit (local dev)\n * new SmtpProvider({ host: 'localhost', port: 1025 })\n * ```\n */\nexport class SmtpProvider implements MailProvider {\n name = 'smtp'\n private transporter: any\n\n constructor(private options: SmtpOptions) {}\n\n private async ensureTransporter(): Promise<void> {\n if (this.transporter) return\n try {\n const nodemailer: any = await import('nodemailer')\n const createTransport = nodemailer.createTransport ?? nodemailer.default?.createTransport\n this.transporter = createTransport({\n host: this.options.host,\n port: this.options.port ?? 587,\n secure: this.options.secure ?? this.options.port === 465,\n auth: this.options.auth,\n connectionTimeout: this.options.connectionTimeout ?? 10000,\n })\n } catch {\n throw new Error('SmtpProvider requires \"nodemailer\" package. Install: pnpm add nodemailer')\n }\n }\n\n async send(message: MailMessage): Promise<MailResult> {\n await this.ensureTransporter()\n\n const result = await this.transporter.sendMail({\n from: formatAddress(message.from),\n to: formatRecipients(message.to),\n cc: message.cc ? formatRecipients(message.cc) : undefined,\n bcc: message.bcc ? formatRecipients(message.bcc) : undefined,\n replyTo: message.replyTo ? formatAddress(message.replyTo) : undefined,\n subject: message.subject,\n text: message.text,\n html: message.html,\n attachments: message.attachments,\n headers: message.headers,\n })\n\n return {\n messageId: result.messageId,\n accepted: (result.accepted?.length ?? 0) > 0,\n raw: result,\n }\n }\n\n async shutdown(): Promise<void> {\n if (this.transporter) {\n this.transporter.close()\n }\n }\n}\n\nfunction formatAddress(addr: any): string | undefined {\n if (!addr) return undefined\n if (typeof addr === 'string') return addr\n return addr.name ? `\"${addr.name}\" <${addr.address}>` : addr.address\n}\n\nfunction formatRecipients(recipients: any): string {\n if (!recipients) return ''\n if (typeof recipients === 'string') return recipients\n if (Array.isArray(recipients)) {\n return recipients.map((r: any) => formatAddress(r)).join(', ')\n }\n return formatAddress(recipients) ?? ''\n}\n","import { Logger } from '@forinda/kickjs-core'\nimport type { MailProvider, MailMessage, MailResult } from '../types'\n\nconst log = Logger.for('ConsoleMail')\n\nlet counter = 0\n\n/**\n * Console mail provider — logs emails instead of sending them.\n * Perfect for development and testing.\n *\n * @example\n * ```ts\n * new MailerAdapter({\n * provider: new ConsoleProvider(),\n * defaultFrom: 'dev@localhost',\n * })\n * ```\n */\nexport class ConsoleProvider implements MailProvider {\n name = 'console'\n\n async send(message: MailMessage): Promise<MailResult> {\n const id = `console-${++counter}`\n const to = Array.isArray(message.to)\n ? message.to.map((r) => (typeof r === 'string' ? r : r.address)).join(', ')\n : typeof message.to === 'string'\n ? message.to\n : message.to.address\n\n log.info(`────────────────────────────────────────`)\n log.info(`From: ${formatAddr(message.from)}`)\n log.info(`To: ${to}`)\n if (message.cc) log.info(`CC: ${formatAddr(message.cc)}`)\n if (message.bcc) log.info(`BCC: ${formatAddr(message.bcc)}`)\n log.info(`Subject: ${message.subject}`)\n if (message.text)\n log.info(`Text: ${message.text.slice(0, 200)}${message.text.length > 200 ? '...' : ''}`)\n if (message.html)\n log.info(`HTML: ${message.html.slice(0, 200)}${message.html.length > 200 ? '...' : ''}`)\n if (message.attachments?.length) {\n log.info(`Attach: ${message.attachments.map((a) => a.filename).join(', ')}`)\n }\n log.info(`ID: ${id}`)\n log.info(`────────────────────────────────────────`)\n\n return { messageId: id, accepted: true }\n }\n}\n\nfunction formatAddr(addr: any): string {\n if (!addr) return '(none)'\n if (typeof addr === 'string') return addr\n if (Array.isArray(addr)) return addr.map(formatAddr).join(', ')\n return addr.name ? `\"${addr.name}\" <${addr.address}>` : addr.address\n}\n"],"mappings":"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","names":["Logger","log","Logger","for","MAILER","Symbol","MailerService","provider","defaultFrom","templateEngine","enabled","options","send","message","msg","from","info","formatRecipient","to","subject","messageId","accepted","result","err","error","sendTemplate","template","data","Error","html","render","getProvider","shutdown","Array","isArray","map","r","address","join","Logger","log","Logger","for","MailerAdapter","name","mailer","options","MailerService","afterStart","_server","container","registerInstance","MAILER","info","provider","enabled","shutdown","SmtpProvider","name","transporter","options","ensureTransporter","nodemailer","createTransport","default","host","port","secure","auth","connectionTimeout","Error","send","message","result","sendMail","from","formatAddress","to","formatRecipients","cc","undefined","bcc","replyTo","subject","text","html","attachments","headers","messageId","accepted","length","raw","shutdown","close","addr","address","recipients","Array","isArray","map","r","join","Logger","log","Logger","for","counter","ConsoleProvider","name","send","message","id","to","Array","isArray","map","r","address","join","info","formatAddr","from","cc","bcc","subject","text","slice","length","html","attachments","a","filename","messageId","accepted","addr"]}
|