@beechcms/api 0.6.0-preview.1 → 0.6.0-preview.3

package/src/features/draft/draft.handler.ts

@@ -1,195 +0,0 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-/// <reference types="@cloudflare/workers-types" />
-import { Context, Hono } from 'hono'
-import {
-  validateAndSanitizeSeedPayload,
-  resolvePolicies,
-  RelationTargetNotFoundError,
-} from '@beechcms/core'
-import { publicProblem } from '../../public/problem-details'
-import { cleanStr } from '../../shared/query-utils'
-import { applyVisibility } from '../../shared/apply-policies'
-import { AppEnv } from '../../types'
-import { CONTENT_ERRORS } from '../content/constants'
-import { draftGuard } from './draft.middleware'
-
-const draftApp = new Hono<AppEnv>()
-
-// GET /drafts — Unified list of pending drafts across all draft-enabled seeds.
-draftApp.get('/drafts', async (context) => {
-  const seeds = context.get('seedRegistry').draftEnabled()
-  const repository = context.get('repository')
-  const drafts = await repository.findPendingDrafts(seeds)
-  return context.json(drafts)
-})
-
-function normalizeBody(raw: unknown): Record<string, unknown> {
-  return typeof raw === 'object' && raw !== null ? (raw as Record<string, unknown>) : {}
-}
-
-function logDraftActivity(
-  context: Context<AppEnv>,
-  id: string,
-  slug: string,
-  title: string,
-  note: 'draft saved' | 'draft published'
-) {
-  const actor = context.get('jwtPayload')
-  context.get('activityLogger').log({
-    action: 'update',
-    entityType: 'content',
-    entityId: id,
-    entitySlug: slug,
-    details: { title, note },
-    actor: {
-      id: actor.sub,
-      email: actor.email ?? 'unknown',
-      name: [actor.name, actor.surname].filter(Boolean).join(' ') || null,
-    },
-  })
-}
-
-// PUT /:slug/:id/draft — Creates or overwrites the pending draft
-draftApp.put('/:slug/:id/draft', draftGuard, async (context) => {
-  const slug = context.req.param('slug')
-  const id = context.req.param('id')
-  const seed = context.get('getSeed')(slug)!
-
-  let body: Record<string, unknown>
-  try {
-    body = normalizeBody(await context.req.json<unknown>())
-  } catch {
-    return publicProblem(context, { 
-      type: 'content-invalid-json', 
-      title: 'Bad Request', 
-      status: 400, 
-      detail: CONTENT_ERRORS.INVALID_JSON_BODY 
-    })
-  }
-
-  const sensitiveAliases = Object.keys(body).filter((alias) => {
-    const branch = seed.branches.find((b) => b.alias === alias)
-    return branch != null && resolvePolicies(branch).privacy !== 'plain'
-  })
-  
-  if (sensitiveAliases.length > 0) {
-    return publicProblem(context, { 
-      type: 'content-sensitive-field-edit', 
-      title: 'Unprocessable Entity', 
-      status: 422, 
-      detail: `${CONTENT_ERRORS.SENSITIVE_FIELD_EDIT}: ${sensitiveAliases.join(', ')}` 
-    })
-  }
-
-  const validation = validateAndSanitizeSeedPayload(seed, body, {
-    operation: 'update',
-    allowNull: true,
-    requireAtLeastOneValidField: true,
-    enforceRequiredFields: false,
-    idGenerator: context.get('idGenerator'),
-  })
-  
-  if (validation.dangerousFields.length > 0) {
-    return publicProblem(context, { 
-      type: 'content-dangerous-content', 
-      title: 'Unprocessable Entity', 
-      status: 422, 
-      detail: `Dangerous markup in field '${validation.dangerousFields[0]}'` 
-    })
-  }
-  
-  if (validation.details.length > 0) {
-    return publicProblem(context, { 
-      type: 'content-validation-failed', 
-      title: 'Bad Request', 
-      status: 400, 
-      detail: 'Validation failed', 
-      errors: validation.details 
-    })
-  }
-
-  const repository = context.get('repository')
-  await repository.saveDraft(seed, id, validation.data)
-
-  const displayTitle = cleanStr(validation.data[seed.displayNameAlias]) ?? id
-  logDraftActivity(context, id, slug, displayTitle, 'draft saved')
-
-  return context.json({ success: true })
-})
-
-// GET /:slug/:id/draft — Retrieves the pending draft
-draftApp.get('/:slug/:id/draft', draftGuard, async (context) => {
-  const slug = context.req.param('slug')
-  const id = context.req.param('id')
-  const seed = context.get('getSeed')(slug)!
-
-  const repository = context.get('repository')
-  const draft = await repository.getDraft(seed, id)
-
-  if (!draft) {
-    return publicProblem(context, { 
-      type: 'draft-not-found', 
-      title: 'Not Found', 
-      status: 404, 
-      detail: 'No pending draft for this entry' 
-    })
-  }
-
-  return context.json({ data: applyVisibility(draft, seed) })
-})
-
-// POST /:slug/:id/draft/publish — Atomically promotes draft to live
-draftApp.post('/:slug/:id/draft/publish', draftGuard, async (context) => {
-  const slug = context.req.param('slug')
-  const id = context.req.param('id')
-  const seed = context.get('getSeed')(slug)!
-
-  const repository = context.get('repository')
-  const draft = await repository.getDraft(seed, id)
-
-  if (!draft) {
-    return publicProblem(context, { 
-      type: 'draft-not-found', 
-      title: 'Not Found', 
-      status: 404, 
-      detail: 'No pending draft to publish' 
-    })
-  }
-
-  try {
-    await repository.publishDraft(seed, id)
-  } catch (err) {
-    if (err instanceof RelationTargetNotFoundError) {
-      return publicProblem(context, {
-        type: 'relation-target-not-found',
-        title: 'Relation Target Not Found',
-        status: 422,
-        detail: `Field '${err.alias}' references '${err.targetSeed}' id='${err.value}' which does not exist`,
-      })
-    }
-    throw err
-  }
-
-  const displayValue = draft[seed.displayNameAlias]
-  const displayStr = typeof displayValue === 'string' ? displayValue : id
-  logDraftActivity(context, id, slug, displayStr, 'draft published')
-
-  return context.json({ success: true })
-})
-
-// DELETE /:slug/:id/draft — Discards the pending draft
-draftApp.delete('/:slug/:id/draft', draftGuard, async (context) => {
-  const slug = context.req.param('slug')
-  const id = context.req.param('id')
-  const seed = context.get('getSeed')(slug)!
-
-  const repository = context.get('repository')
-  await repository.deleteDraft(seed, id)
-
-  return context.json({ success: true })
-})
-
-export { draftApp }

