@odla-ai/chapter 0.59.1 → 0.61.0

package/README.md

@@ -1622,13 +1622,44 @@ These bite silently — a smoke test won't catch them:
   | `meetUrl`, `htmlLink` | `prepEmail` | the booked meeting's Google Meet and calendar links (blank when the provider returned none) |
   | `meetingTime`, `meetingLink` | `prepEmail` | aliases of `startAt` and `meetUrl` (falling back to `htmlLink`) for copy written before those existed |
   | `adminUrl`, `membersUrl` | `adminNotification`, `submitConfirmation`, `onboardingInvite` | `<origin>/admin/` and `<origin>/members/` from the request that fired the send |
+  | `namedSeat`, `namedSeatRecipientName` | `adminNotification`, `submitConfirmation`, `paymentConfirmation`, `prepEmail`, `onboardingInvite` | `paid` or `included` when the frozen checkout carries a gift seat for another person, else blank (so `{{#namedSeat}}` hides); the recipient's name as entered at checkout. A host event reads the same values through `checkoutVariables` |
   | `refundPolicyText`, `commitmentText`, `normsText` | all | the group row's policy copy |
 
+  **Sections and an HTML body.** `{{#name}} … {{/name}}` keeps its contents
+  only when `name` has a value, so a line such as
+  `{{#namedSeat}}Your gift for {{namedSeatRecipientName}} is paid.{{/namedSeat}}`
+  appears for gift buyers alone; a section on its own line disappears with
+  its line. The event must supply a section's name like any variable, and an
+  unclosed section blocks the send. A template may also carry an `html`
+  body (Settings → Email, under the plain body) with the same placeholders
+  and sections: values are escaped, a line break inside a value becomes a
+  `<br>`, the text body is still sent as the plain alternative and recorded
+  in the log, and an unknown placeholder in the HTML blocks the send like
+  one in the text. Without an `html` body the text is rendered to HTML by
+  `textToHtml`.
+
   **From display name.** `emails.fromName` (seeded to the group row, editable
   in Settings → Email) turns the From header into `{ name, email }` —
   `Tori Horton <tori@…>` in an inbox — while the address stays the Worker's
   `EMAIL_FROM`. A group with no name sends the bare address exactly as before.
 
+  **Deliverability.** Every send carries the text part verbatim and an HTML
+  alternative rendered from it by `textToHtml` (paragraphs, line breaks, and
+  each https address as a link labelled with itself) — multipart like mail from
+  any mainstream sender, with nothing the text lacks. Recipient-facing events
+  (every audience except the administrator's) also carry a List-Unsubscribe
+  header pointing at the group's reply-to as a mailto link, so a reader who
+  wants out writes to you instead of reporting spam. Set the notify deps'
+  render hook to `false` for text-only mail, or pass your own renderer. The
+  Email page lists spam-filter signals beside each template — shouting or
+  over-punctuated subjects, trigger phrases, insecure or development-host
+  links, shorteners, link-only bodies — and beside the sender (a no-reply
+  From, a Reply-To on another domain); `emailSpamSignals` and
+  `emailSenderWarnings` are the same checks for a script, and the save route
+  returns them. Warnings never block a send. Authentication (SPF, DKIM, DMARC)
+  belongs to Cloudflare Email Service: onboard the sending domain in the
+  Cloudflare dashboard and it adds the records.
+
   **Re-check this on every chapter upgrade.** Wiring a send changes a site's
   outbound mail with no local diff — release notes call out send changes
   explicitly for that reason.

package/dist/{chunk-P6X3W2XP.js → chunk-24L7FANC.js}

@@ -4,7 +4,7 @@ import {
   DEFAULT_CHAPTER_COPY,
   formatChapterCopy,
   useChapterCopy
-} from "./chunk-GADLTNJF.js";
+} from "./chunk-PKVHXKGJ.js";
 
 // src/ui/admin.tsx
 import { useEffect as useEffect12, useMemo as useMemo3, useRef as useRef3, useState as useState27 } from "preact/hooks";
@@ -2739,6 +2739,11 @@ function EmailBody({ ctx }) {
           " ready"
         ] }),
         data.validation.issues.length ? /* @__PURE__ */ jsx29("ul", { role: "alert", children: data.validation.issues.map((issue, i) => /* @__PURE__ */ jsx29("li", { children: issue.message }, i)) }) : null,
+        data.validation.warnings?.length ? /* @__PURE__ */ jsx29("ul", { children: data.validation.warnings.map((warning, i) => /* @__PURE__ */ jsxs27("li", { children: [
+          copy.spamRisk,
+          ": ",
+          warning.message
+        ] }, i)) }) : null,
         draft ? /* @__PURE__ */ jsx29("p", { role: "status", children: "Save your changes to refresh these checks." }) : /* @__PURE__ */ jsxs27("p", { className: "muted", children: [
           "Checked ",
           new Date(data.validation.checkedAt).toLocaleString()
@@ -2773,9 +2778,15 @@ function EmailBody({ ctx }) {
           "."
         ] }),
         event.issues.length ? /* @__PURE__ */ jsx29("ul", { children: event.issues.map((issue, i) => /* @__PURE__ */ jsx29("li", { children: issue.message }, i)) }) : null,
+        event.warnings?.length ? /* @__PURE__ */ jsx29("ul", { className: "muted", children: event.warnings.map((warning, i) => /* @__PURE__ */ jsxs27("li", { children: [
+          copy.spamRisk,
+          ": ",
+          warning.message
+        ] }, i)) }) : null,
         /* @__PURE__ */ jsx29(Checkbox2, { label: copy.enabled, checked: t.enabled === true, onChange: (e) => editTemplate(key, { enabled: e.target.checked }) }),
         /* @__PURE__ */ jsx29(Field13, { label: copy.subject, children: /* @__PURE__ */ jsx29(Input6, { value: t.subject, onInput: (e) => editTemplate(key, { subject: e.target.value }) }) }),
         /* @__PURE__ */ jsx29(Field13, { label: copy.body, children: /* @__PURE__ */ jsx29(Textarea5, { prose: true, rows: 5, value: t.text, onInput: (e) => editTemplate(key, { text: e.target.value }) }) }),
+        /* @__PURE__ */ jsx29(Field13, { label: copy.htmlBody, hint: copy.htmlBodyHint, children: /* @__PURE__ */ jsx29(Textarea5, { rows: 6, value: t.html ?? "", onInput: (e) => editTemplate(key, { html: e.target.value }) }) }),
         /* @__PURE__ */ jsxs27("p", { className: "muted", children: [
           "Available values: ",
           event.variables.map((name) => `{{${name}}}`).join(", ")
@@ -3875,4 +3886,4 @@ export {
   MembershipDisputes,
   MembershipPolicyVersions
 };
-//# sourceMappingURL=chunk-P6X3W2XP.js.map
+//# sourceMappingURL=chunk-24L7FANC.js.map