@pattern-js/mod-email 0.3.0-main.4a77893

package/dist/markdown.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @pattern-js/mod-email — markdown → email HTML + plain-text alternative.
+ *
+ * Email clients ignore stylesheets, so every style is inline and the subset is
+ * deliberately small: headings, paragraphs, fenced code, lists, bold/italic/
+ * code spans, links (+ bare-URL autolink). One email-specific rule: a paragraph
+ * that is EXACTLY one link renders as a button — the "click the button" line in
+ * a sign-in email costs nothing to author. Only http/https/mailto hrefs survive
+ * (a `javascript:` link renders as plain text). Zero dependencies on purpose:
+ * this is the provider-independent part of sending decent email, and it belongs
+ * to the contract mod.
+ */
+export declare function renderEmailMarkdown(md: string): {
+    html: string;
+    text: string;
+};
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA8IH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA4C9E"}

package/dist/markdown.js

@@ -0,0 +1,173 @@
+/**
+ * @pattern-js/mod-email — markdown → email HTML + plain-text alternative.
+ *
+ * Email clients ignore stylesheets, so every style is inline and the subset is
+ * deliberately small: headings, paragraphs, fenced code, lists, bold/italic/
+ * code spans, links (+ bare-URL autolink). One email-specific rule: a paragraph
+ * that is EXACTLY one link renders as a button — the "click the button" line in
+ * a sign-in email costs nothing to author. Only http/https/mailto hrefs survive
+ * (a `javascript:` link renders as plain text). Zero dependencies on purpose:
+ * this is the provider-independent part of sending decent email, and it belongs
+ * to the contract mod.
+ */
+const FONT = "-apple-system,'Segoe UI',Roboto,Helvetica,Arial,sans-serif";
+const MONO = "ui-monospace,SFMono-Regular,Menlo,Consolas,monospace";
+const S = {
+    wrap: `max-width:560px;margin:0 auto;padding:24px;font-family:${FONT};font-size:15px;line-height:1.6;color:#1a1a1a;`,
+    h1: `margin:0 0 12px;font-size:22px;line-height:1.3;font-weight:700;`,
+    h2: `margin:20px 0 8px;font-size:18px;line-height:1.35;font-weight:700;`,
+    h3: `margin:16px 0 6px;font-size:15px;line-height:1.4;font-weight:700;`,
+    p: `margin:0 0 12px;`,
+    a: `color:#2563eb;text-decoration:underline;`,
+    button: `display:inline-block;padding:12px 20px;border-radius:8px;background:#111111;color:#ffffff;text-decoration:none;font-weight:600;`,
+    code: `font-family:${MONO};font-size:13px;background:#f4f4f5;border-radius:4px;padding:1px 5px;`,
+    pre: `margin:0 0 12px;padding:12px 14px;background:#f4f4f5;border-radius:8px;font-family:${MONO};font-size:13px;line-height:1.5;overflow:auto;white-space:pre-wrap;`,
+    list: `margin:0 0 12px;padding-left:24px;`,
+};
+const SAFE_HREF = /^(https?:|mailto:)/i;
+// After HTML-escaping, `&` in a URL reads `&` — fine inside an attribute.
+const URL_RE = /https?:\/\/[^\s<>"')]+/g;
+// Placeholder delimiter for protected inline spans; stripped from input first.
+const NUL = "\u0000";
+function escapeHtml(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}
+function parseBlocks(md) {
+    const blocks = [];
+    const lines = md.replace(/\r\n/g, "\n").split("\n");
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i];
+        if (!line.trim()) {
+            i++;
+            continue;
+        }
+        // Fenced code — verbatim until the closing fence.
+        if (/^```/.test(line)) {
+            const body = [];
+            i++;
+            while (i < lines.length && !/^```/.test(lines[i])) {
+                body.push(lines[i]);
+                i++;
+            }
+            i++; // closing fence (or EOF)
+            blocks.push({ kind: "code", body: body.join("\n") });
+            continue;
+        }
+        const heading = /^(#{1,3})\s+(.*)$/.exec(line);
+        if (heading) {
+            blocks.push({ kind: "heading", depth: heading[1].length, text: heading[2] });
+            i++;
+            continue;
+        }
+        const bullet = /^\s*[-*]\s+(.*)$/.exec(line);
+        const numbered = /^\s*\d+[.)]\s+(.*)$/.exec(line);
+        if (bullet || numbered) {
+            const ordered = Boolean(numbered);
+            const items = [];
+            const re = ordered ? /^\s*\d+[.)]\s+(.*)$/ : /^\s*[-*]\s+(.*)$/;
+            while (i < lines.length) {
+                const m = re.exec(lines[i]);
+                if (!m)
+                    break;
+                items.push(m[1]);
+                i++;
+            }
+            blocks.push({ kind: "list", ordered, items });
+            continue;
+        }
+        // Paragraph: consecutive non-blank, non-structural lines join with spaces.
+        const para = [line.trim()];
+        i++;
+        while (i < lines.length && lines[i].trim() && !/^(#{1,3}\s|```|\s*[-*]\s|\s*\d+[.)]\s)/.test(lines[i])) {
+            para.push(lines[i].trim());
+            i++;
+        }
+        blocks.push({ kind: "para", text: para.join(" ") });
+    }
+    return blocks;
+}
+/* ── inline rendering (on escaped text) ────────────────────────────────── */
+function renderInline(escaped) {
+    // Protect code spans (and built anchors) from further formatting with
+    // NUL-delimited placeholders — NUL can't survive in the input (stripped).
+    const stash = [];
+    const keep = (html) => `${NUL}${stash.push(html) - 1}${NUL}`;
+    let s = escaped.replace(/`([^`]+)`/g, (_, code) => keep(`<code style="${S.code}">${code}</code>`));
+    // [text](url) — unsafe schemes render as their text, not a link.
+    s = s.replace(/\[([^\]]+)\]\(([^)\s]+)\)/g, (_, text, href) => SAFE_HREF.test(href) ? keep(`<a href="${href}" style="${S.a}">${text}</a>`) : text);
+    // Bare URLs autolink.
+    s = s.replace(URL_RE, (url) => keep(`<a href="${url}" style="${S.a}">${url}</a>`));
+    s = s.replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+    s = s.replace(/(^|\W)\*([^*\s][^*]*)\*/g, "$1<em>$2</em>");
+    s = s.replace(/(^|\W)_([^_\s][^_]*)_/g, "$1<em>$2</em>");
+    return s.replace(/\u0000(\d+)\u0000/g, (_, n) => stash[Number(n)]);
+}
+/** The button rule: a paragraph that is exactly one link (or one bare URL). */
+function soleLink(text) {
+    const t = text.trim();
+    const linked = /^\[([^\]]+)\]\(([^)\s]+)\)$/.exec(t);
+    if (linked && SAFE_HREF.test(linked[2]))
+        return { href: linked[2], label: linked[1] };
+    if (/^https?:\/\/\S+$/.test(t))
+        return { href: t, label: t };
+    return undefined;
+}
+/* ── text alternative ──────────────────────────────────────────────────── */
+function inlineText(text) {
+    return text
+        .replace(/`([^`]+)`/g, "$1")
+        .replace(/\[([^\]]+)\]\(([^)\s]+)\)/g, (_, label, href) => (label === href ? href : `${label} (${href})`))
+        .replace(/\*\*([^*]+)\*\*/g, "$1")
+        .replace(/(^|\W)\*([^*\s][^*]*)\*/g, "$1$2")
+        .replace(/(^|\W)_([^_\s][^_]*)_/g, "$1$2");
+}
+/* ── public API ────────────────────────────────────────────────────────── */
+export function renderEmailMarkdown(md) {
+    const blocks = parseBlocks(md.replaceAll(NUL, ""));
+    const html = blocks
+        .map((b) => {
+        switch (b.kind) {
+            case "heading": {
+                const tag = `h${b.depth}`;
+                return `<${tag} style="${S[tag]}">${renderInline(escapeHtml(b.text))}</${tag}>`;
+            }
+            case "code":
+                return `<pre style="${S.pre}">${escapeHtml(b.body)}</pre>`;
+            case "list": {
+                const tag = b.ordered ? "ol" : "ul";
+                const items = b.items.map((it) => `<li>${renderInline(escapeHtml(it))}</li>`).join("");
+                return `<${tag} style="${S.list}">${items}</${tag}>`;
+            }
+            case "para": {
+                const button = soleLink(b.text);
+                if (button) {
+                    return `<p style="${S.p}"><a href="${escapeHtml(button.href)}" style="${S.button}">${escapeHtml(button.label)}</a></p>`;
+                }
+                return `<p style="${S.p}">${renderInline(escapeHtml(b.text))}</p>`;
+            }
+        }
+    })
+        .join("\n");
+    const text = blocks
+        .map((b) => {
+        switch (b.kind) {
+            case "heading":
+                return inlineText(b.text);
+            case "code":
+                return b.body;
+            case "list":
+                return b.items.map((it, i) => (b.ordered ? `${i + 1}. ${inlineText(it)}` : `- ${inlineText(it)}`)).join("\n");
+            case "para":
+                return inlineText(b.text);
+        }
+    })
+        .join("\n\n");
+    return { html: `<div style="${S.wrap}">\n${html}\n</div>`, text };
+}
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

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

