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

package/dist/conditions/evaluate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.js","names":[],"sources":["../../src/conditions/evaluate.ts"],"sourcesContent":["import type { Operator, Where } from 'payload'\nimport { transformWhereQuery } from 'payload/shared'\n\nconst isNil = (value: unknown): boolean => value === null || value === undefined\n\nconst toNumber = (value: unknown): number | undefined => {\n\tif (typeof value === 'number') {\n\t\treturn Number.isFinite(value) ? value : undefined\n\t}\n\tif (typeof value === 'string' && value.trim() !== '') {\n\t\tconst next = Number(value)\n\t\treturn Number.isNaN(next) ? undefined : next\n\t}\n\treturn undefined\n}\n\nconst toTime = (value: unknown): number | undefined => {\n\tif (value instanceof Date) {\n\t\treturn value.getTime()\n\t}\n\tif (typeof value === 'string' && value.trim() !== '') {\n\t\tconst time = Date.parse(value)\n\t\treturn Number.isNaN(time) ? undefined : time\n\t}\n\treturn undefined\n}\n\n/** Strict, then numeric, then string equality, mirroring Payload's coerce-by-type-then-compare. */\nconst valuesEqual = (answer: unknown, value: unknown): boolean => {\n\tif (answer === value) {\n\t\treturn true\n\t}\n\tif (isNil(answer) || isNil(value)) {\n\t\treturn false\n\t}\n\tconst a = toNumber(answer)\n\tconst b = toNumber(value)\n\tif (a !== undefined && b !== undefined) {\n\t\treturn a === b\n\t}\n\treturn String(answer) === String(value)\n}\n\nconst toList = (value: unknown): unknown[] => {\n\tif (Array.isArray(value)) {\n\t\treturn value\n\t}\n\tif (typeof value === 'string') {\n\t\treturn value.split(',').map((entry) => entry.trim())\n\t}\n\treturn [value]\n}\n\nconst ordered = (\n\tanswer: unknown,\n\tvalue: unknown,\n\tcompare: (a: number, b: number) => boolean\n): boolean => {\n\tconst a = toNumber(answer) ?? toTime(answer)\n\tconst b = toNumber(value) ?? toTime(value)\n\tif (a === undefined || b === undefined) {\n\t\treturn false\n\t}\n\treturn compare(a, b)\n}\n\n/** Case-insensitive: every space-separated word in `value` is a substring of `answer` (Payload `like`). */\nconst everyWord = (answer: unknown, value: unknown): boolean => {\n\tconst haystack = String(answer).toLowerCase()\n\treturn String(value)\n\t\t.toLowerCase()\n\t\t.split(' ')\n\t\t.filter((word) => word.length > 0)\n\t\t.every((word) => haystack.includes(word))\n}\n\nconst evaluateOperator = (operator: Operator, answer: unknown, value: unknown): boolean => {\n\tswitch (operator) {\n\t\tcase 'equals':\n\t\t\treturn isNil(value) ? isNil(answer) : valuesEqual(answer, value)\n\t\tcase 'not_equals':\n\t\t\treturn isNil(value) ? !isNil(answer) : isNil(answer) || !valuesEqual(answer, value)\n\t\tcase 'in':\n\t\t\treturn toList(value).some((entry) => valuesEqual(answer, entry))\n\t\tcase 'not_in':\n\t\t\treturn isNil(answer) || !toList(value).some((entry) => valuesEqual(answer, entry))\n\t\tcase 'exists': {\n\t\t\tconst present = !isNil(answer) && answer !== ''\n\t\t\treturn value === true || value === 'true' ? present : !present\n\t\t}\n\t\tcase 'greater_than':\n\t\t\treturn ordered(answer, value, (a, b) => a > b)\n\t\tcase 'greater_than_equal':\n\t\t\treturn ordered(answer, value, (a, b) => a >= b)\n\t\tcase 'less_than':\n\t\t\treturn ordered(answer, value, (a, b) => a < b)\n\t\tcase 'less_than_equal':\n\t\t\treturn ordered(answer, value, (a, b) => a <= b)\n\t\tcase 'like':\n\t\t\treturn isNil(answer) ? false : everyWord(answer, value)\n\t\tcase 'not_like':\n\t\t\treturn isNil(answer) ? true : !everyWord(answer, value)\n\t\tcase 'contains':\n\t\t\treturn isNil(answer)\n\t\t\t\t? false\n\t\t\t\t: String(answer).toLowerCase().includes(String(value).toLowerCase())\n\t\tdefault:\n\t\t\treturn false\n\t}\n}\n\n/**\n * Evaluate one `Where` node: every top-level key is ANDed. `or` is a disjunction of sub-conditions\n * (an empty `or` matches), `and` is a conjunction, and any other key is a field path whose\n * `{ operator: value }` constraints are ANDed. Recurses, so nested `or`/`and` groups are supported.\n */\nconst evaluateWhere = (where: Where, answers: Record<string, unknown>): boolean =>\n\tObject.entries(where).every(([key, constraint]) => {\n\t\tif (key === 'or') {\n\t\t\tconst groups = (Array.isArray(constraint) ? constraint : []) as Where[]\n\t\t\treturn groups.length === 0 || groups.some((group) => evaluateWhere(group, answers))\n\t\t}\n\t\tif (key === 'and') {\n\t\t\tconst groups = (Array.isArray(constraint) ? constraint : []) as Where[]\n\t\t\treturn groups.every((group) => evaluateWhere(group, answers))\n\t\t}\n\t\tif (constraint == null || typeof constraint !== 'object' || Array.isArray(constraint)) {\n\t\t\treturn false\n\t\t}\n\t\treturn Object.entries(constraint as Record<string, unknown>).every(([operator, value]) =>\n\t\t\tevaluateOperator(operator as Operator, answers[key], value)\n\t\t)\n\t})\n\n/**\n * Evaluate a serializable `Where`-shaped condition against a flat map of (already coerced) form answers.\n * An absent or empty condition matches (returns true). Operator semantics mirror Payload's query\n * adapters: coerce then compare; `not_equals`/`not_in` are null-inclusive; `exists` treats `''`/absent\n * as not-existing; `like` is case-insensitive and space-splits (every word must be a substring), and\n * `not_like` is its logical negation (at least one word absent); `contains` is a single case-insensitive\n * substring; comma-delimited `in`/`not_in` string values are split and trimmed. Geo (`near`/`within`/\n * `intersects`) and `all` are out of scope and evaluate to false. Isomorphic: no `req`/DB access, so the\n * renderer reuses it client-side.\n */\nexport const evaluateCondition = (\n\twhere: Where | null | undefined,\n\tanswers: Record<string, unknown>\n): boolean => {\n\tif (!where || Object.keys(where).length === 0) {\n\t\treturn true\n\t}\n\treturn evaluateWhere(transformWhereQuery(where), answers)\n}\n"],"mappings":"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"}

package/dist/conditions/fieldTypes.d.ts

@@ -0,0 +1,9 @@
+//#region src/conditions/fieldTypes.d.ts
+/**
+ * The condition input families the builder supports. A deliberate subset of Payload's field-condition
+ * types, restricted to the operators `evaluateCondition` implements (no geo/relationship in v1).
+ */
+type ConditionFieldType = 'text' | 'number' | 'select' | 'checkbox' | 'date';
+//#endregion
+export { ConditionFieldType };
+//# sourceMappingURL=fieldTypes.d.ts.map

package/dist/{fieldTypes-CzhhJXjg.js → conditions/fieldTypes.js}

@@ -83,6 +83,6 @@ const operatorValueShape = (operator) => {
 	return "scalar";
 };
 //#endregion
-export { operatorValueShape as a, operatorLabelKey as i, defaultConditionType as n, firstOperatorFor as r, conditionOperators as t };
+export { conditionOperators, defaultConditionType, firstOperatorFor, operatorLabelKey, operatorValueShape };
 
