@dawnlit/outlook-bridge 1.1.1 → 2.1.0

package/dist/mail.js

@@ -1,103 +1,209 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PROTECTED_MAIL_REASON = exports.WELL_KNOWN_FOLDERS = void 0;
-exports.clamp = clamp;
+exports.REPLY_PREFIX = exports.REPLY_PREFIX_SOURCE = exports.NON_INCOMING_ROOTS = exports.PROTECTED_MAIL_REASON = exports.WELL_KNOWN_FOLDERS = exports.FolderId = void 0;
+exports.deleteStatus = deleteStatus;
+exports.deleteMailResult = deleteMailResult;
 exports.isOutgoingRoot = isOutgoingRoot;
+exports.hasReplyPrefix = hasReplyPrefix;
+exports.threadSubject = threadSubject;
+exports.subjectGlobSource = subjectGlobSource;
+exports.folderLeafName = folderLeafName;
 exports.mailFolderRef = mailFolderRef;
+exports.folderOption = folderOption;
 exports.splitQuotedOriginal = splitQuotedOriginal;
+// Platform-neutral mail helpers: folder strings, reply prefixes, splitting a
+// reply from the thread it quotes, and what deleting mail reports. Pure
+// functions, usable without Outlook, and shared by both platforms so neither can
+// come to read these differently.
+const errors_1 = require("./errors");
 /**
- * Clamp a caller's count to the range an operation actually accepts.
- *
- * These bounds ARE the argument contract — how far back a scan reaches, how many
- * rows come back, how deep a folder walk goes — so they are stated here rather
- * than once per platform, which is how the two came to disagree about what a
- * `daysBack` of 0 means.
+ * Outlook's olDefaultFolders ids for the folders this package addresses by
+ * role rather than by name. The ids are Outlook's own, and a folder's NAME is
+ * localized, so a role is always resolved through its id.
+ */
+exports.FolderId = Object.freeze({
+    DeletedItems: 3,
+    Outbox: 4,
+    SentMail: 5,
+    Inbox: 6,
+    Drafts: 16,
+    Junk: 23,
+});
+/**
+ * The folders addressable by name rather than by walking from the Inbox, with
+ * their olDefaultFolders id. A well-known name wins over a user folder of the
+ * same name; reach the latter by qualifying it (`Inbox\Drafts`).
+ */
+exports.WELL_KNOWN_FOLDERS = Object.freeze({
+    'inbox': exports.FolderId.Inbox,
+    'sent items': exports.FolderId.SentMail,
+    'sent': exports.FolderId.SentMail,
+    'sent mail': exports.FolderId.SentMail,
+    'drafts': exports.FolderId.Drafts,
+    'deleted items': exports.FolderId.DeletedItems,
+    'deleted': exports.FolderId.DeletedItems,
+    'trash': exports.FolderId.DeletedItems,
+    'junk email': exports.FolderId.Junk,
+    'junk': exports.FolderId.Junk,
+    'outbox': exports.FolderId.Outbox,
+});
+/** The Inbox root, as a folder reference. */
+const INBOX_REF = Object.freeze({
+    rootId: exports.FolderId.Inbox,
+    rootLabel: 'Inbox',
+    segments: [],
+});
+/**
+ * Why `deleteOutlookEmails` refuses an item, worded once for both platforms —
+ * it reaches the caller verbatim as a per-item `reason`.
  */
