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

package/dist/actions/buildActionBlocks.js

@@ -0,0 +1,19 @@
+import { labelFor } 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 ?? []
+	});
+	return blocks;
+};
+//#endregion
+export { buildActionBlocks };
+
+//# sourceMappingURL=buildActionBlocks.js.map

package/dist/actions/buildActionBlocks.js.map

@@ -0,0 +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"}

package/dist/actions/builtin/confirmation.js

@@ -0,0 +1,49 @@
+import { interpolate } from "../../recall/interpolate.js";
+import { keys } from "../../translations/keys.js";
+import { labelFor } from "../../translations/server.js";
+import { defineAction } from "../defineAction.js";
+//#region src/actions/builtin/confirmation.ts
+const confirmation = defineAction({
+	type: "confirmation",
+	label: keys.actionConfirmation,
+	config: [
+		{
+			name: "toField",
+			type: "text",
+			label: labelFor(keys.actionConfigToField)
+		},
+		{
+			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
+		});
+	}
+});
+//#endregion
+export { confirmation };
+
+//# sourceMappingURL=confirmation.js.map

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

@@ -0,0 +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"}

package/dist/actions/builtin/emailTeam.js

@@ -0,0 +1,46 @@
+import { interpolate } from "../../recall/interpolate.js";
+import { keys } from "../../translations/keys.js";
+import { labelFor } from "../../translations/server.js";
+import { defineAction } from "../defineAction.js";
+//#region src/actions/builtin/emailTeam.ts
+const emailTeam = defineAction({
+	type: "emailTeam",
+	label: keys.actionEmailTeam,
+	config: [
+		{
+			name: "to",
+			type: "text",
+			label: labelFor(keys.actionConfigTo)
+		},
+		{
+			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.to) throw new Error("emailTeam: missing \"to\" address");
+		if (typeof payload.sendEmail !== "function") throw new Error("emailTeam: no email adapter configured");
+		const resolve = (name) => {
+			const entry = values.find((v) => v.field === name);
+			return entry == null ? "" : String(entry.value ?? "");
+		};
+		const subject = interpolate(config.subject ?? "", resolve);
+		const html = interpolate(config.body ?? "", resolve);
+		await payload.sendEmail({
+			to: config.to,
+			subject,
+			html
+		});
+	}
+});
+//#endregion
+export { emailTeam };
+
+//# sourceMappingURL=emailTeam.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emailTeam.js","names":[],"sources":["../../../src/actions/builtin/emailTeam.ts"],"sourcesContent":["import { interpolate } from '../../recall/interpolate'\nimport { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { defineAction } from '../defineAction'\n\ntype EmailTeamConfig = { to?: string; subject?: string; body?: string }\n\nexport const emailTeam = defineAction<EmailTeamConfig>({\n\ttype: 'emailTeam',\n\tlabel: keys.actionEmailTeam,\n\tconfig: [\n\t\t{ name: 'to', type: 'text', label: labelFor(keys.actionConfigTo) },\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.to) {\n\t\t\tthrow new Error('emailTeam: missing \"to\" address')\n\t\t}\n\n\t\tif (typeof payload.sendEmail !== 'function') {\n\t\t\tthrow new Error('emailTeam: no email adapter configured')\n\t\t}\n\n\t\tconst resolve = (name: string) => {\n\t\t\tconst entry = values.find((v) => v.field === name)\n\t\t\treturn entry == null ? '' : String(entry.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: config.to, subject, html })\n\t},\n})\n"],"mappings":";;;;;AAOA,MAAa,YAAY,aAA8B;CACtD,MAAM;CACN,OAAO,KAAK;CACZ,QAAQ;EACP;GAAE,MAAM;GAAM,MAAM;GAAQ,OAAO,SAAS,KAAK,cAAc;EAAE;EACjE;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,IACX,MAAM,IAAI,MAAM,mCAAiC;EAGlD,IAAI,OAAO,QAAQ,cAAc,YAChC,MAAM,IAAI,MAAM,wCAAwC;EAGzD,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,IAAI,OAAO;GAAI;GAAS;EAAK,CAAC;CACzD;AACD,CAAC"}

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

@@ -0,0 +1,7 @@
+import { AnyActionDefinition } from "../defineAction.js";
+
+//#region src/actions/builtin/index.d.ts
+declare const defaultActionDefinitions: Record<string, AnyActionDefinition>;
+//#endregion
+export { defaultActionDefinitions };
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/builtin/index.js

@@ -0,0 +1,13 @@
+import { confirmation } from "./confirmation.js";
+import { emailTeam } from "./emailTeam.js";
+import { signedWebhook } from "./signedWebhook.js";
+//#region src/actions/builtin/index.ts
+const defaultActionDefinitions = {
+	emailTeam,
+	confirmation,
+	signedWebhook
+};
+//#endregion
+export { defaultActionDefinitions };
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/actions/builtin/index.ts"],"sourcesContent":["import type { AnyActionDefinition } from '../defineAction'\nimport { confirmation } from './confirmation'\nimport { emailTeam } from './emailTeam'\nimport { signedWebhook } from './signedWebhook'\n\nexport const defaultActionDefinitions: Record<string, AnyActionDefinition> = {\n\temailTeam: emailTeam as AnyActionDefinition,\n\tconfirmation: confirmation as AnyActionDefinition,\n\tsignedWebhook: signedWebhook as AnyActionDefinition,\n}\n"],"mappings":";;;;AAKA,MAAa,2BAAgE;CACjE;CACG;CACC;AAChB"}