-//# sourceMappingURL=fieldTypes-CzhhJXjg.js.map
+//# sourceMappingURL=fieldTypes.js.map

package/dist/conditions/fieldTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldTypes.js","names":[],"sources":["../../src/conditions/fieldTypes.ts"],"sourcesContent":["import type { Operator } from 'payload'\nimport type { FormFieldValueKind } from '../fields/types'\n\n/**\n * The condition input families the builder supports. A deliberate subset of Payload's field-condition\n * types, restricted to the operators `evaluateCondition` implements (no geo/relationship in v1).\n */\nexport type ConditionFieldType = 'text' | 'number' | 'select' | 'checkbox' | 'date'\n\nconst EQUALITY: Operator[] = ['equals', 'not_equals']\nconst MEMBERSHIP: Operator[] = ['in', 'not_in']\nconst ORDER: Operator[] = ['greater_than', 'greater_than_equal', 'less_than', 'less_than_equal']\nconst TEXT_MATCH: Operator[] = ['like', 'not_like', 'contains']\nconst EXISTS: Operator[] = ['exists']\n\n/** Operators offered per condition type. Each is implemented by `evaluateCondition`. */\nexport const conditionOperators: Record<ConditionFieldType, Operator[]> = {\n\ttext: [...EQUALITY, ...MEMBERSHIP, ...TEXT_MATCH, ...EXISTS],\n\tnumber: [...EQUALITY, ...MEMBERSHIP, ...ORDER, ...EXISTS],\n\tselect: [...EQUALITY, ...MEMBERSHIP, ...EXISTS],\n\tcheckbox: [...EQUALITY, ...EXISTS],\n\tdate: [...EQUALITY, ...ORDER, ...EXISTS],\n}\n\n/** Default condition input for a stored value kind; a field type may override via its `conditionType`. */\nexport const defaultConditionType = (value: FormFieldValueKind): ConditionFieldType => {\n\tswitch (value) {\n\t\tcase 'number':\n\t\t\treturn 'number'\n\t\tcase 'boolean':\n\t\t\treturn 'checkbox'\n\t\tcase 'date':\n\t\t\treturn 'date'\n\t\tcase 'text[]':\n\t\t\treturn 'select'\n\t\tdefault:\n\t\t\treturn 'text'\n\t}\n}\n\n/**\n * The Payload `operators:*` i18n keys the builder uses for operator labels. A local literal union (not\n * imported from `@payloadcms/translations`, which this package never depends on); each member is a real\n * client translation key, so a value of this type is accepted by Payload's `i18n.t`.\n */\nexport type OperatorLabelKey =\n\t| 'operators:contains'\n\t| 'operators:equals'\n\t| 'operators:exists'\n\t| 'operators:isGreaterThan'\n\t| 'operators:isGreaterThanOrEqualTo'\n\t| 'operators:isIn'\n\t| 'operators:isLessThan'\n\t| 'operators:isLessThanOrEqualTo'\n\t| 'operators:isLike'\n\t| 'operators:isNotEqualTo'\n\t| 'operators:isNotIn'\n\t| 'operators:isNotLike'\n\nconst OPERATOR_LABEL_KEYS: Partial<Record<Operator, OperatorLabelKey>> = {\n\tequals: 'operators:equals',\n\tnot_equals: 'operators:isNotEqualTo',\n\tin: 'operators:isIn',\n\tnot_in: 'operators:isNotIn',\n\texists: 'operators:exists',\n\tgreater_than: 'operators:isGreaterThan',\n\tgreater_than_equal: 'operators:isGreaterThanOrEqualTo',\n\tless_than: 'operators:isLessThan',\n\tless_than_equal: 'operators:isLessThanOrEqualTo',\n\tlike: 'operators:isLike',\n\tnot_like: 'operators:isNotLike',\n\tcontains: 'operators:contains',\n}\n\n/**\n * The i18n key for an operator's label, in Payload's own `operators:*` namespace (always present in the\n * admin), so the builder reads native, localized operator labels without duplicating them in our i18n.\n * Keys mirror Payload's `WhereBuilder/field-types.tsx` operator labels. Every operator surfaced by\n * `conditionOperators` is mapped; the `operators:equals` fallback is unreachable for the offered\n * catalogs (no geo/`all` operator is ever presented) and exists only to keep the return type total.\n */\nexport const operatorLabelKey = (operator: Operator): OperatorLabelKey =>\n\tOPERATOR_LABEL_KEYS[operator] ?? 'operators:equals'\n\n/**\n * The first (default) operator a condition type offers. Every catalog leads with `equals`, so the\n * fallback is unreachable; it exists only to keep the return non-optional under `noUncheckedIndexedAccess`.\n */\nexport const firstOperatorFor = (type: ConditionFieldType): Operator =>\n\tconditionOperators[type][0] ?? 'equals'\n\n/** The value control an operator needs: a boolean toggle (`exists`), a list (`in`/`not_in`), or a scalar. */\nexport const operatorValueShape = (operator: Operator): 'boolean' | 'array' | 'scalar' => {\n\tif (operator === 'exists') {\n\t\treturn 'boolean'\n\t}\n\tif (operator === 'in' || operator === 'not_in') {\n\t\treturn 'array'\n\t}\n\treturn 'scalar'\n}\n"],"mappings":";AASA,MAAM,WAAuB,CAAC,UAAU,YAAY;AACpD,MAAM,aAAyB,CAAC,MAAM,QAAQ;AAC9C,MAAM,QAAoB;CAAC;CAAgB;CAAsB;CAAa;AAAiB;AAC/F,MAAM,aAAyB;CAAC;CAAQ;CAAY;AAAU;AAC9D,MAAM,SAAqB,CAAC,QAAQ;;AAGpC,MAAa,qBAA6D;CACzE,MAAM;EAAC,GAAG;EAAU,GAAG;EAAY,GAAG;EAAY,GAAG;CAAM;CAC3D,QAAQ;EAAC,GAAG;EAAU,GAAG;EAAY,GAAG;EAAO,GAAG;CAAM;CACxD,QAAQ;EAAC,GAAG;EAAU,GAAG;EAAY,GAAG;CAAM;CAC9C,UAAU,CAAC,GAAG,UAAU,GAAG,MAAM;CACjC,MAAM;EAAC,GAAG;EAAU,GAAG;EAAO,GAAG;CAAM;AACxC;;AAGA,MAAa,wBAAwB,UAAkD;CACtF,QAAQ,OAAR;EACC,KAAK,UACJ,OAAO;EACR,KAAK,WACJ,OAAO;EACR,KAAK,QACJ,OAAO;EACR,KAAK,UACJ,OAAO;EACR,SACC,OAAO;CACT;AACD;AAqBA,MAAM,sBAAmE;CACxE,QAAQ;CACR,YAAY;CACZ,IAAI;CACJ,QAAQ;CACR,QAAQ;CACR,cAAc;CACd,oBAAoB;CACpB,WAAW;CACX,iBAAiB;CACjB,MAAM;CACN,UAAU;CACV,UAAU;AACX;;;;;;;;AASA,MAAa,oBAAoB,aAChC,oBAAoB,aAAa;;;;;AAMlC,MAAa,oBAAoB,SAChC,mBAAmB,MAAM,MAAM;;AAGhC,MAAa,sBAAsB,aAAuD;CACzF,IAAI,aAAa,UAChB,OAAO;CAER,IAAI,aAAa,QAAQ,aAAa,UACrC,OAAO;CAER,OAAO;AACR"}

package/dist/conditions/normalizeConditions.js

