jdc-react-mailer 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2025-02-17
+
+### Added
+
+- `ContactForm` React component with configurable fields (`name`, `email`, `subject`, `message`), labels, placeholders, and theme overrides.
+- `useContactForm` hook for form state, validation, honeypot, and POST submission.
+- Theming via CSS custom properties (`--jdcm-*`) and optional inline `theme` prop.
+- Next.js App Router handler: `createMailerHandler()` from `jdc-react-mailer/handler` with Nodemailer SMTP, optional rate limit, CORS, and custom email template.
+- Honeypot (`website`) field for spam protection.
+- Accessible form: ARIA attributes, error messages, loading/success/error states, keyboard navigation, reduced-motion support.
+- Package exports: main entry (component + types), `jdc-react-mailer/handler`, `jdc-react-mailer/style.css`.
+- Build with tsup (ESM + CJS, declarations).
+- Vitest tests for validation and hook behavior.
+- README with install, quick start, API reference, and theming guide.
+
+[Unreleased]: https://github.com/your-org/jdc-react-mailer/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/your-org/jdc-react-mailer/releases/tag/v0.1.0

package/README.md

@@ -0,0 +1,180 @@
+# jdc-react-mailer
+
+A reusable, themeable React contact form component with a Next.js App Router API route handler powered by Nodemailer. Capture form submissions and send them to a designated email address.
+
+- **React 18+** and **TypeScript**
+- **Themeable** via CSS custom properties or inline `theme` prop
+- **Next.js-first**: ships a `<ContactForm>` component and `createMailerHandler()` for App Router
+- **Nodemailer** for SMTP (Gmail, SendGrid, SES, or any SMTP provider)
+- Accessible, validated, honeypot spam protection, loading/success/error UX
+
+## Install
+
+```bash
+pnpm add jdc-react-mailer
+# or
+npm i jdc-react-mailer
+```
+
+Peer dependencies: `react` and `react-dom` (>=18). For the Next.js handler you need `next` (>=14) in your app.
+
+## Quick start
+
+### 1. Add the API route (Next.js App Router)
+
+Create `app/api/contact/route.ts`:
+
+```ts
+import { createMailerHandler } from 'jdc-react-mailer/handler';
+
+export const { POST } = createMailerHandler({
+  smtp: {
+    host: process.env.SMTP_HOST!,
+    port: Number(process.env.SMTP_PORT ?? 587),
+    secure: false,
+    auth: {
+      user: process.env.SMTP_USER!,
+      pass: process.env.SMTP_PASS!,
+    },
+  },
+  to: 'you@example.com',
+  from: 'noreply@yoursite.com',
+});
+```
+
+Set `SMTP_HOST`, `SMTP_PORT`, `SMTP_USER`, and `SMTP_PASS` in your environment (e.g. `.env.local`).
+
+### 2. Use the form in a page
+
+```tsx
+import { ContactForm } from 'jdc-react-mailer';
+import 'jdc-react-mailer/style.css';
+
+export default function ContactPage() {
+  return (
+    <ContactForm
+      endpoint="/api/contact"
+      successMessage="Thanks! I'll be in touch."
+    />
+  );
+}
+```
+
+Import the stylesheet once (e.g. in your layout or this page). The form POSTs to `endpoint` with a JSON body; the handler validates it, checks the honeypot, and sends email via Nodemailer.
+
+## Component API
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `endpoint` | `string` | required | POST URL (e.g. `/api/contact`) |
+| `fields` | `('name' \| 'email' \| 'subject' \| 'message')[]` | `['name','email','subject','message']` | Field order and inclusion |
+| `labels` | `Partial<Record<FormFieldName, string>>` | — | Override labels per field |
+| `placeholders` | `Partial<Record<FormFieldName, string>>` | — | Override placeholders |
+| `theme` | `ThemeOverrides` | — | Inline CSS variable overrides (see Theming) |
+| `successMessage` | `string` | `"Thanks! I'll be in touch."` | Message shown after successful submit |
+| `submitLabel` | `string` | `"Send message"` | Submit button text |
+| `onSuccess` | `(data: ContactFormPayload) => void` | — | Called when submit succeeds |
+| `onError` | `(error: Error) => void` | — | Called when submit fails |
+| `className` | `string` | — | Extra class on the form root |
+
+Example with overrides:
+
+```tsx
+<ContactForm
+  endpoint="/api/contact"
+  fields={['name', 'email', 'message']}
+  labels={{ name: 'Full Name', message: 'Your message' }}
+  placeholders={{ message: 'Say hi...' }}
+  theme={{ primary: '#0070f3', radius: '10px' }}
+  successMessage="Got it, thanks!"
+  onSuccess={(data) => console.log('Sent', data)}
+  onError={(err) => console.error(err)}
+  className="my-contact-form"
+/>
+```
+
+## Theming
+
+Styles are driven by CSS custom properties. Import the default stylesheet and override variables where you need:
+
+```css
+/* Override in your app (e.g. global.css or a wrapper) */
+:root {
+  --jdcm-primary:      #0070f3;
+  --jdcm-primary-hover: #005bb5;
+  --jdcm-bg:           #ffffff;
+  --jdcm-surface:      #f9fafb;
+  --jdcm-border:       #e2e8f0;
+  --jdcm-text:         #1a202c;
+  --jdcm-muted:        #718096;
+  --jdcm-error:        #e53e3e;
+  --jdcm-success:      #38a169;
+  --jdcm-radius:       8px;
+  --jdcm-spacing:      1rem;
+  --jdcm-font:         inherit;
+}
+```
+
+Or pass a `theme` prop for inline overrides (no global CSS needed):
+
+```tsx
+<ContactForm
+  endpoint="/api/contact"
+  theme={{
+    primary: '#0070f3',
+    primaryHover: '#005bb5',
+    radius: '10px',
+    fontFamily: 'var(--font-sans)',
+  }}
+/>
+```
+
+When `theme` is set, the root gets `data-theme-set` so the built-in dark-mode media query does not override your variables.
+
+## Handler options
+
+`createMailerHandler(config)` accepts:
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `smtp` | `SmtpConfig` | Nodemailer transport options (`host`, `port`, `secure`, `auth`) |
+| `to` | `string` | Recipient email |
+| `from` | `string` | Sender (e.g. `"Site <noreply@yoursite.com>"`) |
+| `rateLimit` | `number` | Max requests per minute per IP (optional) |
+| `allowedOrigins` | `string[]` | CORS allowed origins (optional) |
+| `emailTemplate` | `(payload: ContactPayload) => string` | Custom HTML body (optional) |
+
+Example with rate limit and custom template:
+
+```ts
+export const { POST } = createMailerHandler({
+  smtp: { ... },
+  to: 'you@example.com',
+  from: 'noreply@yoursite.com',
+  rateLimit: 10,
+  allowedOrigins: ['https://yoursite.com'],
+  emailTemplate: (payload) => `
+    <h2>New message from ${payload.name ?? payload.email}</h2>
+    <p><strong>Email:</strong> ${payload.email}</p>
+    <p>${payload.message.replace(/\n/g, '<br>')}</p>
+  `,
+});
+```
+
+## Exports
+
+- **Default (client):** `ContactForm`, and types `ContactFormProps`, `FormFieldName`, `FormFieldsConfig`, `ThemeOverrides`, `ContactFormPayload`, `SubmitState`.
+- **`jdc-react-mailer/handler`:** `createMailerHandler`, and types `MailerHandlerConfig`, `ContactPayload`, `SmtpConfig`.
+- **`jdc-react-mailer/style.css`:** Default styles (import once in your app).
+
+## Scripts
+
+- `pnpm build` — build ESM + CJS and copy `style.css` to `dist`
+- `pnpm dev` — watch build
+- `pnpm test` — run Vitest
+- `pnpm lint` — ESLint
+- `pnpm format` — Prettier
+
+## Changelog
+
+See [CHANGELOG.md](./CHANGELOG.md).