package/src/features/draft/draft.middleware.ts

@@ -1,66 +0,0 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-import { createMiddleware } from 'hono/factory'
-import { EntryNotFoundError } from '@beechcms/core'
-import { publicProblem } from '../../public/problem-details'
-import { CONTENT_ERRORS } from '../content/constants'
-import type { AppEnv } from '../../types'
-
-/**
- * Middleware that guards draft-related endpoints.
- * Responsibilities:
- * 1. Validates that the targeted Seed schema exists.
- * 2. Ensures the Seed configuration explicitly allows drafts.
- * 3. Confirms that the main live content entry exists in the repository.
- */
-export const draftGuard = createMiddleware<AppEnv>(async (context, next) => {
-  const slug = context.req.param('slug')
-  const id = context.req.param('id')
-
-  if (!slug || !id) {
-    return publicProblem(context, {
-      type: 'content-invalid-request',
-      title: 'Bad Request',
-      status: 400,
-      detail: 'Missing required route parameters',
-    })
-  }
-
-  const seed = context.get('getSeed')(slug)
-  if (!seed) {
-    return publicProblem(context, {
-      type: 'content-seed-not-found',
-      title: 'Not Found',
-      status: 404,
-      detail: CONTENT_ERRORS.SEED_NOT_FOUND,
-    })
-  }
-
-  if (!seed.allowDrafts) {
-    return publicProblem(context, {
-      type: 'draft-not-allowed',
-      title: 'Method Not Allowed',
-      status: 405,
-      detail: 'This content type does not support pending drafts. Set allowDrafts: true on the Seed to enable.',
-    })
-  }
-
-  const repository = context.get('repository')
-  try {
-    await repository.findById(seed, id)
-  } catch (error) {
-    if (error instanceof EntryNotFoundError) {
-      return publicProblem(context, {
-        type: 'content-not-found',
-        title: 'Not Found',
-        status: 404,
-        detail: CONTENT_ERRORS.NOT_FOUND,
-      })
-    }
-    throw error
-  }
-
-  await next()
-})

