@dawnlit/outlook-bridge 1.1.1 → 2.0.0

package/dist/mac/index.d.ts

@@ -1,22 +1,2 @@
-import type { CapabilityMap, OutlookBridge } from '../types';
-/**
- * The whole contract in one object — and the compile-time proof that this
- * module answers all of it.
- *
- * Typed as `OutlookBridge` rather than inferred: a signature that drifts from
- * the Windows one has to fail here, in the package, rather than surface as a
- * per-platform union in the consumer's editor.
- */
-declare const bridge: OutlookBridge;
-export { bridge };
-export * from './accounts';
-export * from './send';
-export * from './drafts';
-export * from './read';
-export * from './folders';
-export * from './cleanup';
-export * from './bounces';
-export * from './attachments';
-export * from './signatures';
-export * from './templates';
-export declare const capabilities: CapabilityMap;
+import type { Backend } from '../backend';
+export declare const macBackend: Backend;

package/dist/mac/index.js

@@ -1,63 +1,37 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.capabilities = exports.bridge = void 0;
-// The macOS implementation: Outlook driven through AppleScript (osascript).
+exports.macBackend = void 0;
+// The macOS backend: Outlook driven through AppleScript (osascript).
 //
-// Scope note: this targets **legacy** Outlook for Mac (`defaults read
-// com.microsoft.Outlook IsRunningNewOutlook` = 0), which implements enough of the
-// AppleScript dictionary to enumerate accounts, read mailboxes, reply, file and
-// delete mail. "New Outlook" implements only a slice of it: accounts don't
-// enumerate, the inbox reports 0 messages, and mutations like `delete` silently
-// no-op. Under New Outlook the account lookup finds nothing and every function
-// here fails loudly with "Account '…' not found" rather than quietly doing the
-// wrong thing.
+// This targets LEGACY Outlook for Mac, which implements enough of the AppleScript
+// dictionary to enumerate accounts, read mailboxes, reply, file and delete mail.
+// New Outlook implements only a slice of it — accounts don't enumerate and the
+// inbox reports no messages — so there the account lookup finds nothing and
+// every operation fails loudly as ACCOUNT_NOT_FOUND rather than quietly doing
+// the wrong thing.
 //
-// Three dictionary traps are worth knowing, and each is handled where it bites:
+// Three dictionary traps are handled where they bite:
 //  - `move`/`delete`/`close` report success even when they do nothing, so every
 //    mutation confirms with a count.
-//  - A new outgoing message lands in Temporary Items — `open` only displays it,
-//    so a windowless draft has to be moved into Drafts explicitly.
-//  - A bad dictionary term fails the WHOLE script at compile time rather than at
-//    the offending line, which is why the root terms in scripts.ts are the
-//    verified ones rather than the ones the Windows ids suggest.
+//  - A new outgoing message lands in Temporary Items; `open` only displays it,
+//    so a windowless draft is moved into Drafts explicitly.
+//  - One bad dictionary term fails the WHOLE script at compile time rather than
+//    at the offending line, which is why the root terms in scripts.ts are the
+//    verified ones.
 const accounts_1 = require("./accounts");
 const send_1 = require("./send");
-const drafts_1 = require("./drafts");
 const read_1 = require("./read");
 const folders_1 = require("./folders");
+const drafts_1 = require("./drafts");
 const cleanup_1 = require("./cleanup");
-const bounces_1 = require("./bounces");
 const attachments_1 = require("./attachments");
+const bounces_1 = require("./bounces");
 const signatures_1 = require("./signatures");
 const templates_1 = require("./templates");
