@dawnlit/outlook-bridge 1.0.0

package/dist/windows/read.js

@@ -0,0 +1,372 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readInboxEmails = readInboxEmails;
+exports.readEmailBody = readEmailBody;
+exports.searchInboxByFilter = searchInboxByFilter;
+exports.readSelectedEmail = readSelectedEmail;
+exports.openOutlookEmail = openOutlookEmail;
+// Reading mail: one folder, one item, a whole Inbox tree, or whatever is
+// selected in the running Outlook.
+const run_1 = require("./run");
+const scripts_1 = require("./scripts");
+const json_1 = require("../shared/json");
+const mail_1 = require("../mail");
+const errors_1 = require("../errors");
+/**
+ * An arbitrary email body crosses the PowerShell boundary base64'd: it carries
+ * quotes, control characters and non-ASCII that would otherwise have to survive
+ * both the console codepage and JSON string escaping intact.
+ */
+function decodeBody(value) {
+    return Buffer.from((0, json_1.str)(value), 'base64').toString('utf8');
+}
+// Outgoing roots keep their timestamp under a different COM property; anything
+// else carries ReceivedTime.
+const OUTGOING_DATE_PROPS = {
+    [mail_1.WELL_KNOWN_FOLDERS['sent items']]: 'SentOn',
+    [mail_1.WELL_KNOWN_FOLDERS.outbox]: 'SentOn',
+    [mail_1.WELL_KNOWN_FOLDERS.drafts]: 'LastModificationTime',
+};
+/**
+ * Read recent emails from the Outlook inbox for the given account.
+ * No subject filtering — returns everything within the date window, up to the limit.
+ * Does NOT download attachments; returns attachment names only.
+ *
+ * `folder` scopes the read to one folder under the Inbox instead of the Inbox
+ * root. Without it, mail already filed away (Inbox\\Invoices) is unreachable —
+ * which is the normal state of any mailbox its owner keeps tidy. Segments are
+ * matched as direct children; a bare name that isn't a direct child falls back to
+ * the same recursive by-name search moveOutlookEmails uses, so one folder string
+ * works in both. Only the named folder is read — its own subfolders are not.
+ */
+async function readInboxEmails(emailAccount, daysBack = 60, limit = 50, folder) {
+    if (process.platform !== 'win32')
+        return [];
+    const ref = folder ? (0, mail_1.mailFolderRef)(folder) : { rootId: 6, rootLabel: 'Inbox', segments: [] };
+    // A folder argument that trims away to nothing ("\\", "  ") would otherwise
+    // read the Inbox root and look like it had scoped — the exact silent
+    // mis-scoping this parameter exists to prevent. A bare well-known name
+    // ("Sent Items") legitimately has no segments, so it is not that case.
+    if (folder && folder.trim() && ref.segments.length === 0 && ref.rootId === 6
+        && !Object.prototype.hasOwnProperty.call(mail_1.WELL_KNOWN_FOLDERS, folder.trim().toLowerCase())) {
+        throw new errors_1.NotFoundError('folder', `Folder '${folder}' does not name a folder under the Inbox.`);
+    }
+    // Which timestamp the folder's items actually carry (see the note in the script).
+    const dateProp = OUTGOING_DATE_PROPS[ref.rootId] ?? 'ReceivedTime';
+    const isOutgoing = (0, run_1.psBool)((0, mail_1.isOutgoingRoot)(ref.rootId));
+    const script = `${(0, scripts_1.accountScript)(emailAccount)}
+${(0, scripts_1.namedStoreScript)(emailAccount)}
+${(0, scripts_1.mailScopeScript)(ref, folder || '')}
+$scopePath = $scope.FolderPath
+$cutoff = (Get-Date).AddDays(-${daysBack}).ToString('MM/dd/yyyy HH:mm')
+# Sent Items and Drafts carry no ReceivedTime, so restricting on it there returns
+# an empty set that looks exactly like an empty folder. Filter each on the date
+# property it actually has.
+$filtered = $scope.Items.Restrict("[${dateProp}] >= '$cutoff'")
+$filtered.Sort('[${dateProp}]', $true)
+$results = @()
+$cap = [Math]::Min($filtered.Count, ${limit})
+for ($i = 1; $i -le $cap; $i++) {
+    $item = $filtered.Item($i)
+    $subj = if ($item.Subject) { $item.Subject.Trim() } else { '' }
+    $bodyText = if ($item.Body) { $item.Body } else { '' }
+    $bodyPreview = if ($bodyText.Length -gt 600) { $bodyText.Substring(0, 600) } else { $bodyText }
+    $attNames = @()
+    foreach ($att in $item.Attachments) { $attNames += $att.FileName }
+    $stamp = ''
+    try { $stamp = $item.${dateProp}.ToString('yyyy-MM-dd HH:mm') } catch {}
+    # Outgoing mail has no meaningful sender line of its own — report who it is TO,
+    # or a Sent Items listing reads as a folder of mail from yourself.
+    $who = ''
+    try { $who = if ($item.To) { $item.To } else { '' } } catch {}
+    $results += [PSCustomObject]@{
+        entryId       = $item.EntryID
+        storeId       = $storeId
+        folderPath    = $scopePath
+        subject       = $subj
+        senderName    = if (${isOutgoing}) { $who } elseif ($item.SenderName) { $item.SenderName } else { '' }
+        senderEmail   = if (${isOutgoing}) { $who } elseif ($item.SenderEmailAddress) { $item.SenderEmailAddress } else { '' }
+        receivedTime  = $stamp
+        bodyPreview   = $bodyPreview
+        attachmentNames = $attNames
+        attachmentCount = $item.Attachments.Count
+    }
+}
+ConvertTo-Json $results -Depth 3
+`;
+    return (0, json_1.parseArray)(await (0, run_1.runPowerShell)(script, 30000)).map(item => {
+        const e = (0, json_1.record)(item);
+        return {
+            entryId: (0, json_1.str)(e.entryId),
+            storeId: (0, json_1.str)(e.storeId),
+            folderPath: (0, json_1.str)(e.folderPath),
+            subject: (0, json_1.str)(e.subject),
+            senderName: (0, json_1.str)(e.senderName),
+            senderEmail: (0, json_1.str)(e.senderEmail),
+            receivedTime: (0, json_1.str)(e.receivedTime),
+            bodyPreview: (0, json_1.str)(e.bodyPreview),
+            attachmentNames: (0, json_1.toArray)(e.attachmentNames).map(json_1.str),
+            attachmentCount: typeof e.attachmentCount === 'number' ? e.attachmentCount : 0,
+        };
+    });
+}
+/**
+ * Read one email's full plain-text body by EntryID.
+ *
+ * Uses `MailItem.Body`, not `HTMLBody`: Outlook's own plain-text rendering is
+ * what every other reader here consumes, and the markup costs an order of
+ * magnitude more for the same sentences. The tradeoff is that HTML tables
+ * flatten, so figures broken out in a table lose their row/column pairing — read
+ * those from the attachment where there is one.
+ *
+ * Exists because `readInboxEmails` caps its preview at 600 chars, and a reply
+ * whose first 600 chars read as complete can still carry a material detail below
+ * the cut. Nothing detects that from the preview alone.
+ *
+ * `includeQuoted` is off by default — see splitQuotedOriginal for why the
+ * quoted thread is a hazard to a caller reading figures out of a reply.
+ * `quotedLength` is reported either way so a caller can tell it exists and ask again.
+ */
+async function readEmailBody(entryId, storeId, maxChars = 8000, includeQuoted = false) {
+    (0, run_1.requireWindows)();
+    const script = `
+$outlook = New-Object -ComObject Outlook.Application
+$ns = $outlook.GetNamespace('mapi')
+$ns.Logon()
+${(0, scripts_1.getItemScript)(entryId, storeId)}
+if ($item -eq $null) { throw "Email not found for EntryID '${(0, run_1.psEscape)(entryId)}'" }
+$cls = 0
+try { $cls = [int]$item.Class } catch {}
+if ($cls -ne 43 -and $cls -ne 46) { throw "The item for this EntryID is not an email (Class=$cls). Re-run readInboxEmails for a current EntryID." }
+$bodyRaw = ''
+try { if ($item.Body) { $bodyRaw = [string]$item.Body } } catch {}
+$attNames = @()
+try { foreach ($att in $item.Attachments) { $attNames += $att.FileName } } catch {}
+${scripts_1.SENDER_SMTP_PS}
+$received = ''
+try { $received = $item.ReceivedTime.ToString('yyyy-MM-dd HH:mm') } catch {}
+$out = [PSCustomObject]@{
+    entryId         = $item.EntryID
+    subject         = if ($item.Subject) { $item.Subject.Trim() } else { '' }
+    senderName      = if ($item.SenderName) { $item.SenderName } else { '' }
+    senderEmail     = $senderSmtp
+    receivedTime    = $received
+    body            = [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($bodyRaw))
+    attachmentNames = $attNames
+}
+ConvertTo-Json $out -Depth 3 -Compress
+`;
+    const raw = await (0, run_1.runPowerShell)(script, 20000);
+    if (!raw || !raw.trim())
+        throw new errors_1.NotFoundError('email', 'Failed to read email body.');
+    const parsed = (0, json_1.parseObject)(raw);
+    const { body, quoted, separator } = (0, mail_1.splitQuotedOriginal)(decodeBody(parsed.body));
+    const attachmentNames = (0, json_1.toArray)(parsed.attachmentNames).map(json_1.str);
+    // The quoted thread is context, never the sender's own answer, so it is capped
+    // harder than the reply itself — its useful part (what was asked) is at the
+    // top of it.
+    const quotedCap = Math.min(maxChars, 4000);
+    return {
+        entryId: (0, json_1.str)(parsed.entryId),
+        subject: (0, json_1.str)(parsed.subject),
+        senderName: (0, json_1.str)(parsed.senderName),
+        senderEmail: (0, json_1.str)(parsed.senderEmail),
+        receivedTime: (0, json_1.str)(parsed.receivedTime),
+        body: body.length > maxChars ? body.slice(0, maxChars) : body,
+        truncated: body.length > maxChars,
+        bodyLength: body.length,
+        quoteSeparator: separator,
+        quotedLength: quoted.length,
+        quotedOriginal: includeQuoted ? quoted.slice(0, quotedCap) : '',
+        attachmentNames,
+        attachmentCount: attachmentNames.length,
+    };
+}
+/**
+ * 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.
+ *
+ * Built for a scan that doesn't know in advance which subfolder holds what
+ * it's after; `readInboxEmails` covers the cheaper "one known folder" case.
+ *
+ * `daysBack` bounds the scan to items received within that many days — what a
+ * daily batch run wants, since a subject filter alone walks the whole Inbox
+ * tree and returns every match ever received. 0 keeps that unbounded
+ * behavior, and is only sane paired with `filter.subjectLike` so Restrict can
+ * narrow the set server-side before anything crosses COM.
+ */
+async function searchInboxByFilter(emailAccount, filter = {}, daysBack = 0) {
+    if (process.platform !== 'win32')
+        return [];
+    const subjectLike = filter.subjectLike ? (0, run_1.psEscape)(filter.subjectLike) : '';
+    const subjectPatternSrc = filter.subjectPattern ? (0, run_1.psEscape)(filter.subjectPattern.source) : '';
+    // The subject filter reaches PowerShell as a single-quoted literal assigned to
+    // $subjLike, and the Restrict query is CONCATENATED from it. Interpolating it
+    // into the double-quoted query string directly — which is what the query needs
+    // to be, so `$cutoff` expands — would let a caller's `$(...)` execute, and
+    // would break the query outright on an apostrophe.
+    const boundedRestrict = subjectLike
+        ? `$folder.Items.Restrict("[ReceivedTime] >= '$cutoff' AND [Subject] like '" + $subjLike + "'")`
+        : `$folder.Items.Restrict("[ReceivedTime] >= '$cutoff'")`;
+    const unboundedRestrict = subjectLike
+        ? `$folder.Items.Restrict("[Subject] like '" + $subjLike + "'")`
+        : `$folder.Items`;
+    const script = `
+$subjLike = '${subjectLike}'
+${(0, scripts_1.accountScript)(emailAccount)}
+${(0, scripts_1.namedStoreScript)(emailAccount)}
+$inbox = $store.GetDefaultFolder(6)
+$results = @()
+$seen = @{}
+$folders = [System.Collections.ArrayList]@($inbox)
+$fi = 0
+while ($fi -lt $folders.Count) {
+    try { foreach ($sub in $folders[$fi].Folders) { [void]$folders.Add($sub) } } catch {}
+    $fi++
+}
+$daysBack = ${daysBack}
+foreach ($folder in $folders) {
+    if ($daysBack -gt 0) {
+        # Bounded scan. Filter on BOTH date and subject in the Restrict so Outlook does the
+        # work server-side — a date-only restrict hands back every item in the window for
+        # every folder in the tree, which is thousands of COM round-trips on a busy mailbox.
+        # Any stricter subject regex still runs on whatever survives.
+        $cutoff = (Get-Date).AddDays(-$daysBack).ToString('MM/dd/yyyy HH:mm')
+        try {
+            $filtered = ${boundedRestrict}
+            $fCount = $filtered.Count
+        } catch {
+            # Some stores reject the compound query; fall back to date-only.
+            $filtered = $folder.Items.Restrict("[ReceivedTime] >= '$cutoff'")
+            $fCount = $filtered.Count
+        }
+    } else {
+        $filtered = ${unboundedRestrict}
+        $fCount = $filtered.Count
+        ${subjectLike ? `if ($fCount -eq 0) {
+            $cutoff = (Get-Date).AddDays(-60).ToString('MM/dd/yyyy HH:mm')
+            $filtered = $folder.Items.Restrict("[ReceivedTime] >= '$cutoff'")
+            $fCount = $filtered.Count
+        }` : ''}
+    }
+    for ($i = 1; $i -le $fCount; $i++) {
+        $item = $filtered.Item($i)
+        if ($seen.ContainsKey($item.EntryID)) { continue }
+        $seen[$item.EntryID] = $true
+        $subject = $item.Subject
+        if (-not $subject) { continue }
+        $subject = $subject.Trim()
+        ${subjectPatternSrc ? `if ($subject -notmatch '${subjectPatternSrc}') { continue }` : ''}
+        ${filter.excludeReplies ? `if ($subject -imatch '^(re|fw[d]?)\\s*:') { continue }` : ''}
+        ${filter.requireAttachment ? `if ($item.Attachments.Count -eq 0) { continue }` : ''}
+        $attNames = @()
+        foreach ($att in $item.Attachments) { $attNames += $att.FileName }
+        $bodyRaw = if ($item.Body) { $item.Body } else { '' }
+        $bodyB64 = [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($bodyRaw))
+${scripts_1.SENDER_SMTP_PS}
+        $received = ''
+        try { $received = $item.ReceivedTime.ToString('yyyy-MM-dd HH:mm') } catch {}
+        $results += [PSCustomObject]@{
+            entryId = $item.EntryID
+            storeId = $storeId
+            subject = $item.Subject.Trim()
+            senderName = if ($item.SenderName) { $item.SenderName } else { '' }
+            senderEmail = $senderSmtp
+            receivedTime = $received
+            body = $bodyB64
+            attachmentNames = $attNames
+            folderPath = $folder.FolderPath
+        }
+    }
+}
+ConvertTo-Json $results -Depth 3
+`;
+    // Returns whole message bodies, so this is the call most likely to push against
+    // the stdout cap — raise `maxBufferBytes` via configure() before a scan that
+    // matches thousands of emails.
+    return (0, json_1.parseArray)(await (0, run_1.runPowerShell)(script, 300000)).map(item => {
+        const e = (0, json_1.record)(item);
+        return {
+            entryId: (0, json_1.str)(e.entryId),
+            storeId: (0, json_1.str)(e.storeId),
+            subject: (0, json_1.str)(e.subject),
+            senderName: (0, json_1.str)(e.senderName),
+            senderEmail: (0, json_1.str)(e.senderEmail),
+            receivedTime: (0, json_1.str)(e.receivedTime),
+            body: decodeBody(e.body),
+            attachmentNames: (0, json_1.toArray)(e.attachmentNames).map(json_1.str),
+            folderPath: (0, json_1.str)(e.folderPath),
+        };
+    });
+}
+/**
+ * Read the email currently selected (or open) in Outlook — full body,
+ * attachments listed by name but not saved.
+ */
+async function readSelectedEmail() {
+    (0, run_1.requireWindows)();
+    const script = `
+$outlook = New-Object -ComObject Outlook.Application
+$item = $null
+try {
+    $explorer = $outlook.ActiveExplorer()
+    if ($explorer -ne $null) {
+        $sel = $explorer.Selection
+        if ($sel -ne $null -and $sel.Count -ge 1) { $item = $sel.Item(1) }
+    }
+} catch {}
+if ($item -eq $null) {
+    try {
+        $insp = $outlook.ActiveInspector()
+        if ($insp -ne $null) { $item = $insp.CurrentItem }
+    } catch {}
+}
+if ($item -eq $null) { throw 'No email is selected in Outlook. Open Outlook, select (or open) an email, then try again.' }
+if ($item.MessageClass -notlike 'IPM.Note*') { throw 'The selected Outlook item is not an email.' }
+$attNames = @()
+foreach ($att in $item.Attachments) { $attNames += $att.FileName }
+$subject = ''
+if ($item.Subject) { $subject = $item.Subject.Trim() }
+$bodyRaw = if ($item.Body) { $item.Body } else { '' }
+$bodyB64 = [Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($bodyRaw))
+$storeId = ''
+try { $storeId = $item.Parent.Store.StoreID } catch {}
+${scripts_1.SENDER_SMTP_PS}
+$received = ''
+try { $received = $item.ReceivedTime.ToString('yyyy-MM-dd HH:mm') } catch {}
+$result = [PSCustomObject]@{
+    entryId = $item.EntryID
+    storeId = $storeId
+    subject = $subject
+    senderName = if ($item.SenderName) { $item.SenderName } else { '' }
+    senderEmail = $senderSmtp
+    receivedTime = $received
+    body = $bodyB64
+    attachmentNames = $attNames
+}
+ConvertTo-Json $result -Depth 3
+`;
+    const raw = await (0, run_1.runPowerShell)(script, 30000);
+    if (!raw || raw.trim() === '' || raw.trim() === 'null') {
+        throw new errors_1.NotFoundError('email', 'Failed to read the selected Outlook email.');
+    }
+    const e = (0, json_1.parseObject)(raw);
+    return {
+        entryId: (0, json_1.str)(e.entryId),
+        storeId: (0, json_1.str)(e.storeId),
+        subject: (0, json_1.str)(e.subject),
+        senderName: (0, json_1.str)(e.senderName),
+        senderEmail: (0, json_1.str)(e.senderEmail),
+        receivedTime: (0, json_1.str)(e.receivedTime),
+        body: decodeBody(e.body),
+        attachmentNames: (0, json_1.toArray)(e.attachmentNames).map(json_1.str),
+    };
+}
+/** Open an email in Outlook by its EntryID. */
+async function openOutlookEmail(entryId) {
+    (0, run_1.requireWindows)();
+    const script = `(New-Object -ComObject Outlook.Application).GetNamespace('mapi').GetItemFromID('${(0, run_1.psEscape)(entryId)}').Display()`;
+    await (0, run_1.runPowerShell)(script);
+}
+//# sourceMappingURL=read.js.map

