@alis-kit/mailer 0.1.0

package/README.md

@@ -0,0 +1,284 @@
+# Mailer Kit
+
+Email delivery abstraction with a template engine and TC39 native decorators (Stage 3).
+
+## Features
+
+- **TC39 Native Decorators** — Uses stage 3 decorators with `Symbol.metadata`, no `reflect-metadata` needed
+- **Template Engine** — Dynamic `${variable}` and `${nested.variable}` interpolation
+- **Provider Agnostic** — Switch between Nodemailer, Resend, or custom providers
+- **Async Queues** — Send emails synchronously or queue them for background delivery
+- **Type Safe** — Full TypeScript support with strict mode
+
+## Requirements
+
+- **Node.js** >= 18.0.0
+- **TypeScript** >= 5.5.0
+
+## Installation
+
+```bash
+npm install @alis-kit/mailer
+```
+
+## Quick Start
+
+### 1. Setup
+
+```typescript
+import { MailerKit } from "@alis-kit/mailer"
+
+MailerKit.setup({
+  provider: "nodemailer",
+  config: {
+    host: "smtp.gmail.com",
+    port: 587,
+    auth: {
+      user: process.env.SMTP_USER,
+      pass: process.env.SMTP_PASS
+    }
+  },
+  from: "noreply@example.com"
+})
+```
+
+### 2. Define a Template
+
+```typescript
+import { EmailTemplate } from "@alis-kit/mailer"
+
+/**
+ * Welcome email sent to new users after registration.
+ *
+ * @example
+ * ```ts
+ * await MailerKit.send(WelcomeEmail, {
+ *   to: "user@example.com",
+ *   name: "John"
+ * })
+ * ```
+ */
+@EmailTemplate("welcome", {
+  template: "./templates/welcome.html",
+  subject: "Welcome to Our Platform!"
+})
+export class WelcomeEmail {
+  to!: string
+  name!: string
+}
+```
+
+### 3. Create the HTML Template
+
+```html
+<!-- templates/welcome.html -->
+<h1>Welcome, ${name}!</h1>
+<p>We're excited to have you on board.</p>
+```
+
+### 4. Send
+
+```typescript
+await MailerKit.send(WelcomeEmail, {
+  to: "user@example.com",
+  name: "John"
+})
+```
+
+## API Reference
+
+### `MailerKit.setup(config)`
+
+Initialize the mailer service. Must be called before sending.
+
+```typescript
+MailerKit.setup({
+  provider: "nodemailer",
+  config: {
+    host: "smtp.example.com",
+    port: 587,
+    auth: { user: "...", pass: "..." }
+  },
+  from: "sender@example.com",
+  queue: {
+    engine: "memory"          // or "bullmq"
+  }
+})
+```
+
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `provider` | `"nodemailer"` | Yes | Email provider to use |
+| `config` | `object` | Yes | Provider-specific configuration |
+| `from` | `string` | Yes | Default sender email address |
+| `queue.engine` | `"memory" \| "bullmq"` | No | Queue engine for async delivery |
+
+---
+
+### `@EmailTemplate(name, options)`
+
+Class decorator that links a class to an HTML template file. Uses TC39 stage 3 native decorators.
+
+```typescript
+@EmailTemplate("notification", {
+  template: "./templates/notification.html",
+  subject: "You have a new notification"
+})
+export class NotificationEmail {
+  to!: string
+  title!: string
+  message!: string
+}
+```
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `name` | `string` | Yes | Unique identifier for the template |
+| `options.template` | `string` | Yes | Path to the HTML template file |
+| `options.subject` | `string` | No | Default subject line |
+
+---
+
+### `MailerKit.send(TemplateClass, data)`
+
+Send an email immediately.
+
+```typescript
+await MailerKit.send(NotificationEmail, {
+  to: "user@example.com",
+  title: "New Message",
+  message: "You have a new notification!"
+})
+```
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `TemplateClass` | `Class` | A class decorated with `@EmailTemplate` |
+| `data` | `object` | Email data including `to`, template variables, and optional overrides |
+
+**Data properties:**
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `to` | `string \| string[]` | Recipient(s) — **required** |
+| `subject` | `string` | Override default subject |
+| `cc` | `string \| string[]` | CC recipients |
+| `bcc` | `string \| string[]` | BCC recipients |
+| `replyTo` | `string` | Reply-to address |
+| `attachments` | `Attachment[]` | File attachments (pdf, doc, docx, xls, xlsx, jpg, jpeg, png, zip) |
+
+---
+
+### `MailerKit.queue(TemplateClass, data, options?)`
+
+Queue an email for asynchronous delivery.
+
+```typescript
+await MailerKit.queue(WelcomeEmail, {
+  to: "user@example.com",
+  name: "John"
+}, { delay: "5s" })
+```
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `delay` | `string` | Delay before sending (e.g., `"5s"`, `"2m"`, `"1h"`) |
+| `priority` | `number` | Priority level (for BullMQ) |
+
+---
+
+### `TemplateEngine.render(templatePath, variables)`
+
+Render an HTML template with variable interpolation.
+
+```typescript
+import { TemplateEngine } from "@alis-kit/mailer"
+
+const html = await TemplateEngine.render("./template.html", {
+  name: "John",
+  user: { email: "john@example.com" }
+})
+```
+
+**Supported syntax:**
+
+| Syntax | Example | Description |
+|--------|---------|-------------|
+| `${var}` | `${name}` | Simple variable |
+| `${nested}` | `${user.email}` | Dot-notation for nested objects |
+| `${array}` | `${items}` | Arrays are JSON-stringified |
+
+---
+
+### `MailerKit.getTemplateMetadata(TemplateClass)`
+
+Retrieve the metadata attached to a decorated class.
+
+```typescript
+const metadata = MailerKit.getTemplateMetadata(WelcomeEmail)
+// { name: "welcome", template: "./templates/welcome.html", subject: "Welcome!" }
+```
+
+## Template Variables
+
+Properties defined in your decorated class act as template variables:
+
+```typescript
+@EmailTemplate("invoice", {
+  template: "./templates/invoice.html",
+  subject: "Your Invoice"
+})
+export class InvoiceEmail {
+  to!: string
+  invoiceNumber!: string
+  total!: number
+  items!: Array<{ name: string; price: number }>
+}
+```
+
+```html
+<!-- templates/invoice.html -->
+<h1>Invoice #${invoiceNumber}</h1>
+<p>Total: $${total}</p>
+<ul>
+  ${items}
+</ul>
+```
+
+## Error Handling
+
+| Error | Cause |
+|-------|-------|
+| `MailerKit not initialized. Call setup() first.` | `send()` or `queue()` called before `setup()` |
+| `Unsupported mail provider: <name>` | Invalid provider in `setup()` config |
+| `Class <Name> is not a valid @EmailTemplate` | Class not decorated with `@EmailTemplate` |
+| `Class <Name> is already decorated with @EmailTemplate` | Duplicate `@EmailTemplate` on same class |
+| `Unsupported attachment type: .<ext>` | Attachment file extension not in allowed list |
+| `Template file not found at: <path>` | HTML template file does not exist |
+| `Queue not configured` | `queue()` called without `queue` in config |
+| `BullMQ integration not implemented` | Using `"bullmq"` engine (not yet supported) |
+
+## Testing
+
+```bash
+# Run all tests
+npm test
+
+# Run tests in watch mode
+npm run test:watch
+```
+
+## Architecture
+
+This project follows the **Functional Core + Decorator Sugar** pattern:
+
+- **`core/`** — Pure functions and classes with all business logic
+- **`decorators/`** — Thin wrappers that store metadata via `Symbol.metadata`
+- **`providers/`** — Email provider adapters (Nodemailer, Resend, etc.)
+- **`template/`** — Template engine and path resolution
+
+Decorators never contain business logic — they only attach metadata that `core/` reads.
+
+## License
+
+ISC