package/dist/handler/index.cjs

@@ -0,0 +1,197 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/handler/index.ts
+var handler_exports = {};
+__export(handler_exports, {
+  createMailerHandler: () => createMailerHandler
+});
+module.exports = __toCommonJS(handler_exports);
+
+// src/handler/mailer.ts
+var import_nodemailer = __toESM(require("nodemailer"), 1);
+function defaultEmailTemplate(payload) {
+  const lines = [
+    "<h2>New contact form submission</h2>",
+    '<table style="border-collapse: collapse; font-family: sans-serif;">'
+  ];
+  if (payload.name) {
+    lines.push(`<tr><td style="padding: 6px 12px 6px 0; font-weight: bold;">Name</td><td style="padding: 6px 0;">${escapeHtml(payload.name)}</td></tr>`);
+  }
+  lines.push(`<tr><td style="padding: 6px 12px 6px 0; font-weight: bold;">Email</td><td style="padding: 6px 0;">${escapeHtml(payload.email)}</td></tr>`);
+  if (payload.phone) {
+    lines.push(`<tr><td style="padding: 6px 12px 6px 0; font-weight: bold;">Phone</td><td style="padding: 6px 0;">${escapeHtml(payload.phone)}</td></tr>`);
+  }
+  if (payload.subject) {
+    lines.push(`<tr><td style="padding: 6px 12px 6px 0; font-weight: bold;">Subject</td><td style="padding: 6px 0;">${escapeHtml(payload.subject)}</td></tr>`);
+  }
+  lines.push(`<tr><td style="padding: 6px 12px 6px 0; font-weight: bold; vertical-align: top;">Message</td><td style="padding: 6px 0;">${escapeHtml(payload.message).replace(/\n/g, "<br>")}</td></tr>`);
+  lines.push("</table>");
+  return lines.join("\n");
+}
+function escapeHtml(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function createTransport(smtp) {
+  return import_nodemailer.default.createTransport(smtp);
+}
+function sendMail(transport, config, payload, htmlBody) {
+  const subject = payload.subject || "Contact form submission";
+  return transport.sendMail({
+    from: config.from,
+    to: config.to,
+    replyTo: payload.email,
+    subject,
+    html: htmlBody,
+    text: `Name: ${payload.name ?? "\u2014"}
+Email: ${payload.email}
+Phone: ${payload.phone ?? "\u2014"}
+Subject: ${payload.subject ?? "\u2014"}
+
+Message:
+${payload.message}`
+  });
+}
+function defaultTemplate(payload) {
+  return defaultEmailTemplate(payload);
+}
+
+// src/handler/validate.ts
+var EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+function parseBody(body) {
+  try {
+    return JSON.parse(body);
+  } catch {
+    return null;
+  }
+}
+function validatePayload(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+    return { ok: false, message: "Invalid payload" };
+  }
+  const o = raw;
+  const email = typeof o.email === "string" ? o.email.trim() : "";
+  const message = typeof o.message === "string" ? o.message.trim() : "";
+  const name = typeof o.name === "string" ? o.name.trim() : void 0;
+  const subject = typeof o.subject === "string" ? o.subject.trim() : void 0;
+  const website = typeof o.website === "string" ? o.website.trim() : "";
+  if (!email) return { ok: false, message: "Email is required" };
+  if (!EMAIL_REGEX.test(email)) return { ok: false, message: "Invalid email address" };
+  if (!message) return { ok: false, message: "Message is required" };
+  if (website) return { ok: false, message: "Invalid submission" };
+  return {
+    ok: true,
+    payload: { email, message, name, subject }
+  };
+}
+
+// src/handler/index.ts
+function getClientIp(request) {
+  const forwarded = request.headers.get("x-forwarded-for");
+  if (forwarded) return forwarded.split(",")[0]?.trim() ?? "unknown";
+  const realIp = request.headers.get("x-real-ip");
+  if (realIp) return realIp;
+  return "unknown";
+}
+function createMailerHandler(config) {
+  const transport = createTransport(config.smtp);
+  const template = config.emailTemplate ?? defaultTemplate;
+  const rateLimitMap = /* @__PURE__ */ new Map();
+  const rateLimit = config.rateLimit ?? 0;
+  const windowMs = 6e4;
+  function checkRateLimit(ip) {
+    if (rateLimit <= 0) return true;
+    const now = Date.now();
+    const entry = rateLimitMap.get(ip);
+    if (!entry) {
+      rateLimitMap.set(ip, { count: 1, resetAt: now + windowMs });
+      return true;
+    }
+    if (now > entry.resetAt) {
+      rateLimitMap.set(ip, { count: 1, resetAt: now + windowMs });
+      return true;
+    }
+    entry.count += 1;
+    return entry.count <= rateLimit;
+  }
+  async function POST(request) {
+    const origin = request.headers.get("origin") ?? "";
+    const allowedOrigins = config.allowedOrigins;
+    if (allowedOrigins && allowedOrigins.length > 0 && origin && !allowedOrigins.includes(origin)) {
+      return new Response(
+        JSON.stringify({ success: false, message: "Forbidden" }),
+        { status: 403, headers: { "Content-Type": "application/json" } }
+      );
+    }
+    const ip = getClientIp(request);
+    if (!checkRateLimit(ip)) {
+      return new Response(
+        JSON.stringify({ success: false, message: "Too many requests" }),
+        { status: 429, headers: { "Content-Type": "application/json" } }
+      );
+    }
+    let body;
+    try {
+      body = await request.text();
+    } catch {
+      return new Response(
+        JSON.stringify({ success: false, message: "Bad request" }),
+        { status: 400, headers: { "Content-Type": "application/json" } }
+      );
+    }
+    const raw = parseBody(body);
+    const validated = validatePayload(raw);
+    if (!validated.ok) {
+      return new Response(
+        JSON.stringify({ success: false, message: validated.message }),
+        { status: 400, headers: { "Content-Type": "application/json" } }
+      );
+    }
+    try {
+      const html = template(validated.payload);
+      await sendMail(transport, { from: config.from, to: config.to }, validated.payload, html);
+      return new Response(
+        JSON.stringify({ success: true }),
+        { status: 200, headers: { "Content-Type": "application/json" } }
+      );
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Failed to send email";
+      return new Response(
+        JSON.stringify({ success: false, message }),
+        { status: 500, headers: { "Content-Type": "application/json" } }
+      );
+    }
+  }
+  return { POST };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createMailerHandler
+});
+//# sourceMappingURL=index.cjs.map

