@dawnlit/outlook-bridge 1.0.0

package/dist/mac/run.js

@@ -0,0 +1,250 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AS_HANDLERS = exports.AS_LIST_SEP = exports.AS_RECORD_SEP = exports.AS_FIELD_SEP = exports.LIST_SEP = exports.RECORD_SEP = exports.FIELD_SEP = void 0;
+exports.runOsaScript = runOsaScript;
+exports.asEscape = asEscape;
+exports.asBool = asBool;
+exports.asRow = asRow;
+exports.splitRecords = splitRecords;
+exports.splitFields = splitFields;
+exports.splitList = splitList;
+exports.field = field;
+exports.summaryFields = summaryFields;
+exports.intField = intField;
+exports.boolField = boolField;
+// Getting a generated AppleScript to osascript and its output back.
+//
+// The macOS counterpart of windows/run.ts: the run itself, the escaping rules,
+// and the record framing every reader here shares.
+const child_process_1 = require("child_process");
+const fs_1 = __importDefault(require("fs"));
+const runtime_1 = require("../runtime");
+const errors_1 = require("../errors");
+const replyBody_1 = require("../shared/replyBody");
+const RUNNER = 'osascript';
+/**
+ * Run an AppleScript via a temp file (avoids arg-length and quoting limits).
+ *
+ * `AS_HANDLERS` is prepended here rather than by each caller — the Windows runner
+ * already owns its UTF-8 prelude the same way. It matters more on this side: a
+ * script missing a handler fails at COMPILE time for the WHOLE script, with a
+ * message pointing nowhere near the omission, so "remember to paste the handlers"
+ * was a footgun every new script had to survive.
+ *
+ * `timeout` overrides the configured default for this one call; see `configure()`
+ * for that and for the stdout cap.
+ */
+function runOsaScript(source, timeout) {
+    // The full text is what osascript compiled, so it is also what the error's
+    // line numbers refer to and what the debug hook and ScriptError must carry.
+    const script = exports.AS_HANDLERS + source;
+    const scriptFile = (0, runtime_1.tempFile)('osa', 'applescript');
+    fs_1.default.writeFileSync(scriptFile, script, 'utf-8');
+    const { timeoutMs, maxBufferBytes, signal } = (0, runtime_1.getConfig)();
+    const effectiveTimeout = timeout ?? timeoutMs;
+    const startedAt = Date.now();
+    return new Promise((resolve, reject) => {
+        (0, child_process_1.execFile)('osascript', [scriptFile], { maxBuffer: maxBufferBytes, timeout: effectiveTimeout, signal }, (error, stdout, stderr) => {
+            const durationMs = Date.now() - startedAt;
+            try {
+                fs_1.default.unlinkSync(scriptFile);
+            }
+            catch { /* ignore */
+            }
+            if (error) {
+                // Running from a file, osascript prefixes the script path:
+                // "/tmp/outlook-bridge-osa-1.applescript:12:34: execution error:
+                // Microsoft Outlook got an error: … (-1728)". Keep just the human
+                // part — these strings reach the user in per-email failure lists.
+                const msg = (stderr || error.message)
+                    .replace(/^(?:.*?:)?\d+:\d+:\s*execution error:\s*/m, '')
+                    .trim();
+                const failure = (0, errors_1.classifyRunFailure)({
+                    runner: RUNNER,
+                    script,
+                    stderr: msg,
+                    durationMs,
+                    nodeError: error,
+                    timeoutMs: effectiveTimeout,
+                    signal,
+                });
+                (0, runtime_1.reportRun)({ runner: RUNNER, script, durationMs, error: failure.message });
+                reject(failure);
+            }
+            else {
+                (0, runtime_1.reportRun)({ runner: RUNNER, script, durationMs });
+                resolve(stdout.replace(/\n$/, ''));
+            }
+        });
+    });
+}
+/** Escape a string for embedding inside an AppleScript double-quoted literal. */
+function asEscape(s) {
+    return s
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\r\n|\r|\n/g, '\\n');
+}
+/** AppleScript's boolean literals. */
+function asBool(value) {
+    return value ? 'true' : 'false';
+}
+// Control characters as separators: subjects and bodies contain tabs, newlines
+// and commas, but never these. Every emitted field also passes through the
+// `sanitize` handler below, which is what makes the framing safe rather than
+// merely unlikely to break.
+exports.FIELD_SEP = '\u001f';
+exports.RECORD_SEP = '\u001e';
+exports.LIST_SEP = '\u001d';
+/** The same three, as AppleScript expressions. */
+exports.AS_FIELD_SEP = '(character id 31)';
+exports.AS_RECORD_SEP = '(character id 30)';
+exports.AS_LIST_SEP = '(character id 29)';
+/**
+ * Emit one record: the AppleScript expressions in `fields`, separated and
+ * terminated so `splitRecords`/`splitFields` can take them apart again.
+ *
+ * Every field goes through `sanitize`, which is what makes the framing safe
+ * rather than merely unlikely to break. A field holding a LIST must be built
+ * with `my sanitizeList(...)`, which cleans the elements instead — `sanitize`
+ * deliberately leaves the list separator alone.
+ */
+function asRow(fields) {
+    return fields
+        .map(f => `my sanitize(${f})`)
+        .join(` & ${exports.AS_FIELD_SEP} & `) + ` & ${exports.AS_RECORD_SEP}`;
+}
+/**
+ * The AppleScript handlers every script here relies on. Called with `my` from
+ * inside a `tell` block.
+ *
+ * `isoDate` produces the zero-padded 'yyyy-MM-dd HH:mm' both platforms' readers
+ * return; `sanitize` strips the framing characters; `joinList` and `replaceText`
+ * are the text-item-delimiter dance nobody should write twice.
+ */
+exports.AS_HANDLERS = `
+on pad2(n)
+    set s to (n as integer) as string
+    if (length of s) < 2 then set s to "0" & s
+    return s
+end pad2
+
+on isoDate(d)
+    if d is missing value then return ""
+    return (year of d as string) & "-" & pad2(month of d as integer) & "-" & pad2(day of d) & " " & pad2(hours of d) & ":" & pad2(minutes of d)
+end isoDate
+
+on joinList(lst, sep)
+    set saved to AppleScript's text item delimiters
+    set AppleScript's text item delimiters to sep
+    set out to lst as string
+    set AppleScript's text item delimiters to saved
+    return out
+end joinList
+
+on replaceText(t, findWhat, replaceWith)
+    set saved to AppleScript's text item delimiters
+    set AppleScript's text item delimiters to findWhat
+    set parts to text items of t
+    set AppleScript's text item delimiters to replaceWith
+    set out to parts as string
+    set AppleScript's text item delimiters to saved
+    return out
+end replaceText
+
+-- Strips the FIELD and RECORD separators only. The LIST separator is left
+-- alone on purpose: a field may legitimately BE a list, and stripping 29 here
+-- collapsed every such field into one run-on string.
+on sanitize(v)
+    if v is missing value then return ""
+    set t to v as string
+    repeat with codePoint in {30, 31}
+        set marker to (character id (codePoint as integer))
+        if t contains marker then set t to my replaceText(t, marker, " ")
+    end repeat
+    return t
+end sanitize
+
+-- A list field: each element loses all three separators, then they are joined
+-- with the LIST separator that splitList() takes them apart on.
+on sanitizeList(lst)
+    set cleaned to {}
+    repeat with item_ in lst
+        set t to my sanitize(item_)
+        repeat with codePoint in {29}
+            set marker to (character id (codePoint as integer))
+            if t contains marker then set t to my replaceText(t, marker, " ")
+        end repeat
+        set end of cleaned to t
+    end repeat
+    return my joinList(cleaned, (character id 29))
+end sanitizeList
+
+on insertAboveQuoted(c, ins)
+    if c is missing value then return ins
+    set c to c as string
+    if (length of c) is 0 then return ins
+    -- Outlook builds a reply as a document whose own empty paragraph sits inside
+    -- WordSection1; inserting straight after that tag puts the new text where the
+    -- user's cursor would have been. Anything else falls back to just inside <body>.
+    -- 'at' is a reserved AppleScript parameter name, so the cut point cannot be
+    -- called that however naturally it reads.
+    set cutPoint to my tagEnd(c, "${replyBody_1.WORD_SECTION_ANCHOR}")
+    if cutPoint is 0 then set cutPoint to my tagEnd(c, "<body")
+    if cutPoint is 0 then return ins & c
+    if cutPoint is (length of c) then return c & ins
+    return (text 1 thru cutPoint of c) & ins & (text (cutPoint + 1) thru -1 of c)
+end insertAboveQuoted
+
+-- 'rest' is an AppleScript term (rest of list), so the remainder cannot be
+-- called that: assigning to it compiles and then fails at run time.
+on tagEnd(c, marker)
+    set ix to offset of marker in c
+    if ix is 0 then return 0
+    if marker ends with ">" then return ix + (length of marker) - 1
+    set tailText to text ix thru -1 of c
+    set gt to offset of ">" in tailText
+    if gt is 0 then return 0
+    return ix + gt - 1
+end tagEnd
+`;
+/** Split a script's output into records, dropping the trailing empty one. */
+function splitRecords(raw) {
+    return raw.split(exports.RECORD_SEP).filter(record => record.trim() !== '');
+}
+/** Split one record into its fields. */
+function splitFields(record) {
+    return record.split(exports.FIELD_SEP);
+}
+/** Split one field that carries a list. */
+function splitList(value) {
+    return (value || '').split(exports.LIST_SEP).filter(Boolean);
+}
+/** A field by position — a missing field reads as ''. */
+function field(fields, index) {
+    return fields[index] ?? '';
+}
+/**
+ * The fields of a script's ONE summary record — the shape every mutation here
+ * returns (counts first, then any per-item failures as further records).
+ */
+function summaryFields(raw) {
+    return splitFields(splitRecords(raw)[0] ?? '');
+}
+/** A numeric field, defaulting to `fallback` when absent or unparsable. */
+function intField(fields, index, fallback = 0) {
+    const parsed = Number.parseInt(field(fields, index), 10);
+    return Number.isNaN(parsed) ? fallback : parsed;
+}
+/**
+ * A boolean field. AppleScript renders booleans as the bare words `true`/`false`,
+ * so this is the counterpart of `shared/json.ts`'s coercions for the framed
+ * output — the Windows side gets those free from ConvertFrom-Json.
+ */
+function boolField(fields, index) {
+    return field(fields, index).trim() === 'true';
+}
+//# sourceMappingURL=run.js.map

