@dawnlit/outlook-bridge 1.0.0

package/dist/mac/scripts.js

@@ -0,0 +1,337 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIST_ACCOUNTS_SNIPPET = exports.FIND_FOLDER_HANDLER = exports.MessageDetail = exports.MAC_ROOT_TERMS = void 0;
+exports.accountLookupSnippet = accountLookupSnippet;
+exports.dateProperty = dateProperty;
+exports.macFolderPath = macFolderPath;
+exports.rootTerm = rootTerm;
+exports.mailScopeSnippet = mailScopeSnippet;
+exports.macMessageId = macMessageId;
+exports.partitionMessageIds = partitionMessageIds;
+exports.messageLookupSnippet = messageLookupSnippet;
+exports.senderSnippet = senderSnippet;
+exports.messageDetailSnippet = messageDetailSnippet;
+exports.messageDetailFields = messageDetailFields;
+exports.firstRecipientSnippet = firstRecipientSnippet;
+exports.allRecipientsSnippet = allRecipientsSnippet;
+// The AppleScript fragments more than one macOS operation is built from.
+const run_1 = require("./run");
+const errors_1 = require("../errors");
+const mail_1 = require("../mail");
+/**
+ * Resolve the account whose SMTP address matches, or raise. Emitted into a
+ * `tell application "Microsoft Outlook"` block; binds `targetAcct`.
+ *
+ * `every account` errors even in legacy mode, so probe the typed classes. A
+ * `whose email address is ...` filter can't be used either: `email address` is
+ * also a class name, and AppleScript resolves it as one ("into type specifier").
+ *
+ * The thrown sentence is the one `classifyRunFailure` recognises to raise
+ * `AccountNotFoundError`, so its wording is load-bearing.
+ */
+function accountLookupSnippet(emailAccount) {
+    return `    set targetAcct to missing value
+    try
+        repeat with a in (exchange accounts & imap accounts & pop accounts)
+            if (email address of a as string) is "${(0, run_1.asEscape)(emailAccount)}" then
+                set targetAcct to a
+                exit repeat
+            end if
+        end repeat
+    end try
+    if targetAcct is missing value then error "Account '${(0, run_1.asEscape)(emailAccount)}' not found"`;
+}
+/**
+ * Outlook for Mac's dictionary term for each well-known root, keyed by the
+ * olDefaultFolders id `mailFolderRef` resolves.
+ *
+ * Verified against the running app. The terms are NOT the ones the Windows ids
+ * suggest — `sent mail` and `junk email` do not compile at all, while
+ * `sent items` and `junk mail` do, and a bad term fails the whole script at
+ * compile time rather than at the offending line.
+ */
+exports.MAC_ROOT_TERMS = {
+    6: 'inbox',
+    5: 'sent items',
+    16: 'drafts',
+    3: 'deleted items',
+    4: 'outbox',
+    23: 'junk mail',
+};
+/** The date property a folder's items actually carry. */
+function dateProperty(rootId) {
+    return (0, mail_1.isOutgoingRoot)(rootId) ? 'time sent' : 'time received';
+}
+/**
+ * The Windows `FolderPath` shape (`\\mailbox\Inbox\Invoices`), built here rather
+ * than in AppleScript — escaping backslashes through a template literal and then
+ * an AppleScript literal is unreadable, and TS already knows the parts.
+ */
+function macFolderPath(emailAccount, rootLabel, segments) {
+    return ['\\\\' + emailAccount, rootLabel, ...segments].join('\\');
+}
+/** The dictionary term for a root, or a NOT_IMPLEMENTED naming what was asked. */
+function rootTerm(ref, folderLabel = '') {
+    const term = exports.MAC_ROOT_TERMS[ref.rootId];
+    if (!term) {
+        const asked = folderLabel ? ` (asked for '${folderLabel}')` : '';
+        throw new errors_1.NotImplementedError(`folder root '${ref.rootLabel}'${asked}`, `macOS — readable roots are ${Object.values(exports.MAC_ROOT_TERMS).join(', ')}`);
+    }
+    return term;
+}
+/**
+ * Emit the AppleScript that resolves `scopeFolder` from `targetAcct`, walking a
+ * well-known root down through any further path segments. Also binds
+ * `scopeCreated`.
+ *
+ * Folder names are compared with `is`, which is case-insensitive in AppleScript —
+ * matching the Windows walk's `-ieq` so 'invoices' finds 'Invoices' on both.
+ * A missing segment errors by name instead of falling back to the root: silently
+ * returning the Inbox for a caller that scoped to one folder hands back the wrong
+ * emails under a name that says otherwise. `createMissing` builds the whole
+ * chain instead, so a nested destination is one call.
+ */
+function mailScopeSnippet(ref, folderLabel = '', createMissing = false) {
+    const term = rootTerm(ref, folderLabel);
+    const walk = ref.segments.map(seg => `
+    set foundFolder to missing value
+    repeat with sf in (mail folders of scopeFolder)
+        if (name of sf as string) is "${(0, run_1.asEscape)(seg)}" then
+            set foundFolder to sf
+            exit repeat
+        end if
+    end repeat
+    if foundFolder is missing value then
+        if ${(0, run_1.asBool)(createMissing)} then
+            set foundFolder to (make new mail folder at scopeFolder with properties {name:"${(0, run_1.asEscape)(seg)}"})
+            set scopeCreated to true
+        else
+            error "Folder '${(0, run_1.asEscape)(seg)}' not found under '${(0, run_1.asEscape)(ref.rootLabel)}'"
+        end if
+    end if
+    set scopeFolder to foundFolder`).join('');
+    return `    set scopeCreated to false
+    set scopeFolder to ${term} of targetAcct${walk}`;
+}
+/**
+ * The message-id text for a script, or an InvalidRequestError.
+ *
+ * Outlook for Mac ids are small integers; a Windows MAPI EntryID is rejected up
+ * front rather than left to fail as a confusing "not found", because a caller
+ * that persisted one from a Windows run needs to be told exactly that.
+ */
+function macMessageId(entryId) {
+    const id = String(entryId ?? '').trim();
+    if (!/^\d+$/.test(id)) {
+        throw new errors_1.InvalidRequestError(`'${entryId}' is not an Outlook for Mac message id. Mac ids are small integers `
+            + `(e.g. "1263") returned by readInboxEmails on this machine; a Windows MAPI `
+            + `EntryID cannot be resolved here.`);
+    }
+    return id;
+}
+/**
+ * Split ids into the ones a script can look up and the ones that can only fail.
+ *
+ * The per-id operations report failures rather than throwing, so an unusable id
+ * belongs in the result's `failed` list beside a genuine lookup miss — not as an
+ * exception that discards the ids that would have worked.
+ */
+function partitionMessageIds(entryIds) {
+    const valid = [];
+    const invalid = [];
+    for (const entryId of entryIds) {
+        try {
+            valid.push(macMessageId(entryId));
+        }
+        catch (error) {
+            invalid.push({ entryId: String(entryId), error: error.message });
+        }
+    }
+    return { valid, invalid };
+}
+/**
+ * Resolve `theMsg` from a macOS message id, or raise.
+ *
+ * `message id N` resolves against the application rather than one folder, so the
+ * message is found wherever it currently sits — including a subfolder.
+ */
+function messageLookupSnippet(id, variable = 'theMsg') {
+    return `    set ${variable} to missing value
+    try
+        set ${variable} to message id ${id}
+    end try
+    if ${variable} is missing value then error "Email not found for message id '${id}'"`;
+}
+/**
+ * The sender's display name and address, as `sndName` / `sndAddr`.
+ *
+ * `sender` yields a record, and `address of sender of m` fails to coerce, so the
+ * record has to be bound first. `name` is absent when there is no display name.
+ */
+function senderSnippet(messageVariable = 'theMsg', indent = '    ') {
+    return `${indent}set sndName to ""
+${indent}set sndAddr to ""
+${indent}try
+${indent}    set snd to sender of ${messageVariable}
+${indent}    try
+${indent}        set sndAddr to (address of snd) as string
+${indent}    end try
+${indent}    try
+${indent}        set sndName to (name of snd) as string
+${indent}    end try
+${indent}end try`;
+}
+/**
+ * Everything a reader wants off ONE message already bound to `theMsg`, and the
+ * row it produces — emitted together so the read order and the positions the
+ * TypeScript decoders index into cannot drift apart.
+ *
+ * Three callers share it (`readEmailBody`, `readSelectedEmail`, and the
+ * attachment resolver) and differ only in how they bind `theMsg`. They used to
+ * share it by copy: thirty lines repeated, with the `time received` → `time sent`
+ * fallback and the field order restated each time, so a dictionary fix reached
+ * one reader and not the others.
+ *
+ * `bodyText` is emitted LAST when asked for, so a stray separator in an earlier
+ * field cannot shift it.
+ */
+function messageDetailSnippet(withBody = false, indent = '    ') {
+    return `${indent}set subj to ""
+${indent}try
+${indent}    set subj to (subject of theMsg) as string
+${indent}end try
+${senderSnippet('theMsg', indent)}
+${indent}set recvd to ""
+${indent}try
+${indent}    set recvd to my isoDate(time received of theMsg)
+${indent}on error
+${indent}    try
+${indent}        set recvd to my isoDate(time sent of theMsg)
+${indent}    end try
+${indent}end try
+${indent}set attNames to {}
+${indent}try
+${indent}    set attNames to name of every attachment of theMsg
+${indent}end try` + (withBody ? `
+${indent}set bodyText to ""
+${indent}try
+${indent}    set bodyText to (plain text content of theMsg) as string
+${indent}end try` : '');
+}
+/**
+ * The fields `messageDetailSnippet` fills, in row order. The decoders read them
+ * back by the positions in `MessageDetail`.
+ */
+function messageDetailFields(withBody = false) {
+    const fields = [
+        '(id of theMsg as string)',
+        'subj',
+        'sndName',
+        'sndAddr',
+        'recvd',
+        'my sanitizeList(attNames)',
+    ];
+    if (withBody)
+        fields.push('bodyText');
+    return fields;
+}
+/** Where each of those fields lands in the emitted row. */
+exports.MessageDetail = {
+    id: 0,
+    subject: 1,
+    senderName: 2,
+    senderEmail: 3,
+    receivedTime: 4,
+    attachmentNames: 5,
+    body: 6,
+};
+/**
+ * The first recipient's name and address, as `sndName` / `sndAddr` — what
+ * outgoing mail reports in place of a sender, matching the Windows reader's
+ * contract for Sent Items (a folder of mail from yourself is unreadable).
+ */
+function firstRecipientSnippet(messageVariable = 'theMsg', indent = '    ') {
+    return `${indent}set sndName to ""
+${indent}set sndAddr to ""
+${indent}try
+${indent}    set rcps to to recipients of ${messageVariable}
+${indent}    if (count of rcps) > 0 then
+${indent}        set ea to email address of (item 1 of rcps)
+${indent}        try
+${indent}            set sndAddr to (address of ea) as string
+${indent}        end try
+${indent}        try
+${indent}            set sndName to (name of ea) as string
+${indent}        end try
+${indent}    end if
+${indent}end try`;
+}
+/**
+ * Every SMTP address a message was addressed to, as the list `addrList`.
+ *
+ * `every recipient` covers To, CC and BCC — the full set, which is the whole
+ * point of readSentRecipientGroups.
+ */
+function allRecipientsSnippet(messageVariable = 'theMsg', indent = '    ') {
+    return `${indent}set addrList to {}
+${indent}try
+${indent}    repeat with r in (every recipient of ${messageVariable})
+${indent}        try
+${indent}            -- The record has to be bound before its field is read: a nested
+${indent}            -- 'address of (email address of r)' does not coerce, and fails
+${indent}            -- inside the try as an empty recipient list rather than an error.
+${indent}            set ea to email address of r
+${indent}            set oneAddr to (address of ea) as string
+${indent}            if oneAddr is not "" then set end of addrList to oneAddr
+${indent}        end try
+${indent}    end repeat
+${indent}end try`;
+}
+/**
+ * Recursive folder-by-name search from `startFolder`, case-insensitive and
+ * depth-capped — the macOS counterpart of the Windows Find-FolderByName, used to
+ * resolve a template folder anywhere in the mailbox tree.
+ */
+exports.FIND_FOLDER_HANDLER = `
+on findFolderByName(startFolder, wantedName, depth)
+    tell application "Microsoft Outlook"
+        set subs to mail folders of startFolder
+    end tell
+    repeat with f in subs
+        if (name of f as string) is wantedName then return f
+    end repeat
+    if depth is less than or equal to 1 then return missing value
+    repeat with f in subs
+        set hit to my findFolderByName(f, wantedName, depth - 1)
+        if hit is not missing value then return hit
+    end repeat
+    return missing value
+end findFolderByName
+`;
+/**
+ * Account enumeration only works when Outlook runs in legacy mode; New Outlook
+ * errors on `every account` and returns empty lists for the typed classes, so
+ * each class is probed independently and failures are ignored.
+ */
+exports.LIST_ACCOUNTS_SNIPPET = `
+set acctList to {}
+tell application "Microsoft Outlook"
+    repeat with acctClass in {"exchange", "imap", "pop"}
+        try
+            if (acctClass as string) is "exchange" then
+                set accts to exchange accounts
+            else if (acctClass as string) is "imap" then
+                set accts to imap accounts
+            else
+                set accts to pop accounts
+            end if
+            repeat with a in accts
+                try
+                    set end of acctList to (email address of a as string)
+                end try
+            end repeat
+        end try
+    end repeat
+end tell
+`;
+//# sourceMappingURL=scripts.js.map

