@agency-lang/email 0.0.1

package/dist/src/email.d.ts

@@ -0,0 +1,23 @@
+export type SmtpOptions = {
+    host?: string;
+    port?: number;
+    secure?: boolean;
+    user?: string;
+    pass?: string;
+};
+export type EmailParams = {
+    from: string;
+    to: string | string[];
+    subject: string;
+    html?: string;
+    text?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    replyTo?: string;
+};
+export type EmailResult = {
+    messageId: string;
+    accepted: string[];
+    rejected: string[];
+};
+export declare function sendEmail(params: EmailParams, options?: SmtpOptions): Promise<EmailResult>;

package/dist/src/email.js

@@ -0,0 +1,51 @@
+import nodemailer from "nodemailer";
+function getSmtpConfig(options) {
+    const host = options?.host || process.env.SMTP_HOST;
+    if (!host) {
+        throw new Error("Missing SMTP host. Set SMTP_HOST env var or pass host option.");
+    }
+    // port=0 means "not provided" — fall through to env or default
+    const port = (options?.port && options.port > 0)
+        ? options.port
+        : (Number(process.env.SMTP_PORT) || 587);
+    // secure is only explicitly set if port was explicitly provided as 465,
+    // or SMTP_SECURE env is set. Otherwise default based on resolved port.
+    const secure = options?.secure ?? (process.env.SMTP_SECURE === "true" || port === 465);
+    const user = options?.user || process.env.SMTP_USER;
+    const pass = options?.pass || process.env.SMTP_PASS;
+    const config = { host, port, secure };
+    if (user && pass) {
+        config.auth = { user, pass };
+    }
+    return config;
+}
+export async function sendEmail(params, options) {
+    const config = getSmtpConfig(options);
+    const transporter = nodemailer.createTransport(config);
+    const mailOptions = {
+        from: params.from,
+        to: Array.isArray(params.to) ? params.to.join(", ") : params.to,
+        subject: params.subject,
+    };
+    if (params.html)
+        mailOptions.html = params.html;
+    if (params.text)
+        mailOptions.text = params.text;
+    if (params.cc)
+        mailOptions.cc = Array.isArray(params.cc) ? params.cc.join(", ") : params.cc;
+    if (params.bcc)
+        mailOptions.bcc = Array.isArray(params.bcc) ? params.bcc.join(", ") : params.bcc;
+    if (params.replyTo)
+        mailOptions.replyTo = params.replyTo;
+    try {
+        const info = await transporter.sendMail(mailOptions);
+        return {
+            messageId: info.messageId ?? "",
+            accepted: info.accepted ?? [],
+            rejected: info.rejected ?? [],
+        };
+    }
+    finally {
+        transporter.close();
+    }
+}

package/index.agency

@@ -0,0 +1,63 @@
+/**
+## Installation
+
+```
+npm install @agency-lang/email
+```
+
+## Environment Variables
+
+Set SMTP connection details:
+- `SMTP_HOST` — SMTP server hostname (e.g. "smtp.gmail.com")
+- `SMTP_PORT` — Port number (default: 587)
+- `SMTP_USER` — Username for authentication (optional for unauthenticated relays)
+- `SMTP_PASS` — Password or app password
+- `SMTP_SECURE` — "true" for TLS on connect (port 465), "false" for STARTTLS (port 587)
+
+Alternatively, pass these directly via parameters.
+
+## Usage
+
+```ts
+import { sendEmail } from "pkg::@agency-lang/email"
+
+node main() {
+  const result = sendEmail(
+    from: "you@gmail.com",
+    to: "friend@example.com",
+    subject: "Hello from Agency!",
+    text: "This email was sent by my agent."
+  )
+  print(result)
+}
+```
+
+## Common SMTP Configurations
+
+**Gmail:** host="smtp.gmail.com", port=587, user=your email, pass=app password
+**Outlook:** host="smtp.office365.com", port=587
+**Yahoo:** host="smtp.mail.yahoo.com", port=465, secure=true
+*/
+
+import { sendEmail as sendEmailImpl } from "./dist/src/email.js"
+
+export def sendEmail(from: string, to: string, subject: string, html: string = "", text: string = "", cc: string = "", bcc: string = "", replyTo: string = "", host: string = "", port: number = 0, secure: boolean = false, user: string = "", pass: string = ""): Result {
+  """
+  Send an email via SMTP using Nodemailer. Works with any email provider (Gmail, Outlook, Yahoo, self-hosted, etc). Requires SMTP_HOST env var or pass host directly. Authentication (SMTP_USER/SMTP_PASS) is optional. Set port to 0 for auto-detection (default 587). Secure is auto-detected from port and SMTP_SECURE env var when not explicitly set.
+  """
+  return try sendEmailImpl({
+    from: from,
+    to: to,
+    subject: subject,
+    html: html,
+    text: text,
+    cc: cc,
+    bcc: bcc,
+    replyTo: replyTo
+  }, {
+    host: host,
+    port: port,
+    user: user,
+    pass: pass
+  })
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@agency-lang/email",
+  "version": "0.0.1",
+  "description": "SMTP email integration for Agency via Nodemailer",
+  "type": "module",
+  "agency": "./index.agency",
+  "main": "./index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/src/email.d.ts",
+      "import": "./dist/src/email.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/",
+    "index.agency",
+    "index.js"
+  ],
+  "author": "Aditya Bhargava",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/egonSchiele/agency-lang/issues"
+  },
+  "homepage": "https://github.com/egonSchiele/agency-lang",
+  "dependencies": {
+    "nodemailer": "^7.0.0"
+  },
+  "peerDependencies": {
+    "agency-lang": ">=0.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.6",
+    "@types/nodemailer": "^6.4.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0",
+    "agency-lang": "0.9.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:agency": "agency tests/agency"
+  }
+}