package/src/features/draft/index.ts

@@ -1,5 +0,0 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-export { draftApp } from './draft.handler'

package/src/features/email/email.service.ts

@@ -1,98 +0,0 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-import { ResendEmailProvider } from './providers/resend'
-import { SmtpEmailProvider } from './providers/smtp'
-import { buildPasswordResetEmail } from './templates/password-reset'
-import { buildPasswordChangedEmail } from './templates/password-changed'
-import { buildAutomationEmail } from './templates/automation-mail'
-import type { EmailProvider } from './email.provider'
-import type {
-  PasswordResetEmailParams,
-  PasswordChangedEmailParams,
-  AutomationMailParams,
-} from './email.types'
-
-const DEFAULT_FROM = 'Beech CMS <onboarding@resend.dev>'
-
-export interface EmailProviderEnv {
-  /** "smtp" | "resend"; default "resend" if absent */
-  provider?: string
-  /** Resend API key, used when provider is "resend" */
-  apiKey?: string
-  /** Mailpit base URL (e.g. http://localhost:8025), used when provider is "smtp" */
-  smtpBaseUrl?: string
-  isDev?: boolean
-}
-
-// TODO: il sistema di selezione provider è attualmente hardcoded su "smtp" | "resend".
-// Sarebbe meglio aprirlo a provider di terze parti (Postmark, SendGrid, Brevo, SES, ...)
-// senza che l'utente debba toccare il codice. Opzioni da valutare:
-//   1. Strategia plugin: EMAIL_PROVIDER accetta un path a modulo ES (`./my-provider.ts`)
-//      che esporta default class implementing EmailProvider — zero lock-in.
-//   2. Provider SMTP generico: rimuovere il coupling con Mailpit dalla denominazione
-//      e accettare qualsiasi server SMTP via SMTP_HOST / SMTP_PORT / SMTP_USER / SMTP_PASS
-//      (il SmtpEmailProvider attuale usa già l'HTTP API di Mailpit, non SMTP raw —
-//      andrebbe riscritto con nodemailer o un client SMTP standard per coprire qualsiasi server).
-//   3. Webhook email: EMAIL_PROVIDER=webhook + EMAIL_WEBHOOK_URL per integrazioni custom.
-// Riferimento: email.provider.ts definisce l'interfaccia — è già sufficientemente astratta.
-function createProvider(env: EmailProviderEnv): EmailProvider {
-  if (env.provider === 'smtp') {
-    if (!env.smtpBaseUrl) throw new Error('SMTP provider selected but SMTP_HOST is missing')
-    return new SmtpEmailProvider({ baseUrl: env.smtpBaseUrl })
-  }
-  return new ResendEmailProvider(env.apiKey ?? '', env.isDev ?? false)
-}
-
-export async function sendPasswordResetEmail(
-  params: PasswordResetEmailParams,
-): Promise<void> {
-  const provider = createProvider({
-    provider: params.provider,
-    apiKey: params.apiKey,
-    smtpBaseUrl: params.smtpBaseUrl,
-    isDev: params.isDev ?? false,
-  })
-  const { subject, html } = buildPasswordResetEmail(params.resetUrl, params.locale)
-  await provider.send({
-    from: params.from ?? DEFAULT_FROM,
-    to: [params.to],
-    subject,
-    html,
-  })
-}
-
-export async function sendPasswordChangedEmail(
-  params: PasswordChangedEmailParams,
-): Promise<void> {
-  const provider = createProvider({
-    provider: params.provider,
-    apiKey: params.apiKey,
-    smtpBaseUrl: params.smtpBaseUrl,
-    isDev: params.isDev ?? false,
-  })
-  const { subject, html } = buildPasswordChangedEmail(params.locale)
-  await provider.send({
-    from: params.from ?? DEFAULT_FROM,
-    to: [params.to],
-    subject,
-    html,
-  })
-}
-
-export async function sendAutomationMail(params: AutomationMailParams): Promise<void> {
-  const provider = createProvider({
-    provider: params.provider,
-    apiKey: params.apiKey ?? params.resendApiKey,
-    smtpBaseUrl: params.smtpBaseUrl,
-    isDev: false,
-  })
-  const message = buildAutomationEmail(params)
-  await provider.send({
-    from: params.from ?? DEFAULT_FROM,
-    to: [message.to],
-    subject: message.subject,
-    html: message.html,
-  })
-}