package/dist/mod.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @pattern-js/mod-email — mod assembly.
+ *
+ * The CONTRACT mod: it owns the account settings, the `email.send` /
+ * `email.account` ops, the admin page, and the packaged sign-in delivery
+ * workflow. It sends nothing by itself — driver mods (mod-email-resend,
+ * mod-email-smtp, …) register an `EmailDriverSpec` on the service in their
+ * `ready()`. Both services are provided in `setup`, so drivers can rely on
+ * them regardless of listing order in pattern.config.json (two-phase install).
+ */
+import { type PatternMod } from "@pattern-js/core";
+export interface EmailModOptions {
+    /** Where accounts persist. Default ".pattern-data/email-config.json". */
+    configPath?: string;
+}
+export declare function emailMod(options?: EmailModOptions): PatternMod;
+/** Ready-to-use with defaults (for `loadMods`/`engine.use`). */
+declare const _default: PatternMod;
+export default _default;
+//# sourceMappingURL=mod.d.ts.map

package/dist/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAS3E,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAYD,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,UAAU,CAqBlE;AAED,gEAAgE;;AAChE,wBAA0B"}

package/dist/mod.js

@@ -0,0 +1,57 @@
+/**
+ * @pattern-js/mod-email — mod assembly.
+ *
+ * The CONTRACT mod: it owns the account settings, the `email.send` /
+ * `email.account` ops, the admin page, and the packaged sign-in delivery
+ * workflow. It sends nothing by itself — driver mods (mod-email-resend,
+ * mod-email-smtp, …) register an `EmailDriverSpec` on the service in their
+ * `ready()`. Both services are provided in `setup`, so drivers can rely on
+ * them regardless of listing order in pattern.config.json (two-phase install).
+ */
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { localFs, provideFilesystem } from "@pattern-js/runtime-node";
+import { defineMod } from "@pattern-js/core";
+import { EmailConfigService } from "./config.js";
+import { DefaultEmailService } from "./service.js";
+import { EMAIL_CONFIG_SERVICE, EMAIL_SERVICE } from "./well-known.js";
+import { accountOp } from "./ops/account.js";
+import { sendOp } from "./ops/send.js";
+import { deliverTokenWorkflow } from "./delivery.js";
+import { emailAdminRoutes, emailFrontend, settingsOps } from "./settings.js";
+/** The packaged docs/ chapter (the `docs` contribution points at "email-docs"). */
+function packagedDocs(engine) {
+    try {
+        const dir = fileURLToPath(new URL("../docs", import.meta.url));
+        if (existsSync(dir))
+            provideFilesystem(engine, "email-docs", localFs(dir));
+    }
+    catch {
+        /* packaged without docs — the contribution is simply skipped */
+    }
+}
+export function emailMod(options = {}) {
+    const config = new EmailConfigService(options.configPath);
+    const service = new DefaultEmailService(config);
+    return defineMod({
+        name: "@pattern-js/mod-email",
+        docs: { filesystem: "email-docs", title: "Email", order: 43 },
+        ops: [sendOp, accountOp, ...settingsOps],
+        // The delivery workflow registers unconditionally: without mod-identity its
+        // hook is auto-declared and never invoked (inert); with it, delivery starts
+        // the moment a "default" account exists.
+        workflows: [deliverTokenWorkflow(), ...emailAdminRoutes()],
+        frontend: emailFrontend(),
+        setup: (engine) => {
+            packagedDocs(engine);
+            engine.provideService(EMAIL_CONFIG_SERVICE, config);
+            engine.provideService(EMAIL_SERVICE, service);
+        },
+        ready: async () => {
+            await config.load();
+        },
+    });
+}
+/** Ready-to-use with defaults (for `loadMods`/`engine.use`). */
+export default emailMod();
+//# sourceMappingURL=mod.js.map