package/dist/core/MailerKit.d.ts

@@ -0,0 +1,90 @@
+import { MailerKitConfig, SendData, QueueOptions } from "../types/index.js";
+/**
+ * Core mailer service that orchestrates email sending and queuing.
+ *
+ * Reads template metadata from `@EmailTemplate` decorated classes via WeakMap
+ * storage — no `reflect-metadata` or `Symbol.metadata` runtime required.
+ *
+ * @example
+ * ```ts
+ * MailerKit.setup({
+ *   provider: "nodemailer",
+ *   config: { host: "smtp.gmail.com", port: 587, auth: { user: "...", pass: "..." } },
+ *   from: "noreply@example.com"
+ * })
+ *
+ * await MailerKit.send(WelcomeEmail, { to: "user@example.com", name: "John" })
+ * ```
+ */
+export declare class MailerKit {
+    private static config;
+    private static provider;
+    /**
+     * Initialize MailerKit with a provider configuration.
+     *
+     * @param config - MailerKit configuration including provider and credentials.
+     * @throws {Error} If the specified provider is not supported.
+     *
+     * @example
+     * ```ts
+     * MailerKit.setup({
+     *   provider: "nodemailer",
+     *   config: { host: "smtp.example.com", port: 587, auth: { user: "u", pass: "p" } },
+     *   from: "sender@example.com"
+     * })
+     * ```
+     */
+    static setup(config: MailerKitConfig): void;
+    /**
+     * Retrieve the template metadata attached to a decorated class.
+     *
+     * Uses WeakMap storage (compatible with all transpilers) — no `reflect-metadata` needed.
+     *
+     * @param TemplateClass - The class constructor to inspect.
+     * @returns The template metadata object with `name`, `template`, and optional `subject`.
+     * @throws {Error} If the class does not have `@EmailTemplate` metadata.
+     */
+    static getTemplateMetadata<T>(TemplateClass: new () => T): {
+        name: string;
+        template: string;
+        subject?: string;
+    };
+    /**
+     * Send an email immediately using a template class.
+     *
+     * @param TemplateClass - A class decorated with `@EmailTemplate`.
+     * @param data - Email data including recipient(s), template variables, and optional overrides.
+     * @throws {Error} If MailerKit is not initialized or the class lacks `@EmailTemplate` metadata.
+     * @throws {Error} If an attachment has an unsupported file extension.
+     *
+     * @example
+     * ```ts
+     * await MailerKit.send(WelcomeEmail, {
+     *   to: "user@example.com",
+     *   name: "John"
+     * })
+     * ```
+     */
+    static send<T>(TemplateClass: new () => T, data: SendData<T>): Promise<void>;
+    /**
+     * Queue an email for asynchronous delivery.
+     *
+     * Currently supports the `"memory"` engine with configurable delay.
+     * BullMQ support is planned for a future release.
+     *
+     * @param TemplateClass - A class decorated with `@EmailTemplate`.
+     * @param data - Email data including recipient(s) and template variables.
+     * @param options - Optional queue options (delay, priority).
+     * @throws {Error} If queue is not configured or uses an unsupported engine.
+     *
+     * @example
+     * ```ts
+     * await MailerKit.queue(WelcomeEmail, {
+     *   to: "user@example.com",
+     *   name: "John"
+     * }, { delay: "5s" })
+     * ```
+     */
+    static queue<T>(TemplateClass: new () => T, data: SendData<T>, options?: QueueOptions): Promise<void>;
+}
+//# sourceMappingURL=MailerKit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MailerKit.d.ts","sourceRoot":"","sources":["../../core/MailerKit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAW3E;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAiB;IACtC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IAErC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,eAAe;IAYpC;;;;;;;;OAQG;IACH,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAC1B,aAAa,EAAE,UAAU,CAAC,GACzB;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAWvD;;;;;;;;;;;;;;;OAeG;WACU,IAAI,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBlF;;;;;;;;;;;;;;;;;;OAkBG;WACU,KAAK,CAAC,CAAC,EAClB,aAAa,EAAE,UAAU,CAAC,EAC1B,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EACjB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC;CAcjB"}

