@impruthvi/nodemail 0.4.0 → 0.6.0

package/README.md

@@ -3,12 +3,10 @@
 [![npm version](https://badge.fury.io/js/@impruthvi%2Fnodemail.svg)](https://www.npmjs.com/package/@impruthvi/nodemail)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.6-blue.svg)](https://www.typescriptlang.org/)
-[![Tests](https://img.shields.io/badge/tests-112%20passing-brightgreen)](https://github.com/impruthvi/nodemail)
+[![Tests](https://img.shields.io/badge/tests-195%20passing-brightgreen)](https://github.com/impruthvi/nodemail)
 [![Coverage](https://img.shields.io/badge/coverage-85%25-brightgreen)](https://github.com/impruthvi/nodemail)
 
-> 🚧 **Work in Progress** - A unified mail service for Node.js/TypeScript inspired by Laravel's elegant Mail system.
-
-**@impruthvi/nodemail** aims to bring the simplicity and elegance of Laravel's Mail system to the Node.js ecosystem with full TypeScript support.
+**@impruthvi/nodemail** brings the simplicity and elegance of Laravel's Mail system to the Node.js ecosystem with full TypeScript support.
 
 ## 🎯 Vision
 
@@ -22,10 +20,11 @@ Inspired by [Laravel's Mail system](https://laravel.com/docs/mail).
 
 ## ✨ Features
 
-### ✅ Available Now (v0.4.0)
+### ✅ Available Now (v0.5.0)
 - 🎯 **Multiple Providers** - SMTP (Nodemailer), SendGrid, AWS SES, Mailgun, Resend, Postmark
 - 🎨 **Template Engines** - Handlebars, EJS, Pug support with dynamic loading
 - 📝 **Mailable Classes** - Reusable email definitions with template support
+- 🧪 **Testing Utilities** - Mail::fake() for testing (Laravel-style assertions)
 - 🪶 **Lightweight** - Only ~25MB with SMTP, install additional providers as needed
 - 🔒 **Type-Safe** - Full TypeScript support with strict typing
 - ✨ **Complete Fluent API** - Chain to(), subject(), html(), template(), data(), cc(), bcc(), attachments(), headers()
@@ -35,7 +34,6 @@ Inspired by [Laravel's Mail system](https://laravel.com/docs/mail).
 ### 🚧 Coming Soon
 - 🔔 **Notifications** - Multi-channel notification system
 - 📋 **Markdown Mail** - Beautiful emails from markdown
-- 🧪 **Testing Utilities** - Mail::fake() for testing
 - 📦 **Queue Support** - Background email sending (Bull/BullMQ)
 - 🌍 **i18n Support** - Multi-language emails
 - 🚀 **More Providers** - Mailtrap and others
@@ -43,12 +41,12 @@ Inspired by [Laravel's Mail system](https://laravel.com/docs/mail).
 ## 📦 Installation
 
 ```bash
-npm install @impruthvi/nodemail@beta
+npm install @impruthvi/nodemail
 ```
 
-Or for the latest stable (when v1.0.0 is released):
+Or install a specific version:
 ```bash
-npm install @impruthvi/nodemail
+npm install @impruthvi/nodemail@0.5.0
 ```
 
 **Lightweight by default!** Only includes SMTP support (~25MB).
@@ -338,79 +336,109 @@ await Mail.to('user@example.com').send(new WelcomeEmail(user, 'My App'));
 await new WelcomeEmail(user, 'My App').to('user@example.com').send();
 ```
 
-**Advanced usage (coming soon):**
+## 🧪 Testing with Mail::fake()
 
-```typescript
-import { Mail } from 'nodemail';
-
-// Configure once
-Mail.configure({
-  default: 'smtp',
-  from: {
-    address: 'noreply@example.com',
-    name: 'My App',
-  },
-  mailers: {
-    smtp: {
-      driver: 'smtp',
-      host: process.env.MAIL_HOST,
-      port: 587,
-      username: process.env.MAIL_USERNAME,
-      password: process.env.MAIL_PASSWORD,
-    },
-  },
-});
-
-// Send emails
-await Mail.to('user@example.com')
-  .subject('Welcome!')
-  .html('<h1>Hello World!</h1>')
-  .send();
-```
-
-**Advanced usage (coming soon):**
+Test your emails without actually sending them - just like Laravel's `Mail::fake()`:
 
 ```typescript
-import { Mail } from 'nodemail';
-
-// Configure once
-Mail.configure({
-  default: 'smtp',
-  from: {
-    address: 'noreply@example.com',
-    name: 'My App',
-  },
-  mailers: {
-    smtp: {
-      driver: 'smtp',
-      host: process.env.MAIL_HOST,
-      port: 587,
-      username: process.env.MAIL_USERNAME,
-      password: process.env.MAIL_PASSWORD,
-    },
-  },
-});
-
-// Send anywhere in your app
-await Mail.to('user@example.com')
-  .subject('Welcome!')
-  .html('<h1>Hello World!</h1>')
-  .send();
+import { Mail, Mailable } from '@impruthvi/nodemail';
 
-// Or use Mailable classes
+// Your Mailable class
 class WelcomeEmail extends Mailable {
-  constructor(private user: User) {
+  constructor(public userName: string) {
     super();
   }
 
   build() {
     return this
-      .subject(`Welcome, ${this.user.name}!`)
-      .view('emails.welcome', { user: this.user });
+      .subject(`Welcome, ${this.userName}!`)
+      .html(`<h1>Hello ${this.userName}!</h1>`);
   }
 }
 
-await Mail.to('user@example.com').send(new WelcomeEmail(user));
+// In your tests
+describe('User Registration', () => {
+  beforeEach(() => {
+    Mail.fake(); // Enable fake mode
+  });
+
+  afterEach(() => {
+    Mail.restore(); // Restore real mailer
+  });
+
+  it('sends welcome email on registration', async () => {
+    // Your application code that sends email
+    await Mail.to('user@example.com').send(new WelcomeEmail('John'));
+
+    // Assert email was sent
+    Mail.assertSent(WelcomeEmail);
+
+    // Assert with conditions
+    Mail.assertSent(WelcomeEmail, (mail) => {
+      return mail.hasTo('user@example.com') &&
+             mail.subjectContains('Welcome');
+    });
+
+    // Assert sent count
+    Mail.assertSentCount(WelcomeEmail, 1);
+
+    // Assert other mailables were NOT sent
+    Mail.assertNotSent(PasswordResetEmail);
+  });
+
+  it('does not send email when validation fails', async () => {
+    // Code that doesn't send email
+    Mail.assertNothingSent();
+  });
+});
+```
+
+### Available Assertions
+
+| Method | Description |
+|--------|-------------|
+| `Mail.fake()` | Enable fake mode (store emails instead of sending) |
+| `Mail.restore()` | Restore real mailer |
+| `Mail.assertSent(Mailable)` | Assert mailable was sent |
+| `Mail.assertSent(Mailable, callback)` | Assert with custom conditions |
+| `Mail.assertSentCount(Mailable, count)` | Assert sent exactly N times |
+| `Mail.assertNotSent(Mailable)` | Assert mailable was NOT sent |
+| `Mail.assertNothingSent()` | Assert no emails were sent |
+| `Mail.assertQueued(Mailable)` | Assert mailable was queued |
+| `Mail.assertNothingQueued()` | Assert nothing was queued |
+| `Mail.sent()` | Get all sent messages |
+| `Mail.sent(Mailable)` | Get sent messages of specific type |
+
+### AssertableMessage Methods
+
+When inspecting sent messages, you can use these helper methods:
+
+```typescript
+const sent = Mail.sent(WelcomeEmail)[0];
+
+// Check recipients
+sent.hasTo('user@example.com');      // Check TO
+sent.hasCc('cc@example.com');        // Check CC
+sent.hasBcc('bcc@example.com');      // Check BCC
+
+// Check content
+sent.hasSubject('Welcome!');         // Exact subject match
+sent.subjectContains('Welcome');     // Subject contains
+sent.htmlContains('Hello');          // HTML contains
+sent.textContains('Hello');          // Plain text contains
+
+// Check attachments
+sent.hasAttachments();               // Has any attachments
+sent.hasAttachment('file.pdf');      // Has specific attachment
+
+// Check headers
+sent.hasHeader('X-Custom');          // Has header
+sent.hasHeader('X-Custom', 'value'); // Header with value
+
+// Get values
+sent.getTo();                        // Get recipients array
+sent.getSubject();                   // Get subject
+sent.getHtml();                      // Get HTML content
 ```
 
 ## 🛠️ Current Status
@@ -428,20 +456,37 @@ await Mail.to('user@example.com').send(new WelcomeEmail(user));
 - ✅ SMTP Provider (nodemailer)
 - ✅ SendGrid Provider (@sendgrid/mail)
 - ✅ AWS SES Provider (@aws-sdk/client-ses)
-- ✅ Message builder with fluent API
+- ✅ Message builder with complete fluent API
 - ✅ Configuration system
 - ✅ Error handling & graceful degradation
-- 🚧 Other providers (Mailgun, Resend, Postmark) - coming soon
 
-**Phase 3: Advanced Features** 🚧 Next
-- Enhanced Mailable classes with template support
-- Additional providers (Mailgun, Resend, Postmark)
+**Phase 3: Additional Providers** ✅ Complete
+- ✅ Mailgun Provider (mailgun.js)
+- ✅ Resend Provider (resend)
+- ✅ Postmark Provider (postmark)
+- ✅ Dynamic loading for all providers
+- ✅ Comprehensive provider tests
+
+**Phase 4: Template Engines & Mailable** ✅ Complete
+- ✅ Template engines (Handlebars, EJS, Pug)
+- ✅ Laravel-like Mailable classes with template support
+- ✅ Complete fluent API (cc, bcc, replyTo, attachments, headers)
+- ✅ Dynamic template loading with caching
+
+**Phase 5: Testing Utilities** ✅ Complete (v0.5.0)
+- ✅ Mail::fake() for testing
+- ✅ assertSent(), assertNotSent(), assertNothingSent()
+- ✅ assertQueued(), assertNothingQueued()
+- ✅ AssertableMessage with inspection methods
+- ✅ Comprehensive test suite (172 tests)
+- ✅ 85%+ code coverage
+
+**Phase 6: Advanced Features** 🚧 Coming Soon
 - Queue integration (Bull/BullMQ)
-- Template engines (Handlebars, EJS, Pug)
-- Testing utilities (Mail::fake(), assertSent())
-- Unit test coverage
 - CLI tools
 - Markdown mail support
+- Multi-channel notifications
+- i18n support
 
 ## 🤝 Contributing
 
@@ -504,7 +549,7 @@ Unlike other packages that bundle everything:
 - **Type-Safe**: Full TypeScript support with strict typing
 - **Developer-Friendly**: Clean, intuitive API
 - **Production-Ready**: Built with best practices
-- **Well-Tested**: Comprehensive test coverage (coming soon)
+- **Well-Tested**: 172 passing tests with 85%+ coverage
 
 ## 📄 License
 

package/dist/core/MailFacade.d.ts

@@ -1,14 +1,58 @@
 import { MailManager } from './MailManager';
-import type { MailConfig } from '../types';
+import type { MailConfig, MailOptions, MailResponse, QueueJobResult } from '../types';
+import type { Mailable } from './Mailable';
+import { MailFake } from '../testing/MailFake';
+import type { AssertableMessage } from '../testing/AssertableMessage';
 declare class MailFacade {
     private static instance;
+    private static fakeInstance;
+    private static config;
     static configure(config: MailConfig): void;
     private static getInstance;
-    static to(address: string | string[]): import("./MailManager").MessageBuilder;
+    private static isFaking;
+    static to(address: string | string[]): FakeableMessageBuilder;
     static mailer(name: string): MailManager;
-    static send(mailable: import('./Mailable').Mailable): Promise<import('../types').MailResponse>;
-    static fake(): void;
-    static assertSent(): void;
+    static send(mailable: Mailable): Promise<MailResponse>;
+    static queue(mailable: Mailable): Promise<QueueJobResult>;
+    static later(mailable: Mailable, delaySeconds: number): Promise<QueueJobResult>;
+    static at(mailable: Mailable, date: Date): Promise<QueueJobResult>;
+    static processQueue(queueName?: string): Promise<void>;
+    static fake(): MailFake;
+    static restore(): void;
+    static getFake(): MailFake | null;
+    static assertSent<T extends Mailable>(mailableClass: new (...args: any[]) => T, callback?: (message: AssertableMessage) => boolean): void;
+    static assertSentCount<T extends Mailable>(mailableClass: new (...args: any[]) => T, count: number): void;
+    static assertNotSent<T extends Mailable>(mailableClass: new (...args: any[]) => T, callback?: (message: AssertableMessage) => boolean): void;
+    static assertNothingSent(): void;
+    static assertQueued<T extends Mailable>(mailableClass: new (...args: any[]) => T, callback?: (message: AssertableMessage) => boolean): void;
+    static assertQueuedCount<T extends Mailable>(mailableClass: new (...args: any[]) => T, count: number): void;
+    static assertNotQueued<T extends Mailable>(mailableClass: new (...args: any[]) => T, callback?: (message: AssertableMessage) => boolean): void;
+    static assertNothingQueued(): void;
+    static sent<T extends Mailable>(mailableClass?: new (...args: any[]) => T): AssertableMessage[];
+    static queued<T extends Mailable>(mailableClass?: new (...args: any[]) => T): AssertableMessage[];
+    static hasSent(): boolean;
+    static hasQueued(): boolean;
+}
+declare class FakeableMessageBuilder {
+    private manager;
+    options: Partial<MailOptions>;
+    constructor(manager: MailManager | MailFake, to: string | string[]);
+    subject(subject: string): this;
+    html(html: string): this;
+    text(text: string): this;
+    from(from: string): this;
+    cc(cc: string | string[]): this;
+    bcc(bcc: string | string[]): this;
+    replyTo(replyTo: string): this;
+    attachments(attachments: import('../types').Attachment[]): this;
+    headers(headers: Record<string, string>): this;
+    template(template: string): this;
+    data(data: Record<string, unknown>): this;
+    send(mailable?: Mailable): Promise<MailResponse>;
+    queue(mailable?: Mailable): Promise<QueueJobResult>;
+    later(delaySeconds: number, mailable?: Mailable): Promise<QueueJobResult>;
+    at(date: Date, mailable?: Mailable): Promise<QueueJobResult>;
+    private getMailOptions;
 }
 export { MailFacade as Mail };
 //# sourceMappingURL=MailFacade.d.ts.map

package/dist/core/MailFacade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MailFacade.d.ts","sourceRoot":"","sources":["../../src/core/MailFacade.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,cAAM,UAAU;IACd,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4B;IAKnD,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAO1C,OAAO,CAAC,MAAM,CAAC,WAAW;IAU1B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAOpC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM;WAOb,IAAI,CAAC,QAAQ,EAAE,OAAO,YAAY,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,UAAU,EAAE,YAAY,CAAC;IAQpG,MAAM,CAAC,IAAI,IAAI,IAAI;IAQnB,MAAM,CAAC,UAAU,IAAI,IAAI;CAI1B;AAED,OAAO,EAAE,UAAU,IAAI,IAAI,EAAE,CAAC"}
+{"version":3,"file":"MailFacade.d.ts","sourceRoot":"","sources":["../../src/core/MailFacade.ts"],"names":[],"mappings":"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"}

package/dist/core/MailFacade.js

@@ -2,9 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Mail = void 0;
 const MailManager_1 = require("./MailManager");
+const MailFake_1 = require("../testing/MailFake");
 class MailFacade {
     static instance = null;
+    static fakeInstance = null;
+    static config = null;
     static configure(config) {
+        this.config = config;
         this.instance = new MailManager_1.MailManager(config);
     }
     static getInstance() {
@@ -13,22 +17,300 @@ class MailFacade {
         }
         return this.instance;
     }
+    static isFaking() {
+        return this.fakeInstance !== null;
+    }
     static to(address) {
-        return this.getInstance().to(address);
+        if (this.isFaking()) {
+            return new FakeableMessageBuilder(this.fakeInstance, address);
+        }
+        return new FakeableMessageBuilder(this.getInstance(), address);
     }
     static mailer(name) {
         return this.getInstance().mailer(name);
     }
     static async send(mailable) {
+        if (this.isFaking()) {
+            const options = mailable.getMailOptions();
+            return this.fakeInstance.send(options, mailable);
+        }
         mailable.setMailManager(this.getInstance());
         return mailable.send();
     }
+    static async queue(mailable) {
+        if (this.isFaking()) {
+            const options = mailable.getMailOptions();
+            await this.fakeInstance.queue(options, mailable);
+            return { success: true, jobId: `fake-${Date.now()}`, queue: 'mail' };
+        }
+        mailable.setMailManager(this.getInstance());
+        return this.getInstance().queue(mailable.getMailOptions());
+    }
+    static async later(mailable, delaySeconds) {
+        if (this.isFaking()) {
+            const options = mailable.getMailOptions();
+            await this.fakeInstance.later(options, delaySeconds, mailable);
+            return { success: true, jobId: `fake-${Date.now()}`, queue: 'mail' };
+        }
+        mailable.setMailManager(this.getInstance());
+        return this.getInstance().later(mailable.getMailOptions(), delaySeconds);
+    }
+    static async at(mailable, date) {
+        if (this.isFaking()) {
+            const options = mailable.getMailOptions();
+            await this.fakeInstance.at(options, date, mailable);
+            return { success: true, jobId: `fake-${Date.now()}`, queue: 'mail' };
+        }
+        mailable.setMailManager(this.getInstance());
+        return this.getInstance().at(mailable.getMailOptions(), date);
+    }
+    static async processQueue(queueName) {
+        if (this.isFaking()) {
+            return;
+        }
+        return this.getInstance().processQueue(queueName);
+    }
     static fake() {
-        throw new Error('Mail.fake() not yet implemented');
+        this.fakeInstance = new MailFake_1.MailFake(this.config || undefined);
+        return this.fakeInstance;
+    }
+    static restore() {
+        this.fakeInstance = null;
+    }
+    static getFake() {
+        return this.fakeInstance;
+    }
+    static assertSent(mailableClass, callback) {
+        if (!this.fakeInstance) {
+            throw new Error('Mail::fake() must be called before using assertions.');
+        }
+        this.fakeInstance.assertSent(mailableClass, callback);
     }
-    static assertSent() {
-        throw new Error('Mail.assertSent() not yet implemented');
+    static assertSentCount(mailableClass, count) {
+        if (!this.fakeInstance) {
+            throw new Error('Mail::fake() must be called before using assertions.');
+        }
+        this.fakeInstance.assertSentCount(mailableClass, count);
+    }
+    static assertNotSent(mailableClass, callback) {
+        if (!this.fakeInstance) {
+            throw new Error('Mail::fake() must be called before using assertions.');
+        }
+        this.fakeInstance.assertNotSent(mailableClass, callback);
+    }
+    static assertNothingSent() {
+        if (!this.fakeInstance) {
+            throw new Error('Mail::fake() must be called before using assertions.');
+        }
+        this.fakeInstance.assertNothingSent();
+    }
+    static assertQueued(mailableClass, callback) {
+        if (!this.fakeInstance) {
+            throw new Error('Mail::fake() must be called before using assertions.');
+        }
+        this.fakeInstance.assertQueued(mailableClass, callback);
+    }
+    static assertQueuedCount(mailableClass, count) {
+        if (!this.fakeInstance) {
+            throw new Error('Mail::fake() must be called before using assertions.');
+        }
+        this.fakeInstance.assertQueuedCount(mailableClass, count);
+    }
+    static assertNotQueued(mailableClass, callback) {
+        if (!this.fakeInstance) {
+            throw new Error('Mail::fake() must be called before using assertions.');
+        }
+        this.fakeInstance.assertNotQueued(mailableClass, callback);
+    }
+    static assertNothingQueued() {
+        if (!this.fakeInstance) {
+            throw new Error('Mail::fake() must be called before using assertions.');
+        }
+        this.fakeInstance.assertNothingQueued();
+    }
+    static sent(mailableClass) {
+        if (!this.fakeInstance) {
+            throw new Error('Mail::fake() must be called before using sent().');
+        }
+        return this.fakeInstance.sent(mailableClass);
+    }
+    static queued(mailableClass) {
+        if (!this.fakeInstance) {
+            throw new Error('Mail::fake() must be called before using queued().');
+        }
+        return this.fakeInstance.queued(mailableClass);
+    }
+    static hasSent() {
+        if (!this.fakeInstance) {
+            throw new Error('Mail::fake() must be called before using hasSent().');
+        }
+        return this.fakeInstance.hasSent();
+    }
+    static hasQueued() {
+        if (!this.fakeInstance) {
+            throw new Error('Mail::fake() must be called before using hasQueued().');
+        }
+        return this.fakeInstance.hasQueued();
     }
 }
 exports.Mail = MailFacade;
+class FakeableMessageBuilder {
+    manager;
+    options = {};
+    constructor(manager, to) {
+        this.manager = manager;
+        this.options.to = to;
+    }
+    subject(subject) {
+        this.options.subject = subject;
+        return this;
+    }
+    html(html) {
+        this.options.html = html;
+        return this;
+    }
+    text(text) {
+        this.options.text = text;
+        return this;
+    }
+    from(from) {
+        this.options.from = from;
+        return this;
+    }
+    cc(cc) {
+        this.options.cc = cc;
+        return this;
+    }
+    bcc(bcc) {
+        this.options.bcc = bcc;
+        return this;
+    }
+    replyTo(replyTo) {
+        this.options.replyTo = replyTo;
+        return this;
+    }
+    attachments(attachments) {
+        this.options.attachments = attachments;
+        return this;
+    }
+    headers(headers) {
+        this.options.headers = headers;
+        return this;
+    }
+    template(template) {
+        this.options.template = template;
+        return this;
+    }
+    data(data) {
+        this.options.data = data;
+        return this;
+    }
+    async send(mailable) {
+        if (this.manager instanceof MailFake_1.MailFake) {
+            if (mailable) {
+                const mailOptions = mailable.getMailOptions();
+                return this.manager.send({ ...mailOptions, to: this.options.to }, mailable);
+            }
+            if (!this.options.subject) {
+                throw new Error('Email subject is required');
+            }
+            return this.manager.send(this.options);
+        }
+        const realManager = this.manager;
+        if (!(realManager instanceof MailManager_1.MailManager)) {
+            throw new Error('Invalid mail manager');
+        }
+        if (mailable) {
+            mailable.setMailManager(realManager);
+            const mailOptions = mailable.getMailOptions();
+            return realManager.send({
+                ...mailOptions,
+                to: this.options.to,
+            });
+        }
+        if (!this.options.subject) {
+            throw new Error('Email subject is required');
+        }
+        return realManager.send(this.options);
+    }
+    async queue(mailable) {
+        if (this.manager instanceof MailFake_1.MailFake) {
+            if (mailable) {
+                const mailOptions = mailable.getMailOptions();
+                await this.manager.queue({ ...mailOptions, to: this.options.to }, mailable);
+            }
+            else {
+                if (!this.options.subject) {
+                    throw new Error('Email subject is required');
+                }
+                await this.manager.queue(this.options);
+            }
+            return { success: true, jobId: `fake-${Date.now()}`, queue: 'mail' };
+        }
+        const realManager = this.manager;
+        if (!(realManager instanceof MailManager_1.MailManager)) {
+            throw new Error('Invalid mail manager');
+        }
+        const mailOptions = this.getMailOptions(mailable);
+        return realManager.queue(mailOptions);
+    }
+    async later(delaySeconds, mailable) {
+        if (this.manager instanceof MailFake_1.MailFake) {
+            if (mailable) {
+                const mailOptions = mailable.getMailOptions();
+                await this.manager.later({ ...mailOptions, to: this.options.to }, delaySeconds, mailable);
+            }
+            else {
+                if (!this.options.subject) {
+                    throw new Error('Email subject is required');
+                }
+                await this.manager.later(this.options, delaySeconds);
+            }
+            return { success: true, jobId: `fake-${Date.now()}`, queue: 'mail' };
+        }
+        const realManager = this.manager;
+        if (!(realManager instanceof MailManager_1.MailManager)) {
+            throw new Error('Invalid mail manager');
+        }
+        const mailOptions = this.getMailOptions(mailable);
+        return realManager.later(mailOptions, delaySeconds);
+    }
+    async at(date, mailable) {
+        if (this.manager instanceof MailFake_1.MailFake) {
+            if (mailable) {
+                const mailOptions = mailable.getMailOptions();
+                await this.manager.at({ ...mailOptions, to: this.options.to }, date, mailable);
+            }
+            else {
+                if (!this.options.subject) {
+                    throw new Error('Email subject is required');
+                }
+                await this.manager.at(this.options, date);
+            }
+            return { success: true, jobId: `fake-${Date.now()}`, queue: 'mail' };
+        }
+        const realManager = this.manager;
+        if (!(realManager instanceof MailManager_1.MailManager)) {
+            throw new Error('Invalid mail manager');
+        }
+        const mailOptions = this.getMailOptions(mailable);
+        return realManager.at(mailOptions, date);
+    }
+    getMailOptions(mailable) {
+        if (mailable) {
+            if (this.manager instanceof MailManager_1.MailManager) {
+                mailable.setMailManager(this.manager);
+            }
+            const mailOptions = mailable.getMailOptions();
+            return {
+                ...mailOptions,
+                to: this.options.to,
+            };
+        }
+        if (!this.options.subject) {
+            throw new Error('Email subject is required');
+        }
+        return this.options;
+    }
+}
 //# sourceMappingURL=MailFacade.js.map