@theokit/gateway-email 0.1.0
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/CHANGELOG.md +37 -0
- package/LICENSE +201 -0
- package/README.md +7 -0
- package/dist/index.cjs +551 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +144 -0
- package/dist/index.d.ts +144 -0
- package/dist/index.js +542 -0
- package/dist/index.js.map +1 -0
- package/package.json +56 -0
package/dist/index.js
ADDED
|
@@ -0,0 +1,542 @@
|
|
|
1
|
+
import { BasePlatformAdapter } from '@theokit/gateway';
|
|
2
|
+
import { ImapFlow } from 'imapflow';
|
|
3
|
+
import { simpleParser } from 'mailparser';
|
|
4
|
+
import { createTransport } from 'nodemailer';
|
|
5
|
+
|
|
6
|
+
// src/adapter.ts
|
|
7
|
+
|
|
8
|
+
// src/errors.ts
|
|
9
|
+
var NETWORK_ERR_RE = /ECONN|ENOTFOUND|ETIMEDOUT|EHOSTUNREACH|EAI_AGAIN|fetch failed/i;
|
|
10
|
+
function mapEmailError(err) {
|
|
11
|
+
if (err === null || err === void 0) {
|
|
12
|
+
return { code: "unknown", message: "Unknown error" };
|
|
13
|
+
}
|
|
14
|
+
if (typeof err === "string") {
|
|
15
|
+
return { code: "unknown", message: err };
|
|
16
|
+
}
|
|
17
|
+
const e = err;
|
|
18
|
+
const code = e.code ?? "";
|
|
19
|
+
const respCode = typeof e.responseCode === "number" ? e.responseCode : void 0;
|
|
20
|
+
const message = typeof e.message === "string" && e.message.length > 0 ? e.message : String(err);
|
|
21
|
+
if (code === "EAUTH" || code === "EAUTHENTICATION") {
|
|
22
|
+
return { code: "auth_failed", message };
|
|
23
|
+
}
|
|
24
|
+
if (code === "EENVELOPE" && /550/.test(message)) {
|
|
25
|
+
return { code: "invalid_request", message };
|
|
26
|
+
}
|
|
27
|
+
if (code === "ECONNECTION" || code === "ESOCKET" || code === "ETLS") {
|
|
28
|
+
return { code: "server_error", message };
|
|
29
|
+
}
|
|
30
|
+
if (code === "ETIMEDOUT") {
|
|
31
|
+
return { code: "timeout", message };
|
|
32
|
+
}
|
|
33
|
+
if (respCode !== void 0) {
|
|
34
|
+
if (respCode === 535 || respCode === 530) return { code: "auth_failed", message };
|
|
35
|
+
if (respCode === 421 || respCode === 451 || respCode === 452)
|
|
36
|
+
return { code: "rate_limit", message };
|
|
37
|
+
if (respCode === 550 || respCode === 551 || respCode === 553)
|
|
38
|
+
return { code: "invalid_request", message };
|
|
39
|
+
if (respCode >= 500) return { code: "server_error", message };
|
|
40
|
+
if (respCode >= 400) return { code: "rate_limit", message };
|
|
41
|
+
}
|
|
42
|
+
if (e.name === "IMAP_AUTH_FAILED" || /auth/i.test(message)) {
|
|
43
|
+
return { code: "auth_failed", message };
|
|
44
|
+
}
|
|
45
|
+
if (NETWORK_ERR_RE.test(message)) return { code: "server_error", message };
|
|
46
|
+
return { code: "unknown", message };
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
// src/filters.ts
|
|
50
|
+
var NOREPLY_RE = /^(noreply|no-reply|no_reply|donotreply|do-not-reply|mailer-daemon|postmaster|bounce|notifications)@/i;
|
|
51
|
+
function extractAddr(s) {
|
|
52
|
+
const m = s.match(/<([^>]+)>/);
|
|
53
|
+
return (m?.[1] ?? s).toLowerCase().trim();
|
|
54
|
+
}
|
|
55
|
+
function isAutomatedSender(fromAddress, headers) {
|
|
56
|
+
if (NOREPLY_RE.test(fromAddress)) return true;
|
|
57
|
+
const lowered = /* @__PURE__ */ new Map();
|
|
58
|
+
for (const [k, v] of headers) lowered.set(k.toLowerCase(), v);
|
|
59
|
+
const autoSubmitted = lowered.get("auto-submitted");
|
|
60
|
+
if (typeof autoSubmitted === "string" && /auto-generated|auto-replied/i.test(autoSubmitted)) {
|
|
61
|
+
return true;
|
|
62
|
+
}
|
|
63
|
+
const precedence = lowered.get("precedence");
|
|
64
|
+
if (typeof precedence === "string" && /bulk|list/i.test(precedence)) {
|
|
65
|
+
return true;
|
|
66
|
+
}
|
|
67
|
+
const xAuto = lowered.get("x-auto-response-suppress");
|
|
68
|
+
if (typeof xAuto === "string" && /all/i.test(xAuto)) {
|
|
69
|
+
return true;
|
|
70
|
+
}
|
|
71
|
+
return false;
|
|
72
|
+
}
|
|
73
|
+
function isAllowedSender(fromAddress, allowedSenders) {
|
|
74
|
+
if (allowedSenders === void 0) return true;
|
|
75
|
+
const norm = extractAddr(fromAddress);
|
|
76
|
+
return allowedSenders.some((s) => extractAddr(s) === norm);
|
|
77
|
+
}
|
|
78
|
+
var ImapClient = class {
|
|
79
|
+
constructor(config) {
|
|
80
|
+
this.config = config;
|
|
81
|
+
}
|
|
82
|
+
config;
|
|
83
|
+
client;
|
|
84
|
+
idleAbort;
|
|
85
|
+
async connect() {
|
|
86
|
+
this.client = new ImapFlow({
|
|
87
|
+
host: this.config.host,
|
|
88
|
+
port: this.config.port,
|
|
89
|
+
secure: this.config.secure,
|
|
90
|
+
auth: this.config.auth,
|
|
91
|
+
logger: false
|
|
92
|
+
});
|
|
93
|
+
await this.client.connect();
|
|
94
|
+
await this.client.mailboxOpen("INBOX");
|
|
95
|
+
}
|
|
96
|
+
supportsIdle() {
|
|
97
|
+
if (this.client === void 0) return false;
|
|
98
|
+
const caps = this.client.capabilities;
|
|
99
|
+
return caps?.has?.("IDLE") ?? false;
|
|
100
|
+
}
|
|
101
|
+
// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: shape-mapping function — imapflow can hand headers as Map OR Buffer depending on protocol path; this is the single normalization site.
|
|
102
|
+
async fetchUnseen() {
|
|
103
|
+
if (this.client === void 0) return [];
|
|
104
|
+
const out = [];
|
|
105
|
+
for await (const raw of this.client.fetch({ seen: false }, {
|
|
106
|
+
uid: true,
|
|
107
|
+
source: true,
|
|
108
|
+
headers: true
|
|
109
|
+
})) {
|
|
110
|
+
const msg = raw;
|
|
111
|
+
const headers = /* @__PURE__ */ new Map();
|
|
112
|
+
const h = msg.headers;
|
|
113
|
+
if (h instanceof Map) {
|
|
114
|
+
for (const [k, v] of h) {
|
|
115
|
+
headers.set(String(k), Array.isArray(v) ? v[0] ?? "" : v);
|
|
116
|
+
}
|
|
117
|
+
} else if (h instanceof Buffer) {
|
|
118
|
+
for (const line of h.toString("utf8").split(/\r?\n/)) {
|
|
119
|
+
const idx = line.indexOf(":");
|
|
120
|
+
if (idx > 0)
|
|
121
|
+
headers.set(line.slice(0, idx).trim().toLowerCase(), line.slice(idx + 1).trim());
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
if (msg.uid !== void 0 && msg.source !== void 0) {
|
|
125
|
+
out.push({
|
|
126
|
+
uid: msg.uid,
|
|
127
|
+
source: msg.source,
|
|
128
|
+
headers
|
|
129
|
+
});
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
return out;
|
|
133
|
+
}
|
|
134
|
+
async startIdle(onExists) {
|
|
135
|
+
if (this.client === void 0) return;
|
|
136
|
+
this.idleAbort = new AbortController();
|
|
137
|
+
const c = this.client;
|
|
138
|
+
c.on("exists", () => {
|
|
139
|
+
onExists();
|
|
140
|
+
});
|
|
141
|
+
void c.idle().catch(() => {
|
|
142
|
+
});
|
|
143
|
+
}
|
|
144
|
+
async stopIdle() {
|
|
145
|
+
if (this.idleAbort !== void 0) {
|
|
146
|
+
this.idleAbort.abort();
|
|
147
|
+
this.idleAbort = void 0;
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
async disconnect() {
|
|
151
|
+
await this.stopIdle();
|
|
152
|
+
if (this.client !== void 0) {
|
|
153
|
+
try {
|
|
154
|
+
await this.client.logout();
|
|
155
|
+
} catch {
|
|
156
|
+
}
|
|
157
|
+
this.client = void 0;
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
};
|
|
161
|
+
var DEFAULT_MAX_BODY = 5e4;
|
|
162
|
+
function stripBraces(id) {
|
|
163
|
+
if (id === void 0 || id.length === 0) return void 0;
|
|
164
|
+
return id.replace(/^<|>$/g, "");
|
|
165
|
+
}
|
|
166
|
+
function normalizeRefs(refs) {
|
|
167
|
+
if (refs === void 0) return void 0;
|
|
168
|
+
const arr = Array.isArray(refs) ? refs : refs.split(/\s+/).filter((s) => s.length > 0);
|
|
169
|
+
const cleaned = arr.map((r) => stripBraces(r)).filter((r) => r !== void 0);
|
|
170
|
+
return cleaned.length > 0 ? cleaned : void 0;
|
|
171
|
+
}
|
|
172
|
+
function addressesFrom(obj) {
|
|
173
|
+
if (obj === void 0) return [];
|
|
174
|
+
if (Array.isArray(obj)) {
|
|
175
|
+
const out = [];
|
|
176
|
+
for (const o of obj) out.push(...o.value ?? []);
|
|
177
|
+
return out;
|
|
178
|
+
}
|
|
179
|
+
return Array.from(obj.value ?? []);
|
|
180
|
+
}
|
|
181
|
+
async function normalizeEmail(rawBuffer, opts) {
|
|
182
|
+
const parsed = await simpleParser(rawBuffer);
|
|
183
|
+
const messageId = stripBraces(parsed.messageId) ?? "unknown";
|
|
184
|
+
const inReplyTo = stripBraces(parsed.inReplyTo);
|
|
185
|
+
const references = normalizeRefs(parsed.references);
|
|
186
|
+
const fromEntries = addressesFrom(parsed.from);
|
|
187
|
+
const fromAddress = (fromEntries[0]?.address ?? "anonymous").toLowerCase().trim();
|
|
188
|
+
const fromName = fromEntries[0]?.name;
|
|
189
|
+
const botAddrLc = opts.botAddress.toLowerCase().trim();
|
|
190
|
+
const recipients = [];
|
|
191
|
+
for (const entry of [
|
|
192
|
+
...addressesFrom(parsed.to),
|
|
193
|
+
...addressesFrom(parsed.cc)
|
|
194
|
+
]) {
|
|
195
|
+
const addr = entry.address?.toLowerCase().trim();
|
|
196
|
+
if (addr !== void 0 && addr.length > 0 && addr !== botAddrLc) {
|
|
197
|
+
recipients.push(addr);
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
const subject = parsed.subject ?? "(no subject)";
|
|
201
|
+
const rawText = parsed.text ?? "";
|
|
202
|
+
const maxChars = opts.maxBodyChars ?? DEFAULT_MAX_BODY;
|
|
203
|
+
const text = rawText.length > maxChars ? `${rawText.slice(0, maxChars)}
|
|
204
|
+
|
|
205
|
+
[truncated \u2014 full body in event.email.raw]` : rawText;
|
|
206
|
+
const receivedAt = parsed.date instanceof Date ? parsed.date.getTime() : Date.now();
|
|
207
|
+
const attachmentCount = Array.isArray(parsed.attachments) ? parsed.attachments.length : 0;
|
|
208
|
+
const emailMeta = {
|
|
209
|
+
messageId,
|
|
210
|
+
...inReplyTo !== void 0 ? { inReplyTo } : {},
|
|
211
|
+
...references !== void 0 ? { references } : {},
|
|
212
|
+
subject,
|
|
213
|
+
fromAddress,
|
|
214
|
+
...fromName !== void 0 ? { fromName } : {},
|
|
215
|
+
recipients,
|
|
216
|
+
attachmentCount,
|
|
217
|
+
raw: parsed
|
|
218
|
+
};
|
|
219
|
+
return {
|
|
220
|
+
id: messageId,
|
|
221
|
+
platform: "email",
|
|
222
|
+
sender: {
|
|
223
|
+
id: fromAddress,
|
|
224
|
+
...fromName !== void 0 ? { displayName: fromName } : {}
|
|
225
|
+
},
|
|
226
|
+
channel: { id: fromAddress, type: "dm", topicId: messageId },
|
|
227
|
+
text,
|
|
228
|
+
receivedAt,
|
|
229
|
+
email: emailMeta
|
|
230
|
+
};
|
|
231
|
+
}
|
|
232
|
+
|
|
233
|
+
// src/seen-uids.ts
|
|
234
|
+
var SeenUidSet = class _SeenUidSet {
|
|
235
|
+
set = /* @__PURE__ */ new Set();
|
|
236
|
+
static MAX_SIZE = 5e3;
|
|
237
|
+
static TRIM_TO = 4e3;
|
|
238
|
+
has(uid) {
|
|
239
|
+
return this.set.has(uid);
|
|
240
|
+
}
|
|
241
|
+
add(uid) {
|
|
242
|
+
if (this.set.size >= _SeenUidSet.MAX_SIZE) this.trim();
|
|
243
|
+
this.set.add(uid);
|
|
244
|
+
}
|
|
245
|
+
trim() {
|
|
246
|
+
const target = _SeenUidSet.TRIM_TO;
|
|
247
|
+
const toDrop = this.set.size - target;
|
|
248
|
+
if (toDrop <= 0) return;
|
|
249
|
+
let i = 0;
|
|
250
|
+
for (const key of this.set) {
|
|
251
|
+
if (i >= toDrop) break;
|
|
252
|
+
this.set.delete(key);
|
|
253
|
+
i++;
|
|
254
|
+
}
|
|
255
|
+
}
|
|
256
|
+
get size() {
|
|
257
|
+
return this.set.size;
|
|
258
|
+
}
|
|
259
|
+
clear() {
|
|
260
|
+
this.set.clear();
|
|
261
|
+
}
|
|
262
|
+
};
|
|
263
|
+
var SmtpClient = class {
|
|
264
|
+
constructor(config) {
|
|
265
|
+
this.config = config;
|
|
266
|
+
}
|
|
267
|
+
config;
|
|
268
|
+
transporter;
|
|
269
|
+
getTransporter() {
|
|
270
|
+
if (this.transporter === void 0) {
|
|
271
|
+
this.transporter = createTransport({
|
|
272
|
+
host: this.config.host,
|
|
273
|
+
port: this.config.port,
|
|
274
|
+
secure: this.config.secure,
|
|
275
|
+
auth: this.config.auth
|
|
276
|
+
});
|
|
277
|
+
}
|
|
278
|
+
return this.transporter;
|
|
279
|
+
}
|
|
280
|
+
async verify() {
|
|
281
|
+
return this.getTransporter().verify();
|
|
282
|
+
}
|
|
283
|
+
async send(opts) {
|
|
284
|
+
const mail = {
|
|
285
|
+
from: opts.from,
|
|
286
|
+
to: opts.to,
|
|
287
|
+
subject: opts.subject,
|
|
288
|
+
text: opts.text
|
|
289
|
+
};
|
|
290
|
+
if (opts.inReplyTo !== void 0) {
|
|
291
|
+
mail.inReplyTo = `<${opts.inReplyTo}>`;
|
|
292
|
+
}
|
|
293
|
+
if (opts.references !== void 0 && opts.references.length > 0) {
|
|
294
|
+
mail.references = opts.references.map((r) => `<${r}>`);
|
|
295
|
+
}
|
|
296
|
+
const info = await this.getTransporter().sendMail(mail);
|
|
297
|
+
const raw = (info.messageId ?? "").replace(/^<|>$/g, "");
|
|
298
|
+
return raw;
|
|
299
|
+
}
|
|
300
|
+
async close() {
|
|
301
|
+
if (this.transporter !== void 0) {
|
|
302
|
+
this.transporter.close();
|
|
303
|
+
this.transporter = void 0;
|
|
304
|
+
}
|
|
305
|
+
}
|
|
306
|
+
};
|
|
307
|
+
|
|
308
|
+
// src/thread-store.ts
|
|
309
|
+
var ThreadStore = class _ThreadStore {
|
|
310
|
+
map = /* @__PURE__ */ new Map();
|
|
311
|
+
static MAX_SIZE = 1e3;
|
|
312
|
+
recordFromInbound(event) {
|
|
313
|
+
const ctx = {
|
|
314
|
+
subject: event.email.subject,
|
|
315
|
+
references: event.email.references ?? [],
|
|
316
|
+
lastMessageId: event.email.messageId
|
|
317
|
+
};
|
|
318
|
+
if (this.map.size >= _ThreadStore.MAX_SIZE && !this.map.has(event.email.messageId)) {
|
|
319
|
+
const firstKey = this.map.keys().next().value;
|
|
320
|
+
if (firstKey !== void 0) this.map.delete(firstKey);
|
|
321
|
+
}
|
|
322
|
+
this.map.delete(event.email.messageId);
|
|
323
|
+
this.map.set(event.email.messageId, ctx);
|
|
324
|
+
}
|
|
325
|
+
lookup(topicId) {
|
|
326
|
+
return this.map.get(topicId);
|
|
327
|
+
}
|
|
328
|
+
get size() {
|
|
329
|
+
return this.map.size;
|
|
330
|
+
}
|
|
331
|
+
clear() {
|
|
332
|
+
this.map.clear();
|
|
333
|
+
}
|
|
334
|
+
};
|
|
335
|
+
|
|
336
|
+
// src/adapter.ts
|
|
337
|
+
var DEFAULT_POLL_INTERVAL_MS = 15e3;
|
|
338
|
+
var EmailAdapter = class extends BasePlatformAdapter {
|
|
339
|
+
platform = "email";
|
|
340
|
+
options;
|
|
341
|
+
seenUids = new SeenUidSet();
|
|
342
|
+
threadStore = new ThreadStore();
|
|
343
|
+
imap;
|
|
344
|
+
smtp;
|
|
345
|
+
handler;
|
|
346
|
+
connected = false;
|
|
347
|
+
// EC-4: serialize concurrent _dispatchInbound calls.
|
|
348
|
+
dispatchQueue = Promise.resolve();
|
|
349
|
+
pollTimer;
|
|
350
|
+
constructor(opts) {
|
|
351
|
+
super();
|
|
352
|
+
for (const k of ["address", "password", "imapHost", "smtpHost"]) {
|
|
353
|
+
const v = opts[k];
|
|
354
|
+
if (typeof v !== "string" || v.length === 0) {
|
|
355
|
+
throw new TypeError(`EmailAdapter: ${k} is required and must be a non-empty string`);
|
|
356
|
+
}
|
|
357
|
+
}
|
|
358
|
+
this.options = opts;
|
|
359
|
+
}
|
|
360
|
+
// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: connect orchestrates factory-vs-real, verify(), connect(), IDLE-vs-poll choice, and rollback-on-throw — a linear single-transaction sequence; splitting hurts the disconnect-on-failure invariant.
|
|
361
|
+
async connect() {
|
|
362
|
+
if (this.connected) return true;
|
|
363
|
+
try {
|
|
364
|
+
const imapFactory = this.options.__imapFactory;
|
|
365
|
+
const smtpFactory = this.options.__smtpFactory;
|
|
366
|
+
this.imap = imapFactory !== void 0 ? imapFactory({
|
|
367
|
+
host: this.options.imapHost,
|
|
368
|
+
port: this.options.imapPort ?? 993,
|
|
369
|
+
secure: true,
|
|
370
|
+
auth: { user: this.options.address, pass: this.options.password }
|
|
371
|
+
}) : new ImapClient({
|
|
372
|
+
host: this.options.imapHost,
|
|
373
|
+
port: this.options.imapPort ?? 993,
|
|
374
|
+
secure: true,
|
|
375
|
+
auth: { user: this.options.address, pass: this.options.password }
|
|
376
|
+
});
|
|
377
|
+
this.smtp = smtpFactory !== void 0 ? smtpFactory({
|
|
378
|
+
host: this.options.smtpHost,
|
|
379
|
+
port: this.options.smtpPort ?? 587,
|
|
380
|
+
secure: (this.options.smtpPort ?? 587) === 465,
|
|
381
|
+
auth: { user: this.options.address, pass: this.options.password }
|
|
382
|
+
}) : new SmtpClient({
|
|
383
|
+
host: this.options.smtpHost,
|
|
384
|
+
port: this.options.smtpPort ?? 587,
|
|
385
|
+
secure: (this.options.smtpPort ?? 587) === 465,
|
|
386
|
+
auth: { user: this.options.address, pass: this.options.password }
|
|
387
|
+
});
|
|
388
|
+
await this.smtp.verify();
|
|
389
|
+
await this.imap.connect();
|
|
390
|
+
if (this.imap.supportsIdle()) {
|
|
391
|
+
await this.imap.startIdle(() => {
|
|
392
|
+
void this._drainUnseen();
|
|
393
|
+
});
|
|
394
|
+
await this._drainUnseen();
|
|
395
|
+
} else {
|
|
396
|
+
await this._drainUnseen();
|
|
397
|
+
const intervalMs = this.options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
|
|
398
|
+
this.pollTimer = setInterval(() => {
|
|
399
|
+
void this._drainUnseen();
|
|
400
|
+
}, intervalMs);
|
|
401
|
+
}
|
|
402
|
+
this.connected = true;
|
|
403
|
+
return true;
|
|
404
|
+
} catch (err) {
|
|
405
|
+
console.error("[email] connect failed:", err instanceof Error ? err.message : err);
|
|
406
|
+
await this.disconnect().catch(() => {
|
|
407
|
+
});
|
|
408
|
+
return false;
|
|
409
|
+
}
|
|
410
|
+
}
|
|
411
|
+
async disconnect() {
|
|
412
|
+
if (this.pollTimer !== void 0) {
|
|
413
|
+
clearInterval(this.pollTimer);
|
|
414
|
+
this.pollTimer = void 0;
|
|
415
|
+
}
|
|
416
|
+
if (this.imap !== void 0) {
|
|
417
|
+
await this.imap.disconnect().catch(() => {
|
|
418
|
+
});
|
|
419
|
+
this.imap = void 0;
|
|
420
|
+
}
|
|
421
|
+
if (this.smtp !== void 0) {
|
|
422
|
+
await this.smtp.close().catch(() => {
|
|
423
|
+
});
|
|
424
|
+
this.smtp = void 0;
|
|
425
|
+
}
|
|
426
|
+
this.connected = false;
|
|
427
|
+
this.handler = void 0;
|
|
428
|
+
this.seenUids.clear();
|
|
429
|
+
this.threadStore.clear();
|
|
430
|
+
}
|
|
431
|
+
// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: send orchestrates input validation + thread-context lookup + Re: prepend + EC-6 references dedup + From: formatting + SMTP-error mapping — each branch is a single-responsibility check; splitting hurts the "one outbound transaction" locality.
|
|
432
|
+
async sendMessage(out) {
|
|
433
|
+
if (out.text.length === 0) {
|
|
434
|
+
return { ok: false, error: { code: "empty_text", message: "Empty text rejected." } };
|
|
435
|
+
}
|
|
436
|
+
if (!this.connected || this.smtp === void 0) {
|
|
437
|
+
return {
|
|
438
|
+
ok: false,
|
|
439
|
+
error: { code: "not_connected", message: "EmailAdapter not connected." }
|
|
440
|
+
};
|
|
441
|
+
}
|
|
442
|
+
const to = out.channel.id;
|
|
443
|
+
const topicId = out.channel.topicId;
|
|
444
|
+
const context = topicId !== void 0 ? this.threadStore.lookup(topicId) : void 0;
|
|
445
|
+
let subject = "Message from agent";
|
|
446
|
+
let inReplyTo;
|
|
447
|
+
let references;
|
|
448
|
+
if (context !== void 0) {
|
|
449
|
+
subject = context.subject.startsWith("Re:") ? context.subject : `Re: ${context.subject}`;
|
|
450
|
+
inReplyTo = context.lastMessageId;
|
|
451
|
+
references = Array.from(/* @__PURE__ */ new Set([...context.references, context.lastMessageId]));
|
|
452
|
+
}
|
|
453
|
+
const from = this.options.fromName !== void 0 ? { name: this.options.fromName, address: this.options.address } : this.options.address;
|
|
454
|
+
try {
|
|
455
|
+
const messageId = await this.smtp.send({
|
|
456
|
+
from,
|
|
457
|
+
to,
|
|
458
|
+
subject,
|
|
459
|
+
text: out.text,
|
|
460
|
+
...inReplyTo !== void 0 ? { inReplyTo } : {},
|
|
461
|
+
...references !== void 0 ? { references } : {}
|
|
462
|
+
});
|
|
463
|
+
return { ok: true, messageId };
|
|
464
|
+
} catch (err) {
|
|
465
|
+
return { ok: false, error: mapEmailError(err) };
|
|
466
|
+
}
|
|
467
|
+
}
|
|
468
|
+
onInbound(handler) {
|
|
469
|
+
this.handler = handler;
|
|
470
|
+
return () => {
|
|
471
|
+
this.handler = void 0;
|
|
472
|
+
};
|
|
473
|
+
}
|
|
474
|
+
/** @internal — drain UNSEEN once and dispatch each. */
|
|
475
|
+
async _drainUnseen() {
|
|
476
|
+
if (this.imap === void 0) return;
|
|
477
|
+
let messages = [];
|
|
478
|
+
try {
|
|
479
|
+
messages = await this.imap.fetchUnseen();
|
|
480
|
+
} catch (err) {
|
|
481
|
+
console.error("[email] fetchUnseen failed:", err instanceof Error ? err.message : err);
|
|
482
|
+
return;
|
|
483
|
+
}
|
|
484
|
+
for (const msg of messages) {
|
|
485
|
+
this._dispatchInbound(msg.uid, msg.source, msg.headers);
|
|
486
|
+
}
|
|
487
|
+
}
|
|
488
|
+
/**
|
|
489
|
+
* EC-4: serialize concurrent IDLE dispatches so seen-check is atomic.
|
|
490
|
+
* Fire-and-forget: never throws; errors logged.
|
|
491
|
+
*/
|
|
492
|
+
_dispatchInbound(uid, rawBuffer, headers) {
|
|
493
|
+
this.dispatchQueue = this.dispatchQueue.then(
|
|
494
|
+
() => this._dispatchInboundInner(uid, rawBuffer, headers).catch(
|
|
495
|
+
(err) => console.error("[email] dispatch error:", err instanceof Error ? err.message : err)
|
|
496
|
+
)
|
|
497
|
+
);
|
|
498
|
+
return this.dispatchQueue;
|
|
499
|
+
}
|
|
500
|
+
async _dispatchInboundInner(uid, rawBuffer, headers) {
|
|
501
|
+
if (this.seenUids.has(uid)) return;
|
|
502
|
+
this.seenUids.add(uid);
|
|
503
|
+
const event = await normalizeEmail(rawBuffer, {
|
|
504
|
+
botAddress: this.options.address,
|
|
505
|
+
...this.options.maxBodyChars !== void 0 ? { maxBodyChars: this.options.maxBodyChars } : {}
|
|
506
|
+
});
|
|
507
|
+
if (event.email.fromAddress === this.options.address.toLowerCase()) {
|
|
508
|
+
console.warn(`[email] dropped own-address loopback (uid=${uid})`);
|
|
509
|
+
return;
|
|
510
|
+
}
|
|
511
|
+
if (this.options.allowAutomated !== true && isAutomatedSender(event.email.fromAddress, headers)) {
|
|
512
|
+
console.warn(`[email] dropped automated sender: ${event.email.fromAddress}`);
|
|
513
|
+
return;
|
|
514
|
+
}
|
|
515
|
+
if (!isAllowedSender(event.email.fromAddress, this.options.allowedSenders)) {
|
|
516
|
+
console.warn(`[email] sender not in allowlist: ${event.email.fromAddress}`);
|
|
517
|
+
return;
|
|
518
|
+
}
|
|
519
|
+
this.threadStore.recordFromInbound(event);
|
|
520
|
+
if (this.handler !== void 0) await this.handler(event);
|
|
521
|
+
}
|
|
522
|
+
/** Test seams. @internal */
|
|
523
|
+
get _seenUidsSize() {
|
|
524
|
+
return this.seenUids.size;
|
|
525
|
+
}
|
|
526
|
+
get _threadStoreSize() {
|
|
527
|
+
return this.threadStore.size;
|
|
528
|
+
}
|
|
529
|
+
/** Test seam — wait for queued dispatches to drain. @internal */
|
|
530
|
+
async _drainDispatchQueue() {
|
|
531
|
+
await this.dispatchQueue;
|
|
532
|
+
}
|
|
533
|
+
/** Test seam — drain IMAP UNSEEN now + flush dispatch queue. @internal */
|
|
534
|
+
async _drainNow() {
|
|
535
|
+
await this._drainUnseen();
|
|
536
|
+
await this.dispatchQueue;
|
|
537
|
+
}
|
|
538
|
+
};
|
|
539
|
+
|
|
540
|
+
export { EmailAdapter, SeenUidSet, ThreadStore, extractAddr, isAllowedSender, isAutomatedSender, mapEmailError, normalizeEmail };
|
|
541
|
+
//# sourceMappingURL=index.js.map
|
|
542
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/errors.ts","../src/filters.ts","../src/imap-client.ts","../src/normalize.ts","../src/seen-uids.ts","../src/smtp-client.ts","../src/thread-store.ts","../src/adapter.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Per-error → canonical `SendResult.error` mapping for email IMAP/SMTP failures.\n *\n * Tolerates plain `Error` without `.code`/`.responseCode` (EC-7 pattern from Teams).\n *\n * @internal\n */\n\n/**\n * Sentinel runtime export — workaround for rollup-plugin-dts deep type-only\n * re-export bug. The marker is INTENTIONALLY orphan: it forces rollup-plugin-dts\n * to keep the module in the bundle so re-exports from `index.ts` resolve.\n *\n * @knipignore\n */\nexport const __errorsMarker: unique symbol = Symbol(\"email-errors\");\n\ninterface ErrorPayload {\n code:\n | \"auth_failed\"\n | \"rate_limit\"\n | \"invalid_request\"\n | \"server_error\"\n | \"not_connected\"\n | \"empty_text\"\n | \"timeout\"\n | \"unknown\";\n message: string;\n}\n\nconst NETWORK_ERR_RE = /ECONN|ENOTFOUND|ETIMEDOUT|EHOSTUNREACH|EAI_AGAIN|fetch failed/i;\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: error-translation ladder is exhaustive — each branch maps one nodemailer/imapflow/SMTP-response class to one typed canonical code; splitting hurts traceability.\nexport function mapEmailError(err: unknown): ErrorPayload {\n if (err === null || err === undefined) {\n return { code: \"unknown\", message: \"Unknown error\" };\n }\n if (typeof err === \"string\") {\n return { code: \"unknown\", message: err };\n }\n const e = err as {\n code?: string;\n responseCode?: number;\n response?: string;\n message?: string;\n name?: string;\n };\n const code = e.code ?? \"\";\n const respCode = typeof e.responseCode === \"number\" ? e.responseCode : undefined;\n const message = typeof e.message === \"string\" && e.message.length > 0 ? e.message : String(err);\n\n // nodemailer error codes\n if (code === \"EAUTH\" || code === \"EAUTHENTICATION\") {\n return { code: \"auth_failed\", message };\n }\n if (code === \"EENVELOPE\" && /550/.test(message)) {\n return { code: \"invalid_request\", message };\n }\n if (code === \"ECONNECTION\" || code === \"ESOCKET\" || code === \"ETLS\") {\n return { code: \"server_error\", message };\n }\n if (code === \"ETIMEDOUT\") {\n return { code: \"timeout\", message };\n }\n // SMTP response codes\n if (respCode !== undefined) {\n if (respCode === 535 || respCode === 530) return { code: \"auth_failed\", message };\n if (respCode === 421 || respCode === 451 || respCode === 452)\n return { code: \"rate_limit\", message };\n if (respCode === 550 || respCode === 551 || respCode === 553)\n return { code: \"invalid_request\", message };\n if (respCode >= 500) return { code: \"server_error\", message };\n if (respCode >= 400) return { code: \"rate_limit\", message };\n }\n // imapflow throws Error with .authenticationFailed flag in some versions\n if (e.name === \"IMAP_AUTH_FAILED\" || /auth/i.test(message)) {\n return { code: \"auth_failed\", message };\n }\n // EC-7: plain Error fallback\n if (NETWORK_ERR_RE.test(message)) return { code: \"server_error\", message };\n return { code: \"unknown\", message };\n}\n","/**\n * Inbound filters: automated-sender (D332) + allowed-sender allowlist (D333 + EC-3).\n *\n * @internal\n */\n\n/**\n * Sentinel runtime export — workaround for rollup-plugin-dts deep type-only\n * re-export bug. The marker is INTENTIONALLY orphan: it forces rollup-plugin-dts\n * to keep the module in the bundle so re-exports from `index.ts` resolve.\n *\n * @knipignore\n */\nexport const __filtersMarker: unique symbol = Symbol(\"email-filters\");\n\nconst NOREPLY_RE =\n /^(noreply|no-reply|no_reply|donotreply|do-not-reply|mailer-daemon|postmaster|bounce|notifications)@/i;\n\n/**\n * EC-3: extract pure email address from a string that may include display\n * name + brackets (`\"Alice\" <alice@example.com>`). Normalizes to lowercase.\n */\nexport function extractAddr(s: string): string {\n const m = s.match(/<([^>]+)>/);\n return (m?.[1] ?? s).toLowerCase().trim();\n}\n\n/**\n * D332: automated-sender filter. Returns `true` if the message should be\n * DROPPED (sender is automated / bot-loop risk).\n */\nexport function isAutomatedSender(fromAddress: string, headers: Map<string, string>): boolean {\n if (NOREPLY_RE.test(fromAddress)) return true;\n // Normalize header keys to lowercase for lookup.\n const lowered = new Map<string, string>();\n for (const [k, v] of headers) lowered.set(k.toLowerCase(), v);\n // RFC 3834: Auto-Submitted\n const autoSubmitted = lowered.get(\"auto-submitted\");\n if (typeof autoSubmitted === \"string\" && /auto-generated|auto-replied/i.test(autoSubmitted)) {\n return true;\n }\n // Legacy Precedence header\n const precedence = lowered.get(\"precedence\");\n if (typeof precedence === \"string\" && /bulk|list/i.test(precedence)) {\n return true;\n }\n // Microsoft X-Auto-Response-Suppress\n const xAuto = lowered.get(\"x-auto-response-suppress\");\n if (typeof xAuto === \"string\" && /all/i.test(xAuto)) {\n return true;\n }\n return false;\n}\n\n/**\n * D333 + EC-3: allowed-sender allowlist.\n *\n * - `undefined` allowlist → OPEN (all allowed).\n * - Empty array → CLOSED (none allowed). Intentional distinction from undefined.\n * - Both sides normalized via `extractAddr` so `\"Alice <alice@x>\"` matches `alice@x`.\n */\nexport function isAllowedSender(fromAddress: string, allowedSenders?: readonly string[]): boolean {\n if (allowedSenders === undefined) return true;\n const norm = extractAddr(fromAddress);\n return allowedSenders.some((s) => extractAddr(s) === norm);\n}\n","/**\n * IMAP client wrapper around `imapflow`. Supports IDLE + polling fallback.\n *\n * @internal\n */\n\nimport { type FetchMessageObject, ImapFlow } from \"imapflow\";\n\n/**\n * Sentinel runtime export — workaround for rollup-plugin-dts deep type-only\n * re-export bug. The marker is INTENTIONALLY orphan: it forces rollup-plugin-dts\n * to keep the module in the bundle so re-exports from `index.ts` resolve.\n *\n * @knipignore\n */\nexport const __imapMarker: unique symbol = Symbol(\"imap\");\n\ninterface ImapClientConfig {\n readonly host: string;\n readonly port: number;\n readonly secure: boolean;\n readonly auth: { user: string; pass: string };\n}\n\nexport interface FetchedMessage {\n readonly uid: number;\n readonly source: Buffer;\n readonly headers: Map<string, string>;\n}\n\nexport interface IImapClient {\n connect(): Promise<void>;\n disconnect(): Promise<void>;\n /** Capability check — does the server advertise IDLE? */\n supportsIdle(): boolean;\n /** Fetch all UNSEEN messages once. Used for poll + post-IDLE-event drain. */\n fetchUnseen(): Promise<FetchedMessage[]>;\n /** Start IDLE; invoke `onExists` whenever the server pushes a new-message notification. */\n startIdle(onExists: () => void): Promise<void>;\n /** Stop IDLE if running. */\n stopIdle(): Promise<void>;\n}\n\nexport class ImapClient implements IImapClient {\n private client: ImapFlow | undefined;\n private idleAbort: AbortController | undefined;\n\n constructor(private readonly config: ImapClientConfig) {}\n\n async connect(): Promise<void> {\n this.client = new ImapFlow({\n host: this.config.host,\n port: this.config.port,\n secure: this.config.secure,\n auth: this.config.auth,\n logger: false,\n });\n await this.client.connect();\n await this.client.mailboxOpen(\"INBOX\");\n }\n\n supportsIdle(): boolean {\n if (this.client === undefined) return false;\n const caps = (this.client as unknown as { capabilities?: { has?: (s: string) => boolean } })\n .capabilities;\n return caps?.has?.(\"IDLE\") ?? false;\n }\n\n // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: shape-mapping function — imapflow can hand headers as Map OR Buffer depending on protocol path; this is the single normalization site.\n async fetchUnseen(): Promise<FetchedMessage[]> {\n if (this.client === undefined) return [];\n const out: FetchedMessage[] = [];\n for await (const raw of this.client.fetch({ seen: false }, {\n uid: true,\n source: true,\n headers: true,\n } as Parameters<ImapFlow[\"fetch\"]>[1])) {\n const msg = raw as FetchMessageObject;\n const headers = new Map<string, string>();\n // headers is a Buffer/Map in imapflow; handle both shapes safely.\n const h = (msg as unknown as { headers?: unknown }).headers;\n if (h instanceof Map) {\n for (const [k, v] of h as Map<string, string | string[]>) {\n headers.set(String(k), Array.isArray(v) ? (v[0] ?? \"\") : v);\n }\n } else if (h instanceof Buffer) {\n for (const line of h.toString(\"utf8\").split(/\\r?\\n/)) {\n const idx = line.indexOf(\":\");\n if (idx > 0)\n headers.set(line.slice(0, idx).trim().toLowerCase(), line.slice(idx + 1).trim());\n }\n }\n if (msg.uid !== undefined && msg.source !== undefined) {\n out.push({\n uid: msg.uid,\n source: msg.source as Buffer,\n headers,\n });\n }\n }\n return out;\n }\n\n async startIdle(onExists: () => void): Promise<void> {\n if (this.client === undefined) return;\n this.idleAbort = new AbortController();\n const c = this.client;\n // imapflow's `c.idle()` resolves when IDLE ends. The `mailbox.on(\"exists\")`\n // event fires inside IDLE. We register the listener once and let imapflow\n // refresh IDLE internally per RFC 2177.\n c.on(\"exists\", () => {\n onExists();\n });\n void c.idle().catch(() => {\n /* idle aborted */\n });\n }\n\n async stopIdle(): Promise<void> {\n if (this.idleAbort !== undefined) {\n this.idleAbort.abort();\n this.idleAbort = undefined;\n }\n }\n\n async disconnect(): Promise<void> {\n await this.stopIdle();\n if (this.client !== undefined) {\n try {\n await this.client.logout();\n } catch {\n /* ignore */\n }\n this.client = undefined;\n }\n }\n}\n","/**\n * Inbound `raw RFC 5322 bytes` → `EmailMessageEvent`.\n *\n * EC-2 absorbed: body capped at `maxBodyChars` (default 50000).\n * EC-5 absorbed: subject fallback to `\"(no subject)\"`.\n *\n * @internal\n */\n\nimport type { EmailMessageEvent } from \"@theokit/gateway\";\nimport { simpleParser } from \"mailparser\";\n\n/**\n * Sentinel runtime export — workaround for rollup-plugin-dts deep type-only\n * re-export bug. The marker is INTENTIONALLY orphan: it forces rollup-plugin-dts\n * to keep the module in the bundle so re-exports from `index.ts` resolve.\n *\n * @knipignore\n */\nexport const __normalizeMarker: unique symbol = Symbol(\"email-normalize\");\n\nexport interface NormalizeOptions {\n readonly botAddress: string;\n /** EC-2: cap body length. Default 50000. */\n readonly maxBodyChars?: number;\n}\n\nconst DEFAULT_MAX_BODY = 50_000;\n\nfunction stripBraces(id: string | undefined): string | undefined {\n if (id === undefined || id.length === 0) return undefined;\n return id.replace(/^<|>$/g, \"\");\n}\n\nfunction normalizeRefs(refs: string | string[] | undefined): readonly string[] | undefined {\n if (refs === undefined) return undefined;\n const arr = Array.isArray(refs) ? refs : refs.split(/\\s+/).filter((s) => s.length > 0);\n const cleaned = arr.map((r) => stripBraces(r)).filter((r): r is string => r !== undefined);\n return cleaned.length > 0 ? cleaned : undefined;\n}\n\ninterface AddressEntry {\n readonly address?: string;\n readonly name?: string;\n}\n\ninterface AddressObject {\n readonly value?: ReadonlyArray<AddressEntry>;\n}\n\nfunction addressesFrom(\n obj: AddressObject | ReadonlyArray<AddressObject> | undefined,\n): AddressEntry[] {\n if (obj === undefined) return [];\n if (Array.isArray(obj)) {\n const out: AddressEntry[] = [];\n for (const o of obj) out.push(...(o.value ?? []));\n return out;\n }\n return Array.from((obj as AddressObject).value ?? []);\n}\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: shape-mapping function — each branch is a small conditional spread for an optional RFC 5322 field; splitting hurts the \"one event normalization here\" locality.\nexport async function normalizeEmail(\n rawBuffer: Buffer | string,\n opts: NormalizeOptions,\n): Promise<EmailMessageEvent> {\n const parsed = await simpleParser(rawBuffer);\n\n const messageId = stripBraces(parsed.messageId) ?? \"unknown\";\n const inReplyTo = stripBraces(parsed.inReplyTo);\n const references = normalizeRefs(parsed.references as string | string[] | undefined);\n\n const fromEntries = addressesFrom(parsed.from as AddressObject | undefined);\n const fromAddress = (fromEntries[0]?.address ?? \"anonymous\").toLowerCase().trim();\n const fromName = fromEntries[0]?.name;\n\n const botAddrLc = opts.botAddress.toLowerCase().trim();\n const recipients: string[] = [];\n for (const entry of [\n ...addressesFrom(parsed.to as AddressObject | ReadonlyArray<AddressObject> | undefined),\n ...addressesFrom(parsed.cc as AddressObject | ReadonlyArray<AddressObject> | undefined),\n ]) {\n const addr = entry.address?.toLowerCase().trim();\n if (addr !== undefined && addr.length > 0 && addr !== botAddrLc) {\n recipients.push(addr);\n }\n }\n\n // EC-5: subject fallback.\n const subject = parsed.subject ?? \"(no subject)\";\n\n // EC-2: cap body.\n const rawText = parsed.text ?? \"\";\n const maxChars = opts.maxBodyChars ?? DEFAULT_MAX_BODY;\n const text =\n rawText.length > maxChars\n ? `${rawText.slice(0, maxChars)}\\n\\n[truncated — full body in event.email.raw]`\n : rawText;\n\n const receivedAt = parsed.date instanceof Date ? parsed.date.getTime() : Date.now();\n const attachmentCount = Array.isArray(parsed.attachments) ? parsed.attachments.length : 0;\n\n const emailMeta: EmailMessageEvent[\"email\"] = {\n messageId,\n ...(inReplyTo !== undefined ? { inReplyTo } : {}),\n ...(references !== undefined ? { references } : {}),\n subject,\n fromAddress,\n ...(fromName !== undefined ? { fromName } : {}),\n recipients,\n attachmentCount,\n raw: parsed,\n };\n\n return {\n id: messageId,\n platform: \"email\",\n sender: {\n id: fromAddress,\n ...(fromName !== undefined ? { displayName: fromName } : {}),\n },\n channel: { id: fromAddress, type: \"dm\", topicId: messageId },\n text,\n receivedAt,\n email: emailMeta,\n };\n}\n","/**\n * Bounded `Set<number>` of dispatched IMAP UIDs (ADR D331).\n *\n * Caps at 5000 entries; trims to 4000 (drops oldest 1000) on overflow.\n * Same pattern as the Teams ConversationReferenceStore / WhatsApp Web bridge\n * — bounded memory in long-running bots.\n *\n * @internal\n */\n\n/**\n * Sentinel runtime export — workaround for rollup-plugin-dts deep type-only\n * re-export bug. The marker is INTENTIONALLY orphan: it forces rollup-plugin-dts\n * to keep the module in the bundle so re-exports from `index.ts` resolve.\n *\n * @knipignore\n */\nexport const __seenUidsMarker: unique symbol = Symbol(\"seen-uids\");\n\nexport class SeenUidSet {\n private set = new Set<number>();\n static readonly MAX_SIZE = 5000;\n static readonly TRIM_TO = 4000;\n\n has(uid: number): boolean {\n return this.set.has(uid);\n }\n\n add(uid: number): void {\n if (this.set.size >= SeenUidSet.MAX_SIZE) this.trim();\n this.set.add(uid);\n }\n\n private trim(): void {\n // Set iteration is insertion-ordered in JS. Drop oldest until at TRIM_TO.\n const target = SeenUidSet.TRIM_TO;\n const toDrop = this.set.size - target;\n if (toDrop <= 0) return;\n let i = 0;\n for (const key of this.set) {\n if (i >= toDrop) break;\n this.set.delete(key);\n i++;\n }\n }\n\n get size(): number {\n return this.set.size;\n }\n\n clear(): void {\n this.set.clear();\n }\n}\n","/**\n * SMTP client wrapper around `nodemailer`. Thin shim; tests inject a fake.\n *\n * @internal\n */\n\nimport { createTransport, type SendMailOptions, type Transporter } from \"nodemailer\";\n\n/**\n * Sentinel runtime export — workaround for rollup-plugin-dts deep type-only\n * re-export bug. The marker is INTENTIONALLY orphan: it forces rollup-plugin-dts\n * to keep the module in the bundle so re-exports from `index.ts` resolve.\n *\n * @knipignore\n */\nexport const __smtpMarker: unique symbol = Symbol(\"smtp\");\n\ninterface SmtpClientConfig {\n readonly host: string;\n readonly port: number;\n readonly secure: boolean;\n readonly auth: { user: string; pass: string };\n}\n\nexport interface SmtpSendOptions {\n readonly from: string | { name: string; address: string };\n readonly to: string;\n readonly subject: string;\n readonly text: string;\n /** Message-ID (without `<>`) we're replying to. */\n readonly inReplyTo?: string;\n /** References chain (without `<>`). Will be serialized with braces. */\n readonly references?: readonly string[];\n}\n\nexport interface ISmtpClient {\n verify(): Promise<true>;\n send(opts: SmtpSendOptions): Promise<string>;\n close(): Promise<void>;\n}\n\nexport class SmtpClient implements ISmtpClient {\n private transporter: Transporter | undefined;\n\n constructor(private readonly config: SmtpClientConfig) {}\n\n private getTransporter(): Transporter {\n if (this.transporter === undefined) {\n this.transporter = createTransport({\n host: this.config.host,\n port: this.config.port,\n secure: this.config.secure,\n auth: this.config.auth,\n });\n }\n return this.transporter;\n }\n\n async verify(): Promise<true> {\n return this.getTransporter().verify();\n }\n\n async send(opts: SmtpSendOptions): Promise<string> {\n const mail: SendMailOptions = {\n from: opts.from,\n to: opts.to,\n subject: opts.subject,\n text: opts.text,\n };\n if (opts.inReplyTo !== undefined) {\n mail.inReplyTo = `<${opts.inReplyTo}>`;\n }\n if (opts.references !== undefined && opts.references.length > 0) {\n mail.references = opts.references.map((r) => `<${r}>`);\n }\n const info = await this.getTransporter().sendMail(mail);\n // Strip `<>` from new Message-ID for consistency with inbound.\n const raw = (info.messageId ?? \"\").replace(/^<|>$/g, \"\");\n return raw;\n }\n\n async close(): Promise<void> {\n if (this.transporter !== undefined) {\n this.transporter.close();\n this.transporter = undefined;\n }\n }\n}\n","/**\n * Thread context store (ADR D337). Records `{subject, references, lastMessageId}`\n * per inbound `Message-ID`; consumed on outbound to reconstruct threading headers.\n *\n * Capped at 1000 entries with FIFO eviction (matches WhatsApp / Teams pattern).\n *\n * @internal\n */\n\nimport type { EmailMessageEvent } from \"@theokit/gateway\";\n\n/**\n * Sentinel runtime export — workaround for rollup-plugin-dts deep type-only\n * re-export bug. The marker is INTENTIONALLY orphan: it forces rollup-plugin-dts\n * to keep the module in the bundle so re-exports from `index.ts` resolve.\n *\n * @knipignore\n */\nexport const __threadStoreMarker: unique symbol = Symbol(\"thread-store\");\n\nexport interface ThreadContext {\n readonly subject: string;\n readonly references: readonly string[];\n readonly lastMessageId: string;\n}\n\nexport class ThreadStore {\n private readonly map = new Map<string, ThreadContext>();\n static readonly MAX_SIZE = 1000;\n\n recordFromInbound(event: EmailMessageEvent): void {\n const ctx: ThreadContext = {\n subject: event.email.subject,\n references: event.email.references ?? [],\n lastMessageId: event.email.messageId,\n };\n // FIFO eviction.\n if (this.map.size >= ThreadStore.MAX_SIZE && !this.map.has(event.email.messageId)) {\n const firstKey = this.map.keys().next().value;\n if (firstKey !== undefined) this.map.delete(firstKey);\n }\n this.map.delete(event.email.messageId);\n this.map.set(event.email.messageId, ctx);\n }\n\n lookup(topicId: string): ThreadContext | undefined {\n return this.map.get(topicId);\n }\n\n get size(): number {\n return this.map.size;\n }\n\n clear(): void {\n this.map.clear();\n }\n}\n","/**\n * `EmailAdapter` — Email platform adapter for `@theokit/gateway`\n * (Adoption Roadmap v1.4 #4; ADRs D327-D339).\n *\n * Stack: nodemailer (SMTP) + imapflow (IMAP IDLE) + mailparser (RFC 5322).\n * Inbound: IMAP IDLE preferred (D328), 15s poll fallback.\n * Outbound: SMTP via nodemailer + threading reciprocity (D337).\n *\n * @public\n */\n\nimport {\n BasePlatformAdapter,\n type MessageEvent as GatewayMessageEvent,\n type OutboundMessage,\n type SendResult,\n} from \"@theokit/gateway\";\n\nimport { mapEmailError } from \"./errors.js\";\nimport { isAllowedSender, isAutomatedSender } from \"./filters.js\";\nimport { type FetchedMessage, type IImapClient, ImapClient } from \"./imap-client.js\";\nimport { normalizeEmail } from \"./normalize.js\";\nimport { SeenUidSet } from \"./seen-uids.js\";\nimport { type ISmtpClient, SmtpClient } from \"./smtp-client.js\";\nimport { ThreadStore } from \"./thread-store.js\";\nimport type { EmailAdapterOptions } from \"./types.js\";\n\nconst DEFAULT_POLL_INTERVAL_MS = 15_000;\n\nexport class EmailAdapter extends BasePlatformAdapter {\n readonly platform = \"email\" as const;\n private readonly options: EmailAdapterOptions;\n private readonly seenUids = new SeenUidSet();\n private readonly threadStore = new ThreadStore();\n private imap: IImapClient | undefined;\n private smtp: ISmtpClient | undefined;\n private handler?: (event: GatewayMessageEvent) => Promise<void>;\n private connected = false;\n // EC-4: serialize concurrent _dispatchInbound calls.\n private dispatchQueue: Promise<void> = Promise.resolve();\n private pollTimer: NodeJS.Timeout | undefined;\n\n constructor(opts: EmailAdapterOptions) {\n super();\n // EC-1 pattern (from Teams): validate non-empty at construction (fail fast).\n for (const k of [\"address\", \"password\", \"imapHost\", \"smtpHost\"] as const) {\n const v = opts[k];\n if (typeof v !== \"string\" || v.length === 0) {\n throw new TypeError(`EmailAdapter: ${k} is required and must be a non-empty string`);\n }\n }\n this.options = opts;\n }\n\n // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: connect orchestrates factory-vs-real, verify(), connect(), IDLE-vs-poll choice, and rollback-on-throw — a linear single-transaction sequence; splitting hurts the disconnect-on-failure invariant.\n async connect(): Promise<boolean> {\n if (this.connected) return true;\n try {\n // Construct clients (test seams allow injection).\n const imapFactory = this.options.__imapFactory as ((cfg: unknown) => IImapClient) | undefined;\n const smtpFactory = this.options.__smtpFactory as ((cfg: unknown) => ISmtpClient) | undefined;\n this.imap =\n imapFactory !== undefined\n ? imapFactory({\n host: this.options.imapHost,\n port: this.options.imapPort ?? 993,\n secure: true,\n auth: { user: this.options.address, pass: this.options.password },\n })\n : new ImapClient({\n host: this.options.imapHost,\n port: this.options.imapPort ?? 993,\n secure: true,\n auth: { user: this.options.address, pass: this.options.password },\n });\n this.smtp =\n smtpFactory !== undefined\n ? smtpFactory({\n host: this.options.smtpHost,\n port: this.options.smtpPort ?? 587,\n secure: (this.options.smtpPort ?? 587) === 465,\n auth: { user: this.options.address, pass: this.options.password },\n })\n : new SmtpClient({\n host: this.options.smtpHost,\n port: this.options.smtpPort ?? 587,\n secure: (this.options.smtpPort ?? 587) === 465,\n auth: { user: this.options.address, pass: this.options.password },\n });\n await this.smtp.verify();\n await this.imap.connect();\n\n // Start inbound dispatch loop — IDLE if supported, poll otherwise.\n if (this.imap.supportsIdle()) {\n await this.imap.startIdle(() => {\n void this._drainUnseen();\n });\n // Drain anything already UNSEEN before IDLE started.\n await this._drainUnseen();\n } else {\n // Polling fallback.\n await this._drainUnseen();\n const intervalMs = this.options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;\n this.pollTimer = setInterval(() => {\n void this._drainUnseen();\n }, intervalMs);\n }\n\n this.connected = true;\n return true;\n } catch (err) {\n console.error(\"[email] connect failed:\", err instanceof Error ? err.message : err);\n await this.disconnect().catch(() => {});\n return false;\n }\n }\n\n async disconnect(): Promise<void> {\n if (this.pollTimer !== undefined) {\n clearInterval(this.pollTimer);\n this.pollTimer = undefined;\n }\n if (this.imap !== undefined) {\n await this.imap.disconnect().catch(() => {});\n this.imap = undefined;\n }\n if (this.smtp !== undefined) {\n await this.smtp.close().catch(() => {});\n this.smtp = undefined;\n }\n this.connected = false;\n this.handler = undefined;\n this.seenUids.clear();\n this.threadStore.clear();\n }\n\n // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: send orchestrates input validation + thread-context lookup + Re: prepend + EC-6 references dedup + From: formatting + SMTP-error mapping — each branch is a single-responsibility check; splitting hurts the \"one outbound transaction\" locality.\n async sendMessage(out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"Empty text rejected.\" } };\n }\n if (!this.connected || this.smtp === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"EmailAdapter not connected.\" },\n };\n }\n const to = out.channel.id;\n const topicId = out.channel.topicId;\n const context = topicId !== undefined ? this.threadStore.lookup(topicId) : undefined;\n\n let subject = \"Message from agent\";\n let inReplyTo: string | undefined;\n let references: readonly string[] | undefined;\n if (context !== undefined) {\n subject = context.subject.startsWith(\"Re:\") ? context.subject : `Re: ${context.subject}`;\n inReplyTo = context.lastMessageId;\n // EC-6: dedup the chain.\n references = Array.from(new Set([...context.references, context.lastMessageId]));\n }\n\n const from =\n this.options.fromName !== undefined\n ? { name: this.options.fromName, address: this.options.address }\n : this.options.address;\n try {\n const messageId = await this.smtp.send({\n from,\n to,\n subject,\n text: out.text,\n ...(inReplyTo !== undefined ? { inReplyTo } : {}),\n ...(references !== undefined ? { references } : {}),\n });\n return { ok: true, messageId };\n } catch (err) {\n return { ok: false, error: mapEmailError(err) };\n }\n }\n\n onInbound(handler: (event: GatewayMessageEvent) => Promise<void>): () => void {\n // EC-H: replace any previous subscription.\n this.handler = handler;\n return () => {\n this.handler = undefined;\n };\n }\n\n /** @internal — drain UNSEEN once and dispatch each. */\n private async _drainUnseen(): Promise<void> {\n if (this.imap === undefined) return;\n let messages: FetchedMessage[] = [];\n try {\n messages = await this.imap.fetchUnseen();\n } catch (err) {\n console.error(\"[email] fetchUnseen failed:\", err instanceof Error ? err.message : err);\n return;\n }\n for (const msg of messages) {\n this._dispatchInbound(msg.uid, msg.source, msg.headers);\n }\n }\n\n /**\n * EC-4: serialize concurrent IDLE dispatches so seen-check is atomic.\n * Fire-and-forget: never throws; errors logged.\n */\n private _dispatchInbound(\n uid: number,\n rawBuffer: Buffer,\n headers: Map<string, string>,\n ): Promise<void> {\n this.dispatchQueue = this.dispatchQueue.then(() =>\n this._dispatchInboundInner(uid, rawBuffer, headers).catch((err) =>\n console.error(\"[email] dispatch error:\", err instanceof Error ? err.message : err),\n ),\n );\n return this.dispatchQueue;\n }\n\n private async _dispatchInboundInner(\n uid: number,\n rawBuffer: Buffer,\n headers: Map<string, string>,\n ): Promise<void> {\n if (this.seenUids.has(uid)) return;\n this.seenUids.add(uid);\n\n const event = await normalizeEmail(rawBuffer, {\n botAddress: this.options.address,\n ...(this.options.maxBodyChars !== undefined\n ? { maxBodyChars: this.options.maxBodyChars }\n : {}),\n });\n\n // EC-1 (CRITICAL): drop own-address loopback BEFORE anything else.\n if (event.email.fromAddress === this.options.address.toLowerCase()) {\n console.warn(`[email] dropped own-address loopback (uid=${uid})`);\n return;\n }\n // D332: drop automated senders unless explicitly allowed.\n if (\n this.options.allowAutomated !== true &&\n isAutomatedSender(event.email.fromAddress, headers)\n ) {\n console.warn(`[email] dropped automated sender: ${event.email.fromAddress}`);\n return;\n }\n // D333 + EC-3: enforce allowlist (both sides normalized via extractAddr).\n if (!isAllowedSender(event.email.fromAddress, this.options.allowedSenders)) {\n console.warn(`[email] sender not in allowlist: ${event.email.fromAddress}`);\n return;\n }\n // Record thread context for outbound reciprocity.\n this.threadStore.recordFromInbound(event);\n\n if (this.handler !== undefined) await this.handler(event);\n }\n\n /** Test seams. @internal */\n get _seenUidsSize(): number {\n return this.seenUids.size;\n }\n get _threadStoreSize(): number {\n return this.threadStore.size;\n }\n /** Test seam — wait for queued dispatches to drain. @internal */\n async _drainDispatchQueue(): Promise<void> {\n await this.dispatchQueue;\n }\n /** Test seam — drain IMAP UNSEEN now + flush dispatch queue. @internal */\n async _drainNow(): Promise<void> {\n await this._drainUnseen();\n await this.dispatchQueue;\n }\n}\n"]}
|