@voltro/plugin-mail 0.85.0 → 0.86.0

package/THIRD-PARTY-NOTICES.md

@@ -1,11 +1,11 @@
 # Third-Party Notices — @voltro/plugin-mail
 
-This package depends on the open-source software listed below. Each is the
+This package uses the open-source software listed below. Each is the
 property of its respective copyright holders and is used under the terms of
 its license. This file is provided for attribution; it grants no rights in
 @voltro/plugin-mail itself, which is proprietary (see LICENSE).
 
-Generated from the resolved runtime dependency closure (43 packages).
+Generated from the resolved runtime dependency closure (42 packages).
 
 ---
 
@@ -3636,34 +3636,6 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## layerr@3.0.0
-
-License: MIT
-
-```
-MIT License
-
-Copyright (c) 2020 Perry Mitchell
-
-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.
-```
-
 ## lib0@0.2.117
 
 License: MIT
@@ -4036,14 +4008,14 @@ Apache License
    limitations under the License.
 ```
 
-## ulidx@2.4.1
+## ulid@3.0.2
 
 License: MIT
 
 ```
-MIT License
+The MIT License (MIT)
 
-Copyright (c) 2021 Perry Mitchell
+Copyright (c) 2017 Alizain Feerasta
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/egress.js

@@ -0,0 +1,34 @@
+//#region src/egress.ts
+var e = {
+	lettermint: "api.lettermint.co",
+	resend: "api.resend.com",
+	postmark: "api.postmarkapp.com",
+	sendgrid: "api.sendgrid.com"
+}, t = (e) => {
+	try {
+		return new URL(e).host || void 0;
+	} catch {
+		return;
+	}
+}, n = (n) => {
+	let r = n.env ?? {}, i = (e) => [{
+		destination: e,
+		purpose: "outgoing email: recipients, subject and body",
+		data: ["personal", "content"],
+		disable: "MAIL_PROVIDER=console (or memory) logs mail instead of sending it — none leaves"
+	}];
+	if (n.provider !== void 0 && typeof n.provider != "string") {
+		let e = n.provider.name;
+		return e === "console" || e === "memory" ? [] : i(`runtime:the '${e}' mail provider`);
+	}
+	let a = n.provider ?? r.MAIL_PROVIDER ?? "console", o = e[a];
+	if (o !== void 0) return i(o);
+	switch (a) {
+		case "ses": return i(r.AWS_REGION ? `email.${r.AWS_REGION}.amazonaws.com` : "runtime:email.<AWS_REGION>.amazonaws.com");
+		case "mailgun": return i((r.MAILGUN_BASE_URL ? t(r.MAILGUN_BASE_URL) : void 0) ?? "api.mailgun.net");
+		case "smtp": return i((r.SMTP_URL ? t(r.SMTP_URL) : void 0) ?? (r.SMTP_HOST ? `${r.SMTP_HOST}${r.SMTP_PORT ? `:${r.SMTP_PORT}` : ""}` : void 0) ?? "runtime:SMTP_URL or SMTP_HOST");
+		default: return [];
+	}
+};
+//#endregion
+export { n as mailEgressOf };

package/dist/events.js