package/dist/core/MailerKit.js

@@ -0,0 +1,179 @@
+import { getEmailTemplateMetadata } from "../decorators/EmailTemplate.js";
+import { TemplateEngine } from "../template/TemplateEngine.js";
+import { TemplatePath } from "../template/TemplatePath.js";
+import { NodemailerProvider } from "../providers/NodemailerProvider.js";
+const ALLOWED_ATTACHMENT_EXTENSIONS = [
+    "pdf", "doc", "docx", "xls", "xlsx", "jpg", "jpeg", "png", "zip"
+];
+/**
+ * Core mailer service that orchestrates email sending and queuing.
+ *
+ * Reads template metadata from `@EmailTemplate` decorated classes via WeakMap
+ * storage — no `reflect-metadata` or `Symbol.metadata` runtime required.
+ *
+ * @example
+ * ```ts
+ * MailerKit.setup({
+ *   provider: "nodemailer",
+ *   config: { host: "smtp.gmail.com", port: 587, auth: { user: "...", pass: "..." } },
+ *   from: "noreply@example.com"
+ * })
+ *
+ * await MailerKit.send(WelcomeEmail, { to: "user@example.com", name: "John" })
+ * ```
+ */
+export class MailerKit {
+    static config;
+    static provider;
+    /**
+     * Initialize MailerKit with a provider configuration.
+     *
+     * @param config - MailerKit configuration including provider and credentials.
+     * @throws {Error} If the specified provider is not supported.
+     *
+     * @example
+     * ```ts
+     * MailerKit.setup({
+     *   provider: "nodemailer",
+     *   config: { host: "smtp.example.com", port: 587, auth: { user: "u", pass: "p" } },
+     *   from: "sender@example.com"
+     * })
+     * ```
+     */
+    static setup(config) {
+        this.config = config;
+        switch (config.provider) {
+            case "nodemailer":
+                this.provider = new NodemailerProvider(config.config);
+                break;
+            default:
+                throw new Error(`Unsupported mail provider: ${config.provider}`);
+        }
+    }
+    /**
+     * Retrieve the template metadata attached to a decorated class.
+     *
+     * Uses WeakMap storage (compatible with all transpilers) — no `reflect-metadata` needed.
+     *
+     * @param TemplateClass - The class constructor to inspect.
+     * @returns The template metadata object with `name`, `template`, and optional `subject`.
+     * @throws {Error} If the class does not have `@EmailTemplate` metadata.
+     */
+    static getTemplateMetadata(TemplateClass) {
+        const metadata = getEmailTemplateMetadata(TemplateClass);
+        if (!metadata) {
+            throw new Error(`Class ${TemplateClass.name} is not a valid @EmailTemplate. ` +
+                `Ensure the class is decorated with @EmailTemplate("name", { template: "..." }).`);
+        }
+        return metadata;
+    }
+    /**
+     * Send an email immediately using a template class.
+     *
+     * @param TemplateClass - A class decorated with `@EmailTemplate`.
+     * @param data - Email data including recipient(s), template variables, and optional overrides.
+     * @throws {Error} If MailerKit is not initialized or the class lacks `@EmailTemplate` metadata.
+     * @throws {Error} If an attachment has an unsupported file extension.
+     *
+     * @example
+     * ```ts
+     * await MailerKit.send(WelcomeEmail, {
+     *   to: "user@example.com",
+     *   name: "John"
+     * })
+     * ```
+     */
+    static async send(TemplateClass, data) {
+        if (!this.provider) {
+            throw new Error("MailerKit not initialized. Call setup() first.");
+        }
+        const metadata = this.getTemplateMetadata(TemplateClass);
+        const html = await TemplateEngine.render(TemplatePath(metadata.template), data);
+        const subject = data.subject || metadata.subject || "No Subject";
+        if (data.attachments) {
+            validateAttachments(data.attachments);
+        }
+        await this.provider.send({
+            from: this.config.from,
+            to: data.to,
+            subject,
+            html,
+            cc: data.cc,
+            bcc: data.bcc,
+            replyTo: data.replyTo,
+            attachments: data.attachments
+        });
+    }
+    /**
+     * Queue an email for asynchronous delivery.
+     *
+     * Currently supports the `"memory"` engine with configurable delay.
+     * BullMQ support is planned for a future release.
+     *
+     * @param TemplateClass - A class decorated with `@EmailTemplate`.
+     * @param data - Email data including recipient(s) and template variables.
+     * @param options - Optional queue options (delay, priority).
+     * @throws {Error} If queue is not configured or uses an unsupported engine.
+     *
+     * @example
+     * ```ts
+     * await MailerKit.queue(WelcomeEmail, {
+     *   to: "user@example.com",
+     *   name: "John"
+     * }, { delay: "5s" })
+     * ```
+     */
+    static async queue(TemplateClass, data, options) {
+        if (!this.config.queue) {
+            throw new Error("Queue not configured");
+        }
+        if (this.config.queue.engine === "memory") {
+            const delayMs = parseDelay(options?.delay || "0s");
+            setTimeout(() => {
+                this.send(TemplateClass, data).catch(console.error);
+            }, delayMs);
+        }
+        else if (this.config.queue.engine === "bullmq") {
+            throw new Error("BullMQ integration not implemented in this version");
+        }
+    }
+}
+/**
+ * Validate that all attachments have allowed file extensions.
+ *
+ * @param attachments - Array of attachment objects to validate.
+ * @throws {Error} If any attachment has an unsupported file extension.
+ */
+function validateAttachments(attachments) {
+    for (const att of attachments) {
+        const ext = att.path.split(".").pop()?.toLowerCase();
+        if (!ext || !ALLOWED_ATTACHMENT_EXTENSIONS.includes(ext)) {
+            throw new Error(`Unsupported attachment type: .${ext}`);
+        }
+    }
+}
+/**
+ * Parse a human-readable delay string into milliseconds.
+ *
+ * @param delay - Delay string like `"5s"`, `"2m"`, `"1h"`, `"1d"`.
+ * @returns The delay in milliseconds.
+ *
+ * @example
+ * ```ts
+ * parseDelay("5s")  // 5000
+ * parseDelay("2m")  // 120000
+ * parseDelay("1h")  // 3600000
+ * ```
+ */
+function parseDelay(delay) {
+    const unit = delay.slice(-1);
+    const value = parseInt(delay.slice(0, -1));
+    switch (unit) {
+        case "s": return value * 1000;
+        case "m": return value * 60 * 1000;
+        case "h": return value * 60 * 60 * 1000;
+        case "d": return value * 24 * 60 * 60 * 1000;
+        default: return value;
+    }
+}
+//# sourceMappingURL=MailerKit.js.map