package/dist/mac/run.js.map

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

package/dist/mac/scripts.d.ts

@@ -0,0 +1,137 @@
+import type { MailFolderRef } from '../types';
+/**
+ * Resolve the account whose SMTP address matches, or raise. Emitted into a
+ * `tell application "Microsoft Outlook"` block; binds `targetAcct`.
+ *
+ * `every account` errors even in legacy mode, so probe the typed classes. A
+ * `whose email address is ...` filter can't be used either: `email address` is
+ * also a class name, and AppleScript resolves it as one ("into type specifier").
+ *
+ * The thrown sentence is the one `classifyRunFailure` recognises to raise
+ * `AccountNotFoundError`, so its wording is load-bearing.
+ */
+export declare function accountLookupSnippet(emailAccount: string): string;
+/**
+ * Outlook for Mac's dictionary term for each well-known root, keyed by the
+ * olDefaultFolders id `mailFolderRef` resolves.
+ *
+ * Verified against the running app. The terms are NOT the ones the Windows ids
+ * suggest — `sent mail` and `junk email` do not compile at all, while
+ * `sent items` and `junk mail` do, and a bad term fails the whole script at
+ * compile time rather than at the offending line.
+ */
+export declare const MAC_ROOT_TERMS: Record<number, string>;
+/** The date property a folder's items actually carry. */
+export declare function dateProperty(rootId: number): string;
+/**
+ * The Windows `FolderPath` shape (`\\mailbox\Inbox\Invoices`), built here rather
+ * than in AppleScript — escaping backslashes through a template literal and then
+ * an AppleScript literal is unreadable, and TS already knows the parts.
+ */
+export declare function macFolderPath(emailAccount: string, rootLabel: string, segments: string[]): string;
+/** The dictionary term for a root, or a NOT_IMPLEMENTED naming what was asked. */
+export declare function rootTerm(ref: MailFolderRef, folderLabel?: string): string;
+/**
+ * Emit the AppleScript that resolves `scopeFolder` from `targetAcct`, walking a
+ * well-known root down through any further path segments. Also binds
+ * `scopeCreated`.
+ *
+ * Folder names are compared with `is`, which is case-insensitive in AppleScript —
+ * matching the Windows walk's `-ieq` so 'invoices' finds 'Invoices' on both.
+ * A missing segment errors by name instead of falling back to the root: silently
+ * returning the Inbox for a caller that scoped to one folder hands back the wrong
+ * emails under a name that says otherwise. `createMissing` builds the whole
+ * chain instead, so a nested destination is one call.
+ */
+export declare function mailScopeSnippet(ref: MailFolderRef, folderLabel?: string, createMissing?: boolean): string;
+/**
+ * The message-id text for a script, or an InvalidRequestError.
+ *
+ * Outlook for Mac ids are small integers; a Windows MAPI EntryID is rejected up
+ * front rather than left to fail as a confusing "not found", because a caller
+ * that persisted one from a Windows run needs to be told exactly that.
+ */
+export declare function macMessageId(entryId: string): string;
+/**
+ * Split ids into the ones a script can look up and the ones that can only fail.
+ *
+ * The per-id operations report failures rather than throwing, so an unusable id
+ * belongs in the result's `failed` list beside a genuine lookup miss — not as an
+ * exception that discards the ids that would have worked.
+ */
+export declare function partitionMessageIds(entryIds: readonly string[]): {
+    valid: string[];
+    invalid: {
+        entryId: string;
+        error: string;
+    }[];
+};
+/**
+ * Resolve `theMsg` from a macOS message id, or raise.
+ *
+ * `message id N` resolves against the application rather than one folder, so the
+ * message is found wherever it currently sits — including a subfolder.
+ */
+export declare function messageLookupSnippet(id: string, variable?: string): string;
+/**
+ * The sender's display name and address, as `sndName` / `sndAddr`.
+ *
+ * `sender` yields a record, and `address of sender of m` fails to coerce, so the
+ * record has to be bound first. `name` is absent when there is no display name.
+ */
+export declare function senderSnippet(messageVariable?: string, indent?: string): string;
+/**
+ * Everything a reader wants off ONE message already bound to `theMsg`, and the
+ * row it produces — emitted together so the read order and the positions the
+ * TypeScript decoders index into cannot drift apart.
+ *
+ * Three callers share it (`readEmailBody`, `readSelectedEmail`, and the
+ * attachment resolver) and differ only in how they bind `theMsg`. They used to
+ * share it by copy: thirty lines repeated, with the `time received` → `time sent`
+ * fallback and the field order restated each time, so a dictionary fix reached
+ * one reader and not the others.
+ *
+ * `bodyText` is emitted LAST when asked for, so a stray separator in an earlier
+ * field cannot shift it.
+ */
+export declare function messageDetailSnippet(withBody?: boolean, indent?: string): string;
+/**
+ * The fields `messageDetailSnippet` fills, in row order. The decoders read them
+ * back by the positions in `MessageDetail`.
+ */
+export declare function messageDetailFields(withBody?: boolean): string[];
+/** Where each of those fields lands in the emitted row. */
+export declare const MessageDetail: {
+    readonly id: 0;
+    readonly subject: 1;
+    readonly senderName: 2;
+    readonly senderEmail: 3;
+    readonly receivedTime: 4;
+    readonly attachmentNames: 5;
+    readonly body: 6;
+};
+/**
+ * The first recipient's name and address, as `sndName` / `sndAddr` — what
+ * outgoing mail reports in place of a sender, matching the Windows reader's
+ * contract for Sent Items (a folder of mail from yourself is unreadable).
+ */
+export declare function firstRecipientSnippet(messageVariable?: string, indent?: string): string;
+/**
+ * Every SMTP address a message was addressed to, as the list `addrList`.
+ *
+ * `every recipient` covers To, CC and BCC — the full set, which is the whole
+ * point of readSentRecipientGroups.
+ */
+export declare function allRecipientsSnippet(messageVariable?: string, indent?: string): string;
+/**
+ * Recursive folder-by-name search from `startFolder`, case-insensitive and
+ * depth-capped — the macOS counterpart of the Windows Find-FolderByName, used to
+ * resolve a template folder anywhere in the mailbox tree.
+ */
+export declare const FIND_FOLDER_HANDLER = "\non findFolderByName(startFolder, wantedName, depth)\n    tell application \"Microsoft Outlook\"\n        set subs to mail folders of startFolder\n    end tell\n    repeat with f in subs\n        if (name of f as string) is wantedName then return f\n    end repeat\n    if depth is less than or equal to 1 then return missing value\n    repeat with f in subs\n        set hit to my findFolderByName(f, wantedName, depth - 1)\n        if hit is not missing value then return hit\n    end repeat\n    return missing value\nend findFolderByName\n";
+/**
+ * Account enumeration only works when Outlook runs in legacy mode; New Outlook
+ * errors on `every account` and returns empty lists for the typed classes, so
+ * each class is probed independently and failures are ignored.
+ */
+export declare const LIST_ACCOUNTS_SNIPPET = "\nset acctList to {}\ntell application \"Microsoft Outlook\"\n    repeat with acctClass in {\"exchange\", \"imap\", \"pop\"}\n        try\n            if (acctClass as string) is \"exchange\" then\n                set accts to exchange accounts\n            else if (acctClass as string) is \"imap\" then\n                set accts to imap accounts\n            else\n                set accts to pop accounts\n            end if\n            repeat with a in accts\n                try\n                    set end of acctList to (email address of a as string)\n                end try\n            end repeat\n        end try\n    end repeat\nend tell\n";