@formepdf/resend 0.6.0 → 0.6.1

package/README.md

@@ -11,37 +11,29 @@ npm install @formepdf/resend resend @formepdf/react @formepdf/core
 ## Quick Start
 
 ```typescript
+import { renderDocument } from '@formepdf/core';
 import { sendPdf } from '@formepdf/resend';
+import { MyInvoice } from './templates/invoice';
 
+// Render the PDF first — works in plain .ts files
+const pdfBytes = await renderDocument(MyInvoice({ customer, items }));
+
+// Then email it
 const { data, error } = await sendPdf({
   resendApiKey: process.env.RESEND_API_KEY,
   from: 'Acme Corp <billing@acme.com>',
-  to: 'customer@email.com',
+  to: customer.email,
   subject: 'Invoice #001',
-  template: 'invoice',
-  data: {
-    invoiceNumber: 'INV-001',
-    date: 'February 25, 2026',
-    dueDate: 'March 27, 2026',
-    company: { name: 'Acme Corp', initials: 'AC', address: '123 Main St', cityStateZip: 'San Francisco, CA 94105', email: 'billing@acme.com' },
-    billTo: { name: 'Jane Smith', company: 'Smith Co', address: '456 Oak Ave', cityStateZip: 'Portland, OR 97201', email: 'jane@smith.co' },
-    shipTo: { name: 'Jane Smith', address: '456 Oak Ave', cityStateZip: 'Portland, OR 97201' },
-    items: [
-      { description: 'Consulting', quantity: 10, unitPrice: 150 },
-    ],
-    taxRate: 0.08,
-    paymentTerms: 'Net 30',
-  },
+  pdf: pdfBytes,
+  filename: 'invoice-001.pdf',
 });
-
-if (error) {
-  console.error(error.message);
-}
 ```
 
-One call. PDF rendered, email sent, invoice attached. Returns Resend's `{ data, error }` shape.
+Generate the PDF separately, email it with `sendPdf`. You control the rendering, and the same bytes can go to email + storage + whatever else. Returns Resend's `{ data, error }` directly.
+
+## Render Callback
 
-## Custom Templates
+For one-liners in `.tsx` files:
 
 ```typescript
 import { sendPdf } from '@formepdf/resend';
@@ -56,6 +48,35 @@ const { data, error } = await sendPdf({
 });
 ```
 
