@dawnlit/outlook-bridge 1.1.1 → 2.1.0

package/dist/windows/bounces.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.cleanUndeliverableEmails = cleanUndeliverableEmails;
 exports.collectBouncedRecipients = collectBouncedRecipients;
 exports.readSentRecipientGroups = readSentRecipientGroups;
-// Bounce-backs: finding them, filing them away, and mining them for the
+// Bounce-backs: finding them, clearing them away, and mining them for the
 // addresses that failed.
 const run_1 = require("./run");
 const scripts_1 = require("./scripts");
@@ -11,257 +11,225 @@ const json_1 = require("../shared/json");
 const bounceRules_1 = require("../shared/bounceRules");
 const mail_1 = require("../mail");
 /**
- * The classifier lists, generated from the shared rules so Windows and macOS
- * cannot come to disagree about what a bounce is. Emitted once per script,
- * before the item loop.
- */
-const BOUNCE_LISTS_PS = `
-$phrases = @(${(0, run_1.psList)(bounceRules_1.BOUNCE_SUBJECT_PHRASES)})
-$daemonAddr = @(${(0, run_1.psList)(bounceRules_1.BOUNCE_DAEMON_ADDRESSES)})
-$daemonName = @(${(0, run_1.psList)(bounceRules_1.BOUNCE_DAEMON_NAMES)})
-`;
-/**
- * Per-item classifier. Given an Outlook item in `$item` and the account address
- * (lowercased) in `$targetLc`, sets `$reason` to why it's a bounce ('' if not)
- * and fills `$failedRcpts` with the recipient addresses parsed from the bounce
- * body. Also leaves `$subj`/`$sName`/`$sEmail` populated for the caller's report.
+ * The classifier, generated from the shared rules so Windows and macOS can't
+ * disagree about what a bounce is. Defines `Get-BounceReport`, which returns
+ * null for an item that isn't a bounce and a report row for one that is.
  *
- * The body is only read once a cheaper signal (class/sender/subject) has already
+ * The body is read only after a cheaper signal (class, sender, subject) has
  * matched — that ordering is what keeps a large-inbox scan affordable.
  */