package/dist/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,SAAS,EAAgC,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAO7E,mFAAmF;AACnF,SAAS,YAAY,CAAC,MAAc;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,IAAI,UAAU,CAAC,GAAG,CAAC;YAAE,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,gEAAgE;IAClE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,UAA2B,EAAE;IACpD,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,SAAS,CAAC;QACf,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;QAC7D,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,WAAW,CAAC;QACxC,4EAA4E;QAC5E,4EAA4E;QAC5E,yCAAyC;QACzC,SAAS,EAAE,CAAC,oBAAoB,EAAE,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAC1D,QAAQ,EAAE,aAAa,EAAE;QACzB,KAAK,EAAE,CAAC,MAAc,EAAE,EAAE;YACxB,YAAY,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,CAAC,cAAc,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;YACpD,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;QACD,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,gEAAgE;AAChE,eAAe,QAAQ,EAAE,CAAC"}

package/dist/ops/account.d.ts

@@ -0,0 +1,4 @@
+/** @pattern-js/mod-email — email.account: resolve a named account to a ref value (like ai.alias). */
+import { type OpDefinition } from "@pattern-js/core";
+export declare const accountOp: OpDefinition;
+//# sourceMappingURL=account.d.ts.map

package/dist/ops/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/ops/account.ts"],"names":[],"mappings":"AAAA,qGAAqG;AAErG,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAK/D,eAAO,MAAM,SAAS,EAAE,YA2BvB,CAAC"}

