@reddoorla/maintenance 0.6.8 → 0.7.0

package/dist/index.js

@@ -1923,6 +1923,638 @@ function fromJsonFile(path) {
     return validate(raw);
   };
 }
+
+// src/reports/draft.ts
+import { mkdir, writeFile as writeFile9 } from "fs/promises";
+import { dirname as dirname2 } from "path";
+
+// src/reports/render.ts
+import mjml2html from "mjml";
+
+// src/reports/maintenance-email/template.ts
+var CHECK_PNG = "https://d3eq0h5l8sxf6t.cloudfront.net/maintenance-email/check.png";
+var BLURRED_TESTS = "https://d3eq0h5l8sxf6t.cloudfront.net/maintenance-email/blurredTests.jpg";
+function fmtDate(d) {
+  if (!d) return "";
+  const mm = String(d.getUTCMonth() + 1).padStart(2, "0");
+  const dd = String(d.getUTCDate()).padStart(2, "0");
+  const yyyy = d.getUTCFullYear();
+  return `${mm}.${dd}.${yyyy}`;
+}
+function fmtUsers(n) {
+  return n.toLocaleString("en-US");
+}
+function maintenanceChecksSection() {
+  const rows = [
+    "Reviewed Logs",
+    "CMS Checked",
+    "DNS Checked",
+    "Google Indexed",
+    "Reviewed Certificate",
+    "Security Updates"
+  ];
+  return rows.map(
+    (label, i) => `
+    <mj-section background-color="white" padding="0px"${i === rows.length - 1 ? ' padding-bottom="36px"' : ""}>
+      <mj-group>
+        <mj-column padding-left="0px" width="90%"${i < rows.length - 1 ? ' border-bottom="solid #CCCCCC 1px"' : ""}>
+          <mj-text height="25px" padding-left="0px" color="#757575" padding-top="20px" padding-bottom="7.5px" font-size="16px">${label}</mj-text>
+        </mj-column>
+        <mj-column width="10%"${i < rows.length - 1 ? ' border-bottom="solid #CCCCCC 1px"' : ""} padding-top="15px">
+          <mj-image align="right" padding-right="0px" width="20px" height="20px" padding-top="2.5px" padding-bottom="15px" src="${CHECK_PNG}" />
+        </mj-column>
+      </mj-group>
+    </mj-section>`
+  ).join("");
+}
+function testingChecklistSection() {
+  const rows = [
+    "Desktop Browsers",
+    "Mobile Browsers",
+    "Package Updates",
+    "Bottlenecks",
+    "Form Functionality",
+    "Animation Functionality"
+  ];
+  return rows.map(
+    (label, i) => `
+    <mj-section background-color="#F4F4F4" padding="0px"${i === rows.length - 1 ? ' padding-bottom="60px"' : ""}>
+      <mj-group>
+        <mj-column width="90%" padding-left="0px"${i < rows.length - 1 ? ' border-bottom="solid #CCCCCC 1px"' : ""}>
+          <mj-text height="25px" padding-left="0px" color="#757575" padding-top="20px" padding-bottom="7.5px" font-size="16px">${label}</mj-text>
+        </mj-column>
+        <mj-column width="10%"${i < rows.length - 1 ? ' border-bottom="solid #CCCCCC 1px"' : ""} padding-top="15px">
+          <mj-image align="right" padding-right="0px" width="20px" height="20px" padding-top="2.5px" padding-bottom="15px" src="${CHECK_PNG}" />
+        </mj-column>
+      </mj-group>
+    </mj-section>`
+  ).join("");
+}
+function maintenanceTestingPlaceholder(lastTested) {
+  return `
+    <mj-section background-color="#F4F4F4">
+      <mj-column>
+        <mj-image href="mailto:info@reddoorla.com" src="${BLURRED_TESTS}" />
+      </mj-column>
+    </mj-section>
+    <mj-section background-color="#F4F4F4" padding-top="0px">
+      <mj-column>
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="16px" font-weight="300" line-height="24px">Last Tested: ${fmtDate(lastTested)}</mj-text>
+      </mj-column>
+    </mj-section>`;
+}
+function testingIntroSection() {
+  return `
+    <mj-section background-color="#F4F4F4">
+      <mj-column>
+        <mj-text color="#C00" font-size="20px" font-weight="700" padding-top="75px">TESTING</mj-text>
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="16px" font-weight="300" line-height="24px">Testing includes checks similar to those at launch: testing on common browsers and operating systems, at different screen sizes, and checking every function, and updating all packages for performance rather than just those needed for security.</mj-text>
+      </mj-column>
+    </mj-section>`;
+}
+function commentarySection(text) {
+  return `
+    <mj-section background-color="white">
+      <mj-column>
+        <mj-text color="#C00" font-size="20px" font-weight="700" padding-top="55px">NOTES</mj-text>
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="16px" font-weight="300" line-height="24px">${text.replace(/\n/g, "<br/>")}</mj-text>
+      </mj-column>
+    </mj-section>`;
+}
+function buildMjml(data) {
+  const isTesting = data.reportType === "Testing";
+  const headerSrc = `cid:${data.headerImageCid}`;
+  const previewText = `Checked up on ${data.siteName}`;
+  return `<mjml>
+  <mj-head>
+    <mj-attributes>
+      <mj-text font-family="helvetica, sans-serif" padding-left="5px" padding-right="5px" />
+      <mj-section padding-left="11%" padding-right="11%"/>
+      <mj-image padding="0px" />
+    </mj-attributes>
+    <mj-preview>${previewText}</mj-preview>
+  </mj-head>
+  <mj-body background-color="white">
+    <mj-section background-color="#F4F4F4" padding-top="0px" padding-bottom="0px" padding-left="0px" padding-right="0px">
+      <mj-column>
+        <mj-image href="${data.siteUrl}" src="${headerSrc}" />
+      </mj-column>
+    </mj-section>
+    <mj-section background-color="white">
+      <mj-column>
+        <mj-text color="#C00" font-size="20px" font-weight="700" padding-top="75px">COMPLETED ON</mj-text>
+        <mj-text color="#C00" font-size="44px" font-weight="400">${fmtDate(data.completedOn)}</mj-text>
+        <mj-text color="#C00" font-size="20px" font-weight="700" padding-top="75px">MAINTENANCE CHECKS</mj-text>
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="16px" font-weight="300" line-height="24px">Includes checking the hosting, DNS, Content Management System (CMS, if applicable), search indexing and security of the site for major flaws and updating as necessary.</mj-text>
+      </mj-column>
+    </mj-section>
+    ${maintenanceChecksSection()}
+    <mj-section background-color="#F4F4F4">
+      <mj-column>
+        <mj-text color="#C00" font-size="20px" font-weight="700" padding-top="55px">LIGHTHOUSE SCORES*</mj-text>
+        <mj-text color="#C00" font-size="20px" font-weight="300" padding-top="25px">Performance</mj-text>
+        <mj-text color="#C00" font-size="44px" font-weight="400" padding-top="0px">${data.lighthouse.performance}</mj-text>
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="12px" font-weight="300" padding-top="0px" padding-bottom="36px">Acceptable 50\u201389 // Ideal 90\u2013100</mj-text>
+        <mj-divider border-width="1px" border-style="solid" border-color="#CCCCCC" padding="0" />
+        <mj-text color="#C00" font-size="20px" font-weight="300" padding-top="25px">Readability</mj-text>
+        <mj-text color="#C00" font-size="44px" font-weight="400" padding-top="0px">${data.lighthouse.accessibility}</mj-text>
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="12px" font-weight="300" padding-top="0px" padding-bottom="36px">Acceptable 80\u201399 // Ideal 100</mj-text>
+        <mj-divider border-width="1px" border-style="solid" border-color="#CCCCCC" padding="0" />
+        <mj-text color="#C00" font-size="20px" font-weight="300" padding-top="25px">Best Practices</mj-text>
+        <mj-text color="#C00" font-size="44px" font-weight="400" padding-top="0px">${data.lighthouse.bestPractices}</mj-text>
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="12px" font-weight="300" padding-top="0px" padding-bottom="36px">Acceptable 60\u201379 // Ideal 80\u201392</mj-text>
+        <mj-divider border-width="1px" border-style="solid" border-color="#CCCCCC" padding="0" />
+        <mj-text color="#C00" font-size="20px" font-weight="300" padding-top="25px">Site Structure</mj-text>
+        <mj-text color="#C00" font-size="44px" font-weight="400" padding-top="0px">${data.lighthouse.seo}</mj-text>
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="12px" font-weight="300" padding-top="0px" padding-bottom="36px">Acceptable 50\u201389 // Ideal 90\u2013100</mj-text>
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="12px" font-weight="300" padding-top="24px" padding-bottom="36px" line-height="20px">*A Lighthouse score is a numerical measure provided by Google's Lighthouse tool, which evaluates various aspects of a web page's quality.</mj-text>
+      </mj-column>
+    </mj-section>
+    <mj-section background-color="white">
+      <mj-column>
+        <mj-text color="#C00" font-size="20px" font-weight="700" padding-top="75px">ANALYTICS</mj-text>
+        <mj-text color="#C00" font-size="44px" font-weight="400">${fmtUsers(data.gaUsersCurrent)} Users</mj-text>
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="16px" font-weight="300" line-height="24px">Last Period: ${fmtUsers(data.gaUsersPrevious)}</mj-text>
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="12px" font-weight="300" padding-top="24px" padding-bottom="36px" line-height="20px">Contact us if you are interested in more in-depth data or have questions about SEO.</mj-text>
+      </mj-column>
+    </mj-section>
+    ${isTesting ? testingIntroSection() + testingChecklistSection() : maintenanceTestingPlaceholder(data.lastTestedDate)}
+    ${data.commentary ? commentarySection(data.commentary) : ""}
+    <mj-section background-color="white">
+      <mj-column padding-top="36px">
+        <mj-text color="#C00" font-family="helvetica, sans-serif" font-size="24px" font-weight="700" padding-top="36px" line-height="36px">Any questions, concerns or requests?</mj-text>
+        <mj-text font-family="helvetica, sans-serif" font-size="24px" font-weight="300" line-height="30px">Just hit reply.</mj-text>
+        <mj-text font-family="helvetica, sans-serif" font-size="24px" font-weight="300" padding-top="0px" line-height="30px" padding-bottom="36px">We're here to help in any way we can.</mj-text>
+        <mj-divider border-width="1px" border-style="solid" border-color="#CCCCCC" padding="0" />
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="12px" font-weight="300" padding-top="24px" line-height="20px" font-style="italic">Copyright ${(/* @__PURE__ */ new Date()).getFullYear()} Reddoor Creative, LLC. All rights reserved.</mj-text>
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="12px" font-weight="700" line-height="16px" padding-top="0" padding-bottom="0px">Our mailing address is:</mj-text>
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="12px" font-weight="300" line-height="16px" padding-top="0" padding-bottom="0px">Reddoor Creative, LLC</mj-text>
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="12px" font-weight="300" line-height="16px" padding-top="0" padding-bottom="0px">29027 Dapper Dan</mj-text>
+        <mj-text color="#757575" font-family="helvetica, sans-serif" font-size="12px" font-weight="300" line-height="16px" padding-top="0" padding-bottom="0px">Fair Oaks Ranch, TX 78015</mj-text>
+      </mj-column>
+    </mj-section>
+  </mj-body>
+</mjml>`;
+}
+
+// src/reports/render.ts
+async function renderReportHtml(data) {
+  const mjml = buildMjml(data);
+  const out = await mjml2html(mjml, { validationLevel: "strict" });
+  return { html: out.html, warnings: out.errors ?? [] };
+}
+
+// src/reports/airtable/websites.ts
+var WEBSITES_TABLE = "Websites";
+function siteSlug(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+function mapRow(rec) {
+  const f = rec.fields;
+  const attachments = f["Header image"] ?? [];
+  const header = attachments[0] ?? null;
+  return {
+    id: rec.id,
+    name: String(f["Name"] ?? ""),
+    url: String(f["url"] ?? ""),
+    pointOfContact: f["point of contact"] ?? null,
+    maintenanceFreq: f["maintenence freq"] ?? "None",
+    testingFreq: f["testing freq"] ?? "None",
+    maintenanceDay: f["maintenance day"] ?? null,
+    testingDay: f["testing day"] ?? null,
+    ga4PropertyId: f["GA4 property ID"] ?? null,
+    reportRecipientsTo: f["Report recipients (To)"] ?? null,
+    reportRecipientsCc: f["Report recipients (CC)"] ?? null,
+    headerImage: header,
+    pScore: f["pScore"] ?? null,
+    rScore: f["rScore"] ?? null,
+    bpScore: f["bpScore"] ?? null,
+    seoScore: f["seoScore"] ?? null
+  };
+}
+async function listWebsites(base) {
+  const out = [];
+  await base(WEBSITES_TABLE).select({ pageSize: 100 }).eachPage((records, fetchNextPage) => {
+    for (const rec of records) out.push(mapRow({ id: rec.id, fields: rec.fields }));
+    fetchNextPage();
+  });
+  return out;
+}
+
+// src/reports/airtable/reports.ts
+var REPORTS_TABLE = "Reports";
+function mapRow2(rec) {
+  const f = rec.fields;
+  const linkSites = f["Site"] ?? [];
+  const html = (f["Rendered HTML"] ?? [])[0] ?? null;
+  return {
+    id: rec.id,
+    reportId: String(f["Report ID"] ?? ""),
+    siteId: linkSites[0] ?? "",
+    reportType: f["Report type"] ?? "Maintenance",
+    periodStart: f["Period start"] ?? null,
+    periodEnd: f["Period end"] ?? null,
+    completedOn: f["Completed on"] ?? null,
+    lighthouse: lighthouseFromFields(f),
+    gaUsersCurrent: f["GA users (period)"] ?? null,
+    gaUsersPrevious: f["GA users (prev period)"] ?? null,
+    lastTestedDate: f["Last tested date"] ?? null,
+    commentary: f["Commentary"] ?? null,
+    subjectOverride: f["Subject override"] ?? null,
+    draftReady: Boolean(f["Draft ready"]),
+    approvedToSend: Boolean(f["Approved to send"]),
+    sentAt: f["Sent at"] ?? null,
+    deliveryStatus: f["Delivery status"] ?? "pending",
+    renderedHtmlAttachment: html,
+    resendMessageId: f["Resend message ID"] ?? null
+  };
+}
+function lighthouseFromFields(f) {
+  const p = f["Lighthouse \u2014 Performance"];
+  const a = f["Lighthouse \u2014 Accessibility"];
+  const b = f["Lighthouse \u2014 Best Practices"];
+  const s = f["Lighthouse \u2014 SEO"];
+  if (typeof p !== "number" || typeof a !== "number" || typeof b !== "number" || typeof s !== "number")
+    return null;
+  return { performance: p, accessibility: a, bestPractices: b, seo: s };
+}
+function ymd(d) {
+  return d.toISOString().slice(0, 10);
+}
+function escapeFormulaString(s) {
+  return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+async function createDraft(base, input) {
+  const fields = {
+    "Report ID": input.reportId,
+    Site: [input.siteId],
+    "Report type": input.reportType,
+    "Period start": ymd(input.periodStart),
+    "Period end": ymd(input.periodEnd),
+    "Completed on": ymd(input.completedOn),
+    "Lighthouse \u2014 Performance": input.lighthouse.performance,
+    "Lighthouse \u2014 Accessibility": input.lighthouse.accessibility,
+    "Lighthouse \u2014 Best Practices": input.lighthouse.bestPractices,
+    "Lighthouse \u2014 SEO": input.lighthouse.seo,
+    "Delivery status": "pending"
+  };
+  if (input.lastTestedDate) fields["Last tested date"] = ymd(input.lastTestedDate);
+  const created = await base(REPORTS_TABLE).create([{ fields }]);
+  const rec = created[0];
+  if (!rec) throw new Error("Airtable create returned no records");
+  return mapRow2({ id: rec.id, fields: rec.fields });
+}
+async function setDraftReady(base, recordId, ready) {
+  await base(REPORTS_TABLE).update([{ id: recordId, fields: { "Draft ready": ready } }]);
+}
+async function listSendableReports(base) {
+  const out = [];
+  await base(REPORTS_TABLE).select({
+    filterByFormula: "AND({Draft ready} = TRUE(), {Approved to send} = TRUE(), {Sent at} = BLANK())",
+    pageSize: 100
+  }).eachPage((records, fetchNextPage) => {
+    for (const rec of records) out.push(mapRow2({ id: rec.id, fields: rec.fields }));
+    fetchNextPage();
+  });
+  return out;
+}
+async function listReportsForSite(base, siteId) {
+  const safeId = escapeFormulaString(siteId);
+  const out = [];
+  await base(REPORTS_TABLE).select({
+    filterByFormula: `FIND(",${safeId},", "," & ARRAYJOIN({Site}, ",") & ",") > 0`,
+    pageSize: 100
+  }).eachPage((records, fetchNextPage) => {
+    for (const rec of records) out.push(mapRow2({ id: rec.id, fields: rec.fields }));
+    fetchNextPage();
+  });
+  return out;
+}
+async function stampSent(base, recordId, sentAt, messageId) {
+  await base(REPORTS_TABLE).update([
+    {
+      id: recordId,
+      fields: {
+        "Sent at": sentAt.toISOString(),
+        "Resend message ID": messageId
+      }
+    }
+  ]);
+}
+
+// src/reports/draft.ts
+function scoresFromWebsite(siteRow) {
+  const { pScore, rScore, bpScore, seoScore } = siteRow;
+  if (pScore === null || rScore === null || bpScore === null || seoScore === null) {
+    throw new Error(
+      `Site '${siteRow.name}' is missing one or more Lighthouse scores on the Websites row (pScore, rScore, bpScore, seoScore). Run 'reddoor-maint audit lighthouse' from the site's checkout and paste the four numbers into Airtable, then retry.`
+    );
+  }
+  return { performance: pScore, accessibility: rScore, bestPractices: bpScore, seo: seoScore };
+}
+function daysAgo(today, n) {
+  const out = new Date(today);
+  out.setDate(out.getDate() - n);
+  return out;
+}
+async function draftReportForSite(base, siteRow, reportType, options = {}) {
+  const scores = scoresFromWebsite(siteRow);
+  const today = /* @__PURE__ */ new Date();
+  const slug = siteSlug(siteRow.name);
+  const periodStart = base !== null ? await derivePeriodStart(base, siteRow, reportType, today) : daysAgo(today, 30);
+  const periodEnd = today;
+  const completedOn = today;
+  const lastTestedDate = reportType === "Maintenance" && siteRow.testingDay ? new Date(siteRow.testingDay) : null;
+  const cidName = `${slug}-header`;
+  const { html } = await renderReportHtml({
+    siteName: siteRow.name,
+    siteUrl: siteRow.url,
+    reportType,
+    completedOn,
+    lighthouse: scores,
+    gaUsersCurrent: 0,
+    gaUsersPrevious: 0,
+    lastTestedDate,
+    commentary: null,
+    headerImageCid: cidName
+  });
+  if (options.previewOnly) {
+    const path = options.previewPath ?? `reports/${slug}/draft.html`;
+    await mkdir(dirname2(path), { recursive: true });
+    await writeFile9(path, html, "utf-8");
+    return { reportRow: null, htmlPath: path, html };
+  }
+  if (base === null) throw new Error("base required when previewOnly=false");
+  const reportId = `${siteRow.name} \u2014 ${reportType} \u2014 ${periodEnd.toISOString().slice(0, 10)}`;
+  const created = await createDraft(base, {
+    reportId,
+    siteId: siteRow.id,
+    reportType,
+    periodStart,
+    periodEnd,
+    completedOn,
+    lighthouse: scores,
+    lastTestedDate
+  });
+  await uploadHtmlAttachment(created.id, html, slug, periodEnd);
+  await setDraftReady(base, created.id, true);
+  return { reportRow: created, htmlPath: null, html };
+}
+async function derivePeriodStart(base, siteRow, reportType, today) {
+  const prior = await listReportsForSite(base, siteRow.id);
+  const sameType = prior.filter((r) => r.reportType === reportType && r.periodEnd).map((r) => r.periodEnd).sort();
+  const latest = sameType[sameType.length - 1];
+  return latest ? new Date(latest) : daysAgo(today, 30);
+}
+async function uploadHtmlAttachment(recordId, html, slug, periodEnd) {
+  const apiKey = process.env.AIRTABLE_PAT;
+  const baseId = process.env.AIRTABLE_BASE_ID;
+  const filename = `${slug}-${periodEnd.toISOString().slice(0, 10)}.html`;
+  const body = {
+    contentType: "text/html",
+    file: Buffer.from(html, "utf-8").toString("base64"),
+    filename
+  };
+  const url = `https://content.airtable.com/v0/${baseId}/${recordId}/Rendered%20HTML/uploadAttachment`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(body)
+  });
+  if (!res.ok) {
+    throw new Error(`Airtable upload failed: ${res.status} ${res.statusText} ${await res.text()}`);
+  }
+}
+
+// src/reports/airtable/client.ts
+import Airtable from "airtable";
+function readAirtableConfig() {
+  const apiKey = process.env.AIRTABLE_PAT;
+  const baseId = process.env.AIRTABLE_BASE_ID;
+  if (!apiKey) throw Object.assign(new Error("AIRTABLE_PAT not set"), { exitCode: 2 });
+  if (!baseId) throw Object.assign(new Error("AIRTABLE_BASE_ID not set"), { exitCode: 2 });
+  return { apiKey, baseId };
+}
+function openBase(cfg) {
+  return new Airtable({ apiKey: cfg.apiKey }).base(cfg.baseId);
+}
+
+// src/reports/airtable/attachments.ts
+async function fetchAttachmentBytes(url) {
+  const res = await fetch(url);
+  if (!res.ok) {
+    throw new Error(
+      `Failed to fetch Airtable attachment ${res.status} ${res.statusText} (url=${url})`
+    );
+  }
+  const contentType = res.headers.get("content-type") ?? "application/octet-stream";
+  const ab = await res.arrayBuffer();
+  return { bytes: new Uint8Array(ab), contentType };
+}
+
+// src/reports/send/resend.ts
+import { Resend } from "resend";
+function defaultResendClient() {
+  const key = process.env.RESEND_API_KEY;
+  if (!key) throw Object.assign(new Error("RESEND_API_KEY not set"), { exitCode: 2 });
+  const resend = new Resend(key);
+  return {
+    async send(input) {
+      const payload = {
+        from: input.from,
+        to: input.to,
+        subject: input.subject,
+        html: input.html
+      };
+      if (input.cc) payload.cc = input.cc;
+      if (input.replyTo) payload.replyTo = input.replyTo;
+      if (input.attachments) payload.attachments = input.attachments;
+      const options = {};
+      if (input.idempotencyKey) options.idempotencyKey = input.idempotencyKey;
+      const { data, error } = await resend.emails.send(payload, options);
+      if (error) throw new Error(`Resend error: ${error.message}`);
+      if (!data?.id) throw new Error("Resend returned no message id");
+      return { messageId: data.id };
+    }
+  };
+}
+
+// src/reports/send/orchestrate.ts
+var FROM_ADDRESS = "Reddoor Reports <reports@reddoorla.com>";
+var REPLY_TO = "info@reddoorla.com";
+async function sendApprovedReports(options = {}) {
+  const base = openBase(readAirtableConfig());
+  const client = options.resend ?? defaultResendClient();
+  const sendable = await listSendableReports(base);
+  if (sendable.length === 0) return { output: "No reports ready to send.", code: 0 };
+  const websites = await listWebsites(base);
+  const sites = new Map(websites.map((w) => [w.id, w]));
+  const lines = [];
+  let anyFailed = false;
+  for (const report of sendable) {
+    const site = sites.get(report.siteId);
+    if (!site) {
+      lines.push(`\u2717 ${report.reportId} \u2014 Site row not found for id=${report.siteId}`);
+      anyFailed = true;
+      continue;
+    }
+    try {
+      const messageId = await sendOne(client, base, site, report);
+      lines.push(`\u2713 sent: ${report.reportId} (${messageId})`);
+    } catch (e) {
+      lines.push(`\u2717 ${report.reportId} \u2014 ${e.message}`);
+      anyFailed = true;
+    }
+  }
+  return { output: lines.join("\n"), code: anyFailed ? 1 : 0 };
+}
+async function sendOne(client, base, site, report) {
+  if (!site.headerImage) {
+    throw new Error(`Site '${site.name}' has no Header image set on the Websites row`);
+  }
+  if (!report.lighthouse) {
+    throw new Error(`Report ${report.reportId} has no Lighthouse scores`);
+  }
+  const { bytes, contentType } = await fetchAttachmentBytes(site.headerImage.url);
+  const slug = siteSlug(site.name);
+  const cidName = `${slug}-header`;
+  const { html } = await renderReportHtml({
+    siteName: site.name,
+    siteUrl: site.url,
+    reportType: report.reportType,
+    completedOn: report.completedOn ? new Date(report.completedOn) : /* @__PURE__ */ new Date(),
+    lighthouse: report.lighthouse,
+    gaUsersCurrent: report.gaUsersCurrent ?? 0,
+    gaUsersPrevious: report.gaUsersPrevious ?? 0,
+    lastTestedDate: report.lastTestedDate ? new Date(report.lastTestedDate) : null,
+    commentary: report.commentary,
+    headerImageCid: cidName
+  });
+  const subject = report.subjectOverride ?? `${site.name} ${report.reportType} Report`;
+  const explicitTo = parseAddresses(site.reportRecipientsTo);
+  const fallbackTo = parseAddresses(site.pointOfContact);
+  const to = explicitTo ?? fallbackTo ?? [];
+  if (to.length === 0) {
+    throw new Error(
+      `Site '${site.name}' has no recipients (Report recipients (To) AND point of contact are both empty)`
+    );
+  }
+  for (const addr of to) {
+    if (!isProbablyEmail(addr)) {
+      throw new Error(
+        `Site '${site.name}' recipient is malformed: ${addr} \u2014 fix Report recipients (To) or point of contact in Airtable`
+      );
+    }
+  }
+  const cc = parseAddresses(site.reportRecipientsCc);
+  if (cc) {
+    for (const addr of cc) {
+      if (!isProbablyEmail(addr)) {
+        throw new Error(
+          `Site '${site.name}' CC is malformed: ${addr} \u2014 fix Report recipients (CC) in Airtable`
+        );
+      }
+    }
+  }
+  const payload = {
+    from: FROM_ADDRESS,
+    to,
+    replyTo: REPLY_TO,
+    subject,
+    html,
+    attachments: [
+      {
+        filename: site.headerImage.filename,
+        content: Buffer.from(bytes).toString("base64"),
+        contentType,
+        inlineContentId: cidName
+      }
+    ],
+    // Stable across retries of the same row — if Airtable stamping fails after a
+    // successful Resend, the next --send-ready replays with the same key and
+    // Resend returns the original message id rather than sending a duplicate.
+    idempotencyKey: `report:${report.id}`
+  };
+  if (cc) payload.cc = cc;
+  const result = await client.send(payload);
+  await stampSent(base, report.id, /* @__PURE__ */ new Date(), result.messageId);
+  return result.messageId;
+}
+function parseAddresses(field) {
+  if (!field) return null;
+  const seen = /* @__PURE__ */ new Set();
+  const list = [];
+  for (const raw of field.split(/[,\n]/)) {
+    const trimmed = raw.trim().toLowerCase();
+    if (!trimmed) continue;
+    if (seen.has(trimmed)) continue;
+    seen.add(trimmed);
+    list.push(trimmed);
+  }
+  return list.length > 0 ? list : null;
+}
+function isProbablyEmail(s) {
+  const at = s.indexOf("@");
+  if (at < 1 || at !== s.lastIndexOf("@")) return false;
+  const local = s.slice(0, at);
+  const domain = s.slice(at + 1);
+  if (!local || !domain) return false;
+  if (!domain.includes(".")) return false;
+  if (/\s/.test(s)) return false;
+  return true;
+}
+
+// src/reports/due.ts
+var MONTHS = {
+  Monthly: 1,
+  Quarterly: 3,
+  Yearly: 12
+};
+function addMonths(d, n) {
+  const out = new Date(d);
+  const day = out.getUTCDate();
+  out.setUTCDate(1);
+  out.setUTCMonth(out.getUTCMonth() + n);
+  const lastDayOfTargetMonth = new Date(
+    Date.UTC(out.getUTCFullYear(), out.getUTCMonth() + 1, 0)
+  ).getUTCDate();
+  out.setUTCDate(Math.min(day, lastDayOfTargetMonth));
+  return out;
+}
+function startOfDay(d) {
+  const out = new Date(d);
+  out.setUTCHours(0, 0, 0, 0);
+  return out;
+}
+function lastSentForType(reports, siteId, type) {
+  const candidates = reports.filter((r) => r.siteId === siteId && r.reportType === type && r.sentAt !== null).map((r) => r.sentAt).sort();
+  return candidates[candidates.length - 1] ?? null;
+}
+function findDueReports(websites, reports, today) {
+  const out = [];
+  const todayStart = startOfDay(today);
+  for (const site of websites) {
+    for (const type of ["Maintenance", "Testing"]) {
+      const freq = type === "Maintenance" ? site.maintenanceFreq : site.testingFreq;
+      if (freq === "None") continue;
+      const lastSent = lastSentForType(reports, site.id, type);
+      const fallback = type === "Maintenance" ? site.maintenanceDay : site.testingDay;
+      const baseIso = lastSent ?? fallback;
+      if (!baseIso) {
+        out.push({ site, reportType: type, dueDate: todayStart, lastSent });
+        continue;
+      }
+      const dueDate = addMonths(new Date(baseIso), MONTHS[freq]);
+      if (todayStart.getTime() >= startOfDay(dueDate).getTime()) {
+        out.push({ site, reportType: type, dueDate, lastSent });
+      }
+    }
+  }
+  return out;
+}
 export {
   ALL_AUDIT_NAMES,
   ALL_RECIPE_NAMES,
@@ -1930,15 +2562,19 @@ export {
   bumpDeps,
   convertToPnpm,
   depsAudit,
+  draftReportForSite,
+  findDueReports,
   fromJsonFile,
   isRecipeName,
   lighthouseAudit,
   lintAudit,
   localPath,
   onboard,
+  renderReportHtml,
   runAudits,
   runAuditsAcross,
   securityAudit,
+  sendApprovedReports,
   svelteCodemods,
   syncConfigs,
   upgradeSvelte4to5