@wild-framework/mail 0.1.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,27 @@
+# @wild-framework/mail
+
+Mail abstraction for [Wild Framework](https://github.com/your-org/wild-framework).
+
+## Install
+
+```bash
+pnpm add @wild-framework/mail
+```
+
+## Usage
+
+```ts
+import { Mail } from "@wild-framework/mail";
+
+await mail.send({
+    to: "user@example.com",
+    subject: "Welcome!",
+    html: "<h1>Hi</h1>",
+});
+```
+
+Ships with an in-memory driver for development/testing. Implement `MailDriver` for Resend/SendGrid/SES/SMTP.
+
+## License
+
+MIT

package/dist/driver.d.ts

@@ -0,0 +1,22 @@
+/**
+ * An email message.
+ */
+export interface MailMessage {
+    to: string | string[];
+    subject: string;
+    html?: string;
+    text?: string;
+    from?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+}
+/**
+ * Mail driver contract.
+ *
+ * Implement this to add providers (Resend, SendGrid, SES, SMTP, etc.).
+ * App code depends on `Mail`, never on a driver directly.
+ */
+export interface MailDriver {
+    send(message: MailMessage): Promise<void>;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACvB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C"}

package/dist/driver.js

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

package/dist/driver.js.map

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

package/dist/in-memory-driver.d.ts

@@ -0,0 +1,14 @@
+import type { MailDriver, MailMessage } from "./driver.js";
+/**
+ * In-memory mail driver.
+ *
+ * Captures sent messages in an array. Intended for local development
+ * and testing — no actual emails are sent.
+ */
+export declare class InMemoryMailDriver implements MailDriver {
+    sent: MailMessage[];
+    send(message: MailMessage): Promise<void>;
+    /** Clear all captured messages. */
+    clear(): void;
+}
+//# sourceMappingURL=in-memory-driver.d.ts.map

package/dist/in-memory-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-driver.d.ts","sourceRoot":"","sources":["../src/in-memory-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE3D;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IAC1C,IAAI,EAAE,WAAW,EAAE,CAAM;IAE1B,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,mCAAmC;IACnC,KAAK,IAAI,IAAI;CAGhB"}

package/dist/in-memory-driver.js

@@ -0,0 +1,17 @@
+/**
+ * In-memory mail driver.
+ *
+ * Captures sent messages in an array. Intended for local development
+ * and testing — no actual emails are sent.
+ */
+export class InMemoryMailDriver {
+    sent = [];
+    async send(message) {
+        this.sent.push(message);
+    }
+    /** Clear all captured messages. */
+    clear() {
+        this.sent = [];
+    }
+}
+//# sourceMappingURL=in-memory-driver.js.map

package/dist/in-memory-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-driver.js","sourceRoot":"","sources":["../src/in-memory-driver.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAkB,EAAE,CAAC;IAEhC,KAAK,CAAC,IAAI,CAAC,OAAoB;QAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,mCAAmC;IACnC,KAAK;QACD,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;CACJ"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { Mail } from "./mail.js";
+export { MailProvider } from "./provider.js";
+export { InMemoryMailDriver } from "./in-memory-driver.js";
+export type { MailDriver, MailMessage } from "./driver.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,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { Mail } from "./mail.js";
+export { MailProvider } from "./provider.js";
+export { InMemoryMailDriver } from "./in-memory-driver.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,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/mail.d.ts

@@ -0,0 +1,16 @@
+import type { MailDriver } from "./driver.js";
+/**
+ * Email facade.
+ *
+ * Wraps a `MailDriver` and exposes a consistent API.
+ * Resolved from the container: `app.resolve(Mail)`.
+ */
+export declare class Mail {
+    private driver;
+    constructor(driver: MailDriver);
+    /**
+     * Send an email message.
+     */
+    send(message: Parameters<MailDriver["send"]>[0]): Promise<void>;
+}
+//# sourceMappingURL=mail.d.ts.map

package/dist/mail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../src/mail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;;;GAKG;AACH,qBAAa,IAAI;IACD,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlE"}

package/dist/mail.js

@@ -0,0 +1,19 @@
+/**
+ * Email facade.
+ *
+ * Wraps a `MailDriver` and exposes a consistent API.
+ * Resolved from the container: `app.resolve(Mail)`.
+ */
+export class Mail {
+    driver;
+    constructor(driver) {
+        this.driver = driver;
+    }
+    /**
+     * Send an email message.
+     */
+    send(message) {
+        return this.driver.send(message);
+    }
+}
+//# sourceMappingURL=mail.js.map

package/dist/mail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail.js","sourceRoot":"","sources":["../src/mail.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,IAAI;IACO;IAApB,YAAoB,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAE1C;;OAEG;IACH,IAAI,CAAC,OAA0C;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;CACJ"}

package/dist/provider.d.ts

@@ -0,0 +1,12 @@
+import type { Provider, Application } from "@wild-framework/core";
+/**
+ * Registers the mail system with the application.
+ *
+ * Binds a `Mail` backed by the in-memory driver. Swap drivers by
+ * implementing `MailDriver` and binding a new `Mail` — app code
+ * never changes.
+ */
+export declare class MailProvider implements Provider {
+    register(app: Application): 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;AAKlE;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,QAAQ;IACzC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAKnC"}

package/dist/provider.js

@@ -0,0 +1,18 @@
+import { Container } from "@wild-framework/container";
+import { Mail } from "./mail.js";
+import { InMemoryMailDriver } from "./in-memory-driver.js";
+/**
+ * Registers the mail system with the application.
+ *
+ * Binds a `Mail` backed by the in-memory driver. Swap drivers by
+ * implementing `MailDriver` and binding a new `Mail` — app code
+ * never changes.
+ */
+export class MailProvider {
+    register(app) {
+        const container = app.resolve(Container);
+        const mail = new Mail(new InMemoryMailDriver());
+        container.singleton(Mail, () => mail);
+    }
+}
+//# 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,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,OAAO,YAAY;IACrB,QAAQ,CAAC,GAAgB;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAC;QAChD,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@wild-framework/mail",
+  "version": "0.1.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": "Mail abstraction for Wild Framework.",
+  "keywords": [
+    "wild",
+    "framework",
+    "mail",
+    "email",
+    "resend"
+  ],
+  "dependencies": {
+    "@wild-framework/core": "0.1.0",
+    "@wild-framework/container": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}