@softure-ai/mailing 0.0.0-stage → 0.1.6

package/dist/messages/index.d.ts

@@ -0,0 +1,59 @@
+import type { MailingErrorCode } from "../contract.js";
+import { en } from "./en.js";
+/** Complete default dictionaries; apps pass partial overrides per locale. */
+export declare const mailingMessages: {
+    en: {
+        errors: {
+            mailing: {
+                invalid_input: string;
+                rejected: string;
+                unavailable: string;
+                suppressed: string;
+            };
+        };
+        footer: {
+            text: string;
+            htmlLead: string;
+            htmlLink: string;
+        };
+        unsubscribe: {
+            title: string;
+            lead: string;
+            submit: string;
+            doneTitle: string;
+            doneBody: string;
+            invalidTitle: string;
+            invalidBody: string;
+            failed: string;
+        };
+    };
+    pl: {
+        errors: {
+            mailing: {
+                invalid_input: string;
+                rejected: string;
+                unavailable: string;
+                suppressed: string;
+            };
+        };
+        footer: {
+            text: string;
+            htmlLead: string;
+            htmlLink: string;
+        };
+        unsubscribe: {
+            title: string;
+            lead: string;
+            submit: string;
+            doneTitle: string;
+            doneBody: string;
+            invalidTitle: string;
+            invalidBody: string;
+            failed: string;
+        };
+    };
+};
+export type MailingMessages = typeof en;
+/** The copy for a mailing error code; a code the dictionary does not know reads as `unavailable`. */
+export declare function getMailingErrorMessage(messages: MailingMessages, code: MailingErrorCode): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/messages/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAG7B,6EAA6E;AAC7E,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAa,CAAC;AAE1C,MAAM,MAAM,eAAe,GAAG,OAAO,EAAE,CAAC;AAExC,qGAAqG;AACrG,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAIhG"}

package/dist/messages/index.js

@@ -0,0 +1,11 @@
+import { en } from "./en.js";
+import { pl } from "./pl.js";
+/** Complete default dictionaries; apps pass partial overrides per locale. */
+export const mailingMessages = { en, pl };
+/** The copy for a mailing error code; a code the dictionary does not know reads as `unavailable`. */
+export function getMailingErrorMessage(messages, code) {
+    const group = messages.errors.mailing;
+    const name = code.slice("mailing.".length);
+    return (Object.hasOwn(group, name) ? group[name] : undefined) ?? messages.errors.mailing.unavailable;
+}
+//# sourceMappingURL=index.js.map

package/dist/messages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/messages/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,6EAA6E;AAC7E,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;AAI1C,qGAAqG;AACrG,MAAM,UAAU,sBAAsB,CAAC,QAAyB,EAAE,IAAsB;IACtF,MAAM,KAAK,GAAqC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;IACxE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC;AACvG,CAAC"}

package/dist/messages/pl.d.ts

@@ -0,0 +1,3 @@
+import type { en } from "./en.js";
+export declare const pl: typeof en;
+//# sourceMappingURL=pl.d.ts.map

package/dist/messages/pl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pl.d.ts","sourceRoot":"","sources":["../../src/messages/pl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAGlC,eAAO,MAAM,EAAE,EAAE,OAAO,EAwBvB,CAAC"}

package/dist/messages/pl.js

@@ -0,0 +1,27 @@
+// Polish copy lives only in message dictionaries; the language gate exempts `messages/` folders.
+export const pl = {
+    errors: {
+        mailing: {
+            invalid_input: "Tej wiadomości nie da się wysłać. Sprawdź adres i spróbuj ponownie.",
+            rejected: "Usługa pocztowa odrzuciła tę wiadomość.",
+            unavailable: "Usługa pocztowa nie odpowiada. Spróbuj ponownie za chwilę.",
+            suppressed: "Ten adres wypisał się z takich wiadomości, więc nic nie wysłano.",
+        },
+    },
+    footer: {
+        text: "Nie chcesz więcej takich wiadomości? Wypisz się tutaj:",
+        htmlLead: "Nie chcesz więcej takich wiadomości?",
+        htmlLink: "Wypisz się",
+    },
+    unsubscribe: {
+        title: "Wypisanie",
+        lead: "Przestaniesz dostawać od nas takie wiadomości. Poczta o Twoim koncie, na przykład reset hasła, nadal będzie przychodzić.",
+        submit: "Wypisz mnie",
+        doneTitle: "Wypisano",
+        doneBody: "Nie wyślemy Ci już takich wiadomości.",
+        invalidTitle: "Ten odnośnik nie działa",
+        invalidBody: "Otwórz jeszcze raz odnośnik z wiadomości, w całości. Jeśli dalej nie działa, odpisz na wiadomość i poproś o wypisanie.",
+        failed: "Nie udało się tego zapisać. Spróbuj ponownie za chwilę.",
+    },
+};
+//# sourceMappingURL=pl.js.map