package/dist/mac/scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../../src/mac/scripts.ts"],"names":[],"mappings":"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"}

package/dist/mac/send.d.ts

@@ -0,0 +1,23 @@
+import type { ReplyEmailParams, ReplyEmailResult, SendEmailParams } from '../types';
+/**
+ * Create an Outlook email as a draft window (or send it) via AppleScript.
+ * Mirrors the Windows COM contract from windows/send.ts.
+ */
+export declare function sendOutlookEmail(params: SendEmailParams): Promise<void>;
+/**
+ * Reply to an email, inserting the caller's HTML above the quoted original.
+ *
+ * `entryId` is Outlook for Mac's small integer message id (see readInboxEmails),
+ * not a Windows MAPI EntryID; `storeId` is accepted for signature parity and
+ * ignored, since macOS has no StoreID and `message id N` resolves against the
+ * application rather than one folder.
+ *
+ * `reply to` builds the quoted body Outlook itself would have — the same thing
+ * COM's Reply() returns — so the insertion point is the one place the two
+ * platforms have to agree, and both look for WordSection1 then `<body>`.
+ *
+ * The `to` line is the reply's resolved recipient addresses rather than the
+ * display-name string Windows reports: Outlook for Mac exposes recipients as
+ * records, and an address is the more useful half to verify against.
+ */
+export declare function replyOutlookEmail(params: ReplyEmailParams): Promise<ReplyEmailResult>;