package/src/features/email/email.types.ts

@@ -1,119 +0,0 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-/**
- * Shared types for the Beech CMS email module.
- *
- * All types used across provider, service, and templates are defined here
- * so that each layer remains decoupled from the others.
- */
-
-// ── Locale ────────────────────────────────────────────────────────────────────
-
-/**
- * Supported languages for the email template system.
- *
- * To add a new language:
- *  1. Add the ISO code here (e.g., `'fr'`).
- *  2. Add the corresponding translation in the `COPY` object of every
- *     file in `templates/`. TypeScript will flag missing keys.
- */
-export const SUPPORTED_EMAIL_LOCALES = ['en', 'it'] as const
-export type EmailLocale = (typeof SUPPORTED_EMAIL_LOCALES)[number]
-
-/**
- * Resolves an unverified locale string (e.g., from a request body)
- * to a supported `EmailLocale` value. Any unknown value
- * safely falls back to `'en'`.
- *
- * @param raw - Raw value from the client (can be anything).
- * @returns A valid `EmailLocale`, always.
- */
-export function resolveEmailLocale(raw: unknown): EmailLocale {
-  if (
-    typeof raw === 'string' &&
-    (SUPPORTED_EMAIL_LOCALES as readonly string[]).includes(raw)
-  ) {
-    return raw as EmailLocale
-  }
-  return 'en'
-}
-
-// ── Outbound message ──────────────────────────────────────────────────────────
-
-/**
- * The resolved email message that the provider receives and sends.
- * It is constructed by the service by combining the call parameters
- * with the template builder output.
- */
-export interface OutboundEmail {
-  /** Sender address in RFC 5321 format (e.g., "Beech CMS <noreply@beechcms.dev>"). */
-  from: string
-  /** List of recipient addresses. Must contain at least one element. */
-  to: string[]
-  subject: string
-  /** Complete HTML body. Must be a valid HTML document (see `templates/shell.ts`). */
-  html: string
-}
-
-// ── Service function parameters ───────────────────────────────────────────────
-
-/**
- * Shared parameters for every email sending function in `email.service.ts`.
- * Specific functions extend this type with the additional fields
- * required for their respective templates.
- */
-export interface BaseEmailParams {
-  /** Main recipient address. */
-  to: string
-  /** Email body language. Use `resolveEmailLocale()` before passing it here. */
-  locale: EmailLocale
-  /**
-   * Resend API key (or the active provider's key). Must be non-empty —
-   * the caller is responsible for validating it before invoking the service.
-   */
-  apiKey: string
-  /**
-   * Sender address in RFC 5321 format.
-   * Default: "Beech CMS <onboarding@resend.dev>" (Resend test sender).
-   * In production, set a verified address via the
-   * `EMAIL_FROM` environment variable.
-   */
-  from?: string
-  /**
-   * When `true`, provider errors are logged to the console.
-   * Set to `false` in production to avoid exposing internal details.
-   */
-  isDev?: boolean
-}
-
-/** Parameters for the password reset email — adds the reset URL. */
-export interface PasswordResetEmailParams extends BaseEmailParams {
-  /**
-   * Complete URL that the user clicks to set the new password.
-   * Contains the token in plain text as a query param `?token=<uuid>`.
-   * Constructed by the caller as `${APP_URL}/reset-password?token=${token}`.
-   */
-  resetUrl: string
-  provider?: 'smtp' | 'resend'
-  smtpBaseUrl?: string
-}
-
-/** Parameters for the "password changed" notification. No additional fields. */
-export interface PasswordChangedEmailParams extends BaseEmailParams {
-  provider?: 'smtp' | 'resend'
-  smtpBaseUrl?: string
-}
-
-export interface AutomationMailParams {
-  to: string
-  subject: string
-  /** Plain text or HTML — passed verbatim to provider. */
-  body: string
-  apiKey?: string
-  resendApiKey?: string
-  from?: string
-  provider?: 'smtp' | 'resend'
-  smtpBaseUrl?: string
-}

