@miguelarios/email-mcp 0.14.0 → 0.16.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.
@@ -0,0 +1,112 @@
1
+ /**
2
+ * Native IMAP SORT (RFC 5256).
3
+ *
4
+ * A server that advertises SORT will order a result set itself, which is both
5
+ * faster and more correct than fetching envelopes to sort them here: the whole
6
+ * mailbox is ordered, not just the page, so pagination is exact rather than
7
+ * approximate on a large folder.
8
+ *
9
+ * imapflow has no SORT command — its public surface stops at `search()` — so
10
+ * this drives `exec` and the search compiler directly. Both are internal to
11
+ * imapflow, which is why every entry point here fails soft: a server that
12
+ * rejects the command, a client version that moved the compiler, or anything
13
+ * else unexpected returns `null` and leaves the caller on its existing
14
+ * client-side path.
15
+ */
16
+ import { createRequire } from "node:module";
17
+ const require = createRequire(import.meta.url);
18
+ /** RFC 5256 §3 sort keys, for the fields `search_emails` exposes. */
19
+ const SORT_KEYS = {
20
+ date: "DATE",
21
+ from: "FROM",
22
+ subject: "SUBJECT",
23
+ };
24
+ /**
25
+ * RFC 5256 makes the charset mandatory on SORT, so one is always sent. UTF-8
26
+ * is the only charset imapflow's compiler ever asks for, and a server that
27
+ * accepts only US-ASCII answers BADCHARSET — which lands in the catch below
28
+ * and sends the caller back to client-side sorting rather than failing.
29
+ */
30
+ const DEFAULT_CHARSET = "UTF-8";
31
+ /**
32
+ * The compiled search key, plus the charset it has to be issued under.
33
+ *
34
+ * imapflow's compiler prepends a `CHARSET UTF-8` pair whenever a criteria
35
+ * value contains non-ASCII and the connection has not enabled `UTF8=ACCEPT`,
36
+ * because that is how RFC 3501 SEARCH takes a charset. SORT does not: RFC 5256
37
+ * gives the charset its own slot between the sort keys and the search key, so
38
+ * leaving the pair in place would emit
39
+ * `UID SORT (REVERSE DATE) UTF-8 CHARSET UTF-8 SUBJECT "café"` — a syntax
40
+ * error the server answers BAD. The pair is lifted out and its value used for
41
+ * the slot instead, which is what makes an accented filter reach SORT at all.
42
+ */
43
+ function compileSearchKey(client, criteria) {
44
+ const { searchCompiler: compile } = require("imapflow/lib/search-compiler.js");
45
+ const keys = criteria && typeof criteria === "object" ? Object.keys(criteria) : [];
46
+ // Mirrors imapflow's own search(): an empty query is "everything", which in
47
+ // IMAP is the ALL key rather than an empty criteria list.
48
+ if (keys.length === 0 || (keys.length === 1 && keys[0] === "all")) {
49
+ return { charset: DEFAULT_CHARSET, attributes: [{ type: "ATOM", value: "ALL" }] };
50
+ }
51
+ const attributes = compile(client, criteria);
52
+ if (attributes[0]?.type === "ATOM" &&
53
+ String(attributes[0].value).toUpperCase() === "CHARSET" &&
54
+ attributes[1] !== undefined) {
55
+ return { charset: String(attributes[1].value), attributes: attributes.slice(2) };
56
+ }
57
+ return { charset: DEFAULT_CHARSET, attributes };
58
+ }
59
+ /** True when the connected server advertises RFC 5256 SORT. */
60
+ export function supportsSort(client) {
61
+ try {
62
+ return client.capabilities?.has("SORT") === true;
63
+ }
64
+ catch {
65
+ return false;
66
+ }
67
+ }
68
+ /**
69
+ * Issues `UID SORT` for one search criteria object, returning UIDs in the
70
+ * server's order, or `null` when the command could not be used.
71
+ */
72
+ export async function uidSort(client, criteria, sortBy, sortOrder) {
73
+ if (!supportsSort(client))
74
+ return null;
75
+ const key = SORT_KEYS[sortBy];
76
+ if (!key)
77
+ return null;
78
+ // RFC 5256: REVERSE prefixes an individual key, it is not a global flag.
79
+ const sortKeys = sortOrder === "desc"
80
+ ? [
81
+ { type: "ATOM", value: "REVERSE" },
82
+ { type: "ATOM", value: key },
83
+ ]
84
+ : [{ type: "ATOM", value: key }];
85
+ try {
86
+ const { charset, attributes: searchAttributes } = compileSearchKey(client, criteria);
87
+ const uids = [];
88
+ const response = await client.exec("UID SORT", [sortKeys, { type: "ATOM", value: charset }, ...searchAttributes], {
89
+ untagged: {
90
+ SORT: async (untagged) => {
91
+ for (const attribute of untagged?.attributes ?? []) {
92
+ // Only digit strings. CONDSTORE can append a (MODSEQ n) group, and
93
+ // `Number("")` is 0, so neither a keyword nor an empty attribute
94
+ // may be allowed to become a UID.
95
+ const raw = attribute?.value;
96
+ if (typeof raw !== "string" || !/^\d+$/.test(raw))
97
+ continue;
98
+ uids.push(Number(raw));
99
+ }
100
+ },
101
+ },
102
+ });
103
+ // imapflow's own commands call this to release the response; skipping it
104
+ // would leave the connection waiting on a reader that never runs.
105
+ response?.next?.();
106
+ return uids;
107
+ }
108
+ catch {
109
+ return null;
110
+ }
111
+ }
112
+ //# sourceMappingURL=imapSort.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"imapSort.js","sourceRoot":"","sources":["../src/imapSort.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,qEAAqE;AACrE,MAAM,SAAS,GAAG;IAChB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;CACV,CAAC;AAMX;;;;;GAKG;AACH,MAAM,eAAe,GAAG,OAAO,CAAC;AAEhC;;;;;;;;;;;GAWG;AACH,SAAS,gBAAgB,CACvB,MAAgB,EAChB,QAAiB;IAEjB,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iCAAiC,CAE5E,CAAC;IACF,MAAM,IAAI,GAAG,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,4EAA4E;IAC5E,0DAA0D;IAC1D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IACpF,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7C,IACE,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,MAAM;QAC9B,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,KAAK,SAAS;QACvD,UAAU,CAAC,CAAC,CAAC,KAAK,SAAS,EAC3B,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC;AAClD,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,YAAY,CAAC,MAAgB;IAC3C,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAgB,EAChB,QAAiB,EACjB,MAAiB,EACjB,SAAyB;IAEzB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,yEAAyE;IACzE,MAAM,QAAQ,GACZ,SAAS,KAAK,MAAM;QAClB,CAAC,CAAC;YACE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE;YAClC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE;SAC7B;QACH,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAErC,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACrF,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,MACf,MAOD,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,gBAAgB,CAAC,EAAE;YACpF,QAAQ,EAAE;gBACR,IAAI,EAAE,KAAK,EAAE,QAAqD,EAAE,EAAE;oBACpE,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,UAAU,IAAI,EAAE,EAAE,CAAC;wBACnD,mEAAmE;wBACnE,iEAAiE;wBACjE,kCAAkC;wBAClC,MAAM,GAAG,GAAG,SAAS,EAAE,KAAK,CAAC;wBAC7B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;4BAAE,SAAS;wBAC5D,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;oBACzB,CAAC;gBACH,CAAC;aACF;SACF,CAAC,CAAC;QACH,yEAAyE;QACzE,kEAAkE;QAClE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
package/dist/main.js CHANGED
@@ -3,7 +3,7 @@ import { loadEmailConfig } from "@miguelarios/pim-core";
3
3
  import { TOOL_LIST_CACHE_HINT, registerTools } from "@miguelarios/pim-core/mcp";