package/dist/mac/send.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendOutlookEmail = sendOutlookEmail;
+exports.replyOutlookEmail = replyOutlookEmail;
+// Composing outgoing mail on macOS: a new email, and a reply to an existing one.
+const run_1 = require("./run");
+const scripts_1 = require("./scripts");
+const replyBody_1 = require("../shared/replyBody");
+const signatures_1 = require("./signatures");
+const templates_1 = require("./templates");
+/** Split a To/CC string the way the Windows contract accepts it. */
+function splitAddresses(s) {
+    return s.split(/[,;]+/).map(x => x.trim()).filter(Boolean);
+}
+/**
+ * What to do with a composed item.
+ *
+ * A new outgoing message lands in Temporary Items, not Drafts — `open` is what
+ * surfaces it, so a windowless draft has to be moved into the Drafts folder
+ * explicitly. (`save` is no help: it demands a file destination, not a folder.)
+ * `move` reports success even where it silently does nothing, so the folder is
+ * confirmed to have grown rather than risk reporting a draft that doesn't exist.
+ */
+function composeAction(variable, sendImmediately, openDraftWindow) {
+    if (sendImmediately)
+        return { prelude: '', action: `    send ${variable}` };
+    if (openDraftWindow !== false)
+        return { prelude: '', action: `    open ${variable}` };
+    return {
+        prelude: `    set draftsFolder to drafts of targetAcct
+    set draftsBefore to count of messages of draftsFolder`,
+        action: `    move ${variable} to draftsFolder
+    if (count of messages of draftsFolder) is not greater than draftsBefore then error "Outlook did not file the draft in the Drafts folder."`,
+    };
+}
+/**
+ * Create an Outlook email as a draft window (or send it) via AppleScript.
+ * Mirrors the Windows COM contract from windows/send.ts.
+ */
+async function sendOutlookEmail(params) {
+    // Same safety property as Windows: never silently send from the wrong mailbox.
+    // The account lookup raises when the address doesn't resolve, so there's no
+    // pre-flight getOutlookAccounts() round-trip — it cost an extra osascript
+    // launch on every email in a batch.
+    const recipientLines = [
+        ...splitAddresses(params.to).map(addr => `    make new to recipient at newMsg with properties {email address:{address:"${(0, run_1.asEscape)(addr)}"}}`),
+        ...splitAddresses(params.cc || '').map(addr => `    make new cc recipient at newMsg with properties {email address:{address:"${(0, run_1.asEscape)(addr)}"}}`),
+    ].join('\n');
+    const attachLine = params.attachmentPath
+        ? `    make new attachment at newMsg with properties {file:POSIX file "${(0, run_1.asEscape)(params.attachmentPath)}"}`
+        : '';
+    const { prelude, action } = composeAction('newMsg', params.sendImmediately, params.openDraftWindow);
+    const script = `
+tell application "Microsoft Outlook"
+${(0, scripts_1.accountLookupSnippet)(params.emailAccount)}
+${prelude}
+    set newMsg to make new outgoing message with properties {subject:"${(0, run_1.asEscape)(params.subject)}", content:"${(0, run_1.asEscape)(params.htmlBody)}"}
+${recipientLines}
+    set account of newMsg to targetAcct
+${attachLine}
+${action}
+end tell`;
+    await (0, run_1.runOsaScript)(script, 120000);
+}
+/**
+ * Reply to an email, inserting the caller's HTML above the quoted original.
+ *
+ * `entryId` is Outlook for Mac's small integer message id (see readInboxEmails),
+ * not a Windows MAPI EntryID; `storeId` is accepted for signature parity and
+ * ignored, since macOS has no StoreID and `message id N` resolves against the
+ * application rather than one folder.
+ *
+ * `reply to` builds the quoted body Outlook itself would have — the same thing
+ * COM's Reply() returns — so the insertion point is the one place the two
+ * platforms have to agree, and both look for WordSection1 then `<body>`.
+ *
+ * The `to` line is the reply's resolved recipient addresses rather than the
+ * display-name string Windows reports: Outlook for Mac exposes recipients as
+ * records, and an address is the more useful half to verify against.
+ */
+async function replyOutlookEmail(params) {
+    const id = (0, scripts_1.macMessageId)(params.entryId);
+    const insertHtml = await (0, replyBody_1.composeReplyHtml)(params, {
+        readTemplateEmails: templates_1.readTemplateEmails,
+        readOutlookSignatureHtml: signatures_1.readOutlookSignatureHtml,
+        listOutlookSignatures: signatures_1.listOutlookSignatures,
+    });
+    const { prelude, action } = composeAction('theReply', params.sendImmediately, params.openDraftWindow);
+    const replyAll = params.replyAll ? 'reply to all true' : 'without reply to all';
+    const script = `tell application "Microsoft Outlook"
+${(0, scripts_1.accountLookupSnippet)(params.emailAccount)}
+${(0, scripts_1.messageLookupSnippet)(id)}
+    set repliedTo to ""
+    try
+        -- Bind the record before reading its field: a nested
+        -- 'address of (sender of theMsg)' does not coerce.
+        set origSender to sender of theMsg
+        set repliedTo to (address of origSender) as string
+    end try
+${prelude}
+    set theReply to reply to theMsg opening window false ${replyAll}
+    -- Neither of these is wrapped in a try, and both would read more defensively
+    -- if they were. A swallowed account assignment sends from whichever mailbox
+    -- Outlook considers default, and a swallowed insertion files a reply with the
+    -- caller's text missing — the two failures this package exists to prevent,
+    -- both of them invisible to the caller if tolerated here.
+    set account of theReply to targetAcct
+    set content of theReply to my insertAboveQuoted(content of theReply, "${(0, run_1.asEscape)(insertHtml)}")
+    -- Read the outgoing fields BEFORE acting: sending moves the item, after which
+    -- the reference is no longer readable.
+    set toList to {}
+    try
+        repeat with r in (every to recipient of theReply)
+            try
+                set ea to email address of r
+                set end of toList to (address of ea) as string
+            end try
+        end repeat
+    end try
+    set toLine to my joinList(toList, ", ")
+    set subj to ""
+    try
+        set subj to (subject of theReply) as string
+    end try
+${action}
+    return my sanitize(toLine) & (character id 31) & my sanitize(subj) & (character id 31) & my sanitize(repliedTo)
+end tell`;
+    const parts = (0, run_1.splitFields)(await (0, run_1.runOsaScript)(script, 120000));
+    return {
+        to: (0, run_1.field)(parts, 0),
+        subject: (0, run_1.field)(parts, 1),
+        repliedToSender: (0, run_1.field)(parts, 2),
+    };
+}
+//# sourceMappingURL=send.js.map