@@ -0,0 +1,47 @@
+import { conditionOperators } from "./fieldTypes.js";
+import { transformWhereQuery } from "payload/shared";
+//#region src/conditions/normalizeConditions.ts
+const isValidConstraint = (constraint, operandTypes) => {
+	if (constraint == null || typeof constraint !== "object") return false;
+	const field = Object.keys(constraint)[0];
+	if (!field) return false;
+	const type = operandTypes.get(field);
+	if (!type) return false;
+	const ops = constraint[field];
+	if (ops == null || typeof ops !== "object") return false;
+	const operator = Object.keys(ops)[0];
+	return Boolean(operator && conditionOperators[type].includes(operator));
+};
+const normalizeOne = (raw, operandTypes) => {
+	if (raw == null || typeof raw !== "object" || Object.keys(raw).length === 0) return;
+	const canonical = transformWhereQuery(raw);
+	const groups = (Array.isArray(canonical.or) ? canonical.or : Array.isArray(canonical.and) ? [{ and: canonical.and }] : []).map((group) => {
+		return (Array.isArray(group.and) ? group.and : []).filter((constraint) => isValidConstraint(constraint, operandTypes));
+	}).filter((group) => group.length > 0);
+	return groups.length > 0 ? { or: groups.map((and) => ({ and })) } : void 0;
+};
+/**
+* Normalize every field's `visibleWhen`/`validateWhen` against the form's own field list. Canonicalizes
+* to OR-of-ANDs and strips constraints whose operand field is missing or whose operator is invalid for
+* that field's condition type, so stored conditions always match what `evaluateCondition` can run.
+*/
+const normalizeFormConditions = (fields, conditionTypes) => {
+	const operandTypes = /* @__PURE__ */ new Map();
+	for (const row of fields) {
+		const name = typeof row.name === "string" ? row.name.trim() : "";
+		if (name.length > 0) operandTypes.set(name, conditionTypes[row.blockType] ?? "text");
+	}
+	return fields.map((row) => {
+		const visibleWhen = normalizeOne(row.visibleWhen, operandTypes);
+		const validateWhen = normalizeOne(row.validateWhen, operandTypes);
+		return {
+			...row,
+			visibleWhen,
+			validateWhen
+		};
+	});
+};
+//#endregion
+export { normalizeFormConditions };
+
+//# sourceMappingURL=normalizeConditions.js.map

package/dist/conditions/normalizeConditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeConditions.js","names":[],"sources":["../../src/conditions/normalizeConditions.ts"],"sourcesContent":["import type { Where } from 'payload'\nimport { transformWhereQuery } from 'payload/shared'\nimport type { ConditionFieldType } from './fieldTypes'\nimport { conditionOperators } from './fieldTypes'\n\nexport type FieldRow = {\n\tblockType: string\n\tname?: string\n\tvisibleWhen?: unknown\n\tvalidateWhen?: unknown\n\t[key: string]: unknown\n}\n\nconst isValidConstraint = (\n\tconstraint: unknown,\n\toperandTypes: Map<string, ConditionFieldType>\n): boolean => {\n\tif (constraint == null || typeof constraint !== 'object') {\n\t\treturn false\n\t}\n\tconst field = Object.keys(constraint as object)[0]\n\tif (!field) {\n\t\treturn false\n\t}\n\tconst type = operandTypes.get(field)\n\tif (!type) {\n\t\treturn false\n\t}\n\tconst ops = (constraint as Record<string, unknown>)[field]\n\tif (ops == null || typeof ops !== 'object') {\n\t\treturn false\n\t}\n\tconst operator = Object.keys(ops as object)[0]\n\treturn Boolean(operator && (conditionOperators[type] as readonly string[]).includes(operator))\n}\n\nconst normalizeOne = (\n\traw: unknown,\n\toperandTypes: Map<string, ConditionFieldType>\n): Where | undefined => {\n\tif (raw == null || typeof raw !== 'object' || Object.keys(raw as object).length === 0) {\n\t\treturn undefined\n\t}\n\tconst canonical = transformWhereQuery(raw as Where)\n\tconst or = Array.isArray(canonical.or)\n\t\t? canonical.or\n\t\t: Array.isArray(canonical.and)\n\t\t\t? [{ and: canonical.and }]\n\t\t\t: []\n\tconst groups = or\n\t\t.map((group) => {\n\t\t\tconst and = Array.isArray((group as Where).and) ? ((group as Where).and as unknown[]) : []\n\t\t\treturn and.filter((constraint) => isValidConstraint(constraint, operandTypes))\n\t\t})\n\t\t.filter((group) => group.length > 0)\n\treturn groups.length > 0 ? ({ or: groups.map((and) => ({ and })) } as Where) : undefined\n}\n\n/**\n * Normalize every field's `visibleWhen`/`validateWhen` against the form's own field list. Canonicalizes\n * to OR-of-ANDs and strips constraints whose operand field is missing or whose operator is invalid for\n * that field's condition type, so stored conditions always match what `evaluateCondition` can run.\n */\nexport const normalizeFormConditions = (\n\tfields: FieldRow[],\n\tconditionTypes: Record<string, ConditionFieldType>\n): FieldRow[] => {\n\tconst operandTypes = new Map<string, ConditionFieldType>()\n\tfor (const row of fields) {\n\t\tconst name = typeof row.name === 'string' ? row.name.trim() : ''\n\t\tif (name.length > 0) {\n\t\t\toperandTypes.set(name, conditionTypes[row.blockType] ?? 'text')\n\t\t}\n\t}\n\treturn fields.map((row) => {\n\t\tconst visibleWhen = normalizeOne(row.visibleWhen, operandTypes)\n\t\tconst validateWhen = normalizeOne(row.validateWhen, operandTypes)\n\t\treturn { ...row, visibleWhen, validateWhen }\n\t})\n}\n"],"mappings":";;;AAaA,MAAM,qBACL,YACA,iBACa;CACb,IAAI,cAAc,QAAQ,OAAO,eAAe,UAC/C,OAAO;CAER,MAAM,QAAQ,OAAO,KAAK,UAAoB,EAAE;CAChD,IAAI,CAAC,OACJ,OAAO;CAER,MAAM,OAAO,aAAa,IAAI,KAAK;CACnC,IAAI,CAAC,MACJ,OAAO;CAER,MAAM,MAAO,WAAuC;CACpD,IAAI,OAAO,QAAQ,OAAO,QAAQ,UACjC,OAAO;CAER,MAAM,WAAW,OAAO,KAAK,GAAa,EAAE;CAC5C,OAAO,QAAQ,YAAa,mBAAmB,MAA4B,SAAS,QAAQ,CAAC;AAC9F;AAEA,MAAM,gBACL,KACA,iBACuB;CACvB,IAAI,OAAO,QAAQ,OAAO,QAAQ,YAAY,OAAO,KAAK,GAAa,EAAE,WAAW,GACnF;CAED,MAAM,YAAY,oBAAoB,GAAY;CAMlD,MAAM,UALK,MAAM,QAAQ,UAAU,EAAE,IAClC,UAAU,KACV,MAAM,QAAQ,UAAU,GAAG,IAC1B,CAAC,EAAE,KAAK,UAAU,IAAI,CAAC,IACvB,CAAC,GAEH,KAAK,UAAU;EAEf,QADY,MAAM,QAAS,MAAgB,GAAG,IAAM,MAAgB,MAAoB,CAAC,GAC9E,QAAQ,eAAe,kBAAkB,YAAY,YAAY,CAAC;CAC9E,CAAC,EACA,QAAQ,UAAU,MAAM,SAAS,CAAC;CACpC,OAAO,OAAO,SAAS,IAAK,EAAE,IAAI,OAAO,KAAK,SAAS,EAAE,IAAI,EAAE,EAAE,IAAc,KAAA;AAChF;;;;;;AAOA,MAAa,2BACZ,QACA,mBACgB;CAChB,MAAM,+BAAe,IAAI,IAAgC;CACzD,KAAK,MAAM,OAAO,QAAQ;EACzB,MAAM,OAAO,OAAO,IAAI,SAAS,WAAW,IAAI,KAAK,KAAK,IAAI;EAC9D,IAAI,KAAK,SAAS,GACjB,aAAa,IAAI,MAAM,eAAe,IAAI,cAAc,MAAM;CAEhE;CACA,OAAO,OAAO,KAAK,QAAQ;EAC1B,MAAM,cAAc,aAAa,IAAI,aAAa,YAAY;EAC9D,MAAM,eAAe,aAAa,IAAI,cAAc,YAAY;EAChE,OAAO;GAAE,GAAG;GAAK;GAAa;EAAa;CAC5C,CAAC;AACF"}

