@dawnlit/outlook-bridge 1.0.0

package/dist/windows/scripts.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FIND_FOLDER_PS = exports.SENDER_SMTP_PS = exports.DELIVERY_STORE_PS = void 0;
+exports.accountScript = accountScript;
+exports.namedStoreScript = namedStoreScript;
+exports.getItemScript = getItemScript;
+exports.mailScopeScript = mailScopeScript;
+// The PowerShell fragments more than one Windows operation is built from.
+//
+// A fragment lives here once at least two modules emit it; one used by a single
+// operation stays beside that operation, where its rules are readable next to
+// the code that depends on them.
+const run_1 = require("./run");
+/**
+ * Open a MAPI session. `$outlook` and `$ns` are what every later fragment reads.
+ *
+ * `Logon()` is a no-op against an Outlook that is already running and starts one
+ * that isn't, so it costs nothing and removes a class of "works only when
+ * Outlook happens to be open" failure.
+ */
+const PS_PRELUDE = `
+$ErrorActionPreference = 'Stop'
+$outlook = New-Object -ComObject Outlook.Application
+$ns = $outlook.GetNamespace('mapi')
+$ns.Logon()
+`;
+/**
+ * Session plus the account whose SMTP address matches; binds `$target` and
+ * `$account`.
+ *
+ * Fails rather than falling back to the default account. A bad address must
+ * never silently send from — or read — the wrong mailbox, and the thrown
+ * sentence is the one `classifyRunFailure` recognises to raise
+ * `AccountNotFoundError`, so the wording is load-bearing.
+ */
+function accountScript(emailAccount) {
+    return `${PS_PRELUDE}
+$target = '${(0, run_1.psEscape)(emailAccount)}'
+$account = $null
+foreach ($a in $ns.Accounts) {
+    if ($a.SmtpAddress -ieq $target) { $account = $a; break }
+}
+if ($account -eq $null) { throw "Account '$target' not found" }
+`;
+}
+/** The account's own delivery store, as `$store`. Requires `accountScript`. */
+exports.DELIVERY_STORE_PS = `
+$store = $account.DeliveryStore
+$storeId = $store.StoreID
+`;
+/**
+ * The account's store reached through the namespace's top-level folders, as
+ * `$storeFolder` / `$store`.
+ *
+ * Kept alongside `DELIVERY_STORE_PS` rather than replaced by it: the reading
+ * operations resolve the store this way, and on a profile where a mailbox is
+ * open under a display name that differs from the delivery store's, the two do
+ * not select the same folders. Changing which one a reader uses changes what it
+ * returns, so each keeps the route it was verified against.
+ */
+function namedStoreScript(emailAccount) {
+    return `
+$storeFolder = $null
+foreach ($f in $ns.Folders) {
+    if ($f.Name -ieq $account.DisplayName) { $storeFolder = $f; break }
+}
+if ($storeFolder -eq $null) { throw "Store folder not found for account '${(0, run_1.psEscape)(emailAccount)}'" }
+$store = $storeFolder.Store
+$storeId = $store.StoreID
+`;
+}
+/**
+ * Resolve one item into `$item`. A StoreID disambiguates across mailboxes, so
+ * pass it whenever the listing that produced the id carried one.
+ */
+function getItemScript(entryId, storeId) {
+    return storeId
+        ? `$item = $ns.GetItemFromID('${(0, run_1.psEscape)(entryId)}', '${(0, run_1.psEscape)(storeId)}')`
+        : `$item = $ns.GetItemFromID('${(0, run_1.psEscape)(entryId)}')`;
+}
+/**
+ * The sender's real SMTP address, as `$senderSmtp`. Requires `$item`.
+ *
+ * An Exchange sender's `SenderEmailAddress` is an X500 DN rather than an
+ * address; a caller that means to reply to it, or correlate it with anything,
+ * needs the address it resolves to.
+ */
+exports.SENDER_SMTP_PS = `
+$senderSmtp = ''
+try {
+    if ($item.SenderEmailType -eq 'EX') { $senderSmtp = $item.Sender.GetExchangeUser().PrimarySmtpAddress }
+} catch {}
+if (-not $senderSmtp) { $senderSmtp = if ($item.SenderEmailAddress) { $item.SenderEmailAddress } else { '' } }
+`;
+/**
+ * Recursive folder-by-name search. Case-insensitive, depth-capped so a huge
+ * mailbox tree can't hang the scan.
+ */
+exports.FIND_FOLDER_PS = `
+function Find-FolderByName($root, $name, $depth) {
+    foreach ($f in $root.Folders) {
+        if ($f.Name -ieq $name) { return $f }
+    }
+    if ($depth -le 1) { return $null }
+    foreach ($f in $root.Folders) {
+        $hit = Find-FolderByName $f $name ($depth - 1)
+        if ($hit -ne $null) { return $hit }
+    }
+    return $null
+}
+`;
+/**
+ * Emit the PowerShell that resolves `$scope` from `$store`, walking a well-known
+ * root down through any further segments. Also binds `$scopeCreated`.
+ *
+ * Split out so the emitted script can be parse-checked without an Outlook
+ * session — the folder walk is the only part that varies per call, and a syntax
+ * error in it would only ever surface as a failed live run.
+ *
+ * `folderLabel` is the caller's original string, used verbatim in the error so
+ * the message names what they typed rather than the parsed segments. Set
+ * `createMissing` to build absent segments instead of throwing — the whole
+ * chain, so a nested destination can be created in one call.
+ */
+function mailScopeScript(ref, folderLabel = '', createMissing = false) {
+    const root = `$store.GetDefaultFolder(${ref.rootId})`;
+    if (ref.segments.length === 0)
+        return `$scope = ${root}\n$scopeCreated = $false`;
+    return `
+${exports.FIND_FOLDER_PS}
+$segments = @(${ref.segments.map(s => `'${(0, run_1.psEscape)(s)}'`).join(',')})
+$scopeRoot = ${root}
+$scope = $scopeRoot
+$deepest = $scopeRoot
+$scopeCreated = $false
+foreach ($seg in $segments) {
+    $next = $null
+    foreach ($f in $scope.Folders) { if ($f.Name -ieq $seg) { $next = $f; break } }
+    if ($next -eq $null) { $deepest = $scope; $scope = $null; break }
+    $scope = $next
+}
+# A bare name that isn't a direct child still resolves by recursive search, so one
+# folder string keeps working across tools.
+if ($scope -eq $null -and $segments.Count -eq 1) {
+    $scope = Find-FolderByName $scopeRoot $segments[0] 3
+}
+if ($scope -eq $null -and ${createMissing ? '$true' : '$false'}) {
+    # Rebuild the whole chain from the root, creating only what is genuinely absent.
+    $scope = $scopeRoot
+    foreach ($seg in $segments) {
+        $next = $null
+        foreach ($f in $scope.Folders) { if ($f.Name -ieq $seg) { $next = $f; break } }
+        if ($next -eq $null) { $next = $scope.Folders.Add($seg); $scopeCreated = $true }
+        $scope = $next
+    }
+}
+if ($scope -eq $null) {
+    $names = @()
+    foreach ($f in $deepest.Folders) { $names += $f.Name }
+    throw "Folder '${(0, run_1.psEscape)(folderLabel)}' not found. Folders under '$($deepest.Name)': $($names -join ', ')"
+}`;
+}
+//# sourceMappingURL=scripts.js.map