package/dist/messages/pl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pl.js","sourceRoot":"","sources":["../../src/messages/pl.ts"],"names":[],"mappings":"AAEA,iGAAiG;AACjG,MAAM,CAAC,MAAM,EAAE,GAAc;IAC3B,MAAM,EAAE;QACN,OAAO,EAAE;YACP,aAAa,EAAE,qEAAqE;YACpF,QAAQ,EAAE,yCAAyC;YACnD,WAAW,EAAE,4DAA4D;YACzE,UAAU,EAAE,kEAAkE;SAC/E;KACF;IACD,MAAM,EAAE;QACN,IAAI,EAAE,wDAAwD;QAC9D,QAAQ,EAAE,sCAAsC;QAChD,QAAQ,EAAE,YAAY;KACvB;IACD,WAAW,EAAE;QACX,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,0HAA0H;QAChI,MAAM,EAAE,aAAa;QACrB,SAAS,EAAE,UAAU;QACrB,QAAQ,EAAE,uCAAuC;QACjD,YAAY,EAAE,yBAAyB;QACvC,WAAW,EAAE,wHAAwH;QACrI,MAAM,EAAE,yDAAyD;KAClE;CACF,CAAC"}

package/dist/next/actions.d.ts

@@ -0,0 +1,2 @@
+export declare function unsubscribeAction(formData: FormData): Promise<void>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/next/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/next/actions.ts"],"names":[],"mappings":"AAeA,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBzE"}

package/dist/next/actions.js

@@ -0,0 +1,35 @@
+"use server";
+// The unsubscribe page's server action. It takes the signed link from the form (the same values
+// the page got in its URL), records the opt-out and redirects to the page's outcome. No session is
+// involved: the signature is the authorization. Next refuses an action whose Origin does not match
+// the host.
+import { errorLogLabel } from "@softure-ai/core";
+import { getSoftureConfig } from "@softure-ai/core/next";
+import { redirect } from "next/navigation";
+import { getMailingRoutes } from "../server/options.js";
+import { unsubscribe } from "../server/suppressions.js";
+import { RECIPIENT_PARAM, readUnsubscribeToken, SIGNATURE_PARAM } from "../server/unsubscribe-link.js";
+import { getMailingContext } from "./context.js";
+import { UNSUBSCRIBE_STATUS_PARAM } from "./params.js";
+export async function unsubscribeAction(formData) {
+    const config = getSoftureConfig();
+    const token = readUnsubscribeToken(formData);
+    let status;
+    try {
+        const result = await unsubscribe(await getMailingContext(config), token, "page");
+        status = result.ok ? "done" : "invalid";
+    }
+    catch (error) {
+        // The label names the kind of failure, never its text: that can carry the link's values.
+        console.error(`@softure-ai/mailing: unsubscribe failed: ${errorLogLabel(error)}`);
+        status = "failed";
+    }
+    const query = new URLSearchParams({ [UNSUBSCRIBE_STATUS_PARAM]: status });
+    if (status === "failed" && token !== null) {
+        // The form comes back with the same link, so the person can try again.
+        query.set(RECIPIENT_PARAM, token.recipientKey);
+        query.set(SIGNATURE_PARAM, token.signature);
+    }
+    redirect(`${getMailingRoutes(config).unsubscribe}?${query.toString()}`);
+}
+//# sourceMappingURL=actions.js.map

