@impruthvi/nodemail 0.5.0 → 0.6.0

package/dist/types/index.d.ts

@@ -7,6 +7,7 @@ export interface MailConfig {
     };
     mailers: Record<string, MailerConfig>;
     templates?: TemplateConfig;
+    queue?: QueueConfig;
 }
 export interface TemplateConfig {
     engine?: 'handlebars' | 'ejs' | 'pug' | TemplateEngine;
@@ -98,4 +99,48 @@ export interface MailResponse {
     response?: string;
     error?: string;
 }
+export interface QueueConfig {
+    driver: 'bull' | 'bullmq' | 'sync';
+    connection?: RedisConnectionConfig;
+    defaultQueue?: string;
+    prefix?: string;
+    retries?: number;
+    backoff?: BackoffConfig;
+}
+export interface RedisConnectionConfig {
+    host?: string;
+    port?: number;
+    password?: string;
+    db?: number;
+    url?: string;
+}
+export interface BackoffConfig {
+    type: 'fixed' | 'exponential';
+    delay: number;
+}
+export interface QueuedMailJob {
+    id: string;
+    mailOptions: MailOptions;
+    mailableClass?: string;
+    mailableData?: Record<string, unknown>;
+    attempts: number;
+    maxAttempts: number;
+    delay?: number;
+    scheduledAt?: Date;
+    createdAt: Date;
+}
+export interface QueueJobResult {
+    success: boolean;
+    jobId: string;
+    queue: string;
+    scheduledAt?: Date;
+    error?: string;
+}
+export interface QueueDriver {
+    add(job: QueuedMailJob, queueName?: string): Promise<QueueJobResult>;
+    addDelayed(job: QueuedMailJob, delay: number, queueName?: string): Promise<QueueJobResult>;
+    addScheduled(job: QueuedMailJob, date: Date, queueName?: string): Promise<QueueJobResult>;
+    process(queueName: string, handler: (job: QueuedMailJob) => Promise<MailResponse>): void;
+    close(): Promise<void>;
+}
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,cAAc,CAAC;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IACrF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAW,SAAQ,YAAY;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,MAAM,EAAE,KAAK,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAe,SAAQ,YAAY;IAClD,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,WAAW,GAAG,WAAW,EAAE,CAAC;IACpD,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,WAAW,GAAG,WAAW,EAAE,CAAC;IACrD,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,WAAW,GAAG,WAAW,EAAE,CAAC;IACtD,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC/B,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/examples/queue-example.ts

@@ -0,0 +1,313 @@
+/**
+ * Queue Example - Demonstrates email queuing functionality
+ *
+ * This example shows how to:
+ * - Configure queue with different drivers (sync, bull, bullmq)
+ * - Queue emails for background processing
+ * - Delay emails by a specific number of seconds
+ * - Schedule emails for a specific time
+ * - Process queued emails
+ *
+ * Note: For Bull/BullMQ drivers, you need Redis running:
+ *   docker run -d -p 6379:6379 redis:alpine
+ */
+
+import { Mail, Mailable, QueueManager } from '../src';
+import type { QueueConfig, MailOptions } from '../src/types';
+
+// Example Mailable class
+class WelcomeMailable extends Mailable {
+  constructor(
+    private userName: string,
+    private activationLink: string
+  ) {
+    super();
+  }
+
+  build(): this {
+    return this.from('noreply@example.com')
+      .subject(`Welcome ${this.userName}!`)
+      .html(`
+        <h1>Welcome to Our Platform!</h1>
+        <p>Hi ${this.userName},</p>
+        <p>Thank you for signing up. Please click the link below to activate your account:</p>
+        <a href="${this.activationLink}">Activate Account</a>
+      `);
+  }
+}
+
+class OrderConfirmationMailable extends Mailable {
+  constructor(
+    private orderId: string,
+    private total: number
+  ) {
+    super();
+  }
+
+  build(): this {
+    return this.from('orders@example.com')
+      .subject(`Order #${this.orderId} Confirmed`)
+      .html(`
+        <h1>Order Confirmation</h1>
+        <p>Your order #${this.orderId} has been confirmed.</p>
+        <p>Total: $${this.total.toFixed(2)}</p>
+        <p>Thank you for your purchase!</p>
+      `);
+  }
+}
+
+async function syncDriverExample(): Promise<void> {
+  console.log('=== Sync Driver Example (for development/testing) ===\n');
+
+  // Configure with sync driver (emails are queued but not processed in background)
+  Mail.configure({
+    default: 'smtp',
+    from: { address: 'noreply@example.com', name: 'My App' },
+    mailers: {
+      smtp: {
+        driver: 'smtp',
+        host: 'smtp.example.com',
+        port: 587,
+        auth: { user: 'user', pass: 'pass' },
+      },
+    },
+    queue: {
+      driver: 'sync',
+      defaultQueue: 'mail',
+    },
+  });
+
+  // Queue an email immediately
+  const result1 = await Mail.to('user@example.com')
+    .subject('Quick Update')
+    .html('<p>This is a quick update!</p>')
+    .queue();
+
+  console.log('Queued email:', result1);
+
+  // Queue an email with 60 second delay
+  const result2 = await Mail.to('user@example.com')
+    .subject('Delayed Message')
+    .html('<p>This message was delayed by 60 seconds.</p>')
+    .later(60);
+
+  console.log('Delayed email:', result2);
+
+  // Schedule an email for a specific time
+  const futureTime = new Date(Date.now() + 3600 * 1000); // 1 hour from now
+  const result3 = await Mail.to('user@example.com')
+    .subject('Scheduled Message')
+    .html('<p>This message was scheduled for a specific time.</p>')
+    .at(futureTime);
+
+  console.log('Scheduled email:', result3);
+}
+
+async function mailableQueueExample(): Promise<void> {
+  console.log('\n=== Mailable Queue Example ===\n');
+
+  Mail.configure({
+    default: 'smtp',
+    from: { address: 'noreply@example.com', name: 'My App' },
+    mailers: {
+      smtp: {
+        driver: 'smtp',
+        host: 'smtp.example.com',
+        port: 587,
+        auth: { user: 'user', pass: 'pass' },
+      },
+    },
+    queue: {
+      driver: 'sync',
+      defaultQueue: 'mail',
+      retries: 3,
+      backoff: { type: 'exponential', delay: 1000 },
+    },
+  });
+
+  // Queue a mailable
+  const welcome = new WelcomeMailable('John Doe', 'https://example.com/activate/abc123');
+  const result1 = await Mail.to('john@example.com').queue(welcome);
+  console.log('Queued welcome email:', result1);
+
+  // Queue with delay
+  const order = new OrderConfirmationMailable('ORD-12345', 99.99);
+  const result2 = await Mail.to('john@example.com').later(120, order);
+  console.log('Delayed order confirmation:', result2);
+
+  // Direct queue via Mail.queue()
+  const welcome2 = new WelcomeMailable('Jane Doe', 'https://example.com/activate/xyz789');
+  const result3 = await Mail.queue(welcome2);
+  console.log('Direct queue result:', result3);
+}
+
+async function queueManagerDirectExample(): Promise<void> {
+  console.log('\n=== QueueManager Direct Usage ===\n');
+
+  const queueConfig: QueueConfig = {
+    driver: 'sync',
+    defaultQueue: 'priority-mail',
+    prefix: 'myapp',
+    retries: 5,
+    backoff: { type: 'fixed', delay: 2000 },
+  };
+
+  const queueManager = new QueueManager(queueConfig);
+
+  const mailOptions: MailOptions = {
+    from: 'noreply@example.com',
+    to: 'recipient@example.com',
+    subject: 'Direct Queue Test',
+    html: '<p>This email was queued directly via QueueManager.</p>',
+  };
+
+  // Queue immediately
+  const result1 = await queueManager.queue(mailOptions);
+  console.log('Queued:', result1);
+
+  // Queue with delay
+  const result2 = await queueManager.later(mailOptions, 30);
+  console.log('Delayed 30s:', result2);
+
+  // Schedule for specific time
+  const tomorrow = new Date(Date.now() + 24 * 60 * 60 * 1000);
+  const result3 = await queueManager.at(mailOptions, tomorrow);
+  console.log('Scheduled for tomorrow:', result3);
+
+  await queueManager.close();
+  console.log('Queue manager closed');
+}
+
+function bullMQConfigExample(): void {
+  console.log('\n=== BullMQ Configuration Example ===\n');
+
+  // This is just showing the configuration - requires Redis running
+  const config = {
+    default: 'smtp',
+    from: { address: 'noreply@example.com', name: 'My App' },
+    mailers: {
+      smtp: {
+        driver: 'smtp' as const,
+        host: 'smtp.example.com',
+        port: 587,
+        auth: { user: 'user', pass: 'pass' },
+      },
+    },
+    queue: {
+      driver: 'bullmq' as const,
+      connection: {
+        host: 'localhost',
+        port: 6379,
+        // password: 'your-redis-password',
+        // db: 0,
+      },
+      defaultQueue: 'mail',
+      prefix: 'myapp',
+      retries: 3,
+      backoff: { type: 'exponential' as const, delay: 1000 },
+    },
+  };
+
+  console.log('BullMQ configuration:');
+  console.log(JSON.stringify(config, null, 2));
+  console.log('\nTo use BullMQ:');
+  console.log('1. Install: npm install bullmq ioredis');
+  console.log('2. Start Redis: docker run -d -p 6379:6379 redis:alpine');
+  console.log('3. Configure Mail with the above config');
+  console.log('4. Start a worker to process queued emails');
+}
+
+function bullConfigExample(): void {
+  console.log('\n=== Bull (Legacy) Configuration Example ===\n');
+
+  // This is just showing the configuration - requires Redis running
+  const config = {
+    default: 'smtp',
+    from: { address: 'noreply@example.com', name: 'My App' },
+    mailers: {
+      smtp: {
+        driver: 'smtp' as const,
+        host: 'smtp.example.com',
+        port: 587,
+        auth: { user: 'user', pass: 'pass' },
+      },
+    },
+    queue: {
+      driver: 'bull' as const,
+      connection: {
+        host: 'localhost',
+        port: 6379,
+      },
+      defaultQueue: 'mail',
+      prefix: 'myapp',
+      retries: 3,
+    },
+  };
+
+  console.log('Bull configuration:');
+  console.log(JSON.stringify(config, null, 2));
+  console.log('\nTo use Bull:');
+  console.log('1. Install: npm install bull');
+  console.log('2. Start Redis: docker run -d -p 6379:6379 redis:alpine');
+  console.log('3. Configure Mail with the above config');
+}
+
+async function testingQueueExample(): Promise<void> {
+  console.log('\n=== Testing Queue with Mail.fake() ===\n');
+
+  // Enable fake mode for testing
+  Mail.fake();
+
+  // Queue some emails
+  await Mail.to('user1@example.com')
+    .subject('Test Queue 1')
+    .html('<p>Test 1</p>')
+    .queue();
+
+  await Mail.to('user2@example.com')
+    .subject('Test Queue 2')
+    .html('<p>Test 2</p>')
+    .later(60);
+
+  const mailable = new WelcomeMailable('Test User', 'https://example.com/activate');
+  await Mail.to('user3@example.com').queue(mailable);
+
+  // Assert emails were queued
+  try {
+    Mail.assertQueued(WelcomeMailable);
+    console.log('WelcomeMailable was queued');
+
+    const queuedCount = Mail.queued().length;
+    console.log(`Total queued emails: ${queuedCount}`);
+
+    // Check specific queued email
+    const queued = Mail.queued();
+    queued.forEach((msg, i) => {
+      console.log(`Queued email ${i + 1}: ${msg.getSubject()}`);
+    });
+  } catch (e) {
+    console.error('Assertion failed:', e);
+  }
+
+  // Restore real mail functionality
+  Mail.restore();
+  console.log('\nMail.fake() restored');
+}
+
+// Run examples
+async function main(): Promise<void> {
+  try {
+    await syncDriverExample();
+    await mailableQueueExample();
+    await queueManagerDirectExample();
+    bullMQConfigExample();
+    bullConfigExample();
+    await testingQueueExample();
+
+    console.log('\n=== All examples completed! ===');
+  } catch (error) {
+    console.error('Example failed:', error);
+  }
+}
+
+void main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@impruthvi/nodemail",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "A unified mail service for Node.js/TypeScript with Laravel-like simplicity. Support for multiple providers (SMTP, SendGrid, AWS SES, Mailgun, Resend, Postmark) and template engines (Handlebars, EJS, Pug) - just change environment variables, no code changes needed.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",