@skoolite/notify-hub 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -337,20 +337,15 @@ interface MetaWhatsAppConfig {
     webhookVerifyToken?: string;
 }
 /**
- * AWS SES email provider configuration
+ * Resend email provider configuration
  */
-interface SesConfig {
-    /** AWS region */
-    region: string;
-    /** Default from address */
+interface ResendConfig {
+    /** Resend API key */
+    apiKey: string;
+    /** Default from address (must be verified domain) */
     fromAddress: string;
     /** Default from name */
     fromName?: string;
-    /** AWS credentials (optional, will use default credential chain) */
-    credentials?: {
-        accessKeyId: string;
-        secretAccessKey: string;
-    };
 }
 /**
  * Provider-specific configuration union
@@ -373,8 +368,8 @@ type WhatsAppProviderConfig = {
     instance: WhatsAppProvider;
 };
 type EmailProviderConfig = {
-    provider: 'ses';
-    config: SesConfig;
+    provider: 'resend';
+    config: ResendConfig;
 } | {
     provider: 'custom';
     instance: EmailProvider;
@@ -825,6 +820,46 @@ declare class MetaWhatsAppProvider implements WhatsAppProvider {
     destroy(): Promise<void>;
 }
 
+/**
+ * Resend email provider implementation
+ * @see https://resend.com/docs/api-reference/emails/send-email
+ */
+declare class ResendEmailProvider implements EmailProvider {
+    readonly name = "resend";
+    private readonly config;
+    private readonly logger?;
+    private readonly retryConfig;
+    private readonly baseUrl;
+    constructor(config: ResendConfig, options?: {
+        logger?: Logger;
+        retryConfig?: RetryConfig;
+    });
+    /**
+     * Initialize the provider (no-op for Resend, uses REST API)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Build the "from" field with optional name
+     */
+    private buildFrom;
+    /**
+     * Send an email
+     */
+    send(to: string, email: EmailMessage, options?: EmailOptions): Promise<SendResult>;
+    /**
+     * Send bulk emails using Resend batch API
+     */
+    sendBulk(messages: EmailMessageWithRecipient[], options?: BulkOptions): Promise<BulkResult>;
+    /**
+     * Basic email validation
+     */
+    private isValidEmail;
+    /**
+     * Cleanup resources
+     */
+    destroy(): Promise<void>;
+}
+
 /**
  * Twilio webhook payload for message status updates
  */
@@ -1077,4 +1112,4 @@ declare function getPakistanNetwork(phone: string): 'jazz' | 'telenor' | 'zong'
  */
 declare function routeByPrefix(phone: string, routing: Record<string, 'primary' | 'fallback'>): 'primary' | 'fallback';
 
-export { BaseLocalSmsProvider, type BaseProvider, type BulkOptions, type BulkResult, type BulkSummary, type Channel, type Cost, DEFAULT_RETRY_CONFIG, type EmailAttachment, type EmailMessage, type EmailMessageWithRecipient, type EmailOptions, type EmailProvider, type EmailProviderConfig, type IncomingMessageEvent, JazzSmsProvider, type LocalSmsConfig, type Logger, type MessageStatus, type MetaWhatsAppConfig, MetaWhatsAppProvider, type Notification, type NotifyError, NotifyHub, type NotifyHubConfig, type RateLimitConfig, type RetryConfig, type RoutingConfig, type SendResult, type SesConfig, type SmsChannelConfig, type SmsMessage, type SmsOptions, type SmsProvider, type SmsProviderConfig, type StatusWebhookEvent, TelenorSmsProvider, type TwilioConfig, TwilioSmsProvider, TwilioWebhookHandler, type WebhookEvent, type WebhookHandler, type WhatsAppMessage, type WhatsAppOptions, type WhatsAppProvider, type WhatsAppProviderConfig, type WhatsAppTemplate, type WhatsAppTemplateButton, type WhatsAppTemplateHeader, WhatsAppWebhookHandler, ZongSmsProvider, calculateBackoff, cleanPhoneNumber, createNotifyError, createTwilioWebhookHandler, createWhatsAppWebhookHandler, getCallingCode, getCountryCode, getPakistanNetwork, isCountry, isPakistanMobile, isRetriableError, routeByPrefix, toE164, validatePhoneNumber, withRetry };
+export { BaseLocalSmsProvider, type BaseProvider, type BulkOptions, type BulkResult, type BulkSummary, type Channel, type Cost, DEFAULT_RETRY_CONFIG, type EmailAttachment, type EmailMessage, type EmailMessageWithRecipient, type EmailOptions, type EmailProvider, type EmailProviderConfig, type IncomingMessageEvent, JazzSmsProvider, type LocalSmsConfig, type Logger, type MessageStatus, type MetaWhatsAppConfig, MetaWhatsAppProvider, type Notification, type NotifyError, NotifyHub, type NotifyHubConfig, type RateLimitConfig, type ResendConfig, ResendEmailProvider, type RetryConfig, type RoutingConfig, type SendResult, type SmsChannelConfig, type SmsMessage, type SmsOptions, type SmsProvider, type SmsProviderConfig, type StatusWebhookEvent, TelenorSmsProvider, type TwilioConfig, TwilioSmsProvider, TwilioWebhookHandler, type WebhookEvent, type WebhookHandler, type WhatsAppMessage, type WhatsAppOptions, type WhatsAppProvider, type WhatsAppProviderConfig, type WhatsAppTemplate, type WhatsAppTemplateButton, type WhatsAppTemplateHeader, WhatsAppWebhookHandler, ZongSmsProvider, calculateBackoff, cleanPhoneNumber, createNotifyError, createTwilioWebhookHandler, createWhatsAppWebhookHandler, getCallingCode, getCountryCode, getPakistanNetwork, isCountry, isPakistanMobile, isRetriableError, routeByPrefix, toE164, validatePhoneNumber, withRetry };

package/dist/index.d.ts

@@ -337,20 +337,15 @@ interface MetaWhatsAppConfig {
     webhookVerifyToken?: string;
 }
 /**
- * AWS SES email provider configuration
+ * Resend email provider configuration
  */
-interface SesConfig {
-    /** AWS region */
-    region: string;
-    /** Default from address */
+interface ResendConfig {
+    /** Resend API key */
+    apiKey: string;
+    /** Default from address (must be verified domain) */
     fromAddress: string;
     /** Default from name */
     fromName?: string;
-    /** AWS credentials (optional, will use default credential chain) */
-    credentials?: {
-        accessKeyId: string;
-        secretAccessKey: string;
-    };
 }
 /**
  * Provider-specific configuration union
@@ -373,8 +368,8 @@ type WhatsAppProviderConfig = {
     instance: WhatsAppProvider;
 };
 type EmailProviderConfig = {
-    provider: 'ses';
-    config: SesConfig;
+    provider: 'resend';
+    config: ResendConfig;
 } | {
     provider: 'custom';
     instance: EmailProvider;
@@ -825,6 +820,46 @@ declare class MetaWhatsAppProvider implements WhatsAppProvider {
     destroy(): Promise<void>;
 }
 
+/**
+ * Resend email provider implementation
+ * @see https://resend.com/docs/api-reference/emails/send-email
+ */
+declare class ResendEmailProvider implements EmailProvider {
+    readonly name = "resend";
+    private readonly config;
+    private readonly logger?;
+    private readonly retryConfig;
+    private readonly baseUrl;
+    constructor(config: ResendConfig, options?: {
+        logger?: Logger;
+        retryConfig?: RetryConfig;
+    });
+    /**
+     * Initialize the provider (no-op for Resend, uses REST API)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Build the "from" field with optional name
+     */
+    private buildFrom;
+    /**
+     * Send an email
+     */
+    send(to: string, email: EmailMessage, options?: EmailOptions): Promise<SendResult>;
+    /**
+     * Send bulk emails using Resend batch API
+     */
+    sendBulk(messages: EmailMessageWithRecipient[], options?: BulkOptions): Promise<BulkResult>;
+    /**
+     * Basic email validation
+     */
+    private isValidEmail;
+    /**
+     * Cleanup resources
+     */
+    destroy(): Promise<void>;
+}
+
 /**
  * Twilio webhook payload for message status updates
  */
@@ -1077,4 +1112,4 @@ declare function getPakistanNetwork(phone: string): 'jazz' | 'telenor' | 'zong'
  */
 declare function routeByPrefix(phone: string, routing: Record<string, 'primary' | 'fallback'>): 'primary' | 'fallback';
 
-export { BaseLocalSmsProvider, type BaseProvider, type BulkOptions, type BulkResult, type BulkSummary, type Channel, type Cost, DEFAULT_RETRY_CONFIG, type EmailAttachment, type EmailMessage, type EmailMessageWithRecipient, type EmailOptions, type EmailProvider, type EmailProviderConfig, type IncomingMessageEvent, JazzSmsProvider, type LocalSmsConfig, type Logger, type MessageStatus, type MetaWhatsAppConfig, MetaWhatsAppProvider, type Notification, type NotifyError, NotifyHub, type NotifyHubConfig, type RateLimitConfig, type RetryConfig, type RoutingConfig, type SendResult, type SesConfig, type SmsChannelConfig, type SmsMessage, type SmsOptions, type SmsProvider, type SmsProviderConfig, type StatusWebhookEvent, TelenorSmsProvider, type TwilioConfig, TwilioSmsProvider, TwilioWebhookHandler, type WebhookEvent, type WebhookHandler, type WhatsAppMessage, type WhatsAppOptions, type WhatsAppProvider, type WhatsAppProviderConfig, type WhatsAppTemplate, type WhatsAppTemplateButton, type WhatsAppTemplateHeader, WhatsAppWebhookHandler, ZongSmsProvider, calculateBackoff, cleanPhoneNumber, createNotifyError, createTwilioWebhookHandler, createWhatsAppWebhookHandler, getCallingCode, getCountryCode, getPakistanNetwork, isCountry, isPakistanMobile, isRetriableError, routeByPrefix, toE164, validatePhoneNumber, withRetry };
+export { BaseLocalSmsProvider, type BaseProvider, type BulkOptions, type BulkResult, type BulkSummary, type Channel, type Cost, DEFAULT_RETRY_CONFIG, type EmailAttachment, type EmailMessage, type EmailMessageWithRecipient, type EmailOptions, type EmailProvider, type EmailProviderConfig, type IncomingMessageEvent, JazzSmsProvider, type LocalSmsConfig, type Logger, type MessageStatus, type MetaWhatsAppConfig, MetaWhatsAppProvider, type Notification, type NotifyError, NotifyHub, type NotifyHubConfig, type RateLimitConfig, type ResendConfig, ResendEmailProvider, type RetryConfig, type RoutingConfig, type SendResult, type SmsChannelConfig, type SmsMessage, type SmsOptions, type SmsProvider, type SmsProviderConfig, type StatusWebhookEvent, TelenorSmsProvider, type TwilioConfig, TwilioSmsProvider, TwilioWebhookHandler, type WebhookEvent, type WebhookHandler, type WhatsAppMessage, type WhatsAppOptions, type WhatsAppProvider, type WhatsAppProviderConfig, type WhatsAppTemplate, type WhatsAppTemplateButton, type WhatsAppTemplateHeader, WhatsAppWebhookHandler, ZongSmsProvider, calculateBackoff, cleanPhoneNumber, createNotifyError, createTwilioWebhookHandler, createWhatsAppWebhookHandler, getCallingCode, getCountryCode, getPakistanNetwork, isCountry, isPakistanMobile, isRetriableError, routeByPrefix, toE164, validatePhoneNumber, withRetry };

package/dist/index.js

@@ -975,6 +975,207 @@ var MetaWhatsAppProvider = class {
   }
 };
 
+// src/providers/email/resend.provider.ts
+var ResendEmailProvider = class {
+  name = "resend";
+  config;
+  logger;
+  retryConfig;
+  baseUrl = "https://api.resend.com";
+  constructor(config, options) {
+    this.config = config;
+    this.logger = options?.logger;
+    this.retryConfig = options?.retryConfig ?? DEFAULT_RETRY_CONFIG;
+  }
+  /**
+   * Initialize the provider (no-op for Resend, uses REST API)
+   */
+  async initialize() {
+    this.logger?.debug("ResendEmailProvider initialized");
+  }
+  /**
+   * Build the "from" field with optional name
+   */
+  buildFrom(options) {
+    const name = options?.fromName ?? this.config.fromName;
+    const address = options?.from ?? this.config.fromAddress;
+    if (name) {
+      return `${name} <${address}>`;
+    }
+    return address;
+  }
+  /**
+   * Send an email
+   */
+  async send(to, email, options) {
+    const timestamp = /* @__PURE__ */ new Date();
+    if (!this.isValidEmail(to)) {
+      return {
+        success: false,
+        channel: "email",
+        status: "failed",
+        provider: this.name,
+        error: {
+          code: "INVALID_EMAIL",
+          message: `Invalid email address: ${to}`,
+          retriable: false
+        },
+        timestamp,
+        metadata: options?.metadata
+      };
+    }
+    if (!email.body && !email.html) {
+      return {
+        success: false,
+        channel: "email",
+        status: "failed",
+        provider: this.name,
+        error: {
+          code: "INVALID_EMAIL_CONTENT",
+          message: "Email must have either body or html content",
+          retriable: false
+        },
+        timestamp,
+        metadata: options?.metadata
+      };
+    }
+    this.logger?.debug(`Sending email to ${to}`);
+    const result = await withRetry(
+      async () => {
+        const payload = {
+          from: this.buildFrom(options),
+          to: [to],
+          subject: email.subject
+        };
+        if (email.html) {
+          payload.html = email.html;
+        }
+        if (email.body) {
+          payload.text = email.body;
+        }
+        if (options?.replyTo) {
+          payload.reply_to = options.replyTo;
+        }
+        if (options?.cc?.length) {
+          payload.cc = options.cc;
+        }
+        if (options?.bcc?.length) {
+          payload.bcc = options.bcc;
+        }
+        if (email.attachments?.length) {
+          payload.attachments = email.attachments.map((att) => ({
+            filename: att.filename,
+            content: typeof att.content === "string" ? att.content : att.content.toString("base64"),
+            content_type: att.contentType
+          }));
+        }
+        const response = await fetch(`${this.baseUrl}/emails`, {
+          method: "POST",
+          headers: {
+            "Authorization": `Bearer ${this.config.apiKey}`,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(payload)
+        });
+        if (!response.ok) {
+          const errorData = await response.json();
+          const error = new Error(errorData.message);
+          error.statusCode = response.status;
+          throw error;
+        }
+        return await response.json();
+      },
+      this.retryConfig
+    );
+    if (result.success && result.value) {
+      this.logger?.info(`Email sent successfully: ${result.value.id}`);
+      return {
+        success: true,
+        messageId: result.value.id,
+        channel: "email",
+        status: "sent",
+        provider: this.name,
+        timestamp,
+        metadata: options?.metadata
+      };
+    }
+    this.logger?.error(`Email send failed: ${result.error?.message}`);
+    return {
+      success: false,
+      channel: "email",
+      status: "failed",
+      provider: this.name,
+      error: createNotifyError(result.error, "RESEND_ERROR"),
+      timestamp,
+      metadata: options?.metadata
+    };
+  }
+  /**
+   * Send bulk emails using Resend batch API
+   */
+  async sendBulk(messages, options) {
+    const startTime = Date.now();
+    const results = [];
+    let sent = 0;
+    let failed = 0;
+    const batchSize = Math.min(options?.concurrency ?? 100, 100);
+    for (let i = 0; i < messages.length; i += batchSize) {
+      const batch = messages.slice(i, i + batchSize);
+      const batchResults = await Promise.all(
+        batch.map(
+          (msg) => this.send(msg.to, msg, { metadata: msg.metadata })
+        )
+      );
+      for (const result of batchResults) {
+        results.push(result);
+        if (result.success) {
+          sent++;
+        } else {
+          failed++;
+          if (options?.stopOnError) {
+            return {
+              results,
+              summary: {
+                total: messages.length,
+                sent,
+                failed,
+                durationMs: Date.now() - startTime
+              }
+            };
+          }
+        }
+      }
+      options?.onProgress?.(sent + failed, messages.length);
+      if (i + batchSize < messages.length && options?.rateLimit) {
+        const delayMs = Math.ceil(1e3 / options.rateLimit.messagesPerSecond) * batchSize;
+        await new Promise((resolve) => setTimeout(resolve, delayMs));
+      }
+    }
+    return {
+      results,
+      summary: {
+        total: messages.length,
+        sent,
+        failed,
+        durationMs: Date.now() - startTime
+      }
+    };
+  }
+  /**
+   * Basic email validation
+   */
+  isValidEmail(email) {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email);
+  }
+  /**
+   * Cleanup resources
+   */
+  async destroy() {
+    this.logger?.debug("ResendEmailProvider destroyed");
+  }
+};
+
 // src/notify-hub.ts
 var noopLogger = {
   debug: () => void 0,
@@ -1096,8 +1297,14 @@ var NotifyHub = class {
     if (config.provider === "custom" && config.instance) {
       return config.instance;
     }
-    if (config.provider === "ses") {
-      throw new Error("SES email provider not yet implemented");
+    if (config.provider === "resend") {
+      const resendConfig = config.config;
+      const provider = new ResendEmailProvider(resendConfig, {
+        logger: this.logger,
+        retryConfig: this.retryConfig
+      });
+      await provider.initialize();
+      return provider;
     }
     throw new Error(`Unknown email provider: ${config.provider}`);
   }
@@ -1668,6 +1875,7 @@ exports.DEFAULT_RETRY_CONFIG = DEFAULT_RETRY_CONFIG;
 exports.JazzSmsProvider = JazzSmsProvider;
 exports.MetaWhatsAppProvider = MetaWhatsAppProvider;
 exports.NotifyHub = NotifyHub;
+exports.ResendEmailProvider = ResendEmailProvider;
 exports.TelenorSmsProvider = TelenorSmsProvider;
 exports.TwilioSmsProvider = TwilioSmsProvider;
 exports.TwilioWebhookHandler = TwilioWebhookHandler;