package/dist/core/MailerKit.js.map

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

package/dist/decorators/EmailTemplate.d.ts

@@ -0,0 +1,39 @@
+import { EmailTemplateOptions } from "../types/index.js";
+export declare const EMAIL_TEMPLATE_METADATA = "mailer:template";
+/**
+ * Class decorator that links a class to an email template file.
+ *
+ * Stores template metadata using WeakMap (compatible with all transpilers)
+ * and optionally on `Symbol.metadata` when the runtime supports it.
+ *
+ * @param name - Unique identifier for the template.
+ * @param options - Configuration object for the template.
+ * @param options.template - Path to the HTML template file.
+ * @param options.subject - Default subject line for the email.
+ *
+ * @example
+ * ```ts
+ * @EmailTemplate("welcome", {
+ *   template: "./templates/welcome.html",
+ *   subject: "Welcome to our platform!"
+ * })
+ * export class WelcomeEmail {
+ *   to!: string
+ *   name!: string
+ * }
+ * ```
+ */
+export declare function EmailTemplate(name: string, options: EmailTemplateOptions): (target: unknown, context: ClassDecoratorContext) => void;
+/**
+ * Retrieve the template metadata attached to a decorated class.
+ *
+ * Reads from WeakMap storage first (always available),
+ * then falls back to `Symbol.metadata` if present.
+ *
+ * @param TemplateClass - The class constructor to inspect.
+ * @returns The template metadata object, or `undefined` if not decorated.
+ */
+export declare function getEmailTemplateMetadata(TemplateClass: object): (EmailTemplateOptions & {
+    name: string;
+}) | undefined;
+//# sourceMappingURL=EmailTemplate.d.ts.map