package/dist/handler/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/handler/index.ts","../../src/handler/mailer.ts","../../src/handler/validate.ts"],"sourcesContent":["import type { NextRequest } from 'next/server';\nimport type { MailerHandlerConfig } from './types';\nimport { createTransport, sendMail, defaultTemplate } from './mailer';\nimport { parseBody, validatePayload } from './validate';\n\nfunction getClientIp(request: NextRequest): string {\n  const forwarded = request.headers.get('x-forwarded-for');\n  if (forwarded) return forwarded.split(',')[0]?.trim() ?? 'unknown';\n  const realIp = request.headers.get('x-real-ip');\n  if (realIp) return realIp;\n  return 'unknown';\n}\n\nexport function createMailerHandler(config: MailerHandlerConfig) {\n  const transport = createTransport(config.smtp);\n  const template = config.emailTemplate ?? defaultTemplate;\n\n  const rateLimitMap = new Map<string, { count: number; resetAt: number }>();\n  const rateLimit = config.rateLimit ?? 0;\n  const windowMs = 60_000;\n\n  function checkRateLimit(ip: string): boolean {\n    if (rateLimit <= 0) return true;\n    const now = Date.now();\n    const entry = rateLimitMap.get(ip);\n    if (!entry) {\n      rateLimitMap.set(ip, { count: 1, resetAt: now + windowMs });\n      return true;\n    }\n    if (now > entry.resetAt) {\n      rateLimitMap.set(ip, { count: 1, resetAt: now + windowMs });\n      return true;\n    }\n    entry.count += 1;\n    return entry.count <= rateLimit;\n  }\n\n  async function POST(request: NextRequest) {\n    const origin = request.headers.get('origin') ?? '';\n    const allowedOrigins = config.allowedOrigins;\n    if (allowedOrigins && allowedOrigins.length > 0 && origin && !allowedOrigins.includes(origin)) {\n      return new Response(\n        JSON.stringify({ success: false, message: 'Forbidden' }),\n        { status: 403, headers: { 'Content-Type': 'application/json' } }\n      );\n    }\n\n    const ip = getClientIp(request);\n    if (!checkRateLimit(ip)) {\n      return new Response(\n        JSON.stringify({ success: false, message: 'Too many requests' }),\n        { status: 429, headers: { 'Content-Type': 'application/json' } }\n      );\n    }\n\n    let body: string;\n    try {\n      body = await request.text();\n    } catch {\n      return new Response(\n        JSON.stringify({ success: false, message: 'Bad request' }),\n        { status: 400, headers: { 'Content-Type': 'application/json' } }\n      );\n    }\n\n    const raw = parseBody(body);\n    const validated = validatePayload(raw);\n    if (!validated.ok) {\n      return new Response(\n        JSON.stringify({ success: false, message: validated.message }),\n        { status: 400, headers: { 'Content-Type': 'application/json' } }\n      );\n    }\n\n    try {\n      const html = template(validated.payload);\n      await sendMail(transport, { from: config.from, to: config.to }, validated.payload, html);\n      return new Response(\n        JSON.stringify({ success: true }),\n        { status: 200, headers: { 'Content-Type': 'application/json' } }\n      );\n    } catch (err) {\n      const message = err instanceof Error ? err.message : 'Failed to send email';\n      return new Response(\n        JSON.stringify({ success: false, message }),\n        { status: 500, headers: { 'Content-Type': 'application/json' } }\n      );\n    }\n  }\n\n  return { POST };\n}\n\nexport type { MailerHandlerConfig, ContactPayload, SmtpConfig } from './types';\n","import nodemailer from 'nodemailer';\nimport type { Transporter } from 'nodemailer';\nimport type { SmtpConfig, ContactPayload } from './types';\n\nfunction defaultEmailTemplate(payload: ContactPayload): string {\n  const lines: string[] = [\n    '<h2>New contact form submission</h2>',\n    '<table style=\"border-collapse: collapse; font-family: sans-serif;\">',\n  ];\n  if (payload.name) {\n    lines.push(`<tr><td style=\"padding: 6px 12px 6px 0; font-weight: bold;\">Name</td><td style=\"padding: 6px 0;\">${escapeHtml(payload.name)}</td></tr>`);\n  }\n  lines.push(`<tr><td style=\"padding: 6px 12px 6px 0; font-weight: bold;\">Email</td><td style=\"padding: 6px 0;\">${escapeHtml(payload.email)}</td></tr>`);\n  if (payload.phone) {\n    lines.push(`<tr><td style=\"padding: 6px 12px 6px 0; font-weight: bold;\">Phone</td><td style=\"padding: 6px 0;\">${escapeHtml(payload.phone)}</td></tr>`);\n  }\n  if (payload.subject) {\n    lines.push(`<tr><td style=\"padding: 6px 12px 6px 0; font-weight: bold;\">Subject</td><td style=\"padding: 6px 0;\">${escapeHtml(payload.subject)}</td></tr>`);\n  }\n  lines.push(`<tr><td style=\"padding: 6px 12px 6px 0; font-weight: bold; vertical-align: top;\">Message</td><td style=\"padding: 6px 0;\">${escapeHtml(payload.message).replace(/\\n/g, '<br>')}</td></tr>`);\n  lines.push('</table>');\n  return lines.join('\\n');\n}\n\nfunction escapeHtml(s: string): string {\n  return s\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&#39;');\n}\n\nexport function createTransport(smtp: SmtpConfig): Transporter {\n  return nodemailer.createTransport(smtp);\n}\n\nexport function sendMail(\n  transport: Transporter,\n  config: { from: string; to: string },\n  payload: ContactPayload,\n  htmlBody: string\n): Promise<void> {\n  const subject = payload.subject || 'Contact form submission';\n  return transport.sendMail({\n    from: config.from,\n    to: config.to,\n    replyTo: payload.email,\n    subject,\n    html: htmlBody,\n    text: `Name: ${payload.name ?? '—'}\\nEmail: ${payload.email}\\nPhone: ${payload.phone ?? '—'}\\nSubject: ${payload.subject ?? '—'}\\n\\nMessage:\\n${payload.message}`,\n  }) as Promise<void>;\n}\n\nexport function defaultTemplate(payload: ContactPayload): string {\n  return defaultEmailTemplate(payload);\n}\n","import type { ContactPayload } from './types';\n\nconst EMAIL_REGEX = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n\nexport function parseBody(body: string): unknown {\n  try {\n    return JSON.parse(body) as unknown;\n  } catch {\n    return null;\n  }\n}\n\nexport function validatePayload(\n  raw: unknown\n): { ok: true; payload: ContactPayload } | { ok: false; message: string } {\n  if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {\n    return { ok: false, message: 'Invalid payload' };\n  }\n  const o = raw as Record<string, unknown>;\n  const email = typeof o.email === 'string' ? o.email.trim() : '';\n  const message = typeof o.message === 'string' ? o.message.trim() : '';\n  const name = typeof o.name === 'string' ? o.name.trim() : undefined;\n  const subject = typeof o.subject === 'string' ? o.subject.trim() : undefined;\n  const website = typeof o.website === 'string' ? o.website.trim() : '';\n\n  if (!email) return { ok: false, message: 'Email is required' };\n  if (!EMAIL_REGEX.test(email)) return { ok: false, message: 'Invalid email address' };\n  if (!message) return { ok: false, message: 'Message is required' };\n  if (website) return { ok: false, message: 'Invalid submission' };\n\n  return {\n    ok: true,\n    payload: { email, message, name, subject },\n  };\n}\n"],"mappings":"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","names":["nodemailer"]}

package/dist/handler/index.d.cts

@@ -0,0 +1,48 @@
+import { NextRequest } from 'next/server';
+
+/**
+ * SMTP options passed to Nodemailer createTransport().
+ */
+interface SmtpConfig {
+    host: string;
+    port: number;
+    secure?: boolean;
+    auth: {
+        user: string;
+        pass: string;
+    };
+}
+/**
+ * Configuration for the mailer route handler.
+ */
+interface MailerHandlerConfig {
+    /** Nodemailer-compatible SMTP config */
+    smtp: SmtpConfig;
+    /** Recipient email address */
+    to: string;
+    /** From address (and optional name, e.g. "Site <noreply@site.com>") */
+    from: string;
+    /** Optional rate limit: max requests per minute per IP */
+    rateLimit?: number;
+    /** Optional allowed origins for CORS (default: same origin) */
+    allowedOrigins?: string[];
+    /** Optional custom email body template. Receives payload and returns HTML string */
+    emailTemplate?: (payload: ContactPayload) => string;
+}
+/**
+ * Validated payload from the contact form (handler expectation).
+ */
+interface ContactPayload {
+    name?: string;
+    email: string;
+    phone?: string;
+    subject?: string;
+    message: string;
+    website?: string;
+}
+
+declare function createMailerHandler(config: MailerHandlerConfig): {
+    POST: (request: NextRequest) => Promise<Response>;
+};
+
+export { type ContactPayload, type MailerHandlerConfig, type SmtpConfig, createMailerHandler };

package/dist/handler/index.d.ts

@@ -0,0 +1,48 @@
+import { NextRequest } from 'next/server';
+
+/**
+ * SMTP options passed to Nodemailer createTransport().
+ */
+interface SmtpConfig {
+    host: string;
+    port: number;
+    secure?: boolean;
+    auth: {
+        user: string;
+        pass: string;
+    };
+}
+/**
+ * Configuration for the mailer route handler.
+ */
+interface MailerHandlerConfig {
+    /** Nodemailer-compatible SMTP config */
+    smtp: SmtpConfig;
+    /** Recipient email address */
+    to: string;
+    /** From address (and optional name, e.g. "Site <noreply@site.com>") */
+    from: string;
+    /** Optional rate limit: max requests per minute per IP */
+    rateLimit?: number;
+    /** Optional allowed origins for CORS (default: same origin) */
+    allowedOrigins?: string[];
+    /** Optional custom email body template. Receives payload and returns HTML string */
+    emailTemplate?: (payload: ContactPayload) => string;
+}
+/**
+ * Validated payload from the contact form (handler expectation).
+ */
+interface ContactPayload {
+    name?: string;
+    email: string;
+    phone?: string;
+    subject?: string;
+    message: string;
+    website?: string;
+}
+
+declare function createMailerHandler(config: MailerHandlerConfig): {
+    POST: (request: NextRequest) => Promise<Response>;
+};
+
+export { type ContactPayload, type MailerHandlerConfig, type SmtpConfig, createMailerHandler };