@arikajs/mail 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ArikaJs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,290 @@
+## Arika Mail
+
+`@arikajs/mail` is the email delivery system for the ArikaJS framework.
+
+It provides a driver-based, configurable mailer with support for templated emails, attachments, and queue-ready delivery — inspired by Laravel Mail but built natively for Node.js and TypeScript.
+
+This package allows applications to send emails without coupling to a specific transport.
+
+---
+
+## ✨ Features
+
+- **Multiple mailers**: Configure different mail transports (SMTP)
+- **Driver-based transport system**: Pluggable email backends
+- **Class-based Mailables**: Reusable email classes
+- **Templated emails**: Using `@arikajs/view` for rendering
+- **Attachments**: Via `@arikajs/storage` integration
+- **Plain text & HTML emails**: Support for both formats
+- **Queue-ready architecture**: Designed for async delivery
+- **TypeScript-first**: Full type safety with JavaScript support
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @arikajs/mail
+# or
+yarn add @arikajs/mail
+# or
+pnpm add @arikajs/mail
+```
+
+---
+
+## 🚀 Quick Start
+
+### Sending a Basic Email
+
+```ts
+import { Mail } from '@arikajs/mail';
+
+await Mail.to('user@example.com')
+  .subject('Welcome')
+  .text('Welcome to ArikaJS!')
+  .send();
+```
+
+---
+
+## 📬 Using Email Templates
+
+```ts
+await Mail.to('user@example.com')
+  .subject('Welcome')
+  .view('emails.welcome', { user })
+  .send();
+```
+
+Templates are rendered using `@arikajs/view`.
+
+---
+
+## ✉️ Mailables (Recommended)
+
+Mailables provide a clean, reusable way to define emails.
+
+```ts
+import { Mailable } from '@arikajs/mail';
+
+export class WelcomeMail extends Mailable {
+  constructor(private user: any) {
+    super();
+  }
+
+  build() {
+    return this
+      .subject('Welcome to ArikaJS')
+      .view('emails.welcome', { user: this.user });
+  }
+}
+```
+
+**Sending a mailable:**
+
+```ts
+await Mail.to(user.email).send(new WelcomeMail(user));
+```
+
+---
+
+## 📎 Attachments
+
+Attach files using Arika Storage:
+
+```ts
+await Mail.to('user@example.com')
+  .subject('Invoice')
+  .attach('invoices/2024.pdf')
+  .send();
+```
+
+---
+
+## ⚙️ Configuration
+
+Mail configuration is defined via the application config:
+
+```ts
+export default {
+  default: process.env.MAIL_MAILER || 'log',
+
+  mailers: {
+    smtp: {
+      transport: 'smtp',
+      host: process.env.MAIL_HOST || 'smtp.mailtrap.io',
+      port: Number(process.env.MAIL_PORT || 587),
+      username: process.env.MAIL_USERNAME,
+      password: process.env.MAIL_PASSWORD,
+      encryption: process.env.MAIL_ENCRYPTION || 'tls',
+    },
+
+    log: {
+      transport: 'log',
+    },
+
+    array: {
+      transport: 'array',
+    },
+  },
+
+  from: {
+    address: process.env.MAIL_FROM_ADDRESS || 'hello@example.com',
+    name: process.env.MAIL_FROM_NAME || 'Example',
+  },
+};
+```
+
+---
+
+## 🚚 Supported Transports (v1)
+
+| Transport | Status | Description |
+| :--- | :--- | :--- |
+| **SMTP** | ✅ Supported | Standard SMTP delivery |
+| **Log** | ✅ Supported | Logs emails to console (for local dev) |
+| **Array** | ✅ Supported | Stores emails in memory (for testing) |
+| SES | ✅ Supported | Amazon SES driver |
+| Mailgun | ✅ Supported | Mailgun API driver |
+| SendGrid | ✅ Supported | SendGrid API driver |
+
+---
+
+## 📚 API Reference
+
+### `Mail.to(address)`
+
+Set the recipient email address.
+
+```ts
+Mail.to('user@example.com')
+```
+
+### `subject(text)`
+
+Set the email subject.
+
+```ts
+.subject('Welcome')
+```
+
+### `text(content)`
+
+Set plain text email content.
+
+```ts
+.text('Plain text email')
+```
+
+### `view(name, data)`
+
+Render an email template.
+
+```ts
+.view('emails.reset', { token })
+```
+
+### `attach(path)`
+
+Attach a file from storage.
+
+```ts
+.attach('reports/file.pdf')
+```
+
+### `send(mailable?)`
+
+Send the email.
+
+```ts
+await Mail.to('user@example.com').send();
+```
+
+or with a Mailable:
+
+```ts
+await Mail.to(user.email).send(new WelcomeMail(user));
+```
+
+---
+
+## 🧠 Architecture
+
+```
+mail/
+├── src/
+│   ├── MailManager.ts      ← Resolves mailers
+│   ├── Mailer.ts           ← Sends messages
+│   ├── Message.ts          ← Email message builder
+│   ├── Mailable.ts         ← Base class for emails
+│   ├── Transport/
+│   │   └── SmtpTransport.ts
+│   ├── Contracts/
+│   │   └── Transport.ts
+│   └── index.ts
+├── tests/
+│   └── Mail.test.ts
+├── package.json
+├── tsconfig.json
+├── README.md
+└── LICENSE
+```
+
+---
+
+## 🔌 Extending Mail (Custom Transports)
+
+Create a custom transport:
+
+```ts
+import { Transport } from '@arikajs/mail';
+
+class CustomTransport implements Transport {
+  async send(message: any): Promise<void> {
+    // Implementation
+  }
+}
+```
+
+Register it with `MailManager`.
+
+---
+
+## 🔗 Integration with ArikaJS
+
+`@arikajs/mail` integrates with:
+
+- **`@arikajs/view`** → Email templates
+- **`@arikajs/storage`** → Attachments
+- **`@arikajs/queue`** → Async email delivery
+- **`@arikajs/config`** → Mailer configuration
+
+---
+
+## 🧪 Testing
+
+Mailables and transports can be mocked for testing.
+A log or array transport will be added for test environments.
+
+---
+
+## 🛣 Roadmap
+
+- [ ] Queue-based sending
+- [ ] Markdown email support
+- [ ] Multiple recipients (CC/BCC)
+- [ ] Mail previews
+- [ ] Retry & failure handling
+
+---
+
+## 📄 License
+
+`@arikajs/mail` is open-source software licensed under the **MIT License**.
+
+---
+
+## 🧭 Philosophy
+
+> "Send emails, not headaches."

package/dist/Contracts/Transport.d.ts

@@ -0,0 +1,4 @@
+export interface Transport {
+    send(message: any): Promise<void>;
+}
+//# sourceMappingURL=Transport.d.ts.map

package/dist/Contracts/Transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transport.d.ts","sourceRoot":"","sources":["../../src/Contracts/Transport.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACtB,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC"}

package/dist/Contracts/Transport.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Transport.js.map

package/dist/Contracts/Transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Transport.js","sourceRoot":"","sources":["../../src/Contracts/Transport.ts"],"names":[],"mappings":""}

package/dist/MailManager.d.ts

@@ -0,0 +1,13 @@
+import { Mailer, ViewRenderer } from './Mailer';
+export declare class MailManager {
+    private config;
+    private viewRenderer?;
+    private mailers;
+    private customCreators;
+    constructor(config: any, viewRenderer?: ViewRenderer | undefined);
+    extend(driver: string, callback: (config: any) => any): this;
+    mailer(name?: string): Mailer;
+    protected resolve(name: string): Mailer;
+    to(users: any): import("./Mailer").PendingMail;
+}
+//# sourceMappingURL=MailManager.d.ts.map

package/dist/MailManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MailManager.d.ts","sourceRoot":"","sources":["../src/MailManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAKhD,qBAAa,WAAW;IAKR,OAAO,CAAC,MAAM;IAAO,OAAO,CAAC,YAAY,CAAC;IAJtD,OAAO,CAAC,OAAO,CAAkC;IAEjD,OAAO,CAAC,cAAc,CAAgD;gBAElD,MAAM,EAAE,GAAG,EAAU,YAAY,CAAC,EAAE,YAAY,YAAA;IAE7D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG;IAKrD,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAUpC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IA0ChC,EAAE,CAAC,KAAK,EAAE,GAAG;CAGvB"}

package/dist/MailManager.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailManager = void 0;
+const Mailer_1 = require("./Mailer");
+const SmtpTransport_1 = require("./Transport/SmtpTransport");
+const LogTransport_1 = require("./Transport/LogTransport");
+const ArrayTransport_1 = require("./Transport/ArrayTransport");
+class MailManager {
+    constructor(config, viewRenderer) {
+        this.config = config;
+        this.viewRenderer = viewRenderer;
+        this.mailers = new Map();
+        this.customCreators = new Map();
+    }
+    extend(driver, callback) {
+        this.customCreators.set(driver, callback);
+        return this;
+    }
+    mailer(name) {
+        const mailerName = name || this.config.default;
+        if (!this.mailers.has(mailerName)) {
+            this.mailers.set(mailerName, this.resolve(mailerName));
+        }
+        return this.mailers.get(mailerName);
+    }
+    resolve(name) {
+        const config = this.config.mailers[name];
+        if (!config) {
+            throw new Error(`Mailer [${name}] is not defined.`);
+        }
+        let transport;
+        if (this.customCreators.has(config.transport)) {
+            transport = this.customCreators.get(config.transport)(config);
+        }
+        else {
+            switch (config.transport) {
+                case 'smtp':
+                    transport = new SmtpTransport_1.SmtpTransport(config);
+                    break;
+                case 'ses':
+                    const { SesTransport } = require('./Transport/SesTransport');
+                    transport = new SesTransport(config);
+                    break;
+                case 'mailgun':
+                    const { MailgunTransport } = require('./Transport/MailgunTransport');
+                    transport = new MailgunTransport(config);
+                    break;
+                case 'sendgrid':
+                    const { SendGridTransport } = require('./Transport/SendGridTransport');
+                    transport = new SendGridTransport(config);
+                    break;
+                case 'log':
+                    transport = new LogTransport_1.LogTransport();
+                    break;
+                case 'array':
+                    transport = new ArrayTransport_1.ArrayTransport();
+                    break;
+                default:
+                    throw new Error(`Unsupported transport driver [${config.transport}].`);
+            }
+        }
+        return new Mailer_1.Mailer(name, transport, this.viewRenderer);
+    }
+    to(users) {
+        return this.mailer().to(users);
+    }
+}
+exports.MailManager = MailManager;
+//# sourceMappingURL=MailManager.js.map

package/dist/MailManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MailManager.js","sourceRoot":"","sources":["../src/MailManager.ts"],"names":[],"mappings":";;;AACA,qCAAgD;AAChD,6DAA0D;AAC1D,2DAAwD;AACxD,+DAA4D;AAE5D,MAAa,WAAW;IAKpB,YAAoB,MAAW,EAAU,YAA2B;QAAhD,WAAM,GAAN,MAAM,CAAK;QAAU,iBAAY,GAAZ,YAAY,CAAe;QAJ5D,YAAO,GAAwB,IAAI,GAAG,EAAE,CAAC;QAEzC,mBAAc,GAAsC,IAAI,GAAG,EAAE,CAAC;IAEE,CAAC;IAElE,MAAM,CAAC,MAAc,EAAE,QAA8B;QACxD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,MAAM,CAAC,IAAa;QACvB,MAAM,UAAU,GAAG,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAE/C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAE,CAAC;IACzC,CAAC;IAES,OAAO,CAAC,IAAY;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAEzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,mBAAmB,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,SAAS,CAAC;QAEd,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5C,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAE,CAAC,MAAM,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YACJ,QAAQ,MAAM,CAAC,SAAS,EAAE,CAAC;gBACvB,KAAK,MAAM;oBACP,SAAS,GAAG,IAAI,6BAAa,CAAC,MAAM,CAAC,CAAC;oBACtC,MAAM;gBACV,KAAK,KAAK;oBACN,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;oBAC7D,SAAS,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;oBACrC,MAAM;gBACV,KAAK,SAAS;oBACV,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;oBACrE,SAAS,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;oBACzC,MAAM;gBACV,KAAK,UAAU;oBACX,MAAM,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAAC;oBACvE,SAAS,GAAG,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;oBAC1C,MAAM;gBACV,KAAK,KAAK;oBACN,SAAS,GAAG,IAAI,2BAAY,EAAE,CAAC;oBAC/B,MAAM;gBACV,KAAK,OAAO;oBACR,SAAS,GAAG,IAAI,+BAAc,EAAE,CAAC;oBACjC,MAAM;gBACV;oBACI,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;YAC/E,CAAC;QACL,CAAC;QAED,OAAO,IAAI,eAAM,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1D,CAAC;IAEM,EAAE,CAAC,KAAU;QAChB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACJ;AAnED,kCAmEC"}

package/dist/Mailable.d.ts

@@ -0,0 +1,21 @@
+export declare abstract class Mailable {
+    subjectLine?: string;
+    viewPath?: string;
+    viewData: any;
+    textContent?: string;
+    attachments: any[];
+    fromAddress?: string | {
+        name: string;
+        address: string;
+    };
+    abstract build(): this;
+    subject(subject: string): this;
+    view(path: string, data?: any): this;
+    text(content: string): this;
+    attach(path: string): this;
+    from(address: string | {
+        name: string;
+        address: string;
+    }): this;
+}
+//# sourceMappingURL=Mailable.d.ts.map

package/dist/Mailable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mailable.d.ts","sourceRoot":"","sources":["../src/Mailable.ts"],"names":[],"mappings":"AACA,8BAAsB,QAAQ;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,GAAG,CAAM;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,GAAG,EAAE,CAAM;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAEhE,QAAQ,CAAC,KAAK,IAAI,IAAI;IAEf,OAAO,CAAC,OAAO,EAAE,MAAM;IAKvB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,GAAQ;IAMjC,IAAI,CAAC,OAAO,EAAE,MAAM;IAKpB,MAAM,CAAC,IAAI,EAAE,MAAM;IAKnB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAIlE"}

package/dist/Mailable.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Mailable = void 0;
+class Mailable {
+    constructor() {
+        this.viewData = {};
+        this.attachments = [];
+    }
+    subject(subject) {
+        this.subjectLine = subject;
+        return this;
+    }
+    view(path, data = {}) {
+        this.viewPath = path;
+        this.viewData = data;
+        return this;
+    }
+    text(content) {
+        this.textContent = content;
+        return this;
+    }
+    attach(path) {
+        this.attachments.push({ path });
+        return this;
+    }
+    from(address) {
+        this.fromAddress = address;
+        return this;
+    }
+}
+exports.Mailable = Mailable;
+//# sourceMappingURL=Mailable.js.map

package/dist/Mailable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mailable.js","sourceRoot":"","sources":["../src/Mailable.ts"],"names":[],"mappings":";;;AACA,MAAsB,QAAQ;IAA9B;QAGW,aAAQ,GAAQ,EAAE,CAAC;QAEnB,gBAAW,GAAU,EAAE,CAAC;IA8BnC,CAAC;IAzBU,OAAO,CAAC,OAAe;QAC1B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;QAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,IAAI,CAAC,IAAY,EAAE,OAAY,EAAE;QACpC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,IAAI,CAAC,OAAe;QACvB,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;QAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,MAAM,CAAC,IAAY;QACtB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,IAAI,CAAC,OAAmD;QAC3D,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;QAC3B,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAnCD,4BAmCC"}

package/dist/Mailer.d.ts

@@ -0,0 +1,31 @@
+import { Transport } from './Contracts/Transport';
+import { Mailable } from './Mailable';
+import { Message, Address } from './Message';
+export interface ViewRenderer {
+    render(view: string, data: any): Promise<string>;
+}
+export declare class Mailer {
+    protected name: string;
+    protected transport: Transport;
+    protected viewRenderer?: ViewRenderer | undefined;
+    constructor(name: string, transport: Transport, viewRenderer?: ViewRenderer | undefined);
+    to(users: string | Address | (string | Address)[]): PendingMail;
+    send(viewPath: string, data: any, callback: (message: Message) => void): Promise<void>;
+    sendMailable(mailable: Mailable): Promise<void>;
+    sendRaw(message: any): Promise<void>;
+    getRenderer(): ViewRenderer | undefined;
+}
+export declare class PendingMail {
+    protected mailer: Mailer;
+    protected message: Message;
+    protected viewPath?: string;
+    protected viewData: any;
+    constructor(mailer: Mailer);
+    to(users: string | Address | (string | Address)[]): this;
+    subject(subject: string): this;
+    text(content: string): this;
+    view(path: string, data?: any): this;
+    attach(path: string): this;
+    send(mailable?: Mailable): Promise<void>;
+}
+//# sourceMappingURL=Mailer.d.ts.map

package/dist/Mailer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mailer.d.ts","sourceRoot":"","sources":["../src/Mailer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAc,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzD,MAAM,WAAW,YAAY;IACzB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACpD;AAED,qBAAa,MAAM;IAEX,SAAS,CAAC,IAAI,EAAE,MAAM;IACtB,SAAS,CAAC,SAAS,EAAE,SAAS;IAC9B,SAAS,CAAC,YAAY,CAAC,EAAE,YAAY;gBAF3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,EACpB,YAAY,CAAC,EAAE,YAAY,YAAA;IAGzC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE;IAI3C,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI;IAYtE,YAAY,CAAC,QAAQ,EAAE,QAAQ;IAI/B,OAAO,CAAC,OAAO,EAAE,GAAG;IAI1B,WAAW;CAGd;AAED,qBAAa,WAAW;IAKR,SAAS,CAAC,MAAM,EAAE,MAAM;IAJpC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAM;gBAEP,MAAM,EAAE,MAAM;IAIpC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE;IAKjD,OAAO,CAAC,OAAO,EAAE,MAAM;IAKvB,IAAI,CAAC,OAAO,EAAE,MAAM;IAKpB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,GAAQ;IAMjC,MAAM,CAAC,IAAI,EAAE,MAAM;IAKb,IAAI,CAAC,QAAQ,CAAC,EAAE,QAAQ;CA4BjC"}

package/dist/Mailer.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendingMail = exports.Mailer = void 0;
+const Message_1 = require("./Message");
+class Mailer {
+    constructor(name, transport, viewRenderer) {
+        this.name = name;
+        this.transport = transport;
+        this.viewRenderer = viewRenderer;
+    }
+    to(users) {
+        return new PendingMail(this).to(users);
+    }
+    async send(viewPath, data, callback) {
+        const message = new Message_1.Message();
+        callback(message);
+        if (viewPath && this.viewRenderer) {
+            const html = await this.viewRenderer.render(viewPath, data);
+            message.htmlContent(html);
+        }
+        return this.transport.send(message.getPayload());
+    }
+    async sendMailable(mailable) {
+        return this.sendRaw(mailable);
+    }
+    async sendRaw(message) {
+        return this.transport.send(message);
+    }
+    getRenderer() {
+        return this.viewRenderer;
+    }
+}
+exports.Mailer = Mailer;
+class PendingMail {
+    constructor(mailer) {
+        this.mailer = mailer;
+        this.viewData = {};
+        this.message = new Message_1.Message();
+    }
+    to(users) {
+        this.message.to(users);
+        return this;
+    }
+    subject(subject) {
+        this.message.subject(subject);
+        return this;
+    }
+    text(content) {
+        this.message.textContent(content);
+        return this;
+    }
+    view(path, data = {}) {
+        this.viewPath = path;
+        this.viewData = data;
+        return this;
+    }
+    attach(path) {
+        this.message.attach({ path });
+        return this;
+    }
+    async send(mailable) {
+        if (mailable) {
+            mailable.build();
+            if (mailable.subjectLine)
+                this.message.subject(mailable.subjectLine);
+            if (mailable.fromAddress)
+                this.message.from(mailable.fromAddress);
+            if (mailable.textContent)
+                this.message.textContent(mailable.textContent);
+            if (mailable.viewPath) {
+                this.viewPath = mailable.viewPath;
+                this.viewData = mailable.viewData;
+            }
+            if (mailable.attachments) {
+                mailable.attachments.forEach(att => this.message.attach(att));
+            }
+        }
+        if (this.viewPath) {
+            const renderer = this.mailer.getRenderer();
+            if (renderer) {
+                const html = await renderer.render(this.viewPath, this.viewData);
+                this.message.htmlContent(html);
+            }
+        }
+        return this.mailer.sendRaw(this.message.getPayload());
+    }
+}
+exports.PendingMail = PendingMail;
+//# sourceMappingURL=Mailer.js.map

package/dist/Mailer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mailer.js","sourceRoot":"","sources":["../src/Mailer.ts"],"names":[],"mappings":"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"}

package/dist/Message.d.ts

@@ -0,0 +1,45 @@
+export interface Attachment {
+    filename?: string;
+    path?: string;
+    content?: string | Buffer;
+    contentType?: string;
+    cid?: string;
+    encoding?: string;
+}
+export interface Address {
+    name: string;
+    address: string;
+}
+export declare class Message {
+    protected _to: (string | Address)[];
+    protected _cc: (string | Address)[];
+    protected _bcc: (string | Address)[];
+    protected _from?: string | Address;
+    protected _replyTo?: string | Address;
+    protected _subject?: string;
+    protected _text?: string;
+    protected _html?: string;
+    protected _attachments: Attachment[];
+    constructor();
+    to(address: string | Address | (string | Address)[]): this;
+    cc(address: string | Address | (string | Address)[]): this;
+    bcc(address: string | Address | (string | Address)[]): this;
+    from(address: string | Address): this;
+    replyTo(address: string | Address): this;
+    subject(subject: string): this;
+    textContent(content: string): this;
+    htmlContent(content: string): this;
+    attach(attachment: Attachment): this;
+    getPayload(): {
+        to: (string | Address)[];
+        cc: (string | Address)[];
+        bcc: (string | Address)[];
+        from: string | Address | undefined;
+        replyTo: string | Address | undefined;
+        subject: string | undefined;
+        text: string | undefined;
+        html: string | undefined;
+        attachments: Attachment[];
+    };
+}
+//# sourceMappingURL=Message.d.ts.map

package/dist/Message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Message.d.ts","sourceRoot":"","sources":["../src/Message.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,OAAO;IAChB,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE,CAAM;IACzC,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE,CAAM;IACzC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE,CAAM;IAC1C,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,SAAS,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,YAAY,EAAE,UAAU,EAAE,CAAM;;IAI1C,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE;IASnD,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE;IASnD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE;IASpD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAK9B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAKjC,OAAO,CAAC,OAAO,EAAE,MAAM;IAKvB,WAAW,CAAC,OAAO,EAAE,MAAM;IAK3B,WAAW,CAAC,OAAO,EAAE,MAAM;IAK3B,MAAM,CAAC,UAAU,EAAE,UAAU;IAK7B,UAAU;;;;;;;;;;;CAab"}