@dawnlit/outlook-bridge 1.1.0 → 2.0.0

package/dist/types.js

@@ -1,13 +1,12 @@
 "use strict";
-// The package's data contract, and the interface both platform implementations
-// answer to.
+// The public contract: what the package returns, what it takes, and the
+// OutlookBridge interface every entry point answers to.
 //
-// These types used to live in the Windows implementation, so macOS imported its
-// own return shapes from it and its stubs re-declared them structurally. The two
-// drifted, and because OutlookService dispatches by picking one implementation or
-// the other, every drift surfaced in the PUBLIC types as a union — `matched:
-// UndeliverableEmail[] | unknown[]` and the like. Both now implement
-// `OutlookBridge` from here, so a drift is a compile error in the package rather
-// than a union in the consumer's editor.
+// Two conventions hold throughout:
+//  - Timestamps are local time as 'yyyy-MM-dd HH:mm', which sorts correctly as
+//    a plain string and is what both platforms can produce without a timezone
+//    table.
+//  - Ids are platform-specific (see EmailLocator). Don't persist one and look it
+//    up on the other platform.
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,aAAa;AACb,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,kFAAkF;AAClF,6EAA6E;AAC7E,qEAAqE;AACrE,iFAAiF;AACjF,yCAAyC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,wEAAwE;AACxE,wDAAwD;AACxD,EAAE;AACF,mCAAmC;AACnC,+EAA+E;AAC/E,8EAA8E;AAC9E,YAAY;AACZ,iFAAiF;AACjF,+BAA+B","sourcesContent":["// The public contract: what the package returns, what it takes, and the\n// OutlookBridge interface every entry point answers to.\n//\n// Two conventions hold throughout:\n//  - Timestamps are local time as 'yyyy-MM-dd HH:mm', which sorts correctly as\n//    a plain string and is what both platforms can produce without a timezone\n//    table.\n//  - Ids are platform-specific (see EmailLocator). Don't persist one and look it\n//    up on the other platform.\n\n// ── Identifying an email ─────────────────────────────────────────────────\n/**\n * Where an email lives, as a listing reported it.\n *\n * Every listing row (`InboxEmail`, `InboxSearchMatch`, `SelectedEmail`, …)\n * carries both fields, so a row can be passed straight back in wherever an\n * `EmailRef` is accepted — which is also the reliable way to keep the two ids\n * from different rows apart.\n */\nexport interface EmailLocator {\n    /** Windows: the MAPI EntryID. macOS: Outlook for Mac's integer message id. */\n    readonly entryId: string;\n    /**\n     * Windows: the StoreID the email was listed from, which lets it resolve in\n     * any mounted mailbox rather than only the default one. macOS has no\n     * equivalent and ignores it.\n     */\n    readonly storeId?: string;\n}\n\n/** An email to act on: its entry id alone, or anything carrying a locator. */\nexport type EmailRef = string | EmailLocator;\n\n/**\n * Recipients: one address, a comma- or semicolon-separated list, or an array.\n * Display-name forms such as `\"Doe, Jo\" <jo@example.com>` are kept whole.\n */\nexport type Recipients = string | readonly string[];\n\n// ── Sending and replying ─────────────────────────────────────────────────\nexport interface SendEmailParams {\n    /** SMTP address of the mailbox to send from. Never falls back to the\n     *  default account — an address that doesn't resolve is an error. */\n    emailAccount: string;\n    to?: Recipients;\n    cc?: Recipients;\n    bcc?: Recipients;\n    subject: string;\n    htmlBody: string;\n    /** Absolute paths of files to attach. Each has to exist. */\n    attachments?: readonly string[];\n    /**\n     * An Outlook signature, by the name listOutlookSignatures reports, added to\n     * the body: in its `{{SIGNATURE}}` placeholder when it has one, otherwise\n     * at the end. Outlook adds no signature of its own to a body set this way,\n     * so this is how a composed email gets one.\n     */\n    signatureName?: string;\n    /** Send now. Default false: the email is staged as a draft instead. */\n    sendImmediately?: boolean;\n    /**\n     * Drafts only. True (the default) opens an Outlook compose window; false\n     * files the draft silently into Drafts — the workable choice for batches.\n     */\n    openDraftWindow?: boolean;\n}\n\nexport interface ReplyEmailParams extends EmailLocator {\n    /** SMTP address of the mailbox to reply from. */\n    emailAccount: string;\n    /**\n     * HTML inserted above the quoted original (a full document is reduced to\n     * its <body> content). Optional when `templateSubject` is given.\n     */\n    htmlBody?: string;\n    /**\n     * Reply with a template email saved in the mailbox, found by subject, so\n     * the caller never carries a large template's HTML itself.\n     */\n    templateSubject?: string;\n    /** Folder holding the template. Default 'Templates'. */\n    templateFolder?: string;\n    /**\n     * The [[SECTION]] of the template to keep, when one template holds several\n     * reply variants (see composeTemplateBody). Required if it has sections.\n     */\n    templateSection?: string;\n    /** `{{PLACEHOLDER}}` → HTML substituted into the composed body. */\n    templatePlaceholders?: Readonly<Record<string, string>>;\n    /**\n     * An Outlook signature (by the name listOutlookSignatures reports), put in\n     * the body's `{{SIGNATURE}}` placeholder, or below the new text when there\n     * is none. Resolved here, so the signature's HTML never crosses the\n     * caller's boundary.\n     */\n    signatureName?: string;\n    /**\n     * Answer every recipient of the original instead of only its sender.\n     * Default false: widening a reply cannot be taken back, so it is opt-in.\n     */\n    replyAll?: boolean;\n    /** Send now. Default false. */\n    sendImmediately?: boolean;\n    /** Drafts only: open a compose window (the default) or file silently. */\n    openDraftWindow?: boolean;\n}\n\nexport interface ReplyEmailResult {\n    /** Who the reply is addressed to. Windows reports Outlook's To line\n     *  (display names); macOS the resolved addresses. */\n    to: string;\n    subject: string;\n    /** The original email's sender — check it is who you meant to answer. */\n    repliedToSender: string;\n}\n\n// ── Per-item outcomes ────────────────────────────────────────────────────\n/** One item a batch operation could not handle, and why. */\nexport interface ItemFailure {\n    entryId: string;\n    /** The item's subject when it could be read, else ''. */\n    subject: string;\n    error: string;\n}\n\n// ── Drafts ───────────────────────────────────────────────────────────────\n/** One mail draft belonging to an account. */\nexport interface OutlookDraft {\n    entryId: string;\n    subject: string;\n    /** The To line as Outlook renders it. */\n    to: string;\n    /** Recipient addresses, best effort — an unresolved Exchange entry falls back to its name. */\n    toEmails: string[];\n    /** Short plain-text preview, enough to tell similar drafts apart. */\n    bodyPreview: string;\n    hasAttachments: boolean;\n    lastModified: string;\n    /** The Drafts folder it sits in; one account's drafts can span two. */\n    folderPath: string;\n}\n\nexport interface ListDraftsOptions {\n    /** Newest-first cap on the drafts returned. Default 100. */\n    limit?: number;\n    /** Characters of body preview per draft. Default 300; 0 omits it. */\n    previewChars?: number;\n}\n\nexport interface ListDraftsResult {\n    account: string;\n    /** The Drafts folders scanned, in scan order. */\n    foldersScanned: string[];\n    /** Matching drafts found, before `limit` was applied. */\n    count: number;\n    truncated: boolean;\n    drafts: OutlookDraft[];\n}\n\nexport interface SendDraftsResult {\n    sent: number;\n    failed: ItemFailure[];\n}\n\nexport interface DeleteDraftsResult {\n    deleted: number;\n    failed: ItemFailure[];\n}\n\n// ── Deleting mail ────────────────────────────────────────────────────────\nexport interface DeleteMailOptions {\n    /** Lift the refusal to touch Inbox and Sent Items (and their subfolders). */\n    allowProtected?: boolean;\n    /** Resolve and report every id without deleting anything. */\n    dryRun?: boolean;\n}\n\n/** What happened to one id in a deleteOutlookEmails call. */\nexport interface DeleteMailOutcome {\n    entryId: string;\n    subject: string;\n    /** The folder the item was actually in — the audit trail for a wrong id. */\n    folderPath: string;\n    status: 'deleted' | 'would-delete' | 'refused' | 'failed';\n    reason: string;\n}\n\nexport interface DeleteMailResult {\n    dryRun: boolean;\n    deleted: number;\n    refused: number;\n    failed: number;\n    items: DeleteMailOutcome[];\n}\n\nexport interface PurgeDeletedItemsOptions {\n    /** Keep items newer than this many days. Default 0: purge everything. */\n    olderThanDays?: number;\n    /** Count what would be purged without destroying anything. */\n    dryRun?: boolean;\n}\n\nexport interface PurgeDeletedItemsResult {\n    folderPath: string;\n    dryRun: boolean;\n    /** Items old enough to qualify. */\n    matched: number;\n    purged: number;\n    /** Items left because they were newer than `olderThanDays`. */\n    kept: number;\n    failed: number;\n}\n\n// ── Bounces ──────────────────────────────────────────────────────────────\n/** One bounce-back / non-delivery message found in a mailbox. */\nexport interface UndeliverableEmail {\n    entryId: string;\n    subject: string;\n    senderName: string;\n    senderEmail: string;\n    receivedTime: string;\n    /** Which rule flagged it: an NDR message class, a mail-daemon sender, or a bounce subject phrase. */\n    matchedReason: string;\n    /** Best-effort addresses parsed from the bounce body — the sends that failed. */\n    failedRecipients: string[];\n}\n\nexport interface CleanUndeliverableOptions {\n    /** How far back to scan. Default 30. */\n    daysBack?: number;\n    /** Report without deleting. Default TRUE — deleting has to be asked for. */\n    dryRun?: boolean;\n}\n\nexport interface CleanUndeliverableResult {\n    account: string;\n    scannedDays: number;\n    dryRun: boolean;\n    matchedCount: number;\n    deletedCount: number;\n    matched: UndeliverableEmail[];\n    /** Matched items that could not be deleted (a delete run only). */\n    failed: ItemFailure[];\n}\n\nexport interface CollectBouncedRecipientsOptions {\n    /** How far back to scan. Default 30. */\n    daysBack?: number;\n    /** Scan Deleted Items too, so bounces already cleaned away still count. Default true. */\n    includeDeletedItems?: boolean;\n}\n\nexport interface SentRecipientGroupsOptions {\n    /** How far back to read Sent Items. Default 30. */\n    daysBack?: number;\n    /** Newest-first cap on messages. Default 3000. */\n    limit?: number;\n}\n\n/** One sent message and every SMTP address it went to (To, CC and BCC). */\nexport interface SentRecipientGroup {\n    entryId: string;\n    subject: string;\n    sentOn: string;\n    recipients: string[];\n}\n\nexport interface BounceReportOptions {\n    /** How far back to read bounce-backs and Sent Items. Default 30. */\n    daysBack?: number;\n    /** Count bounces already moved to Deleted Items too. Default true. */\n    includeDeletedItems?: boolean;\n}\n\n/** A sent message that at least one of its recipients bounced back from. */\nexport interface BouncedSend {\n    entryId: string;\n    subject: string;\n    sentOn: string;\n    /** Every address it went to, lower-cased and deduplicated. */\n    recipients: string[];\n    /** The recipients a bounce-back reported as failed. */\n    failedRecipients: string[];\n    /** True when every recipient failed: the message reached nobody. */\n    allFailed: boolean;\n}\n\nexport interface BounceReport {\n    account: string;\n    scannedDays: number;\n    /** Every distinct address the bounce-backs reported, lower-cased. */\n    bouncedAddresses: string[];\n    /** The sent messages with a bounced recipient, newest first. */\n    sends: BouncedSend[];\n    /**\n     * Bounced addresses no sent message in the window went to: an alias the\n     * server expanded, or a send older than the window.\n     */\n    unmatchedAddresses: string[];\n}\n\n// ── Reading ──────────────────────────────────────────────────────────────\nexport interface ReadInboxOptions {\n    /**\n     * Read this folder instead of the Inbox root: a folder under the Inbox by\n     * name or path, a well-known folder ('Sent Items', 'Drafts', …), or a full\n     * folder path — see mailFolderRef. Only that folder is read, not its\n     * subfolders.\n     */\n    folder?: string;\n    /** Only mail from the last this-many days. Default 60. */\n    daysBack?: number;\n    /** Newest-first cap on rows. Default 50. */\n    limit?: number;\n    /** Characters of plain-text body per row. Default 600; 0 skips reading bodies. */\n    previewChars?: number;\n}\n\nexport interface InboxEmail extends EmailLocator {\n    entryId: string;\n    storeId: string;\n    subject: string;\n    /** For outgoing folders (Sent Items, Outbox, Drafts) these carry the\n     *  RECIPIENT, since a folder of mail \"from\" its own owner says nothing. */\n    senderName: string;\n    senderEmail: string;\n    receivedTime: string;\n    bodyPreview: string;\n    attachmentNames: string[];\n    attachmentCount: number;\n    /** The folder the email was read from. */\n    folderPath: string;\n}\n\nexport interface InboxSearchFilter {\n    /** Only mail from the last this-many days. Default 60 — a scan has no\n     *  unbounded mode; ask for 365 to reach back a year. */\n    daysBack?: number;\n    /** Glob-style subject pattern: `*` matches any run, `?` one character,\n     *  case-insensitive, e.g. '*invoice*'. */\n    subjectLike?: string;\n    /**\n     * Regular expression tested against each subject, case-insensitively\n     * whatever the RegExp's own flags. On Windows the pattern runs in .NET's\n     * regex engine, so keep to syntax JavaScript and .NET share.\n     */\n    subjectPattern?: RegExp;\n    /** Drop subjects carrying a reply or forward prefix (RE:, FW:, AW:, 回复:, …). */\n    excludeReplies?: boolean;\n    /** Only return mail with at least one attachment. */\n    requireAttachment?: boolean;\n    /**\n     * Folders under the Inbox to leave out, by full folder path or bare name,\n     * case-insensitively. An excluded folder takes its whole subtree with it.\n     * Sent, Drafts, Deleted and Junk are always skipped, even where the profile\n     * nests them under the Inbox. macOS matches the leaf name only.\n     */\n    excludeFolders?: readonly string[];\n    /**\n     * Scan only these folders, given the same way. Matched exactly: naming a\n     * folder does not bring its children, and the Inbox root is included only\n     * when named. Exclusion wins where the two overlap.\n     */\n    includeFolders?: readonly string[];\n    /** Return each match's full plain-text body. Default true; false makes a\n     *  scan much lighter when only the metadata is needed. */\n    includeBody?: boolean;\n}\n\nexport interface InboxSearchMatch extends EmailLocator {\n    entryId: string;\n    storeId: string;\n    subject: string;\n    senderName: string;\n    /** SMTP address, resolved from the Exchange DN where the sender is an Exchange user. */\n    senderEmail: string;\n    receivedTime: string;\n    /** The plain-text body; '' when the search asked for no bodies. */\n    body: string;\n    /** Not saved to disk — pass the ones you want to saveEmailAttachments. */\n    attachmentNames: string[];\n    folderPath: string;\n}\n\n/**\n * What was kept about an email besides its id, for finding it again once the\n * id no longer resolves: Outlook rewrites an email's id whenever it moves, and\n * an id from one platform means nothing on the other.\n *\n * At least two of `subject`, `sender` and `receivedTime` are needed, since a\n * subject alone names every message in a thread.\n */\nexport interface EmailDescription {\n    /** Compared without reply and forward prefixes, spacing or case. */\n    subject?: string;\n    /**\n     * An address, a display name, or both (`Jo Doe <jo@example.com>`). An\n     * address is compared as an address; a bare name only against the\n     * sender's display name.\n     */\n    sender?: string;\n    /** `yyyy-MM-dd HH:mm` as a listing reported it, or just the day. */\n    receivedTime?: string;\n    /** The mailbox to search. Default: every account, the one `folderPath` names first. */\n    emailAccount?: string;\n    /**\n     * The folderPath a listing reported (`\\\\team@example.com\\Inbox\\Invoices`).\n     * Only decides which mailbox is searched first.\n     */\n    folderPath?: string;\n}\n\nexport interface LocateEmailOptions {\n    /** How far back to search when the description has no receivedTime. Default 60. */\n    daysBack?: number;\n}\n\nexport interface SelectedEmail extends EmailLocator {\n    entryId: string;\n    storeId: string;\n    subject: string;\n    senderName: string;\n    senderEmail: string;\n    receivedTime: string;\n    body: string;\n    /** Not saved to disk — pass the ones you want to saveEmailAttachments. */\n    attachmentNames: string[];\n}\n\nexport interface ReadEmailBodyOptions {\n    /** Cap on the returned body. Default 8000. */\n    maxChars?: number;\n    /** Also return the quoted thread below the reply. Default false. */\n    includeQuoted?: boolean;\n    /** Cap on the quoted thread when it is returned. Default 4000. */\n    maxQuotedChars?: number;\n}\n\nexport interface EmailBodyResult {\n    entryId: string;\n    subject: string;\n    senderName: string;\n    senderEmail: string;\n    receivedTime: string;\n    /** The sender's own new text — everything above the quoted thread. */\n    body: string;\n    /** True when `body` was cut at maxChars. */\n    truncated: boolean;\n    /** Length of the sender's new text before any cut. */\n    bodyLength: number;\n    /** What the quoted thread was split on; '' when none was found. */\n    quoteSeparator: string;\n    /** Length of the quoted thread, reported even when it isn't returned. */\n    quotedLength: number;\n    /** The quoted thread — only when asked for. */\n    quotedOriginal: string;\n    attachmentNames: string[];\n    attachmentCount: number;\n}\n\n// ── Folders ──────────────────────────────────────────────────────────────\nexport interface MailFolderRef {\n    /** olDefaultFolders id of the well-known root the path starts from. */\n    rootId: number;\n    /** That root as the caller spelled it, for messages. */\n    rootLabel: string;\n    /** Path segments below the root. */\n    segments: string[];\n}\n\nexport interface ListFoldersOptions {\n    /** How many levels below the Inbox to list, 1–10. Default 2. */\n    maxDepth?: number;\n}\n\nexport interface InboxFolderInfo {\n    name: string;\n    /** Outlook folder path, e.g. `\\\\mailbox\\Inbox\\Invoices`. */\n    folderPath: string;\n    itemCount: number;\n    /** 1 = direct child of the Inbox, 2 = grandchild, … */\n    depth: number;\n}\n\nexport interface MoveEmailsOptions {\n    /** Create the destination — the whole missing chain — when absent. Default false. */\n    createIfMissing?: boolean;\n}\n\nexport interface MoveEmailsResult {\n    folderPath: string;\n    folderCreated: boolean;\n    moved: number;\n    failed: ItemFailure[];\n}\n\n// ── Attachments ──────────────────────────────────────────────────────────\nexport interface SaveAttachmentOptions {\n    /**\n     * Directory to save into, created if absent. Without one, each call saves\n     * into a fresh private directory, so two emails that both carry\n     * 'invoice.pdf' can never overwrite each other.\n     */\n    destDir?: string;\n}\n\nexport interface SavedAttachment {\n    /** Where the file was written. A name already taken in the directory gets\n     *  a numbered suffix rather than overwriting what is there. */\n    path: string;\n    /** The attachment's name as the email carries it. */\n    fileName: string;\n    /** Who the email was from — confirm it is the email you meant. */\n    subject: string;\n    senderName: string;\n    senderEmail: string;\n    receivedTime: string;\n}\n\n// ── Template emails ──────────────────────────────────────────────────────\nexport interface ReadTemplatesOptions {\n    /** Mailbox folder holding the templates, searched up to 3 levels deep. Default 'Templates'. */\n    folder?: string;\n    /** Return only the template with this subject (case-insensitive). */\n    subject?: string;\n    /** Return each full HTML body. Default true; false returns previews. */\n    includeBody?: boolean;\n    /** Newest-first cap on templates, 1–200. Default 20. */\n    limit?: number;\n}\n\n/** One template email stored in a mailbox folder. */\nexport interface TemplateEmail {\n    entryId: string;\n    subject: string;\n    /** Full HTML body with embedded (cid:) images removed; '' without includeBody. */\n    htmlBody: string;\n    /** Short plain-text preview; '' with includeBody. */\n    bodyPreview: string;\n    /** [[SECTION]] names, returned with or without the body. */\n    sections: string[];\n    /** `{{PLACEHOLDER}}` names the template expects filled. */\n    placeholders: string[];\n    lastModified: string;\n}\n\nexport interface TemplateFolderResult {\n    folderFound: boolean;\n    /** The folder's path when found. */\n    folderPath: string;\n    templates: TemplateEmail[];\n    /** When the folder wasn't found: the mailbox's top-level folder names. */\n    availableFolders: string[];\n}\n\nexport interface SaveTemplateParams {\n    subject: string;\n    htmlBody: string;\n    /** Folder to save into, created at the mailbox root if absent. Default 'Templates'. */\n    folder?: string;\n}\n\nexport interface SaveTemplateResult {\n    folderPath: string;\n    folderCreated: boolean;\n}\n\n// ── The contract ─────────────────────────────────────────────────────────\n/**\n * Everything the package does, under one signature per operation whatever the\n * platform. A platform that cannot do something says so at run time — see\n * `CapabilityMap` — rather than through a narrower type.\n */\nexport interface OutlookBridge {\n    /** Every mailbox this Outlook profile can reach, as SMTP addresses. */\n    getOutlookAccounts(): Promise<string[]>;\n\n    /** Send an email, or stage it as a draft. */\n    sendOutlookEmail(params: SendEmailParams): Promise<void>;\n\n    /** Reply to an email, with the new text above the quoted original. */\n    replyOutlookEmail(params: ReplyEmailParams): Promise<ReplyEmailResult>;\n\n    /** Recent mail from the Inbox root or one named folder, newest first. */\n    readInboxEmails(emailAccount: string, options?: ReadInboxOptions): Promise<InboxEmail[]>;\n\n    /** Walk every folder under the Inbox for the mail matching `filter`. */\n    searchInboxByFilter(emailAccount: string, filter?: InboxSearchFilter): Promise<InboxSearchMatch[]>;\n\n    /** The email currently selected, or open, in Outlook. */\n    readSelectedEmail(): Promise<SelectedEmail>;\n\n    /** One email's plain-text body, split from the thread it quotes. */\n    readEmailBody(email: EmailRef, options?: ReadEmailBodyOptions): Promise<EmailBodyResult>;\n\n    /** Open an email in Outlook. */\n    openOutlookEmail(email: EmailRef): Promise<void>;\n\n    /**\n     * Find an email again from what was kept about it, when its id no longer\n     * resolves. Searches the Inbox and its subfolders, and returns null rather\n     * than a guess: every field the description gives has to agree.\n     */\n    locateEmail(description: EmailDescription, options?: LocateEmailOptions): Promise<InboxSearchMatch | null>;\n\n    /** The folders under an account's Inbox. */\n    listInboxFolders(emailAccount: string, options?: ListFoldersOptions): Promise<InboxFolderInfo[]>;\n\n    /** File emails into a folder. Moving rewrites each email's entry id. */\n    moveOutlookEmails(\n        emailAccount: string,\n        entryIds: readonly string[],\n        folder: string,\n        options?: MoveEmailsOptions,\n    ): Promise<MoveEmailsResult>;\n\n    /** The mail drafts bound to an account, newest first. */\n    listOutlookDrafts(emailAccount: string, options?: ListDraftsOptions): Promise<ListDraftsResult>;\n\n    /** Send the named drafts — each has to be one of this account's drafts. */\n    sendDrafts(emailAccount: string, entryIds: readonly string[]): Promise<SendDraftsResult>;\n\n    /** Send every draft bound to an account. */\n    sendAllDrafts(emailAccount: string): Promise<SendDraftsResult>;\n\n    /** Delete the named drafts (into Deleted Items) — each has to be one of this account's drafts. */\n    deleteOutlookDrafts(emailAccount: string, entryIds: readonly string[]): Promise<DeleteDraftsResult>;\n\n    /** Delete mail by id into Deleted Items, refusing received and sent mail unless allowed. */\n    deleteOutlookEmails(\n        emailAccount: string,\n        entryIds: readonly string[],\n        options?: DeleteMailOptions,\n    ): Promise<DeleteMailResult>;\n\n    /** Permanently empty an account's Deleted Items. The one irreversible operation. */\n    purgeDeletedItems(emailAccount: string, options?: PurgeDeletedItemsOptions): Promise<PurgeDeletedItemsResult>;\n\n    /** Save one attachment to disk. */\n    saveEmailAttachment(email: EmailRef, fileName: string, options?: SaveAttachmentOptions): Promise<SavedAttachment>;\n\n    /** Save several attachments from one email, in the order named. */\n    saveEmailAttachments(\n        email: EmailRef,\n        fileNames: readonly string[],\n        options?: SaveAttachmentOptions,\n    ): Promise<SavedAttachment[]>;\n\n    /** Find bounce-backs in the Inbox and, unless dry-running, delete them. */\n    cleanUndeliverableEmails(\n        emailAccount: string,\n        options?: CleanUndeliverableOptions,\n    ): Promise<CleanUndeliverableResult>;\n\n    /** The addresses bounce-backs report as having failed, deduplicated. */\n    collectBouncedRecipients(emailAccount: string, options?: CollectBouncedRecipientsOptions): Promise<string[]>;\n\n    /** Sent Items, each message with the full set of addresses it went to. */\n    readSentRecipientGroups(emailAccount: string, options?: SentRecipientGroupsOptions): Promise<SentRecipientGroup[]>;\n\n    /** Which sent messages bounced, and for which of their recipients. */\n    readBounceReport(emailAccount: string, options?: BounceReportOptions): Promise<BounceReport>;\n\n    /** The names of the Outlook signatures on this machine. */\n    listOutlookSignatures(): Promise<string[]>;\n\n    /** A signature's HTML, or '' when there is no signature by that name. */\n    readOutlookSignatureHtml(name: string): Promise<string>;\n\n    /** The template emails saved in a mailbox folder. */\n    readTemplateEmails(emailAccount: string, options?: ReadTemplatesOptions): Promise<TemplateFolderResult>;\n\n    /** Save a new template email. Always adds; never overwrites. */\n    saveTemplateEmail(emailAccount: string, template: SaveTemplateParams): Promise<SaveTemplateResult>;\n\n    /**\n     * Open HTML in an Outlook compose window, wait for the person editing it to\n     * save and close, and return what they saved. Has no timeout; cancel it\n     * with an AbortSignal.\n     */\n    editEmailTemplate(label: string, currentHtml: string): Promise<string>;\n}\n\n// ── Capability discovery ─────────────────────────────────────────────────\n/** Every operation whose availability can be asked about. */\nexport type BridgeCapability = keyof OutlookBridge;\n\n/**\n * Which operations work on this machine: all of them on Windows and macOS,\n * none anywhere else. Lets a UI disable what it cannot back instead of\n * discovering the gap when a user clicks.\n */\nexport type CapabilityMap = Readonly<Record<BridgeCapability, boolean>>;\n"]}