-const capabilities_1 = require("../shared/capabilities");
-/**
- * The whole contract in one object — and the compile-time proof that this
- * module answers all of it.
- *
- * Typed as `OutlookBridge` rather than inferred: a signature that drifts from
- * the Windows one has to fail here, in the package, rather than surface as a
- * per-platform union in the consumer's editor.
- */
-const bridge = {
+exports.macBackend = {
     getOutlookAccounts: accounts_1.getOutlookAccounts,
     sendOutlookEmail: send_1.sendOutlookEmail,
     replyOutlookEmail: send_1.replyOutlookEmail,
-    sendAllDrafts: drafts_1.sendAllDrafts,
     readInboxEmails: read_1.readInboxEmails,
     searchInboxByFilter: read_1.searchInboxByFilter,
     readSelectedEmail: read_1.readSelectedEmail,
@@ -66,12 +40,11 @@ const bridge = {
     listInboxFolders: folders_1.listInboxFolders,
     moveOutlookEmails: folders_1.moveOutlookEmails,
     listOutlookDrafts: drafts_1.listOutlookDrafts,
-    deleteOutlookDrafts: drafts_1.deleteOutlookDrafts,
     sendDrafts: drafts_1.sendDrafts,
+    sendAllDrafts: drafts_1.sendAllDrafts,
+    deleteOutlookDrafts: drafts_1.deleteOutlookDrafts,
     deleteOutlookEmails: cleanup_1.deleteOutlookEmails,
     purgeDeletedItems: cleanup_1.purgeDeletedItems,
-    saveEmailAttachment: attachments_1.saveEmailAttachment,
-    saveEmailAttachmentDetailed: attachments_1.saveEmailAttachmentDetailed,
     saveEmailAttachments: attachments_1.saveEmailAttachments,
     cleanUndeliverableEmails: bounces_1.cleanUndeliverableEmails,
     collectBouncedRecipients: bounces_1.collectBouncedRecipients,
@@ -82,39 +55,4 @@ const bridge = {
     saveTemplateEmail: templates_1.saveTemplateEmail,
     editEmailTemplate: templates_1.editEmailTemplate,
 };
-exports.bridge = bridge;
-// Re-exported one module at a time rather than by name: every feature module
-// here exports exactly its bridge functions and nothing else, so the name list
-// this replaces was a copy of the `bridge` literal above with no way to drift
-// from it usefully.
-__exportStar(require("./accounts"), exports);
-__exportStar(require("./send"), exports);
-__exportStar(require("./drafts"), exports);
-__exportStar(require("./read"), exports);
-__exportStar(require("./folders"), exports);
-__exportStar(require("./cleanup"), exports);
-__exportStar(require("./bounces"), exports);
-__exportStar(require("./attachments"), exports);
-__exportStar(require("./signatures"), exports);
-__exportStar(require("./templates"), exports);
-/**
- * What is ported to macOS.
- *
- * The whole contract is, now — the gaps this map existed to announce (replies,
- * drafts, attachments, deletion, templates, bounce handling and the Inbox-tree
- * search) are implemented against the AppleScript dictionary rather than
- * throwing NOT_IMPLEMENTED, so `NOT_PORTED` is empty and stays the place to
- * name one if that ever stops being true.
- *
- * Two differences survive that no capability flag can express, and a caller
- * moving between platforms has to know them:
- *  - **Ids are not portable.** macOS message ids are small integers, Windows
- *    EntryIDs are long MAPI strings; each platform rejects the other's. `storeId`
- *    has no macOS equivalent and is accepted-and-ignored throughout.
- *  - **`searchInboxByFilter` filters here, not in Outlook.** There is no
- *    AppleScript counterpart to COM's server-side `Items.Restrict`, so a
- *    `daysBack` of 0 over a large mailbox tree costs considerably more here.
- */
-const NOT_PORTED = [];
-exports.capabilities = (0, capabilities_1.capabilityMap)(bridge, NOT_PORTED);
 //# sourceMappingURL=index.js.map

package/dist/mac/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mac/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,4EAA4E;AAC5E,EAAE;AACF,sEAAsE;AACtE,kFAAkF;AAClF,gFAAgF;AAChF,2EAA2E;AAC3E,gFAAgF;AAChF,+EAA+E;AAC/E,+EAA+E;AAC/E,eAAe;AACf,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,qCAAqC;AACrC,gFAAgF;AAChF,mEAAmE;AACnE,iFAAiF;AACjF,2EAA2E;AAC3E,iEAAiE;AACjE,yCAAgD;AAChD,iCAA6D;AAC7D,qCAA6F;AAC7F,iCAAmH;AACnH,uCAAgE;AAChE,uCAAmE;AACnE,uCAAyG;AACzG,+CAAwG;AACxG,6CAA+E;AAC/E,2CAAuF;AACvF,yDAAuD;AAGvD;;;;;;;GAOG;AACH,MAAM,MAAM,GAAkB;IAC1B,kBAAkB,EAAlB,6BAAkB;IAClB,gBAAgB,EAAhB,uBAAgB;IAChB,iBAAiB,EAAjB,wBAAiB;IACjB,aAAa,EAAb,sBAAa;IACb,eAAe,EAAf,sBAAe;IACf,mBAAmB,EAAnB,0BAAmB;IACnB,iBAAiB,EAAjB,wBAAiB;IACjB,aAAa,EAAb,oBAAa;IACb,gBAAgB,EAAhB,uBAAgB;IAChB,gBAAgB,EAAhB,0BAAgB;IAChB,iBAAiB,EAAjB,2BAAiB;IACjB,iBAAiB,EAAjB,0BAAiB;IACjB,mBAAmB,EAAnB,4BAAmB;IACnB,UAAU,EAAV,mBAAU;IACV,mBAAmB,EAAnB,6BAAmB;IACnB,iBAAiB,EAAjB,2BAAiB;IACjB,mBAAmB,EAAnB,iCAAmB;IACnB,2BAA2B,EAA3B,yCAA2B;IAC3B,oBAAoB,EAApB,kCAAoB;IACpB,wBAAwB,EAAxB,kCAAwB;IACxB,wBAAwB,EAAxB,kCAAwB;IACxB,uBAAuB,EAAvB,iCAAuB;IACvB,qBAAqB,EAArB,kCAAqB;IACrB,wBAAwB,EAAxB,qCAAwB;IACxB,kBAAkB,EAAlB,8BAAkB;IAClB,iBAAiB,EAAjB,6BAAiB;IACjB,iBAAiB,EAAjB,6BAAiB;CACpB,CAAC;AAEO,wBAAM;AAEf,6EAA6E;AAC7E,+EAA+E;AAC/E,8EAA8E;AAC9E,oBAAoB;AACpB,6CAA2B;AAC3B,yCAAuB;AACvB,2CAAyB;AACzB,yCAAuB;AACvB,4CAA0B;AAC1B,4CAA0B;AAC1B,4CAA0B;AAC1B,gDAA8B;AAC9B,+CAA6B;AAC7B,8CAA4B;AAE5B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,GAAgC,EAAE,CAAC;AAEtC,QAAA,YAAY,GAAkB,IAAA,4BAAa,EAAC,MAAM,EAAE,UAAU,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mac/index.ts"],"names":[],"mappings":";;;AAAA,qEAAqE;AACrE,EAAE;AACF,kFAAkF;AAClF,iFAAiF;AACjF,+EAA+E;AAC/E,4EAA4E;AAC5E,8EAA8E;AAC9E,mBAAmB;AACnB,EAAE;AACF,sDAAsD;AACtD,gFAAgF;AAChF,qCAAqC;AACrC,+EAA+E;AAC/E,4DAA4D;AAC5D,gFAAgF;AAChF,8EAA8E;AAC9E,oBAAoB;AACpB,yCAAgD;AAChD,iCAA6D;AAC7D,iCAAkH;AAClH,uCAAgE;AAChE,qCAA6F;AAC7F,uCAAmE;AACnE,+CAAqD;AACrD,uCAAwG;AACxG,6CAA+E;AAC/E,2CAAuF;AAG1E,QAAA,UAAU,GAAY;IAC/B,kBAAkB,EAAlB,6BAAkB;IAClB,gBAAgB,EAAhB,uBAAgB;IAChB,iBAAiB,EAAjB,wBAAiB;IACjB,eAAe,EAAf,sBAAe;IACf,mBAAmB,EAAnB,0BAAmB;IACnB,iBAAiB,EAAjB,wBAAiB;IACjB,aAAa,EAAb,oBAAa;IACb,gBAAgB,EAAhB,uBAAgB;IAChB,gBAAgB,EAAhB,0BAAgB;IAChB,iBAAiB,EAAjB,2BAAiB;IACjB,iBAAiB,EAAjB,0BAAiB;IACjB,UAAU,EAAV,mBAAU;IACV,aAAa,EAAb,sBAAa;IACb,mBAAmB,EAAnB,4BAAmB;IACnB,mBAAmB,EAAnB,6BAAmB;IACnB,iBAAiB,EAAjB,2BAAiB;IACjB,oBAAoB,EAApB,kCAAoB;IACpB,wBAAwB,EAAxB,kCAAwB;IACxB,wBAAwB,EAAxB,kCAAwB;IACxB,uBAAuB,EAAvB,iCAAuB;IACvB,qBAAqB,EAArB,kCAAqB;IACrB,wBAAwB,EAAxB,qCAAwB;IACxB,kBAAkB,EAAlB,8BAAkB;IAClB,iBAAiB,EAAjB,6BAAiB;IACjB,iBAAiB,EAAjB,6BAAiB;CACpB,CAAC","sourcesContent":["// The macOS backend: Outlook driven through AppleScript (osascript).\n//\n// This targets LEGACY Outlook for Mac, which implements enough of the AppleScript\n// dictionary to enumerate accounts, read mailboxes, reply, file and delete mail.\n// New Outlook implements only a slice of it — accounts don't enumerate and the\n// inbox reports no messages — so there the account lookup finds nothing and\n// every operation fails loudly as ACCOUNT_NOT_FOUND rather than quietly doing\n// the wrong thing.\n//\n// Three dictionary traps are handled where they bite:\n//  - `move`/`delete`/`close` report success even when they do nothing, so every\n//    mutation confirms with a count.\n//  - A new outgoing message lands in Temporary Items; `open` only displays it,\n//    so a windowless draft is moved into Drafts explicitly.\n//  - One bad dictionary term fails the WHOLE script at compile time rather than\n//    at the offending line, which is why the root terms in scripts.ts are the\n//    verified ones.\nimport { getOutlookAccounts } from './accounts';\nimport { replyOutlookEmail, sendOutlookEmail } from './send';\nimport { openOutlookEmail, readEmailBody, readInboxEmails, readSelectedEmail, searchInboxByFilter } from './read';\nimport { listInboxFolders, moveOutlookEmails } from './folders';\nimport { deleteOutlookDrafts, listOutlookDrafts, sendAllDrafts, sendDrafts } from './drafts';\nimport { deleteOutlookEmails, purgeDeletedItems } from './cleanup';\nimport { saveEmailAttachments } from './attachments';\nimport { cleanUndeliverableEmails, collectBouncedRecipients, readSentRecipientGroups } from './bounces';\nimport { listOutlookSignatures, readOutlookSignatureHtml } from './signatures';\nimport { editEmailTemplate, readTemplateEmails, saveTemplateEmail } from './templates';\nimport type { Backend } from '../backend';\n\nexport const macBackend: Backend = {\n    getOutlookAccounts,\n    sendOutlookEmail,\n    replyOutlookEmail,\n    readInboxEmails,\n    searchInboxByFilter,\n    readSelectedEmail,\n    readEmailBody,\n    openOutlookEmail,\n    listInboxFolders,\n    moveOutlookEmails,\n    listOutlookDrafts,\n    sendDrafts,\n    sendAllDrafts,\n    deleteOutlookDrafts,\n    deleteOutlookEmails,\n    purgeDeletedItems,\n    saveEmailAttachments,\n    cleanUndeliverableEmails,\n    collectBouncedRecipients,\n    readSentRecipientGroups,\n    listOutlookSignatures,\n    readOutlookSignatureHtml,\n    readTemplateEmails,\n    saveTemplateEmail,\n    editEmailTemplate,\n};\n"]}

package/dist/mac/profile.d.ts

@@ -0,0 +1,13 @@
+/** One mail account as the profile database records it. */
+export interface ProfileAccount {
+    emailAccount: string;
+    /** AppleScript folder id per root term — the keys of `ROOT_SPECIAL_TYPES`. */
+    folderIds: Record<string, number>;
+}
+/**
+ * Every mail account the profile knows, whether or not AppleScript can see it.
+ *
+ * An account whose row is missing a given root simply has no id for it, and the
+ * caller keeps whatever the account probe would have done.
+ */
+export declare function readProfileAccounts(): Promise<ProfileAccount[]>;

package/dist/mac/profile.js

@@ -0,0 +1,149 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readProfileAccounts = readProfileAccounts;
+// Outlook's own profile database, read for the mailboxes the dictionary omits.
+//
+// `getOutlookAccounts` can only enumerate `exchange accounts`, `imap accounts`
+// and `pop accounts`, and a Microsoft 365 mailbox added by the modern sync
+// engine is none of those: Outlook files it in `AccountsMail` under a 'SHDO'
+// server type, publishes no account object for it, and answers `every account`
+// with -1728 rather than listing it. Even `account of <folder>` and
+// `account of <message>` come back `missing value` inside that mailbox's own
+// tree, so there is nothing to match an address against — the mailbox is
+// invisible to every function in this directory while its mail sits in plain
+// sight in the folder list.
+//
+// The folders themselves are reachable, because `mail folder id N` resolves
+// against the application rather than through an account, and N is exactly the
+// `Record_RecordID` Outlook's profile database gives that folder. So the
+// addresses AppleScript can't report, and the ids of their well-known folders,
+// are read from that database instead, and the generated scripts fall back to a
+// folder id wherever the account probe comes up empty.
+//
+// Strictly read-only, and never fatal: every failure here leaves the caller with
+// exactly what AppleScript could see on its own.
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+/** Where Outlook keeps its profiles, and the profile used when there are several. */
+const PROFILES_DIR = path_1.default.join(os_1.default.homedir(), 'Library', 'Group Containers', 'UBF8T346G9.Office', 'Outlook', 'Outlook 15 Profiles');
+const DEFAULT_PROFILE = 'Main Profile';
+/**
+ * `Folder_SpecialFolderType` for each root the generated scripts ask for, keyed
+ * by the dictionary term `MAC_ROOT_TERMS` resolves.
+ *
+ * These are Outlook's own numbering, confirmed against a profile's local "On My
+ * Computer" store, where every one of them appears exactly once: 1 Inbox,
+ * 2 Outbox, 8 Sent Items, 9 Deleted Items, 10 Drafts, 12 Junk, 99 the account
+ * root. Outbox is left out: a caller can still name it (`MAC_ROOT_TERMS` maps it),
+ * but nothing here files mail into one, so it is not worth an id — that request
+ * falls back to the account probe like any root the profile has no row for.
+ */
+const ROOT_SPECIAL_TYPES = {
+    'inbox': 1,
+    'sent items': 8,
+    'deleted items': 9,
+    'drafts': 10,
+    'junk mail': 12,
+    'root folder': 99,
+};
+/** Column separator for the query output - a unit separator cannot occur in a row. */
+const SEP = '\x1f';
+/**
+ * Address and well-known folder ids for every mail account in the profile.
+ *
+ * `Record_AccountUID` is a tagged id — the account's `Record_RecordID` in its low
+ * 32 bits, a table tag above — so the join masks rather than assuming the tag,
+ * and drops UID 0, which is the local "On My Computer" store rather than an
+ * account.
+ */
+const ACCOUNTS_SQL = `
+    SELECT a.Account_EmailAddress, f.Folder_SpecialFolderType, f.Record_RecordID
+    FROM AccountsMail a
+             JOIN Folders f ON (f.Record_AccountUID & 4294967295) = a.Record_RecordID
+    WHERE f.Record_AccountUID <> 0
+      AND a.Account_EmailAddress IS NOT NULL
+      AND a.Account_EmailAddress <> ''
+      AND f.Folder_SpecialFolderType IN (${Object.values(ROOT_SPECIAL_TYPES).join(', ')})
+    ORDER BY a.Record_RecordID, f.Folder_SpecialFolderType`;
+/** The profile whose database to read, or '' when there is none to read. */
+function profileDatabase() {
+    let names;
+    try {
+        names = fs_1.default.readdirSync(PROFILES_DIR);
+    }
+    catch {
+        return '';
+    }
+    // Outlook records no "default profile" anywhere reachable — not in its
+    // preferences, not beside the profiles — so with more than one the newest
+    // wins, after the name Outlook itself creates and all but everyone keeps.
+    const dbOf = (name) => path_1.default.join(PROFILES_DIR, name, 'Data', 'Outlook.sqlite');
+    // Outlook rewrites these files while it runs, and the whole directory sits
+    // behind macOS privacy control, so a database that existed a moment ago need
+    // not stat. An unreadable timestamp sorts last rather than throwing: this
+    // runs on nearly every macOS operation (resolveMacAccount), and a mailbox
+    // AppleScript could have named on its own must not be lost to it.
+    const mtimeOf = (db) => {
+        try {
+            return fs_1.default.statSync(db).mtimeMs;
+        }
+        catch {
+            return -Infinity;
+        }
+    };
+    const candidates = names
+        .map(dbOf)
+        .filter(db => fs_1.default.existsSync(db))
+        .sort((a, b) => mtimeOf(b) - mtimeOf(a));
+    const preferred = dbOf(DEFAULT_PROFILE);
+    if (candidates.includes(preferred))
+        return preferred;
+    return candidates[0] ?? '';
+}
+/** Run one read-only query, or return '' if anything at all gets in the way. */
+function query(database, sql) {
+    return new Promise(resolve => {
+        (0, child_process_1.execFile)('sqlite3', ['-readonly', '-list', '-noheader', '-separator', SEP, database, sql], { timeout: 5000, maxBuffer: 1024 * 1024 }, (error, stdout) => resolve(error ? '' : stdout));
+    });
+}
+/**
+ * Every mail account the profile knows, whether or not AppleScript can see it.
+ *
+ * An account whose row is missing a given root simply has no id for it, and the
+ * caller keeps whatever the account probe would have done.
+ */
+async function readProfileAccounts() {
+    try {
+        return await readAccounts();
+    }
+    catch {
+        // The module's contract, enforced at its one exit: this is an enrichment
+        // pass over what AppleScript already found, so nothing that happens in it
+        // is worth failing an operation that would otherwise have worked.
+        return [];
+    }
+}
+async function readAccounts() {
+    const database = profileDatabase();
+    if (!database)
+        return [];
+    const termOf = new Map(Object.entries(ROOT_SPECIAL_TYPES).map(([term, type]) => [type, term]));
+    const byAddress = new Map();
+    for (const line of (await query(database, ACCOUNTS_SQL)).split('\n')) {
+        const [address, specialType, folderId] = line.split(SEP);
+        const term = termOf.get(Number(specialType));
+        if (!address || !term || !/^\d+$/.test(folderId ?? ''))
+            continue;
+        const account = byAddress.get(address.toLowerCase())
+            ?? { emailAccount: address, folderIds: {} };
+        account.folderIds[term] = Number(folderId);
+        byAddress.set(address.toLowerCase(), account);
+    }
+    return [...byAddress.values()];
+}
+//# sourceMappingURL=profile.js.map

package/dist/mac/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/mac/profile.ts"],"names":[],"mappings":"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","sourcesContent":["// Outlook's own profile database, read for the mailboxes the dictionary omits.\n//\n// `getOutlookAccounts` can only enumerate `exchange accounts`, `imap accounts`\n// and `pop accounts`, and a Microsoft 365 mailbox added by the modern sync\n// engine is none of those: Outlook files it in `AccountsMail` under a 'SHDO'\n// server type, publishes no account object for it, and answers `every account`\n// with -1728 rather than listing it. Even `account of <folder>` and\n// `account of <message>` come back `missing value` inside that mailbox's own\n// tree, so there is nothing to match an address against — the mailbox is\n// invisible to every function in this directory while its mail sits in plain\n// sight in the folder list.\n//\n// The folders themselves are reachable, because `mail folder id N` resolves\n// against the application rather than through an account, and N is exactly the\n// `Record_RecordID` Outlook's profile database gives that folder. So the\n// addresses AppleScript can't report, and the ids of their well-known folders,\n// are read from that database instead, and the generated scripts fall back to a\n// folder id wherever the account probe comes up empty.\n//\n// Strictly read-only, and never fatal: every failure here leaves the caller with\n// exactly what AppleScript could see on its own.\nimport { execFile } from 'child_process';\nimport fs from 'fs';\nimport os from 'os';\nimport path from 'path';\n\n/** Where Outlook keeps its profiles, and the profile used when there are several. */\nconst PROFILES_DIR = path.join(\n    os.homedir(),\n    'Library', 'Group Containers', 'UBF8T346G9.Office', 'Outlook', 'Outlook 15 Profiles',\n);\nconst DEFAULT_PROFILE = 'Main Profile';\n\n/**\n * `Folder_SpecialFolderType` for each root the generated scripts ask for, keyed\n * by the dictionary term `MAC_ROOT_TERMS` resolves.\n *\n * These are Outlook's own numbering, confirmed against a profile's local \"On My\n * Computer\" store, where every one of them appears exactly once: 1 Inbox,\n * 2 Outbox, 8 Sent Items, 9 Deleted Items, 10 Drafts, 12 Junk, 99 the account\n * root. Outbox is left out: a caller can still name it (`MAC_ROOT_TERMS` maps it),\n * but nothing here files mail into one, so it is not worth an id — that request\n * falls back to the account probe like any root the profile has no row for.\n */\nconst ROOT_SPECIAL_TYPES: Readonly<Record<string, number>> = {\n    'inbox': 1,\n    'sent items': 8,\n    'deleted items': 9,\n    'drafts': 10,\n    'junk mail': 12,\n    'root folder': 99,\n};\n\n/** One mail account as the profile database records it. */\nexport interface ProfileAccount {\n    emailAccount: string;\n    /** AppleScript folder id per root term — the keys of `ROOT_SPECIAL_TYPES`. */\n    folderIds: Record<string, number>;\n}\n\n/** Column separator for the query output - a unit separator cannot occur in a row. */\nconst SEP = '\\x1f';\n\n/**\n * Address and well-known folder ids for every mail account in the profile.\n *\n * `Record_AccountUID` is a tagged id — the account's `Record_RecordID` in its low\n * 32 bits, a table tag above — so the join masks rather than assuming the tag,\n * and drops UID 0, which is the local \"On My Computer\" store rather than an\n * account.\n */\nconst ACCOUNTS_SQL = `\n    SELECT a.Account_EmailAddress, f.Folder_SpecialFolderType, f.Record_RecordID\n    FROM AccountsMail a\n             JOIN Folders f ON (f.Record_AccountUID & 4294967295) = a.Record_RecordID\n    WHERE f.Record_AccountUID <> 0\n      AND a.Account_EmailAddress IS NOT NULL\n      AND a.Account_EmailAddress <> ''\n      AND f.Folder_SpecialFolderType IN (${Object.values(ROOT_SPECIAL_TYPES).join(', ')})\n    ORDER BY a.Record_RecordID, f.Folder_SpecialFolderType`;\n\n/** The profile whose database to read, or '' when there is none to read. */\nfunction profileDatabase(): string {\n    let names: string[];\n    try {\n        names = fs.readdirSync(PROFILES_DIR);\n    } catch {\n        return '';\n    }\n    // Outlook records no \"default profile\" anywhere reachable — not in its\n    // preferences, not beside the profiles — so with more than one the newest\n    // wins, after the name Outlook itself creates and all but everyone keeps.\n    const dbOf = (name: string) => path.join(PROFILES_DIR, name, 'Data', 'Outlook.sqlite');\n    // Outlook rewrites these files while it runs, and the whole directory sits\n    // behind macOS privacy control, so a database that existed a moment ago need\n    // not stat. An unreadable timestamp sorts last rather than throwing: this\n    // runs on nearly every macOS operation (resolveMacAccount), and a mailbox\n    // AppleScript could have named on its own must not be lost to it.\n    const mtimeOf = (db: string) => {\n        try {\n            return fs.statSync(db).mtimeMs;\n        } catch {\n            return -Infinity;\n        }\n    };\n    const candidates = names\n        .map(dbOf)\n        .filter(db => fs.existsSync(db))\n        .sort((a, b) => mtimeOf(b) - mtimeOf(a));\n    const preferred = dbOf(DEFAULT_PROFILE);\n    if (candidates.includes(preferred)) return preferred;\n    return candidates[0] ?? '';\n}\n\n/** Run one read-only query, or return '' if anything at all gets in the way. */\nfunction query(database: string, sql: string): Promise<string> {\n    return new Promise(resolve => {\n        execFile(\n            'sqlite3',\n            ['-readonly', '-list', '-noheader', '-separator', SEP, database, sql],\n            {timeout: 5000, maxBuffer: 1024 * 1024},\n            (error, stdout) => resolve(error ? '' : stdout),\n        );\n    });\n}\n\n/**\n * Every mail account the profile knows, whether or not AppleScript can see it.\n *\n * An account whose row is missing a given root simply has no id for it, and the\n * caller keeps whatever the account probe would have done.\n */\nexport async function readProfileAccounts(): Promise<ProfileAccount[]> {\n    try {\n        return await readAccounts();\n    } catch {\n        // The module's contract, enforced at its one exit: this is an enrichment\n        // pass over what AppleScript already found, so nothing that happens in it\n        // is worth failing an operation that would otherwise have worked.\n        return [];\n    }\n}\n\nasync function readAccounts(): Promise<ProfileAccount[]> {\n    const database = profileDatabase();\n    if (!database) return [];\n    const termOf = new Map(Object.entries(ROOT_SPECIAL_TYPES).map(([term, type]) => [type, term]));\n    const byAddress = new Map<string, ProfileAccount>();\n    for (const line of (await query(database, ACCOUNTS_SQL)).split('\\n')) {\n        const [address, specialType, folderId] = line.split(SEP);\n        const term = termOf.get(Number(specialType));\n        if (!address || !term || !/^\\d+$/.test(folderId ?? '')) continue;\n        const account = byAddress.get(address.toLowerCase())\n            ?? {emailAccount: address, folderIds: {}};\n        account.folderIds[term] = Number(folderId);\n        byAddress.set(address.toLowerCase(), account);\n    }\n    return [...byAddress.values()];\n}\n"]}

package/dist/mac/read.d.ts

@@ -1,48 +1,28 @@
-import type { EmailBodyResult, InboxEmail, InboxSearchFilter, InboxSearchMatch, SelectedEmail } from '../types';
+import type { RawEmail, ReadInboxRequest, SearchRequest } from '../backend';
+import type { EmailLocator, InboxEmail, InboxSearchMatch, SelectedEmail } from '../types';
 /**
- * Read recent messages for the given account, newest first.
- *
- * `entryId` here is Outlook for Mac's small integer message id (e.g. "779"), not
- * the MAPI EntryID string Windows returns. The two are not interchangeable, so
- * don't persist one and look it up on the other platform.
+ * Recent mail from the Inbox root or one folder, newest first. Entry ids here
+ * are Outlook for Mac's integer message ids, not Windows EntryIDs.
  */
-export declare function readInboxEmails(emailAccount: string, daysBack?: number, limit?: number, folder?: string): Promise<InboxEmail[]>;
+export declare function readInboxEmails(request: ReadInboxRequest): Promise<InboxEmail[]>;
 /**
- * Read one email's full plain-text body by message id.
- *
- * `storeId` is accepted for signature parity and ignored: macOS has no StoreID,
- * and `message id N` resolves against the application rather than one folder, so
- * the message is found wherever it currently sits — including a subfolder.
- *
- * Uses `plain text content`, matching the Windows reader's use of `.Body`: the
- * same tradeoff applies, so an HTML table's rows flatten and tabular figures are
- * better read from an attachment.
+ * One email's full plain-text body. `storeId` has no macOS meaning: `message id
+ * N` resolves against the application, wherever the message sits.
  */
-export declare function readEmailBody(entryId: string, _storeId?: string, maxChars?: number, includeQuoted?: boolean): Promise<EmailBodyResult>;
+export declare function readEmailBody(email: EmailLocator): Promise<RawEmail>;
 /**
- * Walk every folder under the Inbox (recursively) for one account and return the
- * emails matching `filter` — full body included, attachments listed by name but
- * not saved.
+ * Walk every folder under the Inbox for the mail matching the request.
  *
- * The filtering happens here rather than in Outlook: `Items.Restrict` is a COM
- * facility with no AppleScript counterpart, so the folder walk indexes each
- * folder in two bulk reads and the subject/date tests run on the index. The
- * observable contract is the same; the cost profile is not, and a `daysBack` of
- * 0 over a large mailbox tree is correspondingly heavier here.
- *
- * `subjectPattern` is applied case-insensitively regardless of the RegExp's own
- * flags, matching PowerShell's `-match`.
+ * The filtering happens here rather than in Outlook: there is no AppleScript
+ * counterpart to COM's server-side `Items.Restrict`, so each folder is indexed in
+ * bulk reads and the subject and date tests run on the index. The results match
+ * Windows; the cost doesn't, and a wide window over a big tree is heavier here.
  */
-export declare function searchInboxByFilter(emailAccount: string, filter?: InboxSearchFilter, daysBack?: number): Promise<InboxSearchMatch[]>;
+export declare function searchInboxByFilter(request: SearchRequest): Promise<InboxSearchMatch[]>;
 /**
- * Read the email currently selected (or open) in Outlook — full body,
- * attachments listed by name but not saved.
- *
- * `current messages` covers both cases the Windows reader handles separately
- * (an explorer selection and an open item), so there is no second lookup here.
+ * The email currently selected — or open — in Outlook. `current messages`
+ * covers both cases the Windows reader handles separately.
  */
 export declare function readSelectedEmail(): Promise<SelectedEmail>;
-/** Open an email in Outlook by its message id, and bring Outlook forward.
- *  `_storeId` is accepted for parity with Windows and ignored — macOS
- *  AppleScript has no StoreID (see `readEmailBody`). */
-export declare function openOutlookEmail(entryId: string, _storeId?: string): Promise<void>;
+/** Open an email in Outlook and bring Outlook forward. */
+export declare function openOutlookEmail(email: EmailLocator): Promise<void>;