package/dist/ops/account.js

@@ -0,0 +1,33 @@
+/** @pattern-js/mod-email — email.account: resolve a named account to a ref value (like ai.alias). */
+import { value, z } from "@pattern-js/core";
+import { accountRefSchema } from "../types.js";
+import { DEFAULT_ACCOUNT } from "../config.js";
+import { emailConfig, maybe } from "./shared.js";
+export const accountOp = {
+    type: "email.account",
+    title: "email.account",
+    description: "Resolve a named email account (configured in admin → System → Email) to an account reference. " +
+        "Re-pointing the account in admin instantly re-targets every workflow using it. Defaults to " +
+        '"default". With required=false it probes instead of throwing: `configured` reports whether the ' +
+        "account exists — the packaged delivery workflow branches on it.",
+    config: z.object({
+        account: z.string().min(1).default(DEFAULT_ACCOUNT),
+        required: z.boolean().default(true),
+    }),
+    configInputs: { account: value(z.string()) },
+    inputs: {},
+    outputs: {
+        account: value(accountRefSchema.nullable()),
+        configured: value(z.boolean()),
+    },
+    execute: async (ctx) => {
+        const cfg = ctx.config;
+        const name = (await maybe(ctx, "account")) ?? cfg.account;
+        const ref = emailConfig(ctx).resolveAccount(name);
+        if (!ref && cfg.required) {
+            throw new Error(`email.account: no account "${name}" is configured — add it in admin → System → Email.`);
+        }
+        return { account: ref ?? null, configured: Boolean(ref) };
+    },
+};
+//# sourceMappingURL=account.js.map