-function clamp(value, min, max) {
-    return Math.max(min, Math.min(max, Math.floor(value)));
+exports.PROTECTED_MAIL_REASON = 'received or sent mail (Inbox/Sent Items or a subfolder) - pass allowProtected to override';
+const DELETE_STATUSES = ['deleted', 'would-delete', 'refused', 'failed'];
+/** The status a delete script reported for one item; anything it shouldn't have said is a failure. */
+function deleteStatus(reported) {
+    return DELETE_STATUSES.find(status => status === reported) ?? 'failed';
+}
+/** A deleteOutlookEmails result: every outcome, and how many ended each way. */
+function deleteMailResult(dryRun, items) {
+    const tally = (status) => items.filter(item => item.status === status).length;
+    return { dryRun, deleted: tally('deleted'), refused: tally('refused'), failed: tally('failed'), items };
 }
 /**
- * The Outlook folders addressable by name rather than by walking from the Inbox,
- * with their olDefaultFolders id. Sent Items is the one that earns this: "has this
- * already gone out?" is otherwise unanswerable, and no amount of Inbox scanning
- * substitutes for it.
+ * Roots whose items are outgoing mail, which carries a sent time where incoming
+ * mail carries a received one — so a date filter has to know which it's on.
+ */
+function isOutgoingRoot(rootId) {
+    return rootId === exports.FolderId.SentMail || rootId === exports.FolderId.Outbox || rootId === exports.FolderId.Drafts;
+}
+/**
+ * Roots an Inbox walk must never descend into.
  *
- * A well-known name always wins over a user folder of the same name — reach the
- * latter by qualifying it (`Inbox\Drafts`).
+ * On an Exchange profile these sit beside the Inbox and a walk from it can't
+ * reach them anyway. On an IMAP profile Outlook nests them UNDER the Inbox, so
+ * the same walk would hand back mail already sent, drafted or thrown away as if
+ * it had just arrived. They are matched by id, never by name: the names are
+ * localized.
  */
-exports.WELL_KNOWN_FOLDERS = {
-    inbox: 6,
-    'sent items': 5,
-    sent: 5,
-    'sent mail': 5,
-    drafts: 16,
-    'deleted items': 3,
-    deleted: 3,
-    trash: 3,
-    'junk email': 23,
-    junk: 23,
-    outbox: 4,
-};
+exports.NON_INCOMING_ROOTS = Object.freeze([
+    exports.FolderId.DeletedItems,
+    exports.FolderId.Outbox,
+    exports.FolderId.SentMail,
+    exports.FolderId.Drafts,
+    exports.FolderId.Junk,
+]);
 /**
- * Why `deleteOutlookEmails` refuses a message, worded once for both platforms.
+ * Subject prefixes that mark a reply or a forward.
+ *
+ * Kept as a pattern SOURCE because it runs in two engines: macOS tests it as a
+ * JavaScript RegExp, Windows inside PowerShell's .NET one, and both read every
+ * construct used here the same way. Non-ASCII is written as \uXXXX so the
+ * generated PowerShell stays plain ASCII.
  *
- * It reaches the caller verbatim in a per-email `reason`, so the two generated
- * scripts must not word it independently — the same reasoning that put the
- * attachment "not found" sentence in `shared/attachmentMatch.ts`. It also names
- * the option a consumer of THIS package actually passes: the text used to say
- * `allow_protected`, which is the tool-layer spelling and not a name this
- * package exposes.
+ * Not only English: mail threaded in Chinese, Japanese or Korean replies under
+ * 回复:/返信:/답장: and forwards under 转发:/転送:/전달:, and the European
+ * clients use AW:, WG:, SV:, TR:, RV:, ENC: and friends. The colon may be the
+ * full-width one a CJK input method types, and Outlook's reply counter (RE[2]:)
+ * can sit before it.
  */
-exports.PROTECTED_MAIL_REASON = 'received or sent mail (Inbox/Sent Items or a subfolder) - pass allowProtected to override';
+const REPLY_PREFIXES = [
+    're', 'fwd?', 'aw', 'wg', 'sv', 'vs', 'vb', 'tr', 'res', 'rv', 'enc', 'odp',
+    '\\u56DE\\u590D', '\\u56DE\\u8986', '\\u7B54\\u590D', '\\u7B54\\u8986',
+    '\\u8F6C\\u53D1', '\\u8F49\\u767C', '\\u8FD4\\u4FE1', '\\u8EE2\\u9001',
+    '\\uB2F5\\uC7A5', '\\uC804\\uB2EC',
+];
+/** The reply/forward prefixes as one case-insensitive pattern source. */
+exports.REPLY_PREFIX_SOURCE = '^\\s*(?:' + REPLY_PREFIXES.join('|') + ')\\s*(?:\\[\\d+\\])?\\s*[:\\uFF1A]';
+exports.REPLY_PREFIX = new RegExp(exports.REPLY_PREFIX_SOURCE, 'i');
 /**
- * Roots whose items are OUTGOING mail.
+ * Whether a subject opens on a reply or forward prefix.
  *
- * Outgoing mail carries a sent timestamp where received mail carries a received
- * one, and both platforms have to pick the same folders out on that basis —
- * which is why it lives beside `WELL_KNOWN_FOLDERS` rather than as raw
- * `olDefaultFolders` ids compared inline in each reader.
+ * This reads what the subject claims, not how the email was made: a forward
+ * carries a prefix too, and a client can leave one off a real reply.
  */
-function isOutgoingRoot(rootId) {
-    return rootId === exports.WELL_KNOWN_FOLDERS['sent items']
-        || rootId === exports.WELL_KNOWN_FOLDERS.outbox
-        || rootId === exports.WELL_KNOWN_FOLDERS.drafts;
+function hasReplyPrefix(subject) {
+    return exports.REPLY_PREFIX.test(subject);
 }
 /**
- * Resolve a caller's folder string to a well-known root plus the segments below it.
- *
- * Accepts every shape a user has to hand: a bare name ("Invoices"), a relative
- * path ("Invoices\\Paid"), a well-known folder ("Sent Items"), a path under one
- * ("Deleted Items\\2026"), and the full FolderPath listInboxFolders prints
- * ("\\\\team@x.com\\Inbox\\Invoices").
+ * The subject every message in a thread shares: every reply and forward prefix
+ * stripped, however many clients stacked them (`RE: FW: RE[2]: Rate request`
+ * is `Rate request`), and whitespace collapsed. Case is kept, so lower-case
+ * both sides to compare two threads.
+ */
+function threadSubject(subject) {
+    let rest = subject;
+    // Each pass removes at least the prefix's colon, so this always ends.
+    while (exports.REPLY_PREFIX.test(rest))
+        rest = rest.replace(exports.REPLY_PREFIX, '');
+    return rest.replace(/\s+/g, ' ').trim();
+}
+/**
+ * A subject glob as an anchored regex source: `*` matches any run, `?` one
+ * character, everything else itself. Written with constructs JavaScript and
+ * .NET read identically, so both platforms apply exactly the same test.
+ */
+function subjectGlobSource(glob) {
+    let source = '';
+    for (const ch of glob) {
+        if (ch === '*')
+            source += '.*';
+        else if (ch === '?')
+            source += '.';
+        else
+            source += ch.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+    return `^${source}$`;
+}
+/** The leaf name of a folder path or bare name. */
+function folderLeafName(entry) {
+    return entry.trim().split(/[\\/]/).filter(Boolean).pop() ?? '';
+}
+/** A full Outlook folder path starts with the mailbox: `\\mailbox@example.com\…`. */
+const MAILBOX_PREFIX = /^\\\\[^\\/]+[\\/]/;
+function folderSegments(folder) {
+    return folder.trim().replace(MAILBOX_PREFIX, '').split(/[\\/]+/).map(s => s.trim()).filter(Boolean);
+}
+/**
+ * Resolve a folder string to a well-known root plus the segments below it.
  *
- * An unrecognized first segment means Inbox-relative, which is what keeps a bare
- * subfolder name working unchanged.
+ * Accepts every shape a person has to hand: a bare name ('Invoices'), a
+ * relative path ('Invoices\Paid'), a well-known folder ('Sent Items'), a path
+ * under one ('Deleted Items\2026'), and the full path listInboxFolders prints
+ * ('\\team@example.com\Inbox\Invoices'). Anything not starting at a well-known
+ * folder is taken as relative to the Inbox.
  */
 function mailFolderRef(folder) {
-    const rest = folder.trim().replace(/^\\\\[^\\/]+[\\/]/, '');
-    const segments = rest.split(/[\\/]+/).map(s => s.trim()).filter(Boolean);
-    if (segments.length > 0) {
-        const head = segments[0].toLowerCase();
-        if (Object.prototype.hasOwnProperty.call(exports.WELL_KNOWN_FOLDERS, head)) {
-            return { rootId: exports.WELL_KNOWN_FOLDERS[head], rootLabel: segments[0], segments: segments.slice(1) };
-        }
+    const segments = folderSegments(folder);
+    const head = segments[0]?.toLowerCase();
+    if (head !== undefined && Object.prototype.hasOwnProperty.call(exports.WELL_KNOWN_FOLDERS, head)) {
+        return { rootId: exports.WELL_KNOWN_FOLDERS[head], rootLabel: segments[0], segments: segments.slice(1) };
+    }
+    return { rootId: exports.FolderId.Inbox, rootLabel: 'Inbox', segments };
+}
+/**
+ * A caller's folder option as a reference: none given means the Inbox root,
+ * and a string that names no folder at all (only separators) is refused rather
+ * than silently read as the Inbox root.
+ */
+function folderOption(folder) {
+    if (folder === undefined || folder.trim() === '')
+        return { ref: INBOX_REF, label: 'Inbox' };
+    if (folderSegments(folder).length === 0) {
+        throw new errors_1.InvalidRequestError(`Folder '${folder}' does not name a folder.`);
     }
-    return { rootId: 6, rootLabel: 'Inbox', segments };
+    return { ref: mailFolderRef(folder), label: folder.trim() };
 }
 /**
  * Split a plain-text reply into the sender's own text and the quoted thread
  * below it.
  *
- * This matters more than it looks: the quoted original of a reply carries the
- * text of the message it answers. Handing a caller one blob invites a figure
- * from the outgoing message to be read back as the sender's answer, which is a
- * worse failure than the truncation this exists to fix.
+ * This matters more than it looks: the quoted original carries the text of the
+ * message being answered, and handing a reader one blob invites a figure from
+ * that message to be read back as the sender's own.
  *
- * Scans for the earliest of the separators Outlook and the common webmail
- * clients emit. If the split would leave no new text at all — a bottom-posted
- * reply, or a body that opens on a quote — it is abandoned and everything is
- * returned as `body`, since dropping the sender's actual words is the one
- * outcome worth avoiding.
+ * Splits at the earliest separator Outlook or the common webmail clients emit.
+ * If that would leave no new text at all — a bottom-posted reply, or a body
+ * that opens on a quote — the split is abandoned and everything is `body`,
+ * since losing the sender's actual words is the one outcome worth avoiding.
  */
 function splitQuotedOriginal(text) {
     const lines = text.split(/\r?\n/);
@@ -107,10 +213,10 @@ function splitQuotedOriginal(text) {
         let separator = '';
         if (/^-{2,}\s*original message\s*-{2,}$/i.test(line))
             separator = '-----Original Message-----';
-        // Outlook's HTML thread rule, which sits directly above the From:/Sent: block.
+        // Outlook's HTML thread rule, directly above the From:/Sent: block.
         else if (/^_{10,}$/.test(line))
             separator = 'Outlook thread rule';
-        // "On Tue, Jul 21, 2026 at 9:14 AM John Doe <j@x.com> wrote:"
+        // "On Tue, Jul 21, 2026 at 9:14 AM Jo Doe <jo@example.com> wrote:"
         else if (/^on\b.{5,300}\bwrote:$/i.test(line))
             separator = 'On … wrote:';
         else if (/^>/.test(lines[i]))

package/dist/mail.js.map

@@ -1 +1 @@
-{"version":3,"file":"mail.js","sourceRoot":"","sources":["../src/mail.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mail.js","sourceRoot":"","sources":["../src/mail.ts"],"names":[],"mappings":"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","sourcesContent":["// Platform-neutral mail helpers: folder strings, reply prefixes, splitting a\n// reply from the thread it quotes, and what deleting mail reports. Pure\n// functions, usable without Outlook, and shared by both platforms so neither can\n// come to read these differently.\nimport { InvalidRequestError } from './errors';\nimport type { DeleteMailOutcome, DeleteMailResult, MailFolderRef } from './types';\n\n/**\n * Outlook's olDefaultFolders ids for the folders this package addresses by\n * role rather than by name. The ids are Outlook's own, and a folder's NAME is\n * localized, so a role is always resolved through its id.\n */\nexport const FolderId = Object.freeze({\n    DeletedItems: 3,\n    Outbox: 4,\n    SentMail: 5,\n    Inbox: 6,\n    Drafts: 16,\n    Junk: 23,\n});\n\n/**\n * The folders addressable by name rather than by walking from the Inbox, with\n * their olDefaultFolders id. A well-known name wins over a user folder of the\n * same name; reach the latter by qualifying it (`Inbox\\Drafts`).\n */\nexport const WELL_KNOWN_FOLDERS: Readonly<Record<string, number>> = Object.freeze({\n    'inbox': FolderId.Inbox,\n    'sent items': FolderId.SentMail,\n    'sent': FolderId.SentMail,\n    'sent mail': FolderId.SentMail,\n    'drafts': FolderId.Drafts,\n    'deleted items': FolderId.DeletedItems,\n    'deleted': FolderId.DeletedItems,\n    'trash': FolderId.DeletedItems,\n    'junk email': FolderId.Junk,\n    'junk': FolderId.Junk,\n    'outbox': FolderId.Outbox,\n});\n\n/** The Inbox root, as a folder reference. */\nconst INBOX_REF: Readonly<MailFolderRef> = Object.freeze({\n    rootId: FolderId.Inbox,\n    rootLabel: 'Inbox',\n    segments: [],\n});\n\n/**\n * Why `deleteOutlookEmails` refuses an item, worded once for both platforms —\n * it reaches the caller verbatim as a per-item `reason`.\n */\nexport const PROTECTED_MAIL_REASON =\n    'received or sent mail (Inbox/Sent Items or a subfolder) - pass allowProtected to override';\n\nconst DELETE_STATUSES: readonly DeleteMailOutcome['status'][] = ['deleted', 'would-delete', 'refused', 'failed'];\n\n/** The status a delete script reported for one item; anything it shouldn't have said is a failure. */\nexport function deleteStatus(reported: string): DeleteMailOutcome['status'] {\n    return DELETE_STATUSES.find(status => status === reported) ?? 'failed';\n}\n\n/** A deleteOutlookEmails result: every outcome, and how many ended each way. */\nexport function deleteMailResult(dryRun: boolean, items: DeleteMailOutcome[]): DeleteMailResult {\n    const tally = (status: DeleteMailOutcome['status']) => items.filter(item => item.status === status).length;\n    return { dryRun, deleted: tally('deleted'), refused: tally('refused'), failed: tally('failed'), items };\n}\n\n/**\n * Roots whose items are outgoing mail, which carries a sent time where incoming\n * mail carries a received one — so a date filter has to know which it's on.\n */\nexport function isOutgoingRoot(rootId: number): boolean {\n    return rootId === FolderId.SentMail || rootId === FolderId.Outbox || rootId === FolderId.Drafts;\n}\n\n/**\n * Roots an Inbox walk must never descend into.\n *\n * On an Exchange profile these sit beside the Inbox and a walk from it can't\n * reach them anyway. On an IMAP profile Outlook nests them UNDER the Inbox, so\n * the same walk would hand back mail already sent, drafted or thrown away as if\n * it had just arrived. They are matched by id, never by name: the names are\n * localized.\n */\nexport const NON_INCOMING_ROOTS: readonly number[] = Object.freeze([\n    FolderId.DeletedItems,\n    FolderId.Outbox,\n    FolderId.SentMail,\n    FolderId.Drafts,\n    FolderId.Junk,\n]);\n\n/**\n * Subject prefixes that mark a reply or a forward.\n *\n * Kept as a pattern SOURCE because it runs in two engines: macOS tests it as a\n * JavaScript RegExp, Windows inside PowerShell's .NET one, and both read every\n * construct used here the same way. Non-ASCII is written as \\uXXXX so the\n * generated PowerShell stays plain ASCII.\n *\n * Not only English: mail threaded in Chinese, Japanese or Korean replies under\n * 回复:/返信:/답장: and forwards under 转发:/転送:/전달:, and the European\n * clients use AW:, WG:, SV:, TR:, RV:, ENC: and friends. The colon may be the\n * full-width one a CJK input method types, and Outlook's reply counter (RE[2]:)\n * can sit before it.\n */\nconst REPLY_PREFIXES: readonly string[] = [\n    're', 'fwd?', 'aw', 'wg', 'sv', 'vs', 'vb', 'tr', 'res', 'rv', 'enc', 'odp',\n    '\\\\u56DE\\\\u590D', '\\\\u56DE\\\\u8986', '\\\\u7B54\\\\u590D', '\\\\u7B54\\\\u8986',\n    '\\\\u8F6C\\\\u53D1', '\\\\u8F49\\\\u767C', '\\\\u8FD4\\\\u4FE1', '\\\\u8EE2\\\\u9001',\n    '\\\\uB2F5\\\\uC7A5', '\\\\uC804\\\\uB2EC',\n];\n\n/** The reply/forward prefixes as one case-insensitive pattern source. */\nexport const REPLY_PREFIX_SOURCE =\n    '^\\\\s*(?:' + REPLY_PREFIXES.join('|') + ')\\\\s*(?:\\\\[\\\\d+\\\\])?\\\\s*[:\\\\uFF1A]';\nexport const REPLY_PREFIX = new RegExp(REPLY_PREFIX_SOURCE, 'i');\n\n/**\n * Whether a subject opens on a reply or forward prefix.\n *\n * This reads what the subject claims, not how the email was made: a forward\n * carries a prefix too, and a client can leave one off a real reply.\n */\nexport function hasReplyPrefix(subject: string): boolean {\n    return REPLY_PREFIX.test(subject);\n}\n\n/**\n * The subject every message in a thread shares: every reply and forward prefix\n * stripped, however many clients stacked them (`RE: FW: RE[2]: Rate request`\n * is `Rate request`), and whitespace collapsed. Case is kept, so lower-case\n * both sides to compare two threads.\n */\nexport function threadSubject(subject: string): string {\n    let rest = subject;\n    // Each pass removes at least the prefix's colon, so this always ends.\n    while (REPLY_PREFIX.test(rest)) rest = rest.replace(REPLY_PREFIX, '');\n    return rest.replace(/\\s+/g, ' ').trim();\n}\n\n/**\n * A subject glob as an anchored regex source: `*` matches any run, `?` one\n * character, everything else itself. Written with constructs JavaScript and\n * .NET read identically, so both platforms apply exactly the same test.\n */\nexport function subjectGlobSource(glob: string): string {\n    let source = '';\n    for (const ch of glob) {\n        if (ch === '*') source += '.*';\n        else if (ch === '?') source += '.';\n        else source += ch.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n    }\n    return `^${source}$`;\n}\n\n/** The leaf name of a folder path or bare name. */\nexport function folderLeafName(entry: string): string {\n    return entry.trim().split(/[\\\\/]/).filter(Boolean).pop() ?? '';\n}\n\n/** A full Outlook folder path starts with the mailbox: `\\\\mailbox@example.com\\…`. */\nconst MAILBOX_PREFIX = /^\\\\\\\\[^\\\\/]+[\\\\/]/;\n\nfunction folderSegments(folder: string): string[] {\n    return folder.trim().replace(MAILBOX_PREFIX, '').split(/[\\\\/]+/).map(s => s.trim()).filter(Boolean);\n}\n\n/**\n * Resolve a folder string to a well-known root plus the segments below it.\n *\n * Accepts every shape a person has to hand: a bare name ('Invoices'), a\n * relative path ('Invoices\\Paid'), a well-known folder ('Sent Items'), a path\n * under one ('Deleted Items\\2026'), and the full path listInboxFolders prints\n * ('\\\\team@example.com\\Inbox\\Invoices'). Anything not starting at a well-known\n * folder is taken as relative to the Inbox.\n */\nexport function mailFolderRef(folder: string): MailFolderRef {\n    const segments = folderSegments(folder);\n    const head = segments[0]?.toLowerCase();\n    if (head !== undefined && Object.prototype.hasOwnProperty.call(WELL_KNOWN_FOLDERS, head)) {\n        return { rootId: WELL_KNOWN_FOLDERS[head], rootLabel: segments[0], segments: segments.slice(1) };\n    }\n    return { rootId: FolderId.Inbox, rootLabel: 'Inbox', segments };\n}\n\n/**\n * A caller's folder option as a reference: none given means the Inbox root,\n * and a string that names no folder at all (only separators) is refused rather\n * than silently read as the Inbox root.\n */\nexport function folderOption(folder: string | undefined): { ref: MailFolderRef; label: string } {\n    if (folder === undefined || folder.trim() === '') return { ref: INBOX_REF, label: 'Inbox' };\n    if (folderSegments(folder).length === 0) {\n        throw new InvalidRequestError(`Folder '${folder}' does not name a folder.`);\n    }\n    return { ref: mailFolderRef(folder), label: folder.trim() };\n}\n\n/**\n * Split a plain-text reply into the sender's own text and the quoted thread\n * below it.\n *\n * This matters more than it looks: the quoted original carries the text of the\n * message being answered, and handing a reader one blob invites a figure from\n * that message to be read back as the sender's own.\n *\n * Splits at the earliest separator Outlook or the common webmail clients emit.\n * If that would leave no new text at all — a bottom-posted reply, or a body\n * that opens on a quote — the split is abandoned and everything is `body`,\n * since losing the sender's actual words is the one outcome worth avoiding.\n */\nexport function splitQuotedOriginal(text: string): { body: string; quoted: string; separator: string } {\n    const lines = text.split(/\\r?\\n/);\n    const whole = { body: text, quoted: '', separator: '' };\n    for (let i = 0; i < lines.length; i++) {\n        const line = lines[i].trim();\n        let separator = '';\n        if (/^-{2,}\\s*original message\\s*-{2,}$/i.test(line)) separator = '-----Original Message-----';\n        // Outlook's HTML thread rule, directly above the From:/Sent: block.\n        else if (/^_{10,}$/.test(line)) separator = 'Outlook thread rule';\n        // \"On Tue, Jul 21, 2026 at 9:14 AM Jo Doe <jo@example.com> wrote:\"\n        else if (/^on\\b.{5,300}\\bwrote:$/i.test(line)) separator = 'On … wrote:';\n        else if (/^>/.test(lines[i])) separator = '> quoted lines';\n        // A bare header block: \"From: …\" followed by another header line.\n        else if (/^from:\\s*\\S/i.test(line) && /^(sent|date|to|subject|cc):/i.test((lines[i + 1] || '').trim())) {\n            separator = 'From:/Sent: header block';\n        }\n        if (!separator) continue;\n        const body = lines.slice(0, i).join('\\n').trimEnd();\n        if (!body.trim()) return whole;\n        return { body, quoted: lines.slice(i).join('\\n').trim(), separator };\n    }\n    return whole;\n}\n"]}

package/dist/runtime.d.ts

@@ -1,8 +1,8 @@
+import { type ScriptRunner } from './errors';
 /** One completed script run, handed to the `debug` hook. */
 export interface BridgeDebugEvent {
-    /** Which interpreter ran it. */
-    runner: 'powershell' | 'osascript';
-    /** The generated script, verbatim — the thing you actually want when a run fails. */
+    runner: ScriptRunner;
+    /** The script exactly as it ran. */
     script: string;
     durationMs: number;
     /** Present only when the run failed. */
@@ -10,67 +10,100 @@ export interface BridgeDebugEvent {
 }
 export interface BridgeOptions {
     /**
-     * Default ceiling (ms) on a single script run; 0 disables it. Calls that
-     * already carry a specific budget (a full-mailbox scan, a purge) keep their
-     * own and ignore this.
+     * Ceiling on every script run, in milliseconds, replacing each operation's
+     * own budget; 0 disables timeouts. Leave unset (or pass null to go back) to
+     * let each operation use a budget sized for its work — a minute for a
+     * lookup, up to ten for purging Deleted Items. `editEmailTemplate` waits on
+     * a person and is never timed; cancel it with `signal`.
      */
-    timeoutMs?: number;
+    timeoutMs?: number | null;
     /**
-     * Max bytes a script may write to stdout before the run is killed. A read
-     * that returns message bodies is what pushes against this — raise it before
-     * scanning a mailbox that returns thousands of matches.
+     * Max bytes a script may print before the run is killed with
+     * OUTPUT_TOO_LARGE. Searches that return whole bodies push against this.
+     * Default 8 MiB.
      */
     maxBufferBytes?: number;
-    /** Directory for generated scripts and for saved attachments when the caller
-     *  names no destination. Defaults to the OS temp directory. */
+    /** Directory for generated scripts, and for saved attachments when a call
+     *  names no destination. Default: the OS temp directory. */
     tempDir?: string;
     /**
-     * Cancels in-flight runs: the interpreter is killed and the call rejects with
-     * an `AbortedError`. A timeout only caps a run's length — this is how a UI
-     * with a Cancel button, or a shutting-down process, calls one off early.
-     *
-     * Most useful scoped to the calls you want to cancel rather than set process
-     * wide: `bridge.withOptions({ signal }).searchInboxByFilter(...)`.
+     * Cancels in-flight runs: the interpreter is killed and the call rejects
+     * with ABORTED. Most useful scoped to the calls it should cancel:
+     * `bridge.withOptions({ signal }).searchInboxByFilter(...)`.
      */
     signal?: AbortSignal;
-    /** `true` logs every generated script to stderr; a function receives each run
-     *  instead. Defaults to on when OUTLOOK_BRIDGE_DEBUG is set to a non-empty,
-     *  non-'0' value. */
+    /** `true` logs every script to stderr; a function receives each run
+     *  instead. Default: on when OUTLOOK_BRIDGE_DEBUG is set to anything but '' or '0'. */
     debug?: boolean | ((event: BridgeDebugEvent) => void);
 }
-export type ResolvedConfig = Required<Pick<BridgeOptions, 'timeoutMs' | 'maxBufferBytes' | 'tempDir'>> & Pick<BridgeOptions, 'debug' | 'signal'>;
-/** Merge caller options over a base, ignoring the keys they left out. */
+/** The settings a call runs with, every default applied. */
+export interface ResolvedConfig {
+    /** undefined = each operation's own budget. */
+    readonly timeoutMs: number | undefined;
+    readonly maxBufferBytes: number;
+    readonly tempDir: string;
+    readonly signal: AbortSignal | undefined;
+    readonly debug: boolean | ((event: BridgeDebugEvent) => void);
+}
+/** Caller options merged over a base; keys left out keep the base's value. */
 export declare function mergeOptions(base: ResolvedConfig, options?: BridgeOptions): ResolvedConfig;
 /**
- * Override the process-wide defaults. Merges, so naming one option leaves the
- * rest alone. Call before the first automation call.
+ * Change the process-wide settings. Merges, so naming one option leaves the
+ * rest alone.
  *
- * Affects every caller in the process. Prefer `createOutlookBridge(options)` in
- * anything that shares a process with code you don't own.
+ * Affects every caller in the process that uses the exported functions. Prefer
+ * `createOutlookBridge(options)` in a process shared with code you don't own.
  */
 export declare function configure(options: BridgeOptions): void;
-/** The settings in force for the current call — the enclosing scope's, else global. */
-export declare function getConfig(): Readonly<ResolvedConfig>;
-/** The process-wide defaults, ignoring any active scope. */
-export declare function getGlobalConfig(): Readonly<ResolvedConfig>;
+/** The settings in force for the current call: the enclosing bridge's, else the process-wide ones. */
+export declare function getConfig(): ResolvedConfig;
+/** The process-wide settings, ignoring any bridge scope. */
+export declare function getGlobalConfig(): ResolvedConfig;
 /** Run `fn` with `config` in force for it and everything it awaits. */
 export declare function withConfig<T>(config: ResolvedConfig, fn: () => T): T;
-/** Report one finished script run to the configured debug hook. */
+/**
+ * How long each kind of run may take when no `timeoutMs` is set.
+ *
+ * Generous on purpose: a budget is a guard against a hung interpreter, not a
+ * performance target, and the first call against an Outlook that isn't running
+ * yet spends much of its budget starting it.
+ */
+export declare const RUN_BUDGETS: {
+    /** One lookup: accounts, signatures, opening or reading a single email. */
+    readonly quick: 60000;
+    /** Composing, filing, saving attachments, or reading one folder. */
+    readonly standard: 120000;
+    /** Walking a mailbox tree, or acting on a batch of items. */
+    readonly scan: 300000;
+    /** Emptying Deleted Items. */
+    readonly purge: 600000;
+};
+/** A budget name, or 'interactive' for a run that waits on a person and is never timed. */
+export type RunBudget = keyof typeof RUN_BUDGETS | 'interactive';
+/** The timeout one run gets: the configured ceiling if there is one, else its budget. */
+export declare function timeoutFor(budget: RunBudget): number;
+/** Report one finished run to the configured debug hook. */
 export declare function reportRun(event: BridgeDebugEvent): void;
 /**
- * Path for a scratch file in the configured temp directory. The random suffix
- * matters: two concurrent calls landing in the same millisecond would otherwise
- * pick the same name and overwrite each other's script mid-run.
+ * A scratch-file path in the configured temp directory. The random part
+ * matters: two concurrent calls in the same millisecond would otherwise pick the
+ * same name and overwrite each other's script mid-run.
  */
 export declare function tempFile(kind: string, extension: string): string;
+/** Delete a scratch file, ignoring one that is already gone. */
+export declare function removeTempFile(file: string): void;
+/** A destination for saved attachments, and how to undo creating it. */
+export interface AttachmentDestination {
+    dir: string;
+    /** Remove the directory if this call created it and left it empty. */
+    discardIfUnused(): void;
+}
 /**
- * A fresh directory for one call's saved attachments.
+ * Where one call saves its attachments: the caller's directory (created if
+ * absent), or a fresh private directory of its own.
  *
- * Deliberately per-call rather than one shared folder: attachments are saved
- * under the name the sender gave them, so two emails that both carry
- * "invoice.pdf" would otherwise silently overwrite each other — and so would two
- * unrelated programs using this package on the same machine.
+ * Private by default because attachments keep the names senders gave them, so
+ * one shared folder means two emails carrying 'invoice.pdf' overwrite each
+ * other — and so do two programs using this package on one machine.
  */
-export declare function makeAttachmentDir(): string;
-/** Resolve a caller-supplied destination, creating it when absent. */
-export declare function resolveDestDir(destDir?: string): string;
+export declare function attachmentDestination(destDir?: string): AttachmentDestination;