package/dist/windows/accounts.d.ts

@@ -1,2 +1,11 @@
-/** Retrieve all Outlook email accounts (SMTP addresses). */
+/**
+ * Every mailbox this profile can reach, as SMTP addresses.
+ *
+ * Walks Accounts AND the top-level store folders, because they are not the same
+ * set: a mailbox mounted as a secondary store has no Account object, and an
+ * Accounts-only walk would report a profile missing exactly the mailboxes an
+ * operator added on purpose. A store contributes only when its name is an
+ * address; a data file's store is named whatever it was called ("Archive") and
+ * names no mailbox a caller could pass back in.
+ */
 export declare function getOutlookAccounts(): Promise<string[]>;

package/dist/windows/accounts.js

@@ -1,22 +1,34 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getOutlookAccounts = getOutlookAccounts;
+// The mailboxes a Windows Outlook profile can reach.
 const run_1 = require("./run");
-/** Retrieve all Outlook email accounts (SMTP addresses). */
+const scripts_1 = require("./scripts");
+const json_1 = require("../shared/json");
+/**
+ * Every mailbox this profile can reach, as SMTP addresses.
+ *
+ * Walks Accounts AND the top-level store folders, because they are not the same
+ * set: a mailbox mounted as a secondary store has no Account object, and an
+ * Accounts-only walk would report a profile missing exactly the mailboxes an
+ * operator added on purpose. A store contributes only when its name is an
+ * address; a data file's store is named whatever it was called ("Archive") and
+ * names no mailbox a caller could pass back in.
+ */
 async function getOutlookAccounts() {
-    if (process.platform !== 'win32')
-        return [];
-    const script = `
-$outlook = New-Object -ComObject Outlook.Application
+    const output = await (0, run_1.runPowerShellJson)(`${scripts_1.SESSION_PS}
+$seen = @{}
 $accounts = @()
-foreach ($a in $outlook.Session.Accounts) {
-    $accounts += $a.SmtpAddress
+foreach ($a in $ns.Accounts) {
+    $address = [string]$a.SmtpAddress
+    if ($address -and -not $seen.ContainsKey($address.ToLower())) { $seen[$address.ToLower()] = $true; $accounts += $address }
 }
-$accounts -join '|'
-`;
-    const result = await (0, run_1.runPowerShell)(script);
-    if (!result)
-        return [];
-    return result.split('|').filter(Boolean);
+foreach ($f in $ns.Folders) {
+    $name = [string]$f.Name
+    if ($name -match '@' -and -not $seen.ContainsKey($name.ToLower())) { $seen[$name.ToLower()] = $true; $accounts += $name }
+}
+ConvertTo-Json -Compress -InputObject @($accounts)
+`, 'quick');
+    return (0, json_1.strList)(output);
 }
 //# sourceMappingURL=accounts.js.map

