@dawnlit/outlook-bridge 1.0.0

package/dist/outlookTemplateSections.js

@@ -0,0 +1,313 @@
+"use strict";
+/**
+ * Section + placeholder composition for the operator's Outlook template emails.
+ *
+ * A template email is a normal saved mail the operator edits in Outlook, so the
+ * greeting, closing and signature are theirs. Where one template serves several
+ * reply types, the variants live inside it between markers:
+ *
+ *     Hello,
+ *     [[QUOTE]]     Thank you for your quote...        [[/QUOTE]]
+ *     [[NOQUOTE]]   Thank you for letting us know...   [[/NOQUOTE]]
+ *     [[CLARIFY]]   {{QUESTIONS}}                      [[/CLARIFY]]
+ *     Best regards, <signature>
+ *
+ * Composing keeps the requested section, drops the others, and substitutes any
+ * {{PLACEHOLDER}} — so the shared wording is written once and the caller only
+ * names a section instead of carrying (and editing) 40-50k of Word HTML.
+ *
+ * Everything here works on the raw HTML string rather than a parsed tree: Word's
+ * markup carries conditional comments and namespaced tags that a round-trip
+ * through a parser would rewrite, and the reply body must stay byte-identical to
+ * what the operator wrote.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findTemplateMarkers = findTemplateMarkers;
+exports.replaceToken = replaceToken;
+exports.removeTokenLine = removeTokenLine;
+exports.findTokens = findTokens;
+exports.findUnfilledTokens = findUnfilledTokens;
+exports.composeTemplateBody = composeTemplateBody;
+const errors_1 = require("./errors");
+/** Marker/placeholder names: what an operator can reasonably type in Outlook. */
+const NAME = '[A-Za-z0-9_-]{1,40}';
+/**
+ * What Word may inject *between two characters of a marker*: tags (it splits runs
+ * across <span>s freely), comments, non-breaking spaces, and the newlines it wraps
+ * long lines with — sometimes mid-word. So `[[QUOTE]]` is matched character by
+ * character with this between, never as a literal string.
+ */
+const GAP = '(?:<!--[\\s\\S]*?-->|<[^>]*>|&nbsp;|&#160;|\\s)*';
+/** Block elements a marker can sit alone inside; the whole block goes when it does. */
+const BLOCK_TAGS = ['p', 'div', 'li'];
+/**
+ * Block elements that make up one *line* of a template, for a placeholder whose
+ * empty value takes its whole line out (see `removeTokenLine`). Ordered
+ * outermost-first: Word puts a <p> inside every table cell, so a token in a
+ * details table has to drop the <tr> — dropping the <p> would leave the row's
+ * label cell sitting beside a blank one.
+ *
+ * <div> is deliberately absent: it is rarely a line and often the wrapper around
+ * the entire body, so a token sitting directly in one would take the whole email
+ * with it. Falling back to deleting just the token is the safer miss.
+ */
+const LINE_TAGS = ['tr', 'li', 'p'];
+function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Tag-tolerant matcher for one literal marker, e.g. `[[/QUOTE]]` or `{{QUESTIONS}}`.
+ *
+ * Memoized: the pattern interleaves `GAP` between every character, so a 15-character
+ * token compiles to several hundred characters, and the replace loops ask for the
+ * same token repeatedly while walking a template.
+ */
+const markerRegexCache = new Map();
+function markerRegex(token) {
+    let regex = markerRegexCache.get(token);
+    if (!regex) {
+        regex = new RegExp(token.split('').map(escapeRe).join(GAP), 'i');
+        markerRegexCache.set(token, regex);
+    }
+    return regex;
+}
+/** HTML → rough plain text, enough to spot markers and to test a block for emptiness. */
+function stripToText(html) {
+    return html
+        .replace(/<!--[\s\S]*?-->/g, '')
+        .replace(/<[^>]*>/g, '')
+        .replace(/&nbsp;|&#160;/gi, ' ');
+}
+/** Find the markers in a template body (HTML or the plain-text body Outlook derives). */
+function findTemplateMarkers(body) {
+    const text = stripToText(body || '');
+    const opened = [];
+    const closed = new Set();
+    const seen = new Set();
+    const sectionRe = new RegExp(`\\[\\[\\s*(/?)\\s*(${NAME})\\s*\\]\\]`, 'g');
+    let m;
+    while ((m = sectionRe.exec(text)) !== null) {
+        const name = m[2].toUpperCase();
+        if (m[1]) {
+            closed.add(name);
+        }
+        else if (!seen.has(name)) {
+            seen.add(name);
+            opened.push(name);
+        }
+    }
+    const placeholders = [];
+    const placeholderRe = new RegExp(`\\{\\{\\s*(${NAME})\\s*\\}\\}`, 'g');
+    while ((m = placeholderRe.exec(text)) !== null) {
+        const name = m[1].toUpperCase();
+        if (!placeholders.includes(name))
+            placeholders.push(name);
+    }
+    return { sections: opened.filter(n => closed.has(n)), placeholders };
+}
+/**
+ * Every `[[...]]` / `{{...}}` token still in a body, matched pairs or not — the
+ * last check before a composed reply is handed to Outlook, so a marker the
+ * operator half-deleted stops the run instead of going out to a carrier.
+ */
+function markerTokens(body) {
+    const text = stripToText(body || '');
+    const re = new RegExp(`\\[\\[\\s*/?\\s*${NAME}\\s*\\]\\]|\\{\\{\\s*${NAME}\\s*\\}\\}`, 'g');
+    const found = [];
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        const token = m[0].replace(/\s+/g, '');
+        if (!found.includes(token))
+            found.push(token);
+    }
+    return found;
+}
+/**
+ * The nearest enclosing block element of [start, end), or null when the marker
+ * isn't inside one. The closing tag is the first of the same name after the
+ * marker — Word doesn't nest <p>, and where the guess is wrong the emptiness
+ * test below simply fails and the caller falls back to the marker's own span.
+ */
+function enclosingBlock(html, start, end, tags = BLOCK_TAGS) {
+    let best = null;
+    for (const tag of tags) {
+        const openRe = new RegExp(`<${tag}(?:\\s[^>]*)?>`, 'gi');
+        let m;
+        while ((m = openRe.exec(html)) !== null) {
+            if (m.index >= start)
+                break;
+            if (!best || m.index > best.idx) {
+                best = { idx: m.index, contentStart: m.index + m[0].length, tag };
+            }
+        }
+    }
+    if (!best)
+        return null;
+    const closeRe = new RegExp(`</${best.tag}\\s*>`, 'gi');
+    closeRe.lastIndex = end;
+    const close = closeRe.exec(html);
+    if (!close)
+        return null;
+    return {
+        block: { start: best.idx, end: close.index + close[0].length },
+        contentStart: best.contentStart,
+        contentEnd: close.index,
+    };
+}
+/**
+ * What to delete for a marker: the whole paragraph when the marker is alone in it
+ * (removing only the text would leave a blank line in the reply), otherwise just
+ * the marker's own characters.
+ */
+function markerSpan(html, start, end) {
+    const found = enclosingBlock(html, start, end);
+    if (!found || found.contentStart > start || found.contentEnd < end)
+        return { start, end };
+    const rest = html.slice(found.contentStart, start) + html.slice(end, found.contentEnd);
+    return stripToText(rest).trim() === '' ? found.block : { start, end };
+}
+function locate(html, token) {
+    const m = markerRegex(token).exec(html);
+    return m ? { start: m.index, end: m.index + m[0].length } : null;
+}
+// ── Single-token fill ───────────────────────────────────────────────
+//
+// The section machinery below is for templates that hold several variants of one
+// reply. These three are for the simpler case: a template whose wording is fixed
+// and whose details — a lane, a cargo weight — are typed somewhere else and dropped
+// into `{Token}` placeholders. Same tag-tolerant matching, since the operator
+// edits these templates in Outlook too.
+/** Replace every occurrence of `token` with `value`, which is never rescanned. */
+function replaceToken(html, token, value) {
+    let done = '';
+    let rest = html;
+    for (;;) {
+        const at = locate(rest, token);
+        if (!at)
+            return done + rest;
+        done += rest.slice(0, at.start) + value;
+        rest = rest.slice(at.end);
+    }
+}
+/**
+ * Remove `token` along with the line it sits on — the table row or paragraph,
+ * label included. For an optional detail this is the difference between the email
+ * not mentioning it at all and it carrying a heading with nothing under it.
+ * Falls back to deleting just the token when it isn't inside a line element.
+ */
+function removeTokenLine(html, token) {
+    let out = html;
+    for (;;) {
+        const at = locate(out, token);
+        if (!at)
+            return out;
+        const cut = lineSpan(out, at);
+        out = out.slice(0, cut.start) + out.slice(cut.end);
+    }
+}
+/**
+ * The line to delete for a token at `at`: its enclosing row or paragraph, or the
+ * token's own span when it isn't in one.
+ *
+ * `enclosingBlock` returns the *nearest* opening tag before the token, which is
+ * only the enclosing one if it hasn't already been closed — a token in a
+ * paragraph after a table has a `<tr>` before it and a `</tr>` after it without
+ * ever being inside a row, and taking that span would delete the table.
+ */
+function lineSpan(html, at) {
+    for (const tag of LINE_TAGS) {
+        const found = enclosingBlock(html, at.start, at.end, [tag]);
+        if (!found)
+            continue;
+        const closedBefore = new RegExp(`</${tag}\\s*>`, 'i').test(html.slice(found.contentStart, at.start));
+        if (!closedBefore)
+            return found.block;
+    }
+    return at;
+}
+/** Which of `tokens` the template actually uses — what the caller has to supply. */
+function findTokens(html, tokens) {
+    const text = stripToText(html || '');
+    return tokens.filter(token => markerRegex(token).test(text));
+}
+/**
+ * `{Token}`-shaped text still in a filled-in body: a placeholder misspelled in
+ * Outlook, or one the app has no field for. Reads the visible text only, so the
+ * braces in a Word <style> block are not mistaken for placeholders.
+ */
+function findUnfilledTokens(html) {
+    const text = stripToText((html || '').replace(/<(style|script)\b[^>]*>[\s\S]*?<\/\1>/gi, ''));
+    const found = [];
+    const re = /\{\s*([A-Za-z][A-Za-z0-9 _-]{0,30})\s*\}/g;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        const token = `{${m[1].trim()}}`;
+        if (!found.includes(token))
+            found.push(token);
+    }
+    return found;
+}
+/**
+ * Resolve a template body down to the one reply that goes out: keep `section`,
+ * drop the rest, fill the placeholders. Throws rather than guessing — a template
+ * the operator edited into an unusable state must stop the run, not quietly send
+ * a reply with `[[QUOTE]]` or an empty question list in it.
+ */
+function composeTemplateBody(html, options = {}) {
+    const label = options.label ? `Template '${options.label}'` : 'The template';
+    const wanted = (options.section || '').trim().toUpperCase();
+    const { sections, placeholders: available } = findTemplateMarkers(html);
+    if (wanted && !sections.includes(wanted)) {
+        throw new errors_1.InvalidRequestError(sections.length
+            ? `${label} has no [[${wanted}]] section. Sections found: ${sections.join(', ')}.`
+            : `${label} has no [[${wanted}]]...[[/${wanted}]] markers — it holds a single body, so drop templateSection (or add the markers in Outlook).`);
+    }
+    if (!wanted && sections.length) {
+        throw new errors_1.InvalidRequestError(`${label} is split into sections (${sections.join(', ')}) — name one with templateSection, `
+            + `otherwise the reply would go out with the markers and every variant in it.`);
+    }
+    // Deletions are collected first and applied right-to-left, so each span's
+    // indices still refer to the string it was measured against.
+    const cuts = [];
+    for (const name of sections) {
+        const open = locate(html, `[[${name}]]`);
+        const close = locate(html, `[[/${name}]]`);
+        if (!open || !close || close.start < open.end) {
+            throw new errors_1.InvalidRequestError(`${label} has a malformed [[${name}]] section — expected [[${name}]] ... [[/${name}]] in that order.`);
+        }
+        const openSpan = markerSpan(html, open.start, open.end);
+        const closeSpan = markerSpan(html, close.start, close.end);
+        if (name === wanted) {
+            cuts.push(openSpan, closeSpan); // keep the content, shed the markers
+        }
+        else {
+            cuts.push({ start: openSpan.start, end: closeSpan.end });
+        }
+    }
+    let out = html;
+    for (const cut of cuts.sort((a, b) => b.start - a.start)) {
+        out = out.slice(0, cut.start) + out.slice(cut.end);
+    }
+    for (const [rawKey, value] of Object.entries(options.placeholders || {})) {
+        const key = rawKey.trim().toUpperCase();
+        if (!available.includes(key)) {
+            throw new errors_1.InvalidRequestError(`${label} has no {{${key}}} placeholder`
+                + (available.length ? ` (found: ${available.map(p => `{{${p}}}`).join(', ')}).` : '.')
+                + ` It may have been edited out in Outlook — ask the user rather than guessing where the text goes.`);
+        }
+        const m = markerRegex(`{{${key}}}`).exec(out);
+        // Absent from `out` but present in the template = it lived in a dropped
+        // section, which is the caller over-supplying, not an error.
+        if (m)
+            out = out.slice(0, m.index) + (value ?? '') + out.slice(m.index + m[0].length);
+    }
+    const leftover = markerTokens(out);
+    if (leftover.length) {
+        const hint = leftover.every(t => t.startsWith('{{'))
+            ? `Pass a value for each in templatePlaceholders.`
+            : `Check the template in Outlook — every [[SECTION]] needs its [[/SECTION]].`;
+        throw new errors_1.InvalidRequestError(`${label} still contains unresolved markers after composing: ${leftover.join(', ')}. ${hint} The reply was not created.`);
+    }
+    return out;
+}
+//# sourceMappingURL=outlookTemplateSections.js.map