@@ -0,0 +1,46 @@
+import { Effect as e } from "effect";
+//#region src/events.ts
+var t = (e, t, n, r, i, a = {}) => {
+	if (!t) return null;
+	let o = a.metadata !== null && typeof a.metadata == "object" ? Object.fromEntries(Object.entries(a.metadata).filter(([, e]) => typeof e == "string")) : void 0;
+	return {
+		type: e,
+		email: t,
+		provider: n,
+		raw: i,
+		...r === void 0 ? {} : { messageId: r },
+		...a.eventId === void 0 ? {} : { eventId: a.eventId },
+		...o === void 0 ? {} : { metadata: o }
+	};
+}, n = (e) => e === "message.hard_bounced" ? "bounced" : e === "message.spam_complaint" ? "complained" : e === "message.unsubscribed" ? "unsubscribed" : e === "message.delivered" ? "delivered" : e === "message.opened" ? "opened" : e === "message.clicked" ? "clicked" : "unknown", r = (e) => e === "hard_bounce" ? "bounced" : e === "spam_complaint" ? "complained" : e === "unsubscribe" ? "unsubscribed" : "unknown", i = (e) => e === "email.bounced" ? "bounced" : e === "email.complained" ? "complained" : e === "email.delivered" ? "delivered" : e === "email.opened" ? "opened" : e === "email.clicked" ? "clicked" : "unknown", a = (e) => e === "Bounce" ? "bounced" : e === "SpamComplaint" ? "complained" : e === "Delivery" ? "delivered" : e === "Open" ? "opened" : e === "Click" ? "clicked" : "unknown", o = (e) => e === "bounce" || e === "dropped" ? "bounced" : e === "spamreport" ? "complained" : e === "delivered" ? "delivered" : e === "open" ? "opened" : e === "click" ? "clicked" : "unknown", s = (e, s) => {
+	let c = [], l = (e) => {
+		e && c.push(e);
+	};
+	if (e === "sendgrid" && Array.isArray(s)) {
+		for (let e of s) l(t(o(String(e.event)), e.email, "sendgrid", e.sg_message_id, e));
+		return c;
+	}
+	let u = s ?? {};
+	if (e === "lettermint") {
+		let e = String(u.event), i = u.data ?? {}, a = typeof u.id == "string" ? u.id : void 0;
+		return e === "suppression.added" ? (i.type === "email" && l(t(r(String(i.reason)), i.value, "lettermint", void 0, s, { eventId: a })), c) : e === "suppression.removed" ? (i.type === "email" && l(t("unsuppressed", i.value, "lettermint", void 0, s, { eventId: a })), c) : (e.startsWith("message.") && l(t(n(e), i.recipient, "lettermint", i.message_id, s, {
+			eventId: a,
+			metadata: i.metadata
+		})), c);
+	}
+	if (e === "resend") {
+		let e = u.data ?? {}, n = Array.isArray(e.to) ? e.to[0] : e.to ?? e.email;
+		return l(t(i(String(u.type)), n, "resend", e.email_id, s)), c;
+	}
+	if (e === "postmark") {
+		let e = u.Email ?? u.Recipient;
+		return l(t(a(String(u.RecordType)), e, "postmark", u.MessageID, s, { metadata: u.Metadata })), c;
+	}
+	return c;
+}, c = (t, n, r, i = null) => e.gen(function* () {
+	let e = s(t, n);
+	for (let t of e) t.type === "bounced" || t.type === "complained" ? yield* r.suppress(i, t.email, t.type) : t.type === "unsuppressed" && (yield* r.unsuppress(i, t.email));
+	return e;
+});
+//#endregion
+export { c as handleMailEvents, s as parseMailEvent };

package/dist/idempotency.js

@@ -0,0 +1,62 @@
+import { MAIL_IDEMPOTENCY_TABLE as e, attempt as t, describeError as n } from "./storeTables.js";
+import { Effect as r } from "effect";
+import { createLogger as i } from "@voltro/logger";
+import { and as a, eq as o } from "@voltro/database";
+//#region src/idempotency.ts
+var s = i({ scope: "@voltro/plugin-mail" }), c = (e) => e ?? "*", l = () => {
+	let e = /* @__PURE__ */ new Map(), t = (e, t) => `${c(e)} ${t}`;
+	return {
+		reserve: (n, i) => r.sync(() => {
+			let r = t(n, i);
+			if (e.has(r)) {
+				let t = e.get(r);
+				return t ? {
+					won: !1,
+					prior: t
+				} : { won: !1 };
+			}
+			return e.set(r, null), { won: !0 };
+		}),
+		record: (n, i, a) => r.sync(() => void e.set(t(n, i), a))
+	};
+}, u = () => {
+	let i = null;
+	return {
+		reserve: (a, o) => {
+			let l = i;
+			return l ? t(() => l.insertIgnoreWithOutcome(e, {
+				tenant: c(a),
+				key: o,
+				createdAt: /* @__PURE__ */ new Date()
+			}, { conflictColumns: ["tenant", "key"] })).pipe(r.map(({ row: e, outcome: t }) => {
+				if (t === "inserted") return { won: !0 };
+				let n = e.resultId, r = e.resultProvider;
+				return typeof n == "string" && typeof r == "string" ? {
+					won: !1,
+					prior: {
+						id: n,
+						provider: r
+					}
+				} : { won: !1 };
+			}), r.catch((e) => r.sync(() => (s.warn("idempotency reserve failed — skipping send to avoid a double", {
+				key: o,
+				message: n(e)
+			}), { won: !1 })))) : r.succeed({ won: !0 });
+		},
+		record: (l, u, d) => {
+			let f = i;
+			return f ? t(() => f.updateMany(e, {
+				resultId: d.id,
+				resultProvider: d.provider
+			}, { where: a(o("tenant", c(l)), o("key", u)) })).pipe(r.asVoid, r.catch((e) => r.sync(() => s.warn("idempotency record failed", {
+				key: u,
+				message: n(e)
+			})))) : r.void;
+		},
+		bind: async (e) => {
+			i = e;
+		}
+	};
+};
+//#endregion
+export { l as memoryIdempotencyStore, u as postgresIdempotencyStore };