@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
@@ -28,6 +28,18 @@ function decodeCursor(cursor) {
28
28
  }
29
29
  throw new HttpError(400, ERROR_CODES.VALIDATION_FAILED, 'The cursor is not one this history issued.');
30
30
  }
31
+ /** The keys of a state that belong to `custom_fields`: the values, and the names of the changed ones. */
32
+ const CUSTOM_FIELD_KEYS = ['customFieldValues', 'changedCustomFields'];
33
+ /** An audited state without its custom fields, for a reader who may not read them. */
34
+ export function withoutCustomFields(state) {
35
+ const record = asRecord(state);
36
+ if (!record || !CUSTOM_FIELD_KEYS.some((key) => Object.hasOwn(record, key)))
37
+ return state;
38
+ const out = { ...record };
39
+ for (const key of CUSTOM_FIELD_KEYS)
40
+ delete out[key];
41
+ return out;
42
+ }
31
43
  /**
32
44
  * `GET /tasks/:id/history` — **the audit log is the history**: every write of
33
45
  * a Task is a Command recorded against `task` and its id. The Task is read
@@ -89,6 +101,47 @@ function showsReminder(entry, reader) {
89
101
  return true;
90
102
  return Array.isArray(state['recipientIds']) && state['recipientIds'].includes(reader);
91
103
  }
104
+ /** The audit keys that stand in for the values the Task's own store keeps (#470). */
105
+ const VALUE_POINTER = 'valueChangeId';
106
+ const VALUE_NAMES = ['changedFields', 'changedCustomFields'];
107
+ const UUID_SHAPE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
108
+ /** The `task_value_changes` row an entry points at — on the side that has one — or `null`. */
109
+ export function valueChangeIdOf(entry) {
110
+ for (const state of [entry.after, entry.before]) {
111
+ const id = asRecord(state)?.[VALUE_POINTER];
112
+ if (typeof id === 'string' && UUID_SHAPE.test(id))
113
+ return id;
114
+ }
115
+ return null;
116
+ }
117
+ /**
118
+ * An entry with the values the Task's store kept for it (#470): the audit entry
119
+ * names what changed and points at the row by `valueChangeId`; the history
120
+ * serves the values in place of the names, in the shape entries written before
121
+ * #470 carried them. Without a row the names stay and only the pointer goes.
122
+ * Entries written before #470 carry their values and are served as stored
123
+ * (owner ruling O-4, 2026-11-10).
124
+ */
125
+ export function withStoredValues(entry, change) {
126
+ const strip = (state) => {
127
+ const record = asRecord(state);
128
+ if (!record || !(VALUE_POINTER in record || (change && VALUE_NAMES.some((key) => key in record))))
129
+ return state;
130
+ const out = { ...record };
131
+ delete out[VALUE_POINTER];
132
+ if (change)
133
+ for (const key of VALUE_NAMES)
134
+ delete out[key];
135
+ return out;
136
+ };
137
+ const merge = (state, values) => {
138
+ const stripped = strip(state);
139
+ if (!values)
140
+ return stripped;
141
+ return { ...(asRecord(stripped) ?? {}), ...values };
142
+ };
143
+ return { before: merge(entry.before, change?.before ?? null), after: merge(entry.after, change?.after ?? null) };
144
+ }
92
145
  /** An audited state with its context blanked. */