package/dist/actions/builtin/signedWebhook.js

@@ -0,0 +1,49 @@
+import { keys } from "../../translations/keys.js";
+import { labelFor } from "../../translations/server.js";
+import { defineAction } from "../defineAction.js";
+import { SIGNATURE_HEADER, signPayload } from "../sign.js";
+//#region src/actions/builtin/signedWebhook.ts
+const signedWebhook = defineAction({
+	type: "signedWebhook",
+	label: keys.actionSignedWebhook,
+	config: [{
+		name: "url",
+		type: "text",
+		label: labelFor(keys.actionConfigUrl)
+	}, {
+		name: "secret",
+		type: "text",
+		label: labelFor(keys.actionConfigSecret)
+	}],
+	run: async (args) => {
+		const { config, form, submissionId, values } = args;
+		if (!config.url) throw new Error("signedWebhook: missing \"url\"");
+		if (!config.secret) throw new Error("signedWebhook: missing \"secret\"");
+		const body = JSON.stringify({
+			formId: form.id,
+			submissionId,
+			values
+		});
+		const controller = new AbortController();
+		const timer = setTimeout(() => controller.abort(), 1e4);
+		let response;
+		try {
+			response = await fetch(config.url, {
+				method: "POST",
+				headers: {
+					"Content-Type": "application/json",
+					[SIGNATURE_HEADER]: signPayload(body, config.secret)
+				},
+				body,
+				signal: controller.signal
+			});
+		} finally {
+			clearTimeout(timer);
+		}
+		if (!response.ok) throw new Error(`signedWebhook: server responded ${response.status}`);
+	}
+});
+//#endregion
+export { signedWebhook };
+
+//# sourceMappingURL=signedWebhook.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"signedWebhook.js","names":[],"sources":["../../../src/actions/builtin/signedWebhook.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { defineAction } from '../defineAction'\nimport { SIGNATURE_HEADER, signPayload } from '../sign'\n\ntype SignedWebhookConfig = { url?: string; secret?: string }\n\nexport const signedWebhook = defineAction<SignedWebhookConfig>({\n\ttype: 'signedWebhook',\n\tlabel: keys.actionSignedWebhook,\n\tconfig: [\n\t\t{ name: 'url', type: 'text', label: labelFor(keys.actionConfigUrl) },\n\t\t{ name: 'secret', type: 'text', label: labelFor(keys.actionConfigSecret) },\n\t],\n\trun: async (args) => {\n\t\tconst { config, form, submissionId, values } = args\n\n\t\tif (!config.url) {\n\t\t\tthrow new Error('signedWebhook: missing \"url\"')\n\t\t}\n\t\tif (!config.secret) {\n\t\t\tthrow new Error('signedWebhook: missing \"secret\"')\n\t\t}\n\n\t\tconst body = JSON.stringify({ formId: form.id, submissionId, values })\n\t\tconst controller = new AbortController()\n\t\tconst timer = setTimeout(() => controller.abort(), 10_000)\n\n\t\tlet response: Response\n\t\ttry {\n\t\t\tresponse = await fetch(config.url, {\n\t\t\t\tmethod: 'POST',\n\t\t\t\theaders: {\n\t\t\t\t\t'Content-Type': 'application/json',\n\t\t\t\t\t[SIGNATURE_HEADER]: signPayload(body, config.secret),\n\t\t\t\t},\n\t\t\t\tbody,\n\t\t\t\tsignal: controller.signal,\n\t\t\t})\n\t\t} finally {\n\t\t\tclearTimeout(timer)\n\t\t}\n\n\t\tif (!response.ok) {\n\t\t\tthrow new Error(`signedWebhook: server responded ${response.status}`)\n\t\t}\n\t},\n})\n"],"mappings":";;;;;AAOA,MAAa,gBAAgB,aAAkC;CAC9D,MAAM;CACN,OAAO,KAAK;CACZ,QAAQ,CACP;EAAE,MAAM;EAAO,MAAM;EAAQ,OAAO,SAAS,KAAK,eAAe;CAAE,GACnE;EAAE,MAAM;EAAU,MAAM;EAAQ,OAAO,SAAS,KAAK,kBAAkB;CAAE,CAC1E;CACA,KAAK,OAAO,SAAS;EACpB,MAAM,EAAE,QAAQ,MAAM,cAAc,WAAW;EAE/C,IAAI,CAAC,OAAO,KACX,MAAM,IAAI,MAAM,gCAA8B;EAE/C,IAAI,CAAC,OAAO,QACX,MAAM,IAAI,MAAM,mCAAiC;EAGlD,MAAM,OAAO,KAAK,UAAU;GAAE,QAAQ,KAAK;GAAI;GAAc;EAAO,CAAC;EACrE,MAAM,aAAa,IAAI,gBAAgB;EACvC,MAAM,QAAQ,iBAAiB,WAAW,MAAM,GAAG,GAAM;EAEzD,IAAI;EACJ,IAAI;GACH,WAAW,MAAM,MAAM,OAAO,KAAK;IAClC,QAAQ;IACR,SAAS;KACR,gBAAgB;MACf,mBAAmB,YAAY,MAAM,OAAO,MAAM;IACpD;IACA;IACA,QAAQ,WAAW;GACpB,CAAC;EACF,UAAU;GACT,aAAa,KAAK;EACnB;EAEA,IAAI,CAAC,SAAS,IACb,MAAM,IAAI,MAAM,mCAAmC,SAAS,QAAQ;CAEtE;AACD,CAAC"}

