@voltro/plugin-mail 0.84.0 → 0.86.0

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 };

package/dist/index.d.ts

@@ -6,6 +6,7 @@ import { PluginEgressDeclaration } from '@voltro/protocol';
 import { PluginHttpRouteRequest } from '@voltro/protocol';
 import { Schema } from 'effect';
 import { VoltroPlugin } from '@voltro/protocol';
+import { YieldableError } from 'effect/Cause';
 
 /** Any template regardless of its props type — for registries/collections.
  *  `P` is invariant across `EmailTemplate` (it appears in the `props` Schema
@@ -16,7 +17,7 @@ import { VoltroPlugin } from '@voltro/protocol';
 export declare interface AnyEmailTemplate {
     readonly name: string;
     readonly subject: (props: never) => string;
-    readonly props: Schema.Schema.Any;
+    readonly props: Schema.Top;
     readonly render: (props: never) => unknown;
     readonly locale?: string | undefined;
     readonly preview?: unknown;
@@ -57,7 +58,7 @@ export declare const createOutbox: (max?: number) => Outbox;
 
 /** Define a template. Infers the props type from the `props` Schema so
  *  `subject` / `render` receive the decoded shape. */
-export declare const defineEmail: <S extends Schema.Schema.Any>(template: {
+export declare const defineEmail: <S extends Schema.Top>(template: {
     readonly name: string;
     readonly props: S;
     readonly subject: (props: Schema.Schema.Type<S>) => string;
@@ -78,7 +79,7 @@ export declare const defineEmail: <S extends Schema.Schema.Any>(template: {
 export declare interface EmailTemplate<P = unknown> {
     readonly name: string;
     readonly subject: (props: P) => string;
-    readonly props: Schema.Schema<P, P, never> | Schema.Schema.Any;
+    readonly props: Schema.Codec<P, P, never, never> | Schema.Top;
     readonly render: (props: P) => unknown;
     readonly locale?: string;
     /** Realistic example props — pre-fills the dashboard preview box (and
@@ -177,14 +178,12 @@ export declare const mailEgressOf: (options: {
 export declare class MailError extends MailError_base {
 }
 
-declare const MailError_base: Schema.TaggedErrorClass<MailError, "MailError", {
-    readonly _tag: Schema.tag<"MailError">;
-} & {
-    provider: typeof Schema.String;
-    message: typeof Schema.String;
-    transient: typeof Schema.Boolean;
-    status: Schema.optional<typeof Schema.Number>;
-}>;
+declare const MailError_base: Schema.Class<MailError, Schema.TaggedStruct<"MailError", {
+    readonly provider: Schema.String;
+    readonly message: Schema.String;
+    readonly transient: Schema.Boolean;
+    readonly status: Schema.optional<Schema.Number>;
+}>, YieldableError>;
 
 export declare interface MailEvent {
     readonly type: MailEventType;
@@ -385,7 +384,7 @@ export declare interface MailSendRecord {
 export declare class MailService extends MailService_base {
 }
 
-declare const MailService_base: Context.TagClass<MailService, "@voltro/plugin-mail/MailService", MailServiceShape>;
+declare const MailService_base: Context.ServiceClass<MailService, "@voltro/plugin-mail/MailService", MailServiceShape>;
 
 export declare const mailServiceLayer: (options: MailServiceOptions) => Layer.Layer<MailService>;
 
@@ -465,12 +464,10 @@ export declare interface MailUnsubscribe {
 export declare class MailWebhookError extends MailWebhookError_base {
 }
 
-declare const MailWebhookError_base: Schema.TaggedErrorClass<MailWebhookError, "MailWebhookError", {
-    readonly _tag: Schema.tag<"MailWebhookError">;
-} & {
-    provider: typeof Schema.String;
-    message: typeof Schema.String;
-}>;
+declare const MailWebhookError_base: Schema.Class<MailWebhookError, Schema.TaggedStruct<"MailWebhookError", {
+    readonly provider: Schema.String;
+    readonly message: Schema.String;
+}>, YieldableError>;
 
 /**
  * The provider's delivery-event webhook, mounted by the plugin. Bounces and