package/dist/decorators/EmailTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailTemplate.d.ts","sourceRoot":"","sources":["../../decorators/EmailTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAExD,eAAO,MAAM,uBAAuB,oBAAoB,CAAA;AAWxD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,IAC/D,QAAQ,OAAO,EAAE,SAAS,qBAAqB,UAgBxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,GACpB,CAAC,oBAAoB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAEvD"}

package/dist/decorators/EmailTemplate.js

@@ -0,0 +1,58 @@
+export const EMAIL_TEMPLATE_METADATA = "mailer:template";
+/**
+ * WeakMap storage for template metadata, keyed by class constructor.
+ *
+ * TC39 decorators (stage 3) with `context.metadata` require full runtime support.
+ * Since esbuild/Vite doesn't fully implement `context.metadata` yet,
+ * we use WeakMap as the primary storage mechanism.
+ */
+const templateMetadataStore = new WeakMap();
+/**
+ * Class decorator that links a class to an email template file.
+ *
+ * Stores template metadata using WeakMap (compatible with all transpilers)
+ * and optionally on `Symbol.metadata` when the runtime supports it.
+ *
+ * @param name - Unique identifier for the template.
+ * @param options - Configuration object for the template.
+ * @param options.template - Path to the HTML template file.
+ * @param options.subject - Default subject line for the email.
+ *
+ * @example
+ * ```ts
+ * @EmailTemplate("welcome", {
+ *   template: "./templates/welcome.html",
+ *   subject: "Welcome to our platform!"
+ * })
+ * export class WelcomeEmail {
+ *   to!: string
+ *   name!: string
+ * }
+ * ```
+ */
+export function EmailTemplate(name, options) {
+    return (target, context) => {
+        const key = target;
+        if (templateMetadataStore.has(key)) {
+            throw new Error(`Class ${String(context.name)} is already decorated with @EmailTemplate`);
+        }
+        const metadata = { name, ...options };
+        templateMetadataStore.set(key, metadata);
+        if (context.metadata) {
+            context.metadata[EMAIL_TEMPLATE_METADATA] = metadata;
+        }
+    };
+}
+/**
+ * Retrieve the template metadata attached to a decorated class.
+ *
+ * Reads from WeakMap storage first (always available),
+ * then falls back to `Symbol.metadata` if present.
+ *
+ * @param TemplateClass - The class constructor to inspect.
+ * @returns The template metadata object, or `undefined` if not decorated.
+ */
+export function getEmailTemplateMetadata(TemplateClass) {
+    return templateMetadataStore.get(TemplateClass);
+}
+//# sourceMappingURL=EmailTemplate.js.map

