@dawnlit/outlook-bridge 1.1.1 → 2.0.0

package/dist/{outlookTemplateSections.js → templateBody.js}

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

package/dist/templateBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateBody.js","sourceRoot":"","sources":["../src/templateBody.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Sections and placeholders in HTML email templates.\n *\n * A template email is an ordinary saved mail its owner edits in Outlook, so the\n * greeting, closing and signature stay theirs. Where one template serves several\n * kinds of reply, the variants live inside it between markers:\n *\n *     Hello,\n *     [[ACCEPT]]    Thank you — we accept...            [[/ACCEPT]]\n *     [[DECLINE]]   Thank you for letting us know...    [[/DECLINE]]\n *     [[CLARIFY]]   {{QUESTIONS}}                       [[/CLARIFY]]\n *     Best regards, {{SIGNATURE}}\n *\n * Composing keeps the requested section, drops the others, and substitutes the\n * `{{PLACEHOLDER}}`s — so shared wording is written once and a caller names a\n * section instead of carrying the whole body.\n *\n * Everything works on the raw HTML string rather than a parsed tree: Word's\n * markup carries conditional comments and namespaced tags a parser round-trip\n * would rewrite, and the composed body must stay byte-identical to what was\n * written.\n */\n\nimport { InvalidRequestError } from './errors';\n\n/** Marker and placeholder names: what a person can reasonably type in Outlook. */\nconst NAME = '[A-Za-z0-9_-]{1,40}';\n\n/**\n * What Word may inject *between two characters of a marker*: tags (it splits\n * runs across <span>s freely), comments, non-breaking spaces, and the newlines\n * it wraps long lines with — sometimes mid-word. So `[[ACCEPT]]` is matched\n * character by character with this between, never as a literal string.\n */\nconst GAP = '(?:<!--[\\\\s\\\\S]*?-->|<[^>]*>|&nbsp;|&#160;|\\\\s)*';\n\n/** Block elements a marker can sit alone inside; the whole block goes when it does. */\nconst BLOCK_TAGS = ['p', 'div', 'li'];\n\n/**\n * Block elements that make up one *line* of a template, for a token whose\n * empty value takes its whole line out (see `removeTokenLine`). Outermost\n * first: Word puts a <p> inside every table cell, so a token in a details table\n * has to drop the <tr> — dropping the <p> would leave the row's label beside a\n * blank cell.\n *\n * <div> is deliberately absent: it is rarely a line and often the wrapper around\n * the entire body, so a token directly inside one would take the whole email\n * with it. Deleting just the token is the safer miss.\n */\nconst LINE_TAGS = ['tr', 'li', 'p'];\n\nfunction escapeRe(s: string): string {\n    return s.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/**\n * Tag-tolerant matcher for one literal token, e.g. `[[/ACCEPT]]` or `{{QUESTIONS}}`.\n *\n * Memoized: the pattern interleaves `GAP` between every character, so a short\n * token compiles to hundreds of characters, and the replace loops ask for the\n * same token repeatedly while walking a template.\n */\nconst markerRegexCache = new Map<string, RegExp>();\n\nfunction markerRegex(token: string): RegExp {\n    let regex = markerRegexCache.get(token);\n    if (!regex) {\n        regex = new RegExp(token.split('').map(escapeRe).join(GAP), 'i');\n        markerRegexCache.set(token, regex);\n    }\n    return regex;\n}\n\n/** HTML → rough plain text, enough to spot markers and test a block for emptiness. */\nfunction stripToText(html: string): string {\n    return html\n        .replace(/<!--[\\s\\S]*?-->/g, '')\n        .replace(/<[^>]*>/g, '')\n        .replace(/&nbsp;|&#160;/gi, ' ');\n}\n\nexport interface TemplateMarkers {\n    /** Section names with both an opening and a closing marker, in document order. */\n    sections: string[];\n    /** `{{NAME}}` placeholders found anywhere in the template. */\n    placeholders: string[];\n}\n\n/** Find the markers in a template body (HTML, or the plain text Outlook derives from it). */\nexport function findTemplateMarkers(body: string): TemplateMarkers {\n    const text = stripToText(body || '');\n    const opened: string[] = [];\n    const closed = new Set<string>();\n    const seen = new Set<string>();\n    const sectionRe = new RegExp(`\\\\[\\\\[\\\\s*(/?)\\\\s*(${NAME})\\\\s*\\\\]\\\\]`, 'g');\n    let m: RegExpExecArray | null;\n    while ((m = sectionRe.exec(text)) !== null) {\n        const name = m[2].toUpperCase();\n        if (m[1]) {\n            closed.add(name);\n        } else if (!seen.has(name)) {\n            seen.add(name);\n            opened.push(name);\n        }\n    }\n    const placeholders: string[] = [];\n    const placeholderRe = new RegExp(`\\\\{\\\\{\\\\s*(${NAME})\\\\s*\\\\}\\\\}`, 'g');\n    while ((m = placeholderRe.exec(text)) !== null) {\n        const name = m[1].toUpperCase();\n        if (!placeholders.includes(name)) placeholders.push(name);\n    }\n    return {sections: opened.filter(n => closed.has(n)), placeholders};\n}\n\n/**\n * Every `[[...]]` / `{{...}}` token still in a body, paired or not — the last\n * check before a composed body goes out, so a half-deleted marker stops the\n * send instead of reaching a recipient.\n */\nfunction markerTokens(body: string): string[] {\n    const text = stripToText(body || '');\n    const re = new RegExp(`\\\\[\\\\[\\\\s*/?\\\\s*${NAME}\\\\s*\\\\]\\\\]|\\\\{\\\\{\\\\s*${NAME}\\\\s*\\\\}\\\\}`, 'g');\n    const found: string[] = [];\n    let m: RegExpExecArray | null;\n    while ((m = re.exec(text)) !== null) {\n        const token = m[0].replace(/\\s+/g, '');\n        if (!found.includes(token)) found.push(token);\n    }\n    return found;\n}\n\ninterface Span {\n    start: number;\n    end: number;\n}\n\n/**\n * The nearest enclosing block element of [start, end), or null when the marker\n * isn't inside one. The closing tag is the first of the same name after the\n * marker — Word doesn't nest <p>, and where that guess is wrong the emptiness\n * test simply fails and the caller falls back to the marker's own span.\n */\nfunction enclosingBlock(html: string, start: number, end: number, tags: string[] = BLOCK_TAGS): {\n    block: Span;\n    contentStart: number;\n    contentEnd: number;\n} | null {\n    let best: { idx: number; contentStart: number; tag: string } | null = null;\n    for (const tag of tags) {\n        const openRe = new RegExp(`<${tag}(?:\\\\s[^>]*)?>`, 'gi');\n        let m: RegExpExecArray | null;\n        while ((m = openRe.exec(html)) !== null) {\n            if (m.index >= start) break;\n            if (!best || m.index > best.idx) {\n                best = {idx: m.index, contentStart: m.index + m[0].length, tag};\n            }\n        }\n    }\n    if (!best) return null;\n    const closeRe = new RegExp(`</${best.tag}\\\\s*>`, 'gi');\n    closeRe.lastIndex = end;\n    const close = closeRe.exec(html);\n    if (!close) return null;\n    return {\n        block: {start: best.idx, end: close.index + close[0].length},\n        contentStart: best.contentStart,\n        contentEnd: close.index,\n    };\n}\n\n/**\n * What to delete for a marker: its whole paragraph when the marker is alone in\n * it (removing only the text would leave a blank line), else just the marker.\n */\nfunction markerSpan(html: string, start: number, end: number): Span {\n    const found = enclosingBlock(html, start, end);\n    if (!found || found.contentStart > start || found.contentEnd < end) return {start, end};\n    const rest = html.slice(found.contentStart, start) + html.slice(end, found.contentEnd);\n    return stripToText(rest).trim() === '' ? found.block : {start, end};\n}\n\nfunction locate(html: string, token: string): Span | null {\n    const m = markerRegex(token).exec(html);\n    return m ? {start: m.index, end: m.index + m[0].length} : null;\n}\n\n// ── Single-token fill ───────────────────────────────────────────────────\n//\n// The section machinery above is for templates holding several variants of\n// one email. These are for the simpler case: fixed wording with details typed\n// elsewhere and dropped into tokens of the caller's own choosing (`{Name}`,\n// `%NAME%`, …). Same tag-tolerant matching, since these templates are edited in\n// Outlook too.\n\n/** Replace every occurrence of `token` with `value`, which is never rescanned. */\nexport function replaceToken(html: string, token: string, value: string): string {\n    let done = '';\n    let rest = html;\n    for (; ;) {\n        const at = locate(rest, token);\n        if (!at) return done + rest;\n        done += rest.slice(0, at.start) + value;\n        rest = rest.slice(at.end);\n    }\n}\n\n/**\n * Remove `token` together with the line it sits on — the table row or\n * paragraph, label included. For an optional detail this is the difference\n * between the email not mentioning it and a heading with nothing under it.\n * Falls back to deleting just the token when it isn't inside a line element.\n */\nexport function removeTokenLine(html: string, token: string): string {\n    let out = html;\n    for (; ;) {\n        const at = locate(out, token);\n        if (!at) return out;\n        const cut = lineSpan(out, at);\n        out = out.slice(0, cut.start) + out.slice(cut.end);\n    }\n}\n\n/**\n * The line to delete for a token at `at`: its enclosing row or paragraph, or\n * the token's own span when it isn't in one.\n *\n * `enclosingBlock` returns the *nearest* opening tag before the token, which is\n * only the enclosing one if it hasn't been closed already — a token in a\n * paragraph after a table has a `<tr>` before it and a `</tr>` after it without\n * being inside a row, and taking that span would delete the table.\n */\nfunction lineSpan(html: string, at: Span): Span {\n    for (const tag of LINE_TAGS) {\n        const found = enclosingBlock(html, at.start, at.end, [tag]);\n        if (!found) continue;\n        const closedBefore = new RegExp(`</${tag}\\\\s*>`, 'i').test(html.slice(found.contentStart, at.start));\n        if (!closedBefore) return found.block;\n    }\n    return at;\n}\n\n/** Which of `tokens` the template actually uses — what the caller has to supply. */\nexport function findTokens(html: string, tokens: readonly string[]): string[] {\n    const text = stripToText(html || '');\n    return tokens.filter(token => markerRegex(token).test(text));\n}\n\n/**\n * `{Token}`-shaped text still in a filled-in body: a placeholder misspelled\n * while editing, or one nothing supplied. Reads visible text only, so the\n * braces of a <style> block are not mistaken for placeholders. Catches a\n * leftover `{{TOKEN}}` too, reported by its inner `{TOKEN}`.\n */\nexport function findUnfilledTokens(html: string): string[] {\n    const text = stripToText((html || '').replace(/<(style|script)\\b[^>]*>[\\s\\S]*?<\\/\\1>/gi, ''));\n    const found: string[] = [];\n    const re = /\\{\\s*([A-Za-z][A-Za-z0-9 _-]{0,30})\\s*\\}/g;\n    let m: RegExpExecArray | null;\n    while ((m = re.exec(text)) !== null) {\n        const token = `{${m[1].trim()}}`;\n        if (!found.includes(token)) found.push(token);\n    }\n    return found;\n}\n\nexport interface ComposeOptions {\n    /** Section to keep; the other sections are dropped with their markers. */\n    section?: string;\n    /** `{{NAME}}` → HTML to substitute. Names match case-insensitively. */\n    placeholders?: Readonly<Record<string, string>>;\n    /** The template's name, for error messages. */\n    label?: string;\n}\n\n/**\n * Reduce a template body to the one email that goes out: keep `section`, drop\n * the rest, fill the placeholders. Throws INVALID_REQUEST rather than guessing —\n * a template edited into an unusable state has to stop the send, not deliver a\n * body with `[[ACCEPT]]` or an unfilled placeholder in it.\n */\nexport function composeTemplateBody(html: string, options: ComposeOptions = {}): string {\n    const label = options.label ? `Template '${options.label}'` : 'The template';\n    const wanted = (options.section || '').trim().toUpperCase();\n    const {sections, placeholders: available} = findTemplateMarkers(html);\n\n    if (wanted && !sections.includes(wanted)) {\n        throw new InvalidRequestError(\n            sections.length\n                ? `${label} has no [[${wanted}]] section. Sections found: ${sections.join(', ')}.`\n                : `${label} has no [[${wanted}]]...[[/${wanted}]] markers — it holds a single body, so name no section (or add the markers to the template).`,\n        );\n    }\n    if (!wanted && sections.length) {\n        throw new InvalidRequestError(\n            `${label} is split into sections (${sections.join(', ')}); name the one to send, `\n            + 'otherwise the email would go out with every variant and the markers in it.',\n        );\n    }\n\n    // Deletions are collected first and applied right to left, so each span's\n    // offsets still refer to the string they were measured against.\n    const cuts: Span[] = [];\n    for (const name of sections) {\n        const open = locate(html, `[[${name}]]`);\n        const close = locate(html, `[[/${name}]]`);\n        if (!open || !close || close.start < open.end) {\n            throw new InvalidRequestError(`${label} has a malformed [[${name}]] section — expected [[${name}]] ... [[/${name}]] in that order.`);\n        }\n        const openSpan = markerSpan(html, open.start, open.end);\n        const closeSpan = markerSpan(html, close.start, close.end);\n        if (name === wanted) {\n            cuts.push(openSpan, closeSpan); // keep the content, shed the markers\n        } else {\n            cuts.push({start: openSpan.start, end: closeSpan.end});\n        }\n    }\n    let out = html;\n    for (const cut of cuts.sort((a, b) => b.start - a.start)) {\n        out = out.slice(0, cut.start) + out.slice(cut.end);\n    }\n\n    for (const [rawKey, value] of Object.entries(options.placeholders || {})) {\n        const key = rawKey.trim().toUpperCase();\n        if (!available.includes(key)) {\n            throw new InvalidRequestError(\n                `${label} has no {{${key}}} placeholder`\n                + (available.length ? ` (found: ${available.map(p => `{{${p}}}`).join(', ')}).` : '.')\n                + ' It may have been removed when the template was last edited.',\n            );\n        }\n        const m = markerRegex(`{{${key}}}`).exec(out);\n        // In the template but gone from `out` means it lived in a dropped\n        // section: the caller supplying more than one variant needs, not an error.\n        if (m) out = out.slice(0, m.index) + (value ?? '') + out.slice(m.index + m[0].length);\n    }\n\n    const leftover = markerTokens(out);\n    if (leftover.length) {\n        const hint = leftover.every(t => t.startsWith('{{'))\n            ? 'Supply a value for each placeholder.'\n            : 'Check the template — every [[SECTION]] needs its [[/SECTION]].';\n        throw new InvalidRequestError(\n            `${label} still contains unresolved markers after composing: ${leftover.join(', ')}. ${hint} Nothing was created.`,\n        );\n    }\n    return out;\n}\n"]}