package/dist/next/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/next/actions.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,gGAAgG;AAChG,mGAAmG;AACnG,mGAAmG;AACnG,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACvG,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,wBAAwB,EAA0B,MAAM,aAAa,CAAC;AAE/E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,QAAkB;IACxD,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,MAAyB,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,iBAAiB,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACjF,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yFAAyF;QACzF,OAAO,CAAC,KAAK,CAAC,4CAA4C,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClF,MAAM,GAAG,QAAQ,CAAC;IACpB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1E,IAAI,MAAM,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,uEAAuE;QACvE,KAAK,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAC/C,KAAK,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;IACD,QAAQ,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,WAAW,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC1E,CAAC"}

package/dist/next/context.d.ts

@@ -0,0 +1,4 @@
+import { type SoftureConfig } from "@softure-ai/core";
+import type { SuppressionContext } from "../server/suppressions.js";
+export declare function getMailingContext(config?: SoftureConfig): Promise<SuppressionContext>;
+//# sourceMappingURL=context.d.ts.map

package/dist/next/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/next/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,wBAAsB,iBAAiB,CAAC,MAAM,GAAE,aAAkC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAO/G"}

package/dist/next/context.js

@@ -0,0 +1,14 @@
+// What the adapter hands the server functions: the registered config, the process-wide database
+// handle and the wall clock.
+import { systemClock } from "@softure-ai/core";
+import { getSoftureConfig } from "@softure-ai/core/next";
+import { getConfiguredDatabase } from "@softure-ai/db";
+export async function getMailingContext(config = getSoftureConfig()) {
+    if (config.database === null) {
+        // Unreachable for a validated config: the module has a database schema.
+        throw new Error("@softure-ai/mailing: softure.config.ts has no database; mailing needs one");
+    }
+    const { db } = await getConfiguredDatabase(config.database);
+    return { db, clock: systemClock, config };
+}
+//# sourceMappingURL=context.js.map

package/dist/next/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/next/context.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,6BAA6B;AAC7B,OAAO,EAAE,WAAW,EAAsB,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAwB,gBAAgB,EAAE;IAChF,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC7B,wEAAwE;QACxE,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;AAC5C,CAAC"}

package/dist/next/deliver-once.d.ts

@@ -0,0 +1,4 @@
+import type { Delivery, DeliverOptions, DeliveryOutcome } from "../server/deliveries.js";
+/** Sends one mail at most once per scope and recipient; see `deliverOnce` in `@softure-ai/mailing/server`. */
+export declare function deliverOnce(delivery: Delivery, options?: DeliverOptions): Promise<DeliveryOutcome>;
+//# sourceMappingURL=deliver-once.d.ts.map

package/dist/next/deliver-once.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver-once.d.ts","sourceRoot":"","sources":["../../src/next/deliver-once.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAIzF,8GAA8G;AAC9G,wBAAsB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CAE5G"}

package/dist/next/deliver-once.js

@@ -0,0 +1,7 @@
+import { deliverOnce as deliverOnceWithContext } from "../server/deliveries.js";
+import { getMailingContext } from "./context.js";
+/** Sends one mail at most once per scope and recipient; see `deliverOnce` in `@softure-ai/mailing/server`. */
+export async function deliverOnce(delivery, options = {}) {
+    return deliverOnceWithContext(await getMailingContext(), delivery, options);
+}
+//# sourceMappingURL=deliver-once.js.map

package/dist/next/deliver-once.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver-once.js","sourceRoot":"","sources":["../../src/next/deliver-once.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,IAAI,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,8GAA8G;AAC9G,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAkB,EAAE,UAA0B,EAAE;IAChF,OAAO,sBAAsB,CAAC,MAAM,iBAAiB,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC"}

package/dist/next/index.d.ts

@@ -0,0 +1,8 @@
+export { unsubscribeAction } from "./actions.js";
+export { deliverOnce } from "./deliver-once.js";
+export { getMailingMessages } from "./messages.js";
+export { UnsubscribePage, type UnsubscribePageProps } from "./pages.js";
+export { UNSUBSCRIBE_STATUS_PARAM, type UnsubscribeStatus } from "./params.js";
+export { getUnsubscribeRoute, postUnsubscribeRoute } from "./route.js";
+export { sendMail } from "./send-mail.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/next/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/next/index.js