package/dist/decorators/EmailTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailTemplate.js","sourceRoot":"","sources":["../../decorators/EmailTemplate.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAA;AAExD;;;;;;GAMG;AACH,MAAM,qBAAqB,GAAG,IAAI,OAAO,EAAmD,CAAA;AAE5F;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAA6B;IACvE,OAAO,CAAC,MAAe,EAAE,OAA8B,EAAE,EAAE;QACzD,MAAM,GAAG,GAAG,MAAgB,CAAA;QAE5B,IAAI,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,SAAS,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,2CAA2C,CACzE,CAAA;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAA;QACrC,qBAAqB,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;QAExC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,GAAG,QAAQ,CAAA;QACtD,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACtC,aAAqB;IAErB,OAAO,qBAAqB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;AACjD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./decorators/EmailTemplate.js";
+export * from "./core/MailerKit.js";
+export * from "./types/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAA;AAC7C,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from "./decorators/EmailTemplate.js";
+export * from "./core/MailerKit.js";
+export * from "./types/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAA;AAC7C,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA"}

package/dist/providers/BaseProvider.d.ts

@@ -0,0 +1,14 @@
+import { Attachment } from "../types/index.js";
+export declare abstract class BaseProvider {
+    abstract send(options: {
+        from: string;
+        to: string | string[];
+        subject: string;
+        html: string;
+        cc?: string | string[];
+        bcc?: string | string[];
+        replyTo?: string;
+        attachments?: Attachment[];
+    }): Promise<void>;
+}
+//# sourceMappingURL=BaseProvider.d.ts.map

package/dist/providers/BaseProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseProvider.d.ts","sourceRoot":"","sources":["../../providers/BaseProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,8BAAsB,YAAY;IAChC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE;QACrB,IAAI,EAAE,MAAM,CAAA;QACZ,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;QACrB,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,EAAE,MAAM,CAAA;QACZ,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;QACtB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;QACvB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;KAC3B,GAAG,OAAO,CAAC,IAAI,CAAC;CAClB"}

package/dist/providers/BaseProvider.js

@@ -0,0 +1,3 @@
+export class BaseProvider {
+}
+//# sourceMappingURL=BaseProvider.js.map

package/dist/providers/BaseProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseProvider.js","sourceRoot":"","sources":["../../providers/BaseProvider.ts"],"names":[],"mappings":"AAGA,MAAM,OAAgB,YAAY;CAWjC"}

package/dist/providers/NodemailerProvider.d.ts

@@ -0,0 +1,7 @@
+import { BaseProvider } from "./BaseProvider.js";
+export declare class NodemailerProvider extends BaseProvider {
+    private transporter;
+    constructor(config: any);
+    send(options: any): Promise<void>;
+}
+//# sourceMappingURL=NodemailerProvider.d.ts.map