package/dist/conditions/types.d.ts

@@ -0,0 +1,8 @@
+import { Where as Where$1 } from "payload";
+
+//#region src/conditions/types.d.ts
+/** A serializable field-visibility/validation condition, stored in Payload's canonical `Where` shape. */
+type FieldCondition = Where$1;
+//#endregion
+export { FieldCondition };
+//# sourceMappingURL=types.d.ts.map

package/dist/consent/buildConsentSourceConfig.js

@@ -0,0 +1,49 @@
+import { keys } from "../translations/keys.js";
+import { labelFor } from "../translations/server.js";
+//#region src/consent/buildConsentSourceConfig.ts
+/**
+* Builds the `source` select and `sourceConfig` group for the consent field block.
+* Fields inside `sourceConfig` are annotated with `admin.condition` so only the
+* fields that belong to the currently selected source type are visible in the admin UI.
+*
+* `resolveConsentLinks` reads `field.sourceConfig` as a flat object; field names within
+* that group must be unique across all registered sources. Built-in sources (static,
+* pageReference) have no overlapping names. Custom sources should follow the same rule.
+*/
+const buildConsentSourceConfig = (registry) => {
+	const sources = [...registry.values()];
+	const firstType = sources[0]?.type ?? "static";
+	const sourceConfigFields = sources.flatMap((source) => (source.config ?? []).map((field) => {
+		const existingAdmin = typeof field.admin === "object" && field.admin !== null ? field.admin : {};
+		return {
+			...field,
+			admin: {
+				...existingAdmin,
+				condition: (data) => data?.source === source.type
+			}
+		};
+	}));
+	return [{
+		name: "source",
+		type: "select",
+		defaultValue: firstType,
+		label: labelFor(keys.consentConfigSource),
+		options: sources.map((s) => ({
+			label: labelFor(s.label),
+			value: s.type
+		}))
+	}, {
+		name: "sourceConfig",
+		type: "group",
+		label: labelFor(keys.consentConfigSourceConfig),
+		fields: sourceConfigFields.length > 0 ? sourceConfigFields : [{
+			name: "_placeholder",
+			type: "text",
+			admin: { hidden: true }
+		}]
+	}];
+};
+//#endregion
+export { buildConsentSourceConfig };
+
+//# sourceMappingURL=buildConsentSourceConfig.js.map

package/dist/consent/buildConsentSourceConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildConsentSourceConfig.js","names":[],"sources":["../../src/consent/buildConsentSourceConfig.ts"],"sourcesContent":["import type { Field } from 'payload'\nimport { keys } from '../translations/keys'\nimport { labelFor } from '../translations/server'\nimport type { ConsentSourceRegistry } from './registry'\n\n/**\n * Builds the `source` select and `sourceConfig` group for the consent field block.\n * Fields inside `sourceConfig` are annotated with `admin.condition` so only the\n * fields that belong to the currently selected source type are visible in the admin UI.\n *\n * `resolveConsentLinks` reads `field.sourceConfig` as a flat object; field names within\n * that group must be unique across all registered sources. Built-in sources (static,\n * pageReference) have no overlapping names. Custom sources should follow the same rule.\n */\nexport const buildConsentSourceConfig = (registry: ConsentSourceRegistry): Field[] => {\n\tconst sources = [...registry.values()]\n\tconst firstType = sources[0]?.type ?? 'static'\n\n\tconst sourceConfigFields: Field[] = sources.flatMap((source) =>\n\t\t(source.config ?? []).map((field) => {\n\t\t\tconst existingAdmin =\n\t\t\t\ttypeof field.admin === 'object' && field.admin !== null ? field.admin : {}\n\t\t\treturn {\n\t\t\t\t...field,\n\t\t\t\tadmin: {\n\t\t\t\t\t...existingAdmin,\n\t\t\t\t\tcondition: (data: unknown) => (data as Record<string, unknown>)?.source === source.type,\n\t\t\t\t},\n\t\t\t} as Field\n\t\t})\n\t)\n\n\treturn [\n\t\t{\n\t\t\tname: 'source',\n\t\t\ttype: 'select',\n\t\t\tdefaultValue: firstType,\n\t\t\tlabel: labelFor(keys.consentConfigSource),\n\t\t\toptions: sources.map((s) => ({\n\t\t\t\tlabel: labelFor(s.label),\n\t\t\t\tvalue: s.type,\n\t\t\t})),\n\t\t},\n\t\t{\n\t\t\tname: 'sourceConfig',\n\t\t\ttype: 'group',\n\t\t\tlabel: labelFor(keys.consentConfigSourceConfig),\n\t\t\tfields:\n\t\t\t\tsourceConfigFields.length > 0\n\t\t\t\t\t? sourceConfigFields\n\t\t\t\t\t: [{ name: '_placeholder', type: 'text', admin: { hidden: true } }],\n\t\t},\n\t]\n}\n"],"mappings":";;;;;;;;;;;;AAcA,MAAa,4BAA4B,aAA6C;CACrF,MAAM,UAAU,CAAC,GAAG,SAAS,OAAO,CAAC;CACrC,MAAM,YAAY,QAAQ,IAAI,QAAQ;CAEtC,MAAM,qBAA8B,QAAQ,SAAS,YACnD,OAAO,UAAU,CAAC,GAAG,KAAK,UAAU;EACpC,MAAM,gBACL,OAAO,MAAM,UAAU,YAAY,MAAM,UAAU,OAAO,MAAM,QAAQ,CAAC;EAC1E,OAAO;GACN,GAAG;GACH,OAAO;IACN,GAAG;IACH,YAAY,SAAmB,MAAkC,WAAW,OAAO;GACpF;EACD;CACD,CAAC,CACF;CAEA,OAAO,CACN;EACC,MAAM;EACN,MAAM;EACN,cAAc;EACd,OAAO,SAAS,KAAK,mBAAmB;EACxC,SAAS,QAAQ,KAAK,OAAO;GAC5B,OAAO,SAAS,EAAE,KAAK;GACvB,OAAO,EAAE;EACV,EAAE;CACH,GACA;EACC,MAAM;EACN,MAAM;EACN,OAAO,SAAS,KAAK,yBAAyB;EAC9C,QACC,mBAAmB,SAAS,IACzB,qBACA,CAAC;GAAE,MAAM;GAAgB,MAAM;GAAQ,OAAO,EAAE,QAAQ,KAAK;EAAE,CAAC;CACrE,CACD;AACD"}

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

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

package/dist/consent/builtin/index.js

@@ -0,0 +1,11 @@
+import { pageReferenceSource } from "./pageReference.js";
+import { staticSource } from "./static.js";
+//#region src/consent/builtin/index.ts
+const defaultConsentSources = {
+	static: staticSource,
+	pageReference: pageReferenceSource
+};
+//#endregion
+export { defaultConsentSources };
+
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/consent/builtin/index.ts"],"sourcesContent":["import type { AnyConsentSource } from '../defineConsentSource'\nimport { pageReferenceSource } from './pageReference'\nimport { staticSource } from './static'\n\nexport const defaultConsentSources: Record<string, AnyConsentSource> = {\n\tstatic: staticSource as AnyConsentSource,\n\tpageReference: pageReferenceSource as AnyConsentSource,\n}\n"],"mappings":";;;AAIA,MAAa,wBAA0D;CACtE,QAAQ;CACR,eAAe;AAChB"}