@@ -0,0 +1,11 @@
+// The Next.js adapter of @softure-ai/mailing: sending (and sending once, through the ledger) on the
+// registered configuration, the unsubscribe page with its action, and the one-click route
+// (docs/02-module-standard.md §8).
+export { unsubscribeAction } from "./actions.js";
+export { deliverOnce } from "./deliver-once.js";
+export { getMailingMessages } from "./messages.js";
+export { UnsubscribePage } from "./pages.js";
+export { UNSUBSCRIBE_STATUS_PARAM } from "./params.js";
+export { getUnsubscribeRoute, postUnsubscribeRoute } from "./route.js";
+export { sendMail } from "./send-mail.js";
+//# sourceMappingURL=index.js.map

package/dist/next/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,0FAA0F;AAC1F,mCAAmC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,eAAe,EAA6B,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAA0B,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/next/messages.d.ts

@@ -0,0 +1,5 @@
+import type { SoftureConfig } from "@softure-ai/core";
+import type { MailingMessages } from "../messages/index.js";
+/** The module's copy in the app's locale, with the app's overrides applied. */
+export declare function getMailingMessages(config: SoftureConfig): MailingMessages;
+//# sourceMappingURL=messages.d.ts.map

package/dist/next/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/next/messages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,eAAe,CAGzE"}

package/dist/next/messages.js

@@ -0,0 +1,7 @@
+import { getMailingModule } from "../server/options.js";
+/** The module's copy in the app's locale, with the app's overrides applied. */
+export function getMailingMessages(config) {
+    // The module factory merged the dictionaries; their shape is the module's own.
+    return getMailingModule(config).messages[config.locale];
+}
+//# sourceMappingURL=messages.js.map

package/dist/next/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/next/messages.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAAC,MAAqB;IACtD,+EAA+E;IAC/E,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAoB,CAAC;AAC7E,CAAC"}

package/dist/next/pages.d.ts

@@ -0,0 +1,7 @@
+type SearchParams = Promise<Record<string, string | string[] | undefined>>;
+export interface UnsubscribePageProps {
+    readonly searchParams?: SearchParams;
+}
+export declare function UnsubscribePage({ searchParams }: UnsubscribePageProps): Promise<import("react").JSX.Element>;
+export {};
+//# sourceMappingURL=pages.d.ts.map

package/dist/next/pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/next/pages.tsx"],"names":[],"mappings":"AAaA,KAAK,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;AAE3E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;CACtC;AAyBD,wBAAsB,eAAe,CAAC,EAAE,YAAY,EAAE,EAAE,oBAAoB,wCA0B3E"}

