@endora-commerce/mod-tasks 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 (313) hide show
  1. package/dist/admin/components/TaskCustomFields.js +2 -13
  2. package/dist/admin/pages/TaskCreate.js +2 -2
  3. package/dist/backend/domain/list-cursor.js +2 -3
  4. package/dist/backend/email-templates/digest-defaults.d.ts +14 -7
  5. package/dist/backend/email-templates/digest-defaults.js +39 -19
  6. package/dist/backend/email-templates/reminder-defaults.d.ts +7 -3
  7. package/dist/backend/email-templates/reminder-defaults.js +11 -3
  8. package/dist/backend/entities/task-value-change.entity.d.ts +27 -0
  9. package/dist/backend/entities/task-value-change.entity.js +62 -0
  10. package/dist/backend/index.d.ts +2 -1
  11. package/dist/backend/index.js +27 -3
  12. package/dist/backend/services/attachment-service.d.ts +5 -4
  13. package/dist/backend/services/attachment-service.js +25 -9
  14. package/dist/backend/services/digest-service.js +1 -0
  15. package/dist/backend/services/owner-read-permissions.d.ts +3 -0
  16. package/dist/backend/services/owner-read-permissions.js +3 -0
  17. package/dist/backend/services/reference-service.js +2 -19
  18. package/dist/backend/services/reminder-schedule.d.ts +2 -1
  19. package/dist/backend/services/reminder-schedule.js +7 -3
  20. package/dist/backend/services/saved-view-service.js +5 -8
  21. package/dist/backend/services/task-access.js +10 -3
  22. package/dist/backend/services/task-audit-state.d.ts +42 -0
  23. package/dist/backend/services/task-audit-state.js +98 -0
  24. package/dist/backend/services/task-commands.d.ts +38 -2
  25. package/dist/backend/services/task-commands.js +70 -7
  26. package/dist/backend/services/task-email.d.ts +8 -0
  27. package/dist/backend/services/task-email.js +18 -2
  28. package/dist/backend/services/task-history-service.d.ts +37 -0
  29. package/dist/backend/services/task-history-service.js +82 -7
  30. package/dist/backend/services/task-notifier.js +3 -3
  31. package/dist/backend/services/task-visibility.js +3 -3
  32. package/dist/backend/services/time-zone-rederive-service.d.ts +57 -0
  33. package/dist/backend/services/time-zone-rederive-service.js +105 -0
  34. package/dist/backend/workers/tasks-reminders-worker.d.ts +12 -6
  35. package/dist/backend/workers/tasks-reminders-worker.js +13 -6
  36. package/dist/manifest.d.ts +31 -1
  37. package/dist/manifest.js +35 -1
  38. package/dist/migrations/20261110T054810_tasks_value_changes.d.ts +23 -0
  39. package/dist/migrations/20261110T054810_tasks_value_changes.js +39 -0
  40. package/dist/migrations/index.d.ts +2 -1
  41. package/dist/migrations/index.js +7 -2
  42. package/docs/tasks.md +39 -10
  43. package/i18n/en.json +6 -4
  44. package/i18n/pl.json +3 -1
  45. package/package.json +13 -12
  46. package/dist/admin/api.d.ts.map +0 -1
  47. package/dist/admin/api.js.map +0 -1
  48. package/dist/admin/components/AssigneePicker.d.ts.map +0 -1
  49. package/dist/admin/components/AssigneePicker.js.map +0 -1
  50. package/dist/admin/components/BoardCardFieldsEditor.d.ts.map +0 -1
  51. package/dist/admin/components/BoardCardFieldsEditor.js.map +0 -1
  52. package/dist/admin/components/ContextLabel.d.ts.map +0 -1
  53. package/dist/admin/components/ContextLabel.js.map +0 -1
  54. package/dist/admin/components/ContextSection.d.ts.map +0 -1
  55. package/dist/admin/components/ContextSection.js.map +0 -1
  56. package/dist/admin/components/DigestControl.d.ts.map +0 -1
  57. package/dist/admin/components/DigestControl.js.map +0 -1
  58. package/dist/admin/components/LinkedRecordsSection.d.ts.map +0 -1
  59. package/dist/admin/components/LinkedRecordsSection.js.map +0 -1
  60. package/dist/admin/components/LookupPicker.d.ts.map +0 -1
  61. package/dist/admin/components/LookupPicker.js.map +0 -1
  62. package/dist/admin/components/RelatedTasksSection.d.ts.map +0 -1
  63. package/dist/admin/components/RelatedTasksSection.js.map +0 -1
  64. package/dist/admin/components/RemindersSection.d.ts.map +0 -1
  65. package/dist/admin/components/RemindersSection.js.map +0 -1
  66. package/dist/admin/components/StatusBadge.d.ts.map +0 -1
  67. package/dist/admin/components/StatusBadge.js.map +0 -1
  68. package/dist/admin/components/SubtasksSection.d.ts.map +0 -1
  69. package/dist/admin/components/SubtasksSection.js.map +0 -1
  70. package/dist/admin/components/TaskAttachments.d.ts.map +0 -1
  71. package/dist/admin/components/TaskAttachments.js.map +0 -1
  72. package/dist/admin/components/TaskBoard.d.ts.map +0 -1
  73. package/dist/admin/components/TaskBoard.js.map +0 -1
  74. package/dist/admin/components/TaskCard.d.ts.map +0 -1
  75. package/dist/admin/components/TaskCard.js.map +0 -1
  76. package/dist/admin/components/TaskComments.d.ts.map +0 -1
  77. package/dist/admin/components/TaskComments.js.map +0 -1
  78. package/dist/admin/components/TaskCustomFields.d.ts.map +0 -1
  79. package/dist/admin/components/TaskCustomFields.js.map +0 -1
  80. package/dist/admin/components/TaskFieldInputs.d.ts.map +0 -1
  81. package/dist/admin/components/TaskFieldInputs.js.map +0 -1
  82. package/dist/admin/components/TaskFilters.d.ts.map +0 -1
  83. package/dist/admin/components/TaskFilters.js.map +0 -1
  84. package/dist/admin/components/TaskMarkers.d.ts.map +0 -1
  85. package/dist/admin/components/TaskMarkers.js.map +0 -1
  86. package/dist/admin/components/TaskPicker.d.ts.map +0 -1
  87. package/dist/admin/components/TaskPicker.js.map +0 -1
  88. package/dist/admin/components/ViewModeToggle.d.ts.map +0 -1
  89. package/dist/admin/components/ViewModeToggle.js.map +0 -1
  90. package/dist/admin/components/priorities/TaskPriorityDeleteDialog.d.ts.map +0 -1
  91. package/dist/admin/components/priorities/TaskPriorityDeleteDialog.js.map +0 -1
  92. package/dist/admin/components/priorities/TaskPriorityDialog.d.ts.map +0 -1
  93. package/dist/admin/components/priorities/TaskPriorityDialog.js.map +0 -1
  94. package/dist/admin/components/tags/TaskTagDeleteDialog.d.ts.map +0 -1
  95. package/dist/admin/components/tags/TaskTagDeleteDialog.js.map +0 -1
  96. package/dist/admin/components/tags/TaskTagDialog.d.ts.map +0 -1
  97. package/dist/admin/components/tags/TaskTagDialog.js.map +0 -1
  98. package/dist/admin/components/task-columns.d.ts.map +0 -1
  99. package/dist/admin/components/task-columns.js.map +0 -1
  100. package/dist/admin/components/workflow/TaskStatusDeleteDialog.d.ts.map +0 -1
  101. package/dist/admin/components/workflow/TaskStatusDeleteDialog.js.map +0 -1
  102. package/dist/admin/components/workflow/TaskStatusDialog.d.ts.map +0 -1
  103. package/dist/admin/components/workflow/TaskStatusDialog.js.map +0 -1
  104. package/dist/admin/components/workflow/TaskStatusesTable.d.ts.map +0 -1
  105. package/dist/admin/components/workflow/TaskStatusesTable.js.map +0 -1
  106. package/dist/admin/index.d.ts.map +0 -1
  107. package/dist/admin/index.js.map +0 -1
  108. package/dist/admin/lib/current-admin.d.ts.map +0 -1
  109. package/dist/admin/lib/current-admin.js.map +0 -1
  110. package/dist/admin/lib/labels.d.ts.map +0 -1
  111. package/dist/admin/lib/labels.js.map +0 -1
  112. package/dist/admin/lib/references.d.ts.map +0 -1
  113. package/dist/admin/lib/references.js.map +0 -1
  114. package/dist/admin/lib/settings-paths.d.ts.map +0 -1
  115. package/dist/admin/lib/settings-paths.js.map +0 -1
  116. package/dist/admin/lib/task-filters.d.ts.map +0 -1
  117. package/dist/admin/lib/task-filters.js.map +0 -1
  118. package/dist/admin/lib/use-editor-focus.d.ts.map +0 -1
  119. package/dist/admin/lib/use-editor-focus.js.map +0 -1
  120. package/dist/admin/lib/use-task-vocabulary.d.ts.map +0 -1
  121. package/dist/admin/lib/use-task-vocabulary.js.map +0 -1
  122. package/dist/admin/pages/MyTasksPage.d.ts.map +0 -1
  123. package/dist/admin/pages/MyTasksPage.js.map +0 -1
  124. package/dist/admin/pages/TaskCreate.d.ts.map +0 -1
  125. package/dist/admin/pages/TaskCreate.js.map +0 -1
  126. package/dist/admin/pages/TaskDetail.d.ts.map +0 -1
  127. package/dist/admin/pages/TaskDetail.js.map +0 -1
  128. package/dist/admin/pages/TasksPage.d.ts.map +0 -1
  129. package/dist/admin/pages/TasksPage.js.map +0 -1
  130. package/dist/admin/pages/settings/TaskGeneralSettingsPage.d.ts.map +0 -1
  131. package/dist/admin/pages/settings/TaskGeneralSettingsPage.js.map +0 -1
  132. package/dist/admin/pages/settings/TaskPrioritiesPage.d.ts.map +0 -1
  133. package/dist/admin/pages/settings/TaskPrioritiesPage.js.map +0 -1
  134. package/dist/admin/pages/settings/TaskTagsPage.d.ts.map +0 -1
  135. package/dist/admin/pages/settings/TaskTagsPage.js.map +0 -1
  136. package/dist/admin/pages/settings/TaskWorkflowPage.d.ts.map +0 -1
  137. package/dist/admin/pages/settings/TaskWorkflowPage.js.map +0 -1
  138. package/dist/admin/zones/OpportunityTasksPanel.d.ts.map +0 -1
  139. package/dist/admin/zones/OpportunityTasksPanel.js.map +0 -1
  140. package/dist/admin/zones/OrderTasksPanel.d.ts.map +0 -1
  141. package/dist/admin/zones/OrderTasksPanel.js.map +0 -1
  142. package/dist/admin/zones/QuoteRequestTasksPanel.d.ts.map +0 -1
  143. package/dist/admin/zones/QuoteRequestTasksPanel.js.map +0 -1
  144. package/dist/admin/zones/TasksPanel.d.ts.map +0 -1
  145. package/dist/admin/zones/TasksPanel.js.map +0 -1
  146. package/dist/backend/admin-search-provider.d.ts.map +0 -1
  147. package/dist/backend/admin-search-provider.js.map +0 -1
  148. package/dist/backend/domain/board-card-fields.d.ts.map +0 -1
  149. package/dist/backend/domain/board-card-fields.js.map +0 -1
  150. package/dist/backend/domain/due-moment.d.ts.map +0 -1
  151. package/dist/backend/domain/due-moment.js.map +0 -1
  152. package/dist/backend/domain/hierarchy.d.ts.map +0 -1
  153. package/dist/backend/domain/hierarchy.js.map +0 -1
  154. package/dist/backend/domain/list-cursor.d.ts.map +0 -1
  155. package/dist/backend/domain/list-cursor.js.map +0 -1
  156. package/dist/backend/domain/task-status-graph.d.ts.map +0 -1
  157. package/dist/backend/domain/task-status-graph.js.map +0 -1
  158. package/dist/backend/email-templates/digest-defaults.d.ts.map +0 -1
  159. package/dist/backend/email-templates/digest-defaults.js.map +0 -1
  160. package/dist/backend/email-templates/reminder-defaults.d.ts.map +0 -1
  161. package/dist/backend/email-templates/reminder-defaults.js.map +0 -1
  162. package/dist/backend/entities/task-assignee.entity.d.ts.map +0 -1
  163. package/dist/backend/entities/task-assignee.entity.js.map +0 -1
  164. package/dist/backend/entities/task-attachment.entity.d.ts.map +0 -1
  165. package/dist/backend/entities/task-attachment.entity.js.map +0 -1
  166. package/dist/backend/entities/task-comment.entity.d.ts.map +0 -1
  167. package/dist/backend/entities/task-comment.entity.js.map +0 -1
  168. package/dist/backend/entities/task-digest-subscription.entity.d.ts.map +0 -1
  169. package/dist/backend/entities/task-digest-subscription.entity.js.map +0 -1
  170. package/dist/backend/entities/task-list-saved-view.entity.d.ts.map +0 -1
  171. package/dist/backend/entities/task-list-saved-view.entity.js.map +0 -1
  172. package/dist/backend/entities/task-priority.entity.d.ts.map +0 -1
  173. package/dist/backend/entities/task-priority.entity.js.map +0 -1
  174. package/dist/backend/entities/task-record-link.entity.d.ts.map +0 -1
  175. package/dist/backend/entities/task-record-link.entity.js.map +0 -1
  176. package/dist/backend/entities/task-reference.entity.d.ts.map +0 -1
  177. package/dist/backend/entities/task-reference.entity.js.map +0 -1
  178. package/dist/backend/entities/task-relation.entity.d.ts.map +0 -1
  179. package/dist/backend/entities/task-relation.entity.js.map +0 -1
  180. package/dist/backend/entities/task-reminder-delivery.entity.d.ts.map +0 -1
  181. package/dist/backend/entities/task-reminder-delivery.entity.js.map +0 -1
  182. package/dist/backend/entities/task-reminder.entity.d.ts.map +0 -1
  183. package/dist/backend/entities/task-reminder.entity.js.map +0 -1
  184. package/dist/backend/entities/task-status-transition.entity.d.ts.map +0 -1
  185. package/dist/backend/entities/task-status-transition.entity.js.map +0 -1
  186. package/dist/backend/entities/task-status.entity.d.ts.map +0 -1
  187. package/dist/backend/entities/task-status.entity.js.map +0 -1
  188. package/dist/backend/entities/task-tag-assignment.entity.d.ts.map +0 -1
  189. package/dist/backend/entities/task-tag-assignment.entity.js.map +0 -1
  190. package/dist/backend/entities/task-tag.entity.d.ts.map +0 -1
  191. package/dist/backend/entities/task-tag.entity.js.map +0 -1
  192. package/dist/backend/entities/task.entity.d.ts.map +0 -1
  193. package/dist/backend/entities/task.entity.js.map +0 -1
  194. package/dist/backend/index.d.ts.map +0 -1
  195. package/dist/backend/index.js.map +0 -1
  196. package/dist/backend/routes/routes.board.d.ts.map +0 -1
  197. package/dist/backend/routes/routes.board.js.map +0 -1
  198. package/dist/backend/routes/routes.collaboration.d.ts.map +0 -1
  199. package/dist/backend/routes/routes.collaboration.js.map +0 -1
  200. package/dist/backend/routes/routes.priorities.d.ts.map +0 -1
  201. package/dist/backend/routes/routes.priorities.js.map +0 -1
  202. package/dist/backend/routes/routes.reminders.d.ts.map +0 -1
  203. package/dist/backend/routes/routes.reminders.js.map +0 -1
  204. package/dist/backend/routes/routes.settings.d.ts.map +0 -1
  205. package/dist/backend/routes/routes.settings.js.map +0 -1
  206. package/dist/backend/routes/routes.tags.d.ts.map +0 -1
  207. package/dist/backend/routes/routes.tags.js.map +0 -1
  208. package/dist/backend/routes/routes.tasks.d.ts.map +0 -1
  209. package/dist/backend/routes/routes.tasks.js.map +0 -1
  210. package/dist/backend/routes/routes.views.d.ts.map +0 -1
  211. package/dist/backend/routes/routes.views.js.map +0 -1
  212. package/dist/backend/routes/routes.workflow.d.ts.map +0 -1
  213. package/dist/backend/routes/routes.workflow.js.map +0 -1
  214. package/dist/backend/saved-view-actor.d.ts.map +0 -1
  215. package/dist/backend/saved-view-actor.js.map +0 -1
  216. package/dist/backend/services/attachment-active-content.d.ts.map +0 -1
  217. package/dist/backend/services/attachment-active-content.js.map +0 -1
  218. package/dist/backend/services/attachment-service.d.ts.map +0 -1
  219. package/dist/backend/services/attachment-service.js.map +0 -1
  220. package/dist/backend/services/board-card-field-service.d.ts.map +0 -1
  221. package/dist/backend/services/board-card-field-service.js.map +0 -1
  222. package/dist/backend/services/board-service.d.ts.map +0 -1
  223. package/dist/backend/services/board-service.js.map +0 -1
  224. package/dist/backend/services/comment-service.d.ts.map +0 -1
  225. package/dist/backend/services/comment-service.js.map +0 -1
  226. package/dist/backend/services/context-lookup.d.ts.map +0 -1
  227. package/dist/backend/services/context-lookup.js.map +0 -1
  228. package/dist/backend/services/digest-service.d.ts.map +0 -1
  229. package/dist/backend/services/digest-service.js.map +0 -1
  230. package/dist/backend/services/document-lookup-service.d.ts.map +0 -1
  231. package/dist/backend/services/document-lookup-service.js.map +0 -1
  232. package/dist/backend/services/hierarchy-service.d.ts.map +0 -1
  233. package/dist/backend/services/hierarchy-service.js.map +0 -1
  234. package/dist/backend/services/maintenance-service.d.ts.map +0 -1
  235. package/dist/backend/services/maintenance-service.js.map +0 -1
  236. package/dist/backend/services/mention-service.d.ts.map +0 -1
  237. package/dist/backend/services/mention-service.js.map +0 -1
  238. package/dist/backend/services/owner-read-permissions.d.ts.map +0 -1
  239. package/dist/backend/services/owner-read-permissions.js.map +0 -1
  240. package/dist/backend/services/priority-service.d.ts.map +0 -1
  241. package/dist/backend/services/priority-service.js.map +0 -1
  242. package/dist/backend/services/record-link-service.d.ts.map +0 -1
  243. package/dist/backend/services/record-link-service.js.map +0 -1
  244. package/dist/backend/services/record-owners.d.ts.map +0 -1
  245. package/dist/backend/services/record-owners.js.map +0 -1
  246. package/dist/backend/services/reference-service.d.ts.map +0 -1
  247. package/dist/backend/services/reference-service.js.map +0 -1
  248. package/dist/backend/services/relation-service.d.ts.map +0 -1
  249. package/dist/backend/services/relation-service.js.map +0 -1
  250. package/dist/backend/services/reminder-schedule.d.ts.map +0 -1
  251. package/dist/backend/services/reminder-schedule.js.map +0 -1
  252. package/dist/backend/services/reminder-service.d.ts.map +0 -1
  253. package/dist/backend/services/reminder-service.js.map +0 -1
  254. package/dist/backend/services/saved-view-service.d.ts.map +0 -1
  255. package/dist/backend/services/saved-view-service.js.map +0 -1
  256. package/dist/backend/services/scheduled-work-probe.d.ts.map +0 -1
  257. package/dist/backend/services/scheduled-work-probe.js.map +0 -1
  258. package/dist/backend/services/tag-service.d.ts.map +0 -1
  259. package/dist/backend/services/tag-service.js.map +0 -1
  260. package/dist/backend/services/task-access.d.ts.map +0 -1
  261. package/dist/backend/services/task-access.js.map +0 -1
  262. package/dist/backend/services/task-asset-references.d.ts.map +0 -1
  263. package/dist/backend/services/task-asset-references.js.map +0 -1
  264. package/dist/backend/services/task-audit-references.d.ts.map +0 -1
  265. package/dist/backend/services/task-audit-references.js.map +0 -1
  266. package/dist/backend/services/task-checks.d.ts.map +0 -1
  267. package/dist/backend/services/task-checks.js.map +0 -1
  268. package/dist/backend/services/task-commands.d.ts.map +0 -1
  269. package/dist/backend/services/task-commands.js.map +0 -1
  270. package/dist/backend/services/task-context-registry.d.ts.map +0 -1
  271. package/dist/backend/services/task-context-registry.js.map +0 -1
  272. package/dist/backend/services/task-custom-fields.d.ts.map +0 -1
  273. package/dist/backend/services/task-custom-fields.js.map +0 -1
  274. package/dist/backend/services/task-email.d.ts.map +0 -1
  275. package/dist/backend/services/task-email.js.map +0 -1
  276. package/dist/backend/services/task-errors.d.ts.map +0 -1
  277. package/dist/backend/services/task-errors.js.map +0 -1
  278. package/dist/backend/services/task-history-service.d.ts.map +0 -1
  279. package/dist/backend/services/task-history-service.js.map +0 -1
  280. package/dist/backend/services/task-notifier.d.ts.map +0 -1
  281. package/dist/backend/services/task-notifier.js.map +0 -1
  282. package/dist/backend/services/task-number.d.ts.map +0 -1
  283. package/dist/backend/services/task-number.js.map +0 -1
  284. package/dist/backend/services/task-read-port.d.ts.map +0 -1
  285. package/dist/backend/services/task-read-port.js.map +0 -1
  286. package/dist/backend/services/task-reassignment.d.ts.map +0 -1
  287. package/dist/backend/services/task-reassignment.js.map +0 -1
  288. package/dist/backend/services/task-service.d.ts.map +0 -1
  289. package/dist/backend/services/task-service.js.map +0 -1
  290. package/dist/backend/services/task-settings-service.d.ts.map +0 -1
  291. package/dist/backend/services/task-settings-service.js.map +0 -1
  292. package/dist/backend/services/task-transition-service.d.ts.map +0 -1
  293. package/dist/backend/services/task-transition-service.js.map +0 -1
  294. package/dist/backend/services/task-visibility.d.ts.map +0 -1
  295. package/dist/backend/services/task-visibility.js.map +0 -1
  296. package/dist/backend/services/task-workflow-read.d.ts.map +0 -1
  297. package/dist/backend/services/task-workflow-read.js.map +0 -1
  298. package/dist/backend/services/task-write-port.d.ts.map +0 -1
  299. package/dist/backend/services/task-write-port.js.map +0 -1
  300. package/dist/backend/services/time-zone-validator.d.ts.map +0 -1
  301. package/dist/backend/services/time-zone-validator.js.map +0 -1
  302. package/dist/backend/services/workflow-config-service.d.ts.map +0 -1
  303. package/dist/backend/services/workflow-config-service.js.map +0 -1
  304. package/dist/backend/workers/tasks-reminders-worker.d.ts.map +0 -1
  305. package/dist/backend/workers/tasks-reminders-worker.js.map +0 -1
  306. package/dist/manifest.d.ts.map +0 -1
  307. package/dist/manifest.js.map +0 -1
  308. package/dist/migrations/20261026T133731_tasks_init.d.ts.map +0 -1
  309. package/dist/migrations/20261026T133731_tasks_init.js.map +0 -1
  310. package/dist/migrations/20261028T140002_tasks_task_management.d.ts.map +0 -1
  311. package/dist/migrations/20261028T140002_tasks_task_management.js.map +0 -1
  312. package/dist/migrations/index.d.ts.map +0 -1
  313. package/dist/migrations/index.js.map +0 -1