93
146
  export function withoutContext(state) {
94
147
  const out = { ...state };
@@ -126,13 +179,25 @@ export class TaskHistoryService {
126
179
  const page = entries.slice(offset, offset + query.limit);
127
180
  const hasMore = entries.length > offset + query.limit;
128
181
  const truncated = !hasMore && read.length > TASK_HISTORY_REACH;
182
+ // The values the page's entries name, from the Task's own store — keyed by
183
+ // the Task `findVisibleRow` handed out, so a pointer to another Task's row
184
+ // reads nothing (#470).
185
+ const pointers = page
186
+ .map((entry) => valueChangeIdOf({ before: entry.stateBefore ?? null, after: entry.stateAfter ?? null }))
187
+ .filter((id) => id !== null);
188
+ const changes = await this.#valueChanges(task.id, pointers);
189
+ const states = page.map((entry) => {
190
+ const raw = { before: entry.stateBefore ?? null, after: entry.stateAfter ?? null };
191
+ const pointer = valueChangeIdOf(raw);
192
+ return withStoredValues(raw, pointer === null ? null : (changes.get(pointer) ?? null));
193
+ });
129
194
  const actorIds = [...new Set(page.map((entry) => entry.actorAdminUserId).filter((id) => Boolean(id)))];
130
195
  const actors = actorIds.length > 0 ? await this.deps.adminUsers.findByIds(actorIds) : [];
131
196
  const names = new Map(actors.map((admin) => [admin.id, `${admin.firstName} ${admin.lastName}`.trim() || admin.email]));
132
197
  // Each context the page names, asked once, under the reader's own context.
133
198
  const seen = new Map();
134
- for (const entry of page) {
135
- for (const state of [entry.stateBefore, entry.stateAfter]) {
199
+ for (const entry of states) {
200
+ for (const state of [entry.before, entry.after]) {
136
201
  const context = contextOf(state);
137
202
  if (!context)
138
203
  continue;
@@ -142,7 +207,7 @@ export class TaskHistoryService {
142
207
  }
143
208
  }
144
209
  // Every Task the page names, asked once, in one read.
145
- const named = page.flatMap((entry) => [...taskIdsOf(entry.stateBefore), ...taskIdsOf(entry.stateAfter)]);
210
+ const named = states.flatMap((entry) => [...taskIdsOf(entry.before), ...taskIdsOf(entry.after)]);
146
211
  const visibleTasks = named.length > 0 ? await this.deps.access.visibleIds(named) : new Set();
147
212
  const withoutHiddenTasks = (state) => {
148
213
  const record = asRecord(state);
@@ -156,14 +221,16 @@ export class TaskHistoryService {
156
221
  }
157
222
  return out;
158
223
  };
159
- const served = (state) => {
224
+ const mayReadCustomFields = page.length > 0 ? await this.deps.mayReadCustomFields() : true;
225
+ const served = (raw) => {
226
+ const state = mayReadCustomFields ? raw : withoutCustomFields(raw);
160
227
  const context = contextOf(state);
161
228
  if (!context || seen.get(`${context.contextType}:${context.contextId}`))
162
229
  return withoutHiddenTasks(state ?? null);
163
230
  return withoutHiddenTasks(withoutContext(state));
164
231
  };
165
232
  return {
166
- data: page.map((entry) => {
233
+ data: page.map((entry, index) => {
167
234
  const actorId = entry.actorAdminUserId ?? null;
168
235
  return {
169
236
  id: entry.id,
@@ -172,8 +239,8 @@ export class TaskHistoryService {
172
239
  actor: actorId === null
173
240
  ? { kind: 'system', id: null, name: null }
174
241
  : { kind: 'admin', id: actorId, name: names.get(actorId) ?? null },
175
- before: served(entry.stateBefore),
176
- after: served(entry.stateAfter),
242
+ before: served(states[index]?.before ?? null),
243
+ after: served(states[index]?.after ?? null),
177
244
  references: [],
178
245
  };
179
246
  }),
@@ -181,5 +248,13 @@ export class TaskHistoryService {
181
248
  truncated,
182
249
  };
183
250
  }
251
+ /** The stored values of the page's entries, by row id — read by the Task's own id. */
252
+ async #valueChanges(taskId, ids) {
253
+ if (ids.length === 0)
254
+ return new Map();
255
+ const rows = (await this.deps.emFactory().execute(`select v."id", v."before", v."after" from "task_value_changes" v
256
+ where v."task_id" = ? and v."id" = any(?::uuid[])`, [taskId, `{${ids.join(',')}}`]));
257
+ return new Map(rows.map((row) => [row.id, { before: row.before, after: row.after }]));
258
+ }
184
259
  }
185
260
  //# sourceMappingURL=task-history-service.js.map
@@ -16,15 +16,15 @@ export const taskNotificationText = {
16
16
  titleMessage: { scope: 'tasks', key: 'notifications.assigned.title', params: { number } },
17
17
  }),
18
18
  mentioned: (number) => ({
19
- title: `You were mentioned in Task ${number}`,
19
+ title: `You were mentioned in task ${number}`,
20
20
  titleMessage: { scope: 'tasks', key: 'notifications.mention.title', params: { number } },
21
21
  }),
22
22
  commented: (number) => ({
23
- title: `New comment on Task ${number}`,
23
+ title: `New comment on task ${number}`,
24
24
  titleMessage: { scope: 'tasks', key: 'notifications.comment.title', params: { number } },
25
25
  }),
26
26
  reminder: (number) => ({
27
- title: `Reminder: Task ${number}`,
27
+ title: `Reminder: task ${number}`,
28
28
  titleMessage: { scope: 'tasks', key: 'notifications.reminder.title', params: { number } },
29
29
  }),
30
30
  /** The daily digest names no Task at all: how many, and a link to *My Tasks*. */
@@ -1,4 +1,5 @@
1
1
  import { getTenantContext } from '@endora-commerce/platform/tenancy';
2
+ import { isUuidShape } from '@endora-commerce/contracts';
2
3
  /**
3
4
  * The pre-filter over `tasks` aliased `alias`, or `null` for an unrestricted
4
5
  * caller. A type whose visible set is empty adds nothing — none of its Tasks
@@ -29,7 +30,7 @@ function draftPrivateSql(viewer, alias) {
29
30
  : `(not ${alias}."is_draft" and not ${alias}."is_private")`;
30
31
  if (viewer.adminUserId === null)
31
32
  return { sql: published, params: [] };
32
- if (!UUID.test(viewer.adminUserId))
33
+ if (!isUuidShape(viewer.adminUserId))
33
34
  throw new Error(`tasks: "${viewer.adminUserId}" is not an administrator id.`);
34
35
  return { sql: `(${alias}."created_by_admin_user_id" = ?::uuid or ${published})`, params: [viewer.adminUserId] };
35
36
  }
@@ -44,12 +45,11 @@ export function viewerMaySee(viewer, task) {
44
45
  /** A Postgres `uuid[]` literal. The ids come from contributors, so each is checked before it is quoted. */
45
46
  export function uuidArray(ids) {
46
47
  for (const id of ids) {
47
- if (!UUID.test(id))
48
+ if (!isUuidShape(id))
48
49
  throw new Error(`tasks: "${id}" is not a uuid a context may be identified by.`);
49
50
  }
50
51
  return `{${ids.map((id) => `"${id}"`).join(',')}}`;
51
52
  }
52
- const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
53
53
  /** Whether the ambient caller is the system — the one caller visibility does not narrow. */
54
54
  export function isSystemActor() {
55
55
  return getTenantContext()?.actor.kind === 'system';
@@ -0,0 +1,57 @@
1
+ import type { EntityManager } from '@mikro-orm/postgresql';
2
+ import type { CommandBus } from '@endora-commerce/platform/commands';
3
+ import type { AuditPort } from '@endora-commerce/platform/kernel';
4
+ /**
5
+ * The time-zone pass — what Tasks counted in `tasks.time_zone` follows a
6
+ * change of it (issue #505; `specs/165-task-management/` data-model §5,
7
+ * research R-17).
8
+ *
9
+ * Two things are derived in the zone when a due date or time is written, and
10
+ * are re-derived here once the zone has changed:
11
+ *
12
+ * - `due_on` of a Task with a due time — that time's date in the zone;
13
+ * - `remind_at` of a relative reminder on a date-only Task — 09:00 of its due
14
+ * date in the zone, less the offset.
15
+ *
16
+ * **A pass of the `tasks-reminders` tick, not an event handler** (Constitution
17
+ * X, the module's own rule that BullMQ is the clock and the tables are the
18
+ * schedule): the probe asks whether anything is out of step with the zone as
19
+ * it is now, so a change by any path — the Tasks screen, the generic settings
20
+ * write — is caught, and so is one made while Tasks was off, or a Task written
21
+ * with the old zone in the instant the setting changed. It runs first on every
22
+ * tick, so a reminder the zone moved is not sent at its old moment.
23
+ *
24
+ * **The zone arithmetic of the pass is Postgres's**, as the overdue filter's
25
+ * is (`task-service.ts`), so the probe and the pass answer the same question
26
+ * and a pass leaves nothing for the next probe to find.
27
+ *
28
+ * Tasks are walked by id, {@link REDERIVE_BATCH} at a time; each is one
29
+ * `tasks.task.update` Command, as the system, `reason: 'time_zone_changed'`,
30
+ * which re-reads the Task under its lock and leaves one that moved meanwhile.
31
+ */
32
+ /** Tasks re-derived per read. */
33
+ export declare const REDERIVE_BATCH = 500;
34
+ export interface TaskTimeZoneRederiveServiceDeps {
35
+ emFactory: () => EntityManager;
36
+ commandBus: CommandBus;
37
+ /** The kernel's audit port — handed to {@link rederiveTaskDueCommand} with the reminders. */
38
+ auditLog: AuditPort;
39
+ /** `tasks.time_zone`, read per pass. */
40
+ timeZone: () => Promise<string>;
41
+ }
42
+ export interface TaskTimeZoneRederivePassSummary {
43
+ rederived: number;
44
+ }
45
+ export declare class TaskTimeZoneRederiveService {
46
+ #private;
47
+ private readonly deps;
48
+ constructor(deps: TaskTimeZoneRederiveServiceDeps);
49
+ /**
50
+ * Whether a pass would have anything to do — yes or no, outside any scope
51
+ * (issue #120): a Task or a relative reminder out of step with the zone.
52
+ */
53
+ hasWork(): Promise<boolean>;
54
+ /** One pass, in the system scope. */
55
+ pass(): Promise<TaskTimeZoneRederivePassSummary>;
56
+ }
57
+ //# sourceMappingURL=time-zone-rederive-service.d.ts.map
@@ -0,0 +1,105 @@
1
+ import { anyRowExists } from './scheduled-work-probe.js';
2
+ import { rederiveTaskDueCommand } from './task-commands.js';
3
+ /**
4
+ * The time-zone pass — what Tasks counted in `tasks.time_zone` follows a
5
+ * change of it (issue #505; `specs/165-task-management/` data-model §5,
6
+ * research R-17).
7
+ *
8
+ * Two things are derived in the zone when a due date or time is written, and
9
+ * are re-derived here once the zone has changed:
10
+ *
11
+ * - `due_on` of a Task with a due time — that time's date in the zone;
12
+ * - `remind_at` of a relative reminder on a date-only Task — 09:00 of its due
13
+ * date in the zone, less the offset.
14
+ *
15
+ * **A pass of the `tasks-reminders` tick, not an event handler** (Constitution
16
+ * X, the module's own rule that BullMQ is the clock and the tables are the
17
+ * schedule): the probe asks whether anything is out of step with the zone as
18
+ * it is now, so a change by any path — the Tasks screen, the generic settings
19
+ * write — is caught, and so is one made while Tasks was off, or a Task written
20
+ * with the old zone in the instant the setting changed. It runs first on every
21
+ * tick, so a reminder the zone moved is not sent at its old moment.
22
+ *
23
+ * **The zone arithmetic of the pass is Postgres's**, as the overdue filter's
24
+ * is (`task-service.ts`), so the probe and the pass answer the same question
25
+ * and a pass leaves nothing for the next probe to find.
26
+ *
27
+ * Tasks are walked by id, {@link REDERIVE_BATCH} at a time; each is one
28
+ * `tasks.task.update` Command, as the system, `reason: 'time_zone_changed'`,
29
+ * which re-reads the Task under its lock and leaves one that moved meanwhile.
30
+ */
31
+ /** Tasks re-derived per read. */
32
+ export const REDERIVE_BATCH = 500;
33
+ /** 09:00 of `t."due_on"` in the zone (the zone is the parameter). */
34
+ const DATE_ONLY_MOMENT = `(("t"."due_on" + time '09:00') at time zone ?)`;
35
+ /** `t."due_at"`'s date in the zone (the zone is the parameter). */
36
+ const DUE_ON_OF_MOMENT = `("t"."due_at" at time zone ?)::date`;
37
+ /** A Task with a due time whose `due_on` is not that time's date in `timeZone`. */
38
+ function driftedDueOn(timeZone) {
39
+ return {
40
+ from: `from "tasks" "t" where "t"."due_at" is not null and "t"."due_on" is distinct from ${DUE_ON_OF_MOMENT}`,
41
+ params: [timeZone],
42
+ };
43
+ }
44
+ /** A relative reminder on a date-only Task that does not count from 09:00 of its due date in `timeZone`. */
45
+ function driftedReminders(timeZone) {
46
+ return {
47
+ from: `from "task_reminders" "r" join "tasks" "t" on "t"."id" = "r"."task_id"
48
+ where "r"."mode" = 'relative' and "t"."due_at" is null and "t"."due_on" is not null
49
+ and "r"."remind_at" <> ${DATE_ONLY_MOMENT} - make_interval(mins => "r"."offset_minutes")`,
50
+ params: [timeZone],
51
+ };
52
+ }
53
+ export class TaskTimeZoneRederiveService {
54
+ deps;
55
+ constructor(deps) {
56
+ this.deps = deps;
57
+ }
58
+ /**
59
+ * Whether a pass would have anything to do — yes or no, outside any scope
60
+ * (issue #120): a Task or a relative reminder out of step with the zone.
61
+ */
62
+ async hasWork() {
63
+ const timeZone = await this.deps.timeZone();
64
+ return anyRowExists(this.deps.emFactory(), [driftedDueOn(timeZone), driftedReminders(timeZone)]);
65
+ }
66
+ /** One pass, in the system scope. */
67
+ async pass() {
68
+ const timeZone = await this.deps.timeZone();
69
+ const summary = { rederived: 0 };
70
+ let after = null;
71
+ for (;;) {
72
+ const rows = await this.#drifted(timeZone, after);
73
+ if (rows.length === 0)
74
+ break;
75
+ after = rows[rows.length - 1].id;
76
+ for (const row of rows) {
77
+ const changed = await this.deps.commandBus.run(rederiveTaskDueCommand(row.id, {
78
+ seen: { dueOn: row.due_on, dueAt: row.due_at === null ? null : new Date(row.due_at).toISOString() },
79
+ dueOn: row.derived_due_on,
80
+ moment: row.moment === null ? null : new Date(row.moment),
81
+ }, this.deps.auditLog));
82
+ if (changed)
83
+ summary.rederived += 1;
84
+ }
85
+ if (rows.length < REDERIVE_BATCH)
86
+ break;
87
+ }
88
+ return summary;
89
+ }
90
+ /** The next batch of Tasks out of step with `timeZone`, in id order, after `after`, with what the zone makes of them. */
91
+ async #drifted(timeZone, after) {
92
+ return (await this.deps.emFactory().execute(`select "t"."id", to_char("t"."due_on", 'YYYY-MM-DD') as "due_on", "t"."due_at",
93
+ case when "t"."due_at" is not null then to_char(${DUE_ON_OF_MOMENT}, 'YYYY-MM-DD') end as "derived_due_on",
94
+ case when "t"."due_at" is null and "t"."due_on" is not null then ${DATE_ONLY_MOMENT} end as "moment"
95
+ from "tasks" "t"
96
+ where (("t"."due_at" is not null and "t"."due_on" is distinct from ${DUE_ON_OF_MOMENT})
97
+ or ("t"."due_at" is null and "t"."due_on" is not null and exists (
98
+ select 1 from "task_reminders" "r"
99
+ where "r"."task_id" = "t"."id" and "r"."mode" = 'relative'
100
+ and "r"."remind_at" <> ${DATE_ONLY_MOMENT} - make_interval(mins => "r"."offset_minutes"))))
101
+ ${after === null ? '' : 'and "t"."id" > ?'}
102
+ order by "t"."id" limit ?`, [timeZone, timeZone, timeZone, timeZone, ...(after === null ? [] : [after]), REDERIVE_BATCH]));
103
+ }
104
+ }
105
+ //# sourceMappingURL=time-zone-rederive-service.js.map
@@ -12,11 +12,13 @@ import type { Redis } from 'ioredis';
12
12
  * reminder, and a moved due date has no queue to keep in step. A reminder goes
13
13
  * out within a minute or two of its moment (SC-004).
14
14
  *
15
- * **One tick, up to three passes.** The reminders on every tick; the digest
16
- * and the maintenance pass (`#450`, User Story 10 — Tasks whose context's
17
- * record is gone) each when fifteen minutes have passed since its last run in
18
- * this process — an in-memory stamp per pass, so a restart only makes it run
19
- * sooner, and a clock that went back runs it at once.
15
+ * **One tick, up to four passes.** The time-zone pass (`#505` — due dates and
16
+ * relative reminders re-derived once `tasks.time_zone` has changed) and then
17
+ * the reminders on every tick; the digest and the maintenance pass (`#450`,
18
+ * User Story 10 — Tasks whose context's record is gone) each when fifteen
19
+ * minutes have passed since its last run in this process — an in-memory stamp
20
+ * per pass, so a restart only makes it run sooner, and a clock that went back
21
+ * runs it at once.
20
22
  *
21
23
  * **More than one consumer is fine.** A reminder is claimed per recipient by
22
24
  * its delivery row, a digest per person and day by its subscription row, so
@@ -33,6 +35,7 @@ export declare const TASKS_MAINTENANCE_EVERY_MS: number;
33
35
  export declare const TASKS_REMINDERS_SCOPE_REASON = "tasks: deliver due reminders";
34
36
  export declare const TASKS_DIGEST_SCOPE_REASON = "tasks: send the daily digests";
35
37
  export declare const TASKS_MAINTENANCE_SCOPE_REASON = "tasks: clean up Tasks whose context is gone";
38
+ export declare const TASKS_REDERIVE_SCOPE_REASON = "tasks: re-derive due dates and reminders in the Tasks time zone";
36
39
  export type TasksRemindersJobData = Record<string, never>;
37
40
  /** One pass of a tick: a yes-or-no probe outside any scope, and the work inside the system scope. */
38
41
  export interface TaskSweepPass {
@@ -47,6 +50,8 @@ export interface TasksRemindersJobDeps {
47
50
  readonly reminders: TaskSweepPass;
48
51
  readonly digest: TaskSweepPass;
49
52
  readonly maintenance: TaskSweepPass;
53
+ /** Issue #505 — what was counted in an earlier `tasks.time_zone`, re-derived in the current one. */
54
+ readonly rederive: TaskSweepPass;
50
55
  readonly log: {
51
56
  warn(context: Record<string, unknown>, message: string): void;
52
57
  };
@@ -71,7 +76,8 @@ export declare function createTasksRemindersJob(deps: TasksRemindersJobDeps): Ta
71
76
  * whose entry writes the `tenant.escape_hatch` audit row (issue #120): 1 440
72
77
  * idle ticks a day write none.
73
78
  *
74
- * The reminders run every tick; the digest when {@link TASKS_DIGEST_EVERY_MS}
79
+ * The time-zone pass and then the reminders run every tick — in that order, so
80
+ * a reminder the zone moved is not sent at its old moment; the digest when {@link TASKS_DIGEST_EVERY_MS}
75
81
  * and the maintenance pass when {@link TASKS_MAINTENANCE_EVERY_MS} have passed
76
82
  * since each last ran (a clock that went back runs it at once). A
77
83
  * failed pass is logged and not re-thrown: the next tick is the retry. A
@@ -12,11 +12,13 @@ import { enterSystemScope, rethrowIfModuleDisabled } from '@endora-commerce/plat
12
12
  * reminder, and a moved due date has no queue to keep in step. A reminder goes
13
13
  * out within a minute or two of its moment (SC-004).
14
14
  *
15
- * **One tick, up to three passes.** The reminders on every tick; the digest
16
- * and the maintenance pass (`#450`, User Story 10 — Tasks whose context's
17
- * record is gone) each when fifteen minutes have passed since its last run in
18
- * this process — an in-memory stamp per pass, so a restart only makes it run
19
- * sooner, and a clock that went back runs it at once.
15
+ * **One tick, up to four passes.** The time-zone pass (`#505` — due dates and
16
+ * relative reminders re-derived once `tasks.time_zone` has changed) and then
17
+ * the reminders on every tick; the digest and the maintenance pass (`#450`,
18
+ * User Story 10 — Tasks whose context's record is gone) each when fifteen
19
+ * minutes have passed since its last run in this process — an in-memory stamp
20
+ * per pass, so a restart only makes it run sooner, and a clock that went back
21
+ * runs it at once.
20
22
  *
21
23
  * **More than one consumer is fine.** A reminder is claimed per recipient by
22
24
  * its delivery row, a digest per person and day by its subscription row, so
@@ -33,6 +35,7 @@ export const TASKS_MAINTENANCE_EVERY_MS = 15 * 60_000;
33
35
  export const TASKS_REMINDERS_SCOPE_REASON = 'tasks: deliver due reminders';
34
36
  export const TASKS_DIGEST_SCOPE_REASON = 'tasks: send the daily digests';
35
37
  export const TASKS_MAINTENANCE_SCOPE_REASON = 'tasks: clean up Tasks whose context is gone';
38
+ export const TASKS_REDERIVE_SCOPE_REASON = 'tasks: re-derive due dates and reminders in the Tasks time zone';
36
39
  export function createTasksRemindersJob(deps) {
37
40
  return { deps, cadence: { digestRanAt: null, maintenanceRanAt: null } };
38
41
  }
@@ -46,7 +49,8 @@ export function createTasksRemindersJob(deps) {
46
49
  * whose entry writes the `tenant.escape_hatch` audit row (issue #120): 1 440
47
50
  * idle ticks a day write none.
48
51
  *
49
- * The reminders run every tick; the digest when {@link TASKS_DIGEST_EVERY_MS}
52
+ * The time-zone pass and then the reminders run every tick — in that order, so
53
+ * a reminder the zone moved is not sent at its old moment; the digest when {@link TASKS_DIGEST_EVERY_MS}
50
54
  * and the maintenance pass when {@link TASKS_MAINTENANCE_EVERY_MS} have passed
51
55
  * since each last ran (a clock that went back runs it at once). A
52
56
  * failed pass is logged and not re-thrown: the next tick is the retry. A
@@ -76,6 +80,9 @@ export async function runTasksRemindersJob(job, now = new Date()) {
76
80
  };
77
81
  const at = now.getTime();
78
82
  const due = (last, every) => last === null || at < last || at - last >= every;
83
+ if (!deps.isPresent())
84
+ return;
85
+ await run(deps.rederive);
79
86
  if (!deps.isPresent())
80
87
  return;
81
88
  await run(deps.reminders);
@@ -1,3 +1,21 @@
1
+ /**
2
+ * Feature 175 (`specs/175-buyer-input-custom-fields/` research R-11) — the
3
+ * admin writes of this module's custom-field host, for `check:custom-field-writes`.
4
+ * Read as a literal by the check: keep every entry a literal object.
5
+ */
6
+ export declare const customFieldWrites: ({
7
+ entityType: "task";
8
+ kind: "create";
9
+ method: "POST";
10
+ path: string;
11
+ body: string;
12
+ } | {
13
+ entityType: "task";
14
+ kind: "update";
15
+ method: "PATCH";
16
+ path: string;
17
+ body: string;
18
+ })[];
1
19
  export declare const manifest: {
2
20
  id: string;
3
21
  name: string;
@@ -68,6 +86,7 @@ export declare const manifest: {
68
86
  weight: number;
69
87
  descriptionKey?: string | undefined;
70
88
  requiredPermission?: string | undefined;
89
+ entryApiRoute?: string | undefined;
71
90
  keywordsKey?: string | undefined;
72
91
  }[] | undefined;
73
92
  permissions?: {
@@ -77,6 +96,12 @@ export declare const manifest: {
77
96
  description?: string | undefined;
78
97
  requires?: string[] | undefined;
79
98
  }[] | undefined;
99
+ organizationPermissions?: {
100
+ code: string;
101
+ label: string;
102
+ description: string;
103
+ memberDefault: boolean;
104
+ }[] | undefined;
80
105
  transactionalEmails?: {
81
106
  code: string;
82
107
  name: string;
@@ -105,7 +130,7 @@ export declare const manifest: {
105
130
  category: string;
106
131
  contexts: ("email" | "document" | "cms" | "invoice" | "newsletter")[];
107
132
  fields: Record<string, {
108
- type: "number" | "object" | "array" | "uuid" | "text" | "external" | "textarea" | "select" | "radio" | "richtext";
133
+ type: "number" | "object" | "array" | "text" | "select" | "external" | "uuid" | "textarea" | "radio" | "richtext";
109
134
  label?: string | undefined;
110
135
  required?: boolean | undefined;
111
136
  options?: {
@@ -164,5 +189,10 @@ export declare const manifest: {
164
189
  consumers: ("admin" | "backend" | "storefront")[];
165
190
  addressOf: "admin" | "backend" | "storefront" | null;
166
191
  }[] | undefined;
192
+ hookableActions?: {
193
+ action: string;
194
+ objectType: string;
195
+ phases: ("beforeCommit" | "afterCommit")[];
196
+ }[] | undefined;
167
197
  };
168
198
  //# sourceMappingURL=manifest.d.ts.map
package/dist/manifest.js CHANGED
@@ -51,6 +51,27 @@ const settings = defineModuleSettingsManifest({
51
51
  },
52
52
  ],
53
53
  });
54
+ /**
55
+ * Feature 175 (`specs/175-buyer-input-custom-fields/` research R-11) — the
56
+ * admin writes of this module's custom-field host, for `check:custom-field-writes`.
57
+ * Read as a literal by the check: keep every entry a literal object.
58
+ */
59
+ export const customFieldWrites = [
60
+ {
61
+ entityType: 'task',
62
+ kind: 'create',
63
+ method: 'POST',
64
+ path: '/api/v1/admin/tasks',
65
+ body: 'CreateTaskBodySchema',
66
+ },
67
+ {
68
+ entityType: 'task',
69
+ kind: 'update',
70
+ method: 'PATCH',
71
+ path: '/api/v1/admin/tasks/:id',
72
+ body: 'UpdateTaskBodySchema',
73
+ },
74
+ ];
54
75
  export const manifest = defineModuleManifest({
55
76
  id: 'tasks',
56
77
  name: 'Tasks',
@@ -229,7 +250,10 @@ export const manifest = defineModuleManifest({
229
250
  { code: 'TASK_PRIORITY_UNKNOWN' },
230
251
  { code: 'TASK_TAG_UNKNOWN' },
231
252
  { code: 'TASK_TAG_NAME_TAKEN' },
232
- { code: 'TASK_ATTACHMENT_REFUSED' },
253
+ // Issue #642 (#86) — a public file is refused under the same code, with
254
+ // `not_private` as the refusal token choosing its own sentence; the size
255
+ // and active-content refusals carry none and keep the code's sentence.
256
+ { code: 'TASK_ATTACHMENT_REFUSED', tokens: ['not_private'] },
233
257
  { code: 'TASK_VIEW_NAME_TAKEN' },
234
258
  { code: 'TASK_PARENT_CYCLE' },
235
259
  { code: 'TASK_HIERARCHY_TOO_DEEP' },
@@ -344,6 +368,11 @@ export const manifest = defineModuleManifest({
344
368
  { key: 'task.number', label: 'Task number', sampleValue: 'TSK-000042' },
345
369
  { key: 'task.title', label: 'Task title', sampleValue: 'Measure the showroom' },
346
370
  { key: 'task.due', label: 'Task due date', sampleValue: 'October 30, 2026 14:00' },
371
+ {
372
+ key: 'task.adminUrl',
373
+ label: 'Link to the task in the admin panel (empty when ADMIN_BASE_URL is not set)',
374
+ sampleValue: 'https://admin.example.com/tasks/00000000-0000-4000-8000-000000000042',
375
+ },
347
376
  ],
348
377
  },
349
378
  {
@@ -359,6 +388,11 @@ export const manifest = defineModuleManifest({
359
388
  label: 'The tasks, one per line',
360
389
  sampleValue: 'TSK-000042 Measure the showroom — overdue since October 28\nTSK-000051 Call the installer — due today',
361
390
  },
391
+ {
392
+ key: 'digest.adminUrl',
393
+ label: 'Link to My tasks in the admin panel (empty when ADMIN_BASE_URL is not set)',
394
+ sampleValue: 'https://admin.example.com/tasks/mine',
395
+ },
362
396
  ],
363
397
  },
364
398
  ],
@@ -0,0 +1,23 @@
1
+ import { Migration } from '@mikro-orm/migrations';
2
+ /**
3
+ * A Task's own record of the values its writes changed (issue #470, D-288;
4
+ * `specs/conventions/audit-state.md` §3).
5
+ *
6
+ * The platform audit log is not tenant-scoped, so from this release a
7
+ * `tasks.*` audit entry names the fields a write changed and never their
8
+ * values: the title (owner ruling O-1, 2026-11-10), the context note, the
9
+ * custom-field values and an attachment's file name. The Task's history still
10
+ * shows them, from here. One row per Command that changed one of them, written
11
+ * in that Command's transaction; the audit entry points at it by
12
+ * `valueChangeId`.
13
+ *
14
+ * `before` is `null` for something that only arrived and `after` for something
15
+ * that went; each side holds only the keys that changed. The rows go with the
16
+ * Task (`on delete cascade`). Audit entries written before this migration are
17
+ * not touched (owner ruling O-4): they keep the values they were written with.
18
+ */
19
+ export declare class Migration20261110T054810TasksValueChanges extends Migration {
20
+ up(): Promise<void>;
21
+ down(): Promise<void>;
22
+ }
23
+ //# sourceMappingURL=20261110T054810_tasks_value_changes.d.ts.map
@@ -0,0 +1,39 @@
1
+ import { Migration } from '@mikro-orm/migrations';
2
+ /**
3
+ * A Task's own record of the values its writes changed (issue #470, D-288;
4
+ * `specs/conventions/audit-state.md` §3).
5
+ *
6
+ * The platform audit log is not tenant-scoped, so from this release a
7
+ * `tasks.*` audit entry names the fields a write changed and never their
8
+ * values: the title (owner ruling O-1, 2026-11-10), the context note, the
9
+ * custom-field values and an attachment's file name. The Task's history still
10
+ * shows them, from here. One row per Command that changed one of them, written
11
+ * in that Command's transaction; the audit entry points at it by
12
+ * `valueChangeId`.
13
+ *
14
+ * `before` is `null` for something that only arrived and `after` for something
15
+ * that went; each side holds only the keys that changed. The rows go with the
16
+ * Task (`on delete cascade`). Audit entries written before this migration are
17
+ * not touched (owner ruling O-4): they keep the values they were written with.
18
+ */
19
+ export class Migration20261110T054810TasksValueChanges extends Migration {
20
+ async up() {
21
+ this.addSql(`
22
+ create table "task_value_changes" (
23
+ "id" uuid not null default gen_random_uuid(),
24
+ "task_id" uuid not null,
25
+ "before" jsonb null,
26
+ "after" jsonb null,
27
+ "at" timestamptz not null default now(),
28
+ constraint "task_value_changes_pkey" primary key ("id"),
29
+ constraint "task_value_changes_task_fk" foreign key ("task_id")
30
+ references "tasks" ("id") on delete cascade
31
+ );
32
+ `);
33
+ this.addSql(`create index "task_value_changes_task_id_index" on "task_value_changes" ("task_id");`);
34
+ }
35
+ async down() {
36
+ this.addSql('drop table if exists "task_value_changes" cascade;');
37
+ }
38
+ }
39
+ //# sourceMappingURL=20261110T054810_tasks_value_changes.js.map
@@ -11,6 +11,7 @@
11
11
  */
12
12
  import { Migration20261026T133731TasksInit } from './20261026T133731_tasks_init.js';
13
13
  import { Migration20261028T140002TasksTaskManagement } from './20261028T140002_tasks_task_management.js';
14
+ import { Migration20261110T054810TasksValueChanges } from './20261110T054810_tasks_value_changes.js';
14
15
  export declare const migrations: (typeof Migration20261026T133731TasksInit)[];
15
- export { Migration20261026T133731TasksInit, Migration20261028T140002TasksTaskManagement };
16
+ export { Migration20261026T133731TasksInit, Migration20261028T140002TasksTaskManagement, Migration20261110T054810TasksValueChanges, };
16
17
  //# sourceMappingURL=index.d.ts.map