package/dist/next/pages.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// The unsubscribe page, ready to mount with one line:
+// `export { UnsubscribePage as default } from "@softure-ai/mailing/next"`.
+// A server component without client JavaScript: the button is a plain form posting a server
+// action, so it works in any browser a mail client opens. Opening the page changes nothing (mail
+// scanners open links too) and does not check the signature: the submit does.
+import { getSoftureConfig } from "@softure-ai/core/next";
+import { Button, Card, FormError } from "@softure-ai/ui";
+import { RECIPIENT_PARAM, SIGNATURE_PARAM } from "../server/unsubscribe-link.js";
+import { unsubscribeAction } from "./actions.js";
+import { getMailingMessages } from "./messages.js";
+import { UNSUBSCRIBE_STATUS_PARAM } from "./params.js";
+const LAYOUT_CLASS = "sft:mx-auto sft:box-border sft:w-full sft:sm:max-w-md sft:px-4 sft:py-4";
+const FORM_CLASS = "sft:flex sft:flex-col sft:gap-3 sft:font-sans";
+function readParam(params, name) {
+    const value = params[name];
+    return Array.isArray(value) ? value[0] : value;
+}
+/**
+ * The link's token stays out of other sites' Referer headers; `same-origin` (not `no-referrer`)
+ * keeps the Origin header Next checks on server actions.
+ */
+function UnsubscribeLayout({ title, lead, children }) {
+    return (_jsxs("main", { className: LAYOUT_CLASS, children: [_jsx("meta", { name: "referrer", content: "same-origin" }), _jsx(Card, { title: title, subtitle: lead, children: children })] }));
+}
+export async function UnsubscribePage({ searchParams }) {
+    const config = getSoftureConfig();
+    const messages = getMailingMessages(config).unsubscribe;
+    const params = (await searchParams) ?? {};
+    const status = readParam(params, UNSUBSCRIBE_STATUS_PARAM);
+    if (status === "done")
+        return _jsx(UnsubscribeLayout, { title: messages.doneTitle, lead: messages.doneBody });
+    const recipientKey = readParam(params, RECIPIENT_PARAM) ?? "";
+    const signature = readParam(params, SIGNATURE_PARAM) ?? "";
+    if (status === "invalid" || recipientKey === "" || signature === "") {
+        return _jsx(UnsubscribeLayout, { title: messages.invalidTitle, lead: messages.invalidBody });
+    }
+    return (_jsx(UnsubscribeLayout, { title: messages.title, lead: messages.lead, children: _jsxs("form", { action: unsubscribeAction, className: FORM_CLASS, children: [_jsx("input", { type: "hidden", name: RECIPIENT_PARAM, value: recipientKey }), _jsx("input", { type: "hidden", name: SIGNATURE_PARAM, value: signature }), _jsx(FormError, { message: status === "failed" ? messages.failed : undefined }), _jsx("div", { children: _jsx(Button, { type: "submit", variant: "primary", children: messages.submit }) })] }) }));
+}
+//# sourceMappingURL=pages.js.map

package/dist/next/pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../src/next/pages.tsx"],"names":[],"mappings":"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"}

package/dist/next/params.d.ts

@@ -0,0 +1,4 @@
+/** Set by the action after a submit: `done`, `invalid` or `failed`. */
+export declare const UNSUBSCRIBE_STATUS_PARAM = "status";
+export type UnsubscribeStatus = "done" | "invalid" | "failed";
+//# sourceMappingURL=params.d.ts.map

package/dist/next/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/next/params.ts"],"names":[],"mappings":"AAEA,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,WAAW,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC"}

package/dist/next/params.js

@@ -0,0 +1,4 @@
+// The query parameter the unsubscribe page and its action pass between each other.
+/** Set by the action after a submit: `done`, `invalid` or `failed`. */
+export const UNSUBSCRIBE_STATUS_PARAM = "status";
+//# sourceMappingURL=params.js.map

package/dist/next/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/next/params.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,uEAAuE;AACvE,MAAM,CAAC,MAAM,wBAAwB,GAAG,QAAQ,CAAC"}

package/dist/next/route.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Records the opt-out of the link in the URL. The body (`List-Unsubscribe=One-Click`) is not read:
+ * anyone can send it, the signature is the proof. 200 once recorded (also again), 400 for a link
+ * that does not verify, 500 when the database fails: the client may retry, and 200 would claim an
+ * opt-out that did not happen.
+ */
+export declare function postUnsubscribeRoute(request: Request): Promise<Response>;
+/**
+ * A client without RFC 8058 opens the header's URL in a browser: send it to the page with the
+ * same link (303, so nothing changes on GET). A 405 would also put the token in access logs that
+ * record failed requests.
+ */
+export declare function getUnsubscribeRoute(request: Request): Response;
+//# sourceMappingURL=route.d.ts.map

package/dist/next/route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../src/next/route.ts"],"names":[],"mappings":"AAmBA;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAS9E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAG9D"}

package/dist/next/route.js

