@endora-commerce/contracts 0.108.0 → 0.110.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (309) hide show
  1. package/dist/actor.d.ts +16 -0
  2. package/dist/actor.d.ts.map +1 -1
  3. package/dist/addresses.d.ts +35 -0
  4. package/dist/addresses.d.ts.map +1 -1
  5. package/dist/addresses.js +8 -1
  6. package/dist/addresses.js.map +1 -1
  7. package/dist/admin-actions.d.ts +12 -3
  8. package/dist/admin-actions.d.ts.map +1 -1
  9. package/dist/admin-actions.js +34 -3
  10. package/dist/admin-actions.js.map +1 -1
  11. package/dist/admin-contributions.d.ts +94 -10
  12. package/dist/admin-contributions.d.ts.map +1 -1
  13. package/dist/admin-contributions.js +65 -0
  14. package/dist/admin-contributions.js.map +1 -1
  15. package/dist/admin-notifications.d.ts +17 -1
  16. package/dist/admin-notifications.d.ts.map +1 -1
  17. package/dist/admin-preferences.d.ts +108 -0
  18. package/dist/admin-preferences.d.ts.map +1 -0
  19. package/dist/admin-preferences.js +133 -0
  20. package/dist/admin-preferences.js.map +1 -0
  21. package/dist/admin-roles.d.ts +8 -2
  22. package/dist/admin-roles.d.ts.map +1 -1
  23. package/dist/admin-roles.js.map +1 -1
  24. package/dist/admin-users.d.ts +9 -0
  25. package/dist/admin-users.d.ts.map +1 -1
  26. package/dist/admin.d.ts +92 -5
  27. package/dist/admin.d.ts.map +1 -1
  28. package/dist/admin.js +86 -3
  29. package/dist/admin.js.map +1 -1
  30. package/dist/assets-library.d.ts +123 -3
  31. package/dist/assets-library.d.ts.map +1 -1
  32. package/dist/assets-library.js +11 -3
  33. package/dist/assets-library.js.map +1 -1
  34. package/dist/audit-logs.d.ts +12 -0
  35. package/dist/audit-logs.d.ts.map +1 -1
  36. package/dist/audit-logs.js +12 -0
  37. package/dist/audit-logs.js.map +1 -1
  38. package/dist/blog.d.ts +431 -14
  39. package/dist/blog.d.ts.map +1 -1
  40. package/dist/blog.js +251 -7
  41. package/dist/blog.js.map +1 -1
  42. package/dist/carts.d.ts +507 -92
  43. package/dist/carts.d.ts.map +1 -1
  44. package/dist/carts.js +197 -21
  45. package/dist/carts.js.map +1 -1
  46. package/dist/catalog.d.ts +515 -144
  47. package/dist/catalog.d.ts.map +1 -1
  48. package/dist/catalog.js +356 -68
  49. package/dist/catalog.js.map +1 -1
  50. package/dist/cms-brand.d.ts +2233 -0
  51. package/dist/cms-brand.d.ts.map +1 -0
  52. package/dist/cms-brand.js +311 -0
  53. package/dist/cms-brand.js.map +1 -0
  54. package/dist/cms-contact-form.d.ts +55 -0
  55. package/dist/cms-contact-form.d.ts.map +1 -0
  56. package/dist/cms-contact-form.js +100 -0
  57. package/dist/cms-contact-form.js.map +1 -0
  58. package/dist/cms.d.ts +576 -17
  59. package/dist/cms.d.ts.map +1 -1
  60. package/dist/cms.js +251 -0
  61. package/dist/cms.js.map +1 -1
  62. package/dist/common.d.ts +23 -6
  63. package/dist/common.d.ts.map +1 -1
  64. package/dist/common.js +25 -2
  65. package/dist/common.js.map +1 -1
  66. package/dist/comparisons.d.ts +28 -21
  67. package/dist/comparisons.d.ts.map +1 -1
  68. package/dist/comparisons.js +2 -1
  69. package/dist/comparisons.js.map +1 -1
  70. package/dist/credit-limits.d.ts +1 -0
  71. package/dist/credit-limits.d.ts.map +1 -1
  72. package/dist/credit-limits.js +14 -0
  73. package/dist/credit-limits.js.map +1 -1
  74. package/dist/crm-rich-text.d.ts +10 -61
  75. package/dist/crm-rich-text.d.ts.map +1 -1
  76. package/dist/crm-rich-text.js +10 -300
  77. package/dist/crm-rich-text.js.map +1 -1
  78. package/dist/crm.d.ts +173 -115
  79. package/dist/crm.d.ts.map +1 -1
  80. package/dist/crm.js +35 -88
  81. package/dist/crm.js.map +1 -1
  82. package/dist/custom-fields.d.ts +54 -22
  83. package/dist/custom-fields.d.ts.map +1 -1
  84. package/dist/custom-fields.js +21 -1
  85. package/dist/custom-fields.js.map +1 -1
  86. package/dist/customer-accounts.d.ts +216 -22
  87. package/dist/customer-accounts.d.ts.map +1 -1
  88. package/dist/customer-accounts.js +70 -0
  89. package/dist/customer-accounts.js.map +1 -1
  90. package/dist/customers.d.ts +40 -73
  91. package/dist/customers.d.ts.map +1 -1
  92. package/dist/customers.js +45 -10
  93. package/dist/customers.js.map +1 -1
  94. package/dist/document-templates.d.ts +35 -23
  95. package/dist/document-templates.d.ts.map +1 -1
  96. package/dist/document-values.d.ts +8 -0
  97. package/dist/document-values.d.ts.map +1 -1
  98. package/dist/document-values.js +24 -6
  99. package/dist/document-values.js.map +1 -1
  100. package/dist/email.d.ts +5 -0
  101. package/dist/email.d.ts.map +1 -1
  102. package/dist/errors.d.ts +224 -1
  103. package/dist/errors.d.ts.map +1 -1
  104. package/dist/errors.js +269 -1
  105. package/dist/errors.js.map +1 -1
  106. package/dist/forms-logic.d.ts +79 -0
  107. package/dist/forms-logic.d.ts.map +1 -0
  108. package/dist/forms-logic.fixtures.d.ts +52 -0
  109. package/dist/forms-logic.fixtures.d.ts.map +1 -0
  110. package/dist/forms-logic.fixtures.js +610 -0
  111. package/dist/forms-logic.fixtures.js.map +1 -0
  112. package/dist/forms-logic.js +699 -0
  113. package/dist/forms-logic.js.map +1 -0
  114. package/dist/forms.d.ts +9833 -0
  115. package/dist/forms.d.ts.map +1 -0
  116. package/dist/forms.js +827 -0
  117. package/dist/forms.js.map +1 -0
  118. package/dist/import-export.d.ts +180 -0
  119. package/dist/import-export.d.ts.map +1 -1
  120. package/dist/import-export.js +60 -0
  121. package/dist/import-export.js.map +1 -1
  122. package/dist/index.d.ts +22 -1
  123. package/dist/index.d.ts.map +1 -1
  124. package/dist/index.js +45 -1
  125. package/dist/index.js.map +1 -1
  126. package/dist/inventory.d.ts +6 -6
  127. package/dist/invoice-ledger.d.ts +7 -7
  128. package/dist/invoices.d.ts +6 -2
  129. package/dist/invoices.d.ts.map +1 -1
  130. package/dist/invoices.js +7 -0
  131. package/dist/invoices.js.map +1 -1
  132. package/dist/megamenu.d.ts +674 -0
  133. package/dist/megamenu.d.ts.map +1 -1
  134. package/dist/megamenu.js +96 -3
  135. package/dist/megamenu.js.map +1 -1
  136. package/dist/mfa.d.ts +125 -4
  137. package/dist/mfa.d.ts.map +1 -1
  138. package/dist/mfa.js +54 -2
  139. package/dist/mfa.js.map +1 -1
  140. package/dist/modules.d.ts +44 -5
  141. package/dist/modules.d.ts.map +1 -1
  142. package/dist/modules.js +73 -0
  143. package/dist/modules.js.map +1 -1
  144. package/dist/money-decimal.d.ts +54 -0
  145. package/dist/money-decimal.d.ts.map +1 -1
  146. package/dist/money-decimal.js +95 -0
  147. package/dist/money-decimal.js.map +1 -1
  148. package/dist/newsletter.d.ts +7 -7
  149. package/dist/orders.d.ts +128 -10
  150. package/dist/orders.d.ts.map +1 -1
  151. package/dist/orders.js +74 -4
  152. package/dist/orders.js.map +1 -1
  153. package/dist/organization-registry-lookup.d.ts +362 -0
  154. package/dist/organization-registry-lookup.d.ts.map +1 -0
  155. package/dist/organization-registry-lookup.js +196 -0
  156. package/dist/organization-registry-lookup.js.map +1 -0
  157. package/dist/organization-roles.d.ts +340 -0
  158. package/dist/organization-roles.d.ts.map +1 -0
  159. package/dist/organization-roles.js +211 -0
  160. package/dist/organization-roles.js.map +1 -0
  161. package/dist/organizations.d.ts +123 -89
  162. package/dist/organizations.d.ts.map +1 -1
  163. package/dist/organizations.js +68 -24
  164. package/dist/organizations.js.map +1 -1
  165. package/dist/page-builder-props.d.ts +1401 -0
  166. package/dist/page-builder-props.d.ts.map +1 -0
  167. package/dist/page-builder-props.js +266 -0
  168. package/dist/page-builder-props.js.map +1 -0
  169. package/dist/page-builder-values.d.ts +95 -0
  170. package/dist/page-builder-values.d.ts.map +1 -0
  171. package/dist/page-builder-values.js +164 -0
  172. package/dist/page-builder-values.js.map +1 -0
  173. package/dist/pim-connector.d.ts +6 -2
  174. package/dist/pim-connector.d.ts.map +1 -1
  175. package/dist/pim-connector.js +6 -2
  176. package/dist/pim-connector.js.map +1 -1
  177. package/dist/pim-field-path.d.ts +5 -1
  178. package/dist/pim-field-path.d.ts.map +1 -1
  179. package/dist/pim-field-path.js +37 -81
  180. package/dist/pim-field-path.js.map +1 -1
  181. package/dist/pim-locale-mapping.d.ts +131 -0
  182. package/dist/pim-locale-mapping.d.ts.map +1 -0
  183. package/dist/pim-locale-mapping.js +193 -0
  184. package/dist/pim-locale-mapping.js.map +1 -0
  185. package/dist/platform-language.d.ts +9 -0
  186. package/dist/platform-language.d.ts.map +1 -1
  187. package/dist/platform-language.js +14 -0
  188. package/dist/platform-language.js.map +1 -1
  189. package/dist/price-books.d.ts +47 -43
  190. package/dist/price-books.d.ts.map +1 -1
  191. package/dist/price-books.js +6 -2
  192. package/dist/price-books.js.map +1 -1
  193. package/dist/price-lists.d.ts +48 -14
  194. package/dist/price-lists.d.ts.map +1 -1
  195. package/dist/price-lists.js +24 -1
  196. package/dist/price-lists.js.map +1 -1
  197. package/dist/product-feeds.d.ts +144 -84
  198. package/dist/product-feeds.d.ts.map +1 -1
  199. package/dist/product-feeds.js +23 -0
  200. package/dist/product-feeds.js.map +1 -1
  201. package/dist/product-scope-model.d.ts +161 -0
  202. package/dist/product-scope-model.d.ts.map +1 -0
  203. package/dist/product-scope-model.js +161 -0
  204. package/dist/product-scope-model.js.map +1 -0
  205. package/dist/product-scope-overrides.d.ts +0 -103
  206. package/dist/product-scope-overrides.d.ts.map +1 -1
  207. package/dist/product-scope-overrides.js +0 -54
  208. package/dist/product-scope-overrides.js.map +1 -1
  209. package/dist/product-scoped-values.d.ts +2610 -0
  210. package/dist/product-scoped-values.d.ts.map +1 -0
  211. package/dist/product-scoped-values.js +425 -0
  212. package/dist/product-scoped-values.js.map +1 -0
  213. package/dist/product-scopes.d.ts +746 -0
  214. package/dist/product-scopes.d.ts.map +1 -0
  215. package/dist/product-scopes.js +436 -0
  216. package/dist/product-scopes.js.map +1 -0
  217. package/dist/product-summary-text.d.ts +23 -0
  218. package/dist/product-summary-text.d.ts.map +1 -0
  219. package/dist/product-summary-text.js +64 -0
  220. package/dist/product-summary-text.js.map +1 -0
  221. package/dist/product-tax-rates.d.ts +38 -0
  222. package/dist/product-tax-rates.d.ts.map +1 -0
  223. package/dist/product-tax-rates.js +45 -0
  224. package/dist/product-tax-rates.js.map +1 -0
  225. package/dist/product-url-keys.d.ts +210 -0
  226. package/dist/product-url-keys.d.ts.map +1 -0
  227. package/dist/product-url-keys.js +200 -0
  228. package/dist/product-url-keys.js.map +1 -0
  229. package/dist/product-value-resolver.d.ts +37 -60
  230. package/dist/product-value-resolver.d.ts.map +1 -1
  231. package/dist/product-value-resolver.js +36 -96
  232. package/dist/product-value-resolver.js.map +1 -1
  233. package/dist/projects.d.ts +2370 -0
  234. package/dist/projects.d.ts.map +1 -0
  235. package/dist/projects.js +843 -0
  236. package/dist/projects.js.map +1 -0
  237. package/dist/promotions.d.ts +10 -10
  238. package/dist/prompt-actions.d.ts +19 -1
  239. package/dist/prompt-actions.d.ts.map +1 -1
  240. package/dist/prompt-actions.js +31 -2
  241. package/dist/prompt-actions.js.map +1 -1
  242. package/dist/pwa.d.ts +2 -2
  243. package/dist/quick-order.d.ts +150 -7
  244. package/dist/quick-order.d.ts.map +1 -1
  245. package/dist/quick-order.js +76 -2
  246. package/dist/quick-order.js.map +1 -1
  247. package/dist/quote-requests.d.ts +99 -13
  248. package/dist/quote-requests.d.ts.map +1 -1
  249. package/dist/quote-requests.js +66 -1
  250. package/dist/quote-requests.js.map +1 -1
  251. package/dist/record-references.d.ts +252 -0
  252. package/dist/record-references.d.ts.map +1 -0
  253. package/dist/record-references.js +178 -0
  254. package/dist/record-references.js.map +1 -0
  255. package/dist/record-rich-text.d.ts +66 -0
  256. package/dist/record-rich-text.d.ts.map +1 -0
  257. package/dist/record-rich-text.js +304 -0
  258. package/dist/record-rich-text.js.map +1 -0
  259. package/dist/returns.d.ts +234 -52
  260. package/dist/returns.d.ts.map +1 -1
  261. package/dist/returns.js +139 -26
  262. package/dist/returns.js.map +1 -1
  263. package/dist/sales-channels.d.ts +51 -7
  264. package/dist/sales-channels.d.ts.map +1 -1
  265. package/dist/sales-channels.js +38 -4
  266. package/dist/sales-channels.js.map +1 -1
  267. package/dist/saved-list-views.d.ts +56 -0
  268. package/dist/saved-list-views.d.ts.map +1 -1
  269. package/dist/saved-list-views.js +27 -1
  270. package/dist/saved-list-views.js.map +1 -1
  271. package/dist/scoped-write-encoding.d.ts +100 -0
  272. package/dist/scoped-write-encoding.d.ts.map +1 -0
  273. package/dist/scoped-write-encoding.js +135 -0
  274. package/dist/scoped-write-encoding.js.map +1 -0
  275. package/dist/search.d.ts +25 -15
  276. package/dist/search.d.ts.map +1 -1
  277. package/dist/seo.d.ts +127 -15
  278. package/dist/seo.d.ts.map +1 -1
  279. package/dist/seo.js +38 -4
  280. package/dist/seo.js.map +1 -1
  281. package/dist/settings.d.ts +161 -3
  282. package/dist/settings.d.ts.map +1 -1
  283. package/dist/settings.js +73 -3
  284. package/dist/settings.js.map +1 -1
  285. package/dist/shopping-lists.d.ts +24 -3
  286. package/dist/shopping-lists.d.ts.map +1 -1
  287. package/dist/shopping-lists.js +20 -0
  288. package/dist/shopping-lists.js.map +1 -1
  289. package/dist/storefront-cache-tags.d.ts +41 -0
  290. package/dist/storefront-cache-tags.d.ts.map +1 -1
  291. package/dist/storefront-cache-tags.js +36 -0
  292. package/dist/storefront-cache-tags.js.map +1 -1
  293. package/dist/storefront-language-path.d.ts +77 -0
  294. package/dist/storefront-language-path.d.ts.map +1 -0
  295. package/dist/storefront-language-path.js +123 -0
  296. package/dist/storefront-language-path.js.map +1 -0
  297. package/dist/storefront-value-overrides.d.ts +18 -56
  298. package/dist/storefront-value-overrides.d.ts.map +1 -1
  299. package/dist/storefront-value-overrides.js +11 -86
  300. package/dist/storefront-value-overrides.js.map +1 -1
  301. package/dist/tasks.d.ts +2842 -0
  302. package/dist/tasks.d.ts.map +1 -0
  303. package/dist/tasks.js +901 -0
  304. package/dist/tasks.js.map +1 -0
  305. package/dist/transactional-emails.d.ts +14 -11
  306. package/dist/transactional-emails.d.ts.map +1 -1
  307. package/dist/transactional-emails.js +13 -0
  308. package/dist/transactional-emails.js.map +1 -1
  309. package/package.json +3 -3