package/dist/mac/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../src/mac/send.ts"],"names":[],"mappings":"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"}

package/dist/mac/signatures.d.ts

@@ -0,0 +1,4 @@
+/** Names of the user's Outlook signatures. */
+export declare function listOutlookSignatures(): Promise<string[]>;
+/** Read a named signature's HTML. Returns '' if the signature can't be found. */
+export declare function readOutlookSignatureHtml(name: string): Promise<string>;

package/dist/mac/signatures.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listOutlookSignatures = listOutlookSignatures;
+exports.readOutlookSignatureHtml = readOutlookSignatureHtml;
+// Unlike Windows (files on disk), Outlook for Mac serves signature content
+// directly through AppleScript, images included (inline data or remote refs).
+const run_1 = require("./run");
+/** Names of the user's Outlook signatures. */
+async function listOutlookSignatures() {
+    const script = `
+set sigNames to {}
+tell application "Microsoft Outlook"
+    try
+        repeat with s in signatures
+            set end of sigNames to (name of s as string)
+        end repeat
+    end try
+end tell
+set AppleScript's text item delimiters to linefeed
+return sigNames as string`;
+    const raw = await (0, run_1.runOsaScript)(script, 15000);
+    return raw.split('\n').map(s => s.trim()).filter(Boolean).sort((a, b) => a.localeCompare(b));
+}
+/** Read a named signature's HTML. Returns '' if the signature can't be found. */
+async function readOutlookSignatureHtml(name) {
+    const script = `
+tell application "Microsoft Outlook"
+    try
+        return content of (first signature whose name is "${(0, run_1.asEscape)(name)}")
+    on error
+        return ""
+    end try
+end tell`;
+    return (0, run_1.runOsaScript)(script, 15000);
+}
+//# sourceMappingURL=signatures.js.map

