@10x-media/form-builder 0.1.0-beta.2 → 0.1.0-beta.21

package/dist/actions/body/escapeHtml.d.ts

@@ -0,0 +1,6 @@
+//#region src/actions/body/escapeHtml.d.ts
+/** Escape `&`, `<`, `>`, `"`, `'` for safe embedding in HTML text or attribute values. */
+declare const escapeHtml: (value: string) => string;
+//#endregion
+export { escapeHtml };
+//# sourceMappingURL=escapeHtml.d.ts.map

package/dist/actions/body/escapeHtml.js

@@ -0,0 +1,14 @@
+//#region src/actions/body/escapeHtml.ts
+const REPLACEMENTS = {
+	"&": "&",
+	"<": "&lt;",
+	">": "&gt;",
+	"\"": "&quot;",
+	"'": "&#39;"
+};
+/** Escape `&`, `<`, `>`, `"`, `'` for safe embedding in HTML text or attribute values. */
+const escapeHtml = (value) => value.replace(/[&<>"']/g, (char) => REPLACEMENTS[char] ?? char);
+//#endregion
+export { escapeHtml };
+
+//# sourceMappingURL=escapeHtml.js.map

package/dist/actions/body/escapeHtml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeHtml.js","names":[],"sources":["../../../src/actions/body/escapeHtml.ts"],"sourcesContent":["const REPLACEMENTS: Record<string, string> = {\n\t'&': '&amp;',\n\t'<': '&lt;',\n\t'>': '&gt;',\n\t'\"': '&quot;',\n\t\"'\": '&#39;',\n}\n\n/** Escape `&`, `<`, `>`, `\"`, `'` for safe embedding in HTML text or attribute values. */\nexport const escapeHtml = (value: string): string =>\n\tvalue.replace(/[&<>\"']/g, (char) => REPLACEMENTS[char] ?? char)\n"],"mappings":";AAAA,MAAM,eAAuC;CAC5C,KAAK;CACL,KAAK;CACL,KAAK;CACL,MAAK;CACL,KAAK;AACN;;AAGA,MAAa,cAAc,UAC1B,MAAM,QAAQ,aAAa,SAAS,aAAa,SAAS,IAAI"}

package/dist/actions/body/serializeBody.d.ts

@@ -0,0 +1,55 @@
+import { SubmissionDescriptor, SubmissionValue } from "../../submissions/types.js";
+import { BodyConverter } from "./converters.js";
+import { PayloadRequest, RichTextField } from "payload";
+
+//#region src/actions/body/serializeBody.d.ts
+/** Minimal form identity threaded alongside a rendered body (e.g. per-tenant template lookups). */
+type SerializeBodyForm = {
+  id: number | string;
+  title?: string;
+};
+/** Submission data plus optional converter overrides available while serializing a body. */
+type BodyContext = {
+  values: SubmissionValue[];
+  descriptors: SubmissionDescriptor[];
+  converters?: Record<string, BodyConverter>;
+};
+/**
+ * Args a custom `richText.serialize` replacement receives per rendered body. Always populated by
+ * `makeRenderBody` (the action-body pipeline): `form` and `req` enable per-tenant template
+ * lookups or handing the body off to a renderer like react-email.
+ */
+type SerializeBodyArgs = {
+  body: unknown;
+  values: SubmissionValue[];
+  descriptors: SubmissionDescriptor[];
+  form: SerializeBodyForm;
+  req?: PayloadRequest;
+};
+/**
+ * Customizes how the plugin's rich text is authored and rendered. `converters` spread over the
+ * default Lexical node converters; `serialize` replaces the whole action-body pipeline (for
+ * non-HTML channels like chat or plain text, or to hand the body plus the submitted `form`/`req`
+ * off to a renderer like react-email). `editor` is the default Lexical/richText editor for every
+ * plugin-authored richText field: message content, consent statement, the response message, and
+ * the action body fields. `bodyEditor` overrides the action body fields specifically (emailTeam
+ * and confirmation), and `responseEditor` overrides the success `response` message field; both fall
+ * back to `editor` when absent.
+ */
+type RichTextBodyOption = {
+  converters?: Record<string, BodyConverter>;
+  serialize?: (args: SerializeBodyArgs) => Promise<string> | string;
+  editor?: RichTextField['editor'];
+  bodyEditor?: RichTextField['editor'];
+  responseEditor?: RichTextField['editor'];
+};
+/**
+ * Serialize an action's `body` config into HTML. A legacy string body is interpolated as-is
+ * (pre-richText behavior, no escaping); a Lexical state walks the converter registry; a Slate
+ * array uses the minimal legacy serializer; anything else yields `''`. Rendered text is
+ * HTML-escaped and supports `{{ name|fallback }}`, `{{*}}`, and `{{*:table}}` tokens.
+ */
+declare const serializeBody: (body: unknown, ctx: BodyContext) => string;
+//#endregion
+export { BodyContext, RichTextBodyOption, SerializeBodyArgs, serializeBody };
+//# sourceMappingURL=serializeBody.d.ts.map

package/dist/actions/body/serializeBody.js

@@ -0,0 +1,78 @@
+import { interpolate } from "../../recall/interpolate.js";
+import { escapeHtml } from "./escapeHtml.js";
+import { defaultBodyConverters } from "./converters.js";
+import { serializeSlate } from "./serializeSlate.js";
+import { renderAllValues, renderAllValuesTable } from "./wildcards.js";
+//#region src/actions/body/serializeBody.ts
+/** Recall resolver over submission values: field name to stringified value, `''` when absent. */
+const resolverFor = (values) => (name) => {
+	const entry = values.find((value) => value.field === name);
+	return entry == null ? "" : String(entry.value ?? "");
+};
+const renderFor = (ctx) => {
+	const resolve = resolverFor(ctx.values);
+	const htmlResolve = (name) => {
+		if (name === "*") return renderAllValues(ctx.values, ctx.descriptors);
+		if (name === "*:table") return renderAllValuesTable(ctx.values, ctx.descriptors);
+		return escapeHtml(resolve(name));
+	};
+	return {
+		text: (raw) => interpolate(escapeHtml(raw), htmlResolve),
+		interpolate: (raw) => interpolate(raw, resolve)
+	};
+};
+const serializeNodes = (nodes, converters, render) => nodes.map((node) => {
+	if (node == null || typeof node !== "object") return "";
+	const lexicalNode = node;
+	const children = Array.isArray(lexicalNode.children) ? serializeNodes(lexicalNode.children, converters, render) : "";
+	const converter = typeof lexicalNode.type === "string" ? converters[lexicalNode.type] : void 0;
+	return converter ? converter({
+		node: lexicalNode,
+		children,
+		render
+	}) : children;
+}).join("");
+const lexicalRootOf = (body) => {
+	if (body == null || typeof body !== "object" || Array.isArray(body)) return null;
+	const root = body.root;
+	return root != null && typeof root === "object" ? root : null;
+};
+/**
+* Serialize an action's `body` config into HTML. A legacy string body is interpolated as-is
+* (pre-richText behavior, no escaping); a Lexical state walks the converter registry; a Slate
+* array uses the minimal legacy serializer; anything else yields `''`. Rendered text is
+* HTML-escaped and supports `{{ name|fallback }}`, `{{*}}`, and `{{*:table}}` tokens.
+*/
+const serializeBody = (body, ctx) => {
+	if (typeof body === "string") return interpolate(body, resolverFor(ctx.values));
+	const render = renderFor(ctx);
+	if (Array.isArray(body)) return serializeSlate(body, render);
+	const root = lexicalRootOf(body);
+	if (root) {
+		const converters = {
+			...defaultBodyConverters,
+			...ctx.converters ?? {}
+		};
+		return serializeNodes(Array.isArray(root.children) ? root.children : [], converters, render);
+	}
+	return "";
+};
+/** Build the `renderBody` passed to actions, honoring a plugin-level `richText` customization. */
+const makeRenderBody = (args) => async (body) => {
+	if (args.richText?.serialize) return await args.richText.serialize({
+		body,
+		values: args.values,
+		descriptors: args.descriptors,
+		form: args.form,
+		req: args.req
+	});
+	return serializeBody(body, {
+		values: args.values,
+		descriptors: args.descriptors,
+		converters: args.richText?.converters
+	});
+};
+//#endregion
+export { makeRenderBody, resolverFor, serializeBody };
+
+//# sourceMappingURL=serializeBody.js.map

package/dist/actions/body/serializeBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializeBody.js","names":[],"sources":["../../../src/actions/body/serializeBody.ts"],"sourcesContent":["import type { PayloadRequest, RichTextField } from 'payload'\nimport { interpolate } from '../../recall/interpolate'\nimport type { SubmissionDescriptor, SubmissionValue } from '../../submissions/types'\nimport type { BodyConverter, BodyRender } from './converters'\nimport { defaultBodyConverters } from './converters'\nimport { escapeHtml } from './escapeHtml'\nimport { serializeSlate } from './serializeSlate'\nimport { renderAllValues, renderAllValuesTable } from './wildcards'\n\n/** Minimal form identity threaded alongside a rendered body (e.g. per-tenant template lookups). */\ntype SerializeBodyForm = { id: number | string; title?: string }\n\n/** Submission data plus optional converter overrides available while serializing a body. */\nexport type BodyContext = {\n\tvalues: SubmissionValue[]\n\tdescriptors: SubmissionDescriptor[]\n\tconverters?: Record<string, BodyConverter>\n}\n\n/**\n * Args a custom `richText.serialize` replacement receives per rendered body. Always populated by\n * `makeRenderBody` (the action-body pipeline): `form` and `req` enable per-tenant template\n * lookups or handing the body off to a renderer like react-email.\n */\nexport type SerializeBodyArgs = {\n\tbody: unknown\n\tvalues: SubmissionValue[]\n\tdescriptors: SubmissionDescriptor[]\n\tform: SerializeBodyForm\n\treq?: PayloadRequest\n}\n\n/**\n * Customizes how the plugin's rich text is authored and rendered. `converters` spread over the\n * default Lexical node converters; `serialize` replaces the whole action-body pipeline (for\n * non-HTML channels like chat or plain text, or to hand the body plus the submitted `form`/`req`\n * off to a renderer like react-email). `editor` is the default Lexical/richText editor for every\n * plugin-authored richText field: message content, consent statement, the response message, and\n * the action body fields. `bodyEditor` overrides the action body fields specifically (emailTeam\n * and confirmation), and `responseEditor` overrides the success `response` message field; both fall\n * back to `editor` when absent.\n */\nexport type RichTextBodyOption = {\n\tconverters?: Record<string, BodyConverter>\n\tserialize?: (args: SerializeBodyArgs) => Promise<string> | string\n\teditor?: RichTextField['editor']\n\tbodyEditor?: RichTextField['editor']\n\tresponseEditor?: RichTextField['editor']\n}\n\n/** Recall resolver over submission values: field name to stringified value, `''` when absent. */\nexport const resolverFor =\n\t(values: SubmissionValue[]) =>\n\t(name: string): string => {\n\t\tconst entry = values.find((value) => value.field === name)\n\t\treturn entry == null ? '' : String(entry.value ?? '')\n\t}\n\nconst renderFor = (ctx: BodyContext): BodyRender => {\n\tconst resolve = resolverFor(ctx.values)\n\tconst htmlResolve = (name: string): string => {\n\t\tif (name === '*') {\n\t\t\treturn renderAllValues(ctx.values, ctx.descriptors)\n\t\t}\n\t\tif (name === '*:table') {\n\t\t\treturn renderAllValuesTable(ctx.values, ctx.descriptors)\n\t\t}\n\t\treturn escapeHtml(resolve(name))\n\t}\n\treturn {\n\t\ttext: (raw) => interpolate(escapeHtml(raw), htmlResolve),\n\t\tinterpolate: (raw) => interpolate(raw, resolve),\n\t}\n}\n\nconst serializeNodes = (\n\tnodes: unknown[],\n\tconverters: Record<string, BodyConverter>,\n\trender: BodyRender\n): string =>\n\tnodes\n\t\t.map((node) => {\n\t\t\tif (node == null || typeof node !== 'object') {\n\t\t\t\treturn ''\n\t\t\t}\n\t\t\tconst lexicalNode = node as Record<string, unknown>\n\t\t\tconst children = Array.isArray(lexicalNode.children)\n\t\t\t\t? serializeNodes(lexicalNode.children, converters, render)\n\t\t\t\t: ''\n\t\t\tconst converter =\n\t\t\t\ttypeof lexicalNode.type === 'string' ? converters[lexicalNode.type] : undefined\n\t\t\treturn converter ? converter({ node: lexicalNode, children, render }) : children\n\t\t})\n\t\t.join('')\n\nconst lexicalRootOf = (body: unknown): Record<string, unknown> | null => {\n\tif (body == null || typeof body !== 'object' || Array.isArray(body)) {\n\t\treturn null\n\t}\n\tconst root = (body as { root?: unknown }).root\n\treturn root != null && typeof root === 'object' ? (root as Record<string, unknown>) : null\n}\n\n/**\n * Serialize an action's `body` config into HTML. A legacy string body is interpolated as-is\n * (pre-richText behavior, no escaping); a Lexical state walks the converter registry; a Slate\n * array uses the minimal legacy serializer; anything else yields `''`. Rendered text is\n * HTML-escaped and supports `{{ name|fallback }}`, `{{*}}`, and `{{*:table}}` tokens.\n */\nexport const serializeBody = (body: unknown, ctx: BodyContext): string => {\n\tif (typeof body === 'string') {\n\t\treturn interpolate(body, resolverFor(ctx.values))\n\t}\n\tconst render = renderFor(ctx)\n\tif (Array.isArray(body)) {\n\t\treturn serializeSlate(body, render)\n\t}\n\tconst root = lexicalRootOf(body)\n\tif (root) {\n\t\tconst converters = { ...defaultBodyConverters, ...(ctx.converters ?? {}) }\n\t\treturn serializeNodes(Array.isArray(root.children) ? root.children : [], converters, render)\n\t}\n\treturn ''\n}\n\n/** Build the `renderBody` passed to actions, honoring a plugin-level `richText` customization. */\nexport const makeRenderBody =\n\t(args: {\n\t\tvalues: SubmissionValue[]\n\t\tdescriptors: SubmissionDescriptor[]\n\t\tform: SerializeBodyForm\n\t\treq?: PayloadRequest\n\t\trichText?: RichTextBodyOption\n\t}) =>\n\tasync (body: unknown): Promise<string> => {\n\t\tif (args.richText?.serialize) {\n\t\t\treturn await args.richText.serialize({\n\t\t\t\tbody,\n\t\t\t\tvalues: args.values,\n\t\t\t\tdescriptors: args.descriptors,\n\t\t\t\tform: args.form,\n\t\t\t\treq: args.req,\n\t\t\t})\n\t\t}\n\t\treturn serializeBody(body, {\n\t\t\tvalues: args.values,\n\t\t\tdescriptors: args.descriptors,\n\t\t\tconverters: args.richText?.converters,\n\t\t})\n\t}\n"],"mappings":";;;;;;;AAmDA,MAAa,eACX,YACA,SAAyB;CACzB,MAAM,QAAQ,OAAO,MAAM,UAAU,MAAM,UAAU,IAAI;CACzD,OAAO,SAAS,OAAO,KAAK,OAAO,MAAM,SAAS,EAAE;AACrD;AAED,MAAM,aAAa,QAAiC;CACnD,MAAM,UAAU,YAAY,IAAI,MAAM;CACtC,MAAM,eAAe,SAAyB;EAC7C,IAAI,SAAS,KACZ,OAAO,gBAAgB,IAAI,QAAQ,IAAI,WAAW;EAEnD,IAAI,SAAS,WACZ,OAAO,qBAAqB,IAAI,QAAQ,IAAI,WAAW;EAExD,OAAO,WAAW,QAAQ,IAAI,CAAC;CAChC;CACA,OAAO;EACN,OAAO,QAAQ,YAAY,WAAW,GAAG,GAAG,WAAW;EACvD,cAAc,QAAQ,YAAY,KAAK,OAAO;CAC/C;AACD;AAEA,MAAM,kBACL,OACA,YACA,WAEA,MACE,KAAK,SAAS;CACd,IAAI,QAAQ,QAAQ,OAAO,SAAS,UACnC,OAAO;CAER,MAAM,cAAc;CACpB,MAAM,WAAW,MAAM,QAAQ,YAAY,QAAQ,IAChD,eAAe,YAAY,UAAU,YAAY,MAAM,IACvD;CACH,MAAM,YACL,OAAO,YAAY,SAAS,WAAW,WAAW,YAAY,QAAQ,KAAA;CACvE,OAAO,YAAY,UAAU;EAAE,MAAM;EAAa;EAAU;CAAO,CAAC,IAAI;AACzE,CAAC,EACA,KAAK,EAAE;AAEV,MAAM,iBAAiB,SAAkD;CACxE,IAAI,QAAQ,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,IAAI,GACjE,OAAO;CAER,MAAM,OAAQ,KAA4B;CAC1C,OAAO,QAAQ,QAAQ,OAAO,SAAS,WAAY,OAAmC;AACvF;;;;;;;AAQA,MAAa,iBAAiB,MAAe,QAA6B;CACzE,IAAI,OAAO,SAAS,UACnB,OAAO,YAAY,MAAM,YAAY,IAAI,MAAM,CAAC;CAEjD,MAAM,SAAS,UAAU,GAAG;CAC5B,IAAI,MAAM,QAAQ,IAAI,GACrB,OAAO,eAAe,MAAM,MAAM;CAEnC,MAAM,OAAO,cAAc,IAAI;CAC/B,IAAI,MAAM;EACT,MAAM,aAAa;GAAE,GAAG;GAAuB,GAAI,IAAI,cAAc,CAAC;EAAG;EACzE,OAAO,eAAe,MAAM,QAAQ,KAAK,QAAQ,IAAI,KAAK,WAAW,CAAC,GAAG,YAAY,MAAM;CAC5F;CACA,OAAO;AACR;;AAGA,MAAa,kBACX,SAOD,OAAO,SAAmC;CACzC,IAAI,KAAK,UAAU,WAClB,OAAO,MAAM,KAAK,SAAS,UAAU;EACpC;EACA,QAAQ,KAAK;EACb,aAAa,KAAK;EAClB,MAAM,KAAK;EACX,KAAK,KAAK;CACX,CAAC;CAEF,OAAO,cAAc,MAAM;EAC1B,QAAQ,KAAK;EACb,aAAa,KAAK;EAClB,YAAY,KAAK,UAAU;CAC5B,CAAC;AACF"}

package/dist/actions/body/serializeSlate.js

@@ -0,0 +1,31 @@
+import { escapeHtml } from "./escapeHtml.js";
+import { sanitizeUrl } from "./converters.js";
+//#region src/actions/body/serializeSlate.ts
+const leaf = (node, render) => {
+	let html = render.text(typeof node.text === "string" ? node.text : "");
+	if (node.code === true) html = `<code>${html}</code>`;
+	if (node.bold === true) html = `<strong>${html}</strong>`;
+	if (node.italic === true) html = `<em>${html}</em>`;
+	if (node.underline === true) html = `<u>${html}</u>`;
+	return html;
+};
+const serializeNode = (node, render) => {
+	if (node == null || typeof node !== "object") return "";
+	const slateNode = node;
+	if (typeof slateNode.text === "string") return leaf(slateNode, render);
+	const children = Array.isArray(slateNode.children) ? slateNode.children.map((child) => serializeNode(child, render)).join("") : "";
+	if (slateNode.type === "link") {
+		const raw = typeof slateNode.url === "string" ? slateNode.url : "";
+		return `<a href="${escapeHtml(sanitizeUrl(render.interpolate(raw)))}">${children}</a>`;
+	}
+	return `<p>${children}</p>`;
+};
+/**
+* Minimal legacy Slate serializer: paragraph-ish elements, bold/italic/underline/code marks, links.
+* Strikethrough is intentionally unsupported for legacy Slate bodies.
+*/
+const serializeSlate = (nodes, render) => nodes.map((node) => serializeNode(node, render)).join("");
+//#endregion
+export { serializeSlate };
+
+//# sourceMappingURL=serializeSlate.js.map

package/dist/actions/body/serializeSlate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializeSlate.js","names":[],"sources":["../../../src/actions/body/serializeSlate.ts"],"sourcesContent":["import type { BodyRender } from './converters'\nimport { sanitizeUrl } from './converters'\nimport { escapeHtml } from './escapeHtml'\n\ntype SlateNode = Record<string, unknown>\n\nconst leaf = (node: SlateNode, render: BodyRender): string => {\n\tlet html = render.text(typeof node.text === 'string' ? node.text : '')\n\tif (node.code === true) {\n\t\thtml = `<code>${html}</code>`\n\t}\n\tif (node.bold === true) {\n\t\thtml = `<strong>${html}</strong>`\n\t}\n\tif (node.italic === true) {\n\t\thtml = `<em>${html}</em>`\n\t}\n\tif (node.underline === true) {\n\t\thtml = `<u>${html}</u>`\n\t}\n\treturn html\n}\n\nconst serializeNode = (node: unknown, render: BodyRender): string => {\n\tif (node == null || typeof node !== 'object') {\n\t\treturn ''\n\t}\n\tconst slateNode = node as SlateNode\n\tif (typeof slateNode.text === 'string') {\n\t\treturn leaf(slateNode, render)\n\t}\n\tconst children = Array.isArray(slateNode.children)\n\t\t? slateNode.children.map((child) => serializeNode(child, render)).join('')\n\t\t: ''\n\tif (slateNode.type === 'link') {\n\t\tconst raw = typeof slateNode.url === 'string' ? slateNode.url : ''\n\t\tconst href = escapeHtml(sanitizeUrl(render.interpolate(raw)))\n\t\treturn `<a href=\"${href}\">${children}</a>`\n\t}\n\treturn `<p>${children}</p>`\n}\n\n/**\n * Minimal legacy Slate serializer: paragraph-ish elements, bold/italic/underline/code marks, links.\n * Strikethrough is intentionally unsupported for legacy Slate bodies.\n */\nexport const serializeSlate = (nodes: unknown[], render: BodyRender): string =>\n\tnodes.map((node) => serializeNode(node, render)).join('')\n"],"mappings":";;;AAMA,MAAM,QAAQ,MAAiB,WAA+B;CAC7D,IAAI,OAAO,OAAO,KAAK,OAAO,KAAK,SAAS,WAAW,KAAK,OAAO,EAAE;CACrE,IAAI,KAAK,SAAS,MACjB,OAAO,SAAS,KAAK;CAEtB,IAAI,KAAK,SAAS,MACjB,OAAO,WAAW,KAAK;CAExB,IAAI,KAAK,WAAW,MACnB,OAAO,OAAO,KAAK;CAEpB,IAAI,KAAK,cAAc,MACtB,OAAO,MAAM,KAAK;CAEnB,OAAO;AACR;AAEA,MAAM,iBAAiB,MAAe,WAA+B;CACpE,IAAI,QAAQ,QAAQ,OAAO,SAAS,UACnC,OAAO;CAER,MAAM,YAAY;CAClB,IAAI,OAAO,UAAU,SAAS,UAC7B,OAAO,KAAK,WAAW,MAAM;CAE9B,MAAM,WAAW,MAAM,QAAQ,UAAU,QAAQ,IAC9C,UAAU,SAAS,KAAK,UAAU,cAAc,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,IACvE;CACH,IAAI,UAAU,SAAS,QAAQ;EAC9B,MAAM,MAAM,OAAO,UAAU,QAAQ,WAAW,UAAU,MAAM;EAEhE,OAAO,YADM,WAAW,YAAY,OAAO,YAAY,GAAG,CAAC,CACrC,EAAE,IAAI,SAAS;CACtC;CACA,OAAO,MAAM,SAAS;AACvB;;;;;AAMA,MAAa,kBAAkB,OAAkB,WAChD,MAAM,KAAK,SAAS,cAAc,MAAM,MAAM,CAAC,EAAE,KAAK,EAAE"}

package/dist/actions/body/textOfBody.d.ts

@@ -0,0 +1,13 @@
+//#region src/actions/body/textOfBody.d.ts
+/**
+ * Plain-text content of a body (Lexical rich text, legacy Slate, or a legacy string): leaf text
+ * nodes concatenated in document order, block-level nodes (paragraph, heading, list item, quote)
+ * joined by single spaces, whitespace collapsed, so multi-block content flattens to a readable
+ * sentence. For accessible names and previews, where formatting and links collapse to their
+ * visible words. A plain string passes through untouched; unrecognized shapes yield `''`;
+ * never throws.
+ */
+declare const textOfBody: (body: unknown) => string;
+//#endregion
+export { textOfBody };
+//# sourceMappingURL=textOfBody.d.ts.map

package/dist/actions/body/textOfBody.js

@@ -0,0 +1,35 @@
+//#region src/actions/body/textOfBody.ts
+const isNode = (value) => value != null && typeof value === "object" && !Array.isArray(value);
+/** Children-bearing block-level node types whose text reads as a separate run. */
+const BLOCK_TYPES = new Set([
+	"paragraph",
+	"heading",
+	"listitem",
+	"quote"
+]);
+const textOfNode = (node) => {
+	if (!isNode(node)) return "";
+	if (typeof node.text === "string") return node.text;
+	const children = Array.isArray(node.children) ? node.children.map(textOfNode).join("") : "";
+	if (children !== "" && typeof node.type === "string" && BLOCK_TYPES.has(node.type)) return ` ${children} `;
+	return children;
+};
+/**
+* Plain-text content of a body (Lexical rich text, legacy Slate, or a legacy string): leaf text
+* nodes concatenated in document order, block-level nodes (paragraph, heading, list item, quote)
+* joined by single spaces, whitespace collapsed, so multi-block content flattens to a readable
+* sentence. For accessible names and previews, where formatting and links collapse to their
+* visible words. A plain string passes through untouched; unrecognized shapes yield `''`;
+* never throws.
+*/
+const textOfBody = (body) => {
+	if (typeof body === "string") return body;
+	const root = isNode(body) ? body.root : void 0;
+	const nodes = Array.isArray(body) ? body : isNode(root) && Array.isArray(root.children) ? root.children : null;
+	if (!nodes) return "";
+	return nodes.map(textOfNode).join("").replace(/\s+/g, " ").trim();
+};
+//#endregion
+export { textOfBody };
+
+//# sourceMappingURL=textOfBody.js.map

package/dist/actions/body/textOfBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textOfBody.js","names":[],"sources":["../../../src/actions/body/textOfBody.ts"],"sourcesContent":["type BodyNode = Record<string, unknown>\n\nconst isNode = (value: unknown): value is BodyNode =>\n\tvalue != null && typeof value === 'object' && !Array.isArray(value)\n\n/** Children-bearing block-level node types whose text reads as a separate run. */\nconst BLOCK_TYPES = new Set(['paragraph', 'heading', 'listitem', 'quote'])\n\nconst textOfNode = (node: unknown): string => {\n\tif (!isNode(node)) {\n\t\treturn ''\n\t}\n\tif (typeof node.text === 'string') {\n\t\treturn node.text\n\t}\n\tconst children = Array.isArray(node.children) ? node.children.map(textOfNode).join('') : ''\n\tif (children !== '' && typeof node.type === 'string' && BLOCK_TYPES.has(node.type)) {\n\t\treturn ` ${children} `\n\t}\n\treturn children\n}\n\n/**\n * Plain-text content of a body (Lexical rich text, legacy Slate, or a legacy string): leaf text\n * nodes concatenated in document order, block-level nodes (paragraph, heading, list item, quote)\n * joined by single spaces, whitespace collapsed, so multi-block content flattens to a readable\n * sentence. For accessible names and previews, where formatting and links collapse to their\n * visible words. A plain string passes through untouched; unrecognized shapes yield `''`;\n * never throws.\n */\nexport const textOfBody = (body: unknown): string => {\n\tif (typeof body === 'string') {\n\t\treturn body\n\t}\n\tconst root = isNode(body) ? body.root : undefined\n\tconst nodes = Array.isArray(body)\n\t\t? body\n\t\t: isNode(root) && Array.isArray(root.children)\n\t\t\t? root.children\n\t\t\t: null\n\tif (!nodes) {\n\t\treturn ''\n\t}\n\treturn nodes.map(textOfNode).join('').replace(/\\s+/g, ' ').trim()\n}\n"],"mappings":";AAEA,MAAM,UAAU,UACf,SAAS,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;;AAGnE,MAAM,cAAc,IAAI,IAAI;CAAC;CAAa;CAAW;CAAY;AAAO,CAAC;AAEzE,MAAM,cAAc,SAA0B;CAC7C,IAAI,CAAC,OAAO,IAAI,GACf,OAAO;CAER,IAAI,OAAO,KAAK,SAAS,UACxB,OAAO,KAAK;CAEb,MAAM,WAAW,MAAM,QAAQ,KAAK,QAAQ,IAAI,KAAK,SAAS,IAAI,UAAU,EAAE,KAAK,EAAE,IAAI;CACzF,IAAI,aAAa,MAAM,OAAO,KAAK,SAAS,YAAY,YAAY,IAAI,KAAK,IAAI,GAChF,OAAO,IAAI,SAAS;CAErB,OAAO;AACR;;;;;;;;;AAUA,MAAa,cAAc,SAA0B;CACpD,IAAI,OAAO,SAAS,UACnB,OAAO;CAER,MAAM,OAAO,OAAO,IAAI,IAAI,KAAK,OAAO,KAAA;CACxC,MAAM,QAAQ,MAAM,QAAQ,IAAI,IAC7B,OACA,OAAO,IAAI,KAAK,MAAM,QAAQ,KAAK,QAAQ,IAC1C,KAAK,WACL;CACJ,IAAI,CAAC,OACJ,OAAO;CAER,OAAO,MAAM,IAAI,UAAU,EAAE,KAAK,EAAE,EAAE,QAAQ,QAAQ,GAAG,EAAE,KAAK;AACjE"}

package/dist/actions/body/wildcards.d.ts

@@ -0,0 +1,10 @@
+import { SubmissionDescriptor, SubmissionValue } from "../../submissions/types.js";
+
+//#region src/actions/body/wildcards.d.ts
+/** All answers as HTML-escaped `Label: value` lines joined with `<br />`. */
+declare const renderAllValues: (values: SubmissionValue[], descriptors: SubmissionDescriptor[]) => string;
+/** All answers as a simple HTML-escaped two-column table. */
+declare const renderAllValuesTable: (values: SubmissionValue[], descriptors: SubmissionDescriptor[]) => string;
+//#endregion
+export { renderAllValues, renderAllValuesTable };
+//# sourceMappingURL=wildcards.d.ts.map

package/dist/actions/body/wildcards.js

@@ -0,0 +1,33 @@
+import { escapeHtml } from "./escapeHtml.js";
+//#region src/actions/body/wildcards.ts
+const displayValue = (value, descriptor) => {
+	if (value == null) return "";
+	if (Array.isArray(value)) return value.map((entry) => displayValue(entry, descriptor)).join(", ");
+	const raw = typeof value === "object" ? JSON.stringify(value) : String(value);
+	return descriptor?.optionLabels?.[raw] ?? raw;
+};
+/**
+* Descriptors are the submit-time snapshot of real form fields, so when present they gate which
+* values render (internal keys like the honeypot never get a descriptor). Legacy rows without
+* descriptors fall back to rendering every value under its field name.
+*/
+const rowsOf = (values, descriptors) => {
+	const byField = new Map(descriptors.map((descriptor) => [descriptor.field, descriptor]));
+	return (byField.size > 0 ? values.filter((value) => byField.has(value.field)) : values).map((entry) => {
+		const descriptor = byField.get(entry.field);
+		return {
+			label: descriptor?.label ?? entry.field,
+			value: displayValue(entry.value, descriptor)
+		};
+	});
+};
+/** All answers as HTML-escaped `Label: value` lines joined with `<br />`. */
+const renderAllValues = (values, descriptors) => rowsOf(values, descriptors).map((row) => `${escapeHtml(row.label)}: ${escapeHtml(row.value)}`).join("<br />");
+/** All answers as a simple HTML-escaped two-column table. */
+const renderAllValuesTable = (values, descriptors) => {
+	return `<table><tbody>${rowsOf(values, descriptors).map((row) => `<tr><td>${escapeHtml(row.label)}</td><td>${escapeHtml(row.value)}</td></tr>`).join("")}</tbody></table>`;
+};
+//#endregion
+export { renderAllValues, renderAllValuesTable };
+
+//# sourceMappingURL=wildcards.js.map

package/dist/actions/body/wildcards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wildcards.js","names":[],"sources":["../../../src/actions/body/wildcards.ts"],"sourcesContent":["import type { SubmissionDescriptor, SubmissionValue } from '../../submissions/types'\nimport { escapeHtml } from './escapeHtml'\n\ntype Row = { label: string; value: string }\n\nconst displayValue = (value: unknown, descriptor?: SubmissionDescriptor): string => {\n\tif (value == null) {\n\t\treturn ''\n\t}\n\tif (Array.isArray(value)) {\n\t\treturn value.map((entry) => displayValue(entry, descriptor)).join(', ')\n\t}\n\tconst raw = typeof value === 'object' ? JSON.stringify(value) : String(value)\n\treturn descriptor?.optionLabels?.[raw] ?? raw\n}\n\n/**\n * Descriptors are the submit-time snapshot of real form fields, so when present they gate which\n * values render (internal keys like the honeypot never get a descriptor). Legacy rows without\n * descriptors fall back to rendering every value under its field name.\n */\nconst rowsOf = (values: SubmissionValue[], descriptors: SubmissionDescriptor[]): Row[] => {\n\tconst byField = new Map(descriptors.map((descriptor) => [descriptor.field, descriptor]))\n\tconst included = byField.size > 0 ? values.filter((value) => byField.has(value.field)) : values\n\treturn included.map((entry) => {\n\t\tconst descriptor = byField.get(entry.field)\n\t\treturn { label: descriptor?.label ?? entry.field, value: displayValue(entry.value, descriptor) }\n\t})\n}\n\n/** All answers as HTML-escaped `Label: value` lines joined with `<br />`. */\nexport const renderAllValues = (\n\tvalues: SubmissionValue[],\n\tdescriptors: SubmissionDescriptor[]\n): string =>\n\trowsOf(values, descriptors)\n\t\t.map((row) => `${escapeHtml(row.label)}: ${escapeHtml(row.value)}`)\n\t\t.join('<br />')\n\n/** All answers as a simple HTML-escaped two-column table. */\nexport const renderAllValuesTable = (\n\tvalues: SubmissionValue[],\n\tdescriptors: SubmissionDescriptor[]\n): string => {\n\tconst rows = rowsOf(values, descriptors)\n\t\t.map((row) => `<tr><td>${escapeHtml(row.label)}</td><td>${escapeHtml(row.value)}</td></tr>`)\n\t\t.join('')\n\treturn `<table><tbody>${rows}</tbody></table>`\n}\n"],"mappings":";;AAKA,MAAM,gBAAgB,OAAgB,eAA8C;CACnF,IAAI,SAAS,MACZ,OAAO;CAER,IAAI,MAAM,QAAQ,KAAK,GACtB,OAAO,MAAM,KAAK,UAAU,aAAa,OAAO,UAAU,CAAC,EAAE,KAAK,IAAI;CAEvE,MAAM,MAAM,OAAO,UAAU,WAAW,KAAK,UAAU,KAAK,IAAI,OAAO,KAAK;CAC5E,OAAO,YAAY,eAAe,QAAQ;AAC3C;;;;;;AAOA,MAAM,UAAU,QAA2B,gBAA+C;CACzF,MAAM,UAAU,IAAI,IAAI,YAAY,KAAK,eAAe,CAAC,WAAW,OAAO,UAAU,CAAC,CAAC;CAEvF,QADiB,QAAQ,OAAO,IAAI,OAAO,QAAQ,UAAU,QAAQ,IAAI,MAAM,KAAK,CAAC,IAAI,QACzE,KAAK,UAAU;EAC9B,MAAM,aAAa,QAAQ,IAAI,MAAM,KAAK;EAC1C,OAAO;GAAE,OAAO,YAAY,SAAS,MAAM;GAAO,OAAO,aAAa,MAAM,OAAO,UAAU;EAAE;CAChG,CAAC;AACF;;AAGA,MAAa,mBACZ,QACA,gBAEA,OAAO,QAAQ,WAAW,EACxB,KAAK,QAAQ,GAAG,WAAW,IAAI,KAAK,EAAE,IAAI,WAAW,IAAI,KAAK,GAAG,EACjE,KAAK,QAAQ;;AAGhB,MAAa,wBACZ,QACA,gBACY;CAIZ,OAAO,iBAHM,OAAO,QAAQ,WAAW,EACrC,KAAK,QAAQ,WAAW,WAAW,IAAI,KAAK,EAAE,WAAW,WAAW,IAAI,KAAK,EAAE,WAAW,EAC1F,KAAK,EACoB,EAAE;AAC9B"}

package/dist/actions/buildActionBlocks.js

@@ -1,16 +1,19 @@
-import { labelFor } from "../translations/server.js";
+import { resolveDefinitionLabel } from "../translations/server.js";
 //#region src/actions/buildActionBlocks.ts
 /** One authoring block per registered action type: the action's own config fields. */
 const buildActionBlocks = (registry) => {
 	const blocks = [];
-	for (const definition of registry.values()) blocks.push({
-		slug: definition.type,
-		labels: {
-			singular: labelFor(definition.label),
-			plural: labelFor(definition.label)
-		},
-		fields: definition.config ?? []
-	});
+	for (const definition of registry.values()) {
+		const label = resolveDefinitionLabel(definition.label);
+		blocks.push({
+			slug: definition.type,
+			labels: {
+				singular: label,
+				plural: label
+			},
+			fields: definition.config ?? []
+		});
+	}
 	return blocks;
 };
 //#endregion

package/dist/actions/buildActionBlocks.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildActionBlocks.js","names":[],"sources":["../../src/actions/buildActionBlocks.ts"],"sourcesContent":["import type { Block } from 'payload'\nimport { labelFor } from '../translations/server'\nimport type { ActionRegistry } from './registry'\n\n/** One authoring block per registered action type: the action's own config fields. */\nexport const buildActionBlocks = (registry: ActionRegistry): Block[] => {\n\tconst blocks: Block[] = []\n\tfor (const definition of registry.values()) {\n\t\tblocks.push({\n\t\t\tslug: definition.type,\n\t\t\tlabels: { singular: labelFor(definition.label), plural: labelFor(definition.label) },\n\t\t\tfields: definition.config ?? [],\n\t\t})\n\t}\n\treturn blocks\n}\n"],"mappings":";;;AAKA,MAAa,qBAAqB,aAAsC;CACvE,MAAM,SAAkB,CAAC;CACzB,KAAK,MAAM,cAAc,SAAS,OAAO,GACxC,OAAO,KAAK;EACX,MAAM,WAAW;EACjB,QAAQ;GAAE,UAAU,SAAS,WAAW,KAAK;GAAG,QAAQ,SAAS,WAAW,KAAK;EAAE;EACnF,QAAQ,WAAW,UAAU,CAAC;CAC/B,CAAC;CAEF,OAAO;AACR"}
+{"version":3,"file":"buildActionBlocks.js","names":[],"sources":["../../src/actions/buildActionBlocks.ts"],"sourcesContent":["import type { Block } from 'payload'\nimport { resolveDefinitionLabel } from '../translations/server'\nimport type { ActionRegistry } from './registry'\n\n/** One authoring block per registered action type: the action's own config fields. */\nexport const buildActionBlocks = (registry: ActionRegistry): Block[] => {\n\tconst blocks: Block[] = []\n\tfor (const definition of registry.values()) {\n\t\tconst label = resolveDefinitionLabel(definition.label)\n\t\tblocks.push({\n\t\t\tslug: definition.type,\n\t\t\tlabels: { singular: label, plural: label },\n\t\t\tfields: definition.config ?? [],\n\t\t})\n\t}\n\treturn blocks\n}\n"],"mappings":";;;AAKA,MAAa,qBAAqB,aAAsC;CACvE,MAAM,SAAkB,CAAC;CACzB,KAAK,MAAM,cAAc,SAAS,OAAO,GAAG;EAC3C,MAAM,QAAQ,uBAAuB,WAAW,KAAK;EACrD,OAAO,KAAK;GACX,MAAM,WAAW;GACjB,QAAQ;IAAE,UAAU;IAAO,QAAQ;GAAM;GACzC,QAAQ,WAAW,UAAU,CAAC;EAC/B,CAAC;CACF;CACA,OAAO;AACR"}

package/dist/actions/builtin/confirmation.js

@@ -1,49 +1,53 @@
-import { interpolate } from "../../recall/interpolate.js";
+import { fieldNamesOfType } from "../../fields/fieldNamesOfType.js";
 import { keys } from "../../translations/keys.js";
-import { labelFor } from "../../translations/server.js";
-import { defineAction } from "../defineAction.js";
+import { asTranslate, labelFor } from "../../translations/server.js";
+import { firstAddress } from "../emailRecipients.js";
+import { buildEmailAction } from "./emailAction.js";
 //#region src/actions/builtin/confirmation.ts
-const confirmation = defineAction({
-	type: "confirmation",
-	label: keys.actionConfirmation,
-	config: [
-		{
-			name: "toField",
-			type: "text",
-			label: labelFor(keys.actionConfigToField)
+const TO_FIELD_REF = "@10x-media/form-builder/client#FieldNameSelect";
+/**
+* Validates the confirmation action's `toField`: unset is fine, otherwise it must name an
+* existing `email`-type field on the form. Exported for unit testing.
+*/
+const validateToField = (value, { data, req }) => {
+	if (typeof value !== "string" || value.length === 0) return true;
+	return fieldNamesOfType(data && typeof data === "object" ? data.fields : void 0, ["email"]).includes(value) ? true : asTranslate(req.t)(keys.validationEmailFieldUnknown);
+};
+/**
+* The `confirmation` action: its target is `toField`, naming the form's own email field the
+* confirmation is sent to (a `FieldNameSelect`, not a recipient list). The resolved address is
+* sanitized to a single one (dropping CR/LF header injection and any smuggled extra addresses); an
+* unset field or an unresolvable value is a silent skip. Everything else (from/cc/bcc/replyTo,
+* subject, body, localization) is the shared email-action skeleton.
+*/
+const buildConfirmation = (options) => {
+	const toField = {
+		name: "toField",
+		type: "text",
+		label: labelFor(keys.actionConfigToField),
+		admin: {
+			width: "50%",
+			components: { Field: {
+				path: TO_FIELD_REF,
+				clientProps: {
+					types: ["email"],
+					descriptionKey: keys.actionConfigToFieldDescription
+				}
+			} }
 		},
-		{
-			name: "subject",
-			type: "text",
-			label: labelFor(keys.actionConfigSubject)
-		},
-		{
-			name: "body",
-			type: "textarea",
-			label: labelFor(keys.actionConfigBody)
-		}
-	],
-	run: async (args) => {
-		const { config, values, payload } = args;
-		if (!config.toField) return;
-		const entry = values.find((v) => v.field === config.toField);
-		const to = entry == null ? "" : String(entry.value ?? "");
-		if (!to) return;
-		if (typeof payload.sendEmail !== "function") throw new Error("confirmation: no email adapter configured");
-		const resolve = (name) => {
-			const found = values.find((v) => v.field === name);
-			return found == null ? "" : String(found.value ?? "");
-		};
-		const subject = interpolate(config.subject ?? "", resolve);
-		const html = interpolate(config.body ?? "", resolve);
-		await payload.sendEmail({
-			to,
-			subject,
-			html
-		});
-	}
-});
+		validate: validateToField
+	};
+	return buildEmailAction(options, {
+		type: "confirmation",
+		label: keys.actionConfirmation,
+		target: () => toField,
+		resolveTo: ({ config, resolve }) => config.toField ? firstAddress(resolve(config.toField)) : "",
+		hasTarget: (config) => Boolean(config.toField),
+		onMissingTo: "skip"
+	});
+};
+buildConfirmation({ localize: true });
 //#endregion
-export { confirmation };
+export { buildConfirmation };
 
 //# sourceMappingURL=confirmation.js.map

package/dist/actions/builtin/confirmation.js.map

@@ -1 +1 @@
-{"version":3,"file":"confirmation.js","names":[],"sources":["../../../src/actions/builtin/confirmation.ts"],"sourcesContent":["import { interpolate } from '../../recall/interpolate'\nimport { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { defineAction } from '../defineAction'\n\ntype ConfirmationConfig = { toField?: string; subject?: string; body?: string }\n\nexport const confirmation = defineAction<ConfirmationConfig>({\n\ttype: 'confirmation',\n\tlabel: keys.actionConfirmation,\n\tconfig: [\n\t\t{ name: 'toField', type: 'text', label: labelFor(keys.actionConfigToField) },\n\t\t{ name: 'subject', type: 'text', label: labelFor(keys.actionConfigSubject) },\n\t\t{ name: 'body', type: 'textarea', label: labelFor(keys.actionConfigBody) },\n\t],\n\trun: async (args) => {\n\t\tconst { config, values, payload } = args\n\n\t\tif (!config.toField) {\n\t\t\treturn\n\t\t}\n\n\t\tconst entry = values.find((v) => v.field === config.toField)\n\t\tconst to = entry == null ? '' : String(entry.value ?? '')\n\n\t\tif (!to) {\n\t\t\treturn\n\t\t}\n\n\t\tif (typeof payload.sendEmail !== 'function') {\n\t\t\tthrow new Error('confirmation: no email adapter configured')\n\t\t}\n\n\t\tconst resolve = (name: string) => {\n\t\t\tconst found = values.find((v) => v.field === name)\n\t\t\treturn found == null ? '' : String(found.value ?? '')\n\t\t}\n\n\t\tconst subject = interpolate(config.subject ?? '', resolve)\n\t\tconst html = interpolate(config.body ?? '', resolve)\n\n\t\tawait payload.sendEmail({ to, subject, html })\n\t},\n})\n"],"mappings":";;;;;AAOA,MAAa,eAAe,aAAiC;CAC5D,MAAM;CACN,OAAO,KAAK;CACZ,QAAQ;EACP;GAAE,MAAM;GAAW,MAAM;GAAQ,OAAO,SAAS,KAAK,mBAAmB;EAAE;EAC3E;GAAE,MAAM;GAAW,MAAM;GAAQ,OAAO,SAAS,KAAK,mBAAmB;EAAE;EAC3E;GAAE,MAAM;GAAQ,MAAM;GAAY,OAAO,SAAS,KAAK,gBAAgB;EAAE;CAC1E;CACA,KAAK,OAAO,SAAS;EACpB,MAAM,EAAE,QAAQ,QAAQ,YAAY;EAEpC,IAAI,CAAC,OAAO,SACX;EAGD,MAAM,QAAQ,OAAO,MAAM,MAAM,EAAE,UAAU,OAAO,OAAO;EAC3D,MAAM,KAAK,SAAS,OAAO,KAAK,OAAO,MAAM,SAAS,EAAE;EAExD,IAAI,CAAC,IACJ;EAGD,IAAI,OAAO,QAAQ,cAAc,YAChC,MAAM,IAAI,MAAM,2CAA2C;EAG5D,MAAM,WAAW,SAAiB;GACjC,MAAM,QAAQ,OAAO,MAAM,MAAM,EAAE,UAAU,IAAI;GACjD,OAAO,SAAS,OAAO,KAAK,OAAO,MAAM,SAAS,EAAE;EACrD;EAEA,MAAM,UAAU,YAAY,OAAO,WAAW,IAAI,OAAO;EACzD,MAAM,OAAO,YAAY,OAAO,QAAQ,IAAI,OAAO;EAEnD,MAAM,QAAQ,UAAU;GAAE;GAAI;GAAS;EAAK,CAAC;CAC9C;AACD,CAAC"}
+{"version":3,"file":"confirmation.js","names":[],"sources":["../../../src/actions/builtin/confirmation.ts"],"sourcesContent":["import type { Field, PayloadRequest } from 'payload'\nimport { fieldNamesOfType } from '../../fields/fieldNamesOfType'\nimport { keys } from '../../translations/keys'\nimport { asTranslate, labelFor } from '../../translations/server'\nimport { firstAddress } from '../emailRecipients'\nimport { buildEmailAction, type EmailActionConfig, type EmailActionOptions } from './emailAction'\n\ntype ConfirmationConfig = EmailActionConfig & { toField?: string }\n\nconst TO_FIELD_REF = '@10x-media/form-builder/client#FieldNameSelect'\n\n/**\n * Validates the confirmation action's `toField`: unset is fine, otherwise it must name an\n * existing `email`-type field on the form. Exported for unit testing.\n */\nexport const validateToField = (\n\tvalue: unknown,\n\t{ data, req }: { data?: unknown; req: PayloadRequest }\n): string | true => {\n\tif (typeof value !== 'string' || value.length === 0) {\n\t\treturn true\n\t}\n\tconst fields =\n\t\tdata && typeof data === 'object' ? (data as Record<string, unknown>).fields : undefined\n\treturn fieldNamesOfType(fields, ['email']).includes(value)\n\t\t? true\n\t\t: asTranslate(req.t)(keys.validationEmailFieldUnknown)\n}\n\n/**\n * The `confirmation` action: its target is `toField`, naming the form's own email field the\n * confirmation is sent to (a `FieldNameSelect`, not a recipient list). The resolved address is\n * sanitized to a single one (dropping CR/LF header injection and any smuggled extra addresses); an\n * unset field or an unresolvable value is a silent skip. Everything else (from/cc/bcc/replyTo,\n * subject, body, localization) is the shared email-action skeleton.\n */\nexport const buildConfirmation = (options: EmailActionOptions) => {\n\tconst toField: Field = {\n\t\tname: 'toField',\n\t\ttype: 'text',\n\t\tlabel: labelFor(keys.actionConfigToField),\n\t\tadmin: {\n\t\t\twidth: '50%',\n\t\t\tcomponents: {\n\t\t\t\tField: {\n\t\t\t\t\tpath: TO_FIELD_REF,\n\t\t\t\t\tclientProps: { types: ['email'], descriptionKey: keys.actionConfigToFieldDescription },\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\tvalidate: validateToField,\n\t}\n\treturn buildEmailAction<ConfirmationConfig>(options, {\n\t\ttype: 'confirmation',\n\t\tlabel: keys.actionConfirmation,\n\t\ttarget: () => toField,\n\t\tresolveTo: ({ config, resolve }) =>\n\t\t\tconfig.toField ? firstAddress(resolve(config.toField)) : '',\n\t\thasTarget: (config) => Boolean(config.toField),\n\t\tonMissingTo: 'skip',\n\t})\n}\n\nexport const confirmation = buildConfirmation({ localize: true })\n"],"mappings":";;;;;;AASA,MAAM,eAAe;;;;;AAMrB,MAAa,mBACZ,OACA,EAAE,MAAM,UACW;CACnB,IAAI,OAAO,UAAU,YAAY,MAAM,WAAW,GACjD,OAAO;CAIR,OAAO,iBADN,QAAQ,OAAO,SAAS,WAAY,KAAiC,SAAS,KAAA,GAC/C,CAAC,OAAO,CAAC,EAAE,SAAS,KAAK,IACtD,OACA,YAAY,IAAI,CAAC,EAAE,KAAK,2BAA2B;AACvD;;;;;;;;AASA,MAAa,qBAAqB,YAAgC;CACjE,MAAM,UAAiB;EACtB,MAAM;EACN,MAAM;EACN,OAAO,SAAS,KAAK,mBAAmB;EACxC,OAAO;GACN,OAAO;GACP,YAAY,EACX,OAAO;IACN,MAAM;IACN,aAAa;KAAE,OAAO,CAAC,OAAO;KAAG,gBAAgB,KAAK;IAA+B;GACtF,EACD;EACD;EACA,UAAU;CACX;CACA,OAAO,iBAAqC,SAAS;EACpD,MAAM;EACN,OAAO,KAAK;EACZ,cAAc;EACd,YAAY,EAAE,QAAQ,cACrB,OAAO,UAAU,aAAa,QAAQ,OAAO,OAAO,CAAC,IAAI;EAC1D,YAAY,WAAW,QAAQ,OAAO,OAAO;EAC7C,aAAa;CACd,CAAC;AACF;AAE4B,kBAAkB,EAAE,UAAU,KAAK,CAAC"}

package/dist/actions/builtin/emailAction.d.ts

@@ -0,0 +1,20 @@
+import { RecipientSourceRegistry } from "../recipientSources.js";
+import { FromAddressSourceRegistry, FromAddressesResolver } from "../fromAddresses.js";
+import { DepartmentEmailsResolver } from "../../email/departments.js";
+import { RecipientsConfig } from "../emailRecipients.js";
+import { Field, RichTextField } from "payload";
+
+//#region src/actions/builtin/emailAction.d.ts
+/** The plugin-derived options every built-in email action is built from (was five positional args). */
+type EmailActionOptions = {
+  localize: boolean;
+  editor?: RichTextField['editor'];
+  fromAddresses?: FromAddressesResolver; /** Send-time-resolved senders offered in the from select (plugin option `email.fromSources`). */
+  fromSources?: FromAddressSourceRegistry;
+  departments?: DepartmentEmailsResolver;
+  recipients?: RecipientsConfig; /** Server-resolved recipient sources offered in every recipient list (plugin option `email.recipientSources`). */
+  recipientSources?: RecipientSourceRegistry;
+};
+//#endregion
+export { EmailActionOptions };
+//# sourceMappingURL=emailAction.d.ts.map

package/dist/actions/builtin/emailAction.js

@@ -0,0 +1,120 @@
+import { keys } from "../../translations/keys.js";
+import { labelFor } from "../../translations/server.js";
+import { localizedIf } from "../../fields/localizedIf.js";
+import { interpolate } from "../../recall/interpolate.js";
+import { buildRecipientField, resolveRecipientEntries } from "../emailRecipients.js";
+import { resolverFor } from "../body/serializeBody.js";
+import { defineAction } from "../defineAction.js";
+import { buildFromField, resolveSendFrom } from "../fromAddresses.js";
+import { sourcesByValue } from "../recipientSources.js";
+//#region src/actions/builtin/emailAction.ts
+/**
+* The shared skeleton of the built-in email actions (`emailTeam`, `confirmation`): an identical
+* config (a first row pairing the action's target with `replyTo`, an optional `from` select, a
+* cc/bcc row, a subject, and a rich text body, content and recipient fields carrying `localized`
+* when `localize`) and an identical send (interpolate the subject, render the body, resolve
+* cc/bcc/replyTo, and hand a single comma-joined string per list to `payload.sendEmail`). Only the
+* primary `to` target and its missing-value behavior differ, threaded through `spec`.
+*/
+const buildEmailAction = (options, spec) => {
+	const { localize, editor, fromAddresses, fromSources, departments, recipients, recipientSources } = options;
+	const fromSourcesByValue = sourcesByValue(fromSources);
+	const endpoint = departments ? "departments" : void 0;
+	const recip = (name, labelKey) => buildRecipientField(name, labelKey, localize, {
+		endpoint,
+		recipients,
+		width: "50%",
+		departments,
+		sources: recipientSources
+	});
+	return defineAction({
+		type: spec.type,
+		label: spec.label,
+		config: [
+			{
+				type: "row",
+				fields: [spec.target(recip), recip("replyTo", keys.actionConfigReplyTo)]
+			},
+			...fromAddresses || fromSources ? [buildFromField(fromAddresses, fromSources)] : [],
+			{
+				type: "row",
+				fields: [recip("cc", keys.actionConfigCc), recip("bcc", keys.actionConfigBcc)]
+			},
+			{
+				name: "subject",
+				type: "text",
+				label: labelFor(keys.actionConfigSubject),
+				...localizedIf(localize)
+			},
+			{
+				name: "body",
+				type: "richText",
+				label: labelFor(keys.actionConfigBody),
+				admin: { description: labelFor(keys.actionConfigBodyDescription) },
+				...localizedIf(localize),
+				...editor ? { editor } : {}
+			}
+		],
+		run: async (args) => {
+			const { config, values } = args;
+			const resolve = resolverFor(values);
+			const sources = sourcesByValue(recipientSources);
+			const sourceArgs = {
+				context: args.context,
+				values,
+				descriptors: args.descriptors,
+				form: args.form,
+				submissionId: args.submissionId,
+				payload: args.payload,
+				req: args.req,
+				locale: args.locale
+			};
+			const to = await spec.resolveTo({
+				config,
+				resolve,
+				sources,
+				sourceArgs
+			});
+			if (!to) {
+				if (!spec.hasTarget(config) && spec.onMissingTo === "throw") throw new Error(`${spec.type}: missing "to" address`);
+				return;
+			}
+			if (typeof args.payload.sendEmail !== "function") throw new Error(`${spec.type}: no email adapter configured`);
+			const subject = interpolate(config.subject ?? "", resolve);
+			const html = await args.renderBody(config.body);
+			const cc = (await resolveRecipientEntries(config.cc, {
+				resolve,
+				sources,
+				sourceArgs
+			})).join(", ");
+			const bcc = (await resolveRecipientEntries(config.bcc, {
+				resolve,
+				sources,
+				sourceArgs
+			})).join(", ");
+			const replyTo = (await resolveRecipientEntries(config.replyTo, {
+				resolve,
+				sources,
+				sourceArgs
+			})).join(", ");
+			const from = await resolveSendFrom({
+				configured: config.from,
+				sources: fromSourcesByValue,
+				sourceArgs
+			});
+			await args.payload.sendEmail({
+				to,
+				subject,
+				html,
+				...from ? { from } : {},
+				...cc ? { cc } : {},
+				...bcc ? { bcc } : {},
+				...replyTo ? { replyTo } : {}
+			});
+		}
+	});
+};
+//#endregion
+export { buildEmailAction };
+
+//# sourceMappingURL=emailAction.js.map