@endora-commerce/contracts 0.109.0 → 0.111.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 (385) hide show
  1. package/dist/accept-language.d.ts +31 -0
  2. package/dist/accept-language.js +64 -0
  3. package/dist/actor.d.ts +16 -0
  4. package/dist/addresses.d.ts +35 -0
  5. package/dist/addresses.js +8 -1
  6. package/dist/admin-actions.d.ts +2 -0
  7. package/dist/admin-actions.js +18 -0
  8. package/dist/admin-contributions.d.ts +99 -12
  9. package/dist/admin-contributions.js +36 -10
  10. package/dist/admin-roles.d.ts +17 -2
  11. package/dist/admin-users.d.ts +9 -0
  12. package/dist/admin.d.ts +114 -4
  13. package/dist/admin.js +98 -3
  14. package/dist/api-keys.d.ts +22 -0
  15. package/dist/api-keys.js +4 -0
  16. package/dist/assets-library.d.ts +45 -0
  17. package/dist/assets-library.js +20 -3
  18. package/dist/audit-logs.d.ts +12 -0
  19. package/dist/audit-logs.js +12 -0
  20. package/dist/auth.d.ts +9 -0
  21. package/dist/auth.js +9 -0
  22. package/dist/blog.d.ts +382 -22
  23. package/dist/blog.js +199 -17
  24. package/dist/carts.d.ts +423 -36
  25. package/dist/carts.js +150 -12
  26. package/dist/catalog.d.ts +379 -208
  27. package/dist/catalog.js +241 -163
  28. package/dist/cms-brand.d.ts +14 -14
  29. package/dist/cms.d.ts +71 -16
  30. package/dist/cms.js +15 -0
  31. package/dist/command-hooks.d.ts +301 -0
  32. package/dist/command-hooks.js +248 -0
  33. package/dist/common.d.ts +23 -6
  34. package/dist/common.js +25 -2
  35. package/dist/comparisons.d.ts +21 -14
  36. package/dist/comparisons.js +2 -1
  37. package/dist/credit-limits.d.ts +22 -0
  38. package/dist/credit-limits.js +35 -0
  39. package/dist/crm.d.ts +134 -78
  40. package/dist/crm.js +21 -5
  41. package/dist/custom-fields.d.ts +417 -49
  42. package/dist/custom-fields.js +142 -1
  43. package/dist/customer-accounts.d.ts +324 -22
  44. package/dist/customer-accounts.js +43 -0
  45. package/dist/customer-notifications.d.ts +143 -0
  46. package/dist/customer-notifications.js +41 -0
  47. package/dist/customers.d.ts +92 -73
  48. package/dist/customers.js +98 -10
  49. package/dist/dictionary.d.ts +53 -0
  50. package/dist/dictionary.js +25 -0
  51. package/dist/document-templates.d.ts +12 -12
  52. package/dist/email.d.ts +34 -0
  53. package/dist/email.js +6 -0
  54. package/dist/errors.d.ts +431 -3
  55. package/dist/errors.js +523 -3
  56. package/dist/forms-logic.d.ts +79 -0
  57. package/dist/forms-logic.fixtures.d.ts +52 -0
  58. package/dist/forms-logic.fixtures.js +610 -0
  59. package/dist/forms-logic.js +699 -0
  60. package/dist/forms.d.ts +9833 -0
  61. package/dist/forms.js +827 -0
  62. package/dist/i18n.d.ts +34 -0
  63. package/dist/i18n.js +15 -0
  64. package/dist/import-export.d.ts +180 -0
  65. package/dist/import-export.js +60 -0
  66. package/dist/index.d.ts +16 -1
  67. package/dist/index.js +30 -1
  68. package/dist/inventory.d.ts +9 -9
  69. package/dist/invoice-ledger.d.ts +13 -13
  70. package/dist/invoices.d.ts +126 -0
  71. package/dist/invoices.js +53 -0
  72. package/dist/line-bounds.d.ts +53 -0
  73. package/dist/line-bounds.js +65 -0
  74. package/dist/megamenu.d.ts +27 -27
  75. package/dist/mfa.d.ts +210 -4
  76. package/dist/mfa.js +136 -0
  77. package/dist/modules.d.ts +56 -8
  78. package/dist/modules.js +128 -3
  79. package/dist/money-decimal.d.ts +54 -0
  80. package/dist/money-decimal.js +95 -0
  81. package/dist/newsletter.d.ts +4 -4
  82. package/dist/orders.d.ts +246 -12
  83. package/dist/orders.js +140 -7
  84. package/dist/organization-hooks.d.ts +99 -0
  85. package/dist/organization-hooks.js +22 -0
  86. package/dist/organization-registry-lookup.d.ts +362 -0
  87. package/dist/organization-registry-lookup.js +196 -0
  88. package/dist/organization-roles.d.ts +341 -0
  89. package/dist/organization-roles.js +218 -0
  90. package/dist/organizations.d.ts +1074 -103
  91. package/dist/organizations.js +293 -28
  92. package/dist/page-builder-props.d.ts +56 -56
  93. package/dist/pim-connector.d.ts +7 -3
  94. package/dist/pim-connector.js +6 -2
  95. package/dist/pim-field-path.d.ts +5 -1
  96. package/dist/pim-field-path.js +37 -81
  97. package/dist/pim-locale-mapping.d.ts +131 -0
  98. package/dist/pim-locale-mapping.js +193 -0
  99. package/dist/price-books.d.ts +215 -63
  100. package/dist/price-books.js +47 -2
  101. package/dist/price-lists.d.ts +13 -10
  102. package/dist/product-feeds.d.ts +249 -100
  103. package/dist/product-feeds.js +46 -2
  104. package/dist/product-scope-model.d.ts +161 -0
  105. package/dist/product-scope-model.js +161 -0
  106. package/dist/product-scope-overrides.d.ts +0 -103
  107. package/dist/product-scope-overrides.js +0 -54
  108. package/dist/product-scoped-values.d.ts +2610 -0
  109. package/dist/product-scoped-values.js +425 -0
  110. package/dist/product-scopes.d.ts +199 -64
  111. package/dist/product-scopes.js +120 -23
  112. package/dist/product-tax-rates.d.ts +38 -0
  113. package/dist/product-tax-rates.js +45 -0
  114. package/dist/product-url-keys.d.ts +51 -45
  115. package/dist/product-url-keys.js +73 -39
  116. package/dist/product-value-resolver.d.ts +37 -60
  117. package/dist/product-value-resolver.js +36 -96
  118. package/dist/projects.d.ts +76 -28
  119. package/dist/projects.js +53 -9
  120. package/dist/promotions.d.ts +163 -11
  121. package/dist/promotions.js +23 -1
  122. package/dist/pwa.d.ts +41 -2
  123. package/dist/quick-order.d.ts +159 -9
  124. package/dist/quick-order.js +79 -4
  125. package/dist/quote-requests.d.ts +231 -17
  126. package/dist/quote-requests.js +111 -9
  127. package/dist/record-references.d.ts +15 -15
  128. package/dist/record-references.js +2 -3
  129. package/dist/record-rich-text.js +2 -1
  130. package/dist/returns.d.ts +214 -52
  131. package/dist/returns.js +143 -28
  132. package/dist/sales-channels.d.ts +34 -3
  133. package/dist/sales-channels.js +16 -1
  134. package/dist/saved-list-views.d.ts +28 -0
  135. package/dist/saved-list-views.js +14 -1
  136. package/dist/schema-extensions.d.ts +36 -0
  137. package/dist/schema-extensions.js +29 -0
  138. package/dist/scoped-write-encoding.d.ts +100 -0
  139. package/dist/scoped-write-encoding.js +135 -0
  140. package/dist/search.d.ts +18 -16
  141. package/dist/seo.d.ts +83 -30
  142. package/dist/seo.js +8 -1
  143. package/dist/settings.d.ts +173 -2
  144. package/dist/settings.js +53 -2
  145. package/dist/shopping-lists.d.ts +63 -4
  146. package/dist/shopping-lists.js +57 -3
  147. package/dist/storefront-cache-tags.d.ts +22 -0
  148. package/dist/storefront-cache-tags.js +12 -0
  149. package/dist/storefront-value-overrides.d.ts +18 -56
  150. package/dist/storefront-value-overrides.js +11 -86
  151. package/dist/tasks.d.ts +27 -27
  152. package/dist/taxes.d.ts +27 -0
  153. package/dist/taxes.js +4 -0
  154. package/dist/transactional-emails.d.ts +48 -22
  155. package/dist/webhooks.d.ts +75 -0
  156. package/dist/webhooks.js +24 -0
  157. package/package.json +5 -3
  158. package/dist/actor.d.ts.map +0 -1
  159. package/dist/actor.js.map +0 -1
  160. package/dist/addresses.d.ts.map +0 -1
  161. package/dist/addresses.js.map +0 -1
  162. package/dist/admin-actions.d.ts.map +0 -1
  163. package/dist/admin-actions.js.map +0 -1
  164. package/dist/admin-contributions.d.ts.map +0 -1
  165. package/dist/admin-contributions.js.map +0 -1
  166. package/dist/admin-feedback.d.ts.map +0 -1
  167. package/dist/admin-feedback.js.map +0 -1
  168. package/dist/admin-i18n.d.ts.map +0 -1
  169. package/dist/admin-i18n.js.map +0 -1
  170. package/dist/admin-name.d.ts.map +0 -1
  171. package/dist/admin-name.js.map +0 -1
  172. package/dist/admin-notifications.d.ts.map +0 -1
  173. package/dist/admin-notifications.js.map +0 -1
  174. package/dist/admin-preferences.d.ts.map +0 -1
  175. package/dist/admin-preferences.js.map +0 -1
  176. package/dist/admin-roles.d.ts.map +0 -1
  177. package/dist/admin-roles.js.map +0 -1
  178. package/dist/admin-search.d.ts.map +0 -1
  179. package/dist/admin-search.js.map +0 -1
  180. package/dist/admin-users.d.ts.map +0 -1
  181. package/dist/admin-users.js.map +0 -1
  182. package/dist/admin.d.ts.map +0 -1
  183. package/dist/admin.js.map +0 -1
  184. package/dist/analytics.d.ts.map +0 -1
  185. package/dist/analytics.js.map +0 -1
  186. package/dist/api-keys.d.ts.map +0 -1
  187. package/dist/api-keys.js.map +0 -1
  188. package/dist/assets-library.d.ts.map +0 -1
  189. package/dist/assets-library.js.map +0 -1
  190. package/dist/audit-logs.d.ts.map +0 -1
  191. package/dist/audit-logs.js.map +0 -1
  192. package/dist/auth.d.ts.map +0 -1
  193. package/dist/auth.js.map +0 -1
  194. package/dist/blog.d.ts.map +0 -1
  195. package/dist/blog.js.map +0 -1
  196. package/dist/capabilities.d.ts.map +0 -1
  197. package/dist/capabilities.js.map +0 -1
  198. package/dist/carts.d.ts.map +0 -1
  199. package/dist/carts.js.map +0 -1
  200. package/dist/catalog.d.ts.map +0 -1
  201. package/dist/catalog.js.map +0 -1
  202. package/dist/cms-brand.d.ts.map +0 -1
  203. package/dist/cms-brand.js.map +0 -1
  204. package/dist/cms-contact-form.d.ts.map +0 -1
  205. package/dist/cms-contact-form.js.map +0 -1
  206. package/dist/cms.d.ts.map +0 -1
  207. package/dist/cms.js.map +0 -1
  208. package/dist/common.d.ts.map +0 -1
  209. package/dist/common.js.map +0 -1
  210. package/dist/comparisons.d.ts.map +0 -1
  211. package/dist/comparisons.js.map +0 -1
  212. package/dist/credentials.d.ts.map +0 -1
  213. package/dist/credentials.js.map +0 -1
  214. package/dist/credit-limits.d.ts.map +0 -1
  215. package/dist/credit-limits.js.map +0 -1
  216. package/dist/crm-rich-text.d.ts.map +0 -1
  217. package/dist/crm-rich-text.js.map +0 -1
  218. package/dist/crm.d.ts.map +0 -1
  219. package/dist/crm.js.map +0 -1
  220. package/dist/currencies.d.ts.map +0 -1
  221. package/dist/currencies.js.map +0 -1
  222. package/dist/custom-fields.d.ts.map +0 -1
  223. package/dist/custom-fields.js.map +0 -1
  224. package/dist/customer-accounts.d.ts.map +0 -1
  225. package/dist/customer-accounts.js.map +0 -1
  226. package/dist/customers.d.ts.map +0 -1
  227. package/dist/customers.js.map +0 -1
  228. package/dist/dictionary.d.ts.map +0 -1
  229. package/dist/dictionary.js.map +0 -1
  230. package/dist/document-templates.d.ts.map +0 -1
  231. package/dist/document-templates.js.map +0 -1
  232. package/dist/document-values.d.ts.map +0 -1
  233. package/dist/document-values.js.map +0 -1
  234. package/dist/email-address.d.ts.map +0 -1
  235. package/dist/email-address.js.map +0 -1
  236. package/dist/email.d.ts.map +0 -1
  237. package/dist/email.js.map +0 -1
  238. package/dist/envelopes.d.ts.map +0 -1
  239. package/dist/envelopes.js.map +0 -1
  240. package/dist/environment-inputs.d.ts.map +0 -1
  241. package/dist/environment-inputs.js.map +0 -1
  242. package/dist/erp-connector.d.ts.map +0 -1
  243. package/dist/erp-connector.js.map +0 -1
  244. package/dist/errors.d.ts.map +0 -1
  245. package/dist/errors.js.map +0 -1
  246. package/dist/google-analytics.d.ts.map +0 -1
  247. package/dist/google-analytics.js.map +0 -1
  248. package/dist/google-tag-manager.d.ts.map +0 -1
  249. package/dist/google-tag-manager.js.map +0 -1
  250. package/dist/i18n.d.ts.map +0 -1
  251. package/dist/i18n.js.map +0 -1
  252. package/dist/import-export.d.ts.map +0 -1
  253. package/dist/import-export.js.map +0 -1
  254. package/dist/index.d.ts.map +0 -1
  255. package/dist/index.js.map +0 -1
  256. package/dist/inventory.d.ts.map +0 -1
  257. package/dist/inventory.js.map +0 -1
  258. package/dist/invoice-ledger.d.ts.map +0 -1
  259. package/dist/invoice-ledger.js.map +0 -1
  260. package/dist/invoices.d.ts.map +0 -1
  261. package/dist/invoices.js.map +0 -1
  262. package/dist/kernel.d.ts.map +0 -1
  263. package/dist/kernel.js.map +0 -1
  264. package/dist/languages.d.ts.map +0 -1
  265. package/dist/languages.js.map +0 -1
  266. package/dist/line-groups.d.ts.map +0 -1
  267. package/dist/line-groups.js.map +0 -1
  268. package/dist/linkedin-ads.d.ts.map +0 -1
  269. package/dist/linkedin-ads.js.map +0 -1
  270. package/dist/localized-name.d.ts.map +0 -1
  271. package/dist/localized-name.js.map +0 -1
  272. package/dist/megamenu.d.ts.map +0 -1
  273. package/dist/megamenu.js.map +0 -1
  274. package/dist/meta-ads.d.ts.map +0 -1
  275. package/dist/meta-ads.js.map +0 -1
  276. package/dist/mfa.d.ts.map +0 -1
  277. package/dist/mfa.js.map +0 -1
  278. package/dist/modules.d.ts.map +0 -1
  279. package/dist/modules.js.map +0 -1
  280. package/dist/money-decimal.d.ts.map +0 -1
  281. package/dist/money-decimal.js.map +0 -1
  282. package/dist/money-input.d.ts.map +0 -1
  283. package/dist/money-input.js.map +0 -1
  284. package/dist/newsletter.d.ts.map +0 -1
  285. package/dist/newsletter.js.map +0 -1
  286. package/dist/order-minimums.d.ts.map +0 -1
  287. package/dist/order-minimums.js.map +0 -1
  288. package/dist/orders.d.ts.map +0 -1
  289. package/dist/orders.js.map +0 -1
  290. package/dist/organizations.d.ts.map +0 -1
  291. package/dist/organizations.js.map +0 -1
  292. package/dist/page-builder-props.d.ts.map +0 -1
  293. package/dist/page-builder-props.js.map +0 -1
  294. package/dist/page-builder-values.d.ts.map +0 -1
  295. package/dist/page-builder-values.js.map +0 -1
  296. package/dist/pagination.d.ts.map +0 -1
  297. package/dist/pagination.js.map +0 -1
  298. package/dist/payment-methods.d.ts.map +0 -1
  299. package/dist/payment-methods.js.map +0 -1
  300. package/dist/payment-return-url.d.ts.map +0 -1
  301. package/dist/payment-return-url.js.map +0 -1
  302. package/dist/payments.d.ts.map +0 -1
  303. package/dist/payments.js.map +0 -1
  304. package/dist/pim-connector.d.ts.map +0 -1
  305. package/dist/pim-connector.js.map +0 -1
  306. package/dist/pim-field-path.d.ts.map +0 -1
  307. package/dist/pim-field-path.js.map +0 -1
  308. package/dist/platform-info.d.ts.map +0 -1
  309. package/dist/platform-info.js.map +0 -1
  310. package/dist/platform-language.d.ts.map +0 -1
  311. package/dist/platform-language.js.map +0 -1
  312. package/dist/price-book-decimal.d.ts.map +0 -1
  313. package/dist/price-book-decimal.js.map +0 -1
  314. package/dist/price-books.d.ts.map +0 -1
  315. package/dist/price-books.js.map +0 -1
  316. package/dist/price-lists.d.ts.map +0 -1
  317. package/dist/price-lists.js.map +0 -1
  318. package/dist/product-feeds.d.ts.map +0 -1
  319. package/dist/product-feeds.js.map +0 -1
  320. package/dist/product-scope-overrides.d.ts.map +0 -1
  321. package/dist/product-scope-overrides.js.map +0 -1
  322. package/dist/product-scopes.d.ts.map +0 -1
  323. package/dist/product-scopes.js.map +0 -1
  324. package/dist/product-summary-text.d.ts.map +0 -1
  325. package/dist/product-summary-text.js.map +0 -1
  326. package/dist/product-url-keys.d.ts.map +0 -1
  327. package/dist/product-url-keys.js.map +0 -1
  328. package/dist/product-value-resolver.d.ts.map +0 -1
  329. package/dist/product-value-resolver.js.map +0 -1
  330. package/dist/projects.d.ts.map +0 -1
  331. package/dist/projects.js.map +0 -1
  332. package/dist/promotions.d.ts.map +0 -1
  333. package/dist/promotions.js.map +0 -1
  334. package/dist/prompt-actions.d.ts.map +0 -1
  335. package/dist/prompt-actions.js.map +0 -1
  336. package/dist/pwa.d.ts.map +0 -1
  337. package/dist/pwa.js.map +0 -1
  338. package/dist/quick-order.d.ts.map +0 -1
  339. package/dist/quick-order.js.map +0 -1
  340. package/dist/quote-requests.d.ts.map +0 -1
  341. package/dist/quote-requests.js.map +0 -1
  342. package/dist/record-references.d.ts.map +0 -1
  343. package/dist/record-references.js.map +0 -1
  344. package/dist/record-rich-text.d.ts.map +0 -1
  345. package/dist/record-rich-text.js.map +0 -1
  346. package/dist/returns.d.ts.map +0 -1
  347. package/dist/returns.js.map +0 -1
  348. package/dist/sales-channels.d.ts.map +0 -1
  349. package/dist/sales-channels.js.map +0 -1
  350. package/dist/saved-list-views.d.ts.map +0 -1
  351. package/dist/saved-list-views.js.map +0 -1
  352. package/dist/scope-notice.d.ts.map +0 -1
  353. package/dist/scope-notice.js.map +0 -1
  354. package/dist/scoped-translations.d.ts +0 -48
  355. package/dist/scoped-translations.d.ts.map +0 -1
  356. package/dist/scoped-translations.js +0 -78
  357. package/dist/scoped-translations.js.map +0 -1
  358. package/dist/search.d.ts.map +0 -1
  359. package/dist/search.js.map +0 -1
  360. package/dist/seo.d.ts.map +0 -1
  361. package/dist/seo.js.map +0 -1
  362. package/dist/settings.d.ts.map +0 -1
  363. package/dist/settings.js.map +0 -1
  364. package/dist/shipments.d.ts.map +0 -1
  365. package/dist/shipments.js.map +0 -1
  366. package/dist/shipping-methods.d.ts.map +0 -1
  367. package/dist/shipping-methods.js.map +0 -1
  368. package/dist/shopping-lists.d.ts.map +0 -1
  369. package/dist/shopping-lists.js.map +0 -1
  370. package/dist/storefront-cache-tags.d.ts.map +0 -1
  371. package/dist/storefront-cache-tags.js.map +0 -1
  372. package/dist/storefront-language-path.d.ts.map +0 -1
  373. package/dist/storefront-language-path.js.map +0 -1
  374. package/dist/storefront-value-overrides.d.ts.map +0 -1
  375. package/dist/storefront-value-overrides.js.map +0 -1
  376. package/dist/tasks.d.ts.map +0 -1
  377. package/dist/tasks.js.map +0 -1
  378. package/dist/taxes.d.ts.map +0 -1
  379. package/dist/taxes.js.map +0 -1
  380. package/dist/text-normalization.d.ts.map +0 -1
  381. package/dist/text-normalization.js.map +0 -1
  382. package/dist/transactional-emails.d.ts.map +0 -1
  383. package/dist/transactional-emails.js.map +0 -1
  384. package/dist/webhooks.d.ts.map +0 -1
  385. package/dist/webhooks.js.map +0 -1