@@ -0,0 +1,44 @@
+// The RFC 8058 one-click route. Mount both handlers with a rename in
+// app/api/mailing/unsubscribe/route.ts:
+// `export { postUnsubscribeRoute as POST, getUnsubscribeRoute as GET } from "@softure-ai/mailing/next"`.
+//
+// Mail clients (Gmail, Outlook, Apple Mail) POST here from their own servers: no cookies, no
+// server action id, a foreign Origin. That is why this is a route handler and not an action. It
+// needs no session and must stay outside any auth guard. There is no per-IP rate limit on
+// purpose: a few provider addresses act for millions of people, so a bucket would refuse real
+// unsubscribes. The link is checked by shape and signature before the database is touched, and
+// the only write is an idempotent insert.
+import { errorLogLabel } from "@softure-ai/core";
+import { getSoftureConfig } from "@softure-ai/core/next";
+import { getMailingRoutes } from "../server/options.js";
+import { unsubscribe } from "../server/suppressions.js";
+import { readUnsubscribeToken } from "../server/unsubscribe-link.js";
+import { getMailingContext } from "./context.js";
+const NO_STORE = { "cache-control": "no-store" };
+/**
+ * Records the opt-out of the link in the URL. The body (`List-Unsubscribe=One-Click`) is not read:
+ * anyone can send it, the signature is the proof. 200 once recorded (also again), 400 for a link
+ * that does not verify, 500 when the database fails: the client may retry, and 200 would claim an
+ * opt-out that did not happen.
+ */
+export async function postUnsubscribeRoute(request) {
+    const token = readUnsubscribeToken(new URL(request.url).searchParams);
+    try {
+        const result = await unsubscribe(await getMailingContext(), token, "one-click");
+        return new Response(null, { status: result.ok ? 200 : 400, headers: NO_STORE });
+    }
+    catch (error) {
+        console.error(`@softure-ai/mailing: one-click unsubscribe failed: ${errorLogLabel(error)}`);
+        return new Response(null, { status: 500, headers: NO_STORE });
+    }
+}
+/**
+ * A client without RFC 8058 opens the header's URL in a browser: send it to the page with the
+ * same link (303, so nothing changes on GET). A 405 would also put the token in access logs that
+ * record failed requests.
+ */
+export function getUnsubscribeRoute(request) {
+    const { search } = new URL(request.url);
+    return new Response(null, { status: 303, headers: { ...NO_STORE, location: `${getMailingRoutes(getSoftureConfig()).unsubscribe}${search}` } });
+}
+//# sourceMappingURL=route.js.map

package/dist/next/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../src/next/route.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,wCAAwC;AACxC,yGAAyG;AACzG,EAAE;AACF,6FAA6F;AAC7F,gGAAgG;AAChG,0FAA0F;AAC1F,8FAA8F;AAC9F,+FAA+F;AAC/F,0CAA0C;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,QAAQ,GAAG,EAAE,eAAe,EAAE,UAAU,EAAE,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAgB;IACzD,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC;IACtE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,iBAAiB,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;QAChF,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,sDAAsD,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5F,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC,gBAAgB,EAAE,CAAC,CAAC,WAAW,GAAG,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;AACjJ,CAAC"}

package/dist/next/send-mail.d.ts

@@ -0,0 +1,4 @@
+import { type OutgoingMail, type SendMailOptions, type SendMailResult } from "../contract.js";
+/** Sends one mail with the registered config; see `sendMail` in `@softure-ai/mailing/server`. */
+export declare function sendMail(mail: OutgoingMail, options?: SendMailOptions): Promise<SendMailResult>;
+//# sourceMappingURL=send-mail.d.ts.map

package/dist/next/send-mail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-mail.d.ts","sourceRoot":"","sources":["../../src/next/send-mail.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIlH,iGAAiG;AACjG,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAKzG"}

package/dist/next/send-mail.js

@@ -0,0 +1,16 @@
+// `sendMail` on the app's registered configuration, for server actions and route handlers. List
+// mail also gets the shared database handle (its suppression check); transactional mail never
+// touches the database.
+import { getSoftureConfig } from "@softure-ai/core/next";
+import { TRANSACTIONAL_KIND } from "../contract.js";
+import { sendMail as sendMailWithContext } from "../server/send-mail.js";
+import { getMailingContext } from "./context.js";
+/** Sends one mail with the registered config; see `sendMail` in `@softure-ai/mailing/server`. */
+export async function sendMail(mail, options = {}) {
+    const config = getSoftureConfig();
+    if ((mail.kind ?? TRANSACTIONAL_KIND) === TRANSACTIONAL_KIND)
+        return sendMailWithContext({ config }, mail, options);
+    const { db } = await getMailingContext(config);
+    return sendMailWithContext({ config, db }, mail, options);
+}
+//# sourceMappingURL=send-mail.js.map

