statocysts 0.8.0 → 0.9.0

package/dist/index.d.ts

@@ -1,9 +1,31 @@
 import { _ as defineTransport, a as discord, c as Sender, d as buildSenderRegistry, f as DefineProviderContext, g as Transport, h as defineProvider, i as slack, l as SenderRegistry, m as ServiceProvider, n as bark, o as HttpPayload, p as DefineProviderOptions, r as telegram, s as http, t as json, u as SenderUrl } from "./index-DcoOHy7e.js";
+import { Message, MessageHeaders, SMTPConnectionOptions } from "emailjs";
 
+//#region src/core/transports/smtp.d.ts
+/**
+ * SMTP payload for SMTP transport
+ */
+interface SmtpPayload {
+  /**
+   * SMTP client configuration
+   */
+  client: Partial<SMTPConnectionOptions>;
+  /**
+   * Email message to send
+   */
+  message: Message | MessageHeaders;
+}
+//#endregion
+//#region src/services/specialized/email/index.d.ts
+interface EmailOptions {
+  defaultFrom?: string;
+  smtpConfig?: Partial<SMTPConnectionOptions>;
+}
+declare const email: ServiceProvider<"email:", SmtpPayload, EmailOptions>;
+//#endregion
 //#region src/index.d.ts
-
 declare const senderRegistry: SenderRegistry;
 declare function createSender(urls: SenderUrl[]): Sender;
 declare function send(url: string | URL, title: string, body?: string): Promise<void>;
 //#endregion
-export { DefineProviderContext, DefineProviderOptions, HttpPayload, Sender, SenderRegistry, SenderUrl, ServiceProvider, Transport, bark, buildSenderRegistry, createSender, defineProvider, defineTransport, discord, http, json, send, senderRegistry, slack, telegram };
+export { DefineProviderContext, DefineProviderOptions, HttpPayload, Sender, SenderRegistry, SenderUrl, ServiceProvider, Transport, bark, buildSenderRegistry, createSender, defineProvider, defineTransport, discord, email, http, json, send, senderRegistry, slack, telegram };

package/dist/index.js

@@ -1,8 +1,83 @@
 import { a as slack, c as defineTransport, i as telegram, l as defineProvider, n as bark, o as discord, r as buildSenderRegistry, s as http, t as json, u as assert } from "./json-DAUitIVf.js";
+import z from "zod";
+import { SMTPClient } from "emailjs";
 
+//#region src/core/transports/smtp.ts
+/**
+* SMTP transport implementation
+* Handles sending emails over SMTP protocol using emailjs
+*/
+const smtp = defineTransport({ async send(payload) {
+	await new SMTPClient(payload.client).sendAsync(payload.message);
+} });
+
+//#endregion
+//#region src/services/specialized/email/index.ts
+const queryParamSchema = z.object({
+	from: z.string().email().optional(),
+	subject: z.string().optional(),
+	ssl: z.string().transform((val) => val === "true").optional(),
+	tls: z.string().transform((val) => val !== "false").optional()
+});
+const email = defineProvider("email:", {
+	transport: smtp,
+	defaultOptions: {},
+	async prepare(ctx, options) {
+		const { url, message } = ctx;
+		const to = url.searchParams.getAll("to");
+		const cc = url.searchParams.getAll("cc");
+		const bcc = url.searchParams.getAll("bcc");
+		const from = url.searchParams.get("from");
+		const subject = url.searchParams.get("subject");
+		const sslParam = url.searchParams.get("ssl");
+		const tlsParam = url.searchParams.get("tls");
+		const queryResult = queryParamSchema.safeParse({
+			from: from || void 0,
+			subject: subject || void 0,
+			ssl: sslParam || void 0,
+			tls: tlsParam || void 0
+		});
+		if (!queryResult.success) throw new Error(`Invalid email query parameters: ${queryResult.error.message}`);
+		const query = queryResult.data;
+		const host = url.hostname;
+		assert(host, "SMTP host is required");
+		const port = url.port ? Number.parseInt(url.port, 10) : 587;
+		const user = decodeURIComponent(url.username || "");
+		const password = decodeURIComponent(url.password || "");
+		const fromAddress = query.from || options.defaultFrom || user;
+		assert(fromAddress, "Sender email address (from) is required");
+		assert(to.length > 0, "At least one recipient email address (to) is required");
+		const emailSubject = query.subject || message.title;
+		const text = message.body ? `${message.title}\n\n${message.body}` : message.title;
+		return {
+			client: {
+				host,
+				port,
+				...user && password ? {
+					user,
+					password
+				} : {},
+				ssl: query.ssl ?? false,
+				tls: query.tls ?? port === 587,
+				...options.smtpConfig
+			},
+			message: {
+				from: fromAddress,
+				to: to.join(", "),
+				cc: cc.length > 0 ? cc.join(", ") : void 0,
+				bcc: bcc.length > 0 ? bcc.join(", ") : void 0,
+				subject: emailSubject,
+				text
+			}
+		};
+	}
+});
+
+//#endregion
 //#region src/index.ts
 const senderRegistry = buildSenderRegistry([
 	bark,
+	email,
 	json,
 	slack,
 	telegram,
@@ -23,4 +98,4 @@ async function send(url, title, body) {
 }
 
 //#endregion
-export { bark, buildSenderRegistry, createSender, defineProvider, defineTransport, discord, http, json, send, senderRegistry, slack, telegram };
+export { bark, buildSenderRegistry, createSender, defineProvider, defineTransport, discord, email, http, json, send, senderRegistry, slack, telegram };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "statocysts",
   "type": "module",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Notification library for JavaScript",
   "license": "MIT",
   "homepage": "https://github.com/octoplorer/statocysts",
@@ -47,13 +47,16 @@
   "dependencies": {
     "add": "^2.0.6",
     "defu": "^6.1.4",
+    "emailjs": "^5.0.0",
     "ofetch": "^1.5.1",
     "ufo": "^1.6.1",
     "zod": "^4.2.1"
   },
   "devDependencies": {
     "@types/node": "^25.0.3",
+    "@types/smtp-server": "^3.5.12",
     "@vitest/coverage-v8": "4.0.16",
+    "smtp-server": "^3.18.0",
     "tsdown": "^0.18.2",
     "typescript": "^5.9.3",
     "vitest": "^4.0.16"