package/dist/consent/builtin/pageReference.js

@@ -0,0 +1,75 @@
+import { keys } from "../../translations/keys.js";
+import { labelFor } from "../../translations/server.js";
+import { defineConsentSource } from "../defineConsentSource.js";
+import { resolvePublishedVersionRef } from "../resolvePublishedVersionRef.js";
+//#region src/consent/builtin/pageReference.ts
+const pageReferenceSource = defineConsentSource({
+	type: "pageReference",
+	label: keys.consentSourcePageReference,
+	config: [
+		{
+			name: "relationTo",
+			type: "text",
+			label: labelFor(keys.consentConfigRelationTo)
+		},
+		{
+			name: "docId",
+			type: "text",
+			label: labelFor(keys.consentConfigDocId)
+		},
+		{
+			name: "urlField",
+			type: "text",
+			label: labelFor(keys.consentConfigUrlField),
+			defaultValue: "slug"
+		},
+		{
+			name: "captureVersion",
+			type: "checkbox",
+			label: labelFor(keys.consentConfigCaptureVersion)
+		}
+	],
+	resolve: async ({ config, payload, req, locale }) => {
+		const relationTo = String(config.relationTo ?? "");
+		const docId = String(config.docId ?? "");
+		const urlField = String(config.urlField ?? "slug");
+		const captureVersion = Boolean(config.captureVersion);
+		if (!relationTo || !docId) return { links: [] };
+		const doc = await payload.findByID({
+			collection: relationTo,
+			id: docId,
+			depth: 0,
+			locale,
+			req
+		}).catch(() => null);
+		if (!doc) return { links: [{
+			label: relationTo,
+			url: ""
+		}] };
+		const docRecord = doc;
+		const label = String(docRecord.title ?? docRecord[urlField] ?? relationTo);
+		const url = String(docRecord[urlField] ?? "");
+		if (!captureVersion) return { links: [{
+			label,
+			url
+		}] };
+		const v = await resolvePublishedVersionRef(payload, {
+			collection: relationTo,
+			id: docId
+		});
+		return {
+			links: [{
+				label,
+				url
+			}],
+			...v ? {
+				versionRef: v.versionId,
+				versionLabel: v.updatedAt
+			} : {}
+		};
+	}
+});
+//#endregion
+export { pageReferenceSource };
+
+//# sourceMappingURL=pageReference.js.map

package/dist/consent/builtin/pageReference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageReference.js","names":[],"sources":["../../../src/consent/builtin/pageReference.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { defineConsentSource } from '../defineConsentSource'\nimport { resolvePublishedVersionRef } from '../resolvePublishedVersionRef'\n\ntype PageReferenceConfig = {\n\trelationTo?: string\n\tdocId?: string\n\turlField?: string\n\tcaptureVersion?: boolean\n}\n\nexport const pageReferenceSource = defineConsentSource<PageReferenceConfig>({\n\ttype: 'pageReference',\n\tlabel: keys.consentSourcePageReference,\n\tconfig: [\n\t\t{ name: 'relationTo', type: 'text', label: labelFor(keys.consentConfigRelationTo) },\n\t\t{ name: 'docId', type: 'text', label: labelFor(keys.consentConfigDocId) },\n\t\t{\n\t\t\tname: 'urlField',\n\t\t\ttype: 'text',\n\t\t\tlabel: labelFor(keys.consentConfigUrlField),\n\t\t\tdefaultValue: 'slug',\n\t\t},\n\t\t{\n\t\t\tname: 'captureVersion',\n\t\t\ttype: 'checkbox',\n\t\t\tlabel: labelFor(keys.consentConfigCaptureVersion),\n\t\t},\n\t],\n\tresolve: async ({ config, payload, req, locale }) => {\n\t\tconst relationTo = String(config.relationTo ?? '')\n\t\tconst docId = String(config.docId ?? '')\n\t\tconst urlField = String(config.urlField ?? 'slug')\n\t\tconst captureVersion = Boolean(config.captureVersion)\n\n\t\tif (!relationTo || !docId) {\n\t\t\treturn { links: [] }\n\t\t}\n\n\t\tconst doc = await payload\n\t\t\t.findByID({\n\t\t\t\tcollection: relationTo as never,\n\t\t\t\tid: docId,\n\t\t\t\tdepth: 0,\n\t\t\t\tlocale: locale as never,\n\t\t\t\treq,\n\t\t\t})\n\t\t\t.catch(() => null)\n\n\t\tif (!doc) {\n\t\t\treturn { links: [{ label: relationTo, url: '' }] }\n\t\t}\n\n\t\tconst docRecord = doc as Record<string, unknown>\n\t\tconst label = String(docRecord.title ?? docRecord[urlField] ?? relationTo)\n\t\tconst url = String(docRecord[urlField] ?? '')\n\n\t\tif (!captureVersion) {\n\t\t\treturn { links: [{ label, url }] }\n\t\t}\n\n\t\tconst v = await resolvePublishedVersionRef(payload, { collection: relationTo, id: docId })\n\t\treturn {\n\t\t\tlinks: [{ label, url }],\n\t\t\t...(v ? { versionRef: v.versionId, versionLabel: v.updatedAt } : {}),\n\t\t}\n\t},\n})\n"],"mappings":";;;;;AAYA,MAAa,sBAAsB,oBAAyC;CAC3E,MAAM;CACN,OAAO,KAAK;CACZ,QAAQ;EACP;GAAE,MAAM;GAAc,MAAM;GAAQ,OAAO,SAAS,KAAK,uBAAuB;EAAE;EAClF;GAAE,MAAM;GAAS,MAAM;GAAQ,OAAO,SAAS,KAAK,kBAAkB;EAAE;EACxE;GACC,MAAM;GACN,MAAM;GACN,OAAO,SAAS,KAAK,qBAAqB;GAC1C,cAAc;EACf;EACA;GACC,MAAM;GACN,MAAM;GACN,OAAO,SAAS,KAAK,2BAA2B;EACjD;CACD;CACA,SAAS,OAAO,EAAE,QAAQ,SAAS,KAAK,aAAa;EACpD,MAAM,aAAa,OAAO,OAAO,cAAc,EAAE;EACjD,MAAM,QAAQ,OAAO,OAAO,SAAS,EAAE;EACvC,MAAM,WAAW,OAAO,OAAO,YAAY,MAAM;EACjD,MAAM,iBAAiB,QAAQ,OAAO,cAAc;EAEpD,IAAI,CAAC,cAAc,CAAC,OACnB,OAAO,EAAE,OAAO,CAAC,EAAE;EAGpB,MAAM,MAAM,MAAM,QAChB,SAAS;GACT,YAAY;GACZ,IAAI;GACJ,OAAO;GACC;GACR;EACD,CAAC,EACA,YAAY,IAAI;EAElB,IAAI,CAAC,KACJ,OAAO,EAAE,OAAO,CAAC;GAAE,OAAO;GAAY,KAAK;EAAG,CAAC,EAAE;EAGlD,MAAM,YAAY;EAClB,MAAM,QAAQ,OAAO,UAAU,SAAS,UAAU,aAAa,UAAU;EACzE,MAAM,MAAM,OAAO,UAAU,aAAa,EAAE;EAE5C,IAAI,CAAC,gBACJ,OAAO,EAAE,OAAO,CAAC;GAAE;GAAO;EAAI,CAAC,EAAE;EAGlC,MAAM,IAAI,MAAM,2BAA2B,SAAS;GAAE,YAAY;GAAY,IAAI;EAAM,CAAC;EACzF,OAAO;GACN,OAAO,CAAC;IAAE;IAAO;GAAI,CAAC;GACtB,GAAI,IAAI;IAAE,YAAY,EAAE;IAAW,cAAc,EAAE;GAAU,IAAI,CAAC;EACnE;CACD;AACD,CAAC"}