package/dist/ops/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../../src/ops/account.ts"],"names":[],"mappings":"AAAA,qGAAqG;AAErG,OAAO,EAAE,KAAK,EAAE,CAAC,EAAqB,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,CAAC,MAAM,SAAS,GAAiB;IACrC,IAAI,EAAE,eAAe;IACrB,KAAK,EAAE,eAAe;IACtB,WAAW,EACT,gGAAgG;QAChG,6FAA6F;QAC7F,iGAAiG;QACjG,iEAAiE;IACnE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;QACnD,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;KACpC,CAAC;IACF,YAAY,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE;IAC5C,MAAM,EAAE,EAAE;IACV,OAAO,EAAE;QACP,OAAO,EAAE,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC;QAC3C,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;KAC/B;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,GAAG,CAAC,MAAgD,CAAC;QACjE,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,CAAS,GAAG,EAAE,SAAS,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC;QAClE,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,qDAAqD,CAAC,CAAC;QAC3G,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;IAC5D,CAAC;CACF,CAAC"}

package/dist/ops/send.d.ts

@@ -0,0 +1,4 @@
+/** @pattern-js/mod-email — email.send: the operational node every driver serves. */
+import { type OpDefinition } from "@pattern-js/core";
+export declare const sendOp: OpDefinition;
+//# sourceMappingURL=send.d.ts.map

package/dist/ops/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../src/ops/send.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAMzE,eAAO,MAAM,MAAM,EAAE,YAwDpB,CAAC"}

package/dist/ops/send.js

@@ -0,0 +1,57 @@
+/** @pattern-js/mod-email — email.send: the operational node every driver serves. */
+import { required, value, z } from "@pattern-js/core";
+import { accountRefSchema, attachmentInputSchema } from "../types.js";
+import { emailService, maybe } from "./shared.js";
+const recipients = z.union([z.string(), z.array(z.string())]);
+export const sendOp = {
+    type: "email.send",
+    title: "email.send",
+    description: "Send an email through a configured account (drivers: Resend, SMTP, …). Write the body once in " +
+        "`markdown` — it renders to inline-styled HTML plus a plain-text alternative (a paragraph that is " +
+        "exactly one link becomes a button) — or pass explicit `html`/`text`, which win per part. " +
+        "Attachments accept in-memory media ({bytes,mime}), blob references ({blobId}), or literal files " +
+        '({filename,content}). Without an `account` input it uses the "default" account.',
+    config: z.object({
+        /** Static account name; an `account` input (ref or name) wins over it. */
+        account: z.string().optional(),
+    }),
+    inputs: {
+        account: value(z.union([accountRefSchema, z.string()])),
+        to: required(recipients),
+        subject: required(z.string()),
+        markdown: value(z.string()),
+        html: value(z.string()),
+        text: value(z.string()),
+        from: value(z.string()),
+        cc: value(recipients),
+        bcc: value(recipients),
+        replyTo: value(z.string()),
+        attachments: value(z.array(attachmentInputSchema)),
+    },
+    outputs: {
+        result: value(z.object({
+            messageId: z.string().optional(),
+            provider: z.string(),
+            account: z.string(),
+        })),
+    },
+    execute: async (ctx) => {
+        const cfg = ctx.config;
+        const [account, to, subject, markdown, html, text, from, cc, bcc, replyTo, attachments] = await Promise.all([
+            maybe(ctx, "account"),
+            ctx.input.value("to"),
+            ctx.input.value("subject"),
+            maybe(ctx, "markdown"),
+            maybe(ctx, "html"),
+            maybe(ctx, "text"),
+            maybe(ctx, "from"),
+            maybe(ctx, "cc"),
+            maybe(ctx, "bcc"),
+            maybe(ctx, "replyTo"),
+            maybe(ctx, "attachments"),
+        ]);
+        const result = await emailService(ctx).send({ account: account ?? cfg.account, to, cc, bcc, replyTo, from, subject, markdown, html, text, attachments }, ctx);
+        return { result };
+    },
+};
+//# sourceMappingURL=send.js.map

