@formepdf/resend 0.5.0 → 0.6.1

package/README.md

@@ -11,9 +11,51 @@ 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';
 
-await sendPdf({
+// 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,
+  subject: 'Invoice #001',
+  pdf: pdfBytes,
+  filename: 'invoice-001.pdf',
+});
+```
+
+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
+
+For one-liners in `.tsx` files:
+
+```typescript
+import { sendPdf } from '@formepdf/resend';
+import { MyTemplate } from './my-template';
+
+const { data, error } = await sendPdf({
+  resendApiKey: process.env.RESEND_API_KEY,
+  from: 'billing@acme.com',
+  to: 'customer@email.com',
+  subject: 'Your document',
+  render: () => MyTemplate({ name: 'Jane' }),
+});
+```
+
+## 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',
@@ -35,23 +77,6 @@ await sendPdf({
 });
 ```
 
-One call. PDF rendered, email sent, invoice attached.
-
-## Custom Templates
-
-```typescript
-import { sendPdf } from '@formepdf/resend';
-import { MyTemplate } from './my-template';
-
-await sendPdf({
-  resendApiKey: process.env.RESEND_API_KEY,
-  from: 'billing@acme.com',
-  to: 'customer@email.com',
-  subject: 'Your document',
-  render: () => MyTemplate({ name: 'Jane' }),
-});
-```
-
 ## Add PDF to an Existing Resend Call
 
 ```typescript
@@ -76,7 +101,7 @@ await resend.emails.send({
 
 ### `sendPdf(options)`
 
-Render a PDF and email it. Returns `Promise<{ id: string }>` (Resend's email ID).
+Render a PDF and email it. Returns Resend's `{ data, error }` shape directly.
 
 | Option | Type | Required | Description |
 |--------|------|----------|-------------|
@@ -84,9 +109,10 @@ Render a PDF and email it. Returns `Promise<{ id: string }>` (Resend's email ID)
 | `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.d.ts

@@ -1,4 +1,2 @@
 import type { SendPdfOptions } from './types.js';
-export declare function sendPdf(options: SendPdfOptions): Promise<{
-    id: string;
-}>;
+export declare function sendPdf(options: SendPdfOptions): Promise<import("resend").CreateEmailResponse>;

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;
@@ -54,9 +58,5 @@ export async function sendPdf(options) {
         emailPayload.tags = tags;
     if (headers)
         emailPayload.headers = headers;
-    const { data: result, error } = await resend.emails.send(emailPayload);
-    if (error) {
-        throw new Error(`Resend error: ${error.message}`);
-    }
-    return { id: result.id };
+    return resend.emails.send(emailPayload);
 }

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.5.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.5.0",
-    "@formepdf/core": "0.5.0"
+    "@formepdf/react": "0.6.1",
+    "@formepdf/core": "0.6.1"
   },
   "peerDependencies": {
     "resend": ">=3.0.0"