package/dist/windows/read.js.map

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

package/dist/windows/run.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Refuse before generating anything when this isn't Windows.
+ *
+ * Called at the top of each operation as well as inside the two runners, so a
+ * call that would have written temp files or made preparatory reads doesn't do
+ * any of that first. The runners hold the only copy of the check itself — three
+ * near-identical guards worded three different ways is how "not supported" came
+ * to mean two different sentences.
+ */
+export declare function requireWindows(): void;
+/**
+ * Escape a string for a PowerShell SINGLE-quoted literal — the only context
+ * caller-supplied text may go in.
+ *
+ * A double-quoted PowerShell string expands `$(...)` subexpressions, so text
+ * placed there would execute. Where a generated script needs user text inside a
+ * double-quoted string (a Restrict query, which must expand `$cutoff`), assign
+ * it to a variable with this first and concatenate — see read.ts.
+ */
+export declare function psEscape(s: string): string;
+/** A PowerShell array literal of single-quoted strings. */
+export declare function psList(values: readonly string[]): string;
+/** `$true` / `$false` — PowerShell has no bare boolean literal. */
+export declare function psBool(value: boolean): string;
+/**
+ * Run a generated script and return its stdout.
+ *
+ * `timeout` overrides the configured default for this one call — pass it where a
+ * call has a genuinely different budget (a full-mailbox walk, a purge) rather
+ * than relying on the global. See `configure()` for both knobs.
+ */
+export declare function runPowerShell(script: string, timeout?: number): Promise<string>;
+/**
+ * Run a generated script from a temp `.ps1` file rather than `-Command`.
+ *
+ * For the two calls that drive a compose window: a script passed on the command
+ * line competes with the command-line length limit, and these carry enough
+ * inline text to reach it. Failures classify exactly as `runPowerShell`'s do —
+ * the file is an implementation detail, not a second error contract.
+ */
+export declare function runPowerShellFile(script: string, timeout?: number): Promise<string>;
+/**
+ * Write text a script will read back, and hand back a cleanup callback.
+ *
+ * Large HTML — an email body, a Word-sized template — goes to a file rather than
+ * into the script text: inline, it is what pushes a generated script past the
+ * command-line length limit.
+ */
+export declare function scriptInput(kind: string, contents: string): {
+    path: string;
+    cleanup(): void;
+};
+/** Read a file written by a script, as UTF-8, or '' when it never appeared. */
+export declare function readScriptOutput(path: string): string;

