@parsrun/email 0.1.0

package/dist/providers/index.js

@@ -0,0 +1,621 @@
+// src/types.ts
+import {
+  type,
+  emailAddress,
+  emailAttachment,
+  sendEmailOptions,
+  sendTemplateEmailOptions,
+  emailSendResult,
+  smtpConfig,
+  resendConfig,
+  sendgridConfig,
+  sesConfig,
+  postmarkConfig,
+  emailConfig
+} from "@parsrun/types";
+var EmailError = class extends Error {
+  constructor(message, code, cause) {
+    super(message);
+    this.code = code;
+    this.cause = cause;
+    this.name = "EmailError";
+  }
+};
+var EmailErrorCodes = {
+  INVALID_CONFIG: "INVALID_CONFIG",
+  INVALID_RECIPIENT: "INVALID_RECIPIENT",
+  INVALID_CONTENT: "INVALID_CONTENT",
+  SEND_FAILED: "SEND_FAILED",
+  RATE_LIMITED: "RATE_LIMITED",
+  PROVIDER_ERROR: "PROVIDER_ERROR",
+  TEMPLATE_ERROR: "TEMPLATE_ERROR",
+  ATTACHMENT_ERROR: "ATTACHMENT_ERROR"
+};
+
+// src/providers/resend.ts
+var ResendProvider = class {
+  type = "resend";
+  apiKey;
+  fromEmail;
+  fromName;
+  baseUrl = "https://api.resend.com";
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.fromEmail = config.fromEmail;
+    this.fromName = config.fromName;
+  }
+  formatAddress(address) {
+    if (typeof address === "string") {
+      return address;
+    }
+    if (address.name) {
+      return `${address.name} <${address.email}>`;
+    }
+    return address.email;
+  }
+  formatAddresses(addresses) {
+    if (Array.isArray(addresses)) {
+      return addresses.map((a) => this.formatAddress(a));
+    }
+    return [this.formatAddress(addresses)];
+  }
+  async send(options) {
+    const from = options.from ? this.formatAddress(options.from) : this.fromName ? `${this.fromName} <${this.fromEmail}>` : this.fromEmail;
+    const payload = {
+      from,
+      to: this.formatAddresses(options.to),
+      subject: options.subject
+    };
+    if (options.html) payload["html"] = options.html;
+    if (options.text) payload["text"] = options.text;
+    if (options.replyTo) payload["reply_to"] = this.formatAddress(options.replyTo);
+    if (options.cc) payload["cc"] = this.formatAddresses(options.cc);
+    if (options.bcc) payload["bcc"] = this.formatAddresses(options.bcc);
+    if (options.headers) payload["headers"] = options.headers;
+    if (options.tags) payload["tags"] = Object.entries(options.tags).map(([name, value]) => ({ name, value }));
+    if (options.scheduledAt) payload["scheduled_at"] = options.scheduledAt.toISOString();
+    if (options.attachments && options.attachments.length > 0) {
+      payload["attachments"] = options.attachments.map((att) => ({
+        filename: att.filename,
+        content: typeof att.content === "string" ? att.content : this.uint8ArrayToBase64(att.content),
+        content_type: att.contentType
+      }));
+    }
+    try {
+      const response = await fetch(`${this.baseUrl}/emails`, {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(payload)
+      });
+      const data = await response.json();
+      if (!response.ok) {
+        return {
+          success: false,
+          error: data.message || `HTTP ${response.status}`,
+          data
+        };
+      }
+      return {
+        success: true,
+        messageId: data.id,
+        data
+      };
+    } catch (err) {
+      throw new EmailError(
+        `Resend send failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        EmailErrorCodes.SEND_FAILED,
+        err
+      );
+    }
+  }
+  async sendBatch(options) {
+    const results = [];
+    let successful = 0;
+    let failed = 0;
+    for (const email of options.emails) {
+      try {
+        const result = await this.send(email);
+        results.push(result);
+        if (result.success) {
+          successful++;
+        } else {
+          failed++;
+          if (options.stopOnError) break;
+        }
+      } catch (err) {
+        failed++;
+        results.push({
+          success: false,
+          error: err instanceof Error ? err.message : "Unknown error"
+        });
+        if (options.stopOnError) break;
+      }
+    }
+    return {
+      total: options.emails.length,
+      successful,
+      failed,
+      results
+    };
+  }
+  async verify() {
+    try {
+      const response = await fetch(`${this.baseUrl}/domains`, {
+        headers: {
+          "Authorization": `Bearer ${this.apiKey}`
+        }
+      });
+      return response.ok;
+    } catch {
+      return false;
+    }
+  }
+  uint8ArrayToBase64(data) {
+    let binary = "";
+    for (let i = 0; i < data.length; i++) {
+      const byte = data[i];
+      if (byte !== void 0) {
+        binary += String.fromCharCode(byte);
+      }
+    }
+    return btoa(binary);
+  }
+};
+function createResendProvider(config) {
+  return new ResendProvider(config);
+}
+
+// src/providers/sendgrid.ts
+var SendGridProvider = class {
+  type = "sendgrid";
+  apiKey;
+  fromEmail;
+  fromName;
+  baseUrl = "https://api.sendgrid.com/v3";
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.fromEmail = config.fromEmail;
+    this.fromName = config.fromName;
+  }
+  formatAddress(address) {
+    if (typeof address === "string") {
+      return { email: address };
+    }
+    return address.name ? { email: address.email, name: address.name } : { email: address.email };
+  }
+  formatAddresses(addresses) {
+    if (Array.isArray(addresses)) {
+      return addresses.map((a) => this.formatAddress(a));
+    }
+    return [this.formatAddress(addresses)];
+  }
+  async send(options) {
+    const from = options.from ? this.formatAddress(options.from) : this.fromName ? { email: this.fromEmail, name: this.fromName } : { email: this.fromEmail };
+    const personalization = {
+      to: this.formatAddresses(options.to)
+    };
+    if (options.cc) {
+      personalization.cc = this.formatAddresses(options.cc);
+    }
+    if (options.bcc) {
+      personalization.bcc = this.formatAddresses(options.bcc);
+    }
+    if (options.headers) {
+      personalization.headers = options.headers;
+    }
+    const payload = {
+      personalizations: [personalization],
+      from,
+      subject: options.subject,
+      content: []
+    };
+    const content = [];
+    if (options.text) {
+      content.push({ type: "text/plain", value: options.text });
+    }
+    if (options.html) {
+      content.push({ type: "text/html", value: options.html });
+    }
+    payload["content"] = content;
+    if (options.replyTo) {
+      payload["reply_to"] = this.formatAddress(options.replyTo);
+    }
+    if (options.attachments && options.attachments.length > 0) {
+      payload["attachments"] = options.attachments.map((att) => ({
+        filename: att.filename,
+        content: typeof att.content === "string" ? att.content : this.uint8ArrayToBase64(att.content),
+        type: att.contentType,
+        content_id: att.contentId,
+        disposition: att.contentId ? "inline" : "attachment"
+      }));
+    }
+    if (options.scheduledAt) {
+      payload["send_at"] = Math.floor(options.scheduledAt.getTime() / 1e3);
+    }
+    try {
+      const response = await fetch(`${this.baseUrl}/mail/send`, {
+        method: "POST",
+        headers: {
+          "Authorization": `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(payload)
+      });
+      if (response.status === 202) {
+        const messageId = response.headers.get("x-message-id");
+        return {
+          success: true,
+          messageId: messageId ?? void 0
+        };
+      }
+      const data = await response.json().catch(() => ({}));
+      const errorMessage = data.errors?.[0]?.message || `HTTP ${response.status}`;
+      return {
+        success: false,
+        error: errorMessage,
+        data
+      };
+    } catch (err) {
+      throw new EmailError(
+        `SendGrid send failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        EmailErrorCodes.SEND_FAILED,
+        err
+      );
+    }
+  }
+  async sendBatch(options) {
+    const results = [];
+    let successful = 0;
+    let failed = 0;
+    for (const email of options.emails) {
+      try {
+        const result = await this.send(email);
+        results.push(result);
+        if (result.success) {
+          successful++;
+        } else {
+          failed++;
+          if (options.stopOnError) break;
+        }
+      } catch (err) {
+        failed++;
+        results.push({
+          success: false,
+          error: err instanceof Error ? err.message : "Unknown error"
+        });
+        if (options.stopOnError) break;
+      }
+    }
+    return {
+      total: options.emails.length,
+      successful,
+      failed,
+      results
+    };
+  }
+  async verify() {
+    try {
+      const response = await fetch(`${this.baseUrl}/scopes`, {
+        headers: {
+          "Authorization": `Bearer ${this.apiKey}`
+        }
+      });
+      return response.ok;
+    } catch {
+      return false;
+    }
+  }
+  uint8ArrayToBase64(data) {
+    let binary = "";
+    for (let i = 0; i < data.length; i++) {
+      const byte = data[i];
+      if (byte !== void 0) {
+        binary += String.fromCharCode(byte);
+      }
+    }
+    return btoa(binary);
+  }
+};
+function createSendGridProvider(config) {
+  return new SendGridProvider(config);
+}
+
+// src/providers/postmark.ts
+var PostmarkProvider = class {
+  type = "postmark";
+  apiKey;
+  fromEmail;
+  fromName;
+  baseUrl = "https://api.postmarkapp.com";
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.fromEmail = config.fromEmail;
+    this.fromName = config.fromName;
+  }
+  formatAddress(address) {
+    if (typeof address === "string") {
+      return address;
+    }
+    if (address.name) {
+      return `${address.name} <${address.email}>`;
+    }
+    return address.email;
+  }
+  formatAddresses(addresses) {
+    if (Array.isArray(addresses)) {
+      return addresses.map((a) => this.formatAddress(a)).join(",");
+    }
+    return this.formatAddress(addresses);
+  }
+  async send(options) {
+    const from = options.from ? this.formatAddress(options.from) : this.fromName ? `${this.fromName} <${this.fromEmail}>` : this.fromEmail;
+    const payload = {
+      From: from,
+      To: this.formatAddresses(options.to),
+      Subject: options.subject
+    };
+    if (options.html) payload["HtmlBody"] = options.html;
+    if (options.text) payload["TextBody"] = options.text;
+    if (options.replyTo) payload["ReplyTo"] = this.formatAddress(options.replyTo);
+    if (options.cc) payload["Cc"] = this.formatAddresses(options.cc);
+    if (options.bcc) payload["Bcc"] = this.formatAddresses(options.bcc);
+    if (options.headers) {
+      payload["Headers"] = Object.entries(options.headers).map(([Name, Value]) => ({ Name, Value }));
+    }
+    if (options.tags) {
+      const tagEntries = Object.entries(options.tags);
+      if (tagEntries.length > 0 && tagEntries[0]) {
+        payload["Tag"] = tagEntries[0][1];
+      }
+      payload["Metadata"] = options.tags;
+    }
+    if (options.attachments && options.attachments.length > 0) {
+      payload["Attachments"] = options.attachments.map((att) => ({
+        Name: att.filename,
+        Content: typeof att.content === "string" ? att.content : this.uint8ArrayToBase64(att.content),
+        ContentType: att.contentType || "application/octet-stream",
+        ContentID: att.contentId
+      }));
+    }
+    try {
+      const response = await fetch(`${this.baseUrl}/email`, {
+        method: "POST",
+        headers: {
+          "X-Postmark-Server-Token": this.apiKey,
+          "Content-Type": "application/json",
+          "Accept": "application/json"
+        },
+        body: JSON.stringify(payload)
+      });
+      const data = await response.json();
+      if (!response.ok || data.ErrorCode) {
+        return {
+          success: false,
+          error: data.Message || `HTTP ${response.status}`,
+          data
+        };
+      }
+      return {
+        success: true,
+        messageId: data.MessageID,
+        data
+      };
+    } catch (err) {
+      throw new EmailError(
+        `Postmark send failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        EmailErrorCodes.SEND_FAILED,
+        err
+      );
+    }
+  }
+  async sendBatch(options) {
+    const batchPayload = options.emails.map((email) => {
+      const from = email.from ? this.formatAddress(email.from) : this.fromName ? `${this.fromName} <${this.fromEmail}>` : this.fromEmail;
+      const item = {
+        From: from,
+        To: this.formatAddresses(email.to),
+        Subject: email.subject
+      };
+      if (email.html) item["HtmlBody"] = email.html;
+      if (email.text) item["TextBody"] = email.text;
+      if (email.replyTo) item["ReplyTo"] = this.formatAddress(email.replyTo);
+      if (email.cc) item["Cc"] = this.formatAddresses(email.cc);
+      if (email.bcc) item["Bcc"] = this.formatAddresses(email.bcc);
+      return item;
+    });
+    try {
+      const response = await fetch(`${this.baseUrl}/email/batch`, {
+        method: "POST",
+        headers: {
+          "X-Postmark-Server-Token": this.apiKey,
+          "Content-Type": "application/json",
+          "Accept": "application/json"
+        },
+        body: JSON.stringify(batchPayload)
+      });
+      const data = await response.json();
+      const results = data.map((item) => ({
+        success: !item.ErrorCode,
+        messageId: item.MessageID,
+        error: item.ErrorCode ? item.Message : void 0,
+        data: item
+      }));
+      const successful = results.filter((r) => r.success).length;
+      const failed = results.filter((r) => !r.success).length;
+      return {
+        total: options.emails.length,
+        successful,
+        failed,
+        results
+      };
+    } catch (err) {
+      throw new EmailError(
+        `Postmark batch send failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        EmailErrorCodes.SEND_FAILED,
+        err
+      );
+    }
+  }
+  async verify() {
+    try {
+      const response = await fetch(`${this.baseUrl}/server`, {
+        headers: {
+          "X-Postmark-Server-Token": this.apiKey,
+          "Accept": "application/json"
+        }
+      });
+      return response.ok;
+    } catch {
+      return false;
+    }
+  }
+  uint8ArrayToBase64(data) {
+    let binary = "";
+    for (let i = 0; i < data.length; i++) {
+      const byte = data[i];
+      if (byte !== void 0) {
+        binary += String.fromCharCode(byte);
+      }
+    }
+    return btoa(binary);
+  }
+};
+function createPostmarkProvider(config) {
+  return new PostmarkProvider(config);
+}
+
+// src/providers/console.ts
+var ConsoleProvider = class {
+  type = "console";
+  fromEmail;
+  fromName;
+  messageCounter = 0;
+  constructor(config) {
+    this.fromEmail = config.fromEmail;
+    this.fromName = config.fromName;
+  }
+  formatAddress(address) {
+    if (typeof address === "string") {
+      return address;
+    }
+    if (address.name) {
+      return `${address.name} <${address.email}>`;
+    }
+    return address.email;
+  }
+  formatAddresses(addresses) {
+    if (Array.isArray(addresses)) {
+      return addresses.map((a) => this.formatAddress(a)).join(", ");
+    }
+    return this.formatAddress(addresses);
+  }
+  async send(options) {
+    this.messageCounter++;
+    const messageId = `console-${Date.now()}-${this.messageCounter}`;
+    const from = options.from ? this.formatAddress(options.from) : this.fromName ? `${this.fromName} <${this.fromEmail}>` : this.fromEmail;
+    const separator = "\u2500".repeat(60);
+    console.log(`
+${separator}`);
+    console.log("\u{1F4E7} EMAIL (Console Provider)");
+    console.log(separator);
+    console.log(`Message ID: ${messageId}`);
+    console.log(`From:       ${from}`);
+    console.log(`To:         ${this.formatAddresses(options.to)}`);
+    if (options.cc) {
+      console.log(`CC:         ${this.formatAddresses(options.cc)}`);
+    }
+    if (options.bcc) {
+      console.log(`BCC:        ${this.formatAddresses(options.bcc)}`);
+    }
+    if (options.replyTo) {
+      console.log(`Reply-To:   ${this.formatAddress(options.replyTo)}`);
+    }
+    console.log(`Subject:    ${options.subject}`);
+    if (options.headers) {
+      console.log(`Headers:    ${JSON.stringify(options.headers)}`);
+    }
+    if (options.tags) {
+      console.log(`Tags:       ${JSON.stringify(options.tags)}`);
+    }
+    if (options.scheduledAt) {
+      console.log(`Scheduled:  ${options.scheduledAt.toISOString()}`);
+    }
+    if (options.attachments && options.attachments.length > 0) {
+      console.log(`Attachments:`);
+      for (const att of options.attachments) {
+        const size = typeof att.content === "string" ? att.content.length : att.content.length;
+        console.log(`  - ${att.filename} (${att.contentType || "unknown"}, ${size} bytes)`);
+      }
+    }
+    console.log(separator);
+    if (options.text) {
+      console.log("TEXT CONTENT:");
+      console.log(options.text);
+    }
+    if (options.html) {
+      console.log("HTML CONTENT:");
+      console.log(options.html);
+    }
+    console.log(`${separator}
+`);
+    return {
+      success: true,
+      messageId
+    };
+  }
+  async sendBatch(options) {
+    const results = [];
+    let successful = 0;
+    let failed = 0;
+    console.log(`
+\u{1F4EC} BATCH EMAIL (${options.emails.length} emails)`);
+    for (const email of options.emails) {
+      try {
+        const result = await this.send(email);
+        results.push(result);
+        if (result.success) {
+          successful++;
+        } else {
+          failed++;
+          if (options.stopOnError) break;
+        }
+      } catch (err) {
+        failed++;
+        results.push({
+          success: false,
+          error: err instanceof Error ? err.message : "Unknown error"
+        });
+        if (options.stopOnError) break;
+      }
+    }
+    console.log(`\u{1F4EC} BATCH COMPLETE: ${successful} sent, ${failed} failed
+`);
+    return {
+      total: options.emails.length,
+      successful,
+      failed,
+      results
+    };
+  }
+  async verify() {
+    console.log("\u{1F4E7} Console email provider verified (always returns true)");
+    return true;
+  }
+};
+function createConsoleProvider(config) {
+  return new ConsoleProvider(config);
+}
+export {
+  ConsoleProvider,
+  PostmarkProvider,
+  ResendProvider,
+  SendGridProvider,
+  createConsoleProvider,
+  createPostmarkProvider,
+  createResendProvider,
+  createSendGridProvider
+};
+//# sourceMappingURL=index.js.map