package/dist/outlookTemplateSections.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,76 @@
+/** One completed script run, handed to the `debug` hook. */
+export interface BridgeDebugEvent {
+    /** Which interpreter ran it. */
+    runner: 'powershell' | 'osascript';
+    /** The generated script, verbatim — the thing you actually want when a run fails. */
+    script: string;
+    durationMs: number;
+    /** Present only when the run failed. */
+    error?: string;
+}
+export interface BridgeOptions {
+    /**
+     * Default ceiling (ms) on a single script run; 0 disables it. Calls that
+     * already carry a specific budget (a full-mailbox scan, a purge) keep their
+     * own and ignore this.
+     */
+    timeoutMs?: number;
+    /**
+     * Max bytes a script may write to stdout before the run is killed. A read
+     * that returns message bodies is what pushes against this — raise it before
+     * scanning a mailbox that returns thousands of matches.
+     */
+    maxBufferBytes?: number;
+    /** Directory for generated scripts and for saved attachments when the caller
+     *  names no destination. Defaults to the OS temp directory. */
+    tempDir?: string;
+    /**
+     * Cancels in-flight runs: the interpreter is killed and the call rejects with
+     * an `AbortedError`. A timeout only caps a run's length — this is how a UI
+     * with a Cancel button, or a shutting-down process, calls one off early.
+     *
+     * Most useful scoped to the calls you want to cancel rather than set process
+     * wide: `bridge.withOptions({ signal }).searchInboxByFilter(...)`.
+     */
+    signal?: AbortSignal;
+    /** `true` logs every generated script to stderr; a function receives each run
+     *  instead. Defaults to on when OUTLOOK_BRIDGE_DEBUG is set to a non-empty,
+     *  non-'0' value. */
+    debug?: boolean | ((event: BridgeDebugEvent) => void);
+}
+export type ResolvedConfig = Required<Pick<BridgeOptions, 'timeoutMs' | 'maxBufferBytes' | 'tempDir'>> & Pick<BridgeOptions, 'debug' | 'signal'>;
+/** Merge caller options over a base, ignoring the keys they left out. */
+export declare function mergeOptions(base: ResolvedConfig, options?: BridgeOptions): ResolvedConfig;
+/**
+ * Override the process-wide defaults. Merges, so naming one option leaves the
+ * rest alone. Call before the first automation call.
+ *
+ * Affects every caller in the process. Prefer `createOutlookBridge(options)` in
+ * anything that shares a process with code you don't own.
+ */
+export declare function configure(options: BridgeOptions): void;
+/** The settings in force for the current call — the enclosing scope's, else global. */
+export declare function getConfig(): Readonly<ResolvedConfig>;
+/** The process-wide defaults, ignoring any active scope. */
+export declare function getGlobalConfig(): Readonly<ResolvedConfig>;
+/** Run `fn` with `config` in force for it and everything it awaits. */
+export declare function withConfig<T>(config: ResolvedConfig, fn: () => T): T;
+/** Report one finished script run to the configured debug hook. */
+export declare function reportRun(event: BridgeDebugEvent): void;
+/**
+ * Path for a scratch file in the configured temp directory. The random suffix
+ * matters: two concurrent calls landing in the same millisecond would otherwise
+ * pick the same name and overwrite each other's script mid-run.
+ */
+export declare function tempFile(kind: string, extension: string): string;
+/**
+ * A fresh directory for one call's saved attachments.
+ *
+ * Deliberately per-call rather than one shared folder: attachments are saved
+ * under the name the sender gave them, so two emails that both carry
+ * "invoice.pdf" would otherwise silently overwrite each other — and so would two
+ * unrelated programs using this package on the same machine.
+ */
+export declare function makeAttachmentDir(): string;
+/** Resolve a caller-supplied destination, creating it when absent. */
+export declare function resolveDestDir(destDir?: string): string;