@@ -23,6 +23,7 @@ export declare function dueMomentOf(due: {
23
23
  * that is how the reminder's creator is told on the Task.
24
24
  *
25
25
  * Absolute reminders are the caller's chosen moments and are never touched.
26
+ * Answers how many relative reminders moved (none when they were removed).
26
27
  */
27
- export declare function followDueMoment(em: EntityManager, auditLog: AuditPort, taskId: string, moment: Date | null): Promise<void>;
28
+ export declare function followDueMoment(em: EntityManager, auditLog: AuditPort, taskId: string, moment: Date | null): Promise<number>;
28
29
  //# sourceMappingURL=reminder-schedule.d.ts.map
@@ -25,6 +25,7 @@ export function dueMomentOf(due, timeZone) {
25
25
  * that is how the reminder's creator is told on the Task.
26
26
  *
27
27
  * Absolute reminders are the caller's chosen moments and are never touched.
28
+ * Answers how many relative reminders moved (none when they were removed).
28
29
  */
29
30
  export async function followDueMoment(em, auditLog, taskId, moment) {
30
31
  if (moment === null) {
@@ -46,15 +47,18 @@ export async function followDueMoment(em, auditLog, taskId, moment) {
46
47
  stateAfter: null,
47
48
  });
48
49
  }
49
- return;
50
+ return 0;
50
51
  }
51
- await em.execute(`with "moved" as (
52
+ const moved = (await em.execute(`with "moved" as (
52
53
  update "task_reminders"
53
54
  set "remind_at" = ?::timestamptz - make_interval(mins => "offset_minutes")
54
55
  where "task_id" = ? and "mode" = 'relative'
55
56
  and "remind_at" <> ?::timestamptz - make_interval(mins => "offset_minutes")
56
57
  returning "id"
58
+ ), "rearmed" as (
59
+ delete from "task_reminder_deliveries" d using "moved" m where d."reminder_id" = m."id"
57
60
  )
58
- delete from "task_reminder_deliveries" d using "moved" m where d."reminder_id" = m."id"`, [moment, taskId, moment]);
61
+ select count(*)::int as "moved" from "moved"`, [moment, taskId, moment]));
62
+ return Number(moved[0]?.moved ?? 0);
59
63
  }
