@dawnlit/outlook-bridge 1.0.0

package/dist/errors.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Stable discriminants. These are the API; the messages beside them are not.
+ *
+ * - `UNSUPPORTED_PLATFORM` — no Outlook automation exists on this OS at all.
+ * - `NOT_IMPLEMENTED` — the platform could do this, but the port isn't written.
+ *   Distinct from UNSUPPORTED_PLATFORM on purpose: this one is a gap that may
+ *   close in a later release, so a caller may reasonably feature-detect and
+ *   degrade rather than refuse outright.
+ * - `ACCOUNT_NOT_FOUND` — no configured account matches that SMTP address.
+ * - `NOT_FOUND` — a named folder, template, signature or item didn't resolve.
+ * - `INVALID_REQUEST` — the arguments can't produce a call; nothing was attempted.
+ * - `SCRIPT_FAILED` — the interpreter ran and reported failure.
+ * - `TIMEOUT` — the run exceeded its budget and was killed.
+ * - `ABORTED` — the caller's AbortSignal fired.
+ */
+export type OutlookErrorCode = 'UNSUPPORTED_PLATFORM' | 'NOT_IMPLEMENTED' | 'ACCOUNT_NOT_FOUND' | 'NOT_FOUND' | 'INVALID_REQUEST' | 'SCRIPT_FAILED' | 'TIMEOUT' | 'ABORTED';
+/** Base class for every error this package raises deliberately. */
+export declare class OutlookError extends Error {
+    readonly code: OutlookErrorCode;
+    /** The underlying failure, when there was one. */
+    readonly cause?: unknown;
+    constructor(code: OutlookErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** This OS has no Outlook automation backend. */
+export declare class UnsupportedPlatformError extends OutlookError {
+    /** The platform that was asked, i.e. `process.platform` at the time. */
+    readonly platform: string;
+    constructor(platform: string, detail?: string);
+}
+/** The platform supports this, but the port isn't written yet. */
+export declare class NotImplementedError extends OutlookError {
+    /** The bridge function that isn't ported. */
+    readonly operation: string;
+    readonly platform: string;
+    constructor(operation: string, platform: string);
+}
+/** No configured Outlook account matches the requested address. */
+export declare class AccountNotFoundError extends OutlookError {
+    readonly account: string;
+    constructor(account: string);
+}
+/** A named folder, template, signature or item didn't resolve. */
+export declare class NotFoundError extends OutlookError {
+    /** What kind of thing was looked up — 'folder', 'template', 'signature', 'email'. */
+    readonly kind: string;
+    constructor(kind: string, message: string);
+}
+/** The arguments can't produce a call; nothing was attempted. */
+export declare class InvalidRequestError extends OutlookError {
+    constructor(message: string);
+}
+/**
+ * The interpreter ran and failed.
+ *
+ * Carries the generated script verbatim. That is the single most useful thing
+ * when one of these fires and it is otherwise unreachable — the `debug` hook
+ * only fires if the consumer wired one up ahead of time, whereas this arrives
+ * attached to the failure itself.
+ */
+export declare class ScriptError extends OutlookError {
+    readonly runner: 'powershell' | 'osascript';
+    readonly script: string;
+    readonly stderr: string;
+    readonly durationMs: number;
+    constructor(init: {
+        runner: 'powershell' | 'osascript';
+        script: string;
+        stderr: string;
+        durationMs: number;
+        cause?: unknown;
+    });
+}
+/** The run exceeded its budget and was killed. */
+export declare class TimeoutError extends OutlookError {
+    readonly runner: 'powershell' | 'osascript';
+    readonly timeoutMs: number;
+    readonly script: string;
+    constructor(init: {
+        runner: 'powershell' | 'osascript';
+        timeoutMs: number;
+        script: string;
+    });
+}
+/** The caller's AbortSignal fired. */
+export declare class AbortedError extends OutlookError {
+    readonly runner: 'powershell' | 'osascript';
+    constructor(runner: 'powershell' | 'osascript', reason?: unknown);
+}
+/**
+ * Upgrade a raw interpreter failure to the most specific error we can prove.
+ *
+ * Order matters. Abort and timeout both kill the child with SIGTERM, so they are
+ * indistinguishable from the exit status alone — the signal's own state is what
+ * separates them, and it is checked first. Only then is stderr worth reading:
+ * a killed process may have printed a partial, misleading message before dying.
+ */
+export declare function classifyRunFailure(init: {
+    runner: 'powershell' | 'osascript';
+    script: string;
+    stderr: string;
+    durationMs: number;
+    /** The error `execFile` handed back, when the failure came from the child. */
+    nodeError?: (Error & {
+        killed?: boolean;
+        code?: string | number | null;
+    }) | null;
+    /** The budget in force, for the TIMEOUT message. */
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}): OutlookError;

package/dist/errors.js

@@ -0,0 +1,140 @@
+"use strict";
+// The package's error taxonomy.
+//
+// Every failure used to be a bare `new Error(string)`, which left a consumer
+// only one way to tell "this machine can't do that" from "that account doesn't
+// exist" from "the script blew up": matching on the message text. Message text
+// is not an API — rewording one sentence here would silently break a caller's
+// branch — so the distinctions a caller actually acts on carry a stable `code`.
+//
+// Every error this package throws on purpose is an `OutlookError`. A caller that
+// wants one branch for "expected failure" and another for "bug" can switch on
+// `err instanceof OutlookError` alone.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbortedError = exports.TimeoutError = exports.ScriptError = exports.InvalidRequestError = exports.NotFoundError = exports.AccountNotFoundError = exports.NotImplementedError = exports.UnsupportedPlatformError = exports.OutlookError = void 0;
+exports.classifyRunFailure = classifyRunFailure;
+/** Base class for every error this package raises deliberately. */
+class OutlookError extends Error {
+    constructor(code, message, options) {
+        // Declared as a field rather than passed to `super`: the ES2022 `cause`
+        // constructor option isn't in this package's ES2020 target.
+        super(message);
+        if (options && 'cause' in options)
+            this.cause = options.cause;
+        this.code = code;
+        // `name` is what shows up in an unhandled-rejection dump, so make it the
+        // subclass rather than a uniform "Error".
+        this.name = new.target.name;
+        // Restores the prototype chain when the package is consumed as compiled
+        // ES2020 output — without it `instanceof` fails for a subclass.
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.OutlookError = OutlookError;
+/** This OS has no Outlook automation backend. */
+class UnsupportedPlatformError extends OutlookError {
+    constructor(platform, detail = 'Outlook automation is only supported on Windows and macOS.') {
+        super('UNSUPPORTED_PLATFORM', `${detail} (running on '${platform}')`);
+        this.platform = platform;
+    }
+}
+exports.UnsupportedPlatformError = UnsupportedPlatformError;
+/** The platform supports this, but the port isn't written yet. */
+class NotImplementedError extends OutlookError {
+    constructor(operation, platform) {
+        super('NOT_IMPLEMENTED', `'${operation}' is not implemented for Outlook on ${platform} yet.`);
+        this.operation = operation;
+        this.platform = platform;
+    }
+}
+exports.NotImplementedError = NotImplementedError;
+/** No configured Outlook account matches the requested address. */
+class AccountNotFoundError extends OutlookError {
+    constructor(account) {
+        super('ACCOUNT_NOT_FOUND', `Outlook account '${account}' not found.`);
+        this.account = account;
+    }
+}
+exports.AccountNotFoundError = AccountNotFoundError;
+/** A named folder, template, signature or item didn't resolve. */
+class NotFoundError extends OutlookError {
+    constructor(kind, message) {
+        super('NOT_FOUND', message);
+        this.kind = kind;
+    }
+}
+exports.NotFoundError = NotFoundError;
+/** The arguments can't produce a call; nothing was attempted. */
+class InvalidRequestError extends OutlookError {
+    constructor(message) {
+        super('INVALID_REQUEST', message);
+    }
+}
+exports.InvalidRequestError = InvalidRequestError;
+/**
+ * The interpreter ran and failed.
+ *
+ * Carries the generated script verbatim. That is the single most useful thing
+ * when one of these fires and it is otherwise unreachable — the `debug` hook
+ * only fires if the consumer wired one up ahead of time, whereas this arrives
+ * attached to the failure itself.
+ */
+class ScriptError extends OutlookError {
+    constructor(init) {
+        super('SCRIPT_FAILED', init.stderr || `${init.runner} failed with no output.`, { cause: init.cause });
+        this.runner = init.runner;
+        this.script = init.script;
+        this.stderr = init.stderr;
+        this.durationMs = init.durationMs;
+    }
+}
+exports.ScriptError = ScriptError;
+/** The run exceeded its budget and was killed. */
+class TimeoutError extends OutlookError {
+    constructor(init) {
+        super('TIMEOUT', `${init.runner} run exceeded its ${init.timeoutMs}ms budget and was killed.`);
+        this.runner = init.runner;
+        this.timeoutMs = init.timeoutMs;
+        this.script = init.script;
+    }
+}
+exports.TimeoutError = TimeoutError;
+/** The caller's AbortSignal fired. */
+class AbortedError extends OutlookError {
+    constructor(runner, reason) {
+        super('ABORTED', `${runner} run was aborted by the caller.`, { cause: reason });
+        this.runner = runner;
+    }
+}
+exports.AbortedError = AbortedError;
+/**
+ * Both platform scripts signal a bad sending account by `throw`ing a string the
+ * interpreter then prints. Recognising it here is what turns the most common
+ * operational mistake — a typo'd or freshly-removed account — into a code a
+ * caller can branch on, instead of a SCRIPT_FAILED they'd have to grep.
+ *
+ * Deliberately narrow: it only matches the sentence our own scripts emit.
+ */
+const ACCOUNT_NOT_FOUND_RE = /Account '([^']*)' not found/i;
+/**
+ * Upgrade a raw interpreter failure to the most specific error we can prove.
+ *
+ * Order matters. Abort and timeout both kill the child with SIGTERM, so they are
+ * indistinguishable from the exit status alone — the signal's own state is what
+ * separates them, and it is checked first. Only then is stderr worth reading:
+ * a killed process may have printed a partial, misleading message before dying.
+ */
+function classifyRunFailure(init) {
+    const { runner, script, stderr, durationMs, nodeError, timeoutMs, signal } = init;
+    if (signal?.aborted || nodeError?.name === 'AbortError' || nodeError?.code === 'ABORT_ERR') {
+        return new AbortedError(runner, signal?.reason);
+    }
+    if (nodeError?.killed && timeoutMs) {
+        return new TimeoutError({ runner, timeoutMs, script });
+    }
+    const match = ACCOUNT_NOT_FOUND_RE.exec(stderr);
+    if (match)
+        return new AccountNotFoundError(match[1]);
+    return new ScriptError({ runner, script, stderr, durationMs, cause: nodeError ?? undefined });
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { getOutlookAccounts, sendOutlookEmail, replyOutlookEmail, sendAllDrafts, readInboxEmails, searchInboxByFilter, readSelectedEmail, readEmailBody, openOutlookEmail, listInboxFolders, moveOutlookEmails, listOutlookDrafts, deleteOutlookDrafts, deleteOutlookEmails, purgeDeletedItems, saveEmailAttachment, saveEmailAttachmentDetailed, saveEmailAttachments, cleanUndeliverableEmails, collectBouncedRecipients, readSentRecipientGroups, listOutlookSignatures, readOutlookSignatureHtml, readTemplateEmails, saveTemplateEmail, editEmailTemplate, } from './OutlookService';
+export { createOutlookBridge, capabilities, supports } from './OutlookService';
+export type { OutlookBridgeInstance } from './OutlookService';
+export { configure, getConfig } from './runtime';
+export type { BridgeOptions, BridgeDebugEvent, ResolvedConfig } from './runtime';
+export { OutlookError, UnsupportedPlatformError, NotImplementedError, AccountNotFoundError, NotFoundError, InvalidRequestError, ScriptError, TimeoutError, AbortedError, } from './errors';
+export type { OutlookErrorCode } from './errors';
+export { mailFolderRef, splitQuotedOriginal, WELL_KNOWN_FOLDERS } from './mail';
+export type { OutlookBridge, BridgeCapability, CapabilityMap, SendEmailParams, ReplyEmailParams, ReplyEmailResult, DraftSendFailure, SendAllDraftsResult, OutlookDraft, ListDraftsResult, DeleteDraftsResult, DeleteMailOptions, DeleteMailOutcome, DeleteMailResult, PurgeDeletedItemsResult, UndeliverableEmail, CleanUndeliverableResult, SentRecipientGroup, InboxEmail, InboxSearchFilter, InboxSearchMatch, SelectedEmail, EmailBodyResult, MailFolderRef, InboxFolderInfo, MoveEmailsResult, SavedAttachment, TemplateEmail, TemplateFolderResult, SaveTemplateResult, } from './types';
+export { findTemplateMarkers, replaceToken, removeTokenLine, findTokens, findUnfilledTokens, composeTemplateBody, } from './outlookTemplateSections';
+export type { TemplateMarkers, ComposeOptions } from './outlookTemplateSections';

package/dist/index.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composeTemplateBody = exports.findUnfilledTokens = exports.findTokens = exports.removeTokenLine = exports.replaceToken = exports.findTemplateMarkers = exports.WELL_KNOWN_FOLDERS = exports.splitQuotedOriginal = exports.mailFolderRef = exports.AbortedError = exports.TimeoutError = exports.ScriptError = exports.InvalidRequestError = exports.NotFoundError = exports.AccountNotFoundError = exports.NotImplementedError = exports.UnsupportedPlatformError = exports.OutlookError = exports.getConfig = exports.configure = exports.supports = exports.capabilities = exports.createOutlookBridge = exports.editEmailTemplate = exports.saveTemplateEmail = exports.readTemplateEmails = exports.readOutlookSignatureHtml = exports.listOutlookSignatures = exports.readSentRecipientGroups = exports.collectBouncedRecipients = exports.cleanUndeliverableEmails = exports.saveEmailAttachments = exports.saveEmailAttachmentDetailed = exports.saveEmailAttachment = exports.purgeDeletedItems = exports.deleteOutlookEmails = exports.deleteOutlookDrafts = exports.listOutlookDrafts = exports.moveOutlookEmails = exports.listInboxFolders = exports.openOutlookEmail = exports.readEmailBody = exports.readSelectedEmail = exports.searchInboxByFilter = exports.readInboxEmails = exports.sendAllDrafts = exports.replyOutlookEmail = exports.sendOutlookEmail = exports.getOutlookAccounts = void 0;
+// Public API surface. Deliberately explicit (rather than `export *`) so the
+// package only ever exposes what it means to support; `package.json`'s `exports`
+// map closes the deep-import path that would otherwise reach around this.
+var OutlookService_1 = require("./OutlookService");
+Object.defineProperty(exports, "getOutlookAccounts", { enumerable: true, get: function () { return OutlookService_1.getOutlookAccounts; } });
+Object.defineProperty(exports, "sendOutlookEmail", { enumerable: true, get: function () { return OutlookService_1.sendOutlookEmail; } });
+Object.defineProperty(exports, "replyOutlookEmail", { enumerable: true, get: function () { return OutlookService_1.replyOutlookEmail; } });
+Object.defineProperty(exports, "sendAllDrafts", { enumerable: true, get: function () { return OutlookService_1.sendAllDrafts; } });
+Object.defineProperty(exports, "readInboxEmails", { enumerable: true, get: function () { return OutlookService_1.readInboxEmails; } });
+Object.defineProperty(exports, "searchInboxByFilter", { enumerable: true, get: function () { return OutlookService_1.searchInboxByFilter; } });
+Object.defineProperty(exports, "readSelectedEmail", { enumerable: true, get: function () { return OutlookService_1.readSelectedEmail; } });
+Object.defineProperty(exports, "readEmailBody", { enumerable: true, get: function () { return OutlookService_1.readEmailBody; } });
+Object.defineProperty(exports, "openOutlookEmail", { enumerable: true, get: function () { return OutlookService_1.openOutlookEmail; } });
+Object.defineProperty(exports, "listInboxFolders", { enumerable: true, get: function () { return OutlookService_1.listInboxFolders; } });
+Object.defineProperty(exports, "moveOutlookEmails", { enumerable: true, get: function () { return OutlookService_1.moveOutlookEmails; } });
+Object.defineProperty(exports, "listOutlookDrafts", { enumerable: true, get: function () { return OutlookService_1.listOutlookDrafts; } });
+Object.defineProperty(exports, "deleteOutlookDrafts", { enumerable: true, get: function () { return OutlookService_1.deleteOutlookDrafts; } });
+Object.defineProperty(exports, "deleteOutlookEmails", { enumerable: true, get: function () { return OutlookService_1.deleteOutlookEmails; } });
+Object.defineProperty(exports, "purgeDeletedItems", { enumerable: true, get: function () { return OutlookService_1.purgeDeletedItems; } });
+Object.defineProperty(exports, "saveEmailAttachment", { enumerable: true, get: function () { return OutlookService_1.saveEmailAttachment; } });
+Object.defineProperty(exports, "saveEmailAttachmentDetailed", { enumerable: true, get: function () { return OutlookService_1.saveEmailAttachmentDetailed; } });
+Object.defineProperty(exports, "saveEmailAttachments", { enumerable: true, get: function () { return OutlookService_1.saveEmailAttachments; } });
+Object.defineProperty(exports, "cleanUndeliverableEmails", { enumerable: true, get: function () { return OutlookService_1.cleanUndeliverableEmails; } });
+Object.defineProperty(exports, "collectBouncedRecipients", { enumerable: true, get: function () { return OutlookService_1.collectBouncedRecipients; } });
+Object.defineProperty(exports, "readSentRecipientGroups", { enumerable: true, get: function () { return OutlookService_1.readSentRecipientGroups; } });
+Object.defineProperty(exports, "listOutlookSignatures", { enumerable: true, get: function () { return OutlookService_1.listOutlookSignatures; } });
+Object.defineProperty(exports, "readOutlookSignatureHtml", { enumerable: true, get: function () { return OutlookService_1.readOutlookSignatureHtml; } });
+Object.defineProperty(exports, "readTemplateEmails", { enumerable: true, get: function () { return OutlookService_1.readTemplateEmails; } });
+Object.defineProperty(exports, "saveTemplateEmail", { enumerable: true, get: function () { return OutlookService_1.saveTemplateEmail; } });
+Object.defineProperty(exports, "editEmailTemplate", { enumerable: true, get: function () { return OutlookService_1.editEmailTemplate; } });
+// A bridge with its own settings, isolated from every other caller in the
+// process — and capability discovery, so a consumer can ask what works here
+// instead of finding out by calling.
+var OutlookService_2 = require("./OutlookService");
+Object.defineProperty(exports, "createOutlookBridge", { enumerable: true, get: function () { return OutlookService_2.createOutlookBridge; } });
+Object.defineProperty(exports, "capabilities", { enumerable: true, get: function () { return OutlookService_2.capabilities; } });
+Object.defineProperty(exports, "supports", { enumerable: true, get: function () { return OutlookService_2.supports; } });
+// Process-wide settings: run timeouts, the stdout cap, cancellation, where
+// scratch files and saved attachments go, and a hook that hands you every
+// generated script. Prefer createOutlookBridge in shared processes.
+var runtime_1 = require("./runtime");
+Object.defineProperty(exports, "configure", { enumerable: true, get: function () { return runtime_1.configure; } });
+Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return runtime_1.getConfig; } });
+// Failures carry a stable `code`; the messages beside them are not an API.
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "OutlookError", { enumerable: true, get: function () { return errors_1.OutlookError; } });
+Object.defineProperty(exports, "UnsupportedPlatformError", { enumerable: true, get: function () { return errors_1.UnsupportedPlatformError; } });
+Object.defineProperty(exports, "NotImplementedError", { enumerable: true, get: function () { return errors_1.NotImplementedError; } });
+Object.defineProperty(exports, "AccountNotFoundError", { enumerable: true, get: function () { return errors_1.AccountNotFoundError; } });
+Object.defineProperty(exports, "NotFoundError", { enumerable: true, get: function () { return errors_1.NotFoundError; } });
+Object.defineProperty(exports, "InvalidRequestError", { enumerable: true, get: function () { return errors_1.InvalidRequestError; } });
+Object.defineProperty(exports, "ScriptError", { enumerable: true, get: function () { return errors_1.ScriptError; } });
+Object.defineProperty(exports, "TimeoutError", { enumerable: true, get: function () { return errors_1.TimeoutError; } });
+Object.defineProperty(exports, "AbortedError", { enumerable: true, get: function () { return errors_1.AbortedError; } });
+// Platform-neutral helpers, usable without an Outlook session — and the two
+// pieces of parsing a caller most often needs to reproduce.
+var mail_1 = require("./mail");
+Object.defineProperty(exports, "mailFolderRef", { enumerable: true, get: function () { return mail_1.mailFolderRef; } });
+Object.defineProperty(exports, "splitQuotedOriginal", { enumerable: true, get: function () { return mail_1.splitQuotedOriginal; } });
+Object.defineProperty(exports, "WELL_KNOWN_FOLDERS", { enumerable: true, get: function () { return mail_1.WELL_KNOWN_FOLDERS; } });
+var outlookTemplateSections_1 = require("./outlookTemplateSections");
+Object.defineProperty(exports, "findTemplateMarkers", { enumerable: true, get: function () { return outlookTemplateSections_1.findTemplateMarkers; } });
+Object.defineProperty(exports, "replaceToken", { enumerable: true, get: function () { return outlookTemplateSections_1.replaceToken; } });
+Object.defineProperty(exports, "removeTokenLine", { enumerable: true, get: function () { return outlookTemplateSections_1.removeTokenLine; } });
+Object.defineProperty(exports, "findTokens", { enumerable: true, get: function () { return outlookTemplateSections_1.findTokens; } });
+Object.defineProperty(exports, "findUnfilledTokens", { enumerable: true, get: function () { return outlookTemplateSections_1.findUnfilledTokens; } });
+Object.defineProperty(exports, "composeTemplateBody", { enumerable: true, get: function () { return outlookTemplateSections_1.composeTemplateBody; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,4EAA4E;AAC5E,iFAAiF;AACjF,0EAA0E;AAC1E,mDA2B0B;AA1BtB,oHAAA,kBAAkB,OAAA;AAClB,kHAAA,gBAAgB,OAAA;AAChB,mHAAA,iBAAiB,OAAA;AACjB,+GAAA,aAAa,OAAA;AACb,iHAAA,eAAe,OAAA;AACf,qHAAA,mBAAmB,OAAA;AACnB,mHAAA,iBAAiB,OAAA;AACjB,+GAAA,aAAa,OAAA;AACb,kHAAA,gBAAgB,OAAA;AAChB,kHAAA,gBAAgB,OAAA;AAChB,mHAAA,iBAAiB,OAAA;AACjB,mHAAA,iBAAiB,OAAA;AACjB,qHAAA,mBAAmB,OAAA;AACnB,qHAAA,mBAAmB,OAAA;AACnB,mHAAA,iBAAiB,OAAA;AACjB,qHAAA,mBAAmB,OAAA;AACnB,6HAAA,2BAA2B,OAAA;AAC3B,sHAAA,oBAAoB,OAAA;AACpB,0HAAA,wBAAwB,OAAA;AACxB,0HAAA,wBAAwB,OAAA;AACxB,yHAAA,uBAAuB,OAAA;AACvB,uHAAA,qBAAqB,OAAA;AACrB,0HAAA,wBAAwB,OAAA;AACxB,oHAAA,kBAAkB,OAAA;AAClB,mHAAA,iBAAiB,OAAA;AACjB,mHAAA,iBAAiB,OAAA;AAGrB,0EAA0E;AAC1E,4EAA4E;AAC5E,qCAAqC;AACrC,mDAA+E;AAAtE,qHAAA,mBAAmB,OAAA;AAAE,8GAAA,YAAY,OAAA;AAAE,0GAAA,QAAQ,OAAA;AAGpD,2EAA2E;AAC3E,0EAA0E;AAC1E,oEAAoE;AACpE,qCAAiD;AAAxC,oGAAA,SAAS,OAAA;AAAE,oGAAA,SAAS,OAAA;AAG7B,2EAA2E;AAC3E,mCAUkB;AATd,sGAAA,YAAY,OAAA;AACZ,kHAAA,wBAAwB,OAAA;AACxB,6GAAA,mBAAmB,OAAA;AACnB,8GAAA,oBAAoB,OAAA;AACpB,uGAAA,aAAa,OAAA;AACb,6GAAA,mBAAmB,OAAA;AACnB,qGAAA,WAAW,OAAA;AACX,sGAAA,YAAY,OAAA;AACZ,sGAAA,YAAY,OAAA;AAIhB,4EAA4E;AAC5E,4DAA4D;AAC5D,+BAAgF;AAAvE,qGAAA,aAAa,OAAA;AAAE,2GAAA,mBAAmB,OAAA;AAAE,0GAAA,kBAAkB,OAAA;AAmC/D,qEAOmC;AAN/B,8HAAA,mBAAmB,OAAA;AACnB,uHAAA,YAAY,OAAA;AACZ,0HAAA,eAAe,OAAA;AACf,qHAAA,UAAU,OAAA;AACV,6HAAA,kBAAkB,OAAA;AAClB,8HAAA,mBAAmB,OAAA"}

package/dist/mac/accounts.d.ts

@@ -0,0 +1,5 @@
+/**
+ * SMTP addresses of Outlook accounts. Empty under New Outlook (not exposed).
+ * Used by the UI's account picker.
+ */
+export declare function getOutlookAccounts(): Promise<string[]>;

package/dist/mac/accounts.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOutlookAccounts = getOutlookAccounts;
+const run_1 = require("./run");
+const scripts_1 = require("./scripts");
+/**
+ * SMTP addresses of Outlook accounts. Empty under New Outlook (not exposed).
+ * Used by the UI's account picker.
+ */
+async function getOutlookAccounts() {
+    const script = `${scripts_1.LIST_ACCOUNTS_SNIPPET}
+set AppleScript's text item delimiters to linefeed
+return acctList as string`;
+    const raw = await (0, run_1.runOsaScript)(script, 15000);
+    return raw.split('\n').map(s => s.trim()).filter(Boolean);
+}
+//# sourceMappingURL=accounts.js.map

package/dist/mac/accounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.js","sourceRoot":"","sources":["../../src/mac/accounts.ts"],"names":[],"mappings":";;AAOA,gDAMC;AAbD,+BAAqC;AACrC,uCAAkD;AAElD;;;GAGG;AACI,KAAK,UAAU,kBAAkB;IACpC,MAAM,MAAM,GAAG,GAAG,+BAAqB;;0BAEjB,CAAC;IACvB,MAAM,GAAG,GAAG,MAAM,IAAA,kBAAY,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC9C,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC9D,CAAC"}

package/dist/mac/attachments.d.ts

@@ -0,0 +1,28 @@
+import type { SavedAttachment } from '../types';
+/**
+ * Save an email attachment by message id 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 — a message
+ * id can go stale, and a bare "not found" would point at the wrong problem.
+ */
+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 pair of runs — what a
+ * caller working through searchInboxByFilter/readSelectedEmail results wants,
+ * rather than paying an osascript 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`.
+ *
+ * `storeId` is accepted for signature parity and ignored: macOS has no StoreID.
+ */
+export declare function saveEmailAttachments(entryId: string, fileNames: string[], _storeId?: string, destDir?: string): Promise<SavedAttachment[]>;

package/dist/mac/attachments.js

@@ -0,0 +1,120 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+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.
+//
+// Two runs rather than one: the first reads the email's identity and attachment
+// names, the matching happens in TypeScript against shared/attachmentMatch, and
+// only then does the second run save what matched. That keeps one definition of
+// "does this filename match" and one wording for the error, shared with Windows.
+const run_1 = require("./run");
+const scripts_1 = require("./scripts");
+const attachmentMatch_1 = require("../shared/attachmentMatch");
+const runtime_1 = require("../runtime");
+const errors_1 = require("../errors");
+const path_1 = __importDefault(require("path"));
+/** Read the email's identity and the names of the attachments it carries. */
+async function resolveEmail(id) {
+    const script = `tell application "Microsoft Outlook"
+${(0, scripts_1.messageLookupSnippet)(id)}
+${(0, scripts_1.messageDetailSnippet)()}
+    return ${(0, run_1.asRow)((0, scripts_1.messageDetailFields)())}
+end tell`;
+    const parts = (0, run_1.summaryFields)(await (0, run_1.runOsaScript)(script, 30000));
+    return {
+        subject: (0, run_1.field)(parts, scripts_1.MessageDetail.subject),
+        senderName: (0, run_1.field)(parts, scripts_1.MessageDetail.senderName),
+        senderEmail: (0, run_1.field)(parts, scripts_1.MessageDetail.senderEmail),
+        receivedTime: (0, run_1.field)(parts, scripts_1.MessageDetail.receivedTime),
+        attachmentNames: (0, run_1.splitList)((0, run_1.field)(parts, scripts_1.MessageDetail.attachmentNames)),
+    };
+}
+/**
+ * Match one requested filename to an attachment index, or throw the shared
+ * "not found" error naming the email that actually resolved.
+ */
+function requireAttachmentIndex(email, fileName) {
+    const index = (0, attachmentMatch_1.findAttachmentIndex)(email.attachmentNames, fileName);
+    if (index === -1) {
+        throw new errors_1.NotFoundError('attachment', (0, attachmentMatch_1.attachmentNotFoundMessage)({
+            fileName,
+            senderEmail: email.senderEmail,
+            subject: email.subject,
+            receivedTime: email.receivedTime,
+            present: email.attachmentNames.join(', ') || '(none)',
+            idLabel: 'message id',
+        }));
+    }
+    return index;
+}
+/** Save the attachments at the given 1-based indices to `outDir`. */
+async function saveByIndex(id, picks, outDir) {
+    const saveLines = picks.map(pick => `    save (item ${pick.index + 1} of attachments of theMsg) in POSIX file "${(0, run_1.asEscape)(path_1.default.join(outDir, pick.name))}"`);
+    const script = `
+tell application "Microsoft Outlook"
+${(0, scripts_1.messageLookupSnippet)(id)}
+${saveLines.join('\n')}
+end tell`;
+    await (0, run_1.runOsaScript)(script, 120000);
+}
+/**
+ * Save an email attachment by message id 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 — a message
+ * id can go stale, and a bare "not found" would point at the wrong problem.
+ */
+async function saveEmailAttachmentDetailed(entryId, fileName, _storeId, destDir) {
+    const results = await saveEmailAttachments(entryId, [fileName], _storeId, destDir);
+    if (results.length === 0) {
+        throw new errors_1.NotFoundError('attachment', 'Failed to save attachment.');
+    }
+    return results[0];
+}
+/** 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;
+}
+/**
+ * Save several attachments from one email in a single pair of runs — what a
+ * caller working through searchInboxByFilter/readSelectedEmail results wants,
+ * rather than paying an osascript 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`.
+ *
+ * `storeId` is accepted for signature parity and ignored: macOS has no StoreID.
+ */
+async function saveEmailAttachments(entryId, fileNames, _storeId, destDir) {
+    if (fileNames.length === 0)
+        return [];
+    const id = (0, scripts_1.macMessageId)(entryId);
+    const email = await resolveEmail(id);
+    // Resolve every name BEFORE saving anything, so a batch with one bad name
+    // fails without having written half its files.
+    const picks = fileNames.map(fileName => {
+        const index = requireAttachmentIndex(email, fileName);
+        return { index, name: email.attachmentNames[index] };
+    });
+    const outDir = (0, runtime_1.resolveDestDir)(destDir);
+    await saveByIndex(id, picks, outDir);
+    return picks.map(pick => ({
+        path: path_1.default.join(outDir, pick.name),
+        subject: email.subject,
+        senderName: email.senderName,
+        senderEmail: email.senderEmail,
+        receivedTime: email.receivedTime,
+    }));
+}
+//# sourceMappingURL=attachments.js.map

package/dist/mac/attachments.js.map

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

package/dist/mac/bounces.d.ts

@@ -0,0 +1,32 @@
+import type { CleanUndeliverableResult, SentRecipientGroup } from '../types';
+/**
+ * Scan an account's inbox for bounce-back / non-delivery messages — mail-daemon
+ * and postmaster rejections, and "Message blocked"-style failure notices — and,
+ * unless previewing, 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 sender
+ * fingerprints as a mail-delivery daemon/postmaster or its subject contains a
+ * specific bounce phrase. macOS has no MessageClass, so the NDR-report signal
+ * Windows can also use is unavailable here — an Exchange NDR still matches on
+ * its "Undeliverable:" subject, which is what it carries.
+ */
+export declare function cleanUndeliverableEmails(emailAccount: string, daysBack?: number, dryRun?: boolean): 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.
+ */
+export declare function collectBouncedRecipients(emailAccount: string, daysBack?: number, scanDeleted?: boolean): 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.
+ */
+export declare function readSentRecipientGroups(emailAccount: string, daysBack?: number, limit?: number): Promise<SentRecipientGroup[]>;