@@ -1,21 +1,19 @@
1
1
  /**
2
- * Feature 022 — product value resolver.
2
+ * Feature 022, rewritten by feature 174 (`specs/174-product-editor-scope-switcher/`, research R1) —
3
+ * the product value resolver over `product_value_overrides` rows.
3
4
  *
4
- * Pure-function fusion of (baseline + channel-aware overrides) into an
5
- * effective value per (channelId, languageCode) context. This file
6
- * is the SINGLE source of truth for the four-scope fallback chain:
7
- * the backend imports it from `@endora-commerce/contracts` (no behavioural
8
- * duplication in `backend/src/modules/catalog/services/...`) and the
9
- * admin SPA imports it to compute its "effective-value preview"
10
- * client-side so switcher toggles do not need a network round-trip.
5
+ * The fallback chain is {@link resolveScoped}'s — C×L → C → G, restricted to the field's scope
6
+ * set, a present row winning whatever it holds and `{ "v": null }` being an empty override
7
+ * (FR-013). This file only adapts the override table's row shape to {@link ScopedRow}; it adds no
8
+ * second chain. There is no Language level and no "primary language" (FR-010, FR-014): the Global
9
+ * value is one value.
11
10
  *
12
- * The matrix below MUST stay aligned with
13
- * specs/023-product-scope-editor/contracts/resolver.contract.md §5.
11
+ * Shared by the backend and the admin SPA through `@endora-commerce/contracts`.
14
12
  */