60
64
  //# sourceMappingURL=reminder-schedule.js.map
@@ -1,6 +1,6 @@
1
1
  import { isDeepStrictEqual } from 'node:util';
2
2
  import { UniqueConstraintViolationException } from '@mikro-orm/core';
3
- import { ERROR_CODES, savedListViewNameKey } from '@endora-commerce/contracts';
3
+ import { ERROR_CODES, savedListViewNameKey, isUuidShape } from '@endora-commerce/contracts';
4
4
  import { HttpError } from '@endora-commerce/platform/http';
5
5
  import { TaskListSavedView } from '../entities/task-list-saved-view.entity.js';
6
6
  const TABLE = 'task_list_saved_views';
@@ -166,15 +166,12 @@ async function assertNameAvailable(tx, ownerAdminUserId, name, excludeId) {
166
166
  throw nameTaken();
167
167
  }
168
168
  /**
169
- * The shape of a `uuid` column value. A view id that does not have it names no
170
- * view, so it answers the same 404 as an absent one instead of reaching
171
- * PostgreSQL, whose `invalid input syntax for type uuid` would surface as a
172
- * 500. Shape only — deliberately looser than RFC 9562's version and variant
173
- * bits, which PostgreSQL does not check either.
169
+ * A view id without the shape of a `uuid` column value names no view, so it
170
+ * answers the same 404 as an absent one instead of reaching PostgreSQL, whose
171
+ * `invalid input syntax for type uuid` would surface as a 500 (`isUuidShape`).
174
172
  */