package/dist/windows/accounts.js.map

@@ -1 +1 @@
-{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../src/windows/accounts.ts"],"names":[],"mappings":";;AAGA,gDAaC;AAhBD,+BAAsC;AAEtC,4DAA4D;AACrD,KAAK,UAAU,kBAAkB;IACpC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,EAAE,CAAC;IAC5C,MAAM,MAAM,GAAG;;;;;;;CAOlB,CAAC;IACE,MAAM,MAAM,GAAG,MAAM,IAAA,mBAAa,EAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../src/windows/accounts.ts"],"names":[],"mappings":";;AAeA,gDAeC;AA9BD,qDAAqD;AACrD,+BAA0C;AAC1C,uCAAuC;AACvC,yCAAyC;AAEzC;;;;;;;;;GASG;AACI,KAAK,UAAU,kBAAkB;IACpC,MAAM,MAAM,GAAG,MAAM,IAAA,uBAAiB,EAAC,GAAG,oBAAU;;;;;;;;;;;;CAYvD,EAAE,OAAO,CAAC,CAAC;IACR,OAAO,IAAA,cAAO,EAAC,MAAM,CAAC,CAAC;AAC3B,CAAC","sourcesContent":["// The mailboxes a Windows Outlook profile can reach.\nimport { runPowerShellJson } from './run';\nimport { SESSION_PS } from './scripts';\nimport { strList } from '../shared/json';\n\n/**\n * Every mailbox this profile can reach, as SMTP addresses.\n *\n * Walks Accounts AND the top-level store folders, because they are not the same\n * set: a mailbox mounted as a secondary store has no Account object, and an\n * Accounts-only walk would report a profile missing exactly the mailboxes an\n * operator added on purpose. A store contributes only when its name is an\n * address; a data file's store is named whatever it was called (\"Archive\") and\n * names no mailbox a caller could pass back in.\n */\nexport async function getOutlookAccounts(): Promise<string[]> {\n    const output = await runPowerShellJson(`${SESSION_PS}\n$seen = @{}\n$accounts = @()\nforeach ($a in $ns.Accounts) {\n    $address = [string]$a.SmtpAddress\n    if ($address -and -not $seen.ContainsKey($address.ToLower())) { $seen[$address.ToLower()] = $true; $accounts += $address }\n}\nforeach ($f in $ns.Folders) {\n    $name = [string]$f.Name\n    if ($name -match '@' -and -not $seen.ContainsKey($name.ToLower())) { $seen[$name.ToLower()] = $true; $accounts += $name }\n}\nConvertTo-Json -Compress -InputObject @($accounts)\n`, 'quick');\n    return strList(output);\n}\n"]}

package/dist/windows/attachments.d.ts

@@ -1,28 +1,13 @@
+import type { SaveAttachmentsRequest } from '../backend';
 import type { SavedAttachment } from '../types';
 /**
- * Save an email attachment by entryId and filename, returning the saved path
- * together with the resolved email's subject/sender so the caller can confirm the
- * file came from the email it intended.
+ * Save the named attachments of one email, in the order named.
  *
- * `destDir` is created if absent. Without one the file lands in a fresh directory
- * of its own, because attachments keep the name the sender gave them: a single
- * shared folder means two emails carrying "invoice.pdf" silently overwrite each
- * other. Pass `destDir` whenever you want the files somewhere you control.
- *
- * When the attachment isn't found, throws an error that names the email actually
- * resolved (from/subject/received) and the attachments it does carry. Because
- * GetItemFromID happily returns a *different* message when handed a stale or wrong
- * EntryID (common when many replies share one subject), a bare "not found" is
- * misleading — this surfaces which email you're really looking at.
- */
-export declare function saveEmailAttachmentDetailed(entryId: string, fileName: string, storeId?: string, destDir?: string): Promise<SavedAttachment>;
-/** Save an attachment and return just the saved file path. */
-export declare function saveEmailAttachment(entryId: string, fileName: string, storeId?: string, destDir?: string): Promise<string>;
-/**
- * Save several attachments from one email in a single COM round trip — what a
- * caller working through searchInboxByFilter/readSelectedEmail results wants,
- * rather than paying a PowerShell process spawn per attachment. Destination,
- * matching and the not-found error follow saveEmailAttachmentDetailed's rules
- * exactly, applied per name; results come back in the same order as `fileNames`.
+ * Every name is matched before anything is written — exact first, then ignoring
+ * case and whitespace runs — so a batch with one bad name fails without having
+ * saved half its files. A name that matches nothing fails as NOT_FOUND naming
+ * the email that actually resolved and the attachments it does carry: an id can
+ * resolve to a different email than the caller meant, and a bare "not found"
+ * would point at the wrong problem.
  */
-export declare function saveEmailAttachments(entryId: string, fileNames: string[], storeId?: string, destDir?: string): Promise<SavedAttachment[]>;
+export declare function saveEmailAttachments(request: SaveAttachmentsRequest): Promise<SavedAttachment[]>;

package/dist/windows/attachments.js

@@ -1,141 +1,116 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.saveEmailAttachmentDetailed = saveEmailAttachmentDetailed;
-exports.saveEmailAttachment = saveEmailAttachment;
 exports.saveEmailAttachments = saveEmailAttachments;
-// Saving attachments off an email, one at a time or in a batch.
+// Saving attachments off an email.
 const run_1 = require("./run");
 const scripts_1 = require("./scripts");
 const json_1 = require("../shared/json");
 const attachmentMatch_1 = require("../shared/attachmentMatch");
-const runtime_1 = require("../runtime");
 const errors_1 = require("../errors");
 /**
- * The "not found" throw, built from the shared wording with PowerShell
- * interpolations in place of the values — so the sentence a Windows caller sees
- * is literally the same one macOS composes.
+ * The file-name rules from shared/attachmentMatch.ts, as PowerShell: the same
+ * sanitizing `safeFileName` does, and the same never-overwrite numbering as
+ * `uniqueSavePath`.
  */
-const NOT_FOUND_THROW = `throw "${(0, attachmentMatch_1.attachmentNotFoundMessage)({
-    fileName: '$target',
-    senderEmail: '$($item.SenderEmailAddress)',
-    subject: '$($item.Subject)',
-    receivedTime: '$($item.ReceivedTime)',
-    present: '$haveStr',
-    idLabel: 'EntryID',
-})}"`;
+const SAVE_PATH_PS = `
+$unsafeChars = ${(0, run_1.psString)(attachmentMatch_1.UNSAFE_FILE_NAME_CHARS)}
+$reservedName = ${(0, run_1.psString)(attachmentMatch_1.RESERVED_FILE_NAME)}
+$maxStem = ${(0, run_1.psInt)(attachmentMatch_1.MAX_FILE_STEM)}
+function Get-SafeFileName([string]$name) {
+    $safe = [regex]::Replace($name, $unsafeChars, '_').TrimEnd([char[]]'. ')
+    if ($safe -match $reservedName) { $safe = '_' + $safe }
+    $ext = [IO.Path]::GetExtension($safe)
+    $stem = $safe.Substring(0, $safe.Length - $ext.Length)
+    if ($stem.Length -gt $maxStem) { $safe = $stem.Substring(0, $maxStem) + $ext }
+    if (-not $safe) { $safe = 'attachment' }
+    return $safe
+}
+function Get-UniqueSavePath([string]$dir, [string]$name) {
+    $ext = [IO.Path]::GetExtension($name)
+    $stem = $name.Substring(0, $name.Length - $ext.Length)
+    $candidate = [IO.Path]::Combine($dir, $name)
+    $n = 1
+    while (Test-Path -LiteralPath $candidate) {
+        $candidate = [IO.Path]::Combine($dir, "$stem ($n)$ext")
+        $n++
+    }
+    return $candidate
+}
+`;
 /**
- * Locate one attachment by name into `$found`, or throw naming the email that
- * actually resolved. Matching is exact first, then whitespace-normalized (trim +
- * collapse runs, incl. non-breaking spaces) so a trivially reformatted filename
- * still resolves.
+ * Save the named attachments of one email, in the order named.
+ *
+ * Every name is matched before anything is written — exact first, then ignoring
+ * case and whitespace runs — so a batch with one bad name fails without having
+ * saved half its files. A name that matches nothing fails as NOT_FOUND naming
+ * the email that actually resolved and the attachments it does carry: an id can
+ * resolve to a different email than the caller meant, and a bare "not found"
+ * would point at the wrong problem.
  */
-const FIND_ATTACHMENT_PS = `
+async function saveEmailAttachments(request) {
+    const notFound = (0, attachmentMatch_1.attachmentNotFoundMessage)({
+        fileName: '$wanted',
+        senderEmail: '$senderSmtp',
+        subject: '$subject',
+        receivedTime: '$received',
+        present: '$present',
+    });
+    const output = await (0, run_1.runPowerShellJson)(`${scripts_1.SESSION_PS}
+${(0, scripts_1.itemLookupScript)(request.email)}
+${scripts_1.SENDER_SMTP_PS}
+${SAVE_PATH_PS}
+$destDir = ${(0, run_1.psString)(request.destDir)}
+$subject = ''
+try { $subject = [string]$item.Subject } catch {}
+$senderName = ''
+try { $senderName = [string]$item.SenderName } catch {}
+$received = ''
+try { $received = $item.ReceivedTime.ToString('yyyy-MM-dd HH:mm') } catch {}
+$attachments = @()
+foreach ($att in $item.Attachments) { $attachments += $att }
+$picks = @()
+foreach ($wanted in ${(0, run_1.psArray)(request.fileNames)}) {
     $found = $null
-    foreach ($att in $item.Attachments) {
-        if ($att.FileName -eq $target) { $found = $att; break }
-    }
+    foreach ($att in $attachments) { if ([string]$att.FileName -ceq $wanted) { $found = $att; break } }
     if ($found -eq $null) {
-        $tnorm = ($target -replace '\\s+', ' ').Trim()
-        foreach ($att in $item.Attachments) {
-            if ((($att.FileName -replace '\\s+', ' ').Trim()) -ieq $tnorm) { $found = $att; break }
+        $normalized = ($wanted -replace '\\s+', ' ').Trim()
+        foreach ($att in $attachments) {
+            if ((([string]$att.FileName) -replace '\\s+', ' ').Trim() -ieq $normalized) { $found = $att; break }
         }
     }
     if ($found -eq $null) {
-        $have = @(); foreach ($a in $item.Attachments) { $have += $a.FileName }
-        $haveStr = if ($have.Count -gt 0) { $have -join ', ' } else { '(none)' }
-        ${NOT_FOUND_THROW}
+        $present = (@($attachments | ForEach-Object { [string]$_.FileName }) -join ', ')
+        if (-not $present) { $present = '(none)' }
+        throw "${(0, errors_1.failureTag)('NOT_FOUND', 'attachment')}${notFound}"
     }
-`;
-/** The row every saver returns: the file, plus who the email was really from. */
-const SAVED_ROW_PS = `[PSCustomObject]@{
-        path         = $savePath
-        subject      = if ($item.Subject) { $item.Subject } else { '' }
-        senderName   = if ($item.SenderName) { $item.SenderName } else { '' }
-        senderEmail  = if ($item.SenderEmailAddress) { $item.SenderEmailAddress } else { '' }
-        receivedTime = if ($item.ReceivedTime) { $item.ReceivedTime.ToString('yyyy-MM-dd HH:mm') } else { '' }
-    }`;
-function savedAttachment(value) {
-    const e = (0, json_1.record)(value);
-    return {
-        path: (0, json_1.str)(e.path),
-        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),
-    };
-}
-/**
- * Save an email attachment by entryId and filename, returning the saved path
- * together with the resolved email's subject/sender so the caller can confirm the
- * file came from the email it intended.
- *
- * `destDir` is created if absent. Without one the file lands in a fresh directory
- * of its own, because attachments keep the name the sender gave them: a single
- * shared folder means two emails carrying "invoice.pdf" silently overwrite each
- * other. Pass `destDir` whenever you want the files somewhere you control.
- *
- * When the attachment isn't found, throws an error that names the email actually
- * resolved (from/subject/received) and the attachments it does carry. Because
- * GetItemFromID happily returns a *different* message when handed a stale or wrong
- * EntryID (common when many replies share one subject), a bare "not found" is
- * misleading — this surfaces which email you're really looking at.
- */
-async function saveEmailAttachmentDetailed(entryId, fileName, storeId, destDir) {
-    (0, run_1.requireWindows)();
-    const outDir = (0, runtime_1.resolveDestDir)(destDir);
-    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)}'" }
-$target = '${(0, run_1.psEscape)(fileName)}'
-${FIND_ATTACHMENT_PS}
-$savePath = [IO.Path]::Combine('${(0, run_1.psEscape)(outDir)}', $found.FileName)
-$found.SaveAsFile($savePath)
-$out = ${SAVED_ROW_PS}
-ConvertTo-Json $out -Compress
-`;
-    const raw = await (0, run_1.runPowerShell)(script, 15000);
-    if (!raw || !raw.trim())
-        throw new errors_1.NotFoundError('attachment', 'Failed to save attachment.');
-    return savedAttachment((0, json_1.parseObject)(raw));
-}
-/** Save an attachment and return just the saved file path. */
-async function saveEmailAttachment(entryId, fileName, storeId, destDir) {
-    return (await saveEmailAttachmentDetailed(entryId, fileName, storeId, destDir)).path;
+    $picks += $found
 }
-/**
- * Save several attachments from one email in a single COM round trip — what a
- * caller working through searchInboxByFilter/readSelectedEmail results wants,
- * rather than paying a PowerShell process spawn per attachment. Destination,
- * matching and the not-found error follow saveEmailAttachmentDetailed's rules
- * exactly, applied per name; results come back in the same order as `fileNames`.
- */
-async function saveEmailAttachments(entryId, fileNames, storeId, destDir) {
-    (0, run_1.requireWindows)();
-    if (fileNames.length === 0)
-        return [];
-    const outDir = (0, runtime_1.resolveDestDir)(destDir);
-    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)}'" }
-$targets = @(${(0, run_1.psList)(fileNames)})
-$results = @()
-foreach ($target in $targets) {
-${FIND_ATTACHMENT_PS}
-    $savePath = [IO.Path]::Combine('${(0, run_1.psEscape)(outDir)}', $found.FileName)
-    $found.SaveAsFile($savePath)
-    $results += ${SAVED_ROW_PS}
+$rows = @()
+foreach ($att in $picks) {
+    $fileName = [string]$att.FileName
+    $savePath = Get-UniqueSavePath $destDir (Get-SafeFileName $fileName)
+    $att.SaveAsFile($savePath)
+    $rows += [PSCustomObject]@{
+        path         = $savePath
+        fileName     = $fileName
+        subject      = $subject.Trim()
+        senderName   = $senderName
+        senderEmail  = $senderSmtp
+        receivedTime = $received
+    }
 }
-ConvertTo-Json $results -Depth 3 -Compress
-`;
-    const raw = await (0, run_1.runPowerShell)(script, 15000);
-    if (!raw || !raw.trim())
-        throw new errors_1.NotFoundError('attachment', 'Failed to save attachments.');
-    return (0, json_1.parseArray)(raw).map(savedAttachment);
+ConvertTo-Json -Compress -Depth 3 -InputObject @($rows)
+`, 'standard');
+    return (0, json_1.toArray)(output).map(row => {
+        const e = (0, json_1.record)(row);
+        return {
+            path: (0, json_1.str)(e.path),
+            fileName: (0, json_1.str)(e.fileName),
+            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),
+        };
+    });
 }
 //# sourceMappingURL=attachments.js.map

