ts-mailkit 2.0.0 → 2.0.1
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/core/client.d.ts.map +1 -1
- package/dist/core/errors.d.ts.map +1 -1
- package/dist/index.cjs +655 -754
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +636 -709
- package/dist/index.js.map +1 -1
- package/dist/renderers/default/default-renderer.d.ts.map +1 -1
- package/dist/templates/factory.d.ts.map +1 -1
- package/dist/transports/console/console-sender.d.ts.map +1 -1
- package/dist/transports/memory/memory-sender.d.ts.map +1 -1
- package/dist/transports/zeptomail/zeptomail-sender.d.ts.map +1 -1
- package/package.json +5 -5
package/dist/index.js
CHANGED
|
@@ -1,757 +1,684 @@
|
|
|
1
|
-
|
|
1
|
+
//#region src/core/types.ts
|
|
2
|
+
/**
|
|
3
|
+
* Parses an RFC 5322 formatted address string into an EmailAddress.
|
|
4
|
+
* Supports formats such as:
|
|
5
|
+
* - "user@example.com" -> { address: "user@example.com" }
|
|
6
|
+
* - "Sender Name <sender@example.com>" -> { name: "Sender Name", address: "sender@example.com" }
|
|
7
|
+
* - "\"Sender Name\" <sender@example.com>" -> { name: "Sender Name", address: "sender@example.com" }
|
|
8
|
+
*/
|
|
2
9
|
function parseEmailAddress(input) {
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
return {
|
|
12
|
-
address: match[2].trim(),
|
|
13
|
-
name: match[1]?.trim() || void 0
|
|
14
|
-
};
|
|
10
|
+
if (!input || typeof input !== "string") return { address: "" };
|
|
11
|
+
const trimmed = input.trim();
|
|
12
|
+
const match = trimmed.match(/^(?:["']?([^"']+)["']?\s+)?<?([^\s<>@]+@[^\s<>@]+)>?$/);
|
|
13
|
+
if (!match) return { address: trimmed };
|
|
14
|
+
return {
|
|
15
|
+
address: match[2].trim(),
|
|
16
|
+
name: match[1]?.trim() || void 0
|
|
17
|
+
};
|
|
15
18
|
}
|
|
19
|
+
/**
|
|
20
|
+
* Normalizes a Recipient value into a standardized EmailAddress.
|
|
21
|
+
*/
|
|
16
22
|
function normalizeRecipient(recipient) {
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
return {
|
|
27
|
-
address: (recipient.address ?? "").trim(),
|
|
28
|
-
name: recipient.name?.trim()
|
|
29
|
-
};
|
|
23
|
+
if (typeof recipient === "string") return { address: recipient.trim() };
|
|
24
|
+
if ("email" in recipient) return {
|
|
25
|
+
address: (recipient.email ?? "").trim(),
|
|
26
|
+
name: recipient.name?.trim()
|
|
27
|
+
};
|
|
28
|
+
return {
|
|
29
|
+
address: (recipient.address ?? "").trim(),
|
|
30
|
+
name: recipient.name?.trim()
|
|
31
|
+
};
|
|
30
32
|
}
|
|
33
|
+
/**
|
|
34
|
+
* Normalizes a single or array of Recipients into an array of EmailAddress.
|
|
35
|
+
*/
|
|
31
36
|
function normalizeRecipients(recipients) {
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
return list.map(normalizeRecipient).filter((r) => r.address.length > 0);
|
|
37
|
+
if (!recipients) return [];
|
|
38
|
+
return (Array.isArray(recipients) ? recipients : [recipients]).map(normalizeRecipient).filter((r) => r.address.length > 0);
|
|
35
39
|
}
|
|
36
40
|
|
|
37
|
-
|
|
41
|
+
//#endregion
|
|
42
|
+
//#region src/core/errors.ts
|
|
43
|
+
/**
|
|
44
|
+
* Base error class for all ts-mailkit errors.
|
|
45
|
+
*/
|
|
38
46
|
var MailKitError = class extends Error {
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
47
|
+
constructor(message) {
|
|
48
|
+
super(message);
|
|
49
|
+
this.name = "MailKitError";
|
|
50
|
+
Object.setPrototypeOf(this, new.target.prototype);
|
|
51
|
+
}
|
|
44
52
|
};
|
|
53
|
+
/**
|
|
54
|
+
* Thrown when transport configuration is missing or invalid.
|
|
55
|
+
*/
|
|
45
56
|
var ConfigurationError = class extends MailKitError {
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
57
|
+
constructor(message) {
|
|
58
|
+
super(message);
|
|
59
|
+
this.name = "ConfigurationError";
|
|
60
|
+
Object.setPrototypeOf(this, new.target.prototype);
|
|
61
|
+
}
|
|
51
62
|
};
|
|
63
|
+
/**
|
|
64
|
+
* Thrown when an email transport fails to dispatch an email.
|
|
65
|
+
*/
|
|
52
66
|
var TransportError = class extends MailKitError {
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
67
|
+
transportName;
|
|
68
|
+
statusCode;
|
|
69
|
+
responseBody;
|
|
70
|
+
cause;
|
|
71
|
+
constructor(message, options) {
|
|
72
|
+
super(message);
|
|
73
|
+
this.name = "TransportError";
|
|
74
|
+
this.transportName = options.transportName;
|
|
75
|
+
this.statusCode = options.statusCode;
|
|
76
|
+
this.responseBody = options.responseBody;
|
|
77
|
+
this.cause = options.cause;
|
|
78
|
+
Object.setPrototypeOf(this, new.target.prototype);
|
|
79
|
+
}
|
|
66
80
|
};
|
|
81
|
+
/**
|
|
82
|
+
* Thrown when template rendering or DTO validation fails.
|
|
83
|
+
*/
|
|
67
84
|
var TemplateError = class extends MailKitError {
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
85
|
+
constructor(message) {
|
|
86
|
+
super(message);
|
|
87
|
+
this.name = "TemplateError";
|
|
88
|
+
Object.setPrototypeOf(this, new.target.prototype);
|
|
89
|
+
}
|
|
73
90
|
};
|
|
74
91
|
|
|
75
|
-
|
|
92
|
+
//#endregion
|
|
93
|
+
//#region src/renderers/utils/html-to-plaintext.ts
|
|
94
|
+
/**
|
|
95
|
+
* Decodes common HTML entities into their plain text equivalents.
|
|
96
|
+
*/
|
|
76
97
|
function decodeHtmlEntities(text) {
|
|
77
|
-
|
|
98
|
+
return text.replace(/ /gi, " ").replace(/&/gi, "&").replace(/</gi, "<").replace(/>/gi, ">").replace(/"/gi, "\"").replace(/'/gi, "'").replace(/©/gi, "©").replace(/®/gi, "®").replace(/™/gi, "™");
|
|
78
99
|
}
|
|
100
|
+
/**
|
|
101
|
+
* Strips HTML tags and normalizes whitespace into readable plain text.
|
|
102
|
+
* Converts <br>, <p>, and <div> into appropriate line breaks.
|
|
103
|
+
*/
|
|
79
104
|
function htmlToPlainText(html) {
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
html.replace(/<br\s*\/?>/gi, "\n").replace(/<\/p>/gi, "\n\n").replace(/<\/div>/gi, "\n").replace(/<\/h[1-6]>/gi, "\n\n").replace(/<[^>]*>/g, "")
|
|
83
|
-
).replace(/[ \t]+/g, " ").replace(/\n\s*\n\s*\n+/g, "\n\n").trim();
|
|
105
|
+
if (!html) return "";
|
|
106
|
+
return decodeHtmlEntities(html.replace(/<br\s*\/?>/gi, "\n").replace(/<\/p>/gi, "\n\n").replace(/<\/div>/gi, "\n").replace(/<\/h[1-6]>/gi, "\n\n").replace(/<[^>]*>/g, "")).replace(/[ \t]+/g, " ").replace(/\n\s*\n\s*\n+/g, "\n\n").trim();
|
|
84
107
|
}
|
|
85
108
|
|
|
86
|
-
|
|
109
|
+
//#endregion
|
|
110
|
+
//#region src/renderers/default/default-renderer.ts
|
|
111
|
+
/**
|
|
112
|
+
* Validates whether a string is a valid HTTP or HTTPS URL.
|
|
113
|
+
*/
|
|
87
114
|
function isValidHttpUrl(urlString) {
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
115
|
+
if (!urlString || typeof urlString !== "string") return false;
|
|
116
|
+
try {
|
|
117
|
+
const url = new URL(urlString.trim());
|
|
118
|
+
return (url.protocol === "http:" || url.protocol === "https:") && url.hostname.length > 0;
|
|
119
|
+
} catch {
|
|
120
|
+
return false;
|
|
121
|
+
}
|
|
95
122
|
}
|
|
123
|
+
/**
|
|
124
|
+
* Builds a plain-text fallback string from an email DTO.
|
|
125
|
+
*/
|
|
96
126
|
function buildPlainText(dto) {
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
}
|
|
108
|
-
if (dto.otpCode) {
|
|
109
|
-
parts.push(`Verification Code: ${dto.otpCode}`);
|
|
110
|
-
}
|
|
111
|
-
if (dto.actionText && dto.actionUrl) {
|
|
112
|
-
parts.push(`${dto.actionText}: ${dto.actionUrl}`);
|
|
113
|
-
}
|
|
114
|
-
if (dto.extraMessage) {
|
|
115
|
-
parts.push(htmlToPlainText(dto.extraMessage));
|
|
116
|
-
}
|
|
117
|
-
if (dto.footer) {
|
|
118
|
-
parts.push(`${divider}
|
|
119
|
-
${htmlToPlainText(dto.footer)}`);
|
|
120
|
-
}
|
|
121
|
-
return parts.join("\n\n");
|
|
127
|
+
if (dto.noHtmlMessage) return dto.noHtmlMessage;
|
|
128
|
+
const divider = "──────────────────────────────";
|
|
129
|
+
const parts = [];
|
|
130
|
+
if (dto.header) parts.push(dto.header, divider);
|
|
131
|
+
if (dto.body) parts.push(htmlToPlainText(dto.body));
|
|
132
|
+
if (dto.otpCode) parts.push(`Verification Code: ${dto.otpCode}`);
|
|
133
|
+
if (dto.actionText && dto.actionUrl) parts.push(`${dto.actionText}: ${dto.actionUrl}`);
|
|
134
|
+
if (dto.extraMessage) parts.push(htmlToPlainText(dto.extraMessage));
|
|
135
|
+
if (dto.footer) parts.push(`${divider}\n${htmlToPlainText(dto.footer)}`);
|
|
136
|
+
return parts.join("\n\n");
|
|
122
137
|
}
|
|
138
|
+
/**
|
|
139
|
+
* Builds a responsive, styled HTML email document from an email DTO.
|
|
140
|
+
*/
|
|
123
141
|
function buildHtml(dto, options = {}) {
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
}
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
);
|
|
153
|
-
}
|
|
154
|
-
if (dto.header) {
|
|
155
|
-
parts.push(
|
|
156
|
-
`<h2 style="margin:0 0 16px;font-size:1.5rem;font-weight:700;color:#111827;letter-spacing:-0.025em;">${dto.header}</h2>`
|
|
157
|
-
);
|
|
158
|
-
}
|
|
159
|
-
if (dto.body) {
|
|
160
|
-
parts.push(`<div style="margin:0 0 20px;font-size:1rem;color:#374151;">${dto.body}</div>`);
|
|
161
|
-
}
|
|
162
|
-
if (dto.otpCode) {
|
|
163
|
-
parts.push(
|
|
164
|
-
`<div style="margin:24px 0;padding:20px;background-color:#f3f4f6;border-radius:8px;text-align:center;">`,
|
|
165
|
-
` <span style="font-size:2rem;letter-spacing:0.5rem;font-weight:700;color:#111827;font-family:monospace;">${dto.otpCode}</span>`,
|
|
166
|
-
`</div>`
|
|
167
|
-
);
|
|
168
|
-
}
|
|
169
|
-
if (dto.actionUrl && dto.actionText) {
|
|
170
|
-
parts.push(
|
|
171
|
-
`<div style="margin:24px 0;text-align:center;">`,
|
|
172
|
-
` <a href="${dto.actionUrl}" style="display:inline-block;padding:12px 28px;background-color:${primaryColor};color:#ffffff;border-radius:6px;text-decoration:none;font-weight:600;font-size:1rem;text-align:center;box-sizing:border-box;">${dto.actionText}</a>`,
|
|
173
|
-
`</div>`
|
|
174
|
-
);
|
|
175
|
-
}
|
|
176
|
-
if (dto.extraMessage) {
|
|
177
|
-
parts.push(
|
|
178
|
-
`<div style="margin:20px 0 0;font-size:0.875rem;color:#6b7280;line-height:1.5;">${dto.extraMessage}</div>`
|
|
179
|
-
);
|
|
180
|
-
}
|
|
181
|
-
if (dto.footer) {
|
|
182
|
-
parts.push(
|
|
183
|
-
`<div style="margin-top:32px;padding-top:20px;border-top:1px solid #e5e7eb;font-size:0.75rem;color:#9ca3af;text-align:center;">${dto.footer}</div>`
|
|
184
|
-
);
|
|
185
|
-
}
|
|
186
|
-
parts.push(`</div>`, `</body>`, `</html>`);
|
|
187
|
-
return parts.join("\n");
|
|
142
|
+
const primaryColor = options.primaryColor || "#4f46e5";
|
|
143
|
+
const fontFamily = options.fontFamily || "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif";
|
|
144
|
+
const maxWidth = options.maxWidth || "600px";
|
|
145
|
+
const parts = [
|
|
146
|
+
`<!DOCTYPE html>`,
|
|
147
|
+
`<html lang="en">`,
|
|
148
|
+
`<head>`,
|
|
149
|
+
`<meta charset="UTF-8">`,
|
|
150
|
+
`<meta name="viewport" content="width=device-width, initial-scale=1.0">`,
|
|
151
|
+
`<title>${dto.subject}</title>`,
|
|
152
|
+
`</head>`,
|
|
153
|
+
`<body style="margin:0;padding:24px 16px;background-color:#f9fafb;font-family:${fontFamily};color:#1f2937;line-height:1.6;">`,
|
|
154
|
+
`<div style="max-width:${maxWidth};margin:0 auto;background-color:#ffffff;padding:32px 28px;border-radius:8px;box-shadow:0 1px 3px rgba(0,0,0,0.1);border:1px solid #f3f4f6;">`
|
|
155
|
+
];
|
|
156
|
+
const logoCandidate = dto.logoUrl ?? options.logoUrl;
|
|
157
|
+
if (logoCandidate && isValidHttpUrl(logoCandidate)) {
|
|
158
|
+
const validLogo = logoCandidate.trim();
|
|
159
|
+
parts.push(`<div style="margin-bottom:24px;text-align:center;">`, ` <img src="${validLogo}" alt="${dto.fromName || "Logo"}" style="max-height:48px;max-width:200px;height:auto;width:auto;display:inline-block;border:0;outline:none;text-decoration:none;" />`, `</div>`);
|
|
160
|
+
}
|
|
161
|
+
if (dto.imageUrl) parts.push(`<div style="margin-bottom:24px;text-align:center;">`, ` <img src="${dto.imageUrl}" alt="Header" style="max-width:100%;height:auto;border-radius:6px;" />`, `</div>`);
|
|
162
|
+
if (dto.header) parts.push(`<h2 style="margin:0 0 16px;font-size:1.5rem;font-weight:700;color:#111827;letter-spacing:-0.025em;">${dto.header}</h2>`);
|
|
163
|
+
if (dto.body) parts.push(`<div style="margin:0 0 20px;font-size:1rem;color:#374151;">${dto.body}</div>`);
|
|
164
|
+
if (dto.otpCode) parts.push(`<div style="margin:24px 0;padding:20px;background-color:#f3f4f6;border-radius:8px;text-align:center;">`, ` <span style="font-size:2rem;letter-spacing:0.5rem;font-weight:700;color:#111827;font-family:monospace;">${dto.otpCode}</span>`, `</div>`);
|
|
165
|
+
if (dto.actionUrl && dto.actionText) parts.push(`<div style="margin:24px 0;text-align:center;">`, ` <a href="${dto.actionUrl}" style="display:inline-block;padding:12px 28px;background-color:${primaryColor};color:#ffffff;border-radius:6px;text-decoration:none;font-weight:600;font-size:1rem;text-align:center;box-sizing:border-box;">${dto.actionText}</a>`, `</div>`);
|
|
166
|
+
if (dto.extraMessage) parts.push(`<div style="margin:20px 0 0;font-size:0.875rem;color:#6b7280;line-height:1.5;">${dto.extraMessage}</div>`);
|
|
167
|
+
if (dto.footer) parts.push(`<div style="margin-top:32px;padding-top:20px;border-top:1px solid #e5e7eb;font-size:0.75rem;color:#9ca3af;text-align:center;">${dto.footer}</div>`);
|
|
168
|
+
parts.push(`</div>`, `</body>`, `</html>`);
|
|
169
|
+
return parts.join("\n");
|
|
188
170
|
}
|
|
171
|
+
/**
|
|
172
|
+
* Default HTML and plain-text email renderer for ts-mailkit.
|
|
173
|
+
*/
|
|
189
174
|
var DefaultEmailRenderer = class {
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
175
|
+
options;
|
|
176
|
+
constructor(options = {}) {
|
|
177
|
+
this.options = options;
|
|
178
|
+
}
|
|
179
|
+
render(dto) {
|
|
180
|
+
return {
|
|
181
|
+
html: buildHtml(dto, this.options),
|
|
182
|
+
text: buildPlainText(dto)
|
|
183
|
+
};
|
|
184
|
+
}
|
|
200
185
|
};
|
|
201
186
|
|
|
202
|
-
|
|
187
|
+
//#endregion
|
|
188
|
+
//#region src/core/client.ts
|
|
189
|
+
/**
|
|
190
|
+
* Main email client and orchestration service for ts-mailkit.
|
|
191
|
+
*/
|
|
203
192
|
var MailKit = class {
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
return await this.transport.send({
|
|
288
|
-
...options,
|
|
289
|
-
from,
|
|
290
|
-
text
|
|
291
|
-
});
|
|
292
|
-
}
|
|
193
|
+
transport;
|
|
194
|
+
renderer;
|
|
195
|
+
defaultFrom;
|
|
196
|
+
defaultBrandName;
|
|
197
|
+
brandNameResolver;
|
|
198
|
+
constructor(options) {
|
|
199
|
+
if (!options.transport) throw new ConfigurationError("MailKit: A transport adapter (IEmailSender) is required.");
|
|
200
|
+
this.transport = options.transport;
|
|
201
|
+
this.renderer = options.renderer ?? new DefaultEmailRenderer();
|
|
202
|
+
this.defaultFrom = options.defaultFrom;
|
|
203
|
+
this.defaultBrandName = options.defaultBrandName;
|
|
204
|
+
this.brandNameResolver = options.brandNameResolver;
|
|
205
|
+
}
|
|
206
|
+
/**
|
|
207
|
+
* Returns the underlying transport instance.
|
|
208
|
+
*/
|
|
209
|
+
getTransport() {
|
|
210
|
+
return this.transport;
|
|
211
|
+
}
|
|
212
|
+
/**
|
|
213
|
+
* Renders an email DTO to HTML and plain text without dispatching.
|
|
214
|
+
*/
|
|
215
|
+
async render(template) {
|
|
216
|
+
return await this.renderer.render(template);
|
|
217
|
+
}
|
|
218
|
+
/**
|
|
219
|
+
* Sends an email using a strongly-typed template DTO.
|
|
220
|
+
*
|
|
221
|
+
* Example:
|
|
222
|
+
* ```ts
|
|
223
|
+
* await mailer.send({
|
|
224
|
+
* to: 'user@example.com',
|
|
225
|
+
* template: myDto,
|
|
226
|
+
* });
|
|
227
|
+
* ```
|
|
228
|
+
*/
|
|
229
|
+
async send(options) {
|
|
230
|
+
const template = options.template;
|
|
231
|
+
const recipientName = options.toName ?? template.userName;
|
|
232
|
+
let resolvedFromName = options.fromName ?? template.fromName;
|
|
233
|
+
if (!resolvedFromName && this.brandNameResolver) resolvedFromName = await this.brandNameResolver();
|
|
234
|
+
if (!resolvedFromName) resolvedFromName = this.defaultBrandName;
|
|
235
|
+
const rendered = await this.renderer.render(template);
|
|
236
|
+
const plaintextBody = template.noHtmlMessage ?? rendered.text;
|
|
237
|
+
let toRecipients;
|
|
238
|
+
if (typeof options.to === "string" && recipientName) toRecipients = {
|
|
239
|
+
address: options.to,
|
|
240
|
+
name: recipientName
|
|
241
|
+
};
|
|
242
|
+
else toRecipients = options.to;
|
|
243
|
+
let from = options.from ?? this.defaultFrom;
|
|
244
|
+
if (resolvedFromName && from) from = {
|
|
245
|
+
address: normalizeRecipient(from).address,
|
|
246
|
+
name: resolvedFromName
|
|
247
|
+
};
|
|
248
|
+
return await this.sendRaw({
|
|
249
|
+
to: toRecipients,
|
|
250
|
+
from,
|
|
251
|
+
subject: template.subject,
|
|
252
|
+
html: rendered.html,
|
|
253
|
+
text: plaintextBody,
|
|
254
|
+
cc: options.cc,
|
|
255
|
+
bcc: options.bcc,
|
|
256
|
+
replyTo: options.replyTo,
|
|
257
|
+
attachments: options.attachments,
|
|
258
|
+
headers: options.headers,
|
|
259
|
+
tags: options.tags,
|
|
260
|
+
metadata: options.metadata
|
|
261
|
+
});
|
|
262
|
+
}
|
|
263
|
+
/**
|
|
264
|
+
* Dispatches a raw, pre-rendered email directly through the transport.
|
|
265
|
+
* If `options.text` is omitted, plain text is automatically derived from `options.html`.
|
|
266
|
+
*/
|
|
267
|
+
async sendRaw(options) {
|
|
268
|
+
const from = options.from ?? this.defaultFrom;
|
|
269
|
+
const text = options.text ?? (options.html ? htmlToPlainText(options.html) : void 0);
|
|
270
|
+
return await this.transport.send({
|
|
271
|
+
...options,
|
|
272
|
+
from,
|
|
273
|
+
text
|
|
274
|
+
});
|
|
275
|
+
}
|
|
293
276
|
};
|
|
277
|
+
/**
|
|
278
|
+
* Convenience factory to create a MailKit client instance.
|
|
279
|
+
*/
|
|
294
280
|
function createMailKit(options) {
|
|
295
|
-
|
|
281
|
+
return new MailKit(options);
|
|
296
282
|
}
|
|
297
283
|
|
|
298
|
-
|
|
284
|
+
//#endregion
|
|
285
|
+
//#region src/transports/zeptomail/zeptomail-sender.ts
|
|
286
|
+
/**
|
|
287
|
+
* ZeptoMail (Zoho Mail transactional email HTTP API) transport adapter.
|
|
288
|
+
*
|
|
289
|
+
* Designed for zero dependencies and universal edge compatibility (Node.js, Bun, Deno, Cloudflare Workers)
|
|
290
|
+
* by utilizing the standard global `fetch` API.
|
|
291
|
+
*/
|
|
299
292
|
var ZeptoMailHttpSender = class {
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
} catch (err) {
|
|
415
|
-
throw new TransportError(`ZeptoMailHttpSender: Network request failed: ${err instanceof Error ? err.message : String(err)}`, {
|
|
416
|
-
transportName: this.name,
|
|
417
|
-
cause: err
|
|
418
|
-
});
|
|
419
|
-
}
|
|
420
|
-
const responseText = await response.text();
|
|
421
|
-
let responseData;
|
|
422
|
-
try {
|
|
423
|
-
responseData = responseText ? JSON.parse(responseText) : {};
|
|
424
|
-
} catch {
|
|
425
|
-
responseData = { raw: responseText };
|
|
426
|
-
}
|
|
427
|
-
if (!response.ok) {
|
|
428
|
-
const errorMessage = responseData?.error?.message || responseData?.message || `HTTP ${response.status}: ${responseText || response.statusText}`;
|
|
429
|
-
throw new TransportError(`ZeptoMailHttpSender: Failed to send email - ${errorMessage}`, {
|
|
430
|
-
transportName: this.name,
|
|
431
|
-
statusCode: response.status,
|
|
432
|
-
responseBody: responseText
|
|
433
|
-
});
|
|
434
|
-
}
|
|
435
|
-
const messageId = responseData?.data?.[0]?.message_id;
|
|
436
|
-
return {
|
|
437
|
-
success: true,
|
|
438
|
-
messageId,
|
|
439
|
-
response: responseData
|
|
440
|
-
};
|
|
441
|
-
}
|
|
293
|
+
name = "zeptomail";
|
|
294
|
+
apiUrl;
|
|
295
|
+
authHeader;
|
|
296
|
+
defaultFrom;
|
|
297
|
+
fetchImpl;
|
|
298
|
+
constructor(config) {
|
|
299
|
+
if (!config.apiToken || typeof config.apiToken !== "string") throw new ConfigurationError("ZeptoMailHttpSender: Missing or invalid apiToken.");
|
|
300
|
+
if (!config.from) throw new ConfigurationError("ZeptoMailHttpSender: Missing required default from address.");
|
|
301
|
+
const host = (config.apiHost || "api.zeptomail.com").replace(/^https?:\/\//, "").replace(/\/+$/, "");
|
|
302
|
+
this.apiUrl = `https://${host}/v1.1/email`;
|
|
303
|
+
const token = config.apiToken.trim();
|
|
304
|
+
this.authHeader = token.startsWith("Zoho-") ? token : `Zoho-enczapikey ${token}`;
|
|
305
|
+
this.defaultFrom = normalizeRecipient(config.from);
|
|
306
|
+
if (!this.defaultFrom.address) throw new ConfigurationError("ZeptoMailHttpSender: Configured from address must not be empty.");
|
|
307
|
+
const fetchImpl = config.fetch ?? globalThis.fetch;
|
|
308
|
+
if (typeof fetchImpl !== "function") throw new ConfigurationError("ZeptoMailHttpSender: No global fetch implementation found. Pass a custom fetch to ZeptoMailHttpConfig if running on Node < 18.");
|
|
309
|
+
this.fetchImpl = fetchImpl.bind(globalThis);
|
|
310
|
+
}
|
|
311
|
+
/**
|
|
312
|
+
* Dispatches an email using Zoho ZeptoMail API v1.1.
|
|
313
|
+
*/
|
|
314
|
+
async send(options) {
|
|
315
|
+
const toRecipients = normalizeRecipients(options.to);
|
|
316
|
+
if (toRecipients.length === 0) throw new TransportError("ZeptoMailHttpSender: At least one recipient (to) must be specified.", { transportName: this.name });
|
|
317
|
+
const resolvedFrom = options.from ? normalizeRecipient(options.from) : this.defaultFrom;
|
|
318
|
+
const payload = {
|
|
319
|
+
from: {
|
|
320
|
+
address: resolvedFrom.address,
|
|
321
|
+
name: resolvedFrom.name
|
|
322
|
+
},
|
|
323
|
+
to: toRecipients.map((r) => ({ email_address: {
|
|
324
|
+
address: r.address,
|
|
325
|
+
name: r.name || ""
|
|
326
|
+
} })),
|
|
327
|
+
subject: options.subject,
|
|
328
|
+
htmlbody: options.html,
|
|
329
|
+
textbody: options.text
|
|
330
|
+
};
|
|
331
|
+
if (options.cc) {
|
|
332
|
+
const ccList = normalizeRecipients(options.cc);
|
|
333
|
+
if (ccList.length > 0) payload.cc = ccList.map((r) => ({ email_address: {
|
|
334
|
+
address: r.address,
|
|
335
|
+
name: r.name || ""
|
|
336
|
+
} }));
|
|
337
|
+
}
|
|
338
|
+
if (options.bcc) {
|
|
339
|
+
const bccList = normalizeRecipients(options.bcc);
|
|
340
|
+
if (bccList.length > 0) payload.bcc = bccList.map((r) => ({ email_address: {
|
|
341
|
+
address: r.address,
|
|
342
|
+
name: r.name || ""
|
|
343
|
+
} }));
|
|
344
|
+
}
|
|
345
|
+
if (options.replyTo) {
|
|
346
|
+
const replyToList = normalizeRecipients(options.replyTo);
|
|
347
|
+
if (replyToList.length > 0) payload.reply_to = replyToList.map((r) => ({
|
|
348
|
+
address: r.address,
|
|
349
|
+
name: r.name
|
|
350
|
+
}));
|
|
351
|
+
}
|
|
352
|
+
if (options.attachments && options.attachments.length > 0) payload.attachments = options.attachments.map((att) => {
|
|
353
|
+
let contentBase64;
|
|
354
|
+
if (typeof att.content === "string") contentBase64 = att.content;
|
|
355
|
+
else if (typeof Buffer !== "undefined") contentBase64 = Buffer.from(att.content).toString("base64");
|
|
356
|
+
else {
|
|
357
|
+
let binary = "";
|
|
358
|
+
const bytes = new Uint8Array(att.content);
|
|
359
|
+
for (let i = 0; i < bytes.byteLength; i++) binary += String.fromCharCode(bytes[i]);
|
|
360
|
+
contentBase64 = btoa(binary);
|
|
361
|
+
}
|
|
362
|
+
return {
|
|
363
|
+
name: att.filename,
|
|
364
|
+
content: contentBase64,
|
|
365
|
+
mime_type: att.mimeType || att.contentType || "application/octet-stream",
|
|
366
|
+
cid: att.cid
|
|
367
|
+
};
|
|
368
|
+
});
|
|
369
|
+
let response;
|
|
370
|
+
try {
|
|
371
|
+
response = await this.fetchImpl(this.apiUrl, {
|
|
372
|
+
method: "POST",
|
|
373
|
+
headers: {
|
|
374
|
+
Accept: "application/json",
|
|
375
|
+
"Content-Type": "application/json",
|
|
376
|
+
Authorization: this.authHeader
|
|
377
|
+
},
|
|
378
|
+
body: JSON.stringify(payload)
|
|
379
|
+
});
|
|
380
|
+
} catch (err) {
|
|
381
|
+
throw new TransportError(`ZeptoMailHttpSender: Network request failed: ${err instanceof Error ? err.message : String(err)}`, {
|
|
382
|
+
transportName: this.name,
|
|
383
|
+
cause: err
|
|
384
|
+
});
|
|
385
|
+
}
|
|
386
|
+
const responseText = await response.text();
|
|
387
|
+
let responseData;
|
|
388
|
+
try {
|
|
389
|
+
responseData = responseText ? JSON.parse(responseText) : {};
|
|
390
|
+
} catch {
|
|
391
|
+
responseData = { raw: responseText };
|
|
392
|
+
}
|
|
393
|
+
if (!response.ok) {
|
|
394
|
+
const errorMessage = responseData?.error?.message || responseData?.message || `HTTP ${response.status}: ${responseText || response.statusText}`;
|
|
395
|
+
throw new TransportError(`ZeptoMailHttpSender: Failed to send email - ${errorMessage}`, {
|
|
396
|
+
transportName: this.name,
|
|
397
|
+
statusCode: response.status,
|
|
398
|
+
responseBody: responseText
|
|
399
|
+
});
|
|
400
|
+
}
|
|
401
|
+
return {
|
|
402
|
+
success: true,
|
|
403
|
+
messageId: responseData?.data?.[0]?.message_id,
|
|
404
|
+
response: responseData
|
|
405
|
+
};
|
|
406
|
+
}
|
|
442
407
|
};
|
|
443
408
|
|
|
444
|
-
|
|
409
|
+
//#endregion
|
|
410
|
+
//#region src/transports/memory/memory-sender.ts
|
|
411
|
+
/**
|
|
412
|
+
* In-memory email sender for automated testing, local development, and CI environments.
|
|
413
|
+
* Captures all dispatched emails and provides inspection methods.
|
|
414
|
+
*/
|
|
445
415
|
var MemoryEmailSender = class {
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
|
|
472
|
-
|
|
473
|
-
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
|
|
416
|
+
name = "memory";
|
|
417
|
+
sentMails = [];
|
|
418
|
+
nextId = 1;
|
|
419
|
+
async send(options) {
|
|
420
|
+
this.sentMails.push({ ...options });
|
|
421
|
+
const messageId = `mem-${this.nextId++}-${Date.now()}`;
|
|
422
|
+
return {
|
|
423
|
+
success: true,
|
|
424
|
+
messageId,
|
|
425
|
+
response: { id: messageId }
|
|
426
|
+
};
|
|
427
|
+
}
|
|
428
|
+
/**
|
|
429
|
+
* Returns a copy of all emails sent through this transport instance.
|
|
430
|
+
*/
|
|
431
|
+
getSentMails() {
|
|
432
|
+
return [...this.sentMails];
|
|
433
|
+
}
|
|
434
|
+
/**
|
|
435
|
+
* Returns the most recent email sent, or undefined if no emails have been sent.
|
|
436
|
+
*/
|
|
437
|
+
getLastMail() {
|
|
438
|
+
return this.sentMails.length > 0 ? { ...this.sentMails[this.sentMails.length - 1] } : void 0;
|
|
439
|
+
}
|
|
440
|
+
/**
|
|
441
|
+
* Clears all recorded sent emails.
|
|
442
|
+
*/
|
|
443
|
+
clear() {
|
|
444
|
+
this.sentMails = [];
|
|
445
|
+
}
|
|
446
|
+
/**
|
|
447
|
+
* Returns the total count of sent emails.
|
|
448
|
+
*/
|
|
449
|
+
count() {
|
|
450
|
+
return this.sentMails.length;
|
|
451
|
+
}
|
|
482
452
|
};
|
|
483
453
|
|
|
484
|
-
|
|
454
|
+
//#endregion
|
|
455
|
+
//#region src/transports/console/console-sender.ts
|
|
456
|
+
/**
|
|
457
|
+
* Console logger transport that prints dispatched emails to stdout/stderr.
|
|
458
|
+
* Ideal for development and debugging.
|
|
459
|
+
*/
|
|
485
460
|
var ConsoleEmailSender = class {
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
return {
|
|
525
|
-
success: true,
|
|
526
|
-
messageId,
|
|
527
|
-
response: { logged: true }
|
|
528
|
-
};
|
|
529
|
-
}
|
|
461
|
+
name = "console";
|
|
462
|
+
log;
|
|
463
|
+
includeHtml;
|
|
464
|
+
nextId = 1;
|
|
465
|
+
constructor(options = {}) {
|
|
466
|
+
this.log = options.logger ?? console.log;
|
|
467
|
+
this.includeHtml = options.includeHtml ?? false;
|
|
468
|
+
}
|
|
469
|
+
async send(options) {
|
|
470
|
+
const to = normalizeRecipients(options.to).map((r) => r.name ? `${r.name} <${r.address}>` : r.address).join(", ");
|
|
471
|
+
const from = options.from ? JSON.stringify(options.from) : "(default)";
|
|
472
|
+
const messageId = `console-${this.nextId++}-${Date.now()}`;
|
|
473
|
+
const separator = "─".repeat(60);
|
|
474
|
+
const lines = [
|
|
475
|
+
`\n┌${separator}┐`,
|
|
476
|
+
`│ [ts-mailkit:console] DISPATCHED EMAIL (${messageId})`,
|
|
477
|
+
`├${separator}┤`,
|
|
478
|
+
`│ From: ${from}`,
|
|
479
|
+
`│ To: ${to}`,
|
|
480
|
+
`│ Subject: ${options.subject}`,
|
|
481
|
+
`├${separator}┤`
|
|
482
|
+
];
|
|
483
|
+
if (options.text) {
|
|
484
|
+
lines.push("│ Text Body:");
|
|
485
|
+
for (const line of options.text.split("\n")) lines.push(`│ ${line}`);
|
|
486
|
+
}
|
|
487
|
+
if (this.includeHtml && options.html) {
|
|
488
|
+
lines.push("│ HTML Body:");
|
|
489
|
+
for (const line of options.html.split("\n")) lines.push(`│ ${line}`);
|
|
490
|
+
}
|
|
491
|
+
lines.push(`└${separator}┘\n`);
|
|
492
|
+
this.log(lines.join("\n"));
|
|
493
|
+
return {
|
|
494
|
+
success: true,
|
|
495
|
+
messageId,
|
|
496
|
+
response: { logged: true }
|
|
497
|
+
};
|
|
498
|
+
}
|
|
530
499
|
};
|
|
531
500
|
|
|
532
|
-
|
|
533
|
-
|
|
501
|
+
//#endregion
|
|
502
|
+
//#region src/templates/factory.ts
|
|
503
|
+
const DEFAULT_SECURITY_MESSAGE = "If you did not request this, please ignore this email or contact support if you have concerns.";
|
|
534
504
|
function defaultFooter(brandName) {
|
|
535
|
-
|
|
505
|
+
return `© ${(/* @__PURE__ */ new Date()).getFullYear()} ${brandName}. All rights reserved.`;
|
|
536
506
|
}
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
|
|
545
|
-
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
|
|
549
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
|
|
561
|
-
|
|
562
|
-
|
|
563
|
-
|
|
564
|
-
|
|
565
|
-
|
|
566
|
-
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
570
|
-
|
|
571
|
-
|
|
572
|
-
|
|
573
|
-
|
|
574
|
-
|
|
575
|
-
|
|
576
|
-
|
|
577
|
-
|
|
578
|
-
|
|
579
|
-
|
|
580
|
-
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
|
|
590
|
-
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
|
|
596
|
-
|
|
597
|
-
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
|
|
603
|
-
|
|
604
|
-
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
609
|
-
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
|
|
639
|
-
|
|
640
|
-
|
|
641
|
-
|
|
642
|
-
|
|
643
|
-
|
|
644
|
-
|
|
645
|
-
|
|
646
|
-
|
|
647
|
-
|
|
648
|
-
|
|
649
|
-
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
667
|
-
|
|
668
|
-
|
|
669
|
-
|
|
670
|
-
|
|
671
|
-
|
|
672
|
-
|
|
673
|
-
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
|
|
683
|
-
|
|
684
|
-
|
|
685
|
-
|
|
686
|
-
|
|
687
|
-
|
|
688
|
-
|
|
689
|
-
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
|
|
693
|
-
|
|
694
|
-
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
|
|
706
|
-
|
|
707
|
-
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
static _defaultInstance;
|
|
711
|
-
static get defaultInstance() {
|
|
712
|
-
if (!this._defaultInstance) {
|
|
713
|
-
this._defaultInstance = new _EmailTemplateFactory();
|
|
714
|
-
}
|
|
715
|
-
return this._defaultInstance;
|
|
716
|
-
}
|
|
717
|
-
static createEmailVerification(params) {
|
|
718
|
-
return this.defaultInstance.createEmailVerification(params);
|
|
719
|
-
}
|
|
720
|
-
static createPasswordReset(params) {
|
|
721
|
-
return this.defaultInstance.createPasswordReset(params);
|
|
722
|
-
}
|
|
723
|
-
static createSimpleMessage(params) {
|
|
724
|
-
return this.defaultInstance.createSimpleMessage(params);
|
|
725
|
-
}
|
|
726
|
-
static createNewsLetter(params) {
|
|
727
|
-
return this.defaultInstance.createNewsLetter(params);
|
|
728
|
-
}
|
|
729
|
-
static create2FAEmail(params) {
|
|
730
|
-
return this.defaultInstance.create2FAEmail(params);
|
|
731
|
-
}
|
|
732
|
-
static createMagicLinkEmail(params) {
|
|
733
|
-
return this.defaultInstance.createMagicLinkEmail(params);
|
|
734
|
-
}
|
|
735
|
-
};
|
|
736
|
-
export {
|
|
737
|
-
ConfigurationError,
|
|
738
|
-
ConsoleEmailSender,
|
|
739
|
-
DefaultEmailRenderer,
|
|
740
|
-
EmailTemplateFactory,
|
|
741
|
-
MailKit,
|
|
742
|
-
MailKitError,
|
|
743
|
-
MemoryEmailSender,
|
|
744
|
-
TemplateError,
|
|
745
|
-
TransportError,
|
|
746
|
-
ZeptoMailHttpSender,
|
|
747
|
-
buildHtml,
|
|
748
|
-
buildPlainText,
|
|
749
|
-
createMailKit,
|
|
750
|
-
decodeHtmlEntities,
|
|
751
|
-
htmlToPlainText,
|
|
752
|
-
isValidHttpUrl,
|
|
753
|
-
normalizeRecipient,
|
|
754
|
-
normalizeRecipients,
|
|
755
|
-
parseEmailAddress
|
|
507
|
+
/**
|
|
508
|
+
* Factory for creating pre-populated, type-safe email template DTOs.
|
|
509
|
+
*/
|
|
510
|
+
var EmailTemplateFactory = class EmailTemplateFactory {
|
|
511
|
+
defaultBrandName;
|
|
512
|
+
defaultSecurityMessage;
|
|
513
|
+
footerResolver;
|
|
514
|
+
defaultLogoUrl;
|
|
515
|
+
constructor(config = {}) {
|
|
516
|
+
this.defaultBrandName = config.brandName || "Application";
|
|
517
|
+
this.defaultSecurityMessage = config.securityMessage || DEFAULT_SECURITY_MESSAGE;
|
|
518
|
+
this.defaultLogoUrl = config.logoUrl;
|
|
519
|
+
if (typeof config.footer === "function") this.footerResolver = config.footer;
|
|
520
|
+
else if (typeof config.footer === "string") {
|
|
521
|
+
const fixedFooter = config.footer;
|
|
522
|
+
this.footerResolver = () => fixedFooter;
|
|
523
|
+
} else this.footerResolver = defaultFooter;
|
|
524
|
+
}
|
|
525
|
+
resolveBrand(override) {
|
|
526
|
+
return override || this.defaultBrandName;
|
|
527
|
+
}
|
|
528
|
+
buildFooter(brandName) {
|
|
529
|
+
return this.footerResolver(brandName);
|
|
530
|
+
}
|
|
531
|
+
/**
|
|
532
|
+
* Welcome / email-verification email sent after registration.
|
|
533
|
+
*/
|
|
534
|
+
createEmailVerification(params) {
|
|
535
|
+
const { username, verificationUrl, otp, brandName } = params;
|
|
536
|
+
const brand = this.resolveBrand(brandName);
|
|
537
|
+
const body = `Hi ${username},<br/>Thank you for signing up. Use the code below or click the button to verify your email address.`;
|
|
538
|
+
return {
|
|
539
|
+
subject: "Verify Your Email Address",
|
|
540
|
+
header: `Welcome to ${brand}!`,
|
|
541
|
+
body,
|
|
542
|
+
logoUrl: this.defaultLogoUrl,
|
|
543
|
+
otpCode: otp,
|
|
544
|
+
actionUrl: verificationUrl,
|
|
545
|
+
actionText: "Verify Email",
|
|
546
|
+
extraMessage: this.defaultSecurityMessage,
|
|
547
|
+
footer: this.buildFooter(brand),
|
|
548
|
+
userName: username,
|
|
549
|
+
fromName: brand,
|
|
550
|
+
noHtmlMessage: htmlToPlainText(body) + `\n\nYour verification code is: ${otp}\n\nAlternatively, verify here:\n${verificationUrl}`
|
|
551
|
+
};
|
|
552
|
+
}
|
|
553
|
+
/**
|
|
554
|
+
* Password-reset email with an optional OTP code and action link.
|
|
555
|
+
*/
|
|
556
|
+
createPasswordReset(params) {
|
|
557
|
+
const { username, resetUrl, otp = "", brandName } = params;
|
|
558
|
+
const brand = this.resolveBrand(brandName);
|
|
559
|
+
const body = `Hi ${username},<br/>We received a request to reset your password. Use the OTP code below or click the button to proceed.`;
|
|
560
|
+
const plainTextOtp = otp ? `\n\nYour OTP code is: ${otp}` : "";
|
|
561
|
+
return {
|
|
562
|
+
subject: "Password Reset Request",
|
|
563
|
+
header: "Reset Your Password",
|
|
564
|
+
body,
|
|
565
|
+
logoUrl: this.defaultLogoUrl,
|
|
566
|
+
otpCode: otp || void 0,
|
|
567
|
+
actionUrl: resetUrl,
|
|
568
|
+
actionText: "Reset Password",
|
|
569
|
+
extraMessage: this.defaultSecurityMessage,
|
|
570
|
+
footer: this.buildFooter(brand),
|
|
571
|
+
userName: username,
|
|
572
|
+
fromName: brand,
|
|
573
|
+
noHtmlMessage: htmlToPlainText(body) + plainTextOtp + `\n\nAlternatively, you can use the following link to reset your password:\n${resetUrl}`
|
|
574
|
+
};
|
|
575
|
+
}
|
|
576
|
+
/**
|
|
577
|
+
* Generic plain message email (no action button, no OTP).
|
|
578
|
+
*/
|
|
579
|
+
createSimpleMessage(params) {
|
|
580
|
+
const { subject, header, body, brandName } = params;
|
|
581
|
+
const brand = this.resolveBrand(brandName);
|
|
582
|
+
return {
|
|
583
|
+
subject,
|
|
584
|
+
header,
|
|
585
|
+
body,
|
|
586
|
+
logoUrl: this.defaultLogoUrl,
|
|
587
|
+
footer: this.buildFooter(brand),
|
|
588
|
+
fromName: brand,
|
|
589
|
+
noHtmlMessage: htmlToPlainText(body)
|
|
590
|
+
};
|
|
591
|
+
}
|
|
592
|
+
/**
|
|
593
|
+
* Newsletter / announcement email with an optional hero image and CTA button.
|
|
594
|
+
*/
|
|
595
|
+
createNewsLetter(params) {
|
|
596
|
+
const { subject, header, body, imageUrl, actionUrl, actionText, brandName, logoUrl } = params;
|
|
597
|
+
const brand = this.resolveBrand(brandName);
|
|
598
|
+
let noHtmlMessage = htmlToPlainText(body);
|
|
599
|
+
if (actionUrl) noHtmlMessage += `\n\n${actionText || "Learn more"}: ${actionUrl}`;
|
|
600
|
+
return {
|
|
601
|
+
subject,
|
|
602
|
+
header,
|
|
603
|
+
body,
|
|
604
|
+
logoUrl: logoUrl || this.defaultLogoUrl,
|
|
605
|
+
imageUrl,
|
|
606
|
+
actionUrl,
|
|
607
|
+
actionText,
|
|
608
|
+
footer: this.buildFooter(brand),
|
|
609
|
+
fromName: brand,
|
|
610
|
+
noHtmlMessage
|
|
611
|
+
};
|
|
612
|
+
}
|
|
613
|
+
/**
|
|
614
|
+
* Two-factor authentication email with OTP code and optional magic link.
|
|
615
|
+
*/
|
|
616
|
+
create2FAEmail(params) {
|
|
617
|
+
const { username, otp, magicLink = "", brandName } = params;
|
|
618
|
+
const brand = this.resolveBrand(brandName);
|
|
619
|
+
const body = `Hi ${username},<br/>Use the code below or click the button to complete your login.`;
|
|
620
|
+
const plainLink = magicLink ? `\n\nAlternatively, verify here:\n${magicLink}` : "";
|
|
621
|
+
return {
|
|
622
|
+
subject: "Your Login Verification Code",
|
|
623
|
+
header: "Two-Factor Authentication",
|
|
624
|
+
body,
|
|
625
|
+
logoUrl: this.defaultLogoUrl,
|
|
626
|
+
otpCode: otp,
|
|
627
|
+
actionUrl: magicLink || void 0,
|
|
628
|
+
actionText: magicLink ? "Verify Login" : void 0,
|
|
629
|
+
extraMessage: this.defaultSecurityMessage,
|
|
630
|
+
footer: this.buildFooter(brand),
|
|
631
|
+
userName: username,
|
|
632
|
+
fromName: brand,
|
|
633
|
+
noHtmlMessage: htmlToPlainText(body) + `\n\nYour verification code is: ${otp}` + plainLink
|
|
634
|
+
};
|
|
635
|
+
}
|
|
636
|
+
/**
|
|
637
|
+
* Magic link sign-in email (no OTP, button only).
|
|
638
|
+
*/
|
|
639
|
+
createMagicLinkEmail(params) {
|
|
640
|
+
const { username, magicLink, brandName } = params;
|
|
641
|
+
const brand = this.resolveBrand(brandName);
|
|
642
|
+
const body = `Hi ${username},<br/>Click the button below to sign in. No password needed.`;
|
|
643
|
+
return {
|
|
644
|
+
subject: "Your Magic Link",
|
|
645
|
+
header: `Sign In to ${brand}`,
|
|
646
|
+
body,
|
|
647
|
+
logoUrl: this.defaultLogoUrl,
|
|
648
|
+
actionUrl: magicLink,
|
|
649
|
+
actionText: "Sign In",
|
|
650
|
+
extraMessage: this.defaultSecurityMessage,
|
|
651
|
+
footer: this.buildFooter(brand),
|
|
652
|
+
userName: username,
|
|
653
|
+
fromName: brand,
|
|
654
|
+
noHtmlMessage: htmlToPlainText(body) + `\n\nSign in here:\n${magicLink}`
|
|
655
|
+
};
|
|
656
|
+
}
|
|
657
|
+
static _defaultInstance;
|
|
658
|
+
static get defaultInstance() {
|
|
659
|
+
if (!this._defaultInstance) this._defaultInstance = new EmailTemplateFactory();
|
|
660
|
+
return this._defaultInstance;
|
|
661
|
+
}
|
|
662
|
+
static createEmailVerification(params) {
|
|
663
|
+
return this.defaultInstance.createEmailVerification(params);
|
|
664
|
+
}
|
|
665
|
+
static createPasswordReset(params) {
|
|
666
|
+
return this.defaultInstance.createPasswordReset(params);
|
|
667
|
+
}
|
|
668
|
+
static createSimpleMessage(params) {
|
|
669
|
+
return this.defaultInstance.createSimpleMessage(params);
|
|
670
|
+
}
|
|
671
|
+
static createNewsLetter(params) {
|
|
672
|
+
return this.defaultInstance.createNewsLetter(params);
|
|
673
|
+
}
|
|
674
|
+
static create2FAEmail(params) {
|
|
675
|
+
return this.defaultInstance.create2FAEmail(params);
|
|
676
|
+
}
|
|
677
|
+
static createMagicLinkEmail(params) {
|
|
678
|
+
return this.defaultInstance.createMagicLinkEmail(params);
|
|
679
|
+
}
|
|
756
680
|
};
|
|
681
|
+
|
|
682
|
+
//#endregion
|
|
683
|
+
export { ConfigurationError, ConsoleEmailSender, DefaultEmailRenderer, EmailTemplateFactory, MailKit, MailKitError, MemoryEmailSender, TemplateError, TransportError, ZeptoMailHttpSender, buildHtml, buildPlainText, createMailKit, decodeHtmlEntities, htmlToPlainText, isValidHttpUrl, normalizeRecipient, normalizeRecipients, parseEmailAddress };
|
|
757
684
|
//# sourceMappingURL=index.js.map
|