175
- const UUID_SHAPE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
176
173
  async function loadModifiable(tx, id, actor) {
177
- if (!UUID_SHAPE.test(id)) {
174
+ if (!isUuidShape(id)) {
178
175
  throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'Saved view not found.');
179
176
  }
180
177
  const view = await tx.findOne(TaskListSavedView, { id });
@@ -1,4 +1,4 @@
1
- import { ERROR_CODES } from '@endora-commerce/contracts';
1
+ import { ERROR_CODES, isUuidShape } from '@endora-commerce/contracts';
2
2
  import { HttpError } from '@endora-commerce/platform/http';
3
3
  import { getTenantContext } from '@endora-commerce/platform/tenancy';
4
4
  import { assertMayDelete as assertContextLetsDelete } from './task-checks.js';
@@ -84,10 +84,18 @@ export const TASK_ACCESS_READERS = {
84
84
  'walks the distinct context ids of each context type whose present owner can say which still exist, and reads ' +
85
85
  'the ids of the Tasks of the contexts the owner says are gone, or whose group is — handing each to the delete or ' +
86
86
  'ungroup Command, which re-reads it under the lock. Nothing read is shown or sent to anybody.',
87
+ 'services/time-zone-rederive-service.ts': 'The #505 time-zone pass, run in the system scope its worker enters (its probe answers one bit, outside any ' +
88
+ 'scope): it reads the ids and due moments of the Tasks whose `due_on` or relative reminders are out of step ' +
89
+ 'with `tasks.time_zone`, platform-wide on purpose, and hands each to the re-derive Command, which re-reads it ' +
90
+ 'under the lock. Nothing read is shown or sent to anybody.',
87
91
  'services/task-write-port.ts': '`deleteInContext` lists the ids of one context for its owner — the module that registered the context type ' +
88
92
  'and is deleting its own record — and hands each to the delete Command. `createMany` looks up which of the ' +
89
93
  'source keys it was handed that one context already holds, for the same owner, and answers their ids in their ' +
90
94
  'place: ids of Tasks that owner created in its own record (R-19).',
95
+ 'services/task-history-service.ts': 'The Task\'s own value store (`task_value_changes`, issue #470) is read only after `findVisibleRow` handed ' +
96
+ 'out the Task, keyed by that Task\'s id and the row ids its audit entries point at — a pointer to another ' +
97
+ 'Task\'s row reads nothing — and what it holds is served through the same context and Task-id redaction as ' +
98
+ 'the entries themselves.',
91
99
  };
92
100
  /** The columns of {@link TaskRow}, over `tasks` aliased `t`. */
93
101
  export const TASK_COLUMNS = `t."id", t."number", t."title", t."description", t."status",
@@ -95,9 +103,8 @@ export const TASK_COLUMNS = `t."id", t."number", t."title", t."description", t."
95
103
  t."priority_code", t."is_draft", t."is_private", t."parent_task_id", t."source_key", t."custom_field_values",
96
104
  t."published_at", t."completed_at", t."created_by_admin_user_id",
97
105
  t."context_type", t."context_id", t."context_group_id", t."context_note", t."created_at", t."updated_at"`;
98
- const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
99
106
  export function isUuid(value) {
100
- return UUID.test(value);
107
+ return isUuidShape(value);
101
108
  }
102
109
  /** What {@link TaskVisibility.canSee} is asked about one row. */
103
110
  export function visibilityFacts(row) {
@@ -0,0 +1,42 @@
1
+ import type { EntityManager } from '@mikro-orm/postgresql';
2
+ import { type TaskValueState } from '../entities/task-value-change.entity.js';
3
+ /**
4
+ * What a `tasks.*` audit entry may say about a Task, and where the rest goes
5
+ * (issue #470, D-288; `specs/conventions/audit-state.md`).
6
+ *
7
+ * The platform audit log is one global table read under `audit_log:read`, so a
8
+ * Task's entry carries names and structure: its number, codes, dates, ids,
9
+ * booleans, lengths and the names of what changed. Its title (owner ruling O-1,
10
+ * 2026-11-10: a title is a value), its context note, its custom-field values
11
+ * and an attachment's file name go to `task_value_changes`, written in the same
12
+ * Command; the entry carries that row's id as `valueChangeId`, and the Task's
13
+ * history serves the values from there (`task-history-service.ts`).
14
+ */
15
+ /**
16
+ * Every top-level key a Task's audit snapshot may hold. A new field of the
17
+ * snapshot is a value until somebody classifies it on purpose —
18
+ * `task-audit-sentinels.test.ts` holds the snapshot to this list.
19
+ */
20
+ export declare const TASKS_AUDIT_KEYS: ReadonlySet<string>;
21
+ /** What an audit entry says of a value change: the names, and the store row. */
22
+ export interface TaskValueChangeKeys {
23
+ changedFields?: string[];
24
+ changedCustomFields?: string[];
25
+ valueChangeId?: string;
26
+ }
27
+ /**
28
+ * Record what a write changed among the values the audit log may not hold:
29
+ * a {@link TaskValueChange} row in the Command's transaction, and the keys the
30
+ * entry carries instead (`changedFields`, `changedCustomFields`, sorted and
31
+ * each only when non-empty; `valueChangeId`). `before: null` is something that
32
+ * only arrived, `after: null` something that went; `customFieldValues` is
33
+ * compared key by key. Nothing changed writes no row and answers `{}`.
34
+ *
35
+ * Call it inside a Command, with that Command's EntityManager and a Task that
36
+ * was reached through `TaskAccess`.
37
+ */
38
+ export declare function recordTaskValueChange(em: EntityManager, taskId: string, change: {
39
+ before: TaskValueState | null;
40
+ after: TaskValueState | null;
41
+ }): TaskValueChangeKeys;
42
+ //# sourceMappingURL=task-audit-state.d.ts.map
@@ -0,0 +1,98 @@
1
+ import { isDeepStrictEqual } from 'node:util';
2
+ import { TaskValueChange } from '../entities/task-value-change.entity.js';
3
+ /**
4
+ * What a `tasks.*` audit entry may say about a Task, and where the rest goes
5
+ * (issue #470, D-288; `specs/conventions/audit-state.md`).
6
+ *
7
+ * The platform audit log is one global table read under `audit_log:read`, so a
8
+ * Task's entry carries names and structure: its number, codes, dates, ids,
9
+ * booleans, lengths and the names of what changed. Its title (owner ruling O-1,
10
+ * 2026-11-10: a title is a value), its context note, its custom-field values
11
+ * and an attachment's file name go to `task_value_changes`, written in the same
12
+ * Command; the entry carries that row's id as `valueChangeId`, and the Task's
13
+ * history serves the values from there (`task-history-service.ts`).
14
+ */
15
+ /**
16
+ * Every top-level key a Task's audit snapshot may hold. A new field of the
17
+ * snapshot is a value until somebody classifies it on purpose —
18
+ * `task-audit-sentinels.test.ts` holds the snapshot to this list.
19
+ */
20
+ export const TASKS_AUDIT_KEYS = new Set([
21
+ 'number',
22
+ 'descriptionLength',
23
+ 'status',
24
+ 'dueOn',
25
+ 'dueAt',
26
+ 'startOn',
27
+ 'completedAt',
28
+ 'contextType',
29
+ 'contextId',
30
+ 'contextGroupId',
31
+ 'changedFields',
32
+ 'changedCustomFields',
33
+ 'valueChangeId',
34
+ // Issue #505 — a code and a count on the entry of a changed time zone.
35
+ 'reason',
36
+ 'remindersMoved',
37
+ ]);
38
+ function isEmpty(value) {
39
+ return value === null || value === undefined || (Array.isArray(value) && value.length === 0);
40
+ }
41
+ /**
42
+ * Record what a write changed among the values the audit log may not hold:
43
+ * a {@link TaskValueChange} row in the Command's transaction, and the keys the
44
+ * entry carries instead (`changedFields`, `changedCustomFields`, sorted and
45
+ * each only when non-empty; `valueChangeId`). `before: null` is something that
46
+ * only arrived, `after: null` something that went; `customFieldValues` is
47
+ * compared key by key. Nothing changed writes no row and answers `{}`.
48
+ *
49
+ * Call it inside a Command, with that Command's EntityManager and a Task that
50
+ * was reached through `TaskAccess`.
51
+ */
52
+ export function recordTaskValueChange(em, taskId, change) {
53
+ const before = change.before ?? {};
54
+ const after = change.after ?? {};
55
+ const changedFields = [];
56
+ const changedCustomFields = [];
57
+ const storedBefore = {};
58
+ const storedAfter = {};
59
+ for (const field of [...new Set([...Object.keys(before), ...Object.keys(after)])]) {
60
+ if (field === 'customFieldValues')
61
+ continue;
62
+ const was = before[field] ?? null;
63
+ const is = after[field] ?? null;
64
+ const changed = change.before === null ? !isEmpty(is) : change.after === null ? !isEmpty(was) : !isDeepStrictEqual(was, is);
65
+ if (!changed)
66
+ continue;
67
+ changedFields.push(field);
68
+ storedBefore[field] = was;
69
+ storedAfter[field] = is;
70
+ }
71
+ const customBefore = (before.customFieldValues ?? {});
72
+ const customAfter = (after.customFieldValues ?? {});
73
+ for (const key of [...new Set([...Object.keys(customBefore), ...Object.keys(customAfter)])]) {
74
+ if (!isDeepStrictEqual(customBefore[key] ?? null, customAfter[key] ?? null))
75
+ changedCustomFields.push(key);
76
+ }
77
+ changedFields.sort();
78
+ changedCustomFields.sort();
79
+ if (changedCustomFields.length > 0) {
80
+ storedBefore.customFieldValues = Object.fromEntries(changedCustomFields.map((key) => [key, customBefore[key] ?? null]));
81
+ storedAfter.customFieldValues = Object.fromEntries(changedCustomFields.map((key) => [key, customAfter[key] ?? null]));
82
+ }
83
+ if (changedFields.length === 0 && changedCustomFields.length === 0)
84
+ return {};
85
+ // command-coverage-ignore: runs only inside a `tasks.*` Command's `run`, on the `em`
86
+ // the bus handed it — the row commits with that Command's one audit entry.
87
+ const row = em.create(TaskValueChange, {
88
+ taskId,
89
+ before: change.before === null ? null : storedBefore,
90
+ after: change.after === null ? null : storedAfter,
91
+ });
92
+ return {
93
+ ...(changedFields.length > 0 ? { changedFields } : {}),
94
+ ...(changedCustomFields.length > 0 ? { changedCustomFields } : {}),
95
+ valueChangeId: row.id,
96
+ };
97
+ }
98
+ //# sourceMappingURL=task-audit-state.js.map
@@ -11,7 +11,7 @@ import { Task } from '../entities/task.entity.js';
11
11
  * | Action | Event |
12
12
  * | --- | --- |
13
13
  * | `tasks.task.create` | `tasks.task.created.v1` |
14
- * | `tasks.task.update` (title, description, due date and time, start date, context) | — |
14
+ * | `tasks.task.update` (title, description, due date and time, start date, context; a changed time zone) | — |
15
15
  * | `tasks.task.priority_change` | — |
16
16
  * | `tasks.task.tags_change` | — |
17
17
  * | `tasks.task.custom_fields_change` | — |
@@ -89,7 +89,14 @@ export interface TaskFieldChanges {
89
89
  startOn?: string | null;
90
90
  context?: TaskContext | null;
91
91
  }
92
+ /**
93
+ * The audit snapshot of a Task: names and structure only (#470,
94
+ * `TASKS_AUDIT_KEYS`). The title and the context note are values — they go to
95
+ * the Task's value store ({@link taskValues}).
96
+ */
92
97
  export declare function auditSnapshot(task: Task): Record<string, unknown>;
98
+ /** The values of a Task its history shows and the audit log may not hold (#470). */
99
+ export declare function taskValues(task: Task): Record<string, unknown>;
93
100
  /** An event's `eventId` / `occurredAt` envelope. */
94
101
  export declare function envelope(): {
95
102
  eventId: string;
@@ -146,11 +153,40 @@ export declare function ungroupTaskCommand(id: string, from: {
146
153
  contextId: string;
147
154
  contextGroupId: string;
148
155
  }): Command<boolean>;
156
+ /** What the time-zone pass derived for one Task, from the due moment it read (issue #505). */
157
+ export interface TaskDueRederivation {
158
+ /** The Task's `due_on` and `due_at` (ISO) when the pass read them; a Task that moved since is left. */
159
+ seen: {
160
+ dueOn: string | null;
161
+ dueAt: string | null;
162
+ };
163
+ /** With a due time: that time's date in the zone. */
164
+ dueOn: string | null;
165
+ /** Date only: 09:00 of the due date in the zone, the moment its relative reminders count from. */
166
+ moment: Date | null;
167
+ }
168
+ /**
169
+ * `tasks.task.update`, `reason: 'time_zone_changed'` — what was counted in the
170
+ * old `tasks.time_zone` re-derived in the new one (issue #505; data-model §5,
171
+ * research R-17), one Command per Task, run as the system by the time-zone pass
172
+ * (`time-zone-rederive-service.ts`):
173
+ *
174
+ * - a Task with a due time gets that time's date in the zone as `due_on`;
175
+ * - a date-only Task's relative reminders follow 09:00 of its due date in the
176
+ * zone, as {@link followDueMoment} moves them for a changed due date — a
177
+ * reminder whose moment moved fires again.
178
+ *
179
+ * The Task is re-read under its lock and left as it is when its due moment is
180
+ * not the one the pass read: a write meanwhile derived its own. `false`, and
181
+ * nothing recorded, when nothing moved.
182
+ */
183
+ export declare function rederiveTaskDueCommand(id: string, derived: TaskDueRederivation, auditLog: AuditPort): Command<boolean>;
149
184
  /** `tasks.task.tags_change` — the whole set replaced; `false` when it did not change. */
150
185
  export declare function changeTaskTagsCommand(id: string, tagIds: readonly string[]): Command<boolean>;
151
186
  /**
152
187
  * `tasks.task.custom_fields_change` — the bag `custom_fields` validated and
153
- * merged; the audit row holds the keys that changed, before and after.
188
+ * merged; the audit row names the keys that changed, and the Task's value
189
+ * store holds them before and after (#470).
154
190
  * `false` when nothing changed.
155
191
  */
156
192
  export declare function changeTaskCustomFieldsCommand(id: string, merged: Record<string, unknown>): Command<boolean>;
@@ -16,13 +16,18 @@ import { dueMomentOf, followDueMoment } from './reminder-schedule.js';
16
16
  import { referenceRowsFor } from './reference-service.js';
17
17
  import { taskAlreadyPublished, taskAssigneeInvalid, taskNotFound } from './task-errors.js';
18
18
  import { nextTaskNumber } from './task-number.js';
19
+ import { recordTaskValueChange } from './task-audit-state.js';
19
20
  function isoOrNull(value) {
20
21
  return value ? new Date(value).toISOString() : null;
21
22
  }
23
+ /**
24
+ * The audit snapshot of a Task: names and structure only (#470,
25
+ * `TASKS_AUDIT_KEYS`). The title and the context note are values — they go to
26
+ * the Task's value store ({@link taskValues}).
27
+ */
22
28
  export function auditSnapshot(task) {
23
29
  return {
24
30
  number: task.number,
25
- title: task.title,
26
31
  descriptionLength: task.description.length,
27
32
  status: task.status,
28
33
  dueOn: task.dueOn ?? null,
@@ -32,9 +37,12 @@ export function auditSnapshot(task) {
32
37
  contextType: task.contextType ?? null,
33
38
  contextId: task.contextId ?? null,
34
39
  contextGroupId: task.contextGroupId ?? null,
35
- contextNote: task.contextNote ?? null,
36
40
  };
37
41
  }
42
+ /** The values of a Task its history shows and the audit log may not hold (#470). */
43
+ export function taskValues(task) {
44
+ return { title: task.title, contextNote: task.contextNote ?? null };
45
+ }
38
46
  /** An event's `eventId` / `occurredAt` envelope. */
39
47
  export function envelope() {
40
48
  return { eventId: randomUUID(), occurredAt: new Date().toISOString() };
@@ -147,6 +155,14 @@ export function createTaskCommand(context, input) {
147
155
  }
148
156
  }
149
157
  created = task;
158
+ // The values go to the Task's own store; the entry names them (#470).
159
+ // The row names the Task by value, so the Task is written first, as
160
+ // for the other child rows above.
161
+ await scoped.flush();
162
+ const values = recordTaskValueChange(scoped, id, {
163
+ before: null,
164
+ after: { ...taskValues(task), customFieldValues: { ...task.customFieldValues } },
165
+ });
150
166
  return {
151
167
  result: id,
152
168
  before: null,
@@ -159,7 +175,7 @@ export function createTaskCommand(context, input) {
159
175
  tagIds,
160
176
  ...(parentTaskId !== null ? { parentTaskId } : {}),
161
177
  ...(links.length > 0 ? { links: links.map((link) => ({ kind: link.kind, recordId: link.id })) } : {}),
162
- ...(Object.keys(task.customFieldValues).length > 0 ? { customFieldValues: task.customFieldValues } : {}),
178
+ ...values,
163
179
  },
164
180
  };
165
181
  },
@@ -246,6 +262,7 @@ export function updateTaskCommand(id, changes, reminders) {
246
262
  const scoped = em;
247
263
  const task = await lockedTask(scoped, id);
248
264
  const before = auditSnapshot(task);
265
+ const valuesBefore = taskValues(task);
249
266
  let mentioned = [];
250
267
  if (changes.title !== undefined)
251
268
  task.title = changes.title;
@@ -270,7 +287,8 @@ export function updateTaskCommand(id, changes, reminders) {
270
287
  task.contextId = changes.context?.contextId ?? null;
271
288
  task.contextGroupId = changes.context?.contextGroupId ?? null;
272
289
  }
273
- return { result: { mentioned }, before, after: auditSnapshot(task) };
290
+ const values = recordTaskValueChange(scoped, task.id, { before: valuesBefore, after: taskValues(task) });
291
+ return { result: { mentioned }, before, after: { ...auditSnapshot(task), ...values } };
274
292
  },
275
293
  };
276
294
  }
@@ -325,6 +343,46 @@ export function ungroupTaskCommand(id, from) {
325
343
  },
326
344
  };
327
345
  }
346
+ /**
347
+ * `tasks.task.update`, `reason: 'time_zone_changed'` — what was counted in the
348
+ * old `tasks.time_zone` re-derived in the new one (issue #505; data-model §5,
349
+ * research R-17), one Command per Task, run as the system by the time-zone pass
350
+ * (`time-zone-rederive-service.ts`):
351
+ *
352
+ * - a Task with a due time gets that time's date in the zone as `due_on`;
353
+ * - a date-only Task's relative reminders follow 09:00 of its due date in the
354
+ * zone, as {@link followDueMoment} moves them for a changed due date — a
355
+ * reminder whose moment moved fires again.
356
+ *
357
+ * The Task is re-read under its lock and left as it is when its due moment is
358
+ * not the one the pass read: a write meanwhile derived its own. `false`, and
359
+ * nothing recorded, when nothing moved.
360
+ */
361
+ export function rederiveTaskDueCommand(id, derived, auditLog) {
362
+ return {
363
+ action: 'tasks.task.update',
364
+ objectType: 'task',
365
+ objectId: id,
366
+ run: async ({ em }) => {
367
+ const scoped = em;
368
+ const task = await scoped.findOne(Task, { id }, { lockMode: LockMode.PESSIMISTIC_WRITE });
369
+ if (!task || (task.dueOn ?? null) !== derived.seen.dueOn || isoOrNull(task.dueAt) !== derived.seen.dueAt) {
370
+ return { result: false, skipAudit: true };
371
+ }
372
+ const dueOn = task.dueOn ?? null;
373
+ if (task.dueAt && derived.dueOn !== null)
374
+ task.dueOn = derived.dueOn;
375
+ const remindersMoved = !task.dueAt && task.dueOn && derived.moment ? await followDueMoment(scoped, auditLog, task.id, derived.moment) : 0;
376
+ if ((task.dueOn ?? null) === dueOn && remindersMoved === 0)
377
+ return { result: false, skipAudit: true };
378
+ return {
379
+ result: true,
380
+ before: { dueOn },
381
+ after: { dueOn: task.dueOn ?? null, remindersMoved, reason: 'time_zone_changed' },
382
+ };
383
+ },
384
+ };
385
+ }
328
386
  /** `tasks.task.tags_change` — the whole set replaced; `false` when it did not change. */
329
387
  export function changeTaskTagsCommand(id, tagIds) {
330
388
  return {
@@ -350,7 +408,8 @@ export function changeTaskTagsCommand(id, tagIds) {
350
408
  }
351
409
  /**
352
410
  * `tasks.task.custom_fields_change` — the bag `custom_fields` validated and
353
- * merged; the audit row holds the keys that changed, before and after.
411
+ * merged; the audit row names the keys that changed, and the Task's value
412
+ * store holds them before and after (#470).
354
413
  * `false` when nothing changed.
355
414
  */
356
415
  export function changeTaskCustomFieldsCommand(id, merged) {
@@ -364,9 +423,13 @@ export function changeTaskCustomFieldsCommand(id, merged) {
364
423
  const keys = [...new Set([...Object.keys(current), ...Object.keys(merged)])].filter((key) => !isDeepStrictEqual(current[key], merged[key]));
365
424
  if (keys.length === 0)
366
425
  return { result: false, skipAudit: true };
367
- const side = (bag) => Object.fromEntries(keys.map((key) => [key, bag[key] ?? null]));
368
426
  task.customFieldValues = merged;
369
- return { result: true, before: { customFieldValues: side(current) }, after: { customFieldValues: side(merged) } };
427
+ // The values go to the Task's own store; the entry names the keys (#470).
428
+ const values = recordTaskValueChange(em, task.id, {
429
+ before: { customFieldValues: { ...current } },
430
+ after: { customFieldValues: { ...merged } },
431
+ });
432
+ return { result: true, before: null, after: { ...values } };
370
433
  },
371
434
  };
372
435
  }
@@ -46,6 +46,8 @@ export interface TaskReminderEmailInput extends TaskEmailRecipient {
46
46
  }
47
47
  /** One line of a digest. */
48
48
  export interface TaskDigestEntry {
49
+ /** The Task's id — what its link into the admin panel addresses. */
50
+ taskId: string;
49
51
  number: string;
50
52
  title: string;
51
53
  /** `YYYY-MM-DD`. */
@@ -70,6 +72,12 @@ export interface TaskEmailDeps {
70
72
  sender: () => TransactionalEmailSender | undefined;
71
73
  /** Where a send that did not happen is reported. */
72
74
  log: (message: string, context: Record<string, unknown>) => void;
75
+ /**
76
+ * The Admin UI's base address, read per send; `null` when it is not
77
+ * configured, and the e-mail then carries no link. The platform's
78
+ * `configuredAdminBaseUrl` unless a test injects one.
79
+ */
80
+ adminBaseUrl?: () => string | null;
73
81
  }
74
82
  /**
75
83
  * The language a Task e-mail is written in: the recipient's Admin UI language
@@ -1,6 +1,15 @@
1
- import { rethrowIfModuleDisabled } from '@endora-commerce/platform/kernel';
1
+ import { configuredAdminBaseUrl, rethrowIfModuleDisabled } from '@endora-commerce/platform/kernel';
2
2
  import { TASK_DIGEST_EMAIL_CODE } from '../email-templates/digest-defaults.js';
3
3
  import { TASK_REMINDER_EMAIL_CODE } from '../email-templates/reminder-defaults.js';
4
+ import { TASK_DIGEST_LINK_PATH, taskLinkPath } from './task-notifier.js';
5
+ /**
6
+ * `{ adminUrl }` — the bell entry's address made absolute on `base` — or
7
+ * nothing at all: a link is left out rather than relative, which opens nothing
8
+ * from a mail client, and the template drops what it would have shown.
9
+ */
10
+ function adminLink(base, path) {
11
+ return base === null ? {} : { adminUrl: `${base}${path}` };
12
+ }
4
13
  /**
5
14
  * The language a Task e-mail is written in: the recipient's Admin UI language
6
15
  * — Polish for a Polish preference, English for everything else, read by the
@@ -64,6 +73,7 @@ export function createTaskEmail(deps) {
64
73
  });
65
74
  return { sent: false, reason };
66
75
  };
76
+ const adminBaseUrl = deps.adminBaseUrl ?? (() => configuredAdminBaseUrl());
67
77
  const send = async (recipient, message) => {
68
78
  if (!recipient.to)
69
79
  return notSent(message.context, 'no_address');
@@ -100,6 +110,7 @@ export function createTaskEmail(deps) {
100
110
  number: input.number,
101
111
  title: input.title.replace(/\s+/g, ' ').trim(),
102
112
  due: dueWords(input, language, input.timeZone) ?? '',
113
+ ...adminLink(adminBaseUrl(), taskLinkPath(input.taskId)),
103
114
  },
104
115
  }),
105
116
  context: { taskId: input.taskId, deliveryId: input.deliveryId },
@@ -110,9 +121,14 @@ export function createTaskEmail(deps) {
110
121
  messageId: `${TASK_DIGEST_EMAIL_CODE}:${input.adminUserId}:${input.date}`,
111
122
  document: null,
112
123
  variables: (language) => {
113
- const tasks = input.tasks.map((entry) => digestItem(entry, input.date, language));
124
+ const base = adminBaseUrl();
125
+ const tasks = input.tasks.map((entry) => ({
126
+ ...digestItem(entry, input.date, language),
127
+ ...adminLink(base, taskLinkPath(entry.taskId)),
128
+ }));
114
129
  return {
115
130
  digest: {
131
+ ...adminLink(base, TASK_DIGEST_LINK_PATH),
116
132
  date: dayWords(input.date, language),
117
133
  taskCount: String(tasks.length),
118
134
  // One Task a line — the number, the title and the due date, no words around them.
@@ -1,4 +1,5 @@
1
1
  import { type AdminUserReadPort, type RecordHistoryPage, type RecordHistoryQuery } from '@endora-commerce/contracts';
2
+ import type { EntityManager } from '@mikro-orm/postgresql';
2
3
  import type { AuditPort } from '@endora-commerce/platform/kernel';
3
4
  import { type TaskAccess } from './task-access.js';
4
5
  import type { TaskService } from './task-service.js';
@@ -12,6 +13,8 @@ export declare const TASK_AUDIT_OBJECT_TYPE = "task";
12
13
  */
13
14
  export declare const TASK_HISTORY_REACH: number;
14
15
  export interface TaskHistoryServiceDeps {
16
+ /** Reads the Task's own value store (#470), by the id of a Task the reader may see. */
17
+ emFactory: () => EntityManager;
15
18
  tasks: Pick<TaskService, 'findVisibleRow'>;
16
19
  /** Whether the reader may see a context an entry names — the Task may have left it since. */
17
20
  visibility: Pick<TaskVisibility, 'canSeeContext'>;
@@ -21,12 +24,46 @@ export interface TaskHistoryServiceDeps {
21
24
  auditLog: Pick<AuditPort, 'query'>;
22
25
  /** `admin_users`' read port — lazy, resolved per call. */
23
26
  adminUsers: AdminUserReadPort;
27
+ /**
28
+ * Whether the reader holds `custom_fields:read` (owner ruling 2026-11-10,
29
+ * #470; feature 162 P2 = a, as CRM and Projects). Without it no entry serves
30
+ * a Task's custom-field values, nor the names of the changed ones.
31
+ */
32
+ mayReadCustomFields: () => Promise<boolean>;
24
33
  }
34
+ /** An audited state without its custom fields, for a reader who may not read them. */
35
+ export declare function withoutCustomFields(state: unknown): unknown;
25
36
  /** The audited keys whose value is a Task's id (relation and hierarchy entries). */
26
37
  export declare const TASK_ID_KEYS: readonly ["relatedTaskId", "parentTaskId"];
38
+ /** One row of `task_value_changes`: the changed values of one write, either side. */
39
+ export interface StoredTaskValueChange {
40
+ before: Record<string, unknown> | null;
41
+ after: Record<string, unknown> | null;
42
+ }
43
+ /** The `task_value_changes` row an entry points at — on the side that has one — or `null`. */
44
+ export declare function valueChangeIdOf(entry: {
45
+ before: unknown;
46
+ after: unknown;
47
+ }): string | null;
48
+ /**
49
+ * An entry with the values the Task's store kept for it (#470): the audit entry
50
+ * names what changed and points at the row by `valueChangeId`; the history
51
+ * serves the values in place of the names, in the shape entries written before
52
+ * #470 carried them. Without a row the names stay and only the pointer goes.
53
+ * Entries written before #470 carry their values and are served as stored
54
+ * (owner ruling O-4, 2026-11-10).
55
+ */
56
+ export declare function withStoredValues(entry: {
57
+ before: unknown;
58
+ after: unknown;
59
+ }, change: StoredTaskValueChange | null): {
60
+ before: unknown;
61
+ after: unknown;
62
+ };
27
63
  /** An audited state with its context blanked. */
28
64
  export declare function withoutContext(state: Record<string, unknown>): Record<string, unknown>;
29
65
  export declare class TaskHistoryService {
66
+ #private;
30
67
  private readonly deps;
31
68
  constructor(deps: TaskHistoryServiceDeps);
32
69
  list(taskId: string, query: RecordHistoryQuery): Promise<RecordHistoryPage>;