13
+ import { resolveScoped, } from './product-scope-model.js';
15
14
  /**
16
- * Whether a value counts as present: not `undefined`/`null`, and not an empty
17
- * string, array or object. Shared with `storefront-value-overrides`, whose
18
- * walk stops where the baseline holds a value by this same definition.
15
+ * Whether a value counts as present: not `undefined` / `null`, and not an empty string, array or
16
+ * object. A helper for Global values read from a JSON column; never used to skip an override row.
19
17
  */
20
18
  export function isNonEmpty(v) {
21
19
  if (v === undefined || v === null)
@@ -28,92 +26,34 @@ export function isNonEmpty(v) {
28
26
  return Object.keys(v).length > 0;
29
27
  return true;
30
28
  }
31
- function pickLang(baseline, lang) {
32
- if (baseline === null || baseline === undefined)
33
- return undefined;
34
- if (typeof baseline !== 'object')
35
- return undefined;
36
- return baseline[lang];
29
+ /** The scope a {@link ResolverContext} names. A language without a channel resolves at Global. */
30
+ export function scopeOfContext(ctx) {
31
+ if (ctx.channelId === null)
32
+ return { level: 'global' };
33
+ if (ctx.languageCode === null)
34
+ return { level: 'channel', channelId: ctx.channelId };
35
+ return { level: 'channel_language', channelId: ctx.channelId, languageCode: ctx.languageCode };
37
36
  }
38
- function firstNonEmpty(baseline) {
39
- if (baseline === null || baseline === undefined)
40
- return undefined;
41
- if (typeof baseline !== 'object')
42
- return baseline;
43
- const keys = Object.keys(baseline).sort();
44
- for (const k of keys) {
45
- const v = baseline[k];
46
- if (isNonEmpty(v))
47
- return v;
48
- }
49
- return undefined;
37
+ /** One override row as a {@link ScopedRow}: `{ v: null }` (or a missing `v`) is the empty override. */
38
+ export function overrideToScopedRow(row) {
39
+ const v = row.value?.v;
40
+ return {
41
+ channelId: row.channelId,
42
+ languageCode: row.languageCode,
43
+ value: v === null || v === undefined ? { kind: 'empty' } : { kind: 'value', value: v },
44
+ };
50
45
  }
51
- /**
52
- * Resolve one attribute value for the given context using the four-step
53
- * fallback chain. The resolver is tolerant of "orphan" override rows
54
- * left behind when an attribute's scope flags were toggled after writes
55
- * happened — orphan rows are silently skipped (matrix row 12).
56
- */
46
+ /** Resolve one attribute value in `ctx`. Rows of another key, channel or language never match. */
57
47
  export function resolveAttribute(args) {
58
- const { baseline, overrides, attributeKey, scope, ctx } = args;
59
- const matching = overrides.filter((o) => o.attributeKey === attributeKey);
60
- // Step 1 — channel + language slot.
61
- if (scope.channelScoped &&
62
- scope.languageScoped &&
63
- ctx.channelId !== null &&
64
- ctx.languageCode !== null) {
65
- const hit = matching.find((o) => o.channelId === ctx.channelId && o.languageCode === ctx.languageCode);
66
- if (hit && isNonEmpty(hit.value.v)) {
67
- return { value: hit.value.v, source: 'channel+language' };
68
- }
69
- }
70
- // Step 2 — channel-only slot. Reachable when the attribute is
71
- // channel-scoped AND we have a channel context. Honored regardless
72
- // of whether the attribute is also language-scoped: a per-channel
73
- // "language-agnostic" override (a row written when the flag was
74
- // different, or a deliberate language-agnostic channel override)
75
- // still wins over the global baseline.
76
- if (scope.channelScoped && ctx.channelId !== null) {
77
- const hit = matching.find((o) => o.channelId === ctx.channelId && o.languageCode === null);
78
- if (hit && isNonEmpty(hit.value.v)) {
79
- return { value: hit.value.v, source: 'channel' };
80
- }
81
- }
82
- // Step 3 — global + language baseline (for language-scoped attrs).
83
- // Only emit source `'global+language'` when the caller asked for a
84
- // specific language AND we found it. When `ctx.languageCode` is null
85
- // (e.g., "Global / no language" admin view), the primary-language
86
- // fallback is reported as `'global'` so the editor's "inherited from
87
- // X" badge does not falsely claim a language-specific hit.
88
- if (scope.languageScoped) {
89
- if (ctx.languageCode !== null) {
90
- const direct = pickLang(baseline, ctx.languageCode);
91
- if (isNonEmpty(direct)) {
92
- return { value: direct, source: 'global+language' };
93
- }
94
- }
95
- const fallbackPrimary = pickLang(baseline, ctx.primaryLanguage);
96
- if (isNonEmpty(fallbackPrimary)) {
97
- return { value: fallbackPrimary, source: 'global' };
98
- }
99
- const anyLang = firstNonEmpty(baseline);
100
- if (isNonEmpty(anyLang)) {
101
- return { value: anyLang, source: 'global' };
102
- }
103
- return { value: null, source: 'absent' };
104
- }
105
- // Step 4 — pure global (non-language-scoped attribute).
106
- if (isNonEmpty(baseline)) {
107
- return { value: baseline, source: 'global' };
108
- }
109
- return { value: null, source: 'absent' };
48
+ const rows = args.overrides.filter((o) => o.attributeKey === args.attributeKey).map(overrideToScopedRow);
49
+ return resolveScoped({
50
+ global: args.baseline === undefined ? null : args.baseline,
51
+ rows,
52
+ scope: scopeOfContext(args.ctx),
53
+ levels: args.levels,
54
+ });
110
55
  }
111
- /**
112
- * Bulk resolve every attribute for one product in one (ctx) pass.
113
- * Loops `attributeDefs` and applies `resolveAttribute` per entry; the
114
- * `sources` map is for the admin UI and may be ignored by the
115
- * storefront.
116
- */
56
+ /** Resolve every attribute of one product in one context. */
117
57
  export function resolveAll(attributeDefs, overrides, ctx) {
118
58
  const values = {};
119
59
  const sources = {};
@@ -121,7 +61,7 @@ export function resolveAll(attributeDefs, overrides, ctx) {
121
61
  const { value, source } = resolveAttribute({
122
62
  attributeKey: def.attributeKey,
123
63
  baseline: def.baseline,
124
- scope: def.scope,
64
+ levels: def.levels,
125
65
  overrides,
126
66
  ctx,
127
67
  });
@@ -42,8 +42,8 @@ export declare const projectVisibilitySchema: z.ZodEnum<{
42
42
  export type ProjectVisibility = z.infer<typeof projectVisibilitySchema>;
43
43
  /** The module setting `projects.visibility` (FR-018); default `members`. */
44
44
  export declare const projectVisibilitySettingSchema: z.ZodEnum<{
45
- everyone: "everyone";
46
45
  members: "members";
46
+ everyone: "everyone";
47
47
  }>;
48
48
  export type ProjectVisibilitySetting = z.infer<typeof projectVisibilitySettingSchema>;
49
49
  /** What a Project links to (R-10). */
@@ -57,8 +57,8 @@ export type ProjectRecordKind = z.infer<typeof projectRecordKindSchema>;
57
57
  export declare const projectPanelRecordKindSchema: z.ZodEnum<{
58
58
  order: "order";
59
59
  quote_request: "quote_request";
60
- task: "task";
61
60
  opportunity: "opportunity";
61
+ task: "task";
62
62
  }>;
63
63
  export type ProjectPanelRecordKind = z.infer<typeof projectPanelRecordKindSchema>;
64
64
  export declare const projectCommentKindSchema: z.ZodEnum<{
@@ -254,8 +254,9 @@ export declare const UpdateProjectBodySchema: z.ZodObject<{
254
254
  version: z.ZodNumber;
255
255
  }, z.core.$strict>;
256
256
  export type UpdateProjectBody = z.infer<typeof UpdateProjectBodySchema>;
257
- /** `PUT /projects/:id/organizations` — the whole set (409 `PROJECT_ORGANIZATION_IN_USE`). */
257
+ /** `PUT /projects/:id/organizations` — the whole set, in one transaction (409 `PROJECT_ORGANIZATION_IN_USE`). */
258
258
  export declare const SetProjectOrganizationsBodySchema: z.ZodObject<{
259
+ configurationVersion: z.ZodOptional<z.ZodNumber>;
259
260
  organizationIds: z.ZodArray<z.ZodString>;
260
261
  }, z.core.$strict>;
261
262
  export type SetProjectOrganizationsBody = z.infer<typeof SetProjectOrganizationsBodySchema>;
@@ -273,6 +274,7 @@ export declare const ProjectOutOfReachAfterWriteSchema: z.ZodObject<{
273
274
  export type ProjectOutOfReachAfterWrite = z.infer<typeof ProjectOutOfReachAfterWriteSchema>;
274
275
  /** `PUT /projects/:id/members` — the whole set, Members and their Roles, in one Command. */
275
276
  export declare const SetProjectMembersBodySchema: z.ZodObject<{
277
+ configurationVersion: z.ZodOptional<z.ZodNumber>;
276
278
  members: z.ZodArray<z.ZodObject<{
277
279
  adminUserId: z.ZodString;
278
280
  roleIds: z.ZodArray<z.ZodString>;
@@ -281,6 +283,7 @@ export declare const SetProjectMembersBodySchema: z.ZodObject<{
281
283
  export type SetProjectMembersBody = z.infer<typeof SetProjectMembersBodySchema>;
282
284
  /** `POST /projects/:id/stages`. */
283
285
  export declare const CreateProjectStageBodySchema: z.ZodObject<{
286
+ configurationVersion: z.ZodOptional<z.ZodNumber>;
284
287
  name: z.ZodString;
285
288
  color: z.ZodString;
286
289
  plannedDurationDays: z.ZodOptional<z.ZodNumber>;
@@ -304,10 +307,12 @@ export declare const UpdateProjectStageBodySchema: z.ZodObject<{
304
307
  alertOffsetsDays: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodNumber>>>;
305
308
  completionGate: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
306
309
  completionPermitted: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
310
+ version: z.ZodOptional<z.ZodNumber>;
307
311
  }, z.core.$strict>;
308
312
  export type UpdateProjectStageBody = z.infer<typeof UpdateProjectStageBodySchema>;
309
313
  /** `PUT /projects/:id/stages/order` — every Stage id of the Project, in the new order. */
310
314
  export declare const ReorderProjectStagesBodySchema: z.ZodObject<{
315
+ configurationVersion: z.ZodOptional<z.ZodNumber>;
311
316
  stageIds: z.ZodArray<z.ZodString>;
312
317
  }, z.core.$strict>;
313
318
  export type ReorderProjectStagesBody = z.infer<typeof ReorderProjectStagesBodySchema>;
@@ -318,6 +323,7 @@ export declare const ProjectStageMoveSchema: z.ZodObject<{
318
323
  export type ProjectStageMove = z.infer<typeof ProjectStageMoveSchema>;
319
324
  /** `PUT /projects/:id/moves` — the whole set of permitted moves (FR-011). */
320
325
  export declare const SetProjectMovesBodySchema: z.ZodObject<{
326
+ configurationVersion: z.ZodOptional<z.ZodNumber>;
321
327
  moves: z.ZodArray<z.ZodObject<{
322
328
  fromStageId: z.ZodString;
323
329
  toStageId: z.ZodString;
@@ -326,6 +332,7 @@ export declare const SetProjectMovesBodySchema: z.ZodObject<{
326
332
  export type SetProjectMovesBody = z.infer<typeof SetProjectMovesBodySchema>;
327
333
  /** `PUT /projects/:id/stages/:stageId/tasks` — the Stage's Task definitions, replaced whole. */
328
334
  export declare const SetProjectStageTasksBodySchema: z.ZodObject<{
335
+ version: z.ZodOptional<z.ZodNumber>;
329
336
  tasks: z.ZodArray<z.ZodObject<{
330
337
  title: z.ZodString;
331
338
  description: z.ZodOptional<z.ZodString>;
@@ -375,8 +382,8 @@ export declare const RecordProjectParamsSchema: z.ZodObject<{
375
382
  kind: z.ZodEnum<{
376
383
  order: "order";
377
384
  quote_request: "quote_request";
378
- task: "task";
379
385
  opportunity: "opportunity";
386
+ task: "task";
380
387
  }>;
381
388
  recordId: z.ZodString;
382
389
  }, z.core.$strip>;
@@ -672,6 +679,7 @@ export declare const ProjectStageSchema: z.ZodObject<{
672
679
  id: z.ZodString;
673
680
  position: z.ZodNumber;
674
681
  }, z.core.$strict>>;
682
+ version: z.ZodNumber;
675
683
  }, z.core.$strip>;
676
684
  export type ProjectStage = z.infer<typeof ProjectStageSchema>;
677
685
  export declare const ProjectMemberSchema: z.ZodObject<{
@@ -722,13 +730,13 @@ export declare const ProjectDetailSchema: z.ZodObject<{
722
730
  description: z.ZodString;
723
731
  references: z.ZodArray<z.ZodObject<{
724
732
  type: z.ZodEnum<{
725
- product: "product";
726
733
  order: "order";
727
- admin_user: "admin_user";
728
734
  quote_request: "quote_request";
729
- task: "task";
735
+ product: "product";
730
736
  opportunity: "opportunity";
731
737
  project: "project";
738
+ task: "task";
739
+ admin_user: "admin_user";
732
740
  }>;
733
741
  id: z.ZodString;
734
742
  available: z.ZodBoolean;
@@ -786,6 +794,7 @@ export declare const ProjectDetailSchema: z.ZodObject<{
786
794
  id: z.ZodString;
787
795
  position: z.ZodNumber;
788
796
  }, z.core.$strict>>;
797
+ version: z.ZodNumber;
789
798
  }, z.core.$strip>>;
790
799
  moves: z.ZodArray<z.ZodObject<{
791
800
  fromStageId: z.ZodString;
@@ -810,6 +819,7 @@ export declare const ProjectDetailSchema: z.ZodObject<{
810
819
  unreadMessageCount: z.ZodNumber;
811
820
  customFieldValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
812
821
  version: z.ZodNumber;
822
+ configurationVersion: z.ZodNumber;
813
823
  permissions: z.ZodObject<{
814
824
  canWrite: z.ZodBoolean;
815
825
  canConfigure: z.ZodBoolean;
@@ -846,6 +856,7 @@ export declare const SetProjectMovesResultSchema: z.ZodObject<{
846
856
  toStageId: z.ZodString;
847
857
  }, z.core.$strip>>;
848
858
  unreachableStageIds: z.ZodArray<z.ZodString>;
859
+ configurationVersion: z.ZodNumber;
849
860
  }, z.core.$strip>;
850
861
  export type SetProjectMovesResult = z.infer<typeof SetProjectMovesResultSchema>;
851
862
  /** `POST /projects/:id/move` — the Project after the move and what the move recorded. */
@@ -883,13 +894,13 @@ export declare const ProjectMoveResultSchema: z.ZodObject<{
883
894
  description: z.ZodString;
884
895
  references: z.ZodArray<z.ZodObject<{
885
896
  type: z.ZodEnum<{
886
- product: "product";
887
897
  order: "order";
888
- admin_user: "admin_user";
889
898
  quote_request: "quote_request";
890
- task: "task";
899
+ product: "product";
891
900
  opportunity: "opportunity";
892
901
  project: "project";
902
+ task: "task";
903
+ admin_user: "admin_user";
893
904
  }>;
894
905
  id: z.ZodString;
895
906
  available: z.ZodBoolean;
@@ -947,6 +958,7 @@ export declare const ProjectMoveResultSchema: z.ZodObject<{
947
958
  id: z.ZodString;
948
959
  position: z.ZodNumber;
949
960
  }, z.core.$strict>>;
961
+ version: z.ZodNumber;
950
962
  }, z.core.$strip>>;
951
963
  moves: z.ZodArray<z.ZodObject<{
952
964
  fromStageId: z.ZodString;
@@ -971,6 +983,7 @@ export declare const ProjectMoveResultSchema: z.ZodObject<{
971
983
  unreadMessageCount: z.ZodNumber;
972
984
  customFieldValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
973
985
  version: z.ZodNumber;
986
+ configurationVersion: z.ZodNumber;
974
987
  permissions: z.ZodObject<{
975
988
  canWrite: z.ZodBoolean;
976
989
  canConfigure: z.ZodBoolean;
@@ -1028,8 +1041,14 @@ export declare const ProjectLinkSchema: z.ZodObject<{
1028
1041
  available: z.ZodBoolean;
1029
1042
  number: z.ZodOptional<z.ZodString>;
1030
1043
  status: z.ZodOptional<z.ZodString>;
1044
+ statusName: z.ZodOptional<z.ZodString>;
1031
1045
  amount: z.ZodOptional<z.ZodString>;
1032
1046
  currency: z.ZodOptional<z.ZodString>;
1047
+ agreement: z.ZodOptional<z.ZodEnum<{
1048
+ none: "none";
1049
+ agreed: "agreed";
1050
+ partial: "partial";
1051
+ }>>;
1033
1052
  href: z.ZodOptional<z.ZodString>;
1034
1053
  linkedBy: z.ZodNullable<z.ZodObject<{
1035
1054
  id: z.ZodString;
@@ -1117,13 +1136,13 @@ export declare const ProjectCommentSchema: z.ZodObject<{
1117
1136
  body: z.ZodString;
1118
1137
  references: z.ZodArray<z.ZodObject<{
1119
1138
  type: z.ZodEnum<{
1120
- product: "product";
1121
1139
  order: "order";
1122
- admin_user: "admin_user";
1123
1140
  quote_request: "quote_request";
1124
- task: "task";
1141
+ product: "product";
1125
1142
  opportunity: "opportunity";
1126
1143
  project: "project";
1144
+ task: "task";
1145
+ admin_user: "admin_user";
1127
1146
  }>;
1128
1147
  id: z.ZodString;
1129
1148
  available: z.ZodBoolean;
@@ -1240,13 +1259,13 @@ export declare const ProjectDetailResponseSchema: z.ZodObject<{
1240
1259
  description: z.ZodString;
1241
1260
  references: z.ZodArray<z.ZodObject<{
1242
1261
  type: z.ZodEnum<{
1243
- product: "product";
1244
1262
  order: "order";
1245
- admin_user: "admin_user";
1246
1263
  quote_request: "quote_request";
1247
- task: "task";
1264
+ product: "product";
1248
1265
  opportunity: "opportunity";
1249
1266
  project: "project";
1267
+ task: "task";
1268
+ admin_user: "admin_user";
1250
1269
  }>;
1251
1270
  id: z.ZodString;
1252
1271
  available: z.ZodBoolean;
@@ -1304,6 +1323,7 @@ export declare const ProjectDetailResponseSchema: z.ZodObject<{
1304
1323
  id: z.ZodString;
1305
1324
  position: z.ZodNumber;
1306
1325
  }, z.core.$strict>>;
1326
+ version: z.ZodNumber;
1307
1327
  }, z.core.$strip>>;
1308
1328
  moves: z.ZodArray<z.ZodObject<{
1309
1329
  fromStageId: z.ZodString;
@@ -1328,6 +1348,7 @@ export declare const ProjectDetailResponseSchema: z.ZodObject<{
1328
1348
  unreadMessageCount: z.ZodNumber;
1329
1349
  customFieldValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
1330
1350
  version: z.ZodNumber;
1351
+ configurationVersion: z.ZodNumber;
1331
1352
  permissions: z.ZodObject<{
1332
1353
  canWrite: z.ZodBoolean;
1333
1354
  canConfigure: z.ZodBoolean;
@@ -1392,6 +1413,7 @@ export declare const ProjectStageResponseSchema: z.ZodObject<{
1392
1413
  id: z.ZodString;
1393
1414
  position: z.ZodNumber;
1394
1415
  }, z.core.$strict>>;
1416
+ version: z.ZodNumber;
1395
1417
  }, z.core.$strip>;
1396
1418
  }, z.core.$strip>;
1397
1419
  export declare const ProjectStageEntryListResponseSchema: z.ZodObject<{
@@ -1426,6 +1448,7 @@ export declare const SetProjectMovesResponseSchema: z.ZodObject<{
1426
1448
  toStageId: z.ZodString;
1427
1449
  }, z.core.$strip>>;
1428
1450
  unreachableStageIds: z.ZodArray<z.ZodString>;
1451
+ configurationVersion: z.ZodNumber;
1429
1452
  }, z.core.$strip>;
1430
1453
  }, z.core.$strip>;
1431
1454
  export declare const ProjectMoveResponseSchema: z.ZodObject<{
@@ -1463,13 +1486,13 @@ export declare const ProjectMoveResponseSchema: z.ZodObject<{
1463
1486
  description: z.ZodString;
1464
1487
  references: z.ZodArray<z.ZodObject<{
1465
1488
  type: z.ZodEnum<{
1466
- product: "product";
1467
1489
  order: "order";
1468
- admin_user: "admin_user";
1469
1490
  quote_request: "quote_request";
1470
- task: "task";
1491
+ product: "product";
1471
1492
  opportunity: "opportunity";
1472
1493
  project: "project";
1494
+ task: "task";
1495
+ admin_user: "admin_user";
1473
1496
  }>;
1474
1497
  id: z.ZodString;
1475
1498
  available: z.ZodBoolean;
@@ -1527,6 +1550,7 @@ export declare const ProjectMoveResponseSchema: z.ZodObject<{
1527
1550
  id: z.ZodString;
1528
1551
  position: z.ZodNumber;
1529
1552
  }, z.core.$strict>>;
1553
+ version: z.ZodNumber;
1530
1554
  }, z.core.$strip>>;
1531
1555
  moves: z.ZodArray<z.ZodObject<{
1532
1556
  fromStageId: z.ZodString;
@@ -1551,6 +1575,7 @@ export declare const ProjectMoveResponseSchema: z.ZodObject<{
1551
1575
  unreadMessageCount: z.ZodNumber;
1552
1576
  customFieldValues: z.ZodRecord<z.ZodString, z.ZodUnknown>;
1553
1577
  version: z.ZodNumber;
1578
+ configurationVersion: z.ZodNumber;
1554
1579
  permissions: z.ZodObject<{
1555
1580
  canWrite: z.ZodBoolean;
1556
1581
  canConfigure: z.ZodBoolean;
@@ -1604,8 +1629,14 @@ export declare const ProjectLinkResponseSchema: z.ZodObject<{
1604
1629
  available: z.ZodBoolean;
1605
1630
  number: z.ZodOptional<z.ZodString>;
1606
1631
  status: z.ZodOptional<z.ZodString>;
1632
+ statusName: z.ZodOptional<z.ZodString>;
1607
1633
  amount: z.ZodOptional<z.ZodString>;
1608
1634
  currency: z.ZodOptional<z.ZodString>;
1635
+ agreement: z.ZodOptional<z.ZodEnum<{
1636
+ none: "none";
1637
+ agreed: "agreed";
1638
+ partial: "partial";
1639
+ }>>;
1609
1640
  href: z.ZodOptional<z.ZodString>;
1610
1641
  linkedBy: z.ZodNullable<z.ZodObject<{
1611
1642
  id: z.ZodString;
@@ -1626,8 +1657,14 @@ export declare const ProjectLinkListResponseSchema: z.ZodObject<{
1626
1657
  available: z.ZodBoolean;
1627
1658
  number: z.ZodOptional<z.ZodString>;
1628
1659
  status: z.ZodOptional<z.ZodString>;
1660
+ statusName: z.ZodOptional<z.ZodString>;
1629
1661
  amount: z.ZodOptional<z.ZodString>;
1630
1662
  currency: z.ZodOptional<z.ZodString>;
1663
+ agreement: z.ZodOptional<z.ZodEnum<{
1664
+ none: "none";
1665
+ agreed: "agreed";
1666
+ partial: "partial";
1667
+ }>>;
1631
1668
  href: z.ZodOptional<z.ZodString>;
1632
1669
  linkedBy: z.ZodNullable<z.ZodObject<{
1633
1670
  id: z.ZodString;
@@ -1716,13 +1753,13 @@ export declare const ProjectCommentResponseSchema: z.ZodObject<{
1716
1753
  body: z.ZodString;
1717
1754
  references: z.ZodArray<z.ZodObject<{
1718
1755
  type: z.ZodEnum<{
1719
- product: "product";
1720
1756
  order: "order";
1721
- admin_user: "admin_user";
1722
1757
  quote_request: "quote_request";
1723
- task: "task";
1758
+ product: "product";
1724
1759
  opportunity: "opportunity";
1725
1760
  project: "project";
1761
+ task: "task";
1762
+ admin_user: "admin_user";
1726
1763
  }>;
1727
1764
  id: z.ZodString;
1728
1765
  available: z.ZodBoolean;
@@ -1754,13 +1791,13 @@ export declare const ProjectCommentListResponseSchema: z.ZodObject<{
1754
1791
  body: z.ZodString;
1755
1792
  references: z.ZodArray<z.ZodObject<{
1756
1793
  type: z.ZodEnum<{
1757
- product: "product";
1758
1794
  order: "order";
1759
- admin_user: "admin_user";
1760
1795
  quote_request: "quote_request";
1761
- task: "task";
1796
+ product: "product";
1762
1797
  opportunity: "opportunity";
1763
1798
  project: "project";
1799
+ task: "task";
1800
+ admin_user: "admin_user";
1764
1801
  }>;
1765
1802
  id: z.ZodString;
1766
1803
  available: z.ZodBoolean;
@@ -1850,16 +1887,16 @@ export declare const ProjectAdminUserLookupResponseSchema: z.ZodObject<{
1850
1887
  */
1851
1888
  export declare const ProjectVisibilitySettingSchema: z.ZodObject<{
1852
1889
  setting: z.ZodEnum<{
1853
- everyone: "everyone";
1854
1890
  members: "members";
1891
+ everyone: "everyone";
1855
1892
  }>;
1856
1893
  }, z.core.$strip>;
1857
1894
  export type ProjectVisibilitySettingInfo = z.infer<typeof ProjectVisibilitySettingSchema>;
1858
1895
  export declare const ProjectVisibilitySettingResponseSchema: z.ZodObject<{
1859
1896
  data: z.ZodObject<{
1860
1897
  setting: z.ZodEnum<{
1861
- everyone: "everyone";
1862
1898
  members: "members";
1899
+ everyone: "everyone";
1863
1900
  }>;
1864
1901
  }, z.core.$strip>;
1865
1902
  }, z.core.$strip>;
@@ -1962,7 +1999,10 @@ export declare const ProjectCurrencyAmountSchema: z.ZodObject<{
1962
1999
  export type ProjectCurrencyAmount = z.infer<typeof ProjectCurrencyAmountSchema>;
1963
2000
  /**
1964
2001
  * Every figure states the period it covers, how many Projects it was computed
1965
- * from and how many it left out for a missing value (FR-038).
2002
+ * from and how many it left out for a missing value (FR-038) — and the time
2003
+ * zone its days were counted in (issue #475): the `analytics` module's
2004
+ * reporting time zone, or `UTC` while that module is off. An IANA name;
2005
+ * additive, so a reply without it parses as before.
1966
2006
  */
1967
2007
  export declare function projectAnalyticsEnvelope<T extends z.ZodTypeAny>(data: T): z.ZodObject<{
1968
2008
  from: z.ZodString;
@@ -1971,6 +2011,7 @@ export declare function projectAnalyticsEnvelope<T extends z.ZodTypeAny>(data: T
1971
2011
  excluded: z.ZodObject<{
1972
2012
  noValue: z.ZodNumber;
1973
2013
  }, z.core.$strip>;
2014
+ timeZone: z.ZodOptional<z.ZodString>;
1974
2015
  data: T;
1975
2016
  }, z.core.$strip>;
1976
2017
  export declare const ProjectAnalyticsSummarySchema: z.ZodObject<{
@@ -2061,6 +2102,7 @@ export declare const ProjectAnalyticsSummaryResponseSchema: z.ZodObject<{
2061
2102
  excluded: z.ZodObject<{
2062
2103
  noValue: z.ZodNumber;
2063
2104
  }, z.core.$strip>;
2105
+ timeZone: z.ZodOptional<z.ZodString>;
2064
2106
  data: z.ZodObject<{
2065
2107
  opened: z.ZodNumber;
2066
2108
  completed: z.ZodNumber;
@@ -2075,6 +2117,7 @@ export declare const ProjectAnalyticsDurationsResponseSchema: z.ZodObject<{
2075
2117
  excluded: z.ZodObject<{
2076
2118
  noValue: z.ZodNumber;
2077
2119
  }, z.core.$strip>;
2120
+ timeZone: z.ZodOptional<z.ZodString>;
2078
2121
  data: z.ZodObject<{
2079
2122
  completedAverageDays: z.ZodNullable<z.ZodNumber>;
2080
2123
  completedCount: z.ZodNumber;
@@ -2089,6 +2132,7 @@ export declare const ProjectAnalyticsTimeInStageResponseSchema: z.ZodObject<{
2089
2132
  excluded: z.ZodObject<{
2090
2133
  noValue: z.ZodNumber;
2091
2134
  }, z.core.$strip>;
2135
+ timeZone: z.ZodOptional<z.ZodString>;
2092
2136
  data: z.ZodArray<z.ZodObject<{
2093
2137
  stageName: z.ZodString;
2094
2138
  averageDays: z.ZodNullable<z.ZodNumber>;
@@ -2102,6 +2146,7 @@ export declare const ProjectAnalyticsLossesResponseSchema: z.ZodObject<{
2102
2146
  excluded: z.ZodObject<{
2103
2147
  noValue: z.ZodNumber;
2104
2148
  }, z.core.$strip>;
2149
+ timeZone: z.ZodOptional<z.ZodString>;
2105
2150
  data: z.ZodObject<{
2106
2151
  byStage: z.ZodArray<z.ZodObject<{
2107
2152
  stageName: z.ZodString;
@@ -2128,6 +2173,7 @@ export declare const ProjectAnalyticsValueResponseSchema: z.ZodObject<{
2128
2173
  excluded: z.ZodObject<{
2129
2174
  noValue: z.ZodNumber;
2130
2175
  }, z.core.$strip>;
2176
+ timeZone: z.ZodOptional<z.ZodString>;
2131
2177
  data: z.ZodObject<{
2132
2178
  average: z.ZodArray<z.ZodObject<{
2133
2179
  currency: z.ZodString;
@@ -2143,6 +2189,7 @@ export declare const ProjectAnalyticsTopOpenResponseSchema: z.ZodObject<{
2143
2189
  excluded: z.ZodObject<{
2144
2190
  noValue: z.ZodNumber;
2145
2191
  }, z.core.$strip>;
2192
+ timeZone: z.ZodOptional<z.ZodString>;
2146
2193
  data: z.ZodArray<z.ZodObject<{
2147
2194
  id: z.ZodString;
2148
2195
  number: z.ZodString;
@@ -2182,6 +2229,7 @@ export declare const ProjectAnalyticsManagersResponseSchema: z.ZodObject<{
2182
2229
  excluded: z.ZodObject<{
2183
2230
  noValue: z.ZodNumber;
2184
2231
  }, z.core.$strip>;
2232
+ timeZone: z.ZodOptional<z.ZodString>;
2185
2233
  data: z.ZodArray<z.ZodObject<{
2186
2234
  adminUser: z.ZodObject<{
2187
2235
  id: z.ZodString;