package/dist/actions/defineAction.d.ts

@@ -0,0 +1,36 @@
+import { Translate } from "../fields/types.js";
+import { SubmissionDescriptor, SubmissionValue } from "../submissions/types.js";
+import { Field, Payload, PayloadRequest } from "payload";
+
+//#region src/actions/defineAction.d.ts
+/** Context passed to an action's `run` when a submission completes. */
+type ActionRunArgs<TConfig extends Record<string, unknown> = Record<string, unknown>> = {
+  form: {
+    id: number | string;
+    title?: string;
+  };
+  submissionId: number | string;
+  values: SubmissionValue[];
+  descriptors: SubmissionDescriptor[];
+  config: TConfig;
+  payload: Payload;
+  req?: PayloadRequest;
+  locale: string;
+  t: Translate;
+};
+/**
+ * A post-submit action type, authored once: `config` is the admin `Field[]` for authoring;
+ * `run` executes when a submission completes. Built-ins use this same primitive.
+ */
+type ActionDefinition<TConfig extends Record<string, unknown> = Record<string, unknown>> = {
+  type: string;
+  label: string;
+  config?: Field[];
+  run: (args: ActionRunArgs<TConfig>) => Promise<void> | void;
+};
+/** Erased shape stored in the registry; config re-narrows per matched type at execution. */
+type AnyActionDefinition = ActionDefinition<Record<string, unknown>>;
+declare const defineAction: <TConfig extends Record<string, unknown> = Record<string, unknown>>(definition: ActionDefinition<TConfig>) => ActionDefinition<TConfig>;
+//#endregion
+export { ActionDefinition, ActionRunArgs, AnyActionDefinition, defineAction };
+//# sourceMappingURL=defineAction.d.ts.map

package/dist/actions/defineAction.js

@@ -0,0 +1,6 @@
+//#region src/actions/defineAction.ts
+const defineAction = (definition) => definition;
+//#endregion
+export { defineAction };
+
+//# sourceMappingURL=defineAction.js.map

package/dist/actions/defineAction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineAction.js","names":[],"sources":["../../src/actions/defineAction.ts"],"sourcesContent":["import type { Field, Payload, PayloadRequest } from 'payload'\nimport type { Translate } from '../fields/types'\nimport type { SubmissionDescriptor, SubmissionValue } from '../submissions/types'\n\n/** Context passed to an action's `run` when a submission completes. */\nexport type ActionRunArgs<TConfig extends Record<string, unknown> = Record<string, unknown>> = {\n\tform: { id: number | string; title?: string }\n\tsubmissionId: number | string\n\tvalues: SubmissionValue[]\n\tdescriptors: SubmissionDescriptor[]\n\tconfig: TConfig\n\tpayload: Payload\n\treq?: PayloadRequest\n\tlocale: string\n\tt: Translate\n}\n\n/**\n * A post-submit action type, authored once: `config` is the admin `Field[]` for authoring;\n * `run` executes when a submission completes. Built-ins use this same primitive.\n */\nexport type ActionDefinition<TConfig extends Record<string, unknown> = Record<string, unknown>> = {\n\ttype: string\n\tlabel: string\n\tconfig?: Field[]\n\trun: (args: ActionRunArgs<TConfig>) => Promise<void> | void\n}\n\n/** Erased shape stored in the registry; config re-narrows per matched type at execution. */\nexport type AnyActionDefinition = ActionDefinition<Record<string, unknown>>\n\nexport const defineAction = <TConfig extends Record<string, unknown> = Record<string, unknown>>(\n\tdefinition: ActionDefinition<TConfig>\n): ActionDefinition<TConfig> => definition\n"],"mappings":";AA+BA,MAAa,gBACZ,eAC+B"}

package/dist/actions/dispatch.js

@@ -0,0 +1,48 @@
+import { ACTIONS_TASK_SLUG, runActionsForSubmission } from "./task.js";
+const canQueue = (payload) => typeof payload.jobs?.queue === "function";
+const deadline = (ms) => new Promise((resolve) => {
+	setTimeout(resolve, ms).unref?.();
+});
+/**
+* Dispatch a submission's post-submit actions without throwing and without blocking the response on slow
+* action work. With no actions, returns immediately. When a job runner is present, enqueues the native
+* `form-builder-actions` task and returns (action work happens out of band). Otherwise runs the actions
+* inline but bounded by a deadline so a missing worker still delivers without hanging the request; any
+* error is swallowed (logged via `payload.logger`). Never rejects.
+*/
+const dispatchActions = async (args) => {
+	const { payload, registry, req, formId, submissionId } = args;
+	if ((args.actions ?? []).length === 0) return;
+	if (args.hasRunner && canQueue(payload)) {
+		try {
+			await payload.jobs.queue({
+				task: ACTIONS_TASK_SLUG,
+				input: {
+					formId: String(formId),
+					submissionId: String(submissionId)
+				},
+				req
+			});
+		} catch (error) {
+			payload.logger?.error(`@10x-media/form-builder: failed to enqueue actions for submission ${String(submissionId)}: ${error instanceof Error ? error.message : String(error)}`);
+		}
+		return;
+	}
+	const ms = args.deadlineMs ?? 5e3;
+	const work = runActionsForSubmission({
+		input: {
+			formId,
+			submissionId
+		},
+		registry,
+		payload,
+		req
+	}).catch((error) => {
+		payload.logger?.error(`@10x-media/form-builder: inline action dispatch for submission ${String(submissionId)} threw: ${error instanceof Error ? error.message : String(error)}`);
+	});
+	await Promise.race([work, deadline(ms)]);
+};
+//#endregion
+export { dispatchActions };
+
+//# sourceMappingURL=dispatch.js.map