package/dist/mac/signatures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signatures.js","sourceRoot":"","sources":["../../src/mac/signatures.ts"],"names":[],"mappings":";;AAKA,sDAcC;AAGD,4DAUC;AAhCD,2EAA2E;AAC3E,8EAA8E;AAC9E,+BAA+C;AAE/C,8CAA8C;AACvC,KAAK,UAAU,qBAAqB;IACvC,MAAM,MAAM,GAAG;;;;;;;;;;0BAUO,CAAC;IACvB,MAAM,GAAG,GAAG,MAAM,IAAA,kBAAY,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,iFAAiF;AAC1E,KAAK,UAAU,wBAAwB,CAAC,IAAY;IACvD,MAAM,MAAM,GAAG;;;4DAGyC,IAAA,cAAQ,EAAC,IAAI,CAAC;;;;SAIjE,CAAC;IACN,OAAO,IAAA,kBAAY,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/mac/templates.d.ts

@@ -0,0 +1,34 @@
+import type { SaveTemplateResult, TemplateFolderResult } from '../types';
+/**
+ * Read the template emails saved in a mailbox folder (default "Templates"),
+ * returning each item's full HTML body. When the folder doesn't exist, returns
+ * folderFound:false plus the mailbox's folder names instead of throwing, so the
+ * caller can ask the user whether to create it rather than fail.
+ *
+ * Bodies are read in a second pass, for the chosen templates only. That is not
+ * a micro-optimisation: a folder of Word-sized templates is megabytes, and
+ * pulling all of them through stdout on a call that wanted one is what overruns
+ * the buffer — the same reason the Windows reader filters before reading.
+ */
+export declare function readTemplateEmails(emailAccount: string, folderName?: string, limit?: number, includeBody?: boolean, subject?: string): Promise<TemplateFolderResult>;
+/**
+ * Save a new template email into a mailbox folder (default "Templates"),
+ * creating the folder at the mailbox root if it doesn't exist. The item is a
+ * plain unsent mail (subject + HTML body) that can be edited in Outlook.
+ * Never overwrites an existing item — it always adds a new one, so check with
+ * readTemplateEmails first and only call after the user has agreed to create it.
+ */
+export declare function saveTemplateEmail(emailAccount: string, subject: string, htmlBody: string, folderName?: string): Promise<SaveTemplateResult>;
+/**
+ * Open an Outlook compose window pre-filled with `currentHtml`, wait for the
+ * user to close it, and return the HTML they saved.
+ *
+ * Deliberately unbounded: the run lasts as long as the person is editing. Give
+ * it an AbortSignal (`bridge.withOptions({ signal })`) if the caller needs a way
+ * to give up on them.
+ *
+ * The macOS half of the round trip differs from Windows in one visible way: an
+ * edited draft is filed by answering Outlook's own "save this message?" prompt
+ * on close, so the subject tells the user to save rather than to press a key.
+ */
+export declare function editEmailTemplate(label: string, currentHtml: string): Promise<string>;