package/dist/runtime.js

@@ -0,0 +1,123 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeOptions = mergeOptions;
+exports.configure = configure;
+exports.getConfig = getConfig;
+exports.getGlobalConfig = getGlobalConfig;
+exports.withConfig = withConfig;
+exports.reportRun = reportRun;
+exports.tempFile = tempFile;
+exports.makeAttachmentDir = makeAttachmentDir;
+exports.resolveDestDir = resolveDestDir;
+// Process-wide knobs and shared scratch-file handling for the generated
+// PowerShell / AppleScript runs.
+//
+// Every call in this package works by generating a script and shelling out to an
+// interpreter, which leaves a consumer four things they cannot otherwise reach:
+// how long a run may take, how much it may print, how to call it off, and what
+// the script actually said when it failed. Those are the settings here.
+const async_hooks_1 = require("async_hooks");
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const envDebug = process.env.OUTLOOK_BRIDGE_DEBUG;
+/** The process-wide defaults, as mutated by `configure()`. */
+const globalConfig = {
+    timeoutMs: 120000,
+    maxBufferBytes: 8 * 1024 * 1024,
+    tempDir: os_1.default.tmpdir(),
+    debug: !!envDebug && envDebug !== '0',
+};
+/**
+ * Per-instance config, scoped to an async call tree.
+ *
+ * `createOutlookBridge()` hands each instance its own settings, but the platform
+ * services are 3,000 lines of module-level functions that read `getConfig()`
+ * directly. Threading a config parameter through all of them would touch every
+ * line for no behavioural gain; an AsyncLocalStorage lets an instance wrap its
+ * calls instead, and the store follows across every `await` inside one. Two
+ * bridges with different timeouts can then run concurrently in one process,
+ * which is the thing a second consumer actually needs and the global could never
+ * give them.
+ */
+const scoped = new async_hooks_1.AsyncLocalStorage();
+/** Merge caller options over a base, ignoring the keys they left out. */
+function mergeOptions(base, options = {}) {
+    const next = { ...base };
+    if (options.timeoutMs !== undefined)
+        next.timeoutMs = Math.max(0, options.timeoutMs);
+    if (options.maxBufferBytes !== undefined)
+        next.maxBufferBytes = Math.max(1, options.maxBufferBytes);
+    if (options.tempDir !== undefined)
+        next.tempDir = options.tempDir;
+    if (options.signal !== undefined)
+        next.signal = options.signal;
+    if (options.debug !== undefined)
+        next.debug = options.debug;
+    return next;
+}
+/**
+ * Override the process-wide defaults. Merges, so naming one option leaves the
+ * rest alone. Call before the first automation call.
+ *
+ * Affects every caller in the process. Prefer `createOutlookBridge(options)` in
+ * anything that shares a process with code you don't own.
+ */
+function configure(options) {
+    Object.assign(globalConfig, mergeOptions(globalConfig, options));
+}
+/** The settings in force for the current call — the enclosing scope's, else global. */
+function getConfig() {
+    return scoped.getStore() ?? globalConfig;
+}
+/** The process-wide defaults, ignoring any active scope. */
+function getGlobalConfig() {
+    return globalConfig;
+}
+/** Run `fn` with `config` in force for it and everything it awaits. */
+function withConfig(config, fn) {
+    return scoped.run(config, fn);
+}
+/** Report one finished script run to the configured debug hook. */
+function reportRun(event) {
+    const { debug } = getConfig();
+    if (!debug)
+        return;
+    if (typeof debug === 'function') {
+        debug(event);
+        return;
+    }
+    const outcome = event.error ? `FAILED: ${event.error}` : 'ok';
+    process.stderr.write(`[outlook-bridge] ${event.runner} ${event.durationMs}ms ${outcome}\n${event.script}\n`);
+}
+/**
+ * Path for a scratch file in the configured temp directory. The random suffix
+ * matters: two concurrent calls landing in the same millisecond would otherwise
+ * pick the same name and overwrite each other's script mid-run.
+ */
+function tempFile(kind, extension) {
+    const unique = `${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+    return path_1.default.join(getConfig().tempDir, `outlook-bridge-${kind}-${unique}.${extension}`);
+}
+/**
+ * A fresh directory for one call's saved attachments.
+ *
+ * Deliberately per-call rather than one shared folder: attachments are saved
+ * under the name the sender gave them, so two emails that both carry
+ * "invoice.pdf" would otherwise silently overwrite each other — and so would two
+ * unrelated programs using this package on the same machine.
+ */
+function makeAttachmentDir() {
+    return fs_1.default.mkdtempSync(path_1.default.join(getConfig().tempDir, 'outlook-bridge-attachments-'));
+}
+/** Resolve a caller-supplied destination, creating it when absent. */
+function resolveDestDir(destDir) {
+    if (!destDir)
+        return makeAttachmentDir();
+    fs_1.default.mkdirSync(destDir, { recursive: true });
+    return destDir;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/shared/attachmentMatch.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Collapse whitespace runs (non-breaking spaces included) and trim, so a
+ * trivially reformatted filename still resolves. Both platforms' regex engines
+ * treat `\s` as covering U+00A0, which is the character a mail client is most
+ * likely to have substituted.
+ */
+export declare function normalizeAttachmentName(name: string): string;
+/**
+ * Index of the attachment matching `wanted`, or -1.
+ *
+ * Exact first, then whitespace-normalized and case-insensitive — in that order,
+ * so an email carrying two names differing only in case still resolves the one
+ * that was actually asked for.
+ */
+export declare function findAttachmentIndex(names: readonly string[], wanted: string): number;
+/**
+ * The "attachment not found" message, worded once for both platforms.
+ *
+ * Every field arrives already stringified, which is what lets the Windows script
+ * build the identical sentence: it passes PowerShell interpolations
+ * (`$($item.Subject)`) where macOS passes the values it read.
+ */
+export declare function attachmentNotFoundMessage(init: {
+    fileName: string;
+    senderEmail: string;
+    subject: string;
+    receivedTime: string;
+    /** The attachments the email does carry, already joined for display. */
+    present: string;
+    /** What this platform calls the id, for the closing advice. */
+    idLabel: string;
+}): string;

package/dist/shared/attachmentMatch.js

@@ -0,0 +1,50 @@
+"use strict";
+// Matching an attachment by name, and the error when nothing matches.
+//
+// Both are shared because the error is the useful half. Resolving an email by id
+// happily returns a DIFFERENT message when the id is stale or wrong — common
+// precisely when many replies share one subject — so a bare "not found" points
+// the caller at the wrong problem. Naming the email actually resolved, and the
+// attachments it does carry, is what makes the mistake visible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeAttachmentName = normalizeAttachmentName;
+exports.findAttachmentIndex = findAttachmentIndex;
+exports.attachmentNotFoundMessage = attachmentNotFoundMessage;
+/**
+ * Collapse whitespace runs (non-breaking spaces included) and trim, so a
+ * trivially reformatted filename still resolves. Both platforms' regex engines
+ * treat `\s` as covering U+00A0, which is the character a mail client is most
+ * likely to have substituted.
+ */
+function normalizeAttachmentName(name) {
+    return name.replace(/\s+/g, ' ').trim();
+}
+/**
+ * Index of the attachment matching `wanted`, or -1.
+ *
+ * Exact first, then whitespace-normalized and case-insensitive — in that order,
+ * so an email carrying two names differing only in case still resolves the one
+ * that was actually asked for.
+ */
+function findAttachmentIndex(names, wanted) {
+    const exact = names.indexOf(wanted);
+    if (exact !== -1)
+        return exact;
+    const normalized = normalizeAttachmentName(wanted).toLowerCase();
+    return names.findIndex(name => normalizeAttachmentName(name).toLowerCase() === normalized);
+}
+/**
+ * The "attachment not found" message, worded once for both platforms.
+ *
+ * Every field arrives already stringified, which is what lets the Windows script
+ * build the identical sentence: it passes PowerShell interpolations
+ * (`$($item.Subject)`) where macOS passes the values it read.
+ */
+function attachmentNotFoundMessage(init) {
+    return `Attachment '${init.fileName}' not found. `
+        + `Resolved email: from=${init.senderEmail}; subject=${init.subject}; received=${init.receivedTime}. `
+        + `Attachments present: ${init.present}. `
+        + `If this is not the email you expected, the ${init.idLabel} is likely wrong or stale - `
+        + `re-run readInboxEmails to get a current ${init.idLabel}.`;
+}
+//# sourceMappingURL=attachmentMatch.js.map

package/dist/shared/attachmentMatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachmentMatch.js","sourceRoot":"","sources":["../../src/shared/attachmentMatch.ts"],"names":[],"mappings":";AAAA,sEAAsE;AACtE,EAAE;AACF,iFAAiF;AACjF,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAC/E,gEAAgE;;AAQhE,0DAEC;AASD,kDAKC;AASD,8DAeC;AA9CD;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAC,IAAY;IAChD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CAAC,KAAwB,EAAE,MAAc;IACxE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/B,MAAM,UAAU,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IACjE,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,CAAC;AAC/F,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,yBAAyB,CAAC,IASzC;IACG,OAAO,eAAe,IAAI,CAAC,QAAQ,eAAe;UAC5C,wBAAwB,IAAI,CAAC,WAAW,aAAa,IAAI,CAAC,OAAO,cAAc,IAAI,CAAC,YAAY,IAAI;UACpG,wBAAwB,IAAI,CAAC,OAAO,IAAI;UACxC,8CAA8C,IAAI,CAAC,OAAO,8BAA8B;UACxF,2CAA2C,IAAI,CAAC,OAAO,GAAG,CAAC;AACrE,CAAC"}

package/dist/shared/bounceRules.d.ts

@@ -0,0 +1,33 @@
+/** Subject fragments that only a mail system writes. Matched case-insensitively. */
+export declare const BOUNCE_SUBJECT_PHRASES: readonly string[];
+/** Fragments of a sender ADDRESS that fingerprint a mail-delivery daemon. */
+export declare const BOUNCE_DAEMON_ADDRESSES: readonly string[];
+/** Fragments of a sender DISPLAY NAME that fingerprint a mail-delivery daemon. */
+export declare const BOUNCE_DAEMON_NAMES: readonly string[];
+/** MessageClass prefix Exchange stamps on a non-delivery report. */
+export declare const NDR_MESSAGE_CLASS_PREFIX = "REPORT.IPM.Note.NDR";
+/**
+ * Why this item is a bounce, or '' if it isn't.
+ *
+ * Order matches the Windows script's: the structural signal (an NDR message
+ * class) outranks the sender fingerprint, which outranks the subject phrase —
+ * so the reason a caller is shown is the strongest one that applied, not the
+ * first one that happened to be tested.
+ */
+export declare function bounceReason(item: {
+    subject?: string;
+    senderName?: string;
+    senderEmail?: string;
+    /** True when the item's MessageClass marks it a non-delivery report (Windows only). */
+    isNonDeliveryReport?: boolean;
+}): string;
+/** The address pattern both platforms scan a bounce body with. */
+export declare const BODY_ADDRESS_PATTERN = "[A-Za-z0-9._%+\\-]+@[A-Za-z0-9.\\-]+\\.[A-Za-z]{2,}";
+/**
+ * The addresses a bounce body names as having failed — best effort, since a
+ * bounce body is prose with no agreed structure.
+ *
+ * The account's own address and the daemon's are dropped: both appear in nearly
+ * every bounce, and neither is a send that failed.
+ */
+export declare function failedRecipients(body: string, accountAddress: string): string[];