-const BOUNCE_CLASSIFY_PS = `
-$reason = ''
-$failedRcpts = @()
-$subj = ''
-$sName = ''
-$sEmail = ''
-$cls = 0
-try { $cls = [int]$item.Class } catch {}
-if ($cls -eq 43 -or $cls -eq 46) {
-    try { if ($item.Subject) { $subj = [string]$item.Subject } } catch {}
-    $subjLc = $subj.ToLower()
-    try { if ($item.SenderName) { $sName = [string]$item.SenderName } } catch {}
-    $sNameLc = $sName.ToLower()
-    try { if ($item.SenderEmailAddress) { $sEmail = [string]$item.SenderEmailAddress } } catch {}
-    $sEmailLc = $sEmail.ToLower()
-    $msgClass = ''
-    try { $msgClass = [string]$item.MessageClass } catch {}
-    if ($msgClass -like '${bounceRules_1.NDR_MESSAGE_CLASS_PREFIX}*') { $reason = 'Non-delivery report (NDR)' }
-    if ($reason -eq '') { foreach ($d in $daemonAddr) { if ($sEmailLc.Contains($d)) { $reason = 'From mail-delivery system'; break } } }
-    if ($reason -eq '') { foreach ($d in $daemonName) { if ($sNameLc.Contains($d)) { $reason = 'From mail-delivery system'; break } } }
-    if ($reason -eq '') { foreach ($p in $phrases) { if ($subjLc.Contains($p)) { $reason = "Bounce subject phrase: '$p'"; break } } }
-    if ($reason -ne '') {
-        $bodyRaw = ''
-        try { if ($item.Body) { $bodyRaw = [string]$item.Body } } catch {}
-        if ($bodyRaw -ne '') {
-            $mm = [regex]::Matches($bodyRaw, '${bounceRules_1.BODY_ADDRESS_PATTERN}')
-            foreach ($m in $mm) {
-                $addr = $m.Value.ToLower().TrimEnd('.')
-                if ($addr -eq $targetLc) { continue }
-                if ($addr.Contains('mailer-daemon') -or $addr.Contains('postmaster') -or $addr.Contains('mail-daemon')) { continue }
-                if ($failedRcpts -notcontains $addr) { $failedRcpts += $addr }
-                if ($failedRcpts.Count -ge 5) { break }
-            }
-        }
+function bounceClassifierScript() {
+    return `
+$bouncePhrases = ${(0, run_1.psArray)(bounceRules_1.BOUNCE_SUBJECT_PHRASES)}
+$daemonAddresses = ${(0, run_1.psArray)(bounceRules_1.BOUNCE_DAEMON_ADDRESSES)}
+$daemonNames = ${(0, run_1.psArray)(bounceRules_1.BOUNCE_DAEMON_NAMES)}
+$daemonSelf = ${(0, run_1.psArray)(bounceRules_1.DAEMON_SELF_ADDRESSES)}
+$ndrPrefix = ${(0, run_1.psString)(bounceRules_1.NDR_MESSAGE_CLASS_PREFIX)}
+$addressPattern = ${(0, run_1.psString)(bounceRules_1.BODY_ADDRESS_PATTERN)}
+$maxFailed = ${(0, run_1.psInt)(bounceRules_1.MAX_FAILED_RECIPIENTS)}
+$accountLower = $target.ToLower()
+function Get-BounceReport($item) {
+    $class = 0
+    try { $class = [int]$item.Class } catch {}
+    if ($class -ne 43 -and $class -ne 46) { return $null }
+    $subject = ''
+    try { $subject = [string]$item.Subject } catch {}
+    $senderName = ''
+    try { $senderName = [string]$item.SenderName } catch {}
+    $senderEmail = ''
+    try { $senderEmail = [string]$item.SenderEmailAddress } catch {}
+    $messageClass = ''
+    try { $messageClass = [string]$item.MessageClass } catch {}
+    $reason = ''
+    if ($messageClass.StartsWith($ndrPrefix, [StringComparison]::OrdinalIgnoreCase)) { $reason = ${(0, run_1.psString)(bounceRules_1.BOUNCE_REASON.ndr)} }
+    if (-not $reason) { foreach ($d in $daemonAddresses) { if ($senderEmail.ToLower().Contains($d)) { $reason = ${(0, run_1.psString)(bounceRules_1.BOUNCE_REASON.daemon)}; break } } }
+    if (-not $reason) { foreach ($d in $daemonNames) { if ($senderName.ToLower().Contains($d)) { $reason = ${(0, run_1.psString)(bounceRules_1.BOUNCE_REASON.daemon)}; break } } }
+    if (-not $reason) { foreach ($p in $bouncePhrases) { if ($subject.ToLower().Contains($p)) { $reason = "${bounceRules_1.BOUNCE_REASON.subjectPhrase('$p')}"; break } } }
+    if (-not $reason) { return $null }
+    $failedRecipients = @()
+    $body = ''
+    try { $body = [string]$item.Body } catch {}
+    foreach ($m in [regex]::Matches($body, $addressPattern)) {
+        $address = $m.Value.ToLower().TrimEnd('.')
+        if ($address -eq $accountLower) { continue }
+        $isDaemon = $false
+        foreach ($d in $daemonSelf) { if ($address.Contains($d)) { $isDaemon = $true; break } }
+        if ($isDaemon -or $failedRecipients -contains $address) { continue }
+        $failedRecipients += $address
+        if ($failedRecipients.Count -ge $maxFailed) { break }
+    }
+    $received = ''
+    try { $received = $item.ReceivedTime.ToString('yyyy-MM-dd HH:mm') } catch {}
+    return [PSCustomObject]@{
+        entryId          = [string]$item.EntryID
+        subject          = $subject.Trim()
+        senderName       = $senderName
+        senderEmail      = $senderEmail
+        receivedTime     = $received
+        matchedReason    = $reason
+        failedRecipients = @($failedRecipients)
     }
 }
 `;
+}
 /**
- * Scan an account's inbox for bounce-back / non-delivery messages — Outlook NDRs,
- * mail-daemon/postmaster rejections, and "Message blocked"-style Google/O365
- * failure notices — and, unless previewing, move each to Deleted Items (recoverable).
+ * Scan an account's Inbox for bounce-backs and, unless dry-running, move each to
+ * Deleted Items (recoverable).
  *
- * Classification is deliberately conservative so ordinary mail that merely
- * mentions "delivery" is never caught: an item matches only when its
- * MessageClass is an NDR report, its sender fingerprints as a mail-delivery
- * daemon/postmaster, or its subject contains a specific bounce phrase.
- *
- * Matched item references are snapshotted before any Delete() call — deleting
- * mutates the folder collection, so deleting mid-enumeration would skip items
- * (same pattern as sendAllDrafts).
+ * Matched items are collected before the first Delete(): deleting shifts the
+ * collection, and deleting mid-enumeration would skip items.
  */
-async function cleanUndeliverableEmails(emailAccount, daysBack = 30, dryRun = true) {
-    (0, run_1.requireWindows)();
-    const days = (0, mail_1.clamp)(daysBack, 1, 365);
-    const script = `${(0, scripts_1.accountScript)(emailAccount)}
-$dryRun = ${(0, run_1.psBool)(dryRun)}
-${(0, scripts_1.namedStoreScript)(emailAccount)}
-$inbox = $store.GetDefaultFolder(6)
-$cutoff = (Get-Date).AddDays(-${days}).ToString('MM/dd/yyyy HH:mm')
-$filtered = $inbox.Items.Restrict("[ReceivedTime] >= '$cutoff'")
-${BOUNCE_LISTS_PS}
-$targetLc = $target.ToLower()
-$matched = @()   # snapshot of COM item refs to (optionally) delete afterward
-$report = @()
+async function cleanUndeliverableEmails(request) {
+    const output = await (0, run_1.runPowerShellJson)(`${(0, scripts_1.accountScript)(request.account)}
+${scripts_1.NAMED_STORE_PS}
+${bounceClassifierScript()}
+$dryRun = ${(0, run_1.psBool)(request.dryRun)}
+$inbox = $store.GetDefaultFolder(${(0, run_1.psInt)(mail_1.FolderId.Inbox)})
+${(0, scripts_1.cutoffScript)(request.daysBack)}
+${(0, scripts_1.itemsSinceScript)('inbox', 'ReceivedTime')}
+$reports = @()
+$matchedItems = @()
 $count = $filtered.Count
 for ($i = 1; $i -le $count; $i++) {
     $item = $null
     try { $item = $filtered.Item($i) } catch { continue }
     if ($item -eq $null) { continue }
-${BOUNCE_CLASSIFY_PS}
-    if ($reason -eq '') { continue }
-
-    $rt = ''
-    try { $rt = $item.ReceivedTime.ToString('yyyy-MM-dd HH:mm') } catch {}
-    $report += [PSCustomObject]@{
-        entryId = $item.EntryID
-        subject = $subj.Trim()
-        senderName = $sName
-        senderEmail = $sEmail
-        receivedTime = $rt
-        matchedReason = $reason
-        failedRecipients = @($failedRcpts)
-    }
-    $matched += $item
+    $received = $null
+    try { $received = $item.ReceivedTime } catch {}
+    if ($received -ne $null -and $received -lt $cutoff) { continue }
+    $report = Get-BounceReport $item
+    if ($report -eq $null) { continue }
+    $reports += $report
+    $matchedItems += $item
 }
-
 $deleted = 0
 $failed = @()
 if (-not $dryRun) {
-    foreach ($m in $matched) {
-        $s = ''
-        try { $s = [string]$m.Subject } catch {}
+    foreach ($m in $matchedItems) {
+        $entryId = ''
+        $subject = ''
+        try { $entryId = [string]$m.EntryID } catch {}
+        try { $subject = [string]$m.Subject } catch {}
         try { $m.Delete(); $deleted++ }
-        catch { $failed += [PSCustomObject]@{ subject = $s; error = $_.Exception.Message } }
+        catch { ${(0, json_1.itemFailurePs)('$entryId')} }
     }
 }
-
-[PSCustomObject]@{
-    account = $target
-    scannedDays = ${days}
-    dryRun = $dryRun
-    matchedCount = $report.Count
+ConvertTo-Json -Depth 4 -InputObject ([PSCustomObject]@{
     deletedCount = $deleted
-    matched = @($report)
-    failed = @($failed)
-} | ConvertTo-Json -Depth 4
-`;
-    const parsed = (0, json_1.parseObject)(await (0, run_1.runPowerShell)(script, 300000));
+    matched      = @($reports)
+    failed       = @($failed)
+})
+`, 'scan');
+    const e = (0, json_1.record)(output);
+    const matched = (0, json_1.toArray)(e.matched).map(row => {
+        const m = (0, json_1.record)(row);
+        return {
+            entryId: (0, json_1.str)(m.entryId),
+            subject: (0, json_1.str)(m.subject),
+            senderName: (0, json_1.str)(m.senderName),
+            senderEmail: (0, json_1.str)(m.senderEmail),
+            receivedTime: (0, json_1.str)(m.receivedTime),
+            matchedReason: (0, json_1.str)(m.matchedReason),
+            failedRecipients: (0, json_1.strList)(m.failedRecipients),
+        };
+    });
     return {
-        account: (0, json_1.str)(parsed.account) || emailAccount,
-        scannedDays: (0, json_1.num)(parsed.scannedDays) || days,
-        dryRun: parsed.dryRun !== false,
-        matchedCount: (0, json_1.num)(parsed.matchedCount),
-        deletedCount: (0, json_1.num)(parsed.deletedCount),
-        matched: (0, json_1.toArray)(parsed.matched).map(m => {
-            const e = (0, json_1.record)(m);
-            return {
-                entryId: (0, json_1.str)(e.entryId),
-                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),
-                matchedReason: (0, json_1.str)(e.matchedReason),
-                failedRecipients: (0, json_1.toArray)(e.failedRecipients).map(json_1.str),
-            };
-        }),
-        failed: (0, json_1.toArray)(parsed.failed).map(f => {
-            const e = (0, json_1.record)(f);
-            return { subject: (0, json_1.str)(e.subject), error: (0, json_1.str)(e.error) };
-        }),
+        account: request.account,
+        scannedDays: request.daysBack,
+        dryRun: request.dryRun,
+        matchedCount: matched.length,
+        deletedCount: (0, json_1.num)(e.deletedCount),
+        matched,
+        failed: (0, json_1.itemFailures)(e.failed),
     };
 }
 /**
- * Read-only scan of an account's Inbox (and, when scanDeleted, its Deleted Items)
- * for bounce messages, returning just the deduped set of failed recipient
- * addresses. Uses the same conservative classifier as cleanUndeliverableEmails.
- *
- * Deleted Items is included so this still works after cleanUndeliverableEmails has
- * already filed the bounces there — the blacklist step doesn't depend on running
- * before the cleanup. This never deletes anything.
+ * The deduplicated addresses bounce-backs report as failed, from the Inbox and,
+ * optionally, Deleted Items — so it still works after the bounces were cleaned
+ * away. Never deletes anything.
  */
-async function collectBouncedRecipients(emailAccount, daysBack = 30, scanDeleted = true) {
-    if (process.platform !== 'win32')
-        return [];
-    const days = (0, mail_1.clamp)(daysBack, 1, 365);
-    // 6 = Inbox, 3 = Deleted Items.
-    const folderIds = scanDeleted ? '@(6, 3)' : '@(6)';
-    const script = `${(0, scripts_1.accountScript)(emailAccount)}
+async function collectBouncedRecipients(request) {
+    const roles = request.includeDeletedItems ? [mail_1.FolderId.Inbox, mail_1.FolderId.DeletedItems] : [mail_1.FolderId.Inbox];
+    const output = await (0, run_1.runPowerShellJson)(`${(0, scripts_1.accountScript)(request.account)}
 ${scripts_1.DELIVERY_STORE_PS}
-$cutoff = (Get-Date).AddDays(-${days}).ToString('MM/dd/yyyy HH:mm')
-${BOUNCE_LISTS_PS}
-$targetLc = $target.ToLower()
-$found = @{}
-foreach ($fid in ${folderIds}) {
-    $folder = $null
-    try { $folder = $store.GetDefaultFolder($fid) } catch {}
-    if ($folder -eq $null) { continue }
-    $filtered = $folder.Items.Restrict("[ReceivedTime] >= '$cutoff'")
+${bounceClassifierScript()}
+${(0, scripts_1.cutoffScript)(request.daysBack)}
+$found = [ordered]@{}
+foreach ($role in @(${roles.map(run_1.psInt).join(', ')})) {
+    $scanFolder = $null
+    try { $scanFolder = $store.GetDefaultFolder($role) } catch {}
+    if ($scanFolder -eq $null) { continue }
+    ${(0, scripts_1.itemsSinceScript)('scanFolder', 'ReceivedTime').trim()}
     $count = $filtered.Count
     for ($i = 1; $i -le $count; $i++) {
         $item = $null
         try { $item = $filtered.Item($i) } catch { continue }
         if ($item -eq $null) { continue }
-${BOUNCE_CLASSIFY_PS}
-        if ($reason -eq '') { continue }
-        foreach ($a in $failedRcpts) { $found[$a] = $true }
+        $received = $null
+        try { $received = $item.ReceivedTime } catch {}
+        if ($received -ne $null -and $received -lt $cutoff) { continue }
+        $report = Get-BounceReport $item
+        if ($report -eq $null) { continue }
+        foreach ($address in $report.failedRecipients) { $found[$address] = $true }
     }
 }
-ConvertTo-Json @($found.Keys) -Depth 2
-`;
-    return (0, json_1.parseArray)(await (0, run_1.runPowerShell)(script, 300000)).map(json_1.str).filter(Boolean);
+ConvertTo-Json -Compress -InputObject @($found.Keys)
+`, 'scan');
+    return (0, json_1.strList)(output);
 }
 /**
- * Read the account's Sent Items within the window, returning each mail with the
- * full SMTP address set it was sent to (To + CC + BCC), newest first. This is how
- * the "was every address for this contact tried?" question gets answered: where a
- * blast sends one email per organization addressed to all of its addresses, a sent
- * message's recipient set IS that organization's full address set.
+ * Sent Items within the window, each message with the full SMTP address set it
+ * went to (To + CC + BCC), newest first.
  */
-async function readSentRecipientGroups(emailAccount, daysBack = 30, limit = 3000) {
-    if (process.platform !== 'win32')
-        return [];
-    const days = (0, mail_1.clamp)(daysBack, 1, 365);
-    const cap = (0, mail_1.clamp)(limit, 1, 10000);
-    const script = `${(0, scripts_1.accountScript)(emailAccount)}
+async function readSentRecipientGroups(request) {
+    const output = await (0, run_1.runPowerShellJson)(`${(0, scripts_1.accountScript)(request.account)}
 ${scripts_1.DELIVERY_STORE_PS}
-$sent = $store.GetDefaultFolder(5)  # olFolderSentMail
-$cutoff = (Get-Date).AddDays(-${days}).ToString('MM/dd/yyyy HH:mm')
-$items = $sent.Items.Restrict("[SentOn] >= '$cutoff'")
-$items.Sort('[SentOn]', $true)
-$results = @()
-$count = [Math]::Min($items.Count, ${cap})
-for ($i = 1; $i -le $count; $i++) {
+$sentFolder = $store.GetDefaultFolder(${(0, run_1.psInt)(mail_1.FolderId.SentMail)})
+${(0, scripts_1.cutoffScript)(request.daysBack)}
+${(0, scripts_1.itemsSinceScript)('sentFolder', 'SentOn')}
+$filtered.Sort('[SentOn]', $true)
+$limit = ${(0, run_1.psInt)(request.limit)}
+$rows = @()
+$count = $filtered.Count
+for ($i = 1; $i -le $count -and $rows.Count -lt $limit; $i++) {
     $m = $null
-    try { $m = $items.Item($i) } catch { continue }
+    try { $m = $filtered.Item($i) } catch { continue }
     if ($m -eq $null) { continue }
-    $cls = 0
-    try { $cls = [int]$m.Class } catch {}
-    if ($cls -ne 43) { continue }  # olMail only
-    $addrs = @()
+    $sentOn = $null
+    try { $sentOn = $m.SentOn } catch {}
+    if ($sentOn -ne $null -and $sentOn -lt $cutoff) { break }
+    $class = 0
+    try { $class = [int]$m.Class } catch {}
+    if ($class -ne 43) { continue }
+    $addresses = @()
     try {
         foreach ($r in $m.Recipients) {
-            $addr = ''
-            try { $addr = [string]$r.Address } catch {}
-            # Internal recipients resolve to an Exchange DN, not SMTP — recover the
-            # real address so external correlation still works.
-            if ($addr -notlike '*@*') {
-                try { $addr = [string]$r.AddressEntry.GetExchangeUser().PrimarySmtpAddress } catch {}
+            $address = ''
+            try { $address = [string]$r.Address } catch {}
+            # An internal recipient resolves to an Exchange DN; recover its SMTP address.
+            if ($address -notlike '*@*') {
+                try { $address = [string]$r.AddressEntry.GetExchangeUser().PrimarySmtpAddress } catch {}
             }
-            if ($addr -like '*@*') { $addrs += $addr.ToLower() }
+            if ($address -like '*@*') { $addresses += $address.ToLower() }
         }
     } catch {}
-    if ($addrs.Count -eq 0) { continue }
-    $sentOn = ''
-    try { $sentOn = $m.SentOn.ToString('yyyy-MM-dd HH:mm') } catch {}
-    $subj = ''
-    try { if ($m.Subject) { $subj = [string]$m.Subject } } catch {}
-    $results += [PSCustomObject]@{
-        entryId = $m.EntryID
-        subject = $subj.Trim()
-        sentOn = $sentOn
-        recipients = @($addrs)
+    if ($addresses.Count -eq 0) { continue }
+    $rows += [PSCustomObject]@{
+        entryId    = [string]$m.EntryID
+        subject    = ([string]$m.Subject).Trim()
+        sentOn     = if ($sentOn -ne $null) { $sentOn.ToString('yyyy-MM-dd HH:mm') } else { '' }
+        recipients = @($addresses)
     }
 }
-ConvertTo-Json @($results) -Depth 4
-`;
-    return (0, json_1.parseArray)(await (0, run_1.runPowerShell)(script, 300000)).map(it => {
-        const e = (0, json_1.record)(it);
+ConvertTo-Json -Depth 4 -InputObject @($rows)
+`, 'scan');
+    return (0, json_1.toArray)(output).map(row => {
+        const e = (0, json_1.record)(row);
         return {
             entryId: (0, json_1.str)(e.entryId),
             subject: (0, json_1.str)(e.subject),
             sentOn: (0, json_1.str)(e.sentOn),
-            recipients: (0, json_1.toArray)(e.recipients).map(json_1.str),
+            recipients: (0, json_1.strList)(e.recipients),
         };
     });
 }

package/dist/windows/bounces.js.map

@@ -1 +1 @@
-{"version":3,"file":"bounces.js","sourceRoot":"","sources":["../../src/windows/bounces.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bounces.js","sourceRoot":"","sources":["../../src/windows/bounces.ts"],"names":[],"mappings":"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","sourcesContent":["// Bounce-backs: finding them, clearing them away, and mining them for the\n// addresses that failed.\nimport { psArray, psBool, psInt, psString, runPowerShellJson } from './run';\nimport { accountScript, cutoffScript, DELIVERY_STORE_PS, itemsSinceScript, NAMED_STORE_PS } from './scripts';\nimport { itemFailurePs, itemFailures, num, record, str, strList, toArray } from '../shared/json';\nimport {\n    BODY_ADDRESS_PATTERN,\n    BOUNCE_DAEMON_ADDRESSES,\n    BOUNCE_DAEMON_NAMES,\n    BOUNCE_REASON,\n    BOUNCE_SUBJECT_PHRASES,\n    DAEMON_SELF_ADDRESSES,\n    MAX_FAILED_RECIPIENTS,\n    NDR_MESSAGE_CLASS_PREFIX,\n} from '../shared/bounceRules';\nimport { FolderId } from '../mail';\nimport type { CleanUndeliverableRequest, CollectBouncesRequest, SentGroupsRequest } from '../backend';\nimport type { CleanUndeliverableResult, SentRecipientGroup } from '../types';\n\n/**\n * The classifier, generated from the shared rules so Windows and macOS can't\n * disagree about what a bounce is. Defines `Get-BounceReport`, which returns\n * null for an item that isn't a bounce and a report row for one that is.\n *\n * The body is read only after a cheaper signal (class, sender, subject) has\n * matched — that ordering is what keeps a large-inbox scan affordable.\n */\nfunction bounceClassifierScript(): string {\n    return `\n$bouncePhrases = ${psArray(BOUNCE_SUBJECT_PHRASES)}\n$daemonAddresses = ${psArray(BOUNCE_DAEMON_ADDRESSES)}\n$daemonNames = ${psArray(BOUNCE_DAEMON_NAMES)}\n$daemonSelf = ${psArray(DAEMON_SELF_ADDRESSES)}\n$ndrPrefix = ${psString(NDR_MESSAGE_CLASS_PREFIX)}\n$addressPattern = ${psString(BODY_ADDRESS_PATTERN)}\n$maxFailed = ${psInt(MAX_FAILED_RECIPIENTS)}\n$accountLower = $target.ToLower()\nfunction Get-BounceReport($item) {\n    $class = 0\n    try { $class = [int]$item.Class } catch {}\n    if ($class -ne 43 -and $class -ne 46) { return $null }\n    $subject = ''\n    try { $subject = [string]$item.Subject } catch {}\n    $senderName = ''\n    try { $senderName = [string]$item.SenderName } catch {}\n    $senderEmail = ''\n    try { $senderEmail = [string]$item.SenderEmailAddress } catch {}\n    $messageClass = ''\n    try { $messageClass = [string]$item.MessageClass } catch {}\n    $reason = ''\n    if ($messageClass.StartsWith($ndrPrefix, [StringComparison]::OrdinalIgnoreCase)) { $reason = ${psString(BOUNCE_REASON.ndr)} }\n    if (-not $reason) { foreach ($d in $daemonAddresses) { if ($senderEmail.ToLower().Contains($d)) { $reason = ${psString(BOUNCE_REASON.daemon)}; break } } }\n    if (-not $reason) { foreach ($d in $daemonNames) { if ($senderName.ToLower().Contains($d)) { $reason = ${psString(BOUNCE_REASON.daemon)}; break } } }\n    if (-not $reason) { foreach ($p in $bouncePhrases) { if ($subject.ToLower().Contains($p)) { $reason = \"${BOUNCE_REASON.subjectPhrase('$p')}\"; break } } }\n    if (-not $reason) { return $null }\n    $failedRecipients = @()\n    $body = ''\n    try { $body = [string]$item.Body } catch {}\n    foreach ($m in [regex]::Matches($body, $addressPattern)) {\n        $address = $m.Value.ToLower().TrimEnd('.')\n        if ($address -eq $accountLower) { continue }\n        $isDaemon = $false\n        foreach ($d in $daemonSelf) { if ($address.Contains($d)) { $isDaemon = $true; break } }\n        if ($isDaemon -or $failedRecipients -contains $address) { continue }\n        $failedRecipients += $address\n        if ($failedRecipients.Count -ge $maxFailed) { break }\n    }\n    $received = ''\n    try { $received = $item.ReceivedTime.ToString('yyyy-MM-dd HH:mm') } catch {}\n    return [PSCustomObject]@{\n        entryId          = [string]$item.EntryID\n        subject          = $subject.Trim()\n        senderName       = $senderName\n        senderEmail      = $senderEmail\n        receivedTime     = $received\n        matchedReason    = $reason\n        failedRecipients = @($failedRecipients)\n    }\n}\n`;\n}\n\n/**\n * Scan an account's Inbox for bounce-backs and, unless dry-running, move each to\n * Deleted Items (recoverable).\n *\n * Matched items are collected before the first Delete(): deleting shifts the\n * collection, and deleting mid-enumeration would skip items.\n */\nexport async function cleanUndeliverableEmails(request: CleanUndeliverableRequest): Promise<CleanUndeliverableResult> {\n    const output = await runPowerShellJson(`${accountScript(request.account)}\n${NAMED_STORE_PS}\n${bounceClassifierScript()}\n$dryRun = ${psBool(request.dryRun)}\n$inbox = $store.GetDefaultFolder(${psInt(FolderId.Inbox)})\n${cutoffScript(request.daysBack)}\n${itemsSinceScript('inbox', 'ReceivedTime')}\n$reports = @()\n$matchedItems = @()\n$count = $filtered.Count\nfor ($i = 1; $i -le $count; $i++) {\n    $item = $null\n    try { $item = $filtered.Item($i) } catch { continue }\n    if ($item -eq $null) { continue }\n    $received = $null\n    try { $received = $item.ReceivedTime } catch {}\n    if ($received -ne $null -and $received -lt $cutoff) { continue }\n    $report = Get-BounceReport $item\n    if ($report -eq $null) { continue }\n    $reports += $report\n    $matchedItems += $item\n}\n$deleted = 0\n$failed = @()\nif (-not $dryRun) {\n    foreach ($m in $matchedItems) {\n        $entryId = ''\n        $subject = ''\n        try { $entryId = [string]$m.EntryID } catch {}\n        try { $subject = [string]$m.Subject } catch {}\n        try { $m.Delete(); $deleted++ }\n        catch { ${itemFailurePs('$entryId')} }\n    }\n}\nConvertTo-Json -Depth 4 -InputObject ([PSCustomObject]@{\n    deletedCount = $deleted\n    matched      = @($reports)\n    failed       = @($failed)\n})\n`, 'scan');\n    const e = record(output);\n    const matched = toArray(e.matched).map(row => {\n        const m = record(row);\n        return {\n            entryId: str(m.entryId),\n            subject: str(m.subject),\n            senderName: str(m.senderName),\n            senderEmail: str(m.senderEmail),\n            receivedTime: str(m.receivedTime),\n            matchedReason: str(m.matchedReason),\n            failedRecipients: strList(m.failedRecipients),\n        };\n    });\n    return {\n        account: request.account,\n        scannedDays: request.daysBack,\n        dryRun: request.dryRun,\n        matchedCount: matched.length,\n        deletedCount: num(e.deletedCount),\n        matched,\n        failed: itemFailures(e.failed),\n    };\n}\n\n/**\n * The deduplicated addresses bounce-backs report as failed, from the Inbox and,\n * optionally, Deleted Items — so it still works after the bounces were cleaned\n * away. Never deletes anything.\n */\nexport async function collectBouncedRecipients(request: CollectBouncesRequest): Promise<string[]> {\n    const roles = request.includeDeletedItems ? [FolderId.Inbox, FolderId.DeletedItems] : [FolderId.Inbox];\n    const output = await runPowerShellJson(`${accountScript(request.account)}\n${DELIVERY_STORE_PS}\n${bounceClassifierScript()}\n${cutoffScript(request.daysBack)}\n$found = [ordered]@{}\nforeach ($role in @(${roles.map(psInt).join(', ')})) {\n    $scanFolder = $null\n    try { $scanFolder = $store.GetDefaultFolder($role) } catch {}\n    if ($scanFolder -eq $null) { continue }\n    ${itemsSinceScript('scanFolder', 'ReceivedTime').trim()}\n    $count = $filtered.Count\n    for ($i = 1; $i -le $count; $i++) {\n        $item = $null\n        try { $item = $filtered.Item($i) } catch { continue }\n        if ($item -eq $null) { continue }\n        $received = $null\n        try { $received = $item.ReceivedTime } catch {}\n        if ($received -ne $null -and $received -lt $cutoff) { continue }\n        $report = Get-BounceReport $item\n        if ($report -eq $null) { continue }\n        foreach ($address in $report.failedRecipients) { $found[$address] = $true }\n    }\n}\nConvertTo-Json -Compress -InputObject @($found.Keys)\n`, 'scan');\n    return strList(output);\n}\n\n/**\n * Sent Items within the window, each message with the full SMTP address set it\n * went to (To + CC + BCC), newest first.\n */\nexport async function readSentRecipientGroups(request: SentGroupsRequest): Promise<SentRecipientGroup[]> {\n    const output = await runPowerShellJson(`${accountScript(request.account)}\n${DELIVERY_STORE_PS}\n$sentFolder = $store.GetDefaultFolder(${psInt(FolderId.SentMail)})\n${cutoffScript(request.daysBack)}\n${itemsSinceScript('sentFolder', 'SentOn')}\n$filtered.Sort('[SentOn]', $true)\n$limit = ${psInt(request.limit)}\n$rows = @()\n$count = $filtered.Count\nfor ($i = 1; $i -le $count -and $rows.Count -lt $limit; $i++) {\n    $m = $null\n    try { $m = $filtered.Item($i) } catch { continue }\n    if ($m -eq $null) { continue }\n    $sentOn = $null\n    try { $sentOn = $m.SentOn } catch {}\n    if ($sentOn -ne $null -and $sentOn -lt $cutoff) { break }\n    $class = 0\n    try { $class = [int]$m.Class } catch {}\n    if ($class -ne 43) { continue }\n    $addresses = @()\n    try {\n        foreach ($r in $m.Recipients) {\n            $address = ''\n            try { $address = [string]$r.Address } catch {}\n            # An internal recipient resolves to an Exchange DN; recover its SMTP address.\n            if ($address -notlike '*@*') {\n                try { $address = [string]$r.AddressEntry.GetExchangeUser().PrimarySmtpAddress } catch {}\n            }\n            if ($address -like '*@*') { $addresses += $address.ToLower() }\n        }\n    } catch {}\n    if ($addresses.Count -eq 0) { continue }\n    $rows += [PSCustomObject]@{\n        entryId    = [string]$m.EntryID\n        subject    = ([string]$m.Subject).Trim()\n        sentOn     = if ($sentOn -ne $null) { $sentOn.ToString('yyyy-MM-dd HH:mm') } else { '' }\n        recipients = @($addresses)\n    }\n}\nConvertTo-Json -Depth 4 -InputObject @($rows)\n`, 'scan');\n    return toArray(output).map(row => {\n        const e = record(row);\n        return {\n            entryId: str(e.entryId),\n            subject: str(e.subject),\n            sentOn: str(e.sentOn),\n            recipients: strList(e.recipients),\n        };\n    });\n}\n"]}

package/dist/windows/cleanup.d.ts

@@ -1,29 +1,29 @@
-import type { DeleteMailOptions, DeleteMailResult, PurgeDeletedItemsResult } from '../types';
+import type { DeleteEmailsRequest, PurgeRequest } from '../backend';
+import type { DeleteMailResult, PurgeDeletedItemsResult } from '../types';
 /**
- * Delete mail by EntryID from anywhere in the account. Delete() moves each item to
- * Deleted Items, so this is recoverable — purgeDeletedItems is what destroys.
+ * Delete mail by entry id from anywhere in the account. Delete() moves each item
+ * to Deleted Items, so this is recoverable — purgeDeletedItems is what destroys.
  *
- * ⚠️ This is the one tool here that can reach received mail, and EntryIDs are a
- * genuinely unsafe key for it: GetItemFromID silently returns a DIFFERENT message
- * when handed a stale or wrong id, which is common precisely when many replies share
- * one subject (see saveEmailAttachmentDetailed). Three things hold the line:
- *
- *  - **Inbox and Sent Items are refused by default, INCLUDING their subfolders** —
- *    a filed subfolder is still received mail. `allowProtected` lifts that, and is
- *    the caller explicitly taking responsibility.
- *  - **`dryRun` resolves and reports without deleting**, so the exact subjects and
- *    folders can be shown to the user before anything happens. Use it first.
- *  - **Every outcome echoes the subject and folderPath** of the item actually
- *    resolved, so a wrong id is visible after the fact rather than silent.
+ * This is the one operation that can reach received mail, and an entry id is an
+ * unsafe key for it: a stale or wrong id can resolve to a DIFFERENT message.
+ * Four things hold the line:
+ *  - An id that resolves outside this account's store is refused. The bare
+ *    lookup falls back to the default store, and the Inbox/Sent check below
+ *    only knows this account's folders, so another mailbox's received mail
+ *    would otherwise pass it.
+ *  - Inbox and Sent Items are refused, INCLUDING their subfolders (a filed
+ *    folder is still received mail), unless `allowProtected`.
+ *  - `dryRun` resolves and reports without deleting, so the exact subjects and
+ *    folders can be checked before anything happens.
+ *  - Every outcome echoes the subject and folder of the item actually resolved.
  */
-export declare function deleteOutlookEmails(emailAccount: string, entryIds: string[], options?: DeleteMailOptions): Promise<DeleteMailResult>;
+export declare function deleteOutlookEmails(request: DeleteEmailsRequest): Promise<DeleteMailResult>;
 /**
- * Permanently remove items from the account's Deleted Items folder. This is the ONE
- * genuinely irreversible operation here — nothing recovers from it — which is why it
- * is folder-scoped rather than keyed on an EntryID: it can only ever destroy what the
- * user already threw away.
+ * Permanently remove items from the account's Deleted Items. The ONE irreversible
+ * operation here, which is why it is folder-scoped rather than keyed on ids: it
+ * can only ever destroy what was already thrown away.
  *
- * `olderThanDays` keeps recent items (0 = purge everything). Iterates backwards, as
- * deleting mutates the collection and a forward walk would skip every other item.
+ * Walks backwards, since deleting shifts the collection and a forward walk would
+ * skip every other item.
  */
-export declare function purgeDeletedItems(emailAccount: string, olderThanDays?: number, dryRun?: boolean): Promise<PurgeDeletedItemsResult>;
+export declare function purgeDeletedItems(request: PurgeRequest): Promise<PurgeDeletedItemsResult>;