package/dist/windows/scripts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.js","sourceRoot":"","sources":["../../src/windows/scripts.ts"],"names":[],"mappings":";;;AA+BA,sCASC;AAkBD,4CAUC;AAMD,sCAIC;AAgDD,0CAoCC;AAlKD,0EAA0E;AAC1E,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAC9E,iCAAiC;AACjC,+BAAiC;AAGjC;;;;;;GAMG;AACH,MAAM,UAAU,GAAG;;;;;CAKlB,CAAC;AAEF;;;;;;;;GAQG;AACH,SAAgB,aAAa,CAAC,YAAoB;IAC9C,OAAO,GAAG,UAAU;aACX,IAAA,cAAQ,EAAC,YAAY,CAAC;;;;;;CAMlC,CAAC;AACF,CAAC;AAED,+EAA+E;AAClE,QAAA,iBAAiB,GAAG;;;CAGhC,CAAC;AAEF;;;;;;;;;GASG;AACH,SAAgB,gBAAgB,CAAC,YAAoB;IACjD,OAAO;;;;;2EAKgE,IAAA,cAAQ,EAAC,YAAY,CAAC;;;CAGhG,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,OAAe,EAAE,OAAgB;IAC3D,OAAO,OAAO;QACV,CAAC,CAAC,8BAA8B,IAAA,cAAQ,EAAC,OAAO,CAAC,OAAO,IAAA,cAAQ,EAAC,OAAO,CAAC,IAAI;QAC7E,CAAC,CAAC,8BAA8B,IAAA,cAAQ,EAAC,OAAO,CAAC,IAAI,CAAC;AAC9D,CAAC;AAED;;;;;;GAMG;AACU,QAAA,cAAc,GAAG;;;;;;CAM7B,CAAC;AAEF;;;GAGG;AACU,QAAA,cAAc,GAAG;;;;;;;;;;;;CAY7B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,SAAgB,eAAe,CAAC,GAAkB,EAAE,WAAW,GAAG,EAAE,EAAE,aAAa,GAAG,KAAK;IACvF,MAAM,IAAI,GAAG,2BAA2B,GAAG,CAAC,MAAM,GAAG,CAAC;IACtD,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,YAAY,IAAI,0BAA0B,CAAC;IACjF,OAAO;EACT,sBAAc;gBACA,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAA,cAAQ,EAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;eACpD,IAAI;;;;;;;;;;;;;;;4BAeS,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;;;;;;;;;;;;;qBAazC,IAAA,cAAQ,EAAC,WAAW,CAAC;EACxC,CAAC;AACH,CAAC"}