package/dist/consent/builtin/static.js

@@ -0,0 +1,44 @@
+import { keys } from "../../translations/keys.js";
+import { labelFor } from "../../translations/server.js";
+import { defineConsentSource } from "../defineConsentSource.js";
+//#region src/consent/builtin/static.ts
+const staticSource = defineConsentSource({
+	type: "static",
+	label: keys.consentSourceStatic,
+	config: [
+		{
+			name: "label",
+			type: "text",
+			label: labelFor(keys.consentConfigLabel)
+		},
+		{
+			name: "url",
+			type: "text",
+			label: labelFor(keys.consentConfigUrl)
+		},
+		{
+			name: "version",
+			type: "text",
+			label: labelFor(keys.consentConfigVersion)
+		}
+	],
+	resolve({ config }) {
+		const label = String(config.label ?? "");
+		const url = String(config.url ?? "");
+		const version = config.version ? String(config.version) : void 0;
+		return {
+			links: [{
+				label,
+				url
+			}],
+			...version ? {
+				versionRef: version,
+				versionLabel: version
+			} : {}
+		};
+	}
+});
+//#endregion
+export { staticSource };
+
+//# sourceMappingURL=static.js.map

package/dist/consent/builtin/static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.js","names":[],"sources":["../../../src/consent/builtin/static.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { defineConsentSource } from '../defineConsentSource'\n\ntype StaticConfig = { label?: string; url?: string; version?: string }\n\nexport const staticSource = defineConsentSource<StaticConfig>({\n\ttype: 'static',\n\tlabel: keys.consentSourceStatic,\n\tconfig: [\n\t\t{ name: 'label', type: 'text', label: labelFor(keys.consentConfigLabel) },\n\t\t{ name: 'url', type: 'text', label: labelFor(keys.consentConfigUrl) },\n\t\t{ name: 'version', type: 'text', label: labelFor(keys.consentConfigVersion) },\n\t],\n\tresolve({ config }) {\n\t\tconst label = String(config.label ?? '')\n\t\tconst url = String(config.url ?? '')\n\t\tconst version = config.version ? String(config.version) : undefined\n\t\treturn {\n\t\t\tlinks: [{ label, url }],\n\t\t\t...(version ? { versionRef: version, versionLabel: version } : {}),\n\t\t}\n\t},\n})\n"],"mappings":";;;;AAMA,MAAa,eAAe,oBAAkC;CAC7D,MAAM;CACN,OAAO,KAAK;CACZ,QAAQ;EACP;GAAE,MAAM;GAAS,MAAM;GAAQ,OAAO,SAAS,KAAK,kBAAkB;EAAE;EACxE;GAAE,MAAM;GAAO,MAAM;GAAQ,OAAO,SAAS,KAAK,gBAAgB;EAAE;EACpE;GAAE,MAAM;GAAW,MAAM;GAAQ,OAAO,SAAS,KAAK,oBAAoB;EAAE;CAC7E;CACA,QAAQ,EAAE,UAAU;EACnB,MAAM,QAAQ,OAAO,OAAO,SAAS,EAAE;EACvC,MAAM,MAAM,OAAO,OAAO,OAAO,EAAE;EACnC,MAAM,UAAU,OAAO,UAAU,OAAO,OAAO,OAAO,IAAI,KAAA;EAC1D,OAAO;GACN,OAAO,CAAC;IAAE;IAAO;GAAI,CAAC;GACtB,GAAI,UAAU;IAAE,YAAY;IAAS,cAAc;GAAQ,IAAI,CAAC;EACjE;CACD;AACD,CAAC"}

package/dist/consent/captureConsent.d.ts

@@ -0,0 +1,28 @@
+import { FormFieldInstance } from "../submissions/types.js";
+import { ConsentSourceRegistry } from "./registry.js";
+import { Payload, PayloadRequest } from "payload";
+
+//#region src/consent/captureConsent.d.ts
+type ConsentProof = {
+  agreed: boolean;
+  ref?: string;
+  versionRef?: string;
+  at: string;
+};
+/**
+ * Build the authoritative consent proof at submit time: re-resolve the source server-side
+ * (ignores any client ref), capturing a reference url -- never the policy text.
+ * `now` is injected by the caller (`new Date().toISOString()`) for testability.
+ */
+declare const captureConsent: (args: {
+  field: FormFieldInstance;
+  agreed: boolean;
+  registry: ConsentSourceRegistry;
+  payload: Payload;
+  req?: PayloadRequest;
+  locale: string;
+  now: string;
+}) => Promise<ConsentProof>;
+//#endregion
+export { ConsentProof, captureConsent };
+//# sourceMappingURL=captureConsent.d.ts.map

package/dist/consent/captureConsent.js

@@ -0,0 +1,26 @@
+import { resolveConsentLinks } from "./resolveConsentLinks.js";
+//#region src/consent/captureConsent.ts
+/**
+* Build the authoritative consent proof at submit time: re-resolve the source server-side
+* (ignores any client ref), capturing a reference url -- never the policy text.
+* `now` is injected by the caller (`new Date().toISOString()`) for testability.
+*/
+const captureConsent = async (args) => {
+	const resolved = await resolveConsentLinks(args.field, {
+		registry: args.registry,
+		payload: args.payload,
+		req: args.req,
+		locale: args.locale
+	});
+	const ref = resolved.links[0]?.url || void 0;
+	return {
+		agreed: args.agreed,
+		...ref ? { ref } : {},
+		...resolved.versionRef ? { versionRef: resolved.versionRef } : {},
+		at: args.now
+	};
+};
+//#endregion
+export { captureConsent };
+
+//# sourceMappingURL=captureConsent.js.map

package/dist/consent/captureConsent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureConsent.js","names":[],"sources":["../../src/consent/captureConsent.ts"],"sourcesContent":["import type { Payload, PayloadRequest } from 'payload'\nimport type { FormFieldInstance } from '../submissions/types'\nimport type { ConsentSourceRegistry } from './registry'\nimport { resolveConsentLinks } from './resolveConsentLinks'\n\nexport type ConsentProof = {\n\tagreed: boolean\n\tref?: string\n\tversionRef?: string\n\tat: string\n}\n\n/**\n * Build the authoritative consent proof at submit time: re-resolve the source server-side\n * (ignores any client ref), capturing a reference url -- never the policy text.\n * `now` is injected by the caller (`new Date().toISOString()`) for testability.\n */\nexport const captureConsent = async (args: {\n\tfield: FormFieldInstance\n\tagreed: boolean\n\tregistry: ConsentSourceRegistry\n\tpayload: Payload\n\treq?: PayloadRequest\n\tlocale: string\n\tnow: string\n}): Promise<ConsentProof> => {\n\tconst resolved = await resolveConsentLinks(args.field, {\n\t\tregistry: args.registry,\n\t\tpayload: args.payload,\n\t\treq: args.req,\n\t\tlocale: args.locale,\n\t})\n\tconst ref = resolved.links[0]?.url || undefined\n\treturn {\n\t\tagreed: args.agreed,\n\t\t...(ref ? { ref } : {}),\n\t\t...(resolved.versionRef ? { versionRef: resolved.versionRef } : {}),\n\t\tat: args.now,\n\t}\n}\n"],"mappings":";;;;;;;AAiBA,MAAa,iBAAiB,OAAO,SAQR;CAC5B,MAAM,WAAW,MAAM,oBAAoB,KAAK,OAAO;EACtD,UAAU,KAAK;EACf,SAAS,KAAK;EACd,KAAK,KAAK;EACV,QAAQ,KAAK;CACd,CAAC;CACD,MAAM,MAAM,SAAS,MAAM,IAAI,OAAO,KAAA;CACtC,OAAO;EACN,QAAQ,KAAK;EACb,GAAI,MAAM,EAAE,IAAI,IAAI,CAAC;EACrB,GAAI,SAAS,aAAa,EAAE,YAAY,SAAS,WAAW,IAAI,CAAC;EACjE,IAAI,KAAK;CACV;AACD"}