package/src/features/email/providers/resend.ts

@@ -1,67 +0,0 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-/// <reference types="@cloudflare/workers-types" />
-import type { EmailProvider } from '../email.provider'
-import type { OutboundEmail } from '../email.types'
-
-/** Resend REST endpoint for sending emails. */
-const RESEND_API_URL = 'https://api.resend.com/emails'
-
-/**
- * Resend implementation of EmailProvider.
- *
- * This is the ONLY file in the email module that knows about Resend.
- * Every other file is completely unaware of which provider is active.
- *
- * ─── HOW TO REPLACE THIS PROVIDER ──────────────────────────────────────────
- *  1. Create a new file in `providers/` (e.g., `providers/sendgrid.ts`).
- *  2. Export a class that implements `EmailProvider` (a single method: `send`).
- *  3. In `email.service.ts`, replace `new ResendEmailProvider(...)` with
- *     your new class in the `createProvider()` function.
- *  4. Update the environment variables in `types.ts` and `wrangler.jsonc`.
- *  5. No other file in the project needs to be modified.
- *
- * Resend API Documentation: https://resend.com/docs/api-reference/emails/send-email
- * ─────────────────────────────────────────────────────────────────────────────
- */
-export class ResendEmailProvider implements EmailProvider {
-  private readonly apiKey: string
-
-  /** When `true`, errors are logged to the console (development only). */
-  private readonly isDev: boolean
-
-  constructor(apiKey: string, isDev = false) {
-    this.apiKey = apiKey
-    this.isDev = isDev
-  }
-
-  /**
-   * Sends the email via the Resend REST API (`POST /emails`).
-   *
-   * Throws an exception if Resend responds with a non-2xx status, so that
-   * the caller (`email.service.ts`) can decide whether to propagate the error
-   * or handle it silently (fire-and-forget).
-   *
-   * The response body is read for logging only in the development environment,
-   * to avoid unnecessarily consuming the body stream in production.
-   */
-  async send(email: OutboundEmail): Promise<void> {
-    const response = await fetch(RESEND_API_URL, {
-      method: 'POST',
-      headers: {
-        Authorization: `Bearer ${this.apiKey}`,
-        'Content-Type': 'application/json',
-        },
-      body: JSON.stringify(email),
-    })
-
-    if (!response.ok) {
-      const detail = this.isDev
-        ? await response.text()
-        : `HTTP ${response.status}`
-      throw new Error(`[ResendEmailProvider] send failed — ${detail}`)
-    }
-  }
-}

package/src/features/email/providers/smtp.ts