4
4
  import { McpServer } from "@modelcontextprotocol/server";
5
5
  import { serveStdio } from "@modelcontextprotocol/server/stdio";
6
- import { disposeUrlCleaner } from "./htmlToMarkdown.js";
6
+ import { disposeUrlCleaner, disposeUrlProxy } from "./htmlToMarkdown.js";
7
7
  import { registerImapResources } from "./resources/imapResources.js";
8
8
  import { ImapService } from "./services/ImapService.js";
9
9
  import { SmtpService } from "./services/SmtpService.js";
@@ -29,7 +29,7 @@ export async function createServer() {
29
29
  registerTools(server, EMAIL_TOOLS, services);
30
30
  registerImapResources(server, services.imap);
31
31
  const handleShutdown = async () => {
32
- await disposeUrlCleaner();
32
+ await Promise.all([disposeUrlCleaner(), disposeUrlProxy()]);
33
33
  process.exit(0);
34
34
  };
35
35
  process.on("SIGINT", handleShutdown);
package/dist/main.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,IAAI,WAAW,CAAC,MAAM,CAAC;QAC7B,IAAI,EAAE,IAAI,WAAW,CAAC,MAAM,CAAC;KAC9B,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,EACrE;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;YAC7B,qEAAqE;YACrE,8BAA8B;YAC9B,SAAS,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;SAClC;QACD,YAAY,EACV,+WAA+W;QACjX,UAAU,EAAE,EAAE,YAAY,EAAE,oBAAoB,EAAE;KACnD,CACF,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC7C,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE7C,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;QAChC,MAAM,iBAAiB,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAEtC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,uEAAuE;IACvE,yEAAyE;IACzE,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,EAAE;QAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,OAAO,CAAC;KAC9E,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACvD,CAAC"}
1
+ {"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,IAAI,WAAW,CAAC,MAAM,CAAC;QAC7B,IAAI,EAAE,IAAI,WAAW,CAAC,MAAM,CAAC;KAC9B,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,EACrE;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;YAC7B,qEAAqE;YACrE,8BAA8B;YAC9B,SAAS,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE;SAClC;QACD,YAAY,EACV,+WAA+W;QACjX,UAAU,EAAE,EAAE,YAAY,EAAE,oBAAoB,EAAE;KACnD,CACF,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC7C,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE7C,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;QAChC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,iBAAiB,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAEtC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,uEAAuE;IACvE,yEAAyE;IACzE,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,EAAE;QAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,OAAO,CAAC;KAC9E,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;AACvD,CAAC"}
@@ -21,6 +21,20 @@ export interface EmailFull extends EmailSummary {
21
21
  name?: string;
22
22
  address: string;
23
23
  }>;
24
+ /** Present only when the message carries a Reply-To header. */
25
+ replyTo?: Array<{
26
+ name?: string;
27
+ address: string;
28
+ }>;
29
+ /**
30
+ * Present only when the message carries a Bcc header — in practice only for
31
+ * a message this account sent, read back out of Sent or Drafts. A received
32
+ * message never names its blind recipients.
33
+ */
34
+ bcc?: Array<{
35
+ name?: string;
36
+ address: string;
37
+ }>;
24
38
  inReplyTo: string | null;
25
39
  references: string[];
26
40
  textBody?: string;
@@ -48,6 +62,20 @@ export interface CalendarPart {
48
62
  /** True when `content` was withheld — fetch via `download_attachment`. */
49
63
  truncated?: boolean;
50
64
  }
65
+ /** One message in a thread, tagged with the folder it was found in. */
66
+ export interface ThreadMessage extends EmailSummary {
67
+ folder: string;
68
+ }
69
+ export interface ThreadResult {
70
+ /**
71
+ * The Message-ID the conversation hangs off: the first entry of the anchor's
72
+ * References chain, or the anchor's own id when it starts the thread. Null
73
+ * when the anchor carries neither.
74
+ */
75
+ rootMessageId: string | null;
76
+ /** Oldest first — reading order for a conversation. */
77
+ messages: ThreadMessage[];
78
+ }
51
79
  export interface FolderInfo {
52
80
  path: string;
53
81
  specialUse?: string;
@@ -101,14 +129,72 @@ export declare class ImapService {
101
129
  private createClient;
102
130
  listFolders(): Promise<FolderInfo[]>;
103
131
  searchEmails(folder: string, params?: SearchParams, options?: SearchOptions): Promise<EmailSummary[]>;
132
+ /**
133
+ * The result set in the server's own order, or null when SORT is not
134
+ * available.
135
+ *
136
+ * A criteria array means the search had duplicate keys (several subject
137
+ * tokens, say) that IMAP cannot express in one command, so each is sorted
138
+ * separately and intersected. The first result's order is kept: every list
139
+ * is ordered the same way, so filtering one by membership in the others
140
+ * preserves it.
141
+ */
142
+ private sortedUids;
104
143
  private fetchSummaries;
144
+ /** Builds an {@link EmailSummary} from one FETCH response. */
145
+ private toSummary;
146
+ /**
147
+ * Assembles the conversation an anchor message belongs to.
148
+ *
149
+ * Two mechanisms, in order of preference. A server advertising OBJECTID or
150
+ * X-GM-EXT-1 assigns every message a thread id and will answer a SEARCH on
151
+ * it with the whole conversation — that is authoritative, and it catches
152
+ * replies whose References chain was mangled in transit. Otherwise the
153
+ * chain is walked: RFC 5322 §3.6.4 has every reply carry the root's
154
+ * Message-ID in its References, so one SEARCH for messages that either *are*
155
+ * the root or *cite* it returns the thread.
156
+ *
157
+ * RFC 5256's THREAD command would be the third option, but imapflow exposes
158
+ * no way to issue it.
159
+ */
160
+ fetchThread(anchorFolder: string, uid: number, folders: string[]): Promise<ThreadResult>;
105
161
  fetchEmail(folder: string, uid: number): Promise<EmailFull>;
106
162
  fetchRawEmail(folder: string, uid: number): Promise<string>;
107
163
  fetchRawEmail(folder: string, uid: number, maxBytes: number): Promise<RawEmailResult>;
164
+ /**
165
+ * Copies messages, leaving the originals in place.
166
+ *
167
+ * imapflow's `messageCopy` does not throw on a server refusal: its command
168
+ * catches the error, logs a warning, and resolves `false` (and resolves
169
+ * `undefined` when its own preconditions fail). So a missing destination —
170
+ * `NO [TRYCREATE]`, the most likely failure here — would otherwise be
171
+ * indistinguishable from a successful copy on a server without UIDPLUS.
172
+ * Both falsy results are turned back into a thrown error.
173
+ *
174
+ * The UID pairs come from the server's UIDPLUS `COPYUID` response. Without
175
+ * that extension there is no way to learn the new UIDs short of re-searching
176
+ * the destination, so the mapping is absent rather than guessed — the copy
177
+ * did happen.
178
+ */
179
+ copyEmails(folder: string, uids: number[], destination: string): Promise<Array<{
180
+ uid: number;
181
+ destinationUid: number;
182
+ }> | undefined>;
108
183
  moveEmails(folder: string, uids: number[], destination: string): Promise<void>;
109
184
  markEmails(folder: string, uids: number[], flags: string[], action: "add" | "remove"): Promise<void>;
110
185
  deleteEmails(folder: string, uids: number[], permanent?: boolean): Promise<void>;
111
186
  createFolder(path: string): Promise<void>;
187
+ /**
188
+ * Renames a mailbox, returning the paths the server reports rather than the
189
+ * ones requested — a server is free to normalise the delimiter or to prefix
190
+ * the personal namespace, and the RENAME response is the authority on where
191
+ * the folder ended up.
192
+ */
193
+ renameFolder(path: string, newPath: string): Promise<{
194
+ path: string;
195
+ newPath: string;
196
+ }>;
197
+ deleteFolder(path: string): Promise<void>;
112
198
  downloadAttachment(folder: string, uid: number, partId: string): Promise<AttachmentBytes>;
113
199
  downloadAttachment(folder: string, uid: number, partId: string, maxBytes: number): Promise<AttachmentDownload>;
114
200
  private static FALLBACK_NAMES;
@@ -1 +1 @@
1
- {"version":3,"file":"ImapService.d.ts","sourceRoot":"","sources":["../../src/services/ImapService.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ImapService.d.ts","sourceRoot":"","sources":["../../src/services/ImapService.ts"],"names":[],"mappings":"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"}