hubmail 1.0.7 → 1.0.9

package/README.md

@@ -54,21 +54,18 @@ const options: SendEmailOptions = {
 
 ### Sending Emails
 
-Send a single email to one or multiple recipients.
+Send a single email to one or multiple recipients. Supports both simple email strings and formatted addresses like `"Name <email@example.com>"` or objects `{ name: "Name", email: "email@example.com" }`.
 
 ```typescript
 try {
   const result = await hubmail.send({
-    from: "sender@hubmail.space",
-    to: ["recipient@example.com"],
+    from: "Acme <sender@hubmail.space>",
+    to: [{ name: "Recipient", email: "recipient@example.com" }],
     cc: ["manager@example.com"],
     bcc: ["archive@example.com"],
     subject: "Hello from HubMail",
     text: "This is a plain text email.",
     html: "<p>This is an <b>HTML</b> email.</p>",
-    // Optional: Use a template
-    // templateId: "tmpl_123456",
-    // variables: { name: "Alice", orderId: "123" }
   });
 
   console.log("Email sent! ID:", result.id);

package/dist/index.d.ts

@@ -1,14 +1,18 @@
+export type Address = string | {
+    name?: string;
+    email: string;
+};
 export interface SendEmailOptions {
-    /** Sender email address (e.g., "sender@hubmail.space") */
-    from: string;
+    /** Sender email address (e.g., "sender@hubmail.space" or "Acme <billing@hubfly.cloud>") */
+    from: Address;
     /** Primary recipient(s) */
-    to: string | string[];
+    to: Address | Address[];
     /** Carbon copy recipient(s) */
-    cc?: string | string[];
+    cc?: Address | Address[];
     /** Blind carbon copy recipient(s) */
-    bcc?: string | string[];
+    bcc?: Address | Address[];
     /** Reply-to email address */
-    replyTo?: string;
+    replyTo?: Address;
     /** Email subject line. Required if templateId is not provided. */
     subject?: string;
     /** Plain text version of the email */
@@ -28,7 +32,7 @@ export interface ScheduleEmailOptions {
     /** When the email should be sent (ISO string). Must be at least 5 min in future. */
     scheduledAt: string;
     /** Recipients. Required if mailbookId is not provided. */
-    to?: string | string[];
+    to?: Address | Address[];
     /** Send to all contacts in this mailbook. */
     mailbookId?: string;
     /** Template to use for scheduling. */

package/dist/index.js

@@ -1,2 +1,2 @@
 // @bun
-class C extends Error{status;details;constructor(z,j,q){super(z);this.name="HubMailError",this.status=j,this.details=q}}class G{apiKey;baseUrl;constructor(z={}){let j=z.apiKey??process.env.HUBMAIL_KEY;if(!j)throw Error("HubMail API key is required. Provide it in the constructor or set the HUBMAIL_KEY environment variable.");this.apiKey=j,this.baseUrl=(z.baseUrl??"https://hubmail.space").replace(/\/$/,"")}async send(z){let j=await fetch(`${this.baseUrl}/api/v1/send`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},body:JSON.stringify(z)}),q=await j.json();if(!j.ok){let B=q;throw new C(B.error||"Failed to send email",j.status,B.details)}return q}async schedule(z){let j=await fetch(`${this.baseUrl}/api/v1/schedule`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},body:JSON.stringify(z)}),q=await j.json();if(!j.ok){let B=q;throw new C(B.error||"Failed to schedule email",j.status,B.details)}return q}async listMailbooks(){let z=await fetch(`${this.baseUrl}/api/v1/mailbooks`,{method:"GET",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"}}),j=await z.json();if(!z.ok){let q=j;throw new C(q.error||"Failed to list mailbooks",z.status,q.details)}return j}async listContacts(z){let j=await fetch(`${this.baseUrl}/api/v1/mailbooks/${z}/contacts`,{method:"GET",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"}}),q=await j.json();if(!j.ok){let B=q;throw new C(B.error||"Failed to list contacts",j.status,B.details)}return q}async addContact(z,j){let q=await fetch(`${this.baseUrl}/api/v1/mailbooks/${z}/contacts`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},body:JSON.stringify(j)}),B=await q.json();if(!q.ok){let F=B;throw new C(F.error||"Failed to add contact",q.status,F.details)}return B}}var L=G;export{L as default,C as HubMailError,G as HubMail};
+function L(j){if(typeof j==="string")return j;return j.name?`${j.name} <${j.email}>`:j.email}function J(j){if(Array.isArray(j))return j.map(L);return L(j)}class G extends Error{status;details;constructor(j,B,q){super(j);this.name="HubMailError",this.status=B,this.details=q}}class N{apiKey;baseUrl;constructor(j={}){let B=j.apiKey??process.env.HUBMAIL_KEY;if(!B)throw Error("HubMail API key is required. Provide it in the constructor or set the HUBMAIL_KEY environment variable.");this.apiKey=B,this.baseUrl=(j.baseUrl??"https://hubmail.space").replace(/\/$/,"")}async send(j){let B={...j,from:L(j.from),to:J(j.to),cc:j.cc?J(j.cc):void 0,bcc:j.bcc?J(j.bcc):void 0,replyTo:j.replyTo?L(j.replyTo):void 0},q=await fetch(`${this.baseUrl}/api/v1/send`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},body:JSON.stringify(B)}),C=await q.json();if(!q.ok){let F=C;throw new G(F.error||"Failed to send email",q.status,F.details)}return C}async schedule(j){let B={...j,to:j.to?J(j.to):void 0},q=await fetch(`${this.baseUrl}/api/v1/schedule`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},body:JSON.stringify(B)}),C=await q.json();if(!q.ok){let F=C;throw new G(F.error||"Failed to schedule email",q.status,F.details)}return C}async listMailbooks(){let j=await fetch(`${this.baseUrl}/api/v1/mailbooks`,{method:"GET",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"}}),B=await j.json();if(!j.ok){let q=B;throw new G(q.error||"Failed to list mailbooks",j.status,q.details)}return B}async listContacts(j){let B=await fetch(`${this.baseUrl}/api/v1/mailbooks/${j}/contacts`,{method:"GET",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"}}),q=await B.json();if(!B.ok){let C=q;throw new G(C.error||"Failed to list contacts",B.status,C.details)}return q}async addContact(j,B){let q=await fetch(`${this.baseUrl}/api/v1/mailbooks/${j}/contacts`,{method:"POST",headers:{Authorization:`Bearer ${this.apiKey}`,"Content-Type":"application/json"},body:JSON.stringify(B)}),C=await q.json();if(!q.ok){let F=C;throw new G(F.error||"Failed to add contact",q.status,F.details)}return C}}var P=N;export{P as default,G as HubMailError,N as HubMail};

package/package.json

@@ -3,7 +3,7 @@
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "type": "module",
   "files": [
     "dist"