package/dist/next/send-mail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send-mail.js","sourceRoot":"","sources":["../../src/next/send-mail.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,8FAA8F;AAC9F,wBAAwB;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAgE,MAAM,gBAAgB,CAAC;AAClH,OAAO,EAAE,QAAQ,IAAI,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAkB,EAAE,UAA2B,EAAE;IAC9E,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,kBAAkB,CAAC,KAAK,kBAAkB;QAAE,OAAO,mBAAmB,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACpH,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,mBAAmB,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC"}

package/dist/options.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import type { MailProvider, OnUnsubscribedHook } from "./contract.js";
+export declare const DEFAULT_TIMEOUT_MS = 10000;
+export declare const mailingOptionsSchema: z.ZodObject<{
+    from: z.ZodString;
+    replyTo: z.ZodOptional<z.ZodString>;
+    provider: z.ZodCustom<MailProvider, MailProvider>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    onUnsubscribed: z.ZodOptional<z.ZodCustom<OnUnsubscribedHook, OnUnsubscribedHook>>;
+}, z.core.$strict>;
+export type MailingOptionsInput = z.input<typeof mailingOptionsSchema>;
+export type MailingOptions = z.output<typeof mailingOptionsSchema>;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEtE,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAQzC,eAAO,MAAM,oBAAoB;;;;;;kBAiB/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/options.js

@@ -0,0 +1,29 @@
+// The options an app passes to `mailing({ ... })` in softure.config.ts, parsed at startup.
+import { z } from "zod";
+import { isMailbox, isSingleAddress } from "./address.js";
+export const DEFAULT_TIMEOUT_MS = 10_000;
+function isMailProvider(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const candidate = value;
+    return typeof candidate.name === "string" && candidate.name !== "" && typeof candidate.send === "function";
+}
+export const mailingOptionsSchema = z.strictObject({
+    /**
+     * The sender of every mail: `hello@example.com` or `Plan <hello@example.com>`. It must be on a
+     * domain the provider signs (DKIM), or DMARC rejects the mail.
+     */
+    from: z.string().trim().refine(isMailbox, "must be an address or Name <address>, e.g. Plan <hello@example.com>"),
+    /** Where replies go; may sit on another domain than `from` (DMARC does not check it). */
+    replyTo: z.string().trim().refine(isSingleAddress, "must be one address, e.g. support@example.com").optional(),
+    /** The adapter that delivers mail: `resend()`, or `fakeMailProvider()` from `/testing`. */
+    provider: z.custom(isMailProvider, "must be a mail provider such as resend()"),
+    /** How long one send may take before it reads as `mailing.unavailable`. */
+    timeoutMs: z.number().int().min(1_000).max(60_000).default(DEFAULT_TIMEOUT_MS),
+    /**
+     * Reacts to an unsubscribe in its transaction, e.g. `withdrawWaitlistConsents` of
+     * `@softure-ai/waitlist/server`, which records the withdrawal in privacy's consent ledger.
+     */
+    onUnsubscribed: z.custom((value) => typeof value === "function", "must be a function").optional(),
+});
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,SAAS,GAAG,KAA2C,CAAC;IAC9D,OAAO,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,KAAK,EAAE,IAAI,OAAO,SAAS,CAAC,IAAI,KAAK,UAAU,CAAC;AAC7G,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,YAAY,CAAC;IACjD;;;OAGG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,qEAAqE,CAAC;IAChH,yFAAyF;IACzF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,eAAe,EAAE,+CAA+C,CAAC,CAAC,QAAQ,EAAE;IAC9G,2FAA2F;IAC3F,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAe,cAAc,EAAE,0CAA0C,CAAC;IAC5F,2EAA2E;IAC3E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IAC9E;;;OAGG;IACH,cAAc,EAAE,CAAC,CAAC,MAAM,CAAqB,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,UAAU,EAAE,oBAAoB,CAAC,CAAC,QAAQ,EAAE;CACtH,CAAC,CAAC"}

package/dist/providers/resend.d.ts

