better-auth-cloudflare-email 0.1.0 → 0.2.0

package/README.md

@@ -130,7 +130,7 @@ import { betterAuth } from "better-auth";
 import { cloudflareEmail } from "better-auth-cloudflare-email";
 
 interface Env {
-  EMAIL: import("./auth/cloudflare-email").EmailBinding;
+  EMAIL: import("better-auth-cloudflare-email").EmailBinding;
   DB: D1Database;
 }
 
@@ -214,7 +214,7 @@ await email.sendRaw({
   attachments: [{
     filename: "invoice.pdf",
     content: base64String,
-    contentType: "application/pdf",
+    type: "application/pdf",
     disposition: "attachment",
   }],
 });

package/dist/index.cjs

@@ -128,7 +128,7 @@ function createWorkersTransport(opts) {
 }
 function createApiTransport(opts) {
   const baseUrl = opts.baseUrl ?? "https://api.cloudflare.com/client/v4";
-  const url = `${baseUrl}/accounts/${opts.accountId}/email-service/send`;
+  const url = `${baseUrl}/accounts/${opts.accountId}/email/sending/send`;
   return {
     async send(message) {
       const res = await fetch(url, {
@@ -144,7 +144,11 @@ function createApiTransport(opts) {
         throw new Error(`Cloudflare Email API error (${res.status}): ${body}`);
       }
       const json = await res.json();
-      return { messageId: json.result?.messageId ?? "" };
+      if (!json.success) {
+        const msg = json.errors?.map((e) => e.message).join(", ") ?? "Unknown error";
+        throw new Error(`Cloudflare Email API error: ${msg}`);
+      }
+      return json.result ?? { delivered: [], permanent_bounces: [], queued: [] };
     }
   };
 }

package/dist/index.d.cts

@@ -4,37 +4,50 @@
  * Two transports, one interface:
  *
  *   // Inside a Cloudflare Worker — uses the send_email binding (zero latency, no API key)
- *   import { cloudflareEmail } from "./cloudflare-email";
+ *   import { cloudflareEmail } from "better-auth-cloudflare-email";
  *   const email = cloudflareEmail.workers({ binding: env.EMAIL, from: "..." });
  *
  *   // Anywhere else — uses the Cloudflare REST API
- *   import { cloudflareEmail } from "./cloudflare-email";
+ *   import { cloudflareEmail } from "better-auth-cloudflare-email";
  *   const email = cloudflareEmail.api({ accountId: "...", apiToken: "...", from: "..." });
  *
  * Both return the same object shape — spread `email.config` into betterAuth()
  * and wire plugin callbacks identically.
  */
+type EmailAddress = string | {
+    address: string;
+    name: string;
+};
 interface EmailMessage {
     to: string | string[];
-    from: string;
+    from: EmailAddress;
     subject: string;
     html?: string;
     text?: string;
     cc?: string | string[];
     bcc?: string | string[];
-    replyTo?: string;
+    reply_to?: EmailAddress;
     headers?: Record<string, string>;
     attachments?: EmailAttachment[];
 }
-interface EmailAttachment {
+type EmailAttachment = InlineAttachment | StandardAttachment;
+interface InlineAttachment {
+    filename: string;
+    content: string;
+    type: string;
+    disposition: "inline";
+    content_id: string;
+}
+interface StandardAttachment {
     filename: string;
     content: string;
-    contentType: string;
-    disposition: "attachment" | "inline";
-    contentId?: string;
+    type: string;
+    disposition: "attachment";
 }
 interface EmailSendResult {
-    messageId: string;
+    delivered: string[];
+    permanent_bounces: string[];
+    queued: string[];
 }
 interface EmailTransport {
     send(message: EmailMessage): Promise<EmailSendResult>;
@@ -61,8 +74,8 @@ interface Templates {
     otp?: TemplateFn;
 }
 interface SharedOptions {
-    /** Default "from" address, e.g. "MyApp <noreply@myapp.com>". */
-    from: string;
+    /** Default "from" address. String or { address, name }. */
+    from: EmailAddress;
     /** Application name shown in email templates. Default: "Our App". */
     appName?: string;
     /** Override default email templates per type. */
@@ -74,9 +87,8 @@ interface EmailBinding {
     sendBatch?(messages: EmailMessage[]): Promise<{
         results: Array<{
             success: boolean;
-            messageId?: string;
             error?: string;
-        }>;
+        } & Partial<EmailSendResult>>;
     }>;
 }
 interface WorkersOptions extends SharedOptions {
@@ -220,4 +232,4 @@ declare const cloudflareEmail: {
     api(opts: ApiOptions): CloudflareEmailResult;
 };
 
-export { type ApiOptions, type EmailAttachment, type EmailBinding, type EmailMessage, type EmailSendResult, type EmailTransport, type TemplateData, type TemplateFn, type Templates, type WorkersOptions, cloudflareEmail };
+export { type ApiOptions, type EmailAddress, type EmailAttachment, type EmailBinding, type EmailMessage, type EmailSendResult, type EmailTransport, type InlineAttachment, type StandardAttachment, type TemplateData, type TemplateFn, type Templates, type WorkersOptions, cloudflareEmail };

package/dist/index.d.ts

@@ -4,37 +4,50 @@
  * Two transports, one interface:
  *
  *   // Inside a Cloudflare Worker — uses the send_email binding (zero latency, no API key)
- *   import { cloudflareEmail } from "./cloudflare-email";
+ *   import { cloudflareEmail } from "better-auth-cloudflare-email";
  *   const email = cloudflareEmail.workers({ binding: env.EMAIL, from: "..." });
  *
  *   // Anywhere else — uses the Cloudflare REST API
- *   import { cloudflareEmail } from "./cloudflare-email";
+ *   import { cloudflareEmail } from "better-auth-cloudflare-email";
  *   const email = cloudflareEmail.api({ accountId: "...", apiToken: "...", from: "..." });
  *
  * Both return the same object shape — spread `email.config` into betterAuth()
  * and wire plugin callbacks identically.
  */
+type EmailAddress = string | {
+    address: string;
+    name: string;
+};
 interface EmailMessage {
     to: string | string[];
-    from: string;
+    from: EmailAddress;
     subject: string;
     html?: string;
     text?: string;
     cc?: string | string[];
     bcc?: string | string[];
-    replyTo?: string;
+    reply_to?: EmailAddress;
     headers?: Record<string, string>;
     attachments?: EmailAttachment[];
 }
-interface EmailAttachment {
+type EmailAttachment = InlineAttachment | StandardAttachment;
+interface InlineAttachment {
+    filename: string;
+    content: string;
+    type: string;
+    disposition: "inline";
+    content_id: string;
+}
+interface StandardAttachment {
     filename: string;
     content: string;
-    contentType: string;
-    disposition: "attachment" | "inline";
-    contentId?: string;
+    type: string;
+    disposition: "attachment";
 }
 interface EmailSendResult {
-    messageId: string;
+    delivered: string[];
+    permanent_bounces: string[];
+    queued: string[];
 }
 interface EmailTransport {
     send(message: EmailMessage): Promise<EmailSendResult>;
@@ -61,8 +74,8 @@ interface Templates {
     otp?: TemplateFn;
 }
 interface SharedOptions {
-    /** Default "from" address, e.g. "MyApp <noreply@myapp.com>". */
-    from: string;
+    /** Default "from" address. String or { address, name }. */
+    from: EmailAddress;
     /** Application name shown in email templates. Default: "Our App". */
     appName?: string;
     /** Override default email templates per type. */
@@ -74,9 +87,8 @@ interface EmailBinding {
     sendBatch?(messages: EmailMessage[]): Promise<{
         results: Array<{
             success: boolean;
-            messageId?: string;
             error?: string;
-        }>;
+        } & Partial<EmailSendResult>>;
     }>;
 }
 interface WorkersOptions extends SharedOptions {
@@ -220,4 +232,4 @@ declare const cloudflareEmail: {
     api(opts: ApiOptions): CloudflareEmailResult;
 };
 
-export { type ApiOptions, type EmailAttachment, type EmailBinding, type EmailMessage, type EmailSendResult, type EmailTransport, type TemplateData, type TemplateFn, type Templates, type WorkersOptions, cloudflareEmail };
+export { type ApiOptions, type EmailAddress, type EmailAttachment, type EmailBinding, type EmailMessage, type EmailSendResult, type EmailTransport, type InlineAttachment, type StandardAttachment, type TemplateData, type TemplateFn, type Templates, type WorkersOptions, cloudflareEmail };

package/dist/index.js

@@ -102,7 +102,7 @@ function createWorkersTransport(opts) {
 }
 function createApiTransport(opts) {
   const baseUrl = opts.baseUrl ?? "https://api.cloudflare.com/client/v4";
-  const url = `${baseUrl}/accounts/${opts.accountId}/email-service/send`;
+  const url = `${baseUrl}/accounts/${opts.accountId}/email/sending/send`;
   return {
     async send(message) {
       const res = await fetch(url, {
@@ -118,7 +118,11 @@ function createApiTransport(opts) {
         throw new Error(`Cloudflare Email API error (${res.status}): ${body}`);
       }
       const json = await res.json();
-      return { messageId: json.result?.messageId ?? "" };
+      if (!json.success) {
+        const msg = json.errors?.map((e) => e.message).join(", ") ?? "Unknown error";
+        throw new Error(`Cloudflare Email API error: ${msg}`);
+      }
+      return json.result ?? { delivered: [], permanent_bounces: [], queued: [] };
     }
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "better-auth-cloudflare-email",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Send emails through Cloudflare Email Service from Better Auth — Workers binding and REST API transports",
   "license": "MIT",
   "author": "Paul Stenhouse",