package/dist/windows/send.d.ts

@@ -0,0 +1,11 @@
+import type { ReplyEmailParams, ReplyEmailResult, SendEmailParams } from '../types';
+/** Send (or display for review) an email through Outlook COM. */
+export declare function sendOutlookEmail(params: SendEmailParams): Promise<void>;
+/**
+ * Reply to an email, inserting the caller's HTML above the quoted original.
+ *
+ * The body may be given directly or named as a saved template — see
+ * `composeReplyHtml`, which resolves the template, its section and its
+ * placeholders before anything reaches Outlook.
+ */
+export declare function replyOutlookEmail(params: ReplyEmailParams): Promise<ReplyEmailResult>;

package/dist/windows/send.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendOutlookEmail = sendOutlookEmail;
+exports.replyOutlookEmail = replyOutlookEmail;
+// Composing outgoing mail: 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 json_1 = require("../shared/json");
+const signatures_1 = require("./signatures");
+const templates_1 = require("./templates");
+/**
+ * Set the sending account through IDispatch reflection.
+ *
+ * Direct assignment (`$mail.SendUsingAccount = $account`) is a silent no-op under
+ * PowerShell's COM binding — the mail then goes out from whichever account
+ * Outlook considers default, which is the failure this package exists to prevent.
+ */
+function sendUsingAccount(variable) {
+    return `[void]$${variable}.GetType().InvokeMember('SendUsingAccount', [Reflection.BindingFlags]::SetProperty, $null, $${variable}, @($account))`;
+}
+/**
+ * What to do with a composed item: send it, show it, or file it silently.
+ *
+ * `Display()` only shows the compose window — it never files the item, so a
+ * windowless draft has to `Save()` into Drafts explicitly.
+ */
+function composeAction(variable, sendImmediately, openDraftWindow) {
+    if (sendImmediately)
+        return `$${variable}.Send()`;
+    return openDraftWindow !== false ? `$${variable}.Display()` : `$${variable}.Save()`;
+}
+/** Send (or display for review) an email through Outlook COM. */
+async function sendOutlookEmail(params) {
+    (0, run_1.requireWindows)();
+    const attachLine = params.attachmentPath
+        ? `$mail.Attachments.Add('${(0, run_1.psEscape)(params.attachmentPath)}') | Out-Null`
+        : '';
+    // The HTML body goes through a file: inline, a large email is what pushes the
+    // generated script past the command-line length limit.
+    const body = (0, run_1.scriptInput)('email-body', params.htmlBody);
+    const script = `${(0, scripts_1.accountScript)(params.emailAccount)}
+$mail = $outlook.CreateItem(0)
+${sendUsingAccount('mail')}
+$mail.To = '${(0, run_1.psEscape)(params.to)}'
+$mail.CC = '${(0, run_1.psEscape)(params.cc || '')}'
+$mail.Subject = '${(0, run_1.psEscape)(params.subject)}'
+$mail.HTMLBody = [IO.File]::ReadAllText('${(0, run_1.psEscape)(body.path)}', [Text.Encoding]::UTF8)
+${attachLine}
+${composeAction('mail', params.sendImmediately, params.openDraftWindow)}
+`;
+    try {
+        await (0, run_1.runPowerShellFile)(script, 120000);
+    }
+    finally {
+        body.cleanup();
+    }
+}
+/**
+ * Reply to an email, inserting the caller's HTML above the quoted original.
+ *
+ * The body may be given directly or named as a saved template — see
+ * `composeReplyHtml`, which resolves the template, its section and its
+ * placeholders before anything reaches Outlook.
+ */
+async function replyOutlookEmail(params) {
+    (0, run_1.requireWindows)();
+    const insertHtml = await (0, replyBody_1.composeReplyHtml)(params, {
+        readTemplateEmails: templates_1.readTemplateEmails,
+        readOutlookSignatureHtml: signatures_1.readOutlookSignatureHtml,
+        listOutlookSignatures: signatures_1.listOutlookSignatures,
+    });
+    const body = (0, run_1.scriptInput)('reply-insert', insertHtml);
+    const replyMethod = params.replyAll ? 'ReplyAll' : 'Reply';
+    // Outlook builds the reply as a Word document whose own empty paragraph sits
+    // inside WordSection1; inserting straight after that div's opening tag puts
+    // the new text where the user's cursor would have been. A reply Outlook did
+    // not build that way falls back to just inside <body>.
+    const script = `${(0, scripts_1.accountScript)(params.emailAccount)}
+${(0, scripts_1.getItemScript)(params.entryId, params.storeId)}
+$reply = $item.${replyMethod}()
+${sendUsingAccount('reply')}
+
+$insertHtml = [IO.File]::ReadAllText('${(0, run_1.psEscape)(body.path)}', [Text.Encoding]::UTF8)
+$keyWord = '${(0, run_1.psEscape)(replyBody_1.WORD_SECTION_ANCHOR)}'
+# Bound to a local first: each $reply.HTMLBody read marshals the WHOLE generated
+# reply across COM, and a Word reply on a long thread runs to hundreds of KB.
+$html = $reply.HTMLBody
+$idx = $html.IndexOf($keyWord)
+if ($idx -ge 0) { $idx += $keyWord.Length } else {
+    $m = [regex]::Match($html, '<body[^>]*>')
+    $idx = if ($m.Success) { $m.Index + $m.Length } else { 0 }
+}
+$reply.HTMLBody = $html.Insert($idx, $insertHtml)
+$to = [string]$reply.To
+$subject = [string]$reply.Subject
+$sender = ''
+try { $sender = [string]$item.SenderEmailAddress } catch {}
+${composeAction('reply', params.sendImmediately, params.openDraftWindow)}
+ConvertTo-Json @{ to = $to; subject = $subject; repliedToSender = $sender }
+`;
+    try {
+        const parsed = (0, json_1.parseObject)(await (0, run_1.runPowerShell)(script, 60000));
+        return {
+            to: (0, json_1.str)(parsed.to),
+            subject: (0, json_1.str)(parsed.subject),
+            repliedToSender: (0, json_1.str)(parsed.repliedToSender),
+        };
+    }
+    finally {
+        body.cleanup();
+    }
+}
+//# sourceMappingURL=send.js.map