package/dist/windows/run.js

@@ -0,0 +1,161 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireWindows = requireWindows;
+exports.psEscape = psEscape;
+exports.psList = psList;
+exports.psBool = psBool;
+exports.runPowerShell = runPowerShell;
+exports.runPowerShellFile = runPowerShellFile;
+exports.scriptInput = scriptInput;
+exports.readScriptOutput = readScriptOutput;
+// Getting a generated script to Windows PowerShell and its output back.
+//
+// Every Windows function here is "build a script, run it, coerce the JSON", so
+// this module owns the two halves nobody should reimplement: the run itself
+// (encoding, timeout, cancellation, failure classification, the debug hook) and
+// the escaping rules for putting caller text into a script safely.
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("fs"));
+const runtime_1 = require("../runtime");
+const errors_1 = require("../errors");
+const RUNNER = 'powershell';
+/**
+ * Refuse before generating anything when this isn't Windows.
+ *
+ * Called at the top of each operation as well as inside the two runners, so a
+ * call that would have written temp files or made preparatory reads doesn't do
+ * any of that first. The runners hold the only copy of the check itself — three
+ * near-identical guards worded three different ways is how "not supported" came
+ * to mean two different sentences.
+ */
+function requireWindows() {
+    if (process.platform !== 'win32') {
+        throw new errors_1.UnsupportedPlatformError(process.platform, 'Outlook COM automation is only supported on Windows.');
+    }
+}
+/**
+ * Escape a string for a PowerShell SINGLE-quoted literal — the only context
+ * caller-supplied text may go in.
+ *
+ * A double-quoted PowerShell string expands `$(...)` subexpressions, so text
+ * placed there would execute. Where a generated script needs user text inside a
+ * double-quoted string (a Restrict query, which must expand `$cutoff`), assign
+ * it to a variable with this first and concatenate — see read.ts.
+ */
+function psEscape(s) {
+    return s.replace(/'/g, "''");
+}
+/** A PowerShell array literal of single-quoted strings. */
+function psList(values) {
+    return values.map(v => `'${psEscape(v)}'`).join(',');
+}
+/** `$true` / `$false` — PowerShell has no bare boolean literal. */
+function psBool(value) {
+    return value ? '$true' : '$false';
+}
+// Force UTF-8 on stdout. Windows PowerShell 5.1 otherwise encodes output in the
+// OEM/ANSI console code page, whose "best-fit" mapping silently rewrites
+// non-ASCII characters — e.g. a curly quote (U+201C) in an email body becomes a
+// plain " — which corrupts the JSON these scripts emit (an unescaped quote) and
+// breaks JSON.parse. Setting the output encoding first makes non-ASCII survive
+// as real UTF-8 bytes, which Node then decodes correctly.
+const UTF8_PRELUDE = '[Console]::OutputEncoding = [System.Text.Encoding]::UTF8\n';
+/**
+ * Run a generated script and return its stdout.
+ *
+ * `timeout` overrides the configured default for this one call — pass it where a
+ * call has a genuinely different budget (a full-mailbox walk, a purge) rather
+ * than relying on the global. See `configure()` for both knobs.
+ */
+function runPowerShell(script, timeout) {
+    requireWindows();
+    const utf8Script = UTF8_PRELUDE + script;
+    return spawnPowerShell(['-NoProfile', '-NonInteractive', '-Command', utf8Script], utf8Script, timeout);
+}
+/**
+ * Run a generated script from a temp `.ps1` file rather than `-Command`.
+ *
+ * For the two calls that drive a compose window: a script passed on the command
+ * line competes with the command-line length limit, and these carry enough
+ * inline text to reach it. Failures classify exactly as `runPowerShell`'s do —
+ * the file is an implementation detail, not a second error contract.
+ */
+async function runPowerShellFile(script, timeout) {
+    requireWindows();
+    const scriptFile = (0, runtime_1.tempFile)('script', 'ps1');
+    fs_1.default.writeFileSync(scriptFile, UTF8_PRELUDE + script, 'utf-8');
+    try {
+        return await spawnPowerShell(['-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-File', scriptFile], script, timeout);
+    }
+    finally {
+        try {
+            fs_1.default.unlinkSync(scriptFile);
+        }
+        catch { /* the run is done; a leftover scratch file is not worth failing on */
+        }
+    }
+}
+/** The one place a PowerShell child is spawned, timed, classified and reported. */
+function spawnPowerShell(args, script, timeout) {
+    const { timeoutMs, maxBufferBytes, signal } = (0, runtime_1.getConfig)();
+    const effectiveTimeout = timeout ?? timeoutMs;
+    const startedAt = Date.now();
+    return new Promise((resolve, reject) => {
+        (0, child_process_1.execFile)('powershell.exe', args, { maxBuffer: maxBufferBytes, timeout: effectiveTimeout, signal }, (error, stdout, stderr) => {
+            const durationMs = Date.now() - startedAt;
+            if (error) {
+                const failure = (0, errors_1.classifyRunFailure)({
+                    runner: RUNNER,
+                    script,
+                    stderr: (stderr || error.message).trim(),
+                    durationMs,
+                    nodeError: error,
+                    timeoutMs: effectiveTimeout,
+                    signal,
+                });
+                (0, runtime_1.reportRun)({ runner: RUNNER, script, durationMs, error: failure.message });
+                reject(failure);
+            }
+            else {
+                (0, runtime_1.reportRun)({ runner: RUNNER, script, durationMs });
+                resolve(stdout.trim());
+            }
+        });
+    });
+}
+/**
+ * Write text a script will read back, and hand back a cleanup callback.
+ *
+ * Large HTML — an email body, a Word-sized template — goes to a file rather than
+ * into the script text: inline, it is what pushes a generated script past the
+ * command-line length limit.
+ */
+function scriptInput(kind, contents) {
+    const path = (0, runtime_1.tempFile)(kind, 'html');
+    fs_1.default.writeFileSync(path, contents, 'utf-8');
+    return {
+        path,
+        cleanup() {
+            try {
+                fs_1.default.unlinkSync(path);
+            }
+            catch { /* ignore */
+            }
+        },
+    };
+}
+/** Read a file written by a script, as UTF-8, or '' when it never appeared. */
+function readScriptOutput(path) {
+    try {
+        const contents = fs_1.default.readFileSync(path, 'utf-8');
+        fs_1.default.unlinkSync(path);
+        return contents;
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/windows/run.js.map

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

package/dist/windows/scripts.d.ts

@@ -0,0 +1,56 @@
+import type { MailFolderRef } from '../types';
+/**
+ * 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.
+ */
+export declare function accountScript(emailAccount: string): string;
+/** The account's own delivery store, as `$store`. Requires `accountScript`. */
+export declare const DELIVERY_STORE_PS = "\n$store = $account.DeliveryStore\n$storeId = $store.StoreID\n";
+/**
+ * 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.
+ */
+export declare function namedStoreScript(emailAccount: string): string;
+/**
+ * Resolve one item into `$item`. A StoreID disambiguates across mailboxes, so
+ * pass it whenever the listing that produced the id carried one.
+ */
+export declare function getItemScript(entryId: string, storeId?: string): string;
+/**
+ * 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.
+ */
+export declare const SENDER_SMTP_PS = "\n$senderSmtp = ''\ntry {\n    if ($item.SenderEmailType -eq 'EX') { $senderSmtp = $item.Sender.GetExchangeUser().PrimarySmtpAddress }\n} catch {}\nif (-not $senderSmtp) { $senderSmtp = if ($item.SenderEmailAddress) { $item.SenderEmailAddress } else { '' } }\n";
+/**
+ * Recursive folder-by-name search. Case-insensitive, depth-capped so a huge
+ * mailbox tree can't hang the scan.
+ */
+export declare const FIND_FOLDER_PS = "\nfunction Find-FolderByName($root, $name, $depth) {\n    foreach ($f in $root.Folders) {\n        if ($f.Name -ieq $name) { return $f }\n    }\n    if ($depth -le 1) { return $null }\n    foreach ($f in $root.Folders) {\n        $hit = Find-FolderByName $f $name ($depth - 1)\n        if ($hit -ne $null) { return $hit }\n    }\n    return $null\n}\n";
+/**
+ * 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.
+ */
+export declare function mailScopeScript(ref: MailFolderRef, folderLabel?: string, createMissing?: boolean): string;