package/dist/providers/NodemailerProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodemailerProvider.d.ts","sourceRoot":"","sources":["../../providers/NodemailerProvider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGhD,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,WAAW,CAAK;gBAEZ,MAAM,EAAE,GAAG;IAKjB,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAexC"}

package/dist/providers/NodemailerProvider.js

@@ -0,0 +1,26 @@
+// MONAGE-PATCH: add .js extensions to relative imports + replace require() with ESM import for NodeNext compatibility
+import nodemailer from "nodemailer";
+import { BaseProvider } from "./BaseProvider.js";
+export class NodemailerProvider extends BaseProvider {
+    transporter;
+    constructor(config) {
+        super();
+        this.transporter = nodemailer.createTransport(config);
+    }
+    async send(options) {
+        await this.transporter.sendMail({
+            from: options.from,
+            to: options.to,
+            subject: options.subject,
+            html: options.html,
+            cc: options.cc,
+            bcc: options.bcc,
+            replyTo: options.replyTo,
+            attachments: options.attachments?.map((a) => ({
+                filename: a.filename,
+                path: a.path
+            }))
+        });
+    }
+}
+//# sourceMappingURL=NodemailerProvider.js.map

package/dist/providers/NodemailerProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodemailerProvider.js","sourceRoot":"","sources":["../../providers/NodemailerProvider.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,OAAO,UAAU,MAAM,YAAY,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGhD,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAC1C,WAAW,CAAK;IAExB,YAAY,MAAW;QACrB,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAA;IACvD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAY;QACrB,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;YAC9B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAa,EAAE,EAAE,CAAC,CAAC;gBACxD,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,IAAI,EAAE,CAAC,CAAC,IAAI;aACb,CAAC,CAAC;SACJ,CAAC,CAAA;IACJ,CAAC;CACF"}

package/dist/template/TemplateEngine.d.ts

@@ -0,0 +1,8 @@
+export declare class TemplateEngine {
+    /**
+     * Render a template file with variables.
+     */
+    static render(templatePath: string, variables: Record<string, any>): Promise<string>;
+    private static getNestedValue;
+}
+//# sourceMappingURL=TemplateEngine.d.ts.map

package/dist/template/TemplateEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateEngine.d.ts","sourceRoot":"","sources":["../../template/TemplateEngine.ts"],"names":[],"mappings":"AAGA,qBAAa,cAAc;IACzB;;OAEG;WACU,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB1F,OAAO,CAAC,MAAM,CAAC,cAAc;CAG9B"}

package/dist/template/TemplateEngine.js

@@ -0,0 +1,33 @@
+import * as fs from "fs/promises";
+import * as path from "path";
+export class TemplateEngine {
+    /**
+     * Render a template file with variables.
+     */
+    static async render(templatePath, variables) {
+        let content;
+        try {
+            const fullPath = path.isAbsolute(templatePath)
+                ? templatePath
+                : path.join(process.cwd(), templatePath);
+            content = await fs.readFile(fullPath, "utf-8");
+        }
+        catch (error) {
+            throw new Error(`Template file not found at: ${templatePath}`);
+        }
+        return content.replace(/\$\{([^}]+)\}/g, (_, key) => {
+            const value = this.getNestedValue(variables, key.trim());
+            if (value === undefined || value === null)
+                return "";
+            if (Array.isArray(value))
+                return JSON.stringify(value);
+            if (typeof value === "object")
+                return JSON.stringify(value);
+            return String(value);
+        });
+    }
+    static getNestedValue(obj, path) {
+        return path.split(".").reduce((acc, part) => acc && acc[part], obj);
+    }
+}
+//# sourceMappingURL=TemplateEngine.js.map

package/dist/template/TemplateEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateEngine.js","sourceRoot":"","sources":["../../template/TemplateEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAE5B,MAAM,OAAO,cAAc;IACzB;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,YAAoB,EAAE,SAA8B;QACtE,IAAI,OAAe,CAAA;QACnB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;gBAC5C,CAAC,CAAC,YAAY;gBACd,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAA;YAC1C,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,+BAA+B,YAAY,EAAE,CAAC,CAAA;QAChE,CAAC;QAED,OAAO,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;YAClD,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;YACxD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,EAAE,CAAA;YACpD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;YACtD,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;YAC3D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;QACtB,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,MAAM,CAAC,cAAc,CAAC,GAAQ,EAAE,IAAY;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAA;IACrE,CAAC;CACF"}