package/dist/actions/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","names":[],"sources":["../../src/actions/dispatch.ts"],"sourcesContent":["import type { Payload, PayloadRequest } from 'payload'\nimport type { ActionRegistry } from './registry'\nimport type { ActionInstance } from './runActions'\nimport { ACTIONS_TASK_SLUG, runActionsForSubmission } from './task'\n\n/** Default cap on inline action work so a missing worker never hangs the submission response. */\nexport const INLINE_DISPATCH_DEADLINE_MS = 5_000\n\nexport type DispatchActionsArgs = {\n\tactions: ActionInstance[] | null | undefined\n\tformId: number | string\n\tsubmissionId: number | string\n\tregistry: ActionRegistry\n\tpayload: Payload\n\treq?: PayloadRequest\n\t/** Whether a job runner is likely present (queued path); otherwise the bounded-inline fallback runs. */\n\thasRunner: boolean\n\tdeadlineMs?: number\n}\n\nconst canQueue = (payload: Payload): boolean => typeof payload.jobs?.queue === 'function'\n\nconst deadline = (ms: number): Promise<void> =>\n\tnew Promise((resolve) => {\n\t\tconst timer = setTimeout(resolve, ms)\n\t\ttimer.unref?.()\n\t})\n\n/**\n * Dispatch a submission's post-submit actions without throwing and without blocking the response on slow\n * action work. With no actions, returns immediately. When a job runner is present, enqueues the native\n * `form-builder-actions` task and returns (action work happens out of band). Otherwise runs the actions\n * inline but bounded by a deadline so a missing worker still delivers without hanging the request; any\n * error is swallowed (logged via `payload.logger`). Never rejects.\n */\nexport const dispatchActions = async (args: DispatchActionsArgs): Promise<void> => {\n\tconst { payload, registry, req, formId, submissionId } = args\n\tconst actions = args.actions ?? []\n\tif (actions.length === 0) {\n\t\treturn\n\t}\n\n\tif (args.hasRunner && canQueue(payload)) {\n\t\ttry {\n\t\t\tawait payload.jobs.queue({\n\t\t\t\ttask: ACTIONS_TASK_SLUG,\n\t\t\t\tinput: { formId: String(formId), submissionId: String(submissionId) },\n\t\t\t\treq,\n\t\t\t})\n\t\t} catch (error) {\n\t\t\tpayload.logger?.error(\n\t\t\t\t`@10x-media/form-builder: failed to enqueue actions for submission ${String(submissionId)}: ${\n\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t}`\n\t\t\t)\n\t\t}\n\t\treturn\n\t}\n\n\tconst ms = args.deadlineMs ?? INLINE_DISPATCH_DEADLINE_MS\n\t// Guard the action arm itself (not just the race) so a rejection AFTER the deadline wins is never an unhandled rejection.\n\tconst work = runActionsForSubmission({\n\t\tinput: { formId, submissionId },\n\t\tregistry,\n\t\tpayload,\n\t\treq,\n\t}).catch((error) => {\n\t\tpayload.logger?.error(\n\t\t\t`@10x-media/form-builder: inline action dispatch for submission ${String(submissionId)} threw: ${\n\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t}`\n\t\t)\n\t})\n\tawait Promise.race([work, deadline(ms)])\n}\n"],"mappings":";AAoBA,MAAM,YAAY,YAA8B,OAAO,QAAQ,MAAM,UAAU;AAE/E,MAAM,YAAY,OACjB,IAAI,SAAS,YAAY;CAExB,WADyB,SAAS,EAC9B,EAAE,QAAQ;AACf,CAAC;;;;;;;;AASF,MAAa,kBAAkB,OAAO,SAA6C;CAClF,MAAM,EAAE,SAAS,UAAU,KAAK,QAAQ,iBAAiB;CAEzD,KADgB,KAAK,WAAW,CAAC,GACrB,WAAW,GACtB;CAGD,IAAI,KAAK,aAAa,SAAS,OAAO,GAAG;EACxC,IAAI;GACH,MAAM,QAAQ,KAAK,MAAM;IACxB,MAAM;IACN,OAAO;KAAE,QAAQ,OAAO,MAAM;KAAG,cAAc,OAAO,YAAY;IAAE;IACpE;GACD,CAAC;EACF,SAAS,OAAO;GACf,QAAQ,QAAQ,MACf,qEAAqE,OAAO,YAAY,EAAE,IACzF,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAEvD;EACD;EACA;CACD;CAEA,MAAM,KAAK,KAAK,cAAA;CAEhB,MAAM,OAAO,wBAAwB;EACpC,OAAO;GAAE;GAAQ;EAAa;EAC9B;EACA;EACA;CACD,CAAC,EAAE,OAAO,UAAU;EACnB,QAAQ,QAAQ,MACf,kEAAkE,OAAO,YAAY,EAAE,UACtF,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAEvD;CACD,CAAC;CACD,MAAM,QAAQ,KAAK,CAAC,MAAM,SAAS,EAAE,CAAC,CAAC;AACxC"}

package/dist/actions/registry.d.ts

@@ -0,0 +1,16 @@
+import { AnyActionDefinition } from "./defineAction.js";
+
+//#region src/actions/registry.d.ts
+type ActionRegistry = Map<string, AnyActionDefinition>;
+/** `false` removes a built-in, `true` keeps it, a definition adds or replaces one. */
+type ActionOption = boolean | AnyActionDefinition;
+type ActionsConfig = Record<string, ActionOption>;
+/**
+ * Resolve the active action registry from built-in defaults and a consumer override map. `false`
+ * removes a type, `true` keeps the default (no-op when none exists), a definition adds or replaces.
+ * Mirrors the field-type and validation-rule registry convention.
+ */
+declare const resolveActions: (defaults: Record<string, AnyActionDefinition>, config?: ActionsConfig) => ActionRegistry;
+//#endregion
+export { ActionOption, ActionRegistry, ActionsConfig, resolveActions };
+//# sourceMappingURL=registry.d.ts.map

package/dist/actions/registry.js

@@ -0,0 +1,16 @@
+//#region src/actions/registry.ts
+/**
+* Resolve the active action registry from built-in defaults and a consumer override map. `false`
+* removes a type, `true` keeps the default (no-op when none exists), a definition adds or replaces.
+* Mirrors the field-type and validation-rule registry convention.
+*/
+const resolveActions = (defaults, config = {}) => {
+	const registry = new Map(Object.entries(defaults));
+	for (const [type, option] of Object.entries(config)) if (option === false) registry.delete(type);
+	else if (option === true) {} else registry.set(type, option);
+	return registry;
+};
+//#endregion
+export { resolveActions };
+
+//# sourceMappingURL=registry.js.map

package/dist/actions/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../src/actions/registry.ts"],"sourcesContent":["import type { AnyActionDefinition } from './defineAction'\n\nexport type ActionRegistry = Map<string, AnyActionDefinition>\n\n/** `false` removes a built-in, `true` keeps it, a definition adds or replaces one. */\nexport type ActionOption = boolean | AnyActionDefinition\n\nexport type ActionsConfig = Record<string, ActionOption>\n\n/**\n * Resolve the active action registry from built-in defaults and a consumer override map. `false`\n * removes a type, `true` keeps the default (no-op when none exists), a definition adds or replaces.\n * Mirrors the field-type and validation-rule registry convention.\n */\nexport const resolveActions = (\n\tdefaults: Record<string, AnyActionDefinition>,\n\tconfig: ActionsConfig = {}\n): ActionRegistry => {\n\tconst registry: ActionRegistry = new Map(Object.entries(defaults))\n\tfor (const [type, option] of Object.entries(config)) {\n\t\tif (option === false) {\n\t\t\tregistry.delete(type)\n\t\t} else if (option === true) {\n\t\t\t// keep the default; no-op when no default exists for this key\n\t\t} else {\n\t\t\tregistry.set(type, option)\n\t\t}\n\t}\n\treturn registry\n}\n"],"mappings":";;;;;;AAcA,MAAa,kBACZ,UACA,SAAwB,CAAC,MACL;CACpB,MAAM,WAA2B,IAAI,IAAI,OAAO,QAAQ,QAAQ,CAAC;CACjE,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,MAAM,GACjD,IAAI,WAAW,OACd,SAAS,OAAO,IAAI;MACd,IAAI,WAAW,MAAM,CAE5B,OACC,SAAS,IAAI,MAAM,MAAM;CAG3B,OAAO;AACR"}

package/dist/actions/runActions.d.ts

@@ -0,0 +1,9 @@
+//#region src/actions/runActions.d.ts
+type ActionResult = {
+  type: string;
+  ok: boolean;
+  error?: string;
+};
+//#endregion
+export { ActionResult };
+//# sourceMappingURL=runActions.d.ts.map

package/dist/actions/runActions.js

@@ -0,0 +1,34 @@
+//#region src/actions/runActions.ts
+/**
+* Run each configured action, isolating failures: a throwing action is captured as a failed result
+* and never breaks the others or the caller.
+*/
+const runActions = async (args) => {
+	const { actions, registry, ...ctx } = args;
+	const results = [];
+	for (const instance of actions) {
+		const definition = registry.get(instance.blockType);
+		if (!definition) continue;
+		try {
+			await definition.run({
+				...ctx,
+				config: instance
+			});
+			results.push({
+				type: instance.blockType,
+				ok: true
+			});
+		} catch (error) {
+			results.push({
+				type: instance.blockType,
+				ok: false,
+				error: error instanceof Error ? error.message : String(error)
+			});
+		}
+	}
+	return results;
+};
+//#endregion
+export { runActions };
+
+//# sourceMappingURL=runActions.js.map

package/dist/actions/runActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runActions.js","names":[],"sources":["../../src/actions/runActions.ts"],"sourcesContent":["import type { ActionRunArgs } from './defineAction'\nimport type { ActionRegistry } from './registry'\n\n/** A stored action instance from the form's `actions` blocks array. */\nexport type ActionInstance = { blockType: string; [key: string]: unknown }\n\nexport type ActionResult = { type: string; ok: boolean; error?: string }\n\nexport type RunActionsArgs = Omit<ActionRunArgs, 'config'> & {\n\tactions: ActionInstance[]\n\tregistry: ActionRegistry\n}\n\n/**\n * Run each configured action, isolating failures: a throwing action is captured as a failed result\n * and never breaks the others or the caller.\n */\nexport const runActions = async (args: RunActionsArgs): Promise<ActionResult[]> => {\n\tconst { actions, registry, ...ctx } = args\n\tconst results: ActionResult[] = []\n\tfor (const instance of actions) {\n\t\tconst definition = registry.get(instance.blockType)\n\t\tif (!definition) {\n\t\t\tcontinue\n\t\t}\n\t\ttry {\n\t\t\tawait definition.run({ ...ctx, config: instance })\n\t\t\tresults.push({ type: instance.blockType, ok: true })\n\t\t} catch (error) {\n\t\t\tresults.push({\n\t\t\t\ttype: instance.blockType,\n\t\t\t\tok: false,\n\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t})\n\t\t}\n\t}\n\treturn results\n}\n"],"mappings":";;;;;AAiBA,MAAa,aAAa,OAAO,SAAkD;CAClF,MAAM,EAAE,SAAS,UAAU,GAAG,QAAQ;CACtC,MAAM,UAA0B,CAAC;CACjC,KAAK,MAAM,YAAY,SAAS;EAC/B,MAAM,aAAa,SAAS,IAAI,SAAS,SAAS;EAClD,IAAI,CAAC,YACJ;EAED,IAAI;GACH,MAAM,WAAW,IAAI;IAAE,GAAG;IAAK,QAAQ;GAAS,CAAC;GACjD,QAAQ,KAAK;IAAE,MAAM,SAAS;IAAW,IAAI;GAAK,CAAC;EACpD,SAAS,OAAO;GACf,QAAQ,KAAK;IACZ,MAAM,SAAS;IACf,IAAI;IACJ,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAC7D,CAAC;EACF;CACD;CACA,OAAO;AACR"}

package/dist/actions/sign.d.ts

@@ -0,0 +1,7 @@
+//#region src/actions/sign.d.ts
+declare const SIGNATURE_HEADER = "X-Form-Signature";
+/** HMAC-SHA256 over `body`, hex-encoded, wrapped in the versioned header value (`v1=<hex>`). */
+declare const signPayload: (body: string, secret: string) => string;
+//#endregion
+export { SIGNATURE_HEADER, signPayload };
+//# sourceMappingURL=sign.d.ts.map

package/dist/actions/sign.js

@@ -0,0 +1,9 @@
+import { createHmac } from "node:crypto";
+//#region src/actions/sign.ts
+const SIGNATURE_HEADER = "X-Form-Signature";
+/** HMAC-SHA256 over `body`, hex-encoded, wrapped in the versioned header value (`v1=<hex>`). */
+const signPayload = (body, secret) => `v1=${createHmac("sha256", secret).update(body).digest("hex")}`;
+//#endregion
+export { SIGNATURE_HEADER, signPayload };
+
+//# sourceMappingURL=sign.js.map

package/dist/actions/sign.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sign.js","names":[],"sources":["../../src/actions/sign.ts"],"sourcesContent":["import { createHmac } from 'node:crypto'\n\n// Distinct from @10x-media/webhooks' `X-Webhook-Signature` (which signs `timestamp.body`): this action signs the body alone, so a separate header prevents a consumer mistaking the two verification schemes.\nexport const SIGNATURE_HEADER = 'X-Form-Signature'\n\n/** HMAC-SHA256 over `body`, hex-encoded, wrapped in the versioned header value (`v1=<hex>`). */\nexport const signPayload = (body: string, secret: string): string =>\n\t`v1=${createHmac('sha256', secret).update(body).digest('hex')}`\n"],"mappings":";;AAGA,MAAa,mBAAmB;;AAGhC,MAAa,eAAe,MAAc,WACzC,MAAM,WAAW,UAAU,MAAM,EAAE,OAAO,IAAI,EAAE,OAAO,KAAK"}

package/dist/actions/task.js

@@ -0,0 +1,82 @@
+import { asFieldTranslate } from "../translations/server.js";
+import { FORMS_SLUG } from "../collections/forms.js";
+import { FORM_SUBMISSIONS_SLUG } from "../collections/formSubmissions.js";
+import { runActions } from "./runActions.js";
+//#region src/actions/task.ts
+const ACTIONS_TASK_SLUG = "form-builder-actions";
+const asActions = (value) => Array.isArray(value) ? value : [];
+const asValues = (value) => Array.isArray(value) ? value : [];
+const asDescriptors = (value) => Array.isArray(value) ? value : [];
+/**
+* Load the form and submission by id and run the form's actions through the shared, failure-isolating
+* `runActions`. Tolerates a missing form or submission (the row may have been deleted between enqueue and
+* run) by returning early. Used by both the queued task handler and the inline fallback.
+*/
+const runActionsForSubmission = async (args) => {
+	const { input, registry, payload, req } = args;
+	const form = await payload.findByID({
+		collection: FORMS_SLUG,
+		id: input.formId,
+		depth: 0,
+		overrideAccess: true,
+		req
+	}).catch(() => null);
+	if (!form) return;
+	const submission = await payload.findByID({
+		collection: FORM_SUBMISSIONS_SLUG,
+		id: input.submissionId,
+		depth: 0,
+		overrideAccess: true,
+		req
+	}).catch(() => null);
+	if (!submission) return;
+	const locale = typeof submission.locale === "string" ? submission.locale : req?.locale ?? "en";
+	const t = asFieldTranslate(req?.i18n?.t ?? ((key) => key));
+	await runActions({
+		actions: asActions(form.actions),
+		registry,
+		form: {
+			id: form.id,
+			title: typeof form.title === "string" ? form.title : void 0
+		},
+		submissionId: submission.id,
+		values: asValues(submission.values),
+		descriptors: asDescriptors(submission.descriptors),
+		payload,
+		req,
+		locale,
+		t
+	});
+};
+/** Native Payload jobs task that runs a submission's post-submit actions out of band. */
+const buildActionsTask = (registry) => ({
+	slug: ACTIONS_TASK_SLUG,
+	inputSchema: [{
+		name: "formId",
+		type: "text",
+		required: true
+	}, {
+		name: "submissionId",
+		type: "text",
+		required: true
+	}],
+	handler: async ({ input, req }) => {
+		await runActionsForSubmission({
+			input,
+			registry,
+			payload: req.payload,
+			req
+		});
+		return { output: {} };
+	}
+});
+/** Register the actions task on `config.jobs.tasks`, creating the jobs config if absent. */
+const registerActionsTask = (config, registry) => {
+	config.jobs ??= {};
+	config.jobs.tasks ??= [];
+	config.jobs.tasks.push(buildActionsTask(registry));
+};
+//#endregion
+export { ACTIONS_TASK_SLUG, registerActionsTask, runActionsForSubmission };
+
+//# sourceMappingURL=task.js.map

package/dist/actions/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","names":[],"sources":["../../src/actions/task.ts"],"sourcesContent":["import type { Config, Payload, PayloadRequest, TaskConfig } from 'payload'\nimport { FORM_SUBMISSIONS_SLUG } from '../collections/formSubmissions'\nimport { FORMS_SLUG } from '../collections/forms'\nimport type { Translate } from '../fields/types'\nimport type { SubmissionDescriptor, SubmissionValue } from '../submissions/types'\nimport { asFieldTranslate } from '../translations/server'\nimport type { ActionRegistry } from './registry'\nimport type { ActionInstance } from './runActions'\nimport { runActions } from './runActions'\n\nexport const ACTIONS_TASK_SLUG = 'form-builder-actions'\n\n/** Input the dispatch path enqueues; the handler re-loads everything else from the DB. */\nexport type ActionsTaskInput = { formId: number | string; submissionId: number | string }\n\nconst asActions = (value: unknown): ActionInstance[] =>\n\tArray.isArray(value) ? (value as ActionInstance[]) : []\n\nconst asValues = (value: unknown): SubmissionValue[] =>\n\tArray.isArray(value) ? (value as SubmissionValue[]) : []\n\nconst asDescriptors = (value: unknown): SubmissionDescriptor[] =>\n\tArray.isArray(value) ? (value as SubmissionDescriptor[]) : []\n\n/**\n * Load the form and submission by id and run the form's actions through the shared, failure-isolating\n * `runActions`. Tolerates a missing form or submission (the row may have been deleted between enqueue and\n * run) by returning early. Used by both the queued task handler and the inline fallback.\n */\nexport const runActionsForSubmission = async (args: {\n\tinput: ActionsTaskInput\n\tregistry: ActionRegistry\n\tpayload: Payload\n\treq?: PayloadRequest\n}): Promise<void> => {\n\tconst { input, registry, payload, req } = args\n\tconst form = await payload\n\t\t.findByID({\n\t\t\tcollection: FORMS_SLUG,\n\t\t\tid: input.formId,\n\t\t\tdepth: 0,\n\t\t\toverrideAccess: true,\n\t\t\treq,\n\t\t})\n\t\t.catch(() => null)\n\tif (!form) {\n\t\treturn\n\t}\n\tconst submission = await payload\n\t\t.findByID({\n\t\t\tcollection: FORM_SUBMISSIONS_SLUG,\n\t\t\tid: input.submissionId,\n\t\t\tdepth: 0,\n\t\t\toverrideAccess: true,\n\t\t\treq,\n\t\t})\n\t\t.catch(() => null)\n\tif (!submission) {\n\t\treturn\n\t}\n\n\tconst locale = typeof submission.locale === 'string' ? submission.locale : (req?.locale ?? 'en')\n\tconst t: Translate = asFieldTranslate(req?.i18n?.t ?? ((key: string) => key))\n\n\tawait runActions({\n\t\tactions: asActions(form.actions),\n\t\tregistry,\n\t\tform: { id: form.id, title: typeof form.title === 'string' ? form.title : undefined },\n\t\tsubmissionId: submission.id,\n\t\tvalues: asValues(submission.values),\n\t\tdescriptors: asDescriptors(submission.descriptors),\n\t\tpayload,\n\t\treq,\n\t\tlocale,\n\t\tt,\n\t})\n}\n\n/** Native Payload jobs task that runs a submission's post-submit actions out of band. */\nexport const buildActionsTask = (registry: ActionRegistry): TaskConfig =>\n\t({\n\t\tslug: ACTIONS_TASK_SLUG,\n\t\tinputSchema: [\n\t\t\t{ name: 'formId', type: 'text', required: true },\n\t\t\t{ name: 'submissionId', type: 'text', required: true },\n\t\t],\n\t\thandler: async ({ input, req }) => {\n\t\t\tawait runActionsForSubmission({\n\t\t\t\tinput: input as ActionsTaskInput,\n\t\t\t\tregistry,\n\t\t\t\tpayload: req.payload,\n\t\t\t\treq,\n\t\t\t})\n\t\t\treturn { output: {} }\n\t\t},\n\t}) as TaskConfig\n\n/** Register the actions task on `config.jobs.tasks`, creating the jobs config if absent. */\nexport const registerActionsTask = (config: Config, registry: ActionRegistry): void => {\n\tconfig.jobs ??= {}\n\tconfig.jobs.tasks ??= []\n\tconfig.jobs.tasks.push(buildActionsTask(registry))\n}\n"],"mappings":";;;;;AAUA,MAAa,oBAAoB;AAKjC,MAAM,aAAa,UAClB,MAAM,QAAQ,KAAK,IAAK,QAA6B,CAAC;AAEvD,MAAM,YAAY,UACjB,MAAM,QAAQ,KAAK,IAAK,QAA8B,CAAC;AAExD,MAAM,iBAAiB,UACtB,MAAM,QAAQ,KAAK,IAAK,QAAmC,CAAC;;;;;;AAO7D,MAAa,0BAA0B,OAAO,SAKzB;CACpB,MAAM,EAAE,OAAO,UAAU,SAAS,QAAQ;CAC1C,MAAM,OAAO,MAAM,QACjB,SAAS;EACT,YAAY;EACZ,IAAI,MAAM;EACV,OAAO;EACP,gBAAgB;EAChB;CACD,CAAC,EACA,YAAY,IAAI;CAClB,IAAI,CAAC,MACJ;CAED,MAAM,aAAa,MAAM,QACvB,SAAS;EACT,YAAY;EACZ,IAAI,MAAM;EACV,OAAO;EACP,gBAAgB;EAChB;CACD,CAAC,EACA,YAAY,IAAI;CAClB,IAAI,CAAC,YACJ;CAGD,MAAM,SAAS,OAAO,WAAW,WAAW,WAAW,WAAW,SAAU,KAAK,UAAU;CAC3F,MAAM,IAAe,iBAAiB,KAAK,MAAM,OAAO,QAAgB,IAAI;CAE5E,MAAM,WAAW;EAChB,SAAS,UAAU,KAAK,OAAO;EAC/B;EACA,MAAM;GAAE,IAAI,KAAK;GAAI,OAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,KAAA;EAAU;EACpF,cAAc,WAAW;EACzB,QAAQ,SAAS,WAAW,MAAM;EAClC,aAAa,cAAc,WAAW,WAAW;EACjD;EACA;EACA;EACA;CACD,CAAC;AACF;;AAGA,MAAa,oBAAoB,cAC/B;CACA,MAAM;CACN,aAAa,CACZ;EAAE,MAAM;EAAU,MAAM;EAAQ,UAAU;CAAK,GAC/C;EAAE,MAAM;EAAgB,MAAM;EAAQ,UAAU;CAAK,CACtD;CACA,SAAS,OAAO,EAAE,OAAO,UAAU;EAClC,MAAM,wBAAwB;GACtB;GACP;GACA,SAAS,IAAI;GACb;EACD,CAAC;EACD,OAAO,EAAE,QAAQ,CAAC,EAAE;CACrB;AACD;;AAGD,MAAa,uBAAuB,QAAgB,aAAmC;CACtF,OAAO,SAAS,CAAC;CACjB,OAAO,KAAK,UAAU,CAAC;CACvB,OAAO,KAAK,MAAM,KAAK,iBAAiB,QAAQ,CAAC;AAClD"}

package/dist/aggregation/aggregateResponses.d.ts

@@ -0,0 +1,31 @@
+import { FormFieldInstance } from "../submissions/types.js";
+import { FieldAggregation, SubmissionStatusFilter } from "./types.js";
+import { Payload, PayloadRequest } from "payload";
+
+//#region src/aggregation/aggregateResponses.d.ts
+type AggregateFormResponsesArgs = {
+  payload: Payload;
+  formId: number | string; /** Field machine names to aggregate. Defaults to every field that declares options (enumerable). */
+  fields?: string[]; /** Submission status to count. Defaults to `complete`. */
+  status?: SubmissionStatusFilter;
+  req?: PayloadRequest; /** Safety cap on submissions scanned; beyond it the result is flagged `truncated`. Default 10000. */
+  maxSubmissions?: number; /** Page size for the submission scan. Default 500. */
+  pageSize?: number;
+};
+/** True when a field declares non-empty options (a choice field safe to aggregate publicly). */
+declare const fieldHasOptions: (field: FormFieldInstance) => boolean;
+/**
+ * Aggregate submission responses for a form. Loads the form for current labels + option order, then pages
+ * `payload.find` over its submissions (JSON `values` cannot be GROUP BY'd portably across Mongo + Postgres,
+ * so we scan + reduce in JS, cross-DB-identically). Bounded by `maxSubmissions`; beyond it the result is
+ * `truncated`. Returns one `FieldAggregation` per requested field (or per enumerable field by default).
+ */
+declare const aggregateFormResponses: (args: AggregateFormResponsesArgs) => Promise<FieldAggregation[]>;
+type AggregateFieldResponsesArgs = Omit<AggregateFormResponsesArgs, 'fields'> & {
+  field: string;
+};
+/** Single-field convenience over `aggregateFormResponses`. Returns the field's aggregation, or null if absent. */
+declare const aggregateFieldResponses: (args: AggregateFieldResponsesArgs) => Promise<FieldAggregation | null>;
+//#endregion
+export { AggregateFieldResponsesArgs, AggregateFormResponsesArgs, aggregateFieldResponses, aggregateFormResponses, fieldHasOptions };
+//# sourceMappingURL=aggregateResponses.d.ts.map