package/dist/windows/send.js.map

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

package/dist/windows/signatures.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Names of the user's Outlook signatures (the ".htm" files), sorted. Empty off
+ * Windows. Reads from disk synchronously but is declared async to match macOS,
+ * which has to ask Outlook itself — one signature for both platforms.
+ */
+export declare function listOutlookSignatures(): Promise<string[]>;
+/**
+ * Read a named signature's HTML with its image references rewritten to absolute
+ * file: URIs. Outlook stores signature images relative to a "<name>_files"
+ * folder; once the refs are absolute, assigning the HTML to a mail body lets
+ * Outlook resolve and embed the images on Display/Send. Returns '' if the
+ * signature can't be found.
+ */
+export declare function readOutlookSignatureHtml(name: string): Promise<string>;

package/dist/windows/signatures.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listOutlookSignatures = listOutlookSignatures;
+exports.readOutlookSignatureHtml = readOutlookSignatureHtml;
+// Outlook stores each signature as "<name>.htm" (plus .rtf/.txt and a
+// "<name>_files" folder for images) under %APPDATA%\Microsoft\Signatures, so
+// both of these read the disk rather than driving COM.
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const url_1 = require("url");
+const SIGNATURES_DIR = process.env.APPDATA
+    ? path_1.default.join(process.env.APPDATA, 'Microsoft', 'Signatures')
+    : '';
+/**
+ * Names of the user's Outlook signatures (the ".htm" files), sorted. Empty off
+ * Windows. Reads from disk synchronously but is declared async to match macOS,
+ * which has to ask Outlook itself — one signature for both platforms.
+ */
+async function listOutlookSignatures() {
+    if (process.platform !== 'win32' || !SIGNATURES_DIR)
+        return [];
+    try {
+        return fs_1.default.readdirSync(SIGNATURES_DIR)
+            .filter(f => f.toLowerCase().endsWith('.htm'))
+            .map(f => f.slice(0, -4))
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Read a named signature's HTML with its image references rewritten to absolute
+ * file: URIs. Outlook stores signature images relative to a "<name>_files"
+ * folder; once the refs are absolute, assigning the HTML to a mail body lets
+ * Outlook resolve and embed the images on Display/Send. Returns '' if the
+ * signature can't be found.
+ */
+async function readOutlookSignatureHtml(name) {
+    if (process.platform !== 'win32' || !SIGNATURES_DIR)
+        return '';
+    // Only accept a bare signature name — never a path — so a crafted name can't
+    // escape the Signatures folder.
+    const safe = path_1.default.basename(name);
+    const file = path_1.default.join(SIGNATURES_DIR, `${safe}.htm`);
+    if (!fs_1.default.existsSync(file))
+        return '';
+    // Classic Outlook signatures are saved as windows-1252, not UTF-8; decode by
+    // the charset the file declares so accented text / smart quotes survive.
+    const buf = fs_1.default.readFileSync(file);
+    const head = buf.toString('latin1', 0, 2048);
+    const charset = head.match(/charset=["']?([\w-]+)/i)?.[1] || 'utf-8';
+    let html;
+    try {
+        html = new TextDecoder(charset).decode(buf);
+    }
+    catch {
+        html = buf.toString('utf-8');
+    }
+    // pathToFileURL encodes spaces/specials the same way Outlook's relative refs
+    // are, so prefixing the (already relative, already-encoded) src keeps a valid URI.
+    const dirUri = (0, url_1.pathToFileURL)(SIGNATURES_DIR + path_1.default.sep).href;
+    html = html.replace(/(src|background)=(["'])(?!https?:|cid:|data:|file:|mailto:|#)/gi, `$1=$2${dirUri}`);
+    return html;
+}
+//# sourceMappingURL=signatures.js.map

package/dist/windows/signatures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signatures.js","sourceRoot":"","sources":["../../src/windows/signatures.ts"],"names":[],"mappings":";;;;;AAgBA,sDAUC;AASD,4DA0BC;AA7DD,sEAAsE;AACtE,6EAA6E;AAC7E,uDAAuD;AACvD,4CAAoB;AACpB,gDAAwB;AACxB,6BAAoC;AAEpC,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO;IACtC,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,CAAC;IAC3D,CAAC,CAAC,EAAE,CAAC;AAET;;;;GAIG;AACI,KAAK,UAAU,qBAAqB;IACvC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,cAAc;QAAE,OAAO,EAAE,CAAC;IAC/D,IAAI,CAAC;QACD,OAAO,YAAE,CAAC,WAAW,CAAC,cAAc,CAAC;aAChC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;aAC7C,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;aACxB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,wBAAwB,CAAC,IAAY;IACvD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,cAAc;QAAE,OAAO,EAAE,CAAC;IAC/D,6EAA6E;IAC7E,gCAAgC;IAChC,MAAM,IAAI,GAAG,cAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,cAAI,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;IACtD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,6EAA6E;IAC7E,yEAAyE;IACzE,MAAM,GAAG,GAAG,YAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IACrE,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACD,IAAI,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACL,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,6EAA6E;IAC7E,mFAAmF;IACnF,MAAM,MAAM,GAAG,IAAA,mBAAa,EAAC,cAAc,GAAG,cAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IAC7D,IAAI,GAAG,IAAI,CAAC,OAAO,CACf,iEAAiE,EACjE,QAAQ,MAAM,EAAE,CACnB,CAAC;IACF,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/windows/templates.d.ts

@@ -0,0 +1,25 @@
+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.
+ */
+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.
+ */
+export declare function editEmailTemplate(label: string, currentHtml: string): Promise<string>;

package/dist/windows/templates.js

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readTemplateEmails = readTemplateEmails;
+exports.saveTemplateEmail = saveTemplateEmail;
+exports.editEmailTemplate = editEmailTemplate;
+// Template emails: ordinary mail items kept in a mailbox folder and reused as
+// reply bodies, plus the compose-window editor for one.
+const run_1 = require("./run");
+const scripts_1 = require("./scripts");
+const json_1 = require("../shared/json");
+const outlookTemplateSections_1 = require("../outlookTemplateSections");
+const mail_1 = require("../mail");
+const errors_1 = require("../errors");
+const runtime_1 = require("../runtime");
+/**
+ * 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.
+ */
+async function readTemplateEmails(emailAccount, folderName = 'Templates', limit = 20, includeBody = true, subject = '') {
+    (0, run_1.requireWindows)();
+    const cap = (0, mail_1.clamp)(limit, 1, 50);
+    const wanted = (subject || '').trim();
+    const script = `${(0, scripts_1.accountScript)(emailAccount)}
+$root = $account.DeliveryStore.GetRootFolder()
+${scripts_1.FIND_FOLDER_PS}
+$folder = Find-FolderByName $root '${(0, run_1.psEscape)(folderName)}' 3
+if ($folder -eq $null) {
+    $names = @()
+    foreach ($f in $root.Folders) { $names += $f.Name }
+    ConvertTo-Json @{ folderFound = $false; folderPath = ''; templates = @(); availableFolders = $names } -Depth 3
+    exit 0
+}
+$includeBody = ${(0, run_1.psBool)(includeBody)}
+$wanted = '${(0, run_1.psEscape)(wanted)}'
+$items = $folder.Items
+$items.Sort('[LastModificationTime]', $true)
+$results = @()
+# Without a subject filter the sort order does the capping (newest first). With one,
+# scan the whole folder — the wanted template need not be among the newest — and stop
+# as soon as the cap is filled.
+$count = $items.Count
+for ($i = 1; $i -le $count; $i++) {
+    if ($results.Count -ge ${cap}) { break }
+    $item = $null
+    try { $item = $items.Item($i) } catch { continue }
+    if ($item -eq $null) { continue }
+    $cls = 0
+    try { $cls = [int]$item.Class } catch {}
+    if ($cls -ne 43) { continue }  # olMail only
+    if ($wanted -ne '') {
+        $subj = ''
+        try { $subj = [string]$item.Subject } catch {}
+        if ($subj -eq $null) { $subj = '' }
+        if ($subj.Trim() -ine $wanted) { continue }
+    }
+    $html = ''
+    $preview = ''
+    $markers = ''
+    $plain = ''
+    if ($includeBody) {
+        try { $html = [string]$item.HTMLBody } catch {}
+        # Embedded (cid:) images live as attachments on the TEMPLATE item: reusing this HTML
+        # on a new email shows a broken "linked image" placeholder, and rewriting to file:
+        # URIs renders invisibly in modern Outlook. Neither works, so strip the img tags —
+        # template emails are text/HTML only.
+        $html = [regex]::Replace($html, '<img[^>]*src="cid:[^"]*"[^>]*>', '')
+        if ($html.Length -gt 100000) { $html = $html.Substring(0, 100000) }
+    } else {
+        # Bodies omitted: return a short plain-text preview so the caller can tell templates
+        # apart by subject without pulling the full (often huge) Word-generated HTML.
+        try { $plain = [string]$item.Body } catch { $plain = '' }
+        if ($plain) {
+            # ...plus the [[SECTION]] / {{PLACEHOLDER}} markers, scanned from the full text:
+            # that's what lets a caller confirm a sectioned template is intact without
+            # fetching its body. Word can split a marker across tags in the HTML but not
+            # in the plain-text body, so a literal scan is right here.
+            # (Backslashes in the regex are doubled because this whole script is a JS
+            # template literal — a single one would be eaten before PowerShell saw it.)
+            $found = @()
+            foreach ($x in [regex]::Matches($plain, '\\[\\[\\s*/?\\s*[A-Za-z0-9_-]{1,40}\\s*\\]\\]|\\{\\{\\s*[A-Za-z0-9_-]{1,40}\\s*\\}\\}')) {
+                $t = ($x.Value -replace '\\s', '')
+                if ($found -notcontains $t) { $found += $t }
+            }
+            $markers = ($found -join ' ')
+            $preview = $plain.Trim()
+            if ($preview.Length -gt 200) { $preview = $preview.Substring(0, 200) }
+        }
+    }
+    $results += [PSCustomObject]@{
+        entryId      = $item.EntryID
+        subject      = if ($item.Subject) { $item.Subject.Trim() } else { '' }
+        htmlBody     = $html
+        bodyPreview  = $preview
+        markers      = $markers
+        lastModified = $item.LastModificationTime.ToString('yyyy-MM-dd HH:mm')
+    }
+}
+ConvertTo-Json @{ folderFound = $true; folderPath = $folder.FolderPath; templates = $results; availableFolders = @() } -Depth 4
+`;
+    const parsed = (0, json_1.parseObject)(await (0, run_1.runPowerShell)(script, 60000));
+    return {
+        folderFound: Boolean(parsed.folderFound),
+        folderPath: (0, json_1.str)(parsed.folderPath),
+        templates: (0, json_1.toArray)(parsed.templates).map(item => {
+            const e = (0, json_1.record)(item);
+            const html = (0, json_1.str)(e.htmlBody);
+            // With a body in hand the HTML is authoritative (it survives Word splitting a
+            // marker across tags); without one, fall back to what the script scanned out
+            // of the plain-text body.
+            const markers = (0, outlookTemplateSections_1.findTemplateMarkers)(html || (0, json_1.str)(e.markers));
+            return {
+                entryId: (0, json_1.str)(e.entryId),
+                subject: (0, json_1.str)(e.subject),
+                htmlBody: html,
+                bodyPreview: (0, json_1.str)(e.bodyPreview),
+                sections: markers.sections,
+                placeholders: markers.placeholders,
+                lastModified: (0, json_1.str)(e.lastModified),
+            };
+        }),
+        availableFolders: (0, json_1.toArray)(parsed.availableFolders).map(json_1.str),
+    };
+}
+/**
+ * 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.
+ */
+async function saveTemplateEmail(emailAccount, subject, htmlBody, folderName = 'Templates') {
+    (0, run_1.requireWindows)();
+    const body = (0, run_1.scriptInput)('template-body', htmlBody);
+    const script = `${(0, scripts_1.accountScript)(emailAccount)}
+$root = $account.DeliveryStore.GetRootFolder()
+${scripts_1.FIND_FOLDER_PS}
+$folder = Find-FolderByName $root '${(0, run_1.psEscape)(folderName)}' 3
+$folderCreated = $false
+if ($folder -eq $null) {
+    $folder = $root.Folders.Add('${(0, run_1.psEscape)(folderName)}')
+    $folderCreated = $true
+}
+$mail = $outlook.CreateItem(0)
+$mail.Subject = '${(0, run_1.psEscape)(subject)}'
+$mail.HTMLBody = [IO.File]::ReadAllText('${(0, run_1.psEscape)(body.path)}', [Text.Encoding]::UTF8)
+$mail.Save()
+$moved = $mail.Move($folder)
+ConvertTo-Json @{ folderPath = $folder.FolderPath; folderCreated = $folderCreated }
+`;
+    try {
+        const parsed = (0, json_1.parseObject)(await (0, run_1.runPowerShell)(script, 60000));
+        return {
+            folderPath: (0, json_1.str)(parsed.folderPath),
+            folderCreated: Boolean(parsed.folderCreated),
+        };
+    }
+    finally {
+        body.cleanup();
+    }
+}
+/**
+ * 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.
+ */
+async function editEmailTemplate(label, currentHtml) {
+    (0, run_1.requireWindows)();
+    const input = (0, run_1.scriptInput)('template-input', currentHtml);
+    const outputFile = (0, runtime_1.tempFile)('template-output', 'html');
+    const subject = `${label} - Save (Ctrl+S) and close when done`;
+    const script = `
+$ErrorActionPreference = 'Stop'
+$inputPath = '${(0, run_1.psEscape)(input.path)}'
+$outputPath = '${(0, run_1.psEscape)(outputFile)}'
+$subject = '${(0, run_1.psEscape)(subject)}'
+
+$outlook = New-Object -ComObject Outlook.Application
+$ns = $outlook.GetNamespace('mapi')
+$mail = $outlook.CreateItem(0)
+$mail.Subject = $subject
+$mail.HTMLBody = [IO.File]::ReadAllText($inputPath, [Text.Encoding]::UTF8)
+$mail.Display()
+
+# Give the inspector time to fully initialize
+Start-Sleep -Seconds 2
+
+# Poll until the compose window is closed, keeping the last live body as a
+# fallback for the case where the user edits but never presses Ctrl+S.
+$liveBody = ''
+while ($true) {
+    Start-Sleep -Milliseconds 700
+    $open = $false
+    try {
+        foreach ($insp in $outlook.Inspectors) {
+            $ci = $null
+            try { $ci = $insp.CurrentItem } catch {}
+            if ($ci -ne $null -and $ci.Subject -eq $subject) {
+                $open = $true
+                try { $liveBody = $ci.HTMLBody } catch {}
+                break
+            }
+        }
+    } catch {}
+    if (-not $open) { break }
+}
+
+# Prefer the saved draft — it reflects the user's Ctrl+S and survives the
+# inspector closing, unlike the original mail reference. Also removes any
+# leftover editor drafts so they don't pile up in the Drafts folder.
+$savedBody = ''
+try {
+    $drafts = $ns.GetDefaultFolder(16)
+    $draftItems = $drafts.Items
+    for ($i = $draftItems.Count; $i -ge 1; $i--) {
+        $it = $draftItems.Item($i)
+        if ($it.Subject -eq $subject) {
+            if (-not $savedBody) { try { $savedBody = $it.HTMLBody } catch {} }
+            try { $it.Delete() } catch {}
+        }
+    }
+} catch {}
+
+$finalBody = if ($savedBody) { $savedBody } else { $liveBody }
+if ($finalBody) {
+    [IO.File]::WriteAllText($outputPath, $finalBody, [Text.Encoding]::UTF8)
+}
+`;
+    try {
+        // 0 disables the timeout: this run is as long as the edit takes.
+        await (0, run_1.runPowerShellFile)(script, 0);
+    }
+    finally {
+        input.cleanup();
+    }
+    const result = (0, run_1.readScriptOutput)(outputFile);
+    if (!result) {
+        throw new errors_1.NotFoundError('template', 'No template saved. Did you save (Ctrl+S) before closing?');
+    }
+    return result;
+}
+//# sourceMappingURL=templates.js.map