package/dist/ops/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../../src/ops/send.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAEpF,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAqB,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAA8C,MAAM,aAAa,CAAC;AAClH,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,MAAM,GAAiB;IAClC,IAAI,EAAE,YAAY;IAClB,KAAK,EAAE,YAAY;IACnB,WAAW,EACT,gGAAgG;QAChG,mGAAmG;QACnG,2FAA2F;QAC3F,kGAAkG;QAClG,iFAAiF;IACnF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,0EAA0E;QAC1E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACvD,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC;QACxB,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7B,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC3B,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACvB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACvB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACvB,EAAE,EAAE,KAAK,CAAC,UAAU,CAAC;QACrB,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC;QACtB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;KACnD;IACD,OAAO,EAAE;QACP,MAAM,EAAE,KAAK,CACX,CAAC,CAAC,MAAM,CAAC;YACP,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;YACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;SACpB,CAAC,CACH;KACF;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,GAAG,CAAC,MAA8B,CAAC;QAC/C,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC1G,KAAK,CAA2B,GAAG,EAAE,SAAS,CAAC;YAC/C,GAAG,CAAC,KAAK,CAAC,KAAK,CAAoB,IAAI,CAAC;YACxC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAS,SAAS,CAAC;YAClC,KAAK,CAAS,GAAG,EAAE,UAAU,CAAC;YAC9B,KAAK,CAAS,GAAG,EAAE,MAAM,CAAC;YAC1B,KAAK,CAAS,GAAG,EAAE,MAAM,CAAC;YAC1B,KAAK,CAAS,GAAG,EAAE,MAAM,CAAC;YAC1B,KAAK,CAAoB,GAAG,EAAE,IAAI,CAAC;YACnC,KAAK,CAAoB,GAAG,EAAE,KAAK,CAAC;YACpC,KAAK,CAAS,GAAG,EAAE,SAAS,CAAC;YAC7B,KAAK,CAAoB,GAAG,EAAE,aAAa,CAAC;SAC7C,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,CACzC,EAAE,OAAO,EAAE,OAAO,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,EAC3G,GAAG,CACJ,CAAC;QACF,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;CACF,CAAC"}

package/dist/ops/shared.d.ts

@@ -0,0 +1,8 @@
+/** @pattern-js/mod-email — shared op helpers. */
+import type { OpContext } from "@pattern-js/core";
+import type { EmailService } from "../service.js";
+import type { EmailConfigService } from "../config.js";
+export declare function maybe<T>(ctx: OpContext, port: string): Promise<T | undefined>;
+export declare function emailService(ctx: OpContext): EmailService;
+export declare function emailConfig(ctx: OpContext): EmailConfigService;
+//# sourceMappingURL=shared.d.ts.map

package/dist/ops/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/ops/shared.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD,wBAAsB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAEnF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,YAAY,CAIzD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,kBAAkB,CAI9D"}

package/dist/ops/shared.js

