feat: email each new reminder via Cloudflare Email Routing

[ofa1]

Adds email as a second delivery channel alongside Telegram. After the audio
is posted to the chat, the same reminder is emailed to the addresses in
EMAIL_TO through the SEND_EMAIL binding.

The message links to the post and the audio file rather than attaching it,
which keeps it well inside Email Routing's size limit.

Email is best effort. By the time it runs the audio has already gone out, so
throwing would leave the KV timestamp unwritten and re-post the same audio on
the next tick. A failed email is reported to NOTIFICATIONS_CHAT_ID instead and
the run still succeeds. Each recipient is attempted independently so one
unverified address cannot suppress the rest.

The RFC 5322 message is built by hand rather than with mimetext, which pulls
in @babel/runtime-corejs3 and core-js-pure for what is a string builder. The
builders are pure functions, so subject encoding, MIME structure and header
injection are covered directly by unit tests.

Co-Authored-By: Claude Opus 5 noreply@anthropic.com
Claude-Session: https://claude.ai/code/session_01UxmzyMHFg4eau4kqNuxiHP

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
✅ Deployment successful! View logs	mhmic-telegram-cron	e8adfb5	Sep 06 2026, 08:38 PM

[Copilot]

🟡 Changes recommended

Email-send failures can surface full recipient addresses in the notifications chat, which is a avoidable information disclosure risk.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Adds an email delivery channel (via Cloudflare SEND_EMAIL) for each newly posted reminder, while keeping Telegram as the primary channel and ensuring email failures don’t cause re-posts on the next cron tick.

Changes:

• Introduces src/email.ts to compose and send reminder emails (per-recipient) and adds HTML/text sanitization helpers.
• Updates handler flow so Telegram sends first, then email is attempted best-effort with failures reported to the notifications chat.
• Updates test setup (Vitest + Cloudflare pool), adds unit tests for email composition/sending, and refreshes related dependencies/config/docs.

File summaries

File	Description
wrangler.jsonc	Adds SEND_EMAIL binding configuration.
vitest.config.ts	Removes prior workers config file.
vitest.config.mts	Adds new Vitest config using cloudflareTest() plugin and test bindings (incl. email secrets).
tsconfig.json	Updates Cloudflare Vitest pool types entry.
tests/unit/utils.test.ts	Adds coverage for htmlToText and escapeHtml.
tests/unit/handlers.test.ts	Mocks email sending and adds handler-level email behavior tests.
tests/unit/email.test.ts	Adds comprehensive unit tests for composing/sending reminder emails.
tests/env.d.ts	Removes custom cloudflare:test ProvidedEnv typing augmentation.
src/utils.ts	Adds htmlToText (via cheerio) and escapeHtml.
src/handlers.ts	Sends Telegram first, then best-effort email with failure notifications.
src/env.d.ts	Adds durable secret typings that survive wrangler types regeneration.
src/email.ts	New module to build and send reminder emails via SEND_EMAIL.
README.md	Documents email notification behavior and configuration.
package.json	Bumps dev tooling versions; adds/keeps cheerio dependency for HTML decoding.
package-lock.json	Updates lockfile for dependency/version bumps.
.env.example	Adds EMAIL_FROM / EMAIL_TO placeholders and notes.

Review details

• Files reviewed: 12/17 changed files
• Comments generated: 1
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.