package/dist/consent/defineConsentSource.d.ts

@@ -0,0 +1,35 @@
+import { Field, Payload, PayloadRequest } from "payload";
+
+//#region src/consent/defineConsentSource.d.ts
+type ConsentLink = {
+  label: string;
+  url: string;
+};
+type ConsentResolved = {
+  links: ConsentLink[];
+  versionRef?: string;
+  versionLabel?: string;
+};
+type ConsentResolveArgs<TConfig extends Record<string, unknown> = Record<string, unknown>> = {
+  config: TConfig;
+  payload: Payload;
+  req?: PayloadRequest;
+  locale: string;
+};
+/**
+ * A consent source type, authored once: `config` is the admin `Field[]` for authoring;
+ * `resolve` returns localized policy links and an optional version reference at capture time.
+ * Built-ins use this same primitive.
+ */
+type ConsentSource<TConfig extends Record<string, unknown> = Record<string, unknown>> = {
+  type: string;
+  label: string;
+  config?: Field[];
+  resolve: (args: ConsentResolveArgs<TConfig>) => Promise<ConsentResolved> | ConsentResolved;
+};
+/** Erased shape stored in the registry; config re-narrows per matched type at resolution. */
+type AnyConsentSource = ConsentSource<Record<string, unknown>>;
+declare const defineConsentSource: <TConfig extends Record<string, unknown> = Record<string, unknown>>(source: ConsentSource<TConfig>) => ConsentSource<TConfig>;
+//#endregion
+export { AnyConsentSource, ConsentLink, ConsentResolveArgs, ConsentResolved, ConsentSource, defineConsentSource };
+//# sourceMappingURL=defineConsentSource.d.ts.map

package/dist/consent/defineConsentSource.js

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

package/dist/consent/defineConsentSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineConsentSource.js","names":[],"sources":["../../src/consent/defineConsentSource.ts"],"sourcesContent":["import type { Field, Payload, PayloadRequest } from 'payload'\n\nexport type ConsentLink = { label: string; url: string }\nexport type ConsentResolved = { links: ConsentLink[]; versionRef?: string; versionLabel?: string }\n\nexport type ConsentResolveArgs<TConfig extends Record<string, unknown> = Record<string, unknown>> =\n\t{\n\t\tconfig: TConfig\n\t\tpayload: Payload\n\t\treq?: PayloadRequest\n\t\tlocale: string\n\t}\n\n/**\n * A consent source type, authored once: `config` is the admin `Field[]` for authoring;\n * `resolve` returns localized policy links and an optional version reference at capture time.\n * Built-ins use this same primitive.\n */\nexport type ConsentSource<TConfig extends Record<string, unknown> = Record<string, unknown>> = {\n\ttype: string\n\tlabel: string\n\tconfig?: Field[]\n\tresolve: (args: ConsentResolveArgs<TConfig>) => Promise<ConsentResolved> | ConsentResolved\n}\n\n/** Erased shape stored in the registry; config re-narrows per matched type at resolution. */\nexport type AnyConsentSource = ConsentSource<Record<string, unknown>>\n\nexport const defineConsentSource = <\n\tTConfig extends Record<string, unknown> = Record<string, unknown>,\n>(\n\tsource: ConsentSource<TConfig>\n): ConsentSource<TConfig> => source\n"],"mappings":";AA4BA,MAAa,uBAGZ,WAC4B"}

package/dist/consent/registry.d.ts

@@ -0,0 +1,16 @@
+import { AnyConsentSource } from "./defineConsentSource.js";
+
+//#region src/consent/registry.d.ts
+type ConsentSourceRegistry = Map<string, AnyConsentSource>;
+/** `false` removes a built-in, `true` keeps it, a definition adds or replaces one. */
+type ConsentSourceOption = boolean | AnyConsentSource;
+type ConsentSourcesConfig = Record<string, ConsentSourceOption>;
+/**
+ * Resolve the active consent-source 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 action and field-type registry convention.
+ */
+declare const resolveConsentSources: (defaults: Record<string, AnyConsentSource>, config?: ConsentSourcesConfig) => ConsentSourceRegistry;
+//#endregion
+export { ConsentSourceOption, ConsentSourceRegistry, ConsentSourcesConfig, resolveConsentSources };
+//# sourceMappingURL=registry.d.ts.map

package/dist/consent/registry.js

