@dawnlit/outlook-bridge 1.1.0 → 2.0.0

package/dist/shared/json.js.map

@@ -1 +1 @@
-{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/shared/json.ts"],"names":[],"mappings":";AAAA,6DAA6D;AAC7D,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAC/E,wEAAwE;;AAGxE,kCAGC;AAGD,gCAGC;AAGD,0BAEC;AAGD,wBAEC;AAED,kBAEC;AAED,kBAEC;AAED,0BAEC;AAhCD,gFAAgF;AAChF,SAAgB,WAAW,CAAC,GAAW;IACnC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAC;AAC7D,CAAC;AAED,gFAAgF;AAChF,SAAgB,UAAU,CAAC,GAAW;IAClC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IAC5D,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,oFAAoF;AACpF,SAAgB,OAAO,CAAC,KAAc;IAClC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,sEAAsE;AACtE,SAAgB,MAAM,CAAC,KAAc;IACjC,OAAO,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;AACpD,CAAC;AAED,SAAgB,GAAG,CAAC,KAAc;IAC9B,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,SAAgB,GAAG,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,SAAgB,OAAO,CAAC,KAAc;IAClC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/shared/json.ts"],"names":[],"mappings":";AAAA,yEAAyE;AACzE,EAAE;AACF,sEAAsE;AACtE,0EAA0E;AAC1E,gFAAgF;AAChF,oEAAoE;;AAGpE,0BAEC;AAGD,wBAIC;AAED,kBAEC;AAED,kBAEC;AAED,oBAEC;AAGD,0BAEC;AAGD,gCAEC;AAGD,oCAKC;AAxCD,iGAAiG;AACjG,SAAgB,OAAO,CAAC,KAAc;IAClC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,iEAAiE;AACjE,SAAgB,MAAM,CAAC,KAAc;IACjC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACvE,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,EAAE,CAAC;AACb,CAAC;AAED,SAAgB,GAAG,CAAC,KAAc;IAC9B,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,SAAgB,GAAG,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,SAAgB,IAAI,CAAC,KAAc;IAC/B,OAAO,KAAK,KAAK,IAAI,CAAC;AAC1B,CAAC;AAED,mCAAmC;AACnC,SAAgB,OAAO,CAAC,KAAc;IAClC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,0FAA0F;AAC1F,SAAgB,UAAU,CAAC,KAAc;IACrC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC9D,CAAC;AAED,+DAA+D;AAC/D,SAAgB,YAAY,CAAC,KAAc;IACvC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,OAAO,EAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACP,CAAC","sourcesContent":["// Coercing the JSON a PowerShell script prints into the package's types.\n//\n// ConvertTo-Json has two habits a caller must never see: it unwraps a\n// single-element array into a bare object, and it renders an empty one as\n// nothing at all. Every list crossing that boundary goes through `toArray`, and\n// every scalar through a coercion that survives a missing property.\n\n/** One value as a list: an array stays, null and undefined become empty, anything else wraps. */\nexport function toArray(value: unknown): unknown[] {\n    return Array.isArray(value) ? value : value == null ? [] : [value];\n}\n\n/** A value as a plain object, for reading fields off one row. */\nexport function record(value: unknown): Record<string, unknown> {\n    return value !== null && typeof value === 'object' && !Array.isArray(value)\n        ? value as Record<string, unknown>\n        : {};\n}\n\nexport function str(value: unknown): string {\n    return value == null ? '' : String(value);\n}\n\nexport function num(value: unknown): number {\n    return typeof value === 'number' && Number.isFinite(value) ? value : 0;\n}\n\nexport function bool(value: unknown): boolean {\n    return value === true;\n}\n\n/** A list of non-empty strings. */\nexport function strList(value: unknown): string[] {\n    return toArray(value).map(str).filter(Boolean);\n}\n\n/** A base64 field decoded as UTF-8 — how scripts pass bodies that must survive intact. */\nexport function base64Text(value: unknown): string {\n    return Buffer.from(str(value), 'base64').toString('utf8');\n}\n\n/** A list of per-item failures, as the scripts report them. */\nexport function itemFailures(value: unknown): { entryId: string; subject: string; error: string }[] {\n    return toArray(value).map(row => {\n        const e = record(row);\n        return {entryId: str(e.entryId), subject: str(e.subject), error: str(e.error)};\n    });\n}\n"]}

package/dist/shared/locate.d.ts

@@ -0,0 +1,39 @@
+import type { InboxSearchMatch } from '../types';
+/** The fields a match is judged on, trimmed; blank means not given. */
+export interface WantedEmail {
+    readonly subject?: string;
+    readonly sender?: string;
+    readonly receivedTime?: string;
+}
+/** INVALID_REQUEST unless the description gives enough to tell one email from its thread. */
+export declare function requireDescribed(wanted: WantedEmail): void;
+/**
+ * The subject glob to prefilter a search with: the longest run of plain
+ * characters in the subject, or undefined when there's no run of four.
+ *
+ * A subject can hold an apostrophe or a `*`, and the prefilter becomes a query
+ * on some stores; it only has to be selective, since every result is judged on
+ * the whole subject afterwards.
+ */
+export declare function subjectPrefilter(subject: string | undefined): string | undefined;
+/**
+ * How far back a search has to reach to cover the day the email arrived, or
+ * `fallback` when no day is known. Two days of slack cover whichever timezone
+ * the stamp was written in, and a search started either side of midnight.
+ */
+export declare function daysBackFor(receivedTime: string | undefined, fallback: number, now?: number): number;
+/**
+ * How well a found email answers the description, or 0 for "not this one".
+ *
+ * Disagreement on any given field disqualifies outright. Agreement is then
+ * ranked, so an exact minute beats the same day: a sender who wrote twice in
+ * one afternoon still resolves to the email described.
+ */
+export declare function matchScore(wanted: WantedEmail, match: InboxSearchMatch): number;
+/** The best match, or null when nothing agrees with the description. */
+export declare function bestMatch(wanted: WantedEmail, matches: readonly InboxSearchMatch[]): InboxSearchMatch | null;
+/**
+ * Accounts in the order to search them: the one a listing's folderPath names
+ * first (`\\team@example.com\Inbox\…`), then the rest as given.
+ */
+export declare function accountSearchOrder(accounts: readonly string[], folderPath: string | undefined): string[];

package/dist/shared/locate.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireDescribed = requireDescribed;
+exports.subjectPrefilter = subjectPrefilter;
+exports.daysBackFor = daysBackFor;
+exports.matchScore = matchScore;
+exports.bestMatch = bestMatch;
+exports.accountSearchOrder = accountSearchOrder;
+// Finding an email again from what was kept about it: the rules, as pure
+// functions. The search itself is an ordinary searchInboxByFilter per mailbox;
+// what lives here is how narrow that search can be made, and which of its
+// results is the email.
+//
+// The rules never guess. Every field the description gives has to agree, and at
+// least two have to be given, because a subject alone names every message in a
+// thread. A miss stays a miss rather than returning somebody else's email.
+const mail_1 = require("../mail");
+const errors_1 = require("../errors");
+/** `yyyy-MM-dd`, optionally followed by ` HH:mm` — how both platforms stamp a received time. */
+const STAMP = /^\d{4}-\d{2}-\d{2}([ T]\d{2}:\d{2})?/;
+/** An address inside a sender string, which may be a name, an address, or both. */
+const ADDRESS = /[^\s<>,;"']+@[^\s<>,;"']+/;
+const DAY_MS = 86_400_000;
+const subjectKey = (subject) => (0, mail_1.threadSubject)(subject).toLowerCase();
+/**
+ * The stamp in the listings' own form (`yyyy-MM-dd HH:mm`), or '' when it isn't
+ * a stamp at all — which is then treated as not given, since it can't disagree
+ * with anything.
+ */
+function stampOf(receivedTime) {
+    const match = STAMP.exec((receivedTime ?? '').trim());
+    return match ? match[0].replace('T', ' ') : '';
+}
+/** How many of the three fields the description actually gives. */
+function recordedCount(wanted) {
+    return (wanted.subject ? 1 : 0) + (wanted.sender ? 1 : 0) + (stampOf(wanted.receivedTime) ? 1 : 0);
+}
+/** INVALID_REQUEST unless the description gives enough to tell one email from its thread. */
+function requireDescribed(wanted) {
+    if (recordedCount(wanted) < 2) {
+        throw new errors_1.InvalidRequestError('Describe the email by at least two of subject, sender and receivedTime (as yyyy-MM-dd HH:mm): '
+            + 'a subject alone names every message in its thread.');
+    }
+}
+/**
+ * The subject glob to prefilter a search with: the longest run of plain
+ * characters in the subject, or undefined when there's no run of four.
+ *
+ * A subject can hold an apostrophe or a `*`, and the prefilter becomes a query
+ * on some stores; it only has to be selective, since every result is judged on
+ * the whole subject afterwards.
+ */
+function subjectPrefilter(subject) {
+    const longest = ((0, mail_1.threadSubject)(subject ?? '').match(/[A-Za-z0-9 ._-]+/g) ?? [])
+        .map(run => run.trim())
+        .sort((a, b) => b.length - a.length)[0] ?? '';
+    return longest.length >= 4 ? `*${longest}*` : undefined;
+}
+/**
+ * How far back a search has to reach to cover the day the email arrived, or
+ * `fallback` when no day is known. Two days of slack cover whichever timezone
+ * the stamp was written in, and a search started either side of midnight.
+ */
+function daysBackFor(receivedTime, fallback, now = Date.now()) {
+    const stamp = stampOf(receivedTime);
+    if (!stamp)
+        return fallback;
+    const day = Date.parse(`${stamp.slice(0, 10)}T00:00:00Z`);
+    if (Number.isNaN(day))
+        return fallback;
+    return Math.max(1, Math.floor((now - day) / DAY_MS) + 2);
+}
+/** Whether a found email came from the sender described. */
+function senderMatches(wanted, match) {
+    const want = wanted.toLowerCase();
+    const address = ADDRESS.exec(want)?.[0];
+    if (address)
+        return address === match.senderEmail.trim().toLowerCase();
+    const name = match.senderName.trim().toLowerCase();
+    return name !== '' && (want.includes(name) || name.includes(want));
+}
+/**
+ * How well a found email answers the description, or 0 for "not this one".
+ *
+ * Disagreement on any given field disqualifies outright. Agreement is then
+ * ranked, so an exact minute beats the same day: a sender who wrote twice in
+ * one afternoon still resolves to the email described.
+ */
+function matchScore(wanted, match) {
+    if (recordedCount(wanted) < 2)
+        return 0;
+    const wantSubject = wanted.subject ? subjectKey(wanted.subject) : '';
+    if (wantSubject && subjectKey(match.subject) !== wantSubject)
+        return 0;
+    if (wanted.sender && !senderMatches(wanted.sender, match))
+        return 0;
+    const stamp = stampOf(wanted.receivedTime);
+    const found = match.receivedTime.trim();
+    const sameDay = stamp !== '' && stamp.slice(0, 10) === found.slice(0, 10);
+    const sameMinute = sameDay && stamp.length >= 16 && stamp.slice(0, 16) === found.slice(0, 16);
+    if (stamp && !sameDay)
+        return 0;
+    return (wantSubject ? 1 : 0) + (wanted.sender ? 2 : 0) + (sameMinute ? 3 : sameDay ? 1 : 0);
+}
+/** The best match, or null when nothing agrees with the description. */
+function bestMatch(wanted, matches) {
+    let best = null;
+    let bestScore = 0;
+    for (const match of matches) {
+        const score = matchScore(wanted, match);
+        if (score > bestScore) {
+            best = match;
+            bestScore = score;
+        }
+    }
+    return best;
+}
+/**
+ * Accounts in the order to search them: the one a listing's folderPath names
+ * first (`\\team@example.com\Inbox\…`), then the rest as given.
+ */
+function accountSearchOrder(accounts, folderPath) {
+    const path = (folderPath ?? '').toLowerCase();
+    if (!path)
+        return [...accounts];
+    const named = accounts.filter(account => path.includes(account.toLowerCase()));
+    return [...named, ...accounts.filter(account => !named.includes(account))];
+}
+//# sourceMappingURL=locate.js.map

package/dist/shared/locate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.js","sourceRoot":"","sources":["../../src/shared/locate.ts"],"names":[],"mappings":"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","sourcesContent":["// Finding an email again from what was kept about it: the rules, as pure\n// functions. The search itself is an ordinary searchInboxByFilter per mailbox;\n// what lives here is how narrow that search can be made, and which of its\n// results is the email.\n//\n// The rules never guess. Every field the description gives has to agree, and at\n// least two have to be given, because a subject alone names every message in a\n// thread. A miss stays a miss rather than returning somebody else's email.\nimport { threadSubject } from '../mail';\nimport { InvalidRequestError } from '../errors';\nimport type { InboxSearchMatch } from '../types';\n\n/** The fields a match is judged on, trimmed; blank means not given. */\nexport interface WantedEmail {\n    readonly subject?: string;\n    readonly sender?: string;\n    readonly receivedTime?: string;\n}\n\n/** `yyyy-MM-dd`, optionally followed by ` HH:mm` — how both platforms stamp a received time. */\nconst STAMP = /^\\d{4}-\\d{2}-\\d{2}([ T]\\d{2}:\\d{2})?/;\n\n/** An address inside a sender string, which may be a name, an address, or both. */\nconst ADDRESS = /[^\\s<>,;\"']+@[^\\s<>,;\"']+/;\n\nconst DAY_MS = 86_400_000;\n\nconst subjectKey = (subject: string): string => threadSubject(subject).toLowerCase();\n\n/**\n * The stamp in the listings' own form (`yyyy-MM-dd HH:mm`), or '' when it isn't\n * a stamp at all — which is then treated as not given, since it can't disagree\n * with anything.\n */\nfunction stampOf(receivedTime: string | undefined): string {\n    const match = STAMP.exec((receivedTime ?? '').trim());\n    return match ? match[0].replace('T', ' ') : '';\n}\n\n/** How many of the three fields the description actually gives. */\nfunction recordedCount(wanted: WantedEmail): number {\n    return (wanted.subject ? 1 : 0) + (wanted.sender ? 1 : 0) + (stampOf(wanted.receivedTime) ? 1 : 0);\n}\n\n/** INVALID_REQUEST unless the description gives enough to tell one email from its thread. */\nexport function requireDescribed(wanted: WantedEmail): void {\n    if (recordedCount(wanted) < 2) {\n        throw new InvalidRequestError(\n            'Describe the email by at least two of subject, sender and receivedTime (as yyyy-MM-dd HH:mm): '\n            + 'a subject alone names every message in its thread.',\n        );\n    }\n}\n\n/**\n * The subject glob to prefilter a search with: the longest run of plain\n * characters in the subject, or undefined when there's no run of four.\n *\n * A subject can hold an apostrophe or a `*`, and the prefilter becomes a query\n * on some stores; it only has to be selective, since every result is judged on\n * the whole subject afterwards.\n */\nexport function subjectPrefilter(subject: string | undefined): string | undefined {\n    const longest = (threadSubject(subject ?? '').match(/[A-Za-z0-9 ._-]+/g) ?? [])\n        .map(run => run.trim())\n        .sort((a, b) => b.length - a.length)[0] ?? '';\n    return longest.length >= 4 ? `*${longest}*` : undefined;\n}\n\n/**\n * How far back a search has to reach to cover the day the email arrived, or\n * `fallback` when no day is known. Two days of slack cover whichever timezone\n * the stamp was written in, and a search started either side of midnight.\n */\nexport function daysBackFor(receivedTime: string | undefined, fallback: number, now = Date.now()): number {\n    const stamp = stampOf(receivedTime);\n    if (!stamp) return fallback;\n    const day = Date.parse(`${stamp.slice(0, 10)}T00:00:00Z`);\n    if (Number.isNaN(day)) return fallback;\n    return Math.max(1, Math.floor((now - day) / DAY_MS) + 2);\n}\n\n/** Whether a found email came from the sender described. */\nfunction senderMatches(wanted: string, match: InboxSearchMatch): boolean {\n    const want = wanted.toLowerCase();\n    const address = ADDRESS.exec(want)?.[0];\n    if (address) return address === match.senderEmail.trim().toLowerCase();\n    const name = match.senderName.trim().toLowerCase();\n    return name !== '' && (want.includes(name) || name.includes(want));\n}\n\n/**\n * How well a found email answers the description, or 0 for \"not this one\".\n *\n * Disagreement on any given field disqualifies outright. Agreement is then\n * ranked, so an exact minute beats the same day: a sender who wrote twice in\n * one afternoon still resolves to the email described.\n */\nexport function matchScore(wanted: WantedEmail, match: InboxSearchMatch): number {\n    if (recordedCount(wanted) < 2) return 0;\n\n    const wantSubject = wanted.subject ? subjectKey(wanted.subject) : '';\n    if (wantSubject && subjectKey(match.subject) !== wantSubject) return 0;\n    if (wanted.sender && !senderMatches(wanted.sender, match)) return 0;\n\n    const stamp = stampOf(wanted.receivedTime);\n    const found = match.receivedTime.trim();\n    const sameDay = stamp !== '' && stamp.slice(0, 10) === found.slice(0, 10);\n    const sameMinute = sameDay && stamp.length >= 16 && stamp.slice(0, 16) === found.slice(0, 16);\n    if (stamp && !sameDay) return 0;\n\n    return (wantSubject ? 1 : 0) + (wanted.sender ? 2 : 0) + (sameMinute ? 3 : sameDay ? 1 : 0);\n}\n\n/** The best match, or null when nothing agrees with the description. */\nexport function bestMatch(wanted: WantedEmail, matches: readonly InboxSearchMatch[]): InboxSearchMatch | null {\n    let best: InboxSearchMatch | null = null;\n    let bestScore = 0;\n    for (const match of matches) {\n        const score = matchScore(wanted, match);\n        if (score > bestScore) {\n            best = match;\n            bestScore = score;\n        }\n    }\n    return best;\n}\n\n/**\n * Accounts in the order to search them: the one a listing's folderPath names\n * first (`\\\\team@example.com\\Inbox\\…`), then the rest as given.\n */\nexport function accountSearchOrder(accounts: readonly string[], folderPath: string | undefined): string[] {\n    const path = (folderPath ?? '').toLowerCase();\n    if (!path) return [...accounts];\n    const named = accounts.filter(account => path.includes(account.toLowerCase()));\n    return [...named, ...accounts.filter(account => !named.includes(account))];\n}\n"]}

package/dist/shared/replyBody.d.ts

@@ -1,49 +1,59 @@
-import type { ReplyEmailParams, TemplateFolderResult } from '../types';
-/** The reads a platform must supply for a template- or signature-backed reply. */
+import type { ReadTemplatesRequest } from '../backend';
+import type { TemplateFolderResult } from '../types';
+/** The reads a template- or signature-backed reply needs. */
 export interface ReplyBodyDeps {
-    readTemplateEmails(emailAccount: string, folderName?: string, limit?: number, includeBody?: boolean, subject?: string): Promise<TemplateFolderResult>;
+    readTemplateEmails(request: ReadTemplatesRequest): Promise<TemplateFolderResult>;
     readOutlookSignatureHtml(name: string): Promise<string>;
     listOutlookSignatures(): Promise<string[]>;
 }
+/** A reply's content, as the caller described it — already validated. */
+export interface ReplyContent {
+    readonly account: string;
+    readonly htmlBody?: string;
+    readonly templateSubject?: string;
+    readonly templateFolder: string;
+    readonly templateSection?: string;
+    readonly templatePlaceholders?: Readonly<Record<string, string>>;
+    readonly signatureName?: string;
+}
 /**
- * The content of an HTML document's `<body>`, or the input when there is no
- * document around it.
- *
- * Both things this is used on — a signature file and a saved template — are whole
- * HTML documents, and neither may nest its `<html>`/`<body>` inside the reply's.
+ * The content of an HTML document's `<body>`, or the input when it isn't a
+ * whole document. Signature files and saved templates are both whole documents,
+ * and neither may nest its `<html>`/`<body>` inside another email's.
  */
 export declare function innerBodyHtml(html: string): string;
 /**
- * Resolve a saved template's HTML by subject, so a reply can name a template
- * instead of carrying its (often large, Word-generated) HTML.
+ * A saved template's HTML, found by subject.
  *
- * The read is filtered by subject in the platform layer rather than here:
- * unfiltered, EVERY template's full body crosses the interpreter's stdout on
- * every reply, and a folder of Word-sized templates overruns the buffer outright
- * — turning a growing Templates folder into a failure on a call that never
- * needed more than one body.
+ * The read is filtered by subject in the platform script: unfiltered, EVERY
+ * template's full body would cross the interpreter's stdout on every reply, and
+ * a folder of Word-sized templates overruns the output limit on a call that
+ * only ever needed one of them.
+ */
+export declare function resolveTemplateHtml(deps: ReplyBodyDeps, account: string, folder: string, subject: string): Promise<string>;
+/** A named signature's HTML, ready to insert into a body; NOT_FOUND naming the ones there are. */
+export declare function resolveSignatureHtml(deps: Pick<ReplyBodyDeps, 'readOutlookSignatureHtml' | 'listOutlookSignatures'>, name: string): Promise<string>;
+/**
+ * Sign a body: in its `{{SIGNATURE}}` placeholder when it has one, otherwise at
+ * the end, where Outlook itself would put a signature. In a whole document the
+ * end is just inside `</body>`, since anything after `</html>` is outside the
+ * email.
  */
-export declare function resolveTemplateHtmlBySubject(deps: ReplyBodyDeps, emailAccount: string, folderName: string, subject: string): Promise<string>;
+export declare function placeSignature(html: string, signature: string): string;
 /**
  * The HTML to insert above the quoted original: template resolved, section
- * chosen, placeholders and signature filled, document wrapper removed.
+ * kept, placeholders and signature filled, document wrapper removed.
  *
- * Composition also runs (with no options) on any body taken straight from a
- * template, so a stray [[SECTION]] marker is caught here rather than mailed to a
- * customer.
+ * A body taken from a template is always put through composition, even with
+ * nothing to fill, so a stray [[SECTION]] marker is caught here rather than
+ * mailed out.
  */
-export declare function composeReplyHtml(params: ReplyEmailParams, deps: ReplyBodyDeps): Promise<string>;
+export declare function composeReplyHtml(content: ReplyContent, deps: ReplyBodyDeps): Promise<string>;
 /**
- * Where the new text goes in an Outlook-built reply.
- *
- * Outlook builds the reply body as a Word document whose own (empty) paragraph
- * sits inside `WordSection1`; inserting straight after that div's opening tag is
- * what puts the new text where the user's cursor would have been. A reply
- * Outlook did not build that way falls back to just inside `<body>`.
- *
- * The insertion itself cannot live here — the reply HTML never leaves Outlook,
- * so each platform splices it in its own language (`windows/send.ts`, and the
- * `insertAboveQuoted` handler in `mac/run.ts`). The anchor both of them look for
- * is the one part they must agree on, so it is stated once, here.
+ * Where the new text goes in an Outlook-built reply: straight after the opening
+ * of `WordSection1`, the div holding the empty paragraph where a person's cursor
+ * would be. A reply Outlook didn't build that way falls back to just inside
+ * `<body>`. The insertion itself happens in each platform's own language, since
+ * the reply HTML never leaves Outlook; this anchor is the part both must agree on.
  */
 export declare const WORD_SECTION_ANCHOR = "WordSection1>";

package/dist/shared/replyBody.js

@@ -2,112 +2,125 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WORD_SECTION_ANCHOR = void 0;
 exports.innerBodyHtml = innerBodyHtml;
-exports.resolveTemplateHtmlBySubject = resolveTemplateHtmlBySubject;
+exports.resolveTemplateHtml = resolveTemplateHtml;
+exports.resolveSignatureHtml = resolveSignatureHtml;
+exports.placeSignature = placeSignature;
 exports.composeReplyHtml = composeReplyHtml;
-// Everything replyOutlookEmail does BEFORE it touches Outlook.
-//
-// Resolving a named template, filling {{PLACEHOLDER}}s, substituting a named
-// signature and reducing the result to insertable HTML is identical work on both
-// platforms — it is string handling plus two reads that each platform already
-// implements. Keeping it here is what lets macOS answer the same
-// ReplyEmailParams contract Windows does instead of a subset of it.
-const outlookTemplateSections_1 = require("../outlookTemplateSections");
+// Everything a reply needs before it touches Outlook: resolving a named
+// template, keeping its section, filling placeholders and a named signature,
+// and reducing the result to HTML that can be inserted into another document.
+// Signing a new email uses the signature half of it. String work plus three
+// reads each platform already provides, so it is done once here for both.
+const templateBody_1 = require("../templateBody");
 const errors_1 = require("../errors");
 /**
- * The content of an HTML document's `<body>`, or the input when there is no
- * document around it.
- *
- * Both things this is used on — a signature file and a saved template — are whole
- * HTML documents, and neither may nest its `<html>`/`<body>` inside the reply's.
+ * The content of an HTML document's `<body>`, or the input when it isn't a
+ * whole document. Signature files and saved templates are both whole documents,
+ * and neither may nest its `<html>`/`<body>` inside another email's.
  */
 function innerBodyHtml(html) {
     const match = /<body[^>]*>([\s\S]*)<\/body>/i.exec(html);
     return (match ? match[1] : html).trim();
 }
 /**
- * Resolve a saved template's HTML by subject, so a reply can name a template
- * instead of carrying its (often large, Word-generated) HTML.
+ * A saved template's HTML, found by subject.
  *
- * The read is filtered by subject in the platform layer rather than here:
- * unfiltered, EVERY template's full body crosses the interpreter's stdout on
- * every reply, and a folder of Word-sized templates overruns the buffer outright
- * — turning a growing Templates folder into a failure on a call that never
- * needed more than one body.
+ * The read is filtered by subject in the platform script: unfiltered, EVERY
+ * template's full body would cross the interpreter's stdout on every reply, and
+ * a folder of Word-sized templates overruns the output limit on a call that
+ * only ever needed one of them.
  */
-async function resolveTemplateHtmlBySubject(deps, emailAccount, folderName, subject) {
-    const result = await deps.readTemplateEmails(emailAccount, folderName, 50, true, subject);
+async function resolveTemplateHtml(deps, account, folder, subject) {
+    const result = await deps.readTemplateEmails({ account, folder, limit: 50, includeBody: true, subject });
     if (!result.folderFound) {
         const folders = result.availableFolders.join(', ') || '(none)';
-        throw new errors_1.NotFoundError('folder', `Template folder '${folderName}' not found in ${emailAccount}. Available folders: ${folders}.`);
+        throw new errors_1.NotFoundError('folder', `Template folder '${folder}' not found in ${account}. Top-level folders: ${folders}.`);
     }
-    const want = subject.trim().toLowerCase();
-    const match = result.templates.find(t => t.subject.trim().toLowerCase() === want);
+    const wanted = subject.trim().toLowerCase();
+    const match = result.templates.find(t => t.subject.trim().toLowerCase() === wanted);
     if (!match) {
-        // The read above was filtered, so it can't name the alternatives. List them
-        // in a second pass with bodies omitted — which is what makes reading the
-        // whole folder safe here, and keeps the error as useful as it was before
-        // the filter.
-        const all = await deps.readTemplateEmails(emailAccount, folderName, 50, false);
+        // The read above was filtered, so it can't name the alternatives. A
+        // second read without bodies can, cheaply.
+        const all = await deps.readTemplateEmails({ account, folder, limit: 200, includeBody: false });
         const names = all.templates.map(t => t.subject).filter(Boolean).join(', ') || '(none)';
-        throw new errors_1.NotFoundError('template', `Template '${subject}' not found in '${folderName}'. Available templates: ${names}.`);
+        throw new errors_1.NotFoundError('template', `Template '${subject}' not found in '${folder}'. Templates there: ${names}.`);
     }
-    if (!match.htmlBody || match.htmlBody.trim() === '') {
+    if (match.htmlBody.trim() === '') {
         throw new errors_1.NotFoundError('template', `Template '${subject}' has an empty HTML body.`);
     }
     return match.htmlBody;
 }
+/** Where a template asks for the signature. */
+const SIGNATURE_TOKEN = '{{SIGNATURE}}';
+/** A named signature's HTML, ready to insert into a body; NOT_FOUND naming the ones there are. */
+async function resolveSignatureHtml(deps, name) {
+    const signatureHtml = await deps.readOutlookSignatureHtml(name);
+    if (signatureHtml.trim() === '') {
+        const available = (await deps.listOutlookSignatures()).join(', ') || '(none)';
+        throw new errors_1.NotFoundError('signature', `Outlook signature '${name}' not found. Signatures on this machine: ${available}.`);
+    }
+    return innerBodyHtml(signatureHtml);
+}
+/** Whether a body says where its signature goes. */
+function asksForSignature(html) {
+    return (0, templateBody_1.findTokens)(html, [SIGNATURE_TOKEN]).length > 0;
+}
+/**
+ * Sign a body: in its `{{SIGNATURE}}` placeholder when it has one, otherwise at
+ * the end, where Outlook itself would put a signature. In a whole document the
+ * end is just inside `</body>`, since anything after `</html>` is outside the
+ * email.
+ */
+function placeSignature(html, signature) {
+    if (asksForSignature(html))
+        return (0, templateBody_1.replaceToken)(html, SIGNATURE_TOKEN, signature);
+    const block = `<br>${signature}`;
+    const close = html.toLowerCase().lastIndexOf('</body');
+    return close === -1 ? html + block : html.slice(0, close) + block + html.slice(close);
+}
 /**
  * The HTML to insert above the quoted original: template resolved, section
- * chosen, placeholders and signature filled, document wrapper removed.
+ * kept, placeholders and signature filled, document wrapper removed.
  *
- * Composition also runs (with no options) on any body taken straight from a
- * template, so a stray [[SECTION]] marker is caught here rather than mailed to a
- * customer.
+ * A body taken from a template is always put through composition, even with
+ * nothing to fill, so a stray [[SECTION]] marker is caught here rather than
+ * mailed out.
  */
-async function composeReplyHtml(params, deps) {
-    let htmlBody = params.htmlBody;
+async function composeReplyHtml(content, deps) {
+    let html = content.htmlBody;
     let fromTemplate = false;
-    if ((!htmlBody || htmlBody.trim() === '') && params.templateSubject) {
-        htmlBody = await resolveTemplateHtmlBySubject(deps, params.emailAccount, params.templateFolder || 'Templates', params.templateSubject);
+    if ((!html || html.trim() === '') && content.templateSubject) {
+        html = await resolveTemplateHtml(deps, content.account, content.templateFolder, content.templateSubject);
         fromTemplate = true;
     }
-    if (!htmlBody || htmlBody.trim() === '') {
-        throw new errors_1.InvalidRequestError('replyOutlookEmail needs either htmlBody or a resolvable templateSubject.');
-    }
-    // A named signature fills {{SIGNATURE}} like any other placeholder, but is
-    // read here so the caller never carries the signature HTML — images and all —
-    // across the wire.
-    let placeholders = params.templatePlaceholders;
-    if (params.signatureName) {
-        const signatureHtml = await deps.readOutlookSignatureHtml(params.signatureName);
-        if (signatureHtml.trim() === '') {
-            const available = (await deps.listOutlookSignatures()).join(', ') || '(none)';
-            throw new errors_1.NotFoundError('signature', `Outlook signature '${params.signatureName}' not found. Available signatures: ${available}.`);
-        }
-        placeholders = { ...placeholders, SIGNATURE: innerBodyHtml(signatureHtml) };
+    if (!html || html.trim() === '') {
+        throw new errors_1.InvalidRequestError('A reply needs either htmlBody or templateSubject.');
     }
+    // A signature with a placeholder to go in is filled with the others, so
+    // one that sat in a dropped section goes with it. Without one it is added
+    // below the new text once everything else is composed.
+    let placeholders = content.templatePlaceholders;
+    const signature = content.signatureName ? await resolveSignatureHtml(deps, content.signatureName) : '';
+    const signatureInPlace = signature !== '' && asksForSignature(html);
+    if (signatureInPlace)
+        placeholders = { ...placeholders, SIGNATURE: signature };
     const hasPlaceholders = !!placeholders && Object.keys(placeholders).length > 0;
-    if (fromTemplate || params.templateSection || hasPlaceholders) {
-        htmlBody = (0, outlookTemplateSections_1.composeTemplateBody)(htmlBody, {
-            section: params.templateSection,
+    if (fromTemplate || content.templateSection || hasPlaceholders) {
+        html = (0, templateBody_1.composeTemplateBody)(html, {
+            section: content.templateSection,
             placeholders,
-            label: params.templateSubject,
+            label: content.templateSubject,
         });
     }
-    return innerBodyHtml(htmlBody);
+    const body = innerBodyHtml(html);
+    return signature !== '' && !signatureInPlace ? placeSignature(body, signature) : body;
 }
 /**
- * Where the new text goes in an Outlook-built reply.
- *
- * Outlook builds the reply body as a Word document whose own (empty) paragraph
- * sits inside `WordSection1`; inserting straight after that div's opening tag is
- * what puts the new text where the user's cursor would have been. A reply
- * Outlook did not build that way falls back to just inside `<body>`.
- *
- * The insertion itself cannot live here — the reply HTML never leaves Outlook,
- * so each platform splices it in its own language (`windows/send.ts`, and the
- * `insertAboveQuoted` handler in `mac/run.ts`). The anchor both of them look for
- * is the one part they must agree on, so it is stated once, here.
+ * Where the new text goes in an Outlook-built reply: straight after the opening
+ * of `WordSection1`, the div holding the empty paragraph where a person's cursor
+ * would be. A reply Outlook didn't build that way falls back to just inside
+ * `<body>`. The insertion itself happens in each platform's own language, since
+ * the reply HTML never leaves Outlook; this anchor is the part both must agree on.
  */
 exports.WORD_SECTION_ANCHOR = 'WordSection1>';
 //# sourceMappingURL=replyBody.js.map

package/dist/shared/replyBody.js.map

@@ -1 +1 @@
-{"version":3,"file":"replyBody.js","sourceRoot":"","sources":["../../src/shared/replyBody.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"replyBody.js","sourceRoot":"","sources":["../../src/shared/replyBody.ts"],"names":[],"mappings":"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","sourcesContent":["// Everything a reply needs before it touches Outlook: resolving a named\n// template, keeping its section, filling placeholders and a named signature,\n// and reducing the result to HTML that can be inserted into another document.\n// Signing a new email uses the signature half of it. String work plus three\n// reads each platform already provides, so it is done once here for both.\nimport { composeTemplateBody, findTokens, replaceToken } from '../templateBody';\nimport { InvalidRequestError, NotFoundError } from '../errors';\nimport type { ReadTemplatesRequest } from '../backend';\nimport type { TemplateFolderResult } from '../types';\n\n/** The reads a template- or signature-backed reply needs. */\nexport interface ReplyBodyDeps {\n    readTemplateEmails(request: ReadTemplatesRequest): Promise<TemplateFolderResult>;\n\n    readOutlookSignatureHtml(name: string): Promise<string>;\n\n    listOutlookSignatures(): Promise<string[]>;\n}\n\n/** A reply's content, as the caller described it — already validated. */\nexport interface ReplyContent {\n    readonly account: string;\n    readonly htmlBody?: string;\n    readonly templateSubject?: string;\n    readonly templateFolder: string;\n    readonly templateSection?: string;\n    readonly templatePlaceholders?: Readonly<Record<string, string>>;\n    readonly signatureName?: string;\n}\n\n/**\n * The content of an HTML document's `<body>`, or the input when it isn't a\n * whole document. Signature files and saved templates are both whole documents,\n * and neither may nest its `<html>`/`<body>` inside another email's.\n */\nexport function innerBodyHtml(html: string): string {\n    const match = /<body[^>]*>([\\s\\S]*)<\\/body>/i.exec(html);\n    return (match ? match[1] : html).trim();\n}\n\n/**\n * A saved template's HTML, found by subject.\n *\n * The read is filtered by subject in the platform script: unfiltered, EVERY\n * template's full body would cross the interpreter's stdout on every reply, and\n * a folder of Word-sized templates overruns the output limit on a call that\n * only ever needed one of them.\n */\nexport async function resolveTemplateHtml(\n    deps: ReplyBodyDeps,\n    account: string,\n    folder: string,\n    subject: string,\n): Promise<string> {\n    const result = await deps.readTemplateEmails({account, folder, limit: 50, includeBody: true, subject});\n    if (!result.folderFound) {\n        const folders = result.availableFolders.join(', ') || '(none)';\n        throw new NotFoundError('folder', `Template folder '${folder}' not found in ${account}. Top-level folders: ${folders}.`);\n    }\n    const wanted = subject.trim().toLowerCase();\n    const match = result.templates.find(t => t.subject.trim().toLowerCase() === wanted);\n    if (!match) {\n        // The read above was filtered, so it can't name the alternatives. A\n        // second read without bodies can, cheaply.\n        const all = await deps.readTemplateEmails({account, folder, limit: 200, includeBody: false});\n        const names = all.templates.map(t => t.subject).filter(Boolean).join(', ') || '(none)';\n        throw new NotFoundError('template', `Template '${subject}' not found in '${folder}'. Templates there: ${names}.`);\n    }\n    if (match.htmlBody.trim() === '') {\n        throw new NotFoundError('template', `Template '${subject}' has an empty HTML body.`);\n    }\n    return match.htmlBody;\n}\n\n/** Where a template asks for the signature. */\nconst SIGNATURE_TOKEN = '{{SIGNATURE}}';\n\n/** A named signature's HTML, ready to insert into a body; NOT_FOUND naming the ones there are. */\nexport async function resolveSignatureHtml(\n    deps: Pick<ReplyBodyDeps, 'readOutlookSignatureHtml' | 'listOutlookSignatures'>,\n    name: string,\n): Promise<string> {\n    const signatureHtml = await deps.readOutlookSignatureHtml(name);\n    if (signatureHtml.trim() === '') {\n        const available = (await deps.listOutlookSignatures()).join(', ') || '(none)';\n        throw new NotFoundError('signature', `Outlook signature '${name}' not found. Signatures on this machine: ${available}.`);\n    }\n    return innerBodyHtml(signatureHtml);\n}\n\n/** Whether a body says where its signature goes. */\nfunction asksForSignature(html: string): boolean {\n    return findTokens(html, [SIGNATURE_TOKEN]).length > 0;\n}\n\n/**\n * Sign a body: in its `{{SIGNATURE}}` placeholder when it has one, otherwise at\n * the end, where Outlook itself would put a signature. In a whole document the\n * end is just inside `</body>`, since anything after `</html>` is outside the\n * email.\n */\nexport function placeSignature(html: string, signature: string): string {\n    if (asksForSignature(html)) return replaceToken(html, SIGNATURE_TOKEN, signature);\n    const block = `<br>${signature}`;\n    const close = html.toLowerCase().lastIndexOf('</body');\n    return close === -1 ? html + block : html.slice(0, close) + block + html.slice(close);\n}\n\n/**\n * The HTML to insert above the quoted original: template resolved, section\n * kept, placeholders and signature filled, document wrapper removed.\n *\n * A body taken from a template is always put through composition, even with\n * nothing to fill, so a stray [[SECTION]] marker is caught here rather than\n * mailed out.\n */\nexport async function composeReplyHtml(content: ReplyContent, deps: ReplyBodyDeps): Promise<string> {\n    let html = content.htmlBody;\n    let fromTemplate = false;\n    if ((!html || html.trim() === '') && content.templateSubject) {\n        html = await resolveTemplateHtml(deps, content.account, content.templateFolder, content.templateSubject);\n        fromTemplate = true;\n    }\n    if (!html || html.trim() === '') {\n        throw new InvalidRequestError('A reply needs either htmlBody or templateSubject.');\n    }\n\n    // A signature with a placeholder to go in is filled with the others, so\n    // one that sat in a dropped section goes with it. Without one it is added\n    // below the new text once everything else is composed.\n    let placeholders = content.templatePlaceholders;\n    const signature = content.signatureName ? await resolveSignatureHtml(deps, content.signatureName) : '';\n    const signatureInPlace = signature !== '' && asksForSignature(html);\n    if (signatureInPlace) placeholders = {...placeholders, SIGNATURE: signature};\n\n    const hasPlaceholders = !!placeholders && Object.keys(placeholders).length > 0;\n    if (fromTemplate || content.templateSection || hasPlaceholders) {\n        html = composeTemplateBody(html, {\n            section: content.templateSection,\n            placeholders,\n            label: content.templateSubject,\n        });\n    }\n    const body = innerBodyHtml(html);\n    return signature !== '' && !signatureInPlace ? placeSignature(body, signature) : body;\n}\n\n/**\n * Where the new text goes in an Outlook-built reply: straight after the opening\n * of `WordSection1`, the div holding the empty paragraph where a person's cursor\n * would be. A reply Outlook didn't build that way falls back to just inside\n * `<body>`. The insertion itself happens in each platform's own language, since\n * the reply HTML never leaves Outlook; this anchor is the part both must agree on.\n */\nexport const WORD_SECTION_ANCHOR = 'WordSection1>';\n"]}

package/dist/templateBody.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Sections and placeholders in HTML email templates.
+ *
+ * A template email is an ordinary saved mail its owner edits in Outlook, so the
+ * greeting, closing and signature stay theirs. Where one template serves several
+ * kinds of reply, the variants live inside it between markers:
+ *
+ *     Hello,
+ *     [[ACCEPT]]    Thank you — we accept...            [[/ACCEPT]]
+ *     [[DECLINE]]   Thank you for letting us know...    [[/DECLINE]]
+ *     [[CLARIFY]]   {{QUESTIONS}}                       [[/CLARIFY]]
+ *     Best regards, {{SIGNATURE}}
+ *
+ * Composing keeps the requested section, drops the others, and substitutes the
+ * `{{PLACEHOLDER}}`s — so shared wording is written once and a caller names a
+ * section instead of carrying the whole body.
+ *
+ * Everything works on the raw HTML string rather than a parsed tree: Word's
+ * markup carries conditional comments and namespaced tags a parser round-trip
+ * would rewrite, and the composed body must stay byte-identical to what was
+ * written.
+ */
+export interface TemplateMarkers {
+    /** Section names with both an opening and a closing marker, in document order. */
+    sections: string[];
+    /** `{{NAME}}` placeholders found anywhere in the template. */
+    placeholders: string[];
+}
+/** Find the markers in a template body (HTML, or the plain text Outlook derives from it). */
+export declare function findTemplateMarkers(body: string): TemplateMarkers;
+/** Replace every occurrence of `token` with `value`, which is never rescanned. */
+export declare function replaceToken(html: string, token: string, value: string): string;
+/**
+ * Remove `token` together 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 and a heading with nothing under it.
+ * Falls back to deleting just the token when it isn't inside a line element.
+ */
+export declare function removeTokenLine(html: string, token: string): string;
+/** Which of `tokens` the template actually uses — what the caller has to supply. */
+export declare function findTokens(html: string, tokens: readonly string[]): string[];
+/**
+ * `{Token}`-shaped text still in a filled-in body: a placeholder misspelled
+ * while editing, or one nothing supplied. Reads visible text only, so the
+ * braces of a <style> block are not mistaken for placeholders. Catches a
+ * leftover `{{TOKEN}}` too, reported by its inner `{TOKEN}`.
+ */
+export declare function findUnfilledTokens(html: string): string[];
+export interface ComposeOptions {
+    /** Section to keep; the other sections are dropped with their markers. */
+    section?: string;
+    /** `{{NAME}}` → HTML to substitute. Names match case-insensitively. */
+    placeholders?: Readonly<Record<string, string>>;
+    /** The template's name, for error messages. */
+    label?: string;
+}
+/**
+ * Reduce a template body to the one email that goes out: keep `section`, drop
+ * the rest, fill the placeholders. Throws INVALID_REQUEST rather than guessing —
+ * a template edited into an unusable state has to stop the send, not deliver a
+ * body with `[[ACCEPT]]` or an unfilled placeholder in it.
+ */
+export declare function composeTemplateBody(html: string, options?: ComposeOptions): string;