@@ -0,0 +1,18 @@
+/** @pattern-js/mod-email — shared op helpers. */
+import { EMAIL_CONFIG_SERVICE, EMAIL_SERVICE } from "../well-known.js";
+export async function maybe(ctx, port) {
+    return ctx.input.has(port) ? (await ctx.input.value(port)) : undefined;
+}
+export function emailService(ctx) {
+    const svc = ctx.services[EMAIL_SERVICE];
+    if (!svc)
+        throw new Error("mod-email: email service missing — install @pattern-js/mod-email.");
+    return svc;
+}
+export function emailConfig(ctx) {
+    const svc = ctx.services[EMAIL_CONFIG_SERVICE];
+    if (!svc)
+        throw new Error("mod-email: email config missing — install @pattern-js/mod-email.");
+    return svc;
+}
+//# sourceMappingURL=shared.js.map

package/dist/ops/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/ops/shared.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAKjD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEvE,MAAM,CAAC,KAAK,UAAU,KAAK,CAAI,GAAc,EAAE,IAAY;IACzD,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAc;IACzC,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,aAAa,CAA6B,CAAC;IACpE,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAC/F,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAc;IACxC,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAmC,CAAC;IACjF,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IAC9F,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/service.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @pattern-js/mod-email — the contract surface.
+ *
+ * Driver mods (mod-email-resend, mod-email-smtp, …) register an
+ * `EmailDriverSpec` here in their `ready()` (all setups run before any ready,
+ * so the service always exists by then — mirroring how login methods register
+ * on mod-identity). `send` resolves the account by NAME at send time: sourced
+ * secrets (vault/env), markdown → html+text, attachments → bytes, then the
+ * driver. Secret VALUES never sit in workflow values or persisted config.
+ */
+import type { OpContext } from "@pattern-js/core";
+import { type EmailConfigService } from "./config.js";
+import type { EmailAccount, EmailDriverInfo, EmailDriverSpec, SendInput } from "./types.js";
+export interface SendResult {
+    messageId?: string;
+    provider: string;
+    account: string;
+}
+export interface TestResult {
+    ok: boolean;
+    detail?: string;
+    messageId?: string;
+}
+export interface EmailService {
+    /** Driver mods call this in their `ready()`; same-id re-registration replaces. */
+    registerDriver(spec: EmailDriverSpec): void;
+    drivers(): EmailDriverInfo[];
+    driver(id: string): EmailDriverSpec | undefined;
+    /** Resolve account + secrets + bodies + attachments, then delegate to the driver. */
+    send(input: SendInput, ctx: OpContext): Promise<SendResult>;
+    /** REAL test send of a canned message to `to`, from an (unsaved) draft account. */
+    testAccount(draft: EmailAccount, to: string, ctx: OpContext): Promise<TestResult>;
+}
+export declare class DefaultEmailService implements EmailService {
+    private readonly config;
+    private readonly registry;
+    constructor(config: EmailConfigService);
+    registerDriver(spec: EmailDriverSpec): void;
+    drivers(): EmailDriverInfo[];
+    driver(id: string): EmailDriverSpec | undefined;
+    send(input: SendInput, ctx: OpContext): Promise<SendResult>;
+    testAccount(draft: EmailAccount, to: string, ctx: OpContext): Promise<TestResult>;
+    private sendVia;
+    /** Resolve every sourced secret the account carries; enforce the driver's required fields. */
+    private resolveSecrets;
+    private resolveSourced;
+    /** to/cc/bcc listed, bodies final (explicit html/text win over markdown per part), attachments as bytes. */
+    private normalize;
+    private resolveAttachment;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,KAAK,EAEV,YAAY,EAEZ,eAAe,EACf,eAAe,EAGf,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAC5C,OAAO,IAAI,eAAe,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IAChD,qFAAqF;IACrF,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D,mFAAmF;IACnF,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACnF;AAED,qBAAa,mBAAoB,YAAW,YAAY;IAG1C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;gBAElC,MAAM,EAAE,kBAAkB;IAEvD,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAI3C,OAAO,IAAI,eAAe,EAAE;IAI5B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIzC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAS3D,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;YAqBzE,OAAO;IAcrB,8FAA8F;YAChF,cAAc;YAmBd,cAAc;IAW5B,4GAA4G;YAC9F,SAAS;YAmCT,iBAAiB;CAqBhC"}