package/dist/template/TemplatePath.d.ts

@@ -0,0 +1,2 @@
+export declare function TemplatePath(templateName: string): string;
+//# sourceMappingURL=TemplatePath.d.ts.map

package/dist/template/TemplatePath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplatePath.d.ts","sourceRoot":"","sources":["../../template/TemplatePath.ts"],"names":[],"mappings":"AAGA,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAMzD"}

package/dist/template/TemplatePath.js

@@ -0,0 +1,9 @@
+import { fileURLToPath } from "url";
+import { dirname, join } from "path";
+export function TemplatePath(templateName) {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    // Sesuaikan path relatif ke lokasi file utils ini
+    return join(__dirname, "../../../", templateName);
+}
+//# sourceMappingURL=TemplatePath.js.map

package/dist/template/TemplatePath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplatePath.js","sourceRoot":"","sources":["../../template/TemplatePath.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAErC,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC7C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEtC,kDAAkD;IAClD,OAAO,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AACtD,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,51 @@
+export type ProviderType = "nodemailer" | "resend" | "sendgrid";
+export interface EmailTemplateOptions {
+    /**
+     * Path to the HTML template file.
+     */
+    template: string;
+    /**
+     * Default subject for the email.
+     */
+    subject?: string;
+}
+export type AllowedAttachmentExt = "pdf" | "doc" | "docx" | "xls" | "xlsx" | "jpg" | "jpeg" | "png" | "zip";
+export interface Attachment {
+    filename: string;
+    path: string;
+}
+export type SendData<T> = Omit<T, never> & {
+    to: string | string[];
+    subject?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    replyTo?: string;
+    attachments?: Attachment[];
+};
+export interface QueueOptions {
+    delay?: string;
+    priority?: number;
+}
+export interface MailerKitConfig {
+    provider: ProviderType;
+    config: any;
+    from: string;
+    queue?: {
+        engine: "bullmq" | "memory";
+        engineConfig?: {
+            redis?: {
+                host: string;
+                port: number;
+            };
+        };
+        rateLimit?: {
+            max: number;
+            per: "second" | "minute" | "hour";
+        };
+        retry?: {
+            attempts: number;
+            backoff: "exponential" | "fixed";
+        };
+    };
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAA;AAE/D,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAA;AAE3G,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG;IACzC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACtB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;CAC3B,CAAA;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,CAAA;IACtB,MAAM,EAAE,GAAG,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE;QACN,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAA;QAC3B,YAAY,CAAC,EAAE;YACb,KAAK,CAAC,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAA;aAAE,CAAA;SACvC,CAAA;QACD,SAAS,CAAC,EAAE;YACV,GAAG,EAAE,MAAM,CAAA;YACX,GAAG,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;SAClC,CAAA;QACD,KAAK,CAAC,EAAE;YACN,QAAQ,EAAE,MAAM,CAAA;YAChB,OAAO,EAAE,aAAa,GAAG,OAAO,CAAA;SACjC,CAAA;KACF,CAAA;CACF"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/dist/vitest.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("vite").UserConfig;
+export default _default;
+//# sourceMappingURL=vitest.config.d.ts.map

package/dist/vitest.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.d.ts","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":";AAEA,wBAUE"}

package/dist/vitest.config.js

@@ -0,0 +1,13 @@
+import { defineConfig } from "vitest/config";
+export default defineConfig({
+    test: {
+        globals: true,
+        environment: "node",
+        include: ["**/*.test.ts"],
+        coverage: {
+            provider: "v8",
+            include: ["core/**/*.ts", "decorators/**/*.ts", "template/**/*.ts"]
+        }
+    }
+});
+//# sourceMappingURL=vitest.config.js.map

package/dist/vitest.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C,eAAe,YAAY,CAAC;IAC1B,IAAI,EAAE;QACJ,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,MAAM;QACnB,OAAO,EAAE,CAAC,cAAc,CAAC;QACzB,QAAQ,EAAE;YACR,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE,CAAC,cAAc,EAAE,oBAAoB,EAAE,kBAAkB,CAAC;SACpE;KACF;CACF,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@alis-kit/mailer",
+  "version": "0.1.0",
+  "description": "Email delivery abstraction with template engine and TC39 native decorators",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "nodemailer": "^6.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/nodemailer": "^6.4.0",
+    "typescript": "^5.5.0",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.5.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  }
+}