+## Built-in Templates
+
+Skip the render step and use a built-in template:
+
+```typescript
+import { sendPdf } from '@formepdf/resend';
+
+const { data, error } = await sendPdf({
+  resendApiKey: process.env.RESEND_API_KEY,
+  from: 'Acme Corp <billing@acme.com>',
+  to: 'customer@email.com',
+  subject: 'Invoice #001',
+  template: 'invoice',
+  data: {
+    invoiceNumber: 'INV-001',
+    date: 'February 25, 2026',
+    dueDate: 'March 27, 2026',
+    company: { name: 'Acme Corp', initials: 'AC', address: '123 Main St', cityStateZip: 'San Francisco, CA 94105', email: 'billing@acme.com' },
+    billTo: { name: 'Jane Smith', company: 'Smith Co', address: '456 Oak Ave', cityStateZip: 'Portland, OR 97201', email: 'jane@smith.co' },
+    shipTo: { name: 'Jane Smith', address: '456 Oak Ave', cityStateZip: 'Portland, OR 97201' },
+    items: [
+      { description: 'Consulting', quantity: 10, unitPrice: 150 },
+    ],
+    taxRate: 0.08,
+    paymentTerms: 'Net 30',
+  },
+});
+```
+
 ## Add PDF to an Existing Resend Call
 
 ```typescript
@@ -88,9 +109,10 @@ Render a PDF and email it. Returns Resend's `{ data, error }` shape directly.
 | `from` | `string` | Yes | Sender address |
 | `to` | `string \| string[]` | Yes | Recipient(s) |
 | `subject` | `string` | Yes | Email subject |
-| `template` | `string` | One of template/render | Built-in template name |
+| `pdf` | `Uint8Array` | One of pdf/render/template | Pre-rendered PDF bytes |
+| `render` | `() => ReactElement` | One of pdf/render/template | Render callback |
+| `template` | `string` | One of pdf/render/template | Built-in template name |
 | `data` | `object` | With template | Data for the template |
-| `render` | `() => ReactElement` | One of template/render | Custom render function |
 | `filename` | `string` | No | PDF filename (default: `{template}.pdf`) |
 | `html` | `string` | No | Email body HTML |
 | `text` | `string` | No | Email body plain text |

package/dist/send-pdf.js

@@ -3,22 +3,25 @@ import { renderDocument } from '@formepdf/core';
 import { getTemplate } from './templates/index.js';
 import { buildDefaultEmail } from './default-email.js';
 export async function sendPdf(options) {
-    const { resendApiKey, from, to, subject, template, data, render, filename, html, text, react, cc, bcc, replyTo, tags, headers, } = options;
-    let element;
-    if (render) {
-        element = render();
+    const { resendApiKey, from, to, subject, filename, html, text, react, cc, bcc, replyTo, tags, headers, } = options;
+    let pdfBytes;
+    if ('pdf' in options && options.pdf) {
+        pdfBytes = options.pdf;
     }
-    else if (template) {
-        const templateFn = getTemplate(template);
+    else if ('render' in options && options.render) {
+        pdfBytes = await renderDocument(options.render());
+    }
+    else if ('template' in options && options.template) {
+        const templateFn = getTemplate(options.template);
         if (!templateFn) {
-            throw new Error(`Unknown template: "${template}". Use listTemplates() to see available templates.`);
+            throw new Error(`Unknown template: "${options.template}". Use listTemplates() to see available templates.`);
         }
-        element = templateFn(data || {});
+        pdfBytes = await renderDocument(templateFn(options.data || {}));
     }
     else {
-        throw new Error('Either "template" or "render" must be provided.');
+        throw new Error('One of "pdf", "render", or "template" must be provided.');
     }
-    const pdfBytes = await renderDocument(element);
+    const template = 'template' in options ? options.template : undefined;
     const pdfFilename = filename || `${template || 'document'}.pdf`;
     const attachment = {
         filename: pdfFilename,
@@ -27,6 +30,7 @@ export async function sendPdf(options) {
     let emailHtml = html;
     let emailText = text;
     if (!html && !text && !react) {
+        const data = 'data' in options ? options.data : undefined;
         const defaultEmail = buildDefaultEmail(template, data);
         emailHtml = defaultEmail.html;
         emailText = defaultEmail.text;

package/dist/types.d.ts

@@ -17,17 +17,25 @@ interface BaseOptions {
     }[];
     headers?: Record<string, string>;
 }
+interface PdfBytesOptions extends BaseOptions {
+    pdf: Uint8Array;
+    template?: never;
+    data?: never;
+    render?: never;
+}
 interface TemplateOptions extends BaseOptions {
+    pdf?: never;
     template: string;
     data?: Record<string, any>;
     render?: never;
 }
 interface RenderOptions extends BaseOptions {
+    pdf?: never;
     template?: never;
     data?: never;
     render: () => ReactElement;
 }
-export type SendPdfOptions = TemplateOptions | RenderOptions;
+export type SendPdfOptions = PdfBytesOptions | TemplateOptions | RenderOptions;
 export interface RenderAttachOptions {
     template?: string;
     data?: Record<string, any>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formepdf/resend",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Render a PDF and email it in one call — Forme + Resend",
   "type": "module",
   "main": "./dist/index.js",
@@ -12,8 +12,8 @@
     "dist"
   ],
   "dependencies": {
-    "@formepdf/react": "0.6.0",
-    "@formepdf/core": "0.6.0"
+    "@formepdf/react": "0.6.1",
+    "@formepdf/core": "0.6.1"
   },
   "peerDependencies": {
     "resend": ">=3.0.0"