package/dist/windows/attachments.js.map

@@ -1 +1 @@
-{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../src/windows/attachments.ts"],"names":[],"mappings":";;AAmFA,kEAwBC;AAGD,kDAOC;AASD,oDA4BC;AA1JD,gEAAgE;AAChE,+BAAwE;AACxE,uCAA0C;AAC1C,yCAAsE;AACtE,+DAAsE;AACtE,wCAA4C;AAC5C,sCAA0C;AAG1C;;;;GAIG;AACH,MAAM,eAAe,GAAG,UAAU,IAAA,2CAAyB,EAAC;IACxD,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,6BAA6B;IAC1C,OAAO,EAAE,kBAAkB;IAC3B,YAAY,EAAE,uBAAuB;IACrC,OAAO,EAAE,UAAU;IACnB,OAAO,EAAE,SAAS;CACrB,CAAC,GAAG,CAAC;AAEN;;;;;GAKG;AACH,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;UAcjB,eAAe;;CAExB,CAAC;AAEF,iFAAiF;AACjF,MAAM,YAAY,GAAG;;;;;;MAMf,CAAC;AAEP,SAAS,eAAe,CAAC,KAAc;IACnC,MAAM,CAAC,GAAG,IAAA,aAAM,EAAC,KAAK,CAAC,CAAC;IACxB,OAAO;QACH,IAAI,EAAE,IAAA,UAAG,EAAC,CAAC,CAAC,IAAI,CAAC;QACjB,OAAO,EAAE,IAAA,UAAG,EAAC,CAAC,CAAC,OAAO,CAAC;QACvB,UAAU,EAAE,IAAA,UAAG,EAAC,CAAC,CAAC,UAAU,CAAC;QAC7B,WAAW,EAAE,IAAA,UAAG,EAAC,CAAC,CAAC,WAAW,CAAC;QAC/B,YAAY,EAAE,IAAA,UAAG,EAAC,CAAC,CAAC,YAAY,CAAC;KACpC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACI,KAAK,UAAU,2BAA2B,CAC7C,OAAe,EACf,QAAgB,EAChB,OAAgB,EAChB,OAAgB;IAEhB,IAAA,oBAAc,GAAE,CAAC;IACjB,MAAM,MAAM,GAAG,IAAA,wBAAc,EAAC,OAAO,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG;;;;EAIjB,IAAA,uBAAa,EAAC,OAAO,EAAE,OAAO,CAAC;6DAC4B,IAAA,cAAQ,EAAC,OAAO,CAAC;aACjE,IAAA,cAAQ,EAAC,QAAQ,CAAC;EAC7B,kBAAkB;kCACc,IAAA,cAAQ,EAAC,MAAM,CAAC;;SAEzC,YAAY;;CAEpB,CAAC;IACE,MAAM,GAAG,GAAG,MAAM,IAAA,mBAAa,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,sBAAa,CAAC,YAAY,EAAE,4BAA4B,CAAC,CAAC;IAC7F,OAAO,eAAe,CAAC,IAAA,kBAAW,EAAC,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,8DAA8D;AACvD,KAAK,UAAU,mBAAmB,CACrC,OAAe,EACf,QAAgB,EAChB,OAAgB,EAChB,OAAgB;IAEhB,OAAO,CAAC,MAAM,2BAA2B,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AACzF,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,oBAAoB,CACtC,OAAe,EACf,SAAmB,EACnB,OAAgB,EAChB,OAAgB;IAEhB,IAAA,oBAAc,GAAE,CAAC;IACjB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,IAAA,wBAAc,EAAC,OAAO,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG;;;;EAIjB,IAAA,uBAAa,EAAC,OAAO,EAAE,OAAO,CAAC;6DAC4B,IAAA,cAAQ,EAAC,OAAO,CAAC;eAC/D,IAAA,YAAM,EAAC,SAAS,CAAC;;;EAG9B,kBAAkB;sCACkB,IAAA,cAAQ,EAAC,MAAM,CAAC;;kBAEpC,YAAY;;;CAG7B,CAAC;IACE,MAAM,GAAG,GAAG,MAAM,IAAA,mBAAa,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,sBAAa,CAAC,YAAY,EAAE,6BAA6B,CAAC,CAAC;IAC9F,OAAO,IAAA,iBAAU,EAAC,GAAG,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"attachments.js","sourceRoot":"","sources":["../../src/windows/attachments.ts"],"names":[],"mappings":";;AAuDA,oDAiEC;AAxHD,mCAAmC;AACnC,+BAAoE;AACpE,uCAAyE;AACzE,yCAAsD;AACtD,+DAKmC;AACnC,sCAAuC;AAIvC;;;;GAIG;AACH,MAAM,YAAY,GAAG;iBACJ,IAAA,cAAQ,EAAC,wCAAsB,CAAC;kBAC/B,IAAA,cAAQ,EAAC,oCAAkB,CAAC;aACjC,IAAA,WAAK,EAAC,+BAAa,CAAC;;;;;;;;;;;;;;;;;;;;;CAqBhC,CAAC;AAEF;;;;;;;;;GASG;AACI,KAAK,UAAU,oBAAoB,CAAC,OAA+B;IACtE,MAAM,QAAQ,GAAG,IAAA,2CAAyB,EAAC;QACvC,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,aAAa;QAC1B,OAAO,EAAE,UAAU;QACnB,YAAY,EAAE,WAAW;QACzB,OAAO,EAAE,UAAU;KACtB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,IAAA,uBAAiB,EAAC,GAAG,oBAAU;EACtD,IAAA,0BAAgB,EAAC,OAAO,CAAC,KAAK,CAAC;EAC/B,wBAAc;EACd,YAAY;aACD,IAAA,cAAQ,EAAC,OAAO,CAAC,OAAO,CAAC;;;;;;;;;;sBAUhB,IAAA,aAAO,EAAC,OAAO,CAAC,SAAS,CAAC;;;;;;;;;;;;iBAY/B,IAAA,mBAAU,EAAC,WAAW,EAAE,YAAY,CAAC,GAAG,QAAQ;;;;;;;;;;;;;;;;;;;CAmBhE,EAAE,UAAU,CAAC,CAAC;IACX,OAAO,IAAA,cAAO,EAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QAC7B,MAAM,CAAC,GAAG,IAAA,aAAM,EAAC,GAAG,CAAC,CAAC;QACtB,OAAO;YACH,IAAI,EAAE,IAAA,UAAG,EAAC,CAAC,CAAC,IAAI,CAAC;YACjB,QAAQ,EAAE,IAAA,UAAG,EAAC,CAAC,CAAC,QAAQ,CAAC;YACzB,OAAO,EAAE,IAAA,UAAG,EAAC,CAAC,CAAC,OAAO,CAAC;YACvB,UAAU,EAAE,IAAA,UAAG,EAAC,CAAC,CAAC,UAAU,CAAC;YAC7B,WAAW,EAAE,IAAA,UAAG,EAAC,CAAC,CAAC,WAAW,CAAC;YAC/B,YAAY,EAAE,IAAA,UAAG,EAAC,CAAC,CAAC,YAAY,CAAC;SACpC,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC","sourcesContent":["// Saving attachments off an email.\nimport { psArray, psInt, psString, runPowerShellJson } from './run';\nimport { itemLookupScript, SENDER_SMTP_PS, SESSION_PS } from './scripts';\nimport { record, str, toArray } from '../shared/json';\nimport {\n    attachmentNotFoundMessage,\n    MAX_FILE_STEM,\n    RESERVED_FILE_NAME,\n    UNSAFE_FILE_NAME_CHARS,\n} from '../shared/attachmentMatch';\nimport { failureTag } from '../errors';\nimport type { SaveAttachmentsRequest } from '../backend';\nimport type { SavedAttachment } from '../types';\n\n/**\n * The file-name rules from shared/attachmentMatch.ts, as PowerShell: the same\n * sanitizing `safeFileName` does, and the same never-overwrite numbering as\n * `uniqueSavePath`.\n */\nconst SAVE_PATH_PS = `\n$unsafeChars = ${psString(UNSAFE_FILE_NAME_CHARS)}\n$reservedName = ${psString(RESERVED_FILE_NAME)}\n$maxStem = ${psInt(MAX_FILE_STEM)}\nfunction Get-SafeFileName([string]$name) {\n    $safe = [regex]::Replace($name, $unsafeChars, '_').TrimEnd([char[]]'. ')\n    if ($safe -match $reservedName) { $safe = '_' + $safe }\n    $ext = [IO.Path]::GetExtension($safe)\n    $stem = $safe.Substring(0, $safe.Length - $ext.Length)\n    if ($stem.Length -gt $maxStem) { $safe = $stem.Substring(0, $maxStem) + $ext }\n    if (-not $safe) { $safe = 'attachment' }\n    return $safe\n}\nfunction Get-UniqueSavePath([string]$dir, [string]$name) {\n    $ext = [IO.Path]::GetExtension($name)\n    $stem = $name.Substring(0, $name.Length - $ext.Length)\n    $candidate = [IO.Path]::Combine($dir, $name)\n    $n = 1\n    while (Test-Path -LiteralPath $candidate) {\n        $candidate = [IO.Path]::Combine($dir, \"$stem ($n)$ext\")\n        $n++\n    }\n    return $candidate\n}\n`;\n\n/**\n * Save the named attachments of one email, in the order named.\n *\n * Every name is matched before anything is written — exact first, then ignoring\n * case and whitespace runs — so a batch with one bad name fails without having\n * saved half its files. A name that matches nothing fails as NOT_FOUND naming\n * the email that actually resolved and the attachments it does carry: an id can\n * resolve to a different email than the caller meant, and a bare \"not found\"\n * would point at the wrong problem.\n */\nexport async function saveEmailAttachments(request: SaveAttachmentsRequest): Promise<SavedAttachment[]> {\n    const notFound = attachmentNotFoundMessage({\n        fileName: '$wanted',\n        senderEmail: '$senderSmtp',\n        subject: '$subject',\n        receivedTime: '$received',\n        present: '$present',\n    });\n    const output = await runPowerShellJson(`${SESSION_PS}\n${itemLookupScript(request.email)}\n${SENDER_SMTP_PS}\n${SAVE_PATH_PS}\n$destDir = ${psString(request.destDir)}\n$subject = ''\ntry { $subject = [string]$item.Subject } catch {}\n$senderName = ''\ntry { $senderName = [string]$item.SenderName } catch {}\n$received = ''\ntry { $received = $item.ReceivedTime.ToString('yyyy-MM-dd HH:mm') } catch {}\n$attachments = @()\nforeach ($att in $item.Attachments) { $attachments += $att }\n$picks = @()\nforeach ($wanted in ${psArray(request.fileNames)}) {\n    $found = $null\n    foreach ($att in $attachments) { if ([string]$att.FileName -ceq $wanted) { $found = $att; break } }\n    if ($found -eq $null) {\n        $normalized = ($wanted -replace '\\\\s+', ' ').Trim()\n        foreach ($att in $attachments) {\n            if ((([string]$att.FileName) -replace '\\\\s+', ' ').Trim() -ieq $normalized) { $found = $att; break }\n        }\n    }\n    if ($found -eq $null) {\n        $present = (@($attachments | ForEach-Object { [string]$_.FileName }) -join ', ')\n        if (-not $present) { $present = '(none)' }\n        throw \"${failureTag('NOT_FOUND', 'attachment')}${notFound}\"\n    }\n    $picks += $found\n}\n$rows = @()\nforeach ($att in $picks) {\n    $fileName = [string]$att.FileName\n    $savePath = Get-UniqueSavePath $destDir (Get-SafeFileName $fileName)\n    $att.SaveAsFile($savePath)\n    $rows += [PSCustomObject]@{\n        path         = $savePath\n        fileName     = $fileName\n        subject      = $subject.Trim()\n        senderName   = $senderName\n        senderEmail  = $senderSmtp\n        receivedTime = $received\n    }\n}\nConvertTo-Json -Compress -Depth 3 -InputObject @($rows)\n`, 'standard');\n    return toArray(output).map(row => {\n        const e = record(row);\n        return {\n            path: str(e.path),\n            fileName: str(e.fileName),\n            subject: str(e.subject),\n            senderName: str(e.senderName),\n            senderEmail: str(e.senderEmail),\n            receivedTime: str(e.receivedTime),\n        };\n    });\n}\n"]}

package/dist/windows/bounces.d.ts

@@ -1,34 +1,21 @@
+import type { CleanUndeliverableRequest, CollectBouncesRequest, SentGroupsRequest } from '../backend';
 import type { CleanUndeliverableResult, SentRecipientGroup } from '../types';
 /**
- * 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.
  */
-export declare function cleanUndeliverableEmails(emailAccount: string, daysBack?: number, dryRun?: boolean): Promise<CleanUndeliverableResult>;
+export declare function cleanUndeliverableEmails(request: CleanUndeliverableRequest): Promise<CleanUndeliverableResult>;
 /**
- * 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.
  */
-export declare function collectBouncedRecipients(emailAccount: string, daysBack?: number, scanDeleted?: boolean): Promise<string[]>;
+export declare function collectBouncedRecipients(request: CollectBouncesRequest): Promise<string[]>;
 /**
- * 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.
  */
-export declare function readSentRecipientGroups(emailAccount: string, daysBack?: number, limit?: number): Promise<SentRecipientGroup[]>;
+export declare function readSentRecipientGroups(request: SentGroupsRequest): Promise<SentRecipientGroup[]>;