@@ -0,0 +1,699 @@
1
+ import { isCalendarDate, isUuidShape } from './common.js';
2
+ import { normalizeEmailAddress } from './email-address.js';
3
+ import { FORM_CONDITION_OPERATORS_BY_TYPE, FORM_CONSENT_TYPES, FORM_DATETIME_PATTERNS, FORM_LAYOUT_ELEMENT_TYPES, FORMS_LIMITS, } from './forms.js';
4
+ const LAYOUT_TYPES = new Set(FORM_LAYOUT_ELEMENT_TYPES);
5
+ const CONSENT_TYPES = new Set(FORM_CONSENT_TYPES);
6
+ const TEXT_LIKE_TYPES = new Set(['text', 'email', 'phone', 'textarea', 'hidden']);
7
+ const BOOLEAN_TYPES = new Set(['checkbox', ...FORM_CONSENT_TYPES]);
8
+ const isLayout = (type) => LAYOUT_TYPES.has(type);
9
+ const nonBlank = (value) => value !== undefined && value.trim() !== '' ? value : undefined;
10
+ function isInputField(field) {
11
+ return !isLayout(field.type);
12
+ }
13
+ /**
14
+ * The elements that sit on a dependency cycle. Edges: an element → every field its rule names, and a
15
+ * field → its section (a field is visible only inside a visible section). Tarjan's SCC; an element
16
+ * is cyclic when its component has more than one member or it names itself.
17
+ */
18
+ function cyclicElements(source) {
19
+ const edges = new Map();
20
+ const known = new Set();
21
+ for (const section of source.sections) {
22
+ known.add(section.id);
23
+ edges.set(section.id, section.visibility ? section.visibility.groups.flat().map((c) => c.fieldId) : []);
24
+ for (const field of section.fields) {
25
+ known.add(field.id);
26
+ const named = field.visibility ? field.visibility.groups.flat().map((c) => c.fieldId) : [];
27
+ edges.set(field.id, [section.id, ...named]);
28
+ }
29
+ }
30
+ const index = new Map();
31
+ const low = new Map();
32
+ const onStack = new Set();
33
+ const stack = [];
34
+ const cyclic = new Set();
35
+ let next = 0;
36
+ const connect = (node) => {
37
+ index.set(node, next);
38
+ low.set(node, next);
39
+ next += 1;
40
+ stack.push(node);
41
+ onStack.add(node);
42
+ for (const target of edges.get(node) ?? []) {
43
+ if (!known.has(target))
44
+ continue;
45
+ if (!index.has(target)) {
46
+ connect(target);
47
+ low.set(node, Math.min(low.get(node), low.get(target)));
48
+ }
49
+ else if (onStack.has(target)) {
50
+ low.set(node, Math.min(low.get(node), index.get(target)));
51
+ }
52
+ }
53
+ if (low.get(node) !== index.get(node))
54
+ return;
55
+ const component = [];
56
+ let member;
57
+ do {
58
+ member = stack.pop();
59
+ onStack.delete(member);
60
+ component.push(member);
61
+ } while (member !== node);
62
+ if (component.length > 1 || (edges.get(node) ?? []).includes(node)) {
63
+ for (const id of component)
64
+ cyclic.add(id);
65
+ }
66
+ };
67
+ for (const id of known)
68
+ if (!index.has(id))
69
+ connect(id);
70
+ return cyclic;
71
+ }
72
+ // --- Condition evaluation ----------------------------------------------------------------------
73
+ /** A hidden or unknown field's value: empty for every test (B3). */
74
+ const EMPTY = Symbol('empty');
75
+ const firstString = (raw) => {
76
+ if (typeof raw === 'string')
77
+ return raw;
78
+ if (Array.isArray(raw))
79
+ return typeof raw[0] === 'string' ? raw[0] : '';
80
+ if (typeof raw === 'number' || typeof raw === 'boolean')
81
+ return String(raw);
82
+ return '';
83
+ };
84
+ const stringList = (raw) => {
85
+ const list = Array.isArray(raw) ? raw : typeof raw === 'string' ? [raw] : [];
86
+ return list.filter((v) => typeof v === 'string').map((v) => v.trim()).filter((v) => v !== '');
87
+ };
88
+ const isTicked = (raw) => {
89
+ if (raw === true)
90
+ return true;
91
+ const value = firstString(raw).trim().toLowerCase();
92
+ return value === 'on' || value === 'true';
93
+ };
94
+ /** `.` or `,` decimal; anything else is not a number (B5). */
95
+ function parseNumber(raw) {
96
+ if (typeof raw === 'number')
97
+ return Number.isFinite(raw) ? raw : null;
98
+ const value = firstString(raw).trim();
99
+ if (!/^[+-]?\d+(?:[.,]\d+)?$/.test(value))
100
+ return null;
101
+ return Number(value.replace(',', '.'));
102
+ }
103
+ /** A field's value as a condition reads it, from raw posted values or normalised answers alike (B2). */
104
+ function readValue(field, answers) {
105
+ const key = field.key ?? '';
106
+ const raw = answers[key];
107
+ if (field.type === 'number')
108
+ return parseNumber(raw);
109
+ if (field.type === 'checkboxes')
110
+ return stringList(raw);
111
+ if (BOOLEAN_TYPES.has(field.type))
112
+ return isTicked(raw);
113
+ if (field.type === 'address') {
114
+ if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
115
+ return Object.values(raw).some((v) => typeof v === 'string' && v.trim() !== '');
116
+ }
117
+ return Object.keys(answers).some((k) => k.startsWith(`${key}.`) && firstString(answers[k]).trim() !== '');
118
+ }
119
+ return firstString(raw).trim();
120
+ }
121
+ function isEmptyValue(value) {
122
+ if (value === EMPTY || value === null || value === false)
123
+ return true;
124
+ if (typeof value === 'string')
125
+ return value === '';
126
+ if (Array.isArray(value))
127
+ return value.length === 0;
128
+ return false;
129
+ }
130
+ function equalsValue(field, value, expected) {
131
+ if (value === EMPTY || value === null)
132
+ return false;
133
+ const wanted = expected === undefined ? '' : String(expected);
134
+ if (typeof value === 'boolean')
135
+ return (value ? 'true' : 'false') === wanted.trim().toLowerCase();
136
+ if (typeof value === 'number') {
137
+ const n = parseNumber(wanted);
138
+ return n !== null && n === value;
139
+ }
140
+ if (Array.isArray(value))
141
+ return value.includes(wanted.trim());
142
+ if (value === '')
143
+ return false;
144
+ if (field && (TEXT_LIKE_TYPES.has(field.type) || field.type === 'country')) {
145
+ return value.toLowerCase() === wanted.trim().toLowerCase();
146
+ }
147
+ return value === wanted.trim();
148
+ }
149
+ function compareValue(value, expected) {
150
+ if (value === EMPTY || value === null)
151
+ return null;
152
+ if (typeof value === 'number') {
153
+ const n = parseNumber(expected === undefined ? '' : expected);
154
+ return n === null ? null : value - n;
155
+ }
156
+ if (typeof value === 'string' && value !== '' && expected !== undefined) {
157
+ const wanted = String(expected).trim();
158
+ return value < wanted ? -1 : value > wanted ? 1 : 0;
159
+ }
160
+ return null;
161
+ }
162
+ function containsValue(value, expected) {
163
+ if (value === EMPTY || value === null || expected === undefined)
164
+ return false;
165
+ const wanted = String(expected).trim();
166
+ if (Array.isArray(value))
167
+ return value.includes(wanted);
168
+ if (typeof value === 'string')
169
+ return wanted !== '' && value.toLowerCase().includes(wanted.toLowerCase());
170
+ return false;
171
+ }
172
+ function conditionHolds(condition, field, value) {
173
+ switch (condition.operator) {
174
+ case 'is_empty':
175
+ return isEmptyValue(value);
176
+ case 'is_not_empty':
177
+ return !isEmptyValue(value);
178
+ case 'equals':
179
+ return equalsValue(field, value, condition.value);
180
+ case 'not_equals':
181
+ return !equalsValue(field, value, condition.value);
182
+ case 'greater_than': {
183
+ const order = compareValue(value, condition.value);
184
+ return order !== null && order > 0;
185
+ }
186
+ case 'less_than': {
187
+ const order = compareValue(value, condition.value);
188
+ return order !== null && order < 0;
189
+ }
190
+ case 'contains':
191
+ return containsValue(value, condition.value);
192
+ case 'not_contains':
193
+ return !containsValue(value, condition.value);
194
+ }
195
+ }
196
+ /** `and`: any group whose conditions all hold. `or`: every group with a condition that holds (FR-030). */
197
+ function ruleHolds(rule, holds) {
198
+ return rule.connective === 'and'
199
+ ? rule.groups.some((group) => group.every(holds))
200
+ : rule.groups.every((group) => group.some(holds));
201
+ }
202
+ // --- visibleElements ---------------------------------------------------------------------------
203
+ /** Element ids visible for these answers (sections and fields), FR-030–FR-032. */
204
+ export function visibleElements(definition, answers) {
205
+ const cyclic = cyclicElements(definition);
206
+ const fieldById = new Map();
207
+ const sectionOf = new Map();
208
+ const sectionById = new Map();
209
+ for (const section of definition.sections) {
210
+ sectionById.set(section.id, section);
211
+ for (const field of section.fields) {
212
+ fieldById.set(field.id, field);
213
+ sectionOf.set(field.id, section.id);
214
+ }
215
+ }
216
+ const memo = new Map();
217
+ const valueOf = (fieldId) => {
218
+ const field = fieldById.get(fieldId);
219
+ if (!field || isLayout(field.type) || !fieldVisible(fieldId))
220
+ return { field, value: EMPTY };
221
+ return { field, value: readValue(field, answers) };
222
+ };
223
+ const holds = (rule) => rule === undefined ||
224
+ ruleHolds(rule, (condition) => {
225
+ const { field, value } = valueOf(condition.fieldId);
226
+ return conditionHolds(condition, field, value);
227
+ });
228
+ // No element on a cycle is ever evaluated (B4), so the recursion below terminates.
229
+ const sectionVisible = (sectionId) => {
230
+ const cached = memo.get(sectionId);
231
+ if (cached !== undefined)
232
+ return cached;
233
+ const visible = !cyclic.has(sectionId) && holds(sectionById.get(sectionId)?.visibility);
234
+ memo.set(sectionId, visible);
235
+ return visible;
236
+ };
237
+ function fieldVisible(fieldId) {
238
+ const cached = memo.get(fieldId);
239
+ if (cached !== undefined)
240
+ return cached;
241
+ const field = fieldById.get(fieldId);
242
+ const sectionId = sectionOf.get(fieldId);
243
+ const visible = field !== undefined &&
244
+ sectionId !== undefined &&
245
+ !cyclic.has(fieldId) &&
246
+ sectionVisible(sectionId) &&
247
+ holds(field.visibility);
248
+ memo.set(fieldId, visible);
249
+ return visible;
250
+ }
251
+ const sections = new Set();
252
+ const fields = new Set();
253
+ for (const section of definition.sections) {
254
+ if (sectionVisible(section.id))
255
+ sections.add(section.id);
256
+ for (const field of section.fields)
257
+ if (fieldVisible(field.id))
258
+ fields.add(field.id);
259
+ }
260
+ return { sections, fields };
261
+ }
262
+ // --- definitionIssues --------------------------------------------------------------------------
263
+ const KEY_PATTERN = /^[a-z][a-z0-9_]{0,63}$/;
264
+ /**
265
+ * An absolute `http(s)` address: a scheme, a host, then anything without whitespace. A pattern
266
+ * rather than `new URL()`, because this file runs in the browser and in Node alike and the
267
+ * package's program declares neither runtime's globals.
268
+ */
269
+ const ABSOLUTE_HTTP_URL = /^https?:\/\/[^\s/?#@]+(?:[/?#][^\s]*)?$/i;
270
+ function isAbsoluteHttpUrl(value) {
271
+ return value.length <= FORMS_LIMITS.pageUrlChars && ABSOLUTE_HTTP_URL.test(value);
272
+ }
273
+ /**
274
+ * The publish-time rules; `[]` = publishable (data-model §3.5, FR-011, FR-033). The default
275
+ * language is the form row's (it is live, not part of the definition), so it is passed in.
276
+ */
277
+ export function definitionIssues(definition, defaultLanguage) {
278
+ const issues = [];
279
+ const issue = (code, elementId, path) => {
280
+ issues.push({ code, elementId, path });
281
+ };
282
+ const fieldById = new Map();
283
+ for (const section of definition.sections)
284
+ for (const field of section.fields)
285
+ fieldById.set(field.id, field);
286
+ if (definition.sections.length > FORMS_LIMITS.sectionsPerForm)
287
+ issue('too_many_sections', null, 'sections');
288
+ const fieldCount = definition.sections.reduce((n, s) => n + s.fields.length, 0);
289
+ if (fieldCount > FORMS_LIMITS.fieldsPerForm)
290
+ issue('too_many_fields', null, 'sections');
291
+ const checkRule = (rule, elementId, path) => {
292
+ if (!rule)
293
+ return;
294
+ if (rule.groups.length > FORMS_LIMITS.groupsPerRule || rule.groups.flat().length > FORMS_LIMITS.conditionsPerRule) {
295
+ issue('too_many_conditions', elementId, `${path}.visibility`);
296
+ }
297
+ rule.groups.forEach((group, g) => group.forEach((condition, c) => {
298
+ const at = `${path}.visibility.groups[${g}][${c}]`;
299
+ const target = fieldById.get(condition.fieldId);
300
+ if (!target)
301
+ issue('unknown_condition_field', elementId, at);
302
+ else if (isLayout(target.type))
303
+ issue('condition_on_layout_element', elementId, at);
304
+ else if (!FORM_CONDITION_OPERATORS_BY_TYPE[target.type].includes(condition.operator)) {
305
+ issue('operator_not_allowed', elementId, at);
306
+ }
307
+ }));
308
+ };
309
+ const seenKeys = new Set();
310
+ let submitterEmails = 0;
311
+ const labels = definition.texts[defaultLanguage] ?? {};
312
+ definition.sections.forEach((section, s) => {
313
+ const sectionPath = `sections[${s}]`;
314
+ checkRule(section.visibility, section.id, sectionPath);
315
+ section.fields.forEach((field, f) => {
316
+ const path = `${sectionPath}.fields[${f}]`;
317
+ if (field.width > section.columns)
318
+ issue('width_exceeds_columns', field.id, `${path}.width`);
319
+ checkRule(field.visibility, field.id, path);
320
+ if (!isInputField(field))
321
+ return;
322
+ if (!KEY_PATTERN.test(field.key))
323
+ issue('invalid_key', field.id, `${path}.key`);
324
+ else if (seenKeys.has(field.key))
325
+ issue('duplicate_key', field.id, `${path}.key`);
326
+ seenKeys.add(field.key);
327
+ if (field.type !== 'hidden') {
328
+ const label = CONSENT_TYPES.has(field.type)
329
+ ? (nonBlank(labels[`fields.${field.id}.content`]) ?? nonBlank(labels[`fields.${field.id}.label`]))
330
+ : nonBlank(labels[`fields.${field.id}.label`]);
331
+ if (label === undefined)
332
+ issue('missing_default_language_label', field.id, `texts.${defaultLanguage}`);
333
+ }
334
+ switch (field.type) {
335
+ case 'select':
336
+ case 'radio':
337
+ case 'checkboxes': {
338
+ if (field.options.length === 0)
339
+ issue('missing_options', field.id, `${path}.options`);
340
+ if (field.options.length > FORMS_LIMITS.optionsPerChoice)
341
+ issue('too_many_options', field.id, `${path}.options`);
342
+ const values = new Set();
343
+ field.options.forEach((option, o) => {
344
+ if (values.has(option.value))
345
+ issue('duplicate_option_value', field.id, `${path}.options[${o}].value`);
346
+ values.add(option.value);
347
+ });
348
+ if (field.type === 'checkboxes' &&
349
+ field.minSelected !== undefined &&
350
+ field.maxSelected !== undefined &&
351
+ field.minSelected > field.maxSelected) {
352
+ issue('min_above_max', field.id, `${path}.minSelected`);
353
+ }
354
+ break;
355
+ }
356
+ case 'text':
357
+ case 'textarea':
358
+ if (field.minLength !== undefined && field.maxLength !== undefined && field.minLength > field.maxLength) {
359
+ issue('min_above_max', field.id, `${path}.minLength`);
360
+ }
361
+ break;
362
+ case 'number':
363
+ if (field.min !== undefined && field.max !== undefined && field.min > field.max) {
364
+ issue('min_above_max', field.id, `${path}.min`);
365
+ }
366
+ break;
367
+ case 'datetime':
368
+ if (field.earliest !== undefined && field.latest !== undefined && field.earliest > field.latest) {
369
+ issue('min_above_max', field.id, `${path}.earliest`);
370
+ }
371
+ break;
372
+ case 'email':
373
+ if (field.submitterEmail) {
374
+ submitterEmails += 1;
375
+ if (submitterEmails > 1)
376
+ issue('multiple_submitter_email', field.id, `${path}.submitterEmail`);
377
+ }
378
+ break;
379
+ case 'privacy_consent':
380
+ case 'terms':
381
+ if (!field.required)
382
+ issue('consent_must_be_required', field.id, `${path}.required`);
383
+ break;
384
+ case 'marketing_consent':
385
+ if (field.required)
386
+ issue('marketing_consent_required', field.id, `${path}.required`);
387
+ break;
388
+ default:
389
+ break;
390
+ }
391
+ });
392
+ });
393
+ const cyclic = cyclicElements(definition);
394
+ definition.sections.forEach((section, s) => {
395
+ if (cyclic.has(section.id))
396
+ issue('cyclic_visibility', section.id, `sections[${s}].visibility`);
397
+ section.fields.forEach((field, f) => {
398
+ if (cyclic.has(field.id))
399
+ issue('cyclic_visibility', field.id, `sections[${s}].fields[${f}].visibility`);
400
+ });
401
+ });
402
+ const confirmation = definition.behaviour.confirmation;
403
+ if (confirmation.type === 'redirect' && !isAbsoluteHttpUrl(confirmation.url)) {
404
+ issue('invalid_redirect_url', null, 'behaviour.confirmation.url');
405
+ }
406
+ if (confirmation.type === 'page' && !isUuidShape(confirmation.cmsPageId)) {
407
+ issue('invalid_page_reference', null, 'behaviour.confirmation.cmsPageId');
408
+ }
409
+ const { availableFrom, availableUntil } = definition.restrictions;
410
+ if (availableFrom !== null && availableUntil !== null && Date.parse(availableUntil) <= Date.parse(availableFrom)) {
411
+ issue('invalid_window', null, 'restrictions.availableUntil');
412
+ }
413
+ return issues;
414
+ }
415
+ // --- validateSubmission ------------------------------------------------------------------------
416
+ const PHONE_PATTERN = /^\+?[0-9][0-9 ()./-]{3,30}$/;
417
+ const EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
418
+ const LINE_BREAK = /[\r\n]/;
419
+ const TEXT_PATTERNS = {
420
+ digits: /^[0-9]+$/,
421
+ letters: /^\p{L}+$/u,
422
+ alphanumeric: /^[\p{L}0-9]+$/u,
423
+ };
424
+ function matchesPattern(pattern, value) {
425
+ return pattern === 'url' ? isAbsoluteHttpUrl(value) : TEXT_PATTERNS[pattern].test(value);
426
+ }
427
+ const CONSENT_KIND = {
428
+ privacy_consent: 'privacy',
429
+ marketing_consent: 'marketing',
430
+ terms: 'terms',
431
+ };
432
+ const fail = (fieldKey, code) => ({ errors: [{ fieldKey, code }] });
433
+ const SKIP = { skip: true };
434
+ /** Length checks of a string answer: the field's own limits, then the global cap (B7). */
435
+ function lengthError(value, limits, cap) {
436
+ if (limits.minLength !== undefined && value.length < limits.minLength)
437
+ return 'too_short';
438
+ if (limits.maxLength !== undefined && value.length > limits.maxLength)
439
+ return 'too_long';
440
+ if (value.length > cap)
441
+ return 'too_long';
442
+ return null;
443
+ }
444
+ function validateField(field, raw, ctx) {
445
+ const key = field.key;
446
+ const single = firstString(raw[key]).trim();
447
+ const required = field.required;
448
+ switch (field.type) {
449
+ case 'text': {
450
+ if (LINE_BREAK.test(single))
451
+ return fail(key, 'single_line');
452
+ if (single === '')
453
+ return required ? fail(key, 'required') : SKIP;
454
+ const length = lengthError(single, field, FORMS_LIMITS.singleLineChars);
455
+ if (length)
456
+ return fail(key, length);
457
+ if (field.pattern && !matchesPattern(field.pattern, single))
458
+ return fail(key, 'pattern');
459
+ return { value: single };
460
+ }
461
+ case 'email': {
462
+ if (LINE_BREAK.test(single))
463
+ return fail(key, 'single_line');
464
+ if (single === '')
465
+ return required ? fail(key, 'required') : SKIP;
466
+ if (single.length > FORMS_LIMITS.singleLineChars)
467
+ return fail(key, 'too_long');
468
+ const email = normalizeEmailAddress(single);
469
+ if (email.length > 320 || !EMAIL_PATTERN.test(email))
470
+ return fail(key, 'invalid_email');
471
+ return { value: email };
472
+ }
473
+ case 'phone': {
474
+ if (LINE_BREAK.test(single))
475
+ return fail(key, 'single_line');
476
+ if (single === '')
477
+ return required ? fail(key, 'required') : SKIP;
478
+ const digits = single.replace(/[^0-9]/g, '').length;
479
+ if (!PHONE_PATTERN.test(single) || digits < 4)
480
+ return fail(key, 'invalid_phone');
481
+ return { value: single };
482
+ }
483
+ case 'number': {
484
+ if (single === '')
485
+ return required ? fail(key, 'required') : SKIP;
486
+ const value = parseNumber(single);
487
+ if (value === null)
488
+ return fail(key, 'invalid_number');
489
+ if (field.min !== undefined && value < field.min)
490
+ return fail(key, 'below_min');
491
+ if (field.max !== undefined && value > field.max)
492
+ return fail(key, 'above_max');
493
+ if (field.step !== undefined) {
494
+ const steps = (value - (field.min ?? 0)) / field.step;
495
+ if (Math.abs(steps - Math.round(steps)) > 1e-9)
496
+ return fail(key, 'step_mismatch');
497
+ }
498
+ return { value };
499
+ }
500
+ case 'textarea': {
501
+ if (single === '')
502
+ return required ? fail(key, 'required') : SKIP;
503
+ const length = lengthError(single, field, FORMS_LIMITS.multiLineChars);
504
+ if (length)
505
+ return fail(key, length);
506
+ return { value: single };
507
+ }
508
+ case 'select':
509
+ case 'radio': {
510
+ if (LINE_BREAK.test(single))
511
+ return fail(key, 'single_line');
512
+ if (single === '')
513
+ return required ? fail(key, 'required') : SKIP;
514
+ if (!field.options.some((option) => option.value === single))
515
+ return fail(key, 'unknown_option');
516
+ return { value: single };
517
+ }
518
+ case 'checkboxes': {
519
+ const chosen = new Set(stringList(raw[key]));
520
+ if (chosen.size === 0)
521
+ return required ? fail(key, 'required') : SKIP;
522
+ const values = field.options.map((option) => option.value);
523
+ if ([...chosen].some((value) => !values.includes(value)))
524
+ return fail(key, 'unknown_option');
525
+ if (field.minSelected !== undefined && chosen.size < field.minSelected)
526
+ return fail(key, 'too_few');
527
+ if (field.maxSelected !== undefined && chosen.size > field.maxSelected)
528
+ return fail(key, 'too_many');
529
+ return { value: values.filter((value) => chosen.has(value)) };
530
+ }
531
+ case 'checkbox': {
532
+ const ticked = isTicked(raw[key]);
533
+ if (!ticked && required)
534
+ return fail(key, 'required');
535
+ return { value: ticked };
536
+ }
537
+ case 'datetime': {
538
+ if (LINE_BREAK.test(single))
539
+ return fail(key, 'single_line');
540
+ if (single === '')
541
+ return required ? fail(key, 'required') : SKIP;
542
+ if (!FORM_DATETIME_PATTERNS[field.mode].test(single))
543
+ return fail(key, 'invalid_date');
544
+ if (field.mode !== 'time' && !isCalendarDate(single.slice(0, 10)))
545
+ return fail(key, 'invalid_date');
546
+ if (field.earliest !== undefined && single < field.earliest)
547
+ return fail(key, 'too_early');
548
+ if (field.latest !== undefined && single > field.latest)
549
+ return fail(key, 'too_late');
550
+ return { value: single };
551
+ }
552
+ case 'country': {
553
+ if (LINE_BREAK.test(single))
554
+ return fail(key, 'single_line');
555
+ if (single === '')
556
+ return required ? fail(key, 'required') : SKIP;
557
+ const code = single.toUpperCase();
558
+ const allowed = field.allowedCountries === undefined || field.allowedCountries.includes(code);
559
+ if (!allowed || !/^[A-Z]{2}$/.test(code) || !ctx.isKnownCountry(code))
560
+ return fail(key, 'invalid_country');
561
+ return { value: code };
562
+ }
563
+ case 'address': {
564
+ const parts = Object.entries(field.parts).filter(([, part]) => part.enabled);
565
+ const typed = parts.map(([name]) => [name, firstString(raw[`${key}.${name}`]).trim()]);
566
+ const anyTyped = typed.some(([, value]) => value !== '');
567
+ if (!anyTyped && !required)
568
+ return SKIP;
569
+ const errors = [];
570
+ const answer = {};
571
+ for (const [name, value] of typed) {
572
+ const partKey = `${key}.${name}`;
573
+ const part = field.parts[name];
574
+ if (LINE_BREAK.test(value))
575
+ errors.push({ fieldKey: partKey, code: 'single_line' });
576
+ else if (value === '') {
577
+ if (part.required)
578
+ errors.push({ fieldKey: partKey, code: 'required' });
579
+ }
580
+ else if (value.length > FORMS_LIMITS.singleLineChars)
581
+ errors.push({ fieldKey: partKey, code: 'too_long' });
582
+ else if (name === 'country') {
583
+ const code = value.toUpperCase();
584
+ if (!/^[A-Z]{2}$/.test(code) || !ctx.isKnownCountry(code)) {
585
+ errors.push({ fieldKey: partKey, code: 'invalid_country' });
586
+ }
587
+ else
588
+ answer[name] = code;
589
+ }
590
+ else
591
+ answer[name] = value;
592
+ }
593
+ return errors.length > 0 ? { errors } : { value: answer };
594
+ }
595
+ case 'hidden': {
596
+ // Never required: the shopper cannot fill a hidden field. Over the cap it is truncated,
597
+ // not refused (the spec's edge case) — the value came from the page, not from the shopper.
598
+ if (LINE_BREAK.test(single))
599
+ return fail(key, 'single_line');
600
+ if (single === '')
601
+ return SKIP;
602
+ return { value: single.slice(0, FORMS_LIMITS.hiddenChars) };
603
+ }
604
+ case 'privacy_consent':
605
+ case 'terms': {
606
+ const given = isTicked(raw[key]);
607
+ if (!given)
608
+ return fail(key, 'consent_required');
609
+ return { value: true };
610
+ }
611
+ case 'marketing_consent':
612
+ return { value: isTicked(raw[key]) };
613
+ }
614
+ }
615
+ /**
616
+ * Server-authoritative validation of raw posted values against a version: drops values of hidden
617
+ * and unknown fields, coerces by type, applies required/limits/patterns, and returns either the
618
+ * normalised answers + consents or per-field errors. FR-032, FR-034, FR-036.
619
+ */
620
+ export function validateSubmission(definition, raw, ctx) {
621
+ const visible = visibleElements(definition, raw);
622
+ const answers = {};
623
+ const consents = [];
624
+ const errors = [];
625
+ for (const section of definition.sections) {
626
+ for (const field of section.fields) {
627
+ if (!isInputField(field) || !visible.fields.has(field.id))
628
+ continue;
629
+ const outcome = validateField(field, raw, ctx);
630
+ if ('errors' in outcome) {
631
+ errors.push(...outcome.errors);
632
+ continue;
633
+ }
634
+ if ('skip' in outcome)
635
+ continue;
636
+ answers[field.key] = outcome.value;
637
+ const kind = CONSENT_KIND[field.type];
638
+ if (kind)
639
+ consents.push({ fieldKey: field.key, kind, given: outcome.value === true });
640
+ }
641
+ }
642
+ return errors.length > 0 ? { ok: false, errors } : { ok: true, answers, consents };
643
+ }
644
+ // --- Texts -------------------------------------------------------------------------------------
645
+ /** Texts for one language with the R-7 fallback; built-ins are the caller's. */
646
+ export function resolveTexts(definition, language, defaultLanguage) {
647
+ const own = definition.texts[language] ?? {};
648
+ const fallback = definition.texts[defaultLanguage] ?? {};
649
+ return (textId) => nonBlank(own[textId]) ?? nonBlank(fallback[textId]);
650
+ }
651
+ /** A text id that names an element no longer in the definition is not owed a translation. */
652
+ function isLiveTextId(textId, elementIds) {
653
+ const match = /^(fields|sections)\.([^.]+)\./.exec(textId);
654
+ return match === null || elementIds.has(match[2]);
655
+ }
656
+ /** Per language, the text ids that fall back to the default language. FR-018, US7-2. */
657
+ export function textCompleteness(definition, languages, defaultLanguage) {
658
+ const elementIds = new Set(definition.sections.flatMap((s) => [s.id, ...s.fields.map((f) => f.id)]));
659
+ const source = definition.texts[defaultLanguage] ?? {};
660
+ const owed = Object.keys(source)
661
+ .filter((id) => nonBlank(source[id]) !== undefined && isLiveTextId(id, elementIds))
662
+ .sort();
663
+ return languages.map((language) => {
664
+ if (language === defaultLanguage)
665
+ return { language, missing: [] };
666
+ const own = definition.texts[language] ?? {};
667
+ return { language, missing: owed.filter((id) => nonBlank(own[id]) === undefined) };
668
+ });
669
+ }
670
+ // --- Entry helpers -----------------------------------------------------------------------------
671
+ function inputFields(definition) {
672
+ return definition.sections.flatMap((section) => section.fields.filter(isInputField));
673
+ }
674
+ /** The answers that `shareWithIntegrations` fields of this version expose. FR-064. */
675
+ export function sharedAnswers(definition, answers) {
676
+ const shared = {};
677
+ for (const field of inputFields(definition)) {
678
+ if (field.shareWithIntegrations && Object.prototype.hasOwnProperty.call(answers, field.key)) {
679
+ shared[field.key] = answers[field.key];
680
+ }
681
+ }
682
+ return shared;
683
+ }
684
+ const SEARCHABLE_TYPES = new Set(['text', 'textarea', 'email', 'phone']);
685
+ /** Text answers joined for search, lower-cased, capped. R-18 (hidden values excluded). */
686
+ export function searchTextOf(definition, answers) {
687
+ const parts = [];
688
+ for (const field of inputFields(definition)) {
689
+ const value = answers[field.key];
690
+ if (SEARCHABLE_TYPES.has(field.type) && typeof value === 'string' && value !== '')
691
+ parts.push(value.toLowerCase());
692
+ }
693
+ return parts.join('\n').slice(0, FORMS_LIMITS.searchTextChars);
694
+ }
695
+ /** One CSV-safe cell: prefixes =, +, -, @, TAB, CR with an apostrophe. R-18. */
696
+ export function neutraliseSpreadsheetCell(value) {
697
+ return /^[=+\-@\t\r]/.test(value) ? `'${value}` : value;
698
+ }
699
+ //# sourceMappingURL=forms-logic.js.map