@@ -1,55 +0,0 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-/// <reference types="@cloudflare/workers-types" />
-import type { EmailProvider } from '../email.provider'
-import type { OutboundEmail } from '../email.types'
-
-export interface SmtpProviderConfig {
-  /** Base URL of the Mailpit HTTP API, e.g. http://localhost:8025 */
-  baseUrl: string
-}
-
-interface MailpitAddress { Name?: string; Email: string }
-interface MailpitSendPayload {
-  From: MailpitAddress
-  To: MailpitAddress[]
-  Subject: string
-  HTML?: string
-  Text?: string
-}
-
-function parseAddress(raw: string): MailpitAddress {
-  const match = raw.match(/^\s*(.+?)\s*<([^>]+)>\s*$/)
-  if (match) return { Name: match[1], Email: match[2] }
-  return { Email: raw.trim() }
-}
-
-export class SmtpEmailProvider implements EmailProvider {
-  private readonly endpoint: string
-
-  constructor(config: SmtpProviderConfig) {
-    this.endpoint = `${config.baseUrl.replace(/\/$/, '')}/api/v1/send`
-  }
-
-  async send(email: OutboundEmail): Promise<void> {
-    const payload: MailpitSendPayload = {
-      From: parseAddress(email.from),
-      To: email.to.map(parseAddress),
-      Subject: email.subject,
-      HTML: email.html,
-    }
-
-    const response = await fetch(this.endpoint, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(payload),
-    })
-
-    if (!response.ok) {
-      const body = await response.text().catch(() => `HTTP ${response.status}`)
-      throw new Error(`[SmtpEmailProvider] send failed — ${body}`)
-    }
-  }
-}

package/src/features/email/templates/automation-mail.ts

@@ -1,19 +0,0 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-import type { AutomationMailParams } from '../email.types'
-
-/** Identity builder: automation payloads are already user-authored. */
-export function buildAutomationEmail(params: AutomationMailParams) {
-  return {
-    to: params.to,
-    subject: params.subject,
-    html: params.body,
-    text: stripHtml(params.body),
-  }
-}
-
-function stripHtml(input: string): string {
-  return input.replace(/<[^>]+>/g, '').trim()
-}

package/src/features/email/templates/password-changed.ts

@@ -1,63 +0,0 @@
-// SPDX-License-Identifier: BUSL-1.1
-// Copyright (c) 2024–2026 Flavio De Musso. All rights reserved.
-// See LICENSE in the repository root for license terms.
-
-import type { EmailLocale } from '../email.types'
-import { buildEmailShell } from './shell'
-
-/**
- * Localized texts for the "password changed" security notification.
- *
- * ─── ADDING A NEW LANGUAGE ──────────────────────────────────────────────────
- * See instructions in `templates/password-reset.ts`.
- * ─────────────────────────────────────────────────────────────────────────────
- */
-const COPY: Record<EmailLocale, {
-  subject: string
-  title: string
-  body: string
-  warning: string
-  footer: string
-}> = {
-  en: {
-    subject: 'Your Beech CMS password has been changed',
-    title: 'Your password has been changed',
-    body: 'Your Beech CMS account password was successfully changed. If you made this change, no action is needed.',
-    warning:
-      'If you did not make this change, your account may be compromised. Contact your administrator immediately.',
-    footer: 'This is an automated security notification. Do not reply to this email.',
-  },
-  it: {
-    subject: 'La tua password Beech CMS è stata modificata',
-    title: 'La tua password è stata modificata',
-    body: 'La password del tuo account Beech CMS è stata modificata con successo. Se hai effettuato tu questa modifica, non devi fare nulla.',
-    warning:
-      'Se non hai effettuato tu questa modifica, il tuo account potrebbe essere compromesso. Contatta immediatamente il tuo amministratore.',
-    footer: 'Questa è una notifica di sicurezza automatica. Non rispondere a questa email.',
-  },
-}
-
-/**
- * Builds the "password changed" notification email.
- *
- * This email does not have a CTA button — it is a pure security notification.
- * The `warning` block (red text) warns the user to take action if they
- * were not the one who changed the password.
- *
- * @param locale - Language for the email subject and body.
- * @returns Object with `subject` (string) and `html` (complete HTML document).
- */
-export function buildPasswordChangedEmail(
-  locale: EmailLocale,
-): { subject: string; html: string } {
-  const c = COPY[locale]
-  return {
-    subject: c.subject,
-    html: buildEmailShell(locale, {
-      title: c.title,
-      body: c.body,
-      warning: c.warning,
-      footer: c.footer,
-    }),
-  }
-}