@wild-framework/mail-auto 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wild Framework contributors
+
+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,28 @@
+# @wild-framework/mail-auto
+
+Env-driven mail provider for [Wild Framework](https://github.com/KhandaSoftware/wild-framework).
+
+## Install
+
+```bash
+pnpm add @wild-framework/mail-auto
+```
+
+## Usage
+
+Register `MailProvider` and set `MAIL_DRIVER` to swap backends without touching app code:
+
+```ts
+import { MailProvider } from "@wild-framework/mail-auto";
+
+app.register(MailProvider);
+```
+
+| `MAIL_DRIVER` | Backend | Env vars |
+| ------------- | ------- | -------- |
+| `smtp`        | SMTP    | `SMTP_HOST`, `SMTP_PORT`, `SMTP_SECURE`, `SMTP_USER`, `SMTP_PASS`, `MAIL_FROM` |
+| unset / other | In-memory | — (dev/tests) |
+
+## License
+
+MIT

package/dist/classify.d.ts

@@ -0,0 +1,10 @@
+/** Which concrete mail backend a driver name maps to. */
+export type MailBackend = "smtp" | "memory";
+/**
+ * Classify a `MAIL_DRIVER` value.
+ *
+ *   "smtp"     → "smtp"
+ *   anything else / undefined → "memory"
+ */
+export declare function classifyMailDriver(driver: string | undefined): MailBackend;
+//# sourceMappingURL=classify.d.ts.map

package/dist/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../src/classify.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAE1E"}

package/dist/classify.js

@@ -0,0 +1,10 @@
+/**
+ * Classify a `MAIL_DRIVER` value.
+ *
+ *   "smtp"     → "smtp"
+ *   anything else / undefined → "memory"
+ */
+export function classifyMailDriver(driver) {
+    return driver?.trim().toLowerCase() === "smtp" ? "smtp" : "memory";
+}
+//# sourceMappingURL=classify.js.map

package/dist/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../src/classify.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IACzD,OAAO,MAAM,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { MailProvider } from "./provider.js";
+export { classifyMailDriver } from "./classify.js";
+export type { MailBackend } from "./classify.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { MailProvider } from "./provider.js";
+export { classifyMailDriver } from "./classify.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,30 @@
+import type { Provider, Application } from "@wild-framework/core";
+/**
+ * Unified, env-driven mail provider.
+ *
+ * Selects a concrete driver from `MAIL_DRIVER` and binds a `Mail` into the
+ * container. This is the "one provider to rule them all" — register it and
+ * set `MAIL_DRIVER` to swap backends without touching app code:
+ *
+ *   MAIL_DRIVER=smtp   → SMTP (SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS, MAIL_FROM)
+ *   (unset)            → in-memory (dev/tests)
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * MailProvider.driver = "smtp"; // optional — force a backend
+ * ```
+ *
+ * The explicit providers (`MailProvider` from `@wild-framework/mail` and
+ * `SmtpMailProvider` from `@wild-framework/mail-smtp`) remain available when
+ * you want to be explicit.
+ */
+export declare class MailProvider implements Provider {
+    /** Force a backend; defaults to `MAIL_DRIVER` (smtp | memory). */
+    static driver: "smtp" | "memory" | undefined;
+    private instance;
+    register(app: Application): void;
+    boot(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMlE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAa,YAAW,QAAQ;IACzC,kEAAkE;IAClE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAE7C,OAAO,CAAC,QAAQ,CAA6B;IAE7C,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAoB1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGlC"}

package/dist/provider.js

@@ -0,0 +1,55 @@
+import { Container } from "@wild-framework/container";
+import { Mail, InMemoryMailDriver } from "@wild-framework/mail";
+import { SmtpMailDriver } from "@wild-framework/mail-smtp";
+import { classifyMailDriver } from "./classify.js";
+/**
+ * Unified, env-driven mail provider.
+ *
+ * Selects a concrete driver from `MAIL_DRIVER` and binds a `Mail` into the
+ * container. This is the "one provider to rule them all" — register it and
+ * set `MAIL_DRIVER` to swap backends without touching app code:
+ *
+ *   MAIL_DRIVER=smtp   → SMTP (SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASS, MAIL_FROM)
+ *   (unset)            → in-memory (dev/tests)
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * MailProvider.driver = "smtp"; // optional — force a backend
+ * ```
+ *
+ * The explicit providers (`MailProvider` from `@wild-framework/mail` and
+ * `SmtpMailProvider` from `@wild-framework/mail-smtp`) remain available when
+ * you want to be explicit.
+ */
+export class MailProvider {
+    /** Force a backend; defaults to `MAIL_DRIVER` (smtp | memory). */
+    static driver;
+    instance;
+    register(app) {
+        const container = app.resolve(Container);
+        const backend = classifyMailDriver(MailProvider.driver ?? process.env.MAIL_DRIVER);
+        if (backend === "smtp") {
+            const driver = new SmtpMailDriver({
+                host: process.env.SMTP_HOST ?? "localhost",
+                port: process.env.SMTP_PORT ? Number(process.env.SMTP_PORT) : undefined,
+                secure: process.env.SMTP_SECURE === "true",
+                user: process.env.SMTP_USER,
+                pass: process.env.SMTP_PASS,
+                from: process.env.MAIL_FROM,
+            });
+            this.instance = driver;
+            container.singleton(Mail, () => new Mail(driver));
+        }
+        else {
+            container.singleton(Mail, () => new Mail(new InMemoryMailDriver()));
+        }
+    }
+    async boot() {
+        await this.instance?.connect();
+    }
+    async shutdown() {
+        await this.instance?.close();
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,YAAY;IACrB,kEAAkE;IAClE,MAAM,CAAC,MAAM,CAAgC;IAErC,QAAQ,CAA6B;IAE7C,QAAQ,CAAC,GAAgB;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,kBAAkB,CAAC,YAAY,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAEnF,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;gBAC9B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,WAAW;gBAC1C,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;gBACvE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM;gBAC1C,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS;gBAC3B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS;gBAC3B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS;aAC9B,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC;YACvB,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACJ,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAC,CAAC;QACxE,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI;QACN,MAAM,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,QAAQ;QACV,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC;IACjC,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@wild-framework/mail-auto",
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Sphah",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KhandaSoftware/wild-framework.git"
+  },
+  "description": "Env-driven mail provider — auto-selects SMTP or in-memory from MAIL_DRIVER.",
+  "keywords": [
+    "wild",
+    "framework",
+    "mail",
+    "email",
+    "smtp",
+    "auto"
+  ],
+  "dependencies": {
+    "@wild-framework/core": "0.2.0",
+    "@wild-framework/container": "0.2.0",
+    "@wild-framework/mail": "0.2.0",
+    "@wild-framework/mail-smtp": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}