@@ -0,0 +1,16 @@
+//#region src/consent/registry.ts
+/**
+* Resolve the active consent-source 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 action and field-type registry convention.
+*/
+const resolveConsentSources = (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 { resolveConsentSources };
+
+//# sourceMappingURL=registry.js.map

package/dist/consent/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../src/consent/registry.ts"],"sourcesContent":["import type { AnyConsentSource } from './defineConsentSource'\n\nexport type ConsentSourceRegistry = Map<string, AnyConsentSource>\n\n/** `false` removes a built-in, `true` keeps it, a definition adds or replaces one. */\nexport type ConsentSourceOption = boolean | AnyConsentSource\n\nexport type ConsentSourcesConfig = Record<string, ConsentSourceOption>\n\n/**\n * Resolve the active consent-source registry from built-in defaults and a consumer override map.\n * `false` removes a type, `true` keeps the default (no-op when none exists), a definition adds or\n * replaces. Mirrors the action and field-type registry convention.\n */\nexport const resolveConsentSources = (\n\tdefaults: Record<string, AnyConsentSource>,\n\tconfig: ConsentSourcesConfig = {}\n): ConsentSourceRegistry => {\n\tconst registry: ConsentSourceRegistry = 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,yBACZ,UACA,SAA+B,CAAC,MACL;CAC3B,MAAM,WAAkC,IAAI,IAAI,OAAO,QAAQ,QAAQ,CAAC;CACxE,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/consent/resolveConsentLinks.d.ts

@@ -0,0 +1,19 @@
+import { FormFieldInstance } from "../submissions/types.js";
+import { ConsentResolved } from "./defineConsentSource.js";
+import { ConsentSourceRegistry } from "./registry.js";
+import { Payload, PayloadRequest } from "payload";
+
+//#region src/consent/resolveConsentLinks.d.ts
+/**
+ * Resolve a consent field's policy links via its configured source (for display).
+ * Unknown/missing source returns empty links. Never throws.
+ */
+declare const resolveConsentLinks: (field: FormFieldInstance, ctx: {
+  registry: ConsentSourceRegistry;
+  payload: Payload;
+  req?: PayloadRequest;
+  locale: string;
+}) => Promise<ConsentResolved>;
+//#endregion
+export { resolveConsentLinks };
+//# sourceMappingURL=resolveConsentLinks.d.ts.map

package/dist/consent/resolveConsentLinks.js

@@ -0,0 +1,26 @@
+//#region src/consent/resolveConsentLinks.ts
+const EMPTY = { links: [] };
+/**
+* Resolve a consent field's policy links via its configured source (for display).
+* Unknown/missing source returns empty links. Never throws.
+*/
+const resolveConsentLinks = async (field, ctx) => {
+	const sourceType = typeof field.source === "string" ? field.source : "static";
+	const source = ctx.registry.get(sourceType);
+	if (!source) return EMPTY;
+	const sourceConfig = field.sourceConfig && typeof field.sourceConfig === "object" ? field.sourceConfig : {};
+	try {
+		return await source.resolve({
+			config: sourceConfig,
+			payload: ctx.payload,
+			req: ctx.req,
+			locale: ctx.locale
+		});
+	} catch {
+		return EMPTY;
+	}
+};
+//#endregion
+export { resolveConsentLinks };
+
+//# sourceMappingURL=resolveConsentLinks.js.map

package/dist/consent/resolveConsentLinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveConsentLinks.js","names":[],"sources":["../../src/consent/resolveConsentLinks.ts"],"sourcesContent":["import type { Payload, PayloadRequest } from 'payload'\nimport type { FormFieldInstance } from '../submissions/types'\nimport type { ConsentResolved } from './defineConsentSource'\nimport type { ConsentSourceRegistry } from './registry'\n\nconst EMPTY: ConsentResolved = { links: [] }\n\n/**\n * Resolve a consent field's policy links via its configured source (for display).\n * Unknown/missing source returns empty links. Never throws.\n */\nexport const resolveConsentLinks = async (\n\tfield: FormFieldInstance,\n\tctx: {\n\t\tregistry: ConsentSourceRegistry\n\t\tpayload: Payload\n\t\treq?: PayloadRequest\n\t\tlocale: string\n\t}\n): Promise<ConsentResolved> => {\n\tconst sourceType = typeof field.source === 'string' ? field.source : 'static'\n\tconst source = ctx.registry.get(sourceType)\n\tif (!source) {\n\t\treturn EMPTY\n\t}\n\t// The source params live in the field's `sourceConfig` group (kept off the top level so they cannot collide with the shared field config).\n\tconst sourceConfig =\n\t\tfield.sourceConfig && typeof field.sourceConfig === 'object'\n\t\t\t? (field.sourceConfig as Record<string, unknown>)\n\t\t\t: {}\n\ttry {\n\t\treturn await source.resolve({\n\t\t\tconfig: sourceConfig,\n\t\t\tpayload: ctx.payload,\n\t\t\treq: ctx.req,\n\t\t\tlocale: ctx.locale,\n\t\t})\n\t} catch {\n\t\treturn EMPTY\n\t}\n}\n"],"mappings":";AAKA,MAAM,QAAyB,EAAE,OAAO,CAAC,EAAE;;;;;AAM3C,MAAa,sBAAsB,OAClC,OACA,QAM8B;CAC9B,MAAM,aAAa,OAAO,MAAM,WAAW,WAAW,MAAM,SAAS;CACrE,MAAM,SAAS,IAAI,SAAS,IAAI,UAAU;CAC1C,IAAI,CAAC,QACJ,OAAO;CAGR,MAAM,eACL,MAAM,gBAAgB,OAAO,MAAM,iBAAiB,WAChD,MAAM,eACP,CAAC;CACL,IAAI;EACH,OAAO,MAAM,OAAO,QAAQ;GAC3B,QAAQ;GACR,SAAS,IAAI;GACb,KAAK,IAAI;GACT,QAAQ,IAAI;EACb,CAAC;CACF,QAAQ;EACP,OAAO;CACR;AACD"}

package/dist/consent/resolvePublishedVersionRef.d.ts

@@ -0,0 +1,17 @@
+import { Payload } from "payload";
+
+//#region src/consent/resolvePublishedVersionRef.d.ts
+/**
+ * Returns the latest published version of a doc, or null when versions/drafts are off or nothing
+ * is published. Never throws.
+ */
+declare const resolvePublishedVersionRef: (payload: Payload, args: {
+  collection: string;
+  id: string | number;
+}) => Promise<{
+  versionId: string;
+  updatedAt: string;
+} | null>;
+//#endregion
+export { resolvePublishedVersionRef };
+//# sourceMappingURL=resolvePublishedVersionRef.d.ts.map

package/dist/consent/resolvePublishedVersionRef.js

@@ -0,0 +1,27 @@
+//#region src/consent/resolvePublishedVersionRef.ts
+/**
+* Returns the latest published version of a doc, or null when versions/drafts are off or nothing
+* is published. Never throws.
+*/
+const resolvePublishedVersionRef = async (payload, args) => {
+	try {
+		const doc = (await payload.findVersions({
+			collection: args.collection,
+			where: { and: [{ parent: { equals: args.id } }, { "version._status": { equals: "published" } }] },
+			sort: "-updatedAt",
+			limit: 1,
+			depth: 0
+		}))?.docs?.[0];
+		if (!doc) return null;
+		return {
+			versionId: String(doc.id),
+			updatedAt: String(doc.updatedAt)
+		};
+	} catch {
+		return null;
+	}
+};
+//#endregion
+export { resolvePublishedVersionRef };
+
+//# sourceMappingURL=resolvePublishedVersionRef.js.map

package/dist/consent/resolvePublishedVersionRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePublishedVersionRef.js","names":[],"sources":["../../src/consent/resolvePublishedVersionRef.ts"],"sourcesContent":["import type { Payload } from 'payload'\n\n/**\n * Returns the latest published version of a doc, or null when versions/drafts are off or nothing\n * is published. Never throws.\n */\nexport const resolvePublishedVersionRef = async (\n\tpayload: Payload,\n\targs: { collection: string; id: string | number }\n): Promise<{ versionId: string; updatedAt: string } | null> => {\n\ttry {\n\t\tconst result = await payload.findVersions({\n\t\t\tcollection: args.collection as never,\n\t\t\twhere: {\n\t\t\t\tand: [{ parent: { equals: args.id } }, { 'version._status': { equals: 'published' } }],\n\t\t\t},\n\t\t\tsort: '-updatedAt',\n\t\t\tlimit: 1,\n\t\t\tdepth: 0,\n\t\t})\n\t\tconst doc = result?.docs?.[0]\n\t\tif (!doc) {\n\t\t\treturn null\n\t\t}\n\t\treturn { versionId: String(doc.id), updatedAt: String(doc.updatedAt) }\n\t} catch {\n\t\treturn null\n\t}\n}\n"],"mappings":";;;;;AAMA,MAAa,6BAA6B,OACzC,SACA,SAC8D;CAC9D,IAAI;EAUH,MAAM,OAAM,MATS,QAAQ,aAAa;GACzC,YAAY,KAAK;GACjB,OAAO,EACN,KAAK,CAAC,EAAE,QAAQ,EAAE,QAAQ,KAAK,GAAG,EAAE,GAAG,EAAE,mBAAmB,EAAE,QAAQ,YAAY,EAAE,CAAC,EACtF;GACA,MAAM;GACN,OAAO;GACP,OAAO;EACR,CAAC,IACmB,OAAO;EAC3B,IAAI,CAAC,KACJ,OAAO;EAER,OAAO;GAAE,WAAW,OAAO,IAAI,EAAE;GAAG,WAAW,OAAO,IAAI,SAAS;EAAE;CACtE,QAAQ;EACP,OAAO;CACR;AACD"}

package/dist/events/noopSink.js

@@ -0,0 +1,6 @@
+//#region src/events/noopSink.ts
+const noopEventSink = { emit: () => Promise.resolve() };
+//#endregion
+export { noopEventSink };
+
+//# sourceMappingURL=noopSink.js.map

package/dist/events/noopSink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noopSink.js","names":[],"sources":["../../src/events/noopSink.ts"],"sourcesContent":["import type { FormEventSink } from './types'\n\nexport const noopEventSink: FormEventSink = {\n\temit: () => Promise.resolve(),\n}\n"],"mappings":";AAEA,MAAa,gBAA+B,EAC3C,YAAY,QAAQ,QAAQ,EAC7B"}

package/dist/events/resolveEventSink.js

@@ -0,0 +1,8 @@
+import { noopEventSink } from "./noopSink.js";
+//#region src/events/resolveEventSink.ts
+/** Resolves the configured event sink, falling back to the no-op sink. Consumed by the submission pipeline in a later phase. */
+const resolveEventSink = (sink) => sink ?? noopEventSink;
+//#endregion
+export { resolveEventSink };
+
+//# sourceMappingURL=resolveEventSink.js.map