@@ -0,0 +1,17 @@
+import type { MailProvider } from "../contract.js";
+export declare const RESEND_ENDPOINT = "https://api.resend.com/emails";
+export declare const RESEND_API_KEY_ENV = "RESEND_API_KEY";
+export interface ResendOptions {
+    /**
+     * The API key. Default: `process.env.RESEND_API_KEY`, read on every send, so the configuration
+     * loads at build time without the secret.
+     */
+    readonly apiKey?: string;
+    /** Default: Resend's `POST /emails`. For a proxy or a test server. */
+    readonly endpoint?: string;
+    /** Injected in tests; default: the global `fetch`. */
+    readonly fetch?: typeof fetch;
+}
+/** Sends through Resend's HTTP API. */
+export declare function resend(options?: ResendOptions): MailProvider;
+//# sourceMappingURL=resend.d.ts.map

package/dist/providers/resend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resend.d.ts","sourceRoot":"","sources":["../../src/providers/resend.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAoC,MAAM,gBAAgB,CAAC;AAErF,eAAO,MAAM,eAAe,kCAAkC,CAAC;AAC/D,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CAC/B;AAQD,uCAAuC;AACvC,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,YAAY,CA0BhE"}

package/dist/providers/resend.js

@@ -0,0 +1,64 @@
+export const RESEND_ENDPOINT = "https://api.resend.com/emails";
+export const RESEND_API_KEY_ENV = "RESEND_API_KEY";
+/** Resend's name for an idempotency key that another request is still using: retry later. */
+const CONCURRENT_IDEMPOTENT_REQUESTS = "concurrent_idempotent_requests";
+/** Statuses below 500 that mean "try again later", not "this mail is refused". */
+const RETRYABLE_CLIENT_STATUSES = new Set([408, 429]);
+/** Sends through Resend's HTTP API. */
+export function resend(options = {}) {
+    const endpoint = options.endpoint ?? RESEND_ENDPOINT;
+    return {
+        name: "resend",
+        send: async (message, { signal }) => {
+            const apiKey = (options.apiKey ?? process.env[RESEND_API_KEY_ENV] ?? "").trim();
+            if (apiKey === "") {
+                // A deployment without the key cannot send anything until it is set; never a caller error.
+                console.error(`mailing: resend has no API key; set ${RESEND_API_KEY_ENV} or pass resend({ apiKey })`);
+                return { status: "unavailable" };
+            }
+            const fetchImpl = options.fetch ?? fetch;
+            const response = await fetchImpl(endpoint, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                    ...(message.idempotencyKey === null ? {} : { "Idempotency-Key": message.idempotencyKey }),
+                },
+                body: JSON.stringify(toResendBody(message)),
+                signal,
+                cache: "no-store",
+            });
+            return readOutcome(response);
+        },
+    };
+}
+function toResendBody(message) {
+    return {
+        from: message.from,
+        to: [message.to],
+        subject: message.subject,
+        text: message.text,
+        ...(message.html === null ? {} : { html: message.html }),
+        ...(message.replyTo === null ? {} : { reply_to: message.replyTo }),
+        ...(Object.keys(message.headers).length === 0 ? {} : { headers: message.headers }),
+    };
+}
+async function readOutcome(response) {
+    const payload = await response.json().catch(() => null);
+    if (response.ok) {
+        const id = readString(payload, "id");
+        return id === null ? { status: "unavailable", httpStatus: response.status } : { status: "sent", id };
+    }
+    // Only the error's `name` (an enum) is read: its `message` can echo the address back.
+    const isRetryable = response.status >= 500 ||
+        RETRYABLE_CLIENT_STATUSES.has(response.status) ||
+        (response.status === 409 && readString(payload, "name") === CONCURRENT_IDEMPOTENT_REQUESTS);
+    return { status: isRetryable ? "unavailable" : "rejected", httpStatus: response.status };
+}
+function readString(payload, key) {
+    if (typeof payload !== "object" || payload === null || !Object.hasOwn(payload, key))
+        return null;
+    const value = payload[key];
+    return typeof value === "string" && value !== "" ? value : null;
+}
+//# sourceMappingURL=resend.js.map