@endora-commerce/mod-tasks 0.0.0-stage → 0.110.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (543) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +61 -2
  3. package/dist/admin/api.d.ts +121 -0
  4. package/dist/admin/api.d.ts.map +1 -0
  5. package/dist/admin/api.js +262 -0
  6. package/dist/admin/api.js.map +1 -0
  7. package/dist/admin/components/AssigneePicker.d.ts +36 -0
  8. package/dist/admin/components/AssigneePicker.d.ts.map +1 -0
  9. package/dist/admin/components/AssigneePicker.js +64 -0
  10. package/dist/admin/components/AssigneePicker.js.map +1 -0
  11. package/dist/admin/components/BoardCardFieldsEditor.d.ts +23 -0
  12. package/dist/admin/components/BoardCardFieldsEditor.d.ts.map +1 -0
  13. package/dist/admin/components/BoardCardFieldsEditor.js +138 -0
  14. package/dist/admin/components/BoardCardFieldsEditor.js.map +1 -0
  15. package/dist/admin/components/ContextLabel.d.ts +13 -0
  16. package/dist/admin/components/ContextLabel.d.ts.map +1 -0
  17. package/dist/admin/components/ContextLabel.js +18 -0
  18. package/dist/admin/components/ContextLabel.js.map +1 -0
  19. package/dist/admin/components/ContextSection.d.ts +27 -0
  20. package/dist/admin/components/ContextSection.d.ts.map +1 -0
  21. package/dist/admin/components/ContextSection.js +60 -0
  22. package/dist/admin/components/ContextSection.js.map +1 -0
  23. package/dist/admin/components/DigestControl.d.ts +15 -0
  24. package/dist/admin/components/DigestControl.d.ts.map +1 -0
  25. package/dist/admin/components/DigestControl.js +102 -0
  26. package/dist/admin/components/DigestControl.js.map +1 -0
  27. package/dist/admin/components/LinkedRecordsSection.d.ts +25 -0
  28. package/dist/admin/components/LinkedRecordsSection.d.ts.map +1 -0
  29. package/dist/admin/components/LinkedRecordsSection.js +93 -0
  30. package/dist/admin/components/LinkedRecordsSection.js.map +1 -0
  31. package/dist/admin/components/LookupPicker.d.ts +26 -0
  32. package/dist/admin/components/LookupPicker.d.ts.map +1 -0
  33. package/dist/admin/components/LookupPicker.js +42 -0
  34. package/dist/admin/components/LookupPicker.js.map +1 -0
  35. package/dist/admin/components/RelatedTasksSection.d.ts +19 -0
  36. package/dist/admin/components/RelatedTasksSection.d.ts.map +1 -0
  37. package/dist/admin/components/RelatedTasksSection.js +64 -0
  38. package/dist/admin/components/RelatedTasksSection.js.map +1 -0
  39. package/dist/admin/components/RemindersSection.d.ts +22 -0
  40. package/dist/admin/components/RemindersSection.d.ts.map +1 -0
  41. package/dist/admin/components/RemindersSection.js +107 -0
  42. package/dist/admin/components/RemindersSection.js.map +1 -0
  43. package/dist/admin/components/StatusBadge.d.ts +13 -0
  44. package/dist/admin/components/StatusBadge.d.ts.map +1 -0
  45. package/dist/admin/components/StatusBadge.js +12 -0
  46. package/dist/admin/components/StatusBadge.js.map +1 -0
  47. package/dist/admin/components/SubtasksSection.d.ts +25 -0
  48. package/dist/admin/components/SubtasksSection.d.ts.map +1 -0
  49. package/dist/admin/components/SubtasksSection.js +76 -0
  50. package/dist/admin/components/SubtasksSection.js.map +1 -0
  51. package/dist/admin/components/TaskAttachments.d.ts +24 -0
  52. package/dist/admin/components/TaskAttachments.d.ts.map +1 -0
  53. package/dist/admin/components/TaskAttachments.js +135 -0
  54. package/dist/admin/components/TaskAttachments.js.map +1 -0
  55. package/dist/admin/components/TaskBoard.d.ts +44 -0
  56. package/dist/admin/components/TaskBoard.d.ts.map +1 -0
  57. package/dist/admin/components/TaskBoard.js +295 -0
  58. package/dist/admin/components/TaskBoard.js.map +1 -0
  59. package/dist/admin/components/TaskCard.d.ts +14 -0
  60. package/dist/admin/components/TaskCard.d.ts.map +1 -0
  61. package/dist/admin/components/TaskCard.js +125 -0
  62. package/dist/admin/components/TaskCard.js.map +1 -0
  63. package/dist/admin/components/TaskComments.d.ts +18 -0
  64. package/dist/admin/components/TaskComments.d.ts.map +1 -0
  65. package/dist/admin/components/TaskComments.js +58 -0
  66. package/dist/admin/components/TaskComments.js.map +1 -0
  67. package/dist/admin/components/TaskCustomFields.d.ts +15 -0
  68. package/dist/admin/components/TaskCustomFields.d.ts.map +1 -0
  69. package/dist/admin/components/TaskCustomFields.js +66 -0
  70. package/dist/admin/components/TaskCustomFields.js.map +1 -0
  71. package/dist/admin/components/TaskFieldInputs.d.ts +47 -0
  72. package/dist/admin/components/TaskFieldInputs.d.ts.map +1 -0
  73. package/dist/admin/components/TaskFieldInputs.js +79 -0
  74. package/dist/admin/components/TaskFieldInputs.js.map +1 -0
  75. package/dist/admin/components/TaskFilters.d.ts +34 -0
  76. package/dist/admin/components/TaskFilters.d.ts.map +1 -0
  77. package/dist/admin/components/TaskFilters.js +100 -0
  78. package/dist/admin/components/TaskFilters.js.map +1 -0
  79. package/dist/admin/components/TaskMarkers.d.ts +13 -0
  80. package/dist/admin/components/TaskMarkers.d.ts.map +1 -0
  81. package/dist/admin/components/TaskMarkers.js +20 -0
  82. package/dist/admin/components/TaskMarkers.js.map +1 -0
  83. package/dist/admin/components/TaskPicker.d.ts +21 -0
  84. package/dist/admin/components/TaskPicker.d.ts.map +1 -0
  85. package/dist/admin/components/TaskPicker.js +56 -0
  86. package/dist/admin/components/TaskPicker.js.map +1 -0
  87. package/dist/admin/components/ViewModeToggle.d.ts +12 -0
  88. package/dist/admin/components/ViewModeToggle.d.ts.map +1 -0
  89. package/dist/admin/components/ViewModeToggle.js +18 -0
  90. package/dist/admin/components/ViewModeToggle.js.map +1 -0
  91. package/dist/admin/components/priorities/TaskPriorityDeleteDialog.d.ts +20 -0
  92. package/dist/admin/components/priorities/TaskPriorityDeleteDialog.d.ts.map +1 -0
  93. package/dist/admin/components/priorities/TaskPriorityDeleteDialog.js +59 -0
  94. package/dist/admin/components/priorities/TaskPriorityDeleteDialog.js.map +1 -0
  95. package/dist/admin/components/priorities/TaskPriorityDialog.d.ts +29 -0
  96. package/dist/admin/components/priorities/TaskPriorityDialog.d.ts.map +1 -0
  97. package/dist/admin/components/priorities/TaskPriorityDialog.js +88 -0
  98. package/dist/admin/components/priorities/TaskPriorityDialog.js.map +1 -0
  99. package/dist/admin/components/tags/TaskTagDeleteDialog.d.ts +16 -0
  100. package/dist/admin/components/tags/TaskTagDeleteDialog.d.ts.map +1 -0
  101. package/dist/admin/components/tags/TaskTagDeleteDialog.js +34 -0
  102. package/dist/admin/components/tags/TaskTagDeleteDialog.js.map +1 -0
  103. package/dist/admin/components/tags/TaskTagDialog.d.ts +27 -0
  104. package/dist/admin/components/tags/TaskTagDialog.d.ts.map +1 -0
  105. package/dist/admin/components/tags/TaskTagDialog.js +60 -0
  106. package/dist/admin/components/tags/TaskTagDialog.js.map +1 -0
  107. package/dist/admin/components/task-columns.d.ts +5 -0
  108. package/dist/admin/components/task-columns.d.ts.map +1 -0
  109. package/dist/admin/components/task-columns.js +72 -0
  110. package/dist/admin/components/task-columns.js.map +1 -0
  111. package/dist/admin/components/workflow/TaskStatusDeleteDialog.d.ts +21 -0
  112. package/dist/admin/components/workflow/TaskStatusDeleteDialog.d.ts.map +1 -0
  113. package/dist/admin/components/workflow/TaskStatusDeleteDialog.js +63 -0
  114. package/dist/admin/components/workflow/TaskStatusDeleteDialog.js.map +1 -0
  115. package/dist/admin/components/workflow/TaskStatusDialog.d.ts +32 -0
  116. package/dist/admin/components/workflow/TaskStatusDialog.d.ts.map +1 -0
  117. package/dist/admin/components/workflow/TaskStatusDialog.js +102 -0
  118. package/dist/admin/components/workflow/TaskStatusDialog.js.map +1 -0
  119. package/dist/admin/components/workflow/TaskStatusesTable.d.ts +20 -0
  120. package/dist/admin/components/workflow/TaskStatusesTable.d.ts.map +1 -0
  121. package/dist/admin/components/workflow/TaskStatusesTable.js +25 -0
  122. package/dist/admin/components/workflow/TaskStatusesTable.js.map +1 -0
  123. package/dist/admin/index.d.ts +20 -0
  124. package/dist/admin/index.d.ts.map +1 -0
  125. package/dist/admin/index.js +121 -0
  126. package/dist/admin/index.js.map +1 -0
  127. package/dist/admin/lib/current-admin.d.ts +6 -0
  128. package/dist/admin/lib/current-admin.d.ts.map +1 -0
  129. package/dist/admin/lib/current-admin.js +11 -0
  130. package/dist/admin/lib/current-admin.js.map +1 -0
  131. package/dist/admin/lib/labels.d.ts +30 -0
  132. package/dist/admin/lib/labels.d.ts.map +1 -0
  133. package/dist/admin/lib/labels.js +76 -0
  134. package/dist/admin/lib/labels.js.map +1 -0
  135. package/dist/admin/lib/references.d.ts +16 -0
  136. package/dist/admin/lib/references.d.ts.map +1 -0
  137. package/dist/admin/lib/references.js +53 -0
  138. package/dist/admin/lib/references.js.map +1 -0
  139. package/dist/admin/lib/settings-paths.d.ts +10 -0
  140. package/dist/admin/lib/settings-paths.d.ts.map +1 -0
  141. package/dist/admin/lib/settings-paths.js +10 -0
  142. package/dist/admin/lib/settings-paths.js.map +1 -0
  143. package/dist/admin/lib/task-filters.d.ts +69 -0
  144. package/dist/admin/lib/task-filters.d.ts.map +1 -0
  145. package/dist/admin/lib/task-filters.js +180 -0
  146. package/dist/admin/lib/task-filters.js.map +1 -0
  147. package/dist/admin/lib/use-editor-focus.d.ts +25 -0
  148. package/dist/admin/lib/use-editor-focus.d.ts.map +1 -0
  149. package/dist/admin/lib/use-editor-focus.js +54 -0
  150. package/dist/admin/lib/use-editor-focus.js.map +1 -0
  151. package/dist/admin/lib/use-task-vocabulary.d.ts +15 -0
  152. package/dist/admin/lib/use-task-vocabulary.d.ts.map +1 -0
  153. package/dist/admin/lib/use-task-vocabulary.js +26 -0
  154. package/dist/admin/lib/use-task-vocabulary.js.map +1 -0
  155. package/dist/admin/pages/MyTasksPage.d.ts +17 -0
  156. package/dist/admin/pages/MyTasksPage.d.ts.map +1 -0
  157. package/dist/admin/pages/MyTasksPage.js +96 -0
  158. package/dist/admin/pages/MyTasksPage.js.map +1 -0
  159. package/dist/admin/pages/TaskCreate.d.ts +34 -0
  160. package/dist/admin/pages/TaskCreate.d.ts.map +1 -0
  161. package/dist/admin/pages/TaskCreate.js +146 -0
  162. package/dist/admin/pages/TaskCreate.js.map +1 -0
  163. package/dist/admin/pages/TaskDetail.d.ts +33 -0
  164. package/dist/admin/pages/TaskDetail.d.ts.map +1 -0
  165. package/dist/admin/pages/TaskDetail.js +431 -0
  166. package/dist/admin/pages/TaskDetail.js.map +1 -0
  167. package/dist/admin/pages/TasksPage.d.ts +21 -0
  168. package/dist/admin/pages/TasksPage.d.ts.map +1 -0
  169. package/dist/admin/pages/TasksPage.js +145 -0
  170. package/dist/admin/pages/TasksPage.js.map +1 -0
  171. package/dist/admin/pages/settings/TaskGeneralSettingsPage.d.ts +13 -0
  172. package/dist/admin/pages/settings/TaskGeneralSettingsPage.d.ts.map +1 -0
  173. package/dist/admin/pages/settings/TaskGeneralSettingsPage.js +75 -0
  174. package/dist/admin/pages/settings/TaskGeneralSettingsPage.js.map +1 -0
  175. package/dist/admin/pages/settings/TaskPrioritiesPage.d.ts +16 -0
  176. package/dist/admin/pages/settings/TaskPrioritiesPage.d.ts.map +1 -0
  177. package/dist/admin/pages/settings/TaskPrioritiesPage.js +75 -0
  178. package/dist/admin/pages/settings/TaskPrioritiesPage.js.map +1 -0
  179. package/dist/admin/pages/settings/TaskTagsPage.d.ts +16 -0
  180. package/dist/admin/pages/settings/TaskTagsPage.d.ts.map +1 -0
  181. package/dist/admin/pages/settings/TaskTagsPage.js +68 -0
  182. package/dist/admin/pages/settings/TaskTagsPage.js.map +1 -0
  183. package/dist/admin/pages/settings/TaskWorkflowPage.d.ts +22 -0
  184. package/dist/admin/pages/settings/TaskWorkflowPage.d.ts.map +1 -0
  185. package/dist/admin/pages/settings/TaskWorkflowPage.js +110 -0
  186. package/dist/admin/pages/settings/TaskWorkflowPage.js.map +1 -0
  187. package/dist/admin/zones/OpportunityTasksPanel.d.ts +7 -0
  188. package/dist/admin/zones/OpportunityTasksPanel.d.ts.map +1 -0
  189. package/dist/admin/zones/OpportunityTasksPanel.js +9 -0
  190. package/dist/admin/zones/OpportunityTasksPanel.js.map +1 -0
  191. package/dist/admin/zones/OrderTasksPanel.d.ts +7 -0
  192. package/dist/admin/zones/OrderTasksPanel.d.ts.map +1 -0
  193. package/dist/admin/zones/OrderTasksPanel.js +9 -0
  194. package/dist/admin/zones/OrderTasksPanel.js.map +1 -0
  195. package/dist/admin/zones/QuoteRequestTasksPanel.d.ts +7 -0
  196. package/dist/admin/zones/QuoteRequestTasksPanel.d.ts.map +1 -0
  197. package/dist/admin/zones/QuoteRequestTasksPanel.js +9 -0
  198. package/dist/admin/zones/QuoteRequestTasksPanel.js.map +1 -0
  199. package/dist/admin/zones/TasksPanel.d.ts +22 -0
  200. package/dist/admin/zones/TasksPanel.d.ts.map +1 -0
  201. package/dist/admin/zones/TasksPanel.js +59 -0
  202. package/dist/admin/zones/TasksPanel.js.map +1 -0
  203. package/dist/backend/admin-search-provider.d.ts +38 -0
  204. package/dist/backend/admin-search-provider.d.ts.map +1 -0
  205. package/dist/backend/admin-search-provider.js +48 -0
  206. package/dist/backend/admin-search-provider.js.map +1 -0
  207. package/dist/backend/domain/board-card-fields.d.ts +35 -0
  208. package/dist/backend/domain/board-card-fields.d.ts.map +1 -0
  209. package/dist/backend/domain/board-card-fields.js +98 -0
  210. package/dist/backend/domain/board-card-fields.js.map +1 -0
  211. package/dist/backend/domain/due-moment.d.ts +28 -0
  212. package/dist/backend/domain/due-moment.d.ts.map +1 -0
  213. package/dist/backend/domain/due-moment.js +66 -0
  214. package/dist/backend/domain/due-moment.js.map +1 -0
  215. package/dist/backend/domain/hierarchy.d.ts +36 -0
  216. package/dist/backend/domain/hierarchy.d.ts.map +1 -0
  217. package/dist/backend/domain/hierarchy.js +13 -0
  218. package/dist/backend/domain/hierarchy.js.map +1 -0
  219. package/dist/backend/domain/list-cursor.d.ts +27 -0
  220. package/dist/backend/domain/list-cursor.d.ts.map +1 -0
  221. package/dist/backend/domain/list-cursor.js +74 -0
  222. package/dist/backend/domain/list-cursor.js.map +1 -0
  223. package/dist/backend/domain/task-status-graph.d.ts +73 -0
  224. package/dist/backend/domain/task-status-graph.d.ts.map +1 -0
  225. package/dist/backend/domain/task-status-graph.js +90 -0
  226. package/dist/backend/domain/task-status-graph.js.map +1 -0
  227. package/dist/backend/email-templates/digest-defaults.d.ts +30 -0
  228. package/dist/backend/email-templates/digest-defaults.d.ts.map +1 -0
  229. package/dist/backend/email-templates/digest-defaults.js +50 -0
  230. package/dist/backend/email-templates/digest-defaults.js.map +1 -0
  231. package/dist/backend/email-templates/reminder-defaults.d.ts +24 -0
  232. package/dist/backend/email-templates/reminder-defaults.d.ts.map +1 -0
  233. package/dist/backend/email-templates/reminder-defaults.js +46 -0
  234. package/dist/backend/email-templates/reminder-defaults.js.map +1 -0
  235. package/dist/backend/entities/task-assignee.entity.d.ts +15 -0
  236. package/dist/backend/entities/task-assignee.entity.d.ts.map +1 -0
  237. package/dist/backend/entities/task-assignee.entity.js +47 -0
  238. package/dist/backend/entities/task-assignee.entity.js.map +1 -0
  239. package/dist/backend/entities/task-attachment.entity.d.ts +15 -0
  240. package/dist/backend/entities/task-attachment.entity.d.ts.map +1 -0
  241. package/dist/backend/entities/task-attachment.entity.js +53 -0
  242. package/dist/backend/entities/task-attachment.entity.js.map +1 -0
  243. package/dist/backend/entities/task-comment.entity.d.ts +17 -0
  244. package/dist/backend/entities/task-comment.entity.d.ts.map +1 -0
  245. package/dist/backend/entities/task-comment.entity.js +62 -0
  246. package/dist/backend/entities/task-comment.entity.js.map +1 -0
  247. package/dist/backend/entities/task-digest-subscription.entity.d.ts +15 -0
  248. package/dist/backend/entities/task-digest-subscription.entity.d.ts.map +1 -0
  249. package/dist/backend/entities/task-digest-subscription.entity.js +46 -0
  250. package/dist/backend/entities/task-digest-subscription.entity.js.map +1 -0
  251. package/dist/backend/entities/task-list-saved-view.entity.d.ts +25 -0
  252. package/dist/backend/entities/task-list-saved-view.entity.d.ts.map +1 -0
  253. package/dist/backend/entities/task-list-saved-view.entity.js +74 -0
  254. package/dist/backend/entities/task-list-saved-view.entity.js.map +1 -0
  255. package/dist/backend/entities/task-priority.entity.d.ts +17 -0
  256. package/dist/backend/entities/task-priority.entity.d.ts.map +1 -0
  257. package/dist/backend/entities/task-priority.entity.js +66 -0
  258. package/dist/backend/entities/task-priority.entity.js.map +1 -0
  259. package/dist/backend/entities/task-record-link.entity.d.ts +17 -0
  260. package/dist/backend/entities/task-record-link.entity.d.ts.map +1 -0
  261. package/dist/backend/entities/task-record-link.entity.js +58 -0
  262. package/dist/backend/entities/task-record-link.entity.js.map +1 -0
  263. package/dist/backend/entities/task-reference.entity.d.ts +21 -0
  264. package/dist/backend/entities/task-reference.entity.d.ts.map +1 -0
  265. package/dist/backend/entities/task-reference.entity.js +60 -0
  266. package/dist/backend/entities/task-reference.entity.js.map +1 -0
  267. package/dist/backend/entities/task-relation.entity.d.ts +13 -0
  268. package/dist/backend/entities/task-relation.entity.d.ts.map +1 -0
  269. package/dist/backend/entities/task-relation.entity.js +45 -0
  270. package/dist/backend/entities/task-relation.entity.js.map +1 -0
  271. package/dist/backend/entities/task-reminder-delivery.entity.d.ts +18 -0
  272. package/dist/backend/entities/task-reminder-delivery.entity.d.ts.map +1 -0
  273. package/dist/backend/entities/task-reminder-delivery.entity.js +53 -0
  274. package/dist/backend/entities/task-reminder-delivery.entity.js.map +1 -0
  275. package/dist/backend/entities/task-reminder.entity.d.ts +21 -0
  276. package/dist/backend/entities/task-reminder.entity.d.ts.map +1 -0
  277. package/dist/backend/entities/task-reminder.entity.js +70 -0
  278. package/dist/backend/entities/task-reminder.entity.js.map +1 -0
  279. package/dist/backend/entities/task-status-transition.entity.d.ts +14 -0
  280. package/dist/backend/entities/task-status-transition.entity.d.ts.map +1 -0
  281. package/dist/backend/entities/task-status-transition.entity.js +48 -0
  282. package/dist/backend/entities/task-status-transition.entity.js.map +1 -0
  283. package/dist/backend/entities/task-status.entity.d.ts +29 -0
  284. package/dist/backend/entities/task-status.entity.d.ts.map +1 -0
  285. package/dist/backend/entities/task-status.entity.js +85 -0
  286. package/dist/backend/entities/task-status.entity.js.map +1 -0
  287. package/dist/backend/entities/task-tag-assignment.entity.d.ts +10 -0
  288. package/dist/backend/entities/task-tag-assignment.entity.d.ts.map +1 -0
  289. package/dist/backend/entities/task-tag-assignment.entity.js +35 -0
  290. package/dist/backend/entities/task-tag-assignment.entity.js.map +1 -0
  291. package/dist/backend/entities/task-tag.entity.d.ts +14 -0
  292. package/dist/backend/entities/task-tag.entity.d.ts.map +1 -0
  293. package/dist/backend/entities/task-tag.entity.js +50 -0
  294. package/dist/backend/entities/task-tag.entity.js.map +1 -0
  295. package/dist/backend/entities/task.entity.d.ts +66 -0
  296. package/dist/backend/entities/task.entity.d.ts.map +1 -0
  297. package/dist/backend/entities/task.entity.js +175 -0
  298. package/dist/backend/entities/task.entity.js.map +1 -0
  299. package/dist/backend/index.d.ts +40 -0
  300. package/dist/backend/index.d.ts.map +1 -0
  301. package/dist/backend/index.js +642 -0
  302. package/dist/backend/index.js.map +1 -0
  303. package/dist/backend/routes/routes.board.d.ts +21 -0
  304. package/dist/backend/routes/routes.board.d.ts.map +1 -0
  305. package/dist/backend/routes/routes.board.js +28 -0
  306. package/dist/backend/routes/routes.board.js.map +1 -0
  307. package/dist/backend/routes/routes.collaboration.d.ts +30 -0
  308. package/dist/backend/routes/routes.collaboration.d.ts.map +1 -0
  309. package/dist/backend/routes/routes.collaboration.js +124 -0
  310. package/dist/backend/routes/routes.collaboration.js.map +1 -0
  311. package/dist/backend/routes/routes.priorities.d.ts +15 -0
  312. package/dist/backend/routes/routes.priorities.d.ts.map +1 -0
  313. package/dist/backend/routes/routes.priorities.js +27 -0
  314. package/dist/backend/routes/routes.priorities.js.map +1 -0
  315. package/dist/backend/routes/routes.reminders.d.ts +23 -0
  316. package/dist/backend/routes/routes.reminders.d.ts.map +1 -0
  317. package/dist/backend/routes/routes.reminders.js +36 -0
  318. package/dist/backend/routes/routes.reminders.js.map +1 -0
  319. package/dist/backend/routes/routes.settings.d.ts +16 -0
  320. package/dist/backend/routes/routes.settings.d.ts.map +1 -0
  321. package/dist/backend/routes/routes.settings.js +19 -0
  322. package/dist/backend/routes/routes.settings.js.map +1 -0
  323. package/dist/backend/routes/routes.tags.d.ts +15 -0
  324. package/dist/backend/routes/routes.tags.d.ts.map +1 -0
  325. package/dist/backend/routes/routes.tags.js +27 -0
  326. package/dist/backend/routes/routes.tags.js.map +1 -0
  327. package/dist/backend/routes/routes.tasks.d.ts +42 -0
  328. package/dist/backend/routes/routes.tasks.d.ts.map +1 -0
  329. package/dist/backend/routes/routes.tasks.js +109 -0
  330. package/dist/backend/routes/routes.tasks.js.map +1 -0
  331. package/dist/backend/routes/routes.views.d.ts +17 -0
  332. package/dist/backend/routes/routes.views.d.ts.map +1 -0
  333. package/dist/backend/routes/routes.views.js +29 -0
  334. package/dist/backend/routes/routes.views.js.map +1 -0
  335. package/dist/backend/routes/routes.workflow.d.ts +19 -0
  336. package/dist/backend/routes/routes.workflow.d.ts.map +1 -0
  337. package/dist/backend/routes/routes.workflow.js +34 -0
  338. package/dist/backend/routes/routes.workflow.js.map +1 -0
  339. package/dist/backend/saved-view-actor.d.ts +16 -0
  340. package/dist/backend/saved-view-actor.d.ts.map +1 -0
  341. package/dist/backend/saved-view-actor.js +24 -0
  342. package/dist/backend/saved-view-actor.js.map +1 -0
  343. package/dist/backend/services/attachment-active-content.d.ts +22 -0
  344. package/dist/backend/services/attachment-active-content.d.ts.map +1 -0
  345. package/dist/backend/services/attachment-active-content.js +80 -0
  346. package/dist/backend/services/attachment-active-content.js.map +1 -0
  347. package/dist/backend/services/attachment-service.d.ts +71 -0
  348. package/dist/backend/services/attachment-service.d.ts.map +1 -0
  349. package/dist/backend/services/attachment-service.js +236 -0
  350. package/dist/backend/services/attachment-service.js.map +1 -0
  351. package/dist/backend/services/board-card-field-service.d.ts +36 -0
  352. package/dist/backend/services/board-card-field-service.d.ts.map +1 -0
  353. package/dist/backend/services/board-card-field-service.js +71 -0
  354. package/dist/backend/services/board-card-field-service.js.map +1 -0
  355. package/dist/backend/services/board-service.d.ts +38 -0
  356. package/dist/backend/services/board-service.d.ts.map +1 -0
  357. package/dist/backend/services/board-service.js +57 -0
  358. package/dist/backend/services/board-service.js.map +1 -0
  359. package/dist/backend/services/comment-service.d.ts +61 -0
  360. package/dist/backend/services/comment-service.d.ts.map +1 -0
  361. package/dist/backend/services/comment-service.js +219 -0
  362. package/dist/backend/services/comment-service.js.map +1 -0
  363. package/dist/backend/services/context-lookup.d.ts +19 -0
  364. package/dist/backend/services/context-lookup.d.ts.map +1 -0
  365. package/dist/backend/services/context-lookup.js +53 -0
  366. package/dist/backend/services/context-lookup.js.map +1 -0
  367. package/dist/backend/services/digest-service.d.ts +88 -0
  368. package/dist/backend/services/digest-service.d.ts.map +1 -0
  369. package/dist/backend/services/digest-service.js +212 -0
  370. package/dist/backend/services/digest-service.js.map +1 -0
  371. package/dist/backend/services/document-lookup-service.d.ts +40 -0
  372. package/dist/backend/services/document-lookup-service.d.ts.map +1 -0
  373. package/dist/backend/services/document-lookup-service.js +67 -0
  374. package/dist/backend/services/document-lookup-service.js.map +1 -0
  375. package/dist/backend/services/hierarchy-service.d.ts +66 -0
  376. package/dist/backend/services/hierarchy-service.d.ts.map +1 -0
  377. package/dist/backend/services/hierarchy-service.js +132 -0
  378. package/dist/backend/services/hierarchy-service.js.map +1 -0
  379. package/dist/backend/services/maintenance-service.d.ts +61 -0
  380. package/dist/backend/services/maintenance-service.d.ts.map +1 -0
  381. package/dist/backend/services/maintenance-service.js +119 -0
  382. package/dist/backend/services/maintenance-service.js.map +1 -0
  383. package/dist/backend/services/mention-service.d.ts +70 -0
  384. package/dist/backend/services/mention-service.d.ts.map +1 -0
  385. package/dist/backend/services/mention-service.js +113 -0
  386. package/dist/backend/services/mention-service.js.map +1 -0
  387. package/dist/backend/services/owner-read-permissions.d.ts +50 -0
  388. package/dist/backend/services/owner-read-permissions.d.ts.map +1 -0
  389. package/dist/backend/services/owner-read-permissions.js +58 -0
  390. package/dist/backend/services/owner-read-permissions.js.map +1 -0
  391. package/dist/backend/services/priority-service.d.ts +76 -0
  392. package/dist/backend/services/priority-service.d.ts.map +1 -0
  393. package/dist/backend/services/priority-service.js +188 -0
  394. package/dist/backend/services/priority-service.js.map +1 -0
  395. package/dist/backend/services/record-link-service.d.ts +73 -0
  396. package/dist/backend/services/record-link-service.d.ts.map +1 -0
  397. package/dist/backend/services/record-link-service.js +187 -0
  398. package/dist/backend/services/record-link-service.js.map +1 -0
  399. package/dist/backend/services/record-owners.d.ts +52 -0
  400. package/dist/backend/services/record-owners.d.ts.map +1 -0
  401. package/dist/backend/services/record-owners.js +54 -0
  402. package/dist/backend/services/record-owners.js.map +1 -0
  403. package/dist/backend/services/reference-service.d.ts +77 -0
  404. package/dist/backend/services/reference-service.d.ts.map +1 -0
  405. package/dist/backend/services/reference-service.js +179 -0
  406. package/dist/backend/services/reference-service.js.map +1 -0
  407. package/dist/backend/services/relation-service.d.ts +39 -0
  408. package/dist/backend/services/relation-service.d.ts.map +1 -0
  409. package/dist/backend/services/relation-service.js +77 -0
  410. package/dist/backend/services/relation-service.js.map +1 -0
  411. package/dist/backend/services/reminder-schedule.d.ts +28 -0
  412. package/dist/backend/services/reminder-schedule.d.ts.map +1 -0
  413. package/dist/backend/services/reminder-schedule.js +60 -0
  414. package/dist/backend/services/reminder-schedule.js.map +1 -0
  415. package/dist/backend/services/reminder-service.d.ts +93 -0
  416. package/dist/backend/services/reminder-service.d.ts.map +1 -0
  417. package/dist/backend/services/reminder-service.js +370 -0
  418. package/dist/backend/services/reminder-service.js.map +1 -0
  419. package/dist/backend/services/saved-view-service.d.ts +65 -0
  420. package/dist/backend/services/saved-view-service.d.ts.map +1 -0
  421. package/dist/backend/services/saved-view-service.js +206 -0
  422. package/dist/backend/services/saved-view-service.js.map +1 -0
  423. package/dist/backend/services/scheduled-work-probe.d.ts +34 -0
  424. package/dist/backend/services/scheduled-work-probe.d.ts.map +1 -0
  425. package/dist/backend/services/scheduled-work-probe.js +30 -0
  426. package/dist/backend/services/scheduled-work-probe.js.map +1 -0
  427. package/dist/backend/services/tag-service.d.ts +53 -0
  428. package/dist/backend/services/tag-service.d.ts.map +1 -0
  429. package/dist/backend/services/tag-service.js +165 -0
  430. package/dist/backend/services/tag-service.js.map +1 -0
  431. package/dist/backend/services/task-access.d.ts +95 -0
  432. package/dist/backend/services/task-access.d.ts.map +1 -0
  433. package/dist/backend/services/task-access.js +183 -0
  434. package/dist/backend/services/task-access.js.map +1 -0
  435. package/dist/backend/services/task-asset-references.d.ts +42 -0
  436. package/dist/backend/services/task-asset-references.d.ts.map +1 -0
  437. package/dist/backend/services/task-asset-references.js +52 -0
  438. package/dist/backend/services/task-asset-references.js.map +1 -0
  439. package/dist/backend/services/task-audit-references.d.ts +18 -0
  440. package/dist/backend/services/task-audit-references.d.ts.map +1 -0
  441. package/dist/backend/services/task-audit-references.js +26 -0
  442. package/dist/backend/services/task-audit-references.js.map +1 -0
  443. package/dist/backend/services/task-checks.d.ts +78 -0
  444. package/dist/backend/services/task-checks.d.ts.map +1 -0
  445. package/dist/backend/services/task-checks.js +148 -0
  446. package/dist/backend/services/task-checks.js.map +1 -0
  447. package/dist/backend/services/task-commands.d.ts +199 -0
  448. package/dist/backend/services/task-commands.d.ts.map +1 -0
  449. package/dist/backend/services/task-commands.js +483 -0
  450. package/dist/backend/services/task-commands.js.map +1 -0
  451. package/dist/backend/services/task-context-registry.d.ts +34 -0
  452. package/dist/backend/services/task-context-registry.d.ts.map +1 -0
  453. package/dist/backend/services/task-context-registry.js +49 -0
  454. package/dist/backend/services/task-context-registry.js.map +1 -0
  455. package/dist/backend/services/task-custom-fields.d.ts +21 -0
  456. package/dist/backend/services/task-custom-fields.d.ts.map +1 -0
  457. package/dist/backend/services/task-custom-fields.js +34 -0
  458. package/dist/backend/services/task-custom-fields.js.map +1 -0
  459. package/dist/backend/services/task-email.d.ts +116 -0
  460. package/dist/backend/services/task-email.d.ts.map +1 -0
  461. package/dist/backend/services/task-email.js +128 -0
  462. package/dist/backend/services/task-email.js.map +1 -0
  463. package/dist/backend/services/task-errors.d.ts +34 -0
  464. package/dist/backend/services/task-errors.d.ts.map +1 -0
  465. package/dist/backend/services/task-errors.js +56 -0
  466. package/dist/backend/services/task-errors.js.map +1 -0
  467. package/dist/backend/services/task-history-service.d.ts +34 -0
  468. package/dist/backend/services/task-history-service.d.ts.map +1 -0
  469. package/dist/backend/services/task-history-service.js +185 -0
  470. package/dist/backend/services/task-history-service.js.map +1 -0
  471. package/dist/backend/services/task-notifier.d.ts +85 -0
  472. package/dist/backend/services/task-notifier.d.ts.map +1 -0
  473. package/dist/backend/services/task-notifier.js +96 -0
  474. package/dist/backend/services/task-notifier.js.map +1 -0
  475. package/dist/backend/services/task-number.d.ts +17 -0
  476. package/dist/backend/services/task-number.d.ts.map +1 -0
  477. package/dist/backend/services/task-number.js +30 -0
  478. package/dist/backend/services/task-number.js.map +1 -0
  479. package/dist/backend/services/task-read-port.d.ts +25 -0
  480. package/dist/backend/services/task-read-port.d.ts.map +1 -0
  481. package/dist/backend/services/task-read-port.js +38 -0
  482. package/dist/backend/services/task-read-port.js.map +1 -0
  483. package/dist/backend/services/task-reassignment.d.ts +43 -0
  484. package/dist/backend/services/task-reassignment.d.ts.map +1 -0
  485. package/dist/backend/services/task-reassignment.js +41 -0
  486. package/dist/backend/services/task-reassignment.js.map +1 -0
  487. package/dist/backend/services/task-service.d.ts +219 -0
  488. package/dist/backend/services/task-service.d.ts.map +1 -0
  489. package/dist/backend/services/task-service.js +1112 -0
  490. package/dist/backend/services/task-service.js.map +1 -0
  491. package/dist/backend/services/task-settings-service.d.ts +23 -0
  492. package/dist/backend/services/task-settings-service.d.ts.map +1 -0
  493. package/dist/backend/services/task-settings-service.js +30 -0
  494. package/dist/backend/services/task-settings-service.js.map +1 -0
  495. package/dist/backend/services/task-transition-service.d.ts +56 -0
  496. package/dist/backend/services/task-transition-service.d.ts.map +1 -0
  497. package/dist/backend/services/task-transition-service.js +125 -0
  498. package/dist/backend/services/task-transition-service.js.map +1 -0
  499. package/dist/backend/services/task-visibility.d.ts +102 -0
  500. package/dist/backend/services/task-visibility.d.ts.map +1 -0
  501. package/dist/backend/services/task-visibility.js +106 -0
  502. package/dist/backend/services/task-visibility.js.map +1 -0
  503. package/dist/backend/services/task-workflow-read.d.ts +15 -0
  504. package/dist/backend/services/task-workflow-read.d.ts.map +1 -0
  505. package/dist/backend/services/task-workflow-read.js +53 -0
  506. package/dist/backend/services/task-workflow-read.js.map +1 -0
  507. package/dist/backend/services/task-write-port.d.ts +65 -0
  508. package/dist/backend/services/task-write-port.d.ts.map +1 -0
  509. package/dist/backend/services/task-write-port.js +115 -0
  510. package/dist/backend/services/task-write-port.js.map +1 -0
  511. package/dist/backend/services/time-zone-validator.d.ts +15 -0
  512. package/dist/backend/services/time-zone-validator.d.ts.map +1 -0
  513. package/dist/backend/services/time-zone-validator.js +28 -0
  514. package/dist/backend/services/time-zone-validator.js.map +1 -0
  515. package/dist/backend/services/workflow-config-service.d.ts +69 -0
  516. package/dist/backend/services/workflow-config-service.d.ts.map +1 -0
  517. package/dist/backend/services/workflow-config-service.js +262 -0
  518. package/dist/backend/services/workflow-config-service.js.map +1 -0
  519. package/dist/backend/workers/tasks-reminders-worker.d.ts +102 -0
  520. package/dist/backend/workers/tasks-reminders-worker.d.ts.map +1 -0
  521. package/dist/backend/workers/tasks-reminders-worker.js +134 -0
  522. package/dist/backend/workers/tasks-reminders-worker.js.map +1 -0
  523. package/dist/manifest.d.ts +174 -0
  524. package/dist/manifest.d.ts.map +1 -0
  525. package/dist/manifest.js +374 -0
  526. package/dist/manifest.js.map +1 -0
  527. package/dist/migrations/20261026T133731_tasks_init.d.ts +23 -0
  528. package/dist/migrations/20261026T133731_tasks_init.d.ts.map +1 -0
  529. package/dist/migrations/20261026T133731_tasks_init.js +61 -0
  530. package/dist/migrations/20261026T133731_tasks_init.js.map +1 -0
  531. package/dist/migrations/20261028T140002_tasks_task_management.d.ts +34 -0
  532. package/dist/migrations/20261028T140002_tasks_task_management.d.ts.map +1 -0
  533. package/dist/migrations/20261028T140002_tasks_task_management.js +371 -0
  534. package/dist/migrations/20261028T140002_tasks_task_management.js.map +1 -0
  535. package/dist/migrations/index.d.ts +16 -0
  536. package/dist/migrations/index.d.ts.map +1 -0
  537. package/dist/migrations/index.js +16 -0
  538. package/dist/migrations/index.js.map +1 -0
  539. package/docs/tasks.md +597 -0
  540. package/i18n/en.json +568 -0
  541. package/i18n/pl.json +568 -0
  542. package/package.json +102 -3
  543. package/tailwind.css +14 -0
@@ -0,0 +1,95 @@
1
+ import type { EntityManager } from '@mikro-orm/postgresql';
2
+ import type { TaskContextRegistry } from './task-context-registry.js';
3
+ import type { TaskVisibility, TaskVisibilityFacts } from './task-visibility.js';
4
+ /**
5
+ * `TaskAccess` — how a route or a service obtains **one** Task, and what the
6
+ * caller may do with it (`specs/165-task-management/` research R-3, R-21).
7
+ *
8
+ * Every read of a Task by id is `findVisible` / `loadVisible`: the row, asked
9
+ * of {@link TaskVisibility} (context, draft, private) before it is handed out,
10
+ * so a Task the caller may not see answers 404 `TASK_NOT_FOUND` exactly as a
11
+ * missing one does. Every write starts from `loadVisible` and asks
12
+ * `assertMayChange` — or `assertMayDelete` for a delete.
13
+ *
14
+ * **The seam.** Every Task-owned table is `@RuleScoped` and no ORM filter backs
15
+ * that class, so the guard against a forgotten read path is
16
+ * `visibility-seam.test.ts`: it fails on any read of a rule-scoped table
17
+ * outside `task-visibility.ts`, this file and the files of
18
+ * {@link TASK_ACCESS_READERS}, each with why that read is safe.
19
+ */
20
+ /**
21
+ * Files besides this one that read a rule-scoped Task table, each with why
22
+ * that is safe. A file belongs here only when **every** such read either
23
+ * composes {@link TaskVisibility.condition} / `taskVisibilitySql`, or is keyed
24
+ * by Task ids this file or such a read handed out. Paths are relative to
25
+ * `src/backend/`.
26
+ */
27
+ export declare const TASK_ACCESS_READERS: Readonly<Record<string, string>>;
28
+ /** One `tasks` row as every read selects it. */
29
+ export interface TaskRow {
30
+ id: string;
31
+ number: string;
32
+ title: string;
33
+ description: string;
34
+ status: string;
35
+ /** `YYYY-MM-DD`, formatted by the query so no driver date parsing is involved. */
36
+ due_on: string | null;
37
+ due_at: Date | string | null;
38
+ start_on: string | null;
39
+ priority_code: string | null;
40
+ is_draft: boolean;
41
+ is_private: boolean;
42
+ parent_task_id: string | null;
43
+ source_key: string | null;
44
+ custom_field_values: Record<string, unknown> | null;
45
+ published_at: Date | string | null;
46
+ completed_at: Date | string | null;
47
+ created_by_admin_user_id: string;
48
+ context_type: string | null;
49
+ context_id: string | null;
50
+ context_group_id: string | null;
51
+ context_note: string | null;
52
+ created_at: Date | string;
53
+ updated_at: Date | string;
54
+ }
55
+ /** The columns of {@link TaskRow}, over `tasks` aliased `t`. */
56
+ export declare const TASK_COLUMNS = "t.\"id\", t.\"number\", t.\"title\", t.\"description\", t.\"status\",\n to_char(t.\"due_on\", 'YYYY-MM-DD') as \"due_on\", t.\"due_at\", to_char(t.\"start_on\", 'YYYY-MM-DD') as \"start_on\",\n t.\"priority_code\", t.\"is_draft\", t.\"is_private\", t.\"parent_task_id\", t.\"source_key\", t.\"custom_field_values\",\n t.\"published_at\", t.\"completed_at\", t.\"created_by_admin_user_id\",\n t.\"context_type\", t.\"context_id\", t.\"context_group_id\", t.\"context_note\", t.\"created_at\", t.\"updated_at\"";
57
+ export declare function isUuid(value: string): boolean;
58
+ /** What {@link TaskVisibility.canSee} is asked about one row. */
59
+ export declare function visibilityFacts(row: TaskRow): TaskVisibilityFacts;
60
+ /** The administrator behind the current request, or `null` for the system. */
61
+ export declare function actingAdminUserId(): string | null;
62
+ /** Someone else's private Task: readable and deletable by a `tasks:see_private` holder, nothing else. */
63
+ export declare function isSomeoneElsesPrivate(row: Pick<TaskRow, 'is_private' | 'created_by_admin_user_id'>): boolean;
64
+ export interface TaskAccessDeps {
65
+ emFactory: () => EntityManager;
66
+ visibility: TaskVisibility;
67
+ contexts: TaskContextRegistry;
68
+ }
69
+ export declare class TaskAccess {
70
+ private readonly deps;
71
+ constructor(deps: TaskAccessDeps);
72
+ /** One Task the caller may see, or `null` — hidden and missing alike. */
73
+ findVisible(id: string): Promise<TaskRow | null>;
74
+ /** The **only** way a route or a service obtains a Task: 404 `TASK_NOT_FOUND` for one hidden or missing. */
75
+ loadVisible(id: string): Promise<TaskRow>;
76
+ /** Which of `ids` the caller may see — the ones hidden, missing or malformed are absent. */
77
+ visibleIds(ids: readonly string[]): Promise<Set<string>>;
78
+ /**
79
+ * The Task a write has just committed, read by id **without** visibility: the
80
+ * write may have moved it into a context the caller does not see, and
81
+ * answering 404 for a change that committed would misreport it. Never a first
82
+ * read — its id comes from a Command that ran after `loadVisible` or created it.
83
+ */
84
+ rowAfterWrite(id: string): Promise<TaskRow>;
85
+ /**
86
+ * Any write but a delete: someone else's private Task — which only a holder
87
+ * of `tasks:see_private` sees at all — answers 403 `TASK_PRIVATE_READ_ONLY`.
88
+ * A context's own say (`canChangeTasks`) is asked where 163 asked it: when a
89
+ * Task goes into or out of a record (`task-checks.ts`).
90
+ */
91
+ assertMayChange(row: TaskRow): void;
92
+ /** A delete: the record owner's `canChangeTasks` for a Task in a context (163 T147). */
93
+ assertMayDelete(row: TaskRow): Promise<void>;
94
+ }
95
+ //# sourceMappingURL=task-access.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-access.d.ts","sourceRoot":"","sources":["../../../src/backend/services/task-access.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,183 @@
1
+ import { ERROR_CODES, isUuidShape } from '@endora-commerce/contracts';
2
+ import { HttpError } from '@endora-commerce/platform/http';
3
+ import { getTenantContext } from '@endora-commerce/platform/tenancy';
4
+ import { assertMayDelete as assertContextLetsDelete } from './task-checks.js';
5
+ import { taskNotFound } from './task-errors.js';
6
+ /**
7
+ * `TaskAccess` — how a route or a service obtains **one** Task, and what the
8
+ * caller may do with it (`specs/165-task-management/` research R-3, R-21).
9
+ *
10
+ * Every read of a Task by id is `findVisible` / `loadVisible`: the row, asked
11
+ * of {@link TaskVisibility} (context, draft, private) before it is handed out,
12
+ * so a Task the caller may not see answers 404 `TASK_NOT_FOUND` exactly as a
13
+ * missing one does. Every write starts from `loadVisible` and asks
14
+ * `assertMayChange` — or `assertMayDelete` for a delete.
15
+ *
16
+ * **The seam.** Every Task-owned table is `@RuleScoped` and no ORM filter backs
17
+ * that class, so the guard against a forgotten read path is
18
+ * `visibility-seam.test.ts`: it fails on any read of a rule-scoped table
19
+ * outside `task-visibility.ts`, this file and the files of
20
+ * {@link TASK_ACCESS_READERS}, each with why that read is safe.
21
+ */
22
+ /**
23
+ * Files besides this one that read a rule-scoped Task table, each with why
24
+ * that is safe. A file belongs here only when **every** such read either
25
+ * composes {@link TaskVisibility.condition} / `taskVisibilitySql`, or is keyed
26
+ * by Task ids this file or such a read handed out. Paths are relative to
27
+ * `src/backend/`.
28
+ */
29
+ export const TASK_ACCESS_READERS = {
30
+ 'services/task-service.ts': 'The list, My Tasks, the board, search, the read port and global search compose the visibility pre-filter ' +
31
+ '(`TaskVisibility.condition` / `taskVisibilitySql`); a sub-task count composes it over the children too. ' +
32
+ 'Assignees, tags, sub-task rows and related-Task pairs are read only for the ids those queries returned (the ' +
33
+ 'other side of a pair through the pre-filter again); a Task just written is ' +
34
+ 're-read by the id its Command wrote.',
35
+ 'services/task-commands.ts': 'Every Command runs after its caller loaded the Task through `TaskAccess.loadVisible` (or, for the write ' +
36
+ 'port, is the context owner acting on its own record): it locks that one id and reads its assignees by it, ' +
37
+ 'and a delete reads the ids of its sub-tasks — every one, whoever may see it — to record on each that it ' +
38
+ 'lost its parent; the caller counts only those its reader may see.',
39
+ 'services/attachment-service.ts': 'Every read starts from `loadVisible` and is keyed by that Task\'s id, or — to ask which Tasks already hold ' +
40
+ 'a file — reads only Task ids by asset and answers them through `visibleIds`, so a file attached to a Task ' +
41
+ 'the caller may not see is refused without saying where it is.',
42
+ 'services/comment-service.ts': 'Every read and write starts from `loadVisible` and is keyed by that Task\'s id: the thread, the comment an ' +
43
+ 'author changes (and its `task_references` rows, replaced by the saving Command), and the assignees a new ' +
44
+ 'comment tells — each of whom is asked again whether they may see the Task before being told.',
45
+ 'services/priority-service.ts': 'The in-use count the list shows composes the visibility pre-filter (`TaskVisibility.condition`). Removing a ' +
46
+ 'priority is configuration (FR-024, research R-9): it moves **every** Task holding it to the replacement, or ' +
47
+ 'clears it, whoever may see the Task — drafts and private Tasks included — by the ids `task-reassignment.ts` ' +
48
+ 'locked, hands nothing back but the list, and records each move in that Task\'s own history.',
49
+ 'services/tag-service.ts': 'The usage count the list shows joins `tasks` and composes the visibility pre-filter (`TaskVisibility.condition`). ' +
50
+ 'Deleting a tag counts its assignments platform-wide, whoever may see the Tasks, because the tag leaves every one ' +
51
+ 'of them (research R-10): the count goes into the tag\'s own audit row, never to the caller.',
52
+ 'services/task-reassignment.ts': 'A status or priority removal (FR-016, FR-024) locks the ids and completion times of **every** Task holding the ' +
53
+ 'value, whoever may see it — a Task the operator cannot see still holds it — inside the removing Command; the ' +
54
+ 'caller moves them and records each move in that Task\'s history, and answers only how many moved.',
55
+ 'services/task-asset-references.ts': 'The asset library asks whether **anything** still uses a file before deleting it — platform-wide on ' +
56
+ 'purpose, by whoever deletes it, who need not see the Task — and is answered with the Task\'s number, never ' +
57
+ 'its title (research R-7; Projects\' `project-asset-references.ts`). Its reader restriction ' +
58
+ '(`specs/166-asset-reference-visibility/` FR-002) adds the attached files of the Tasks the caller may **not** ' +
59
+ 'see — the NULL-safe complement of `TaskVisibility.condition`, `(…) is not true` — and every attached file, ' +
60
+ 'read while Tasks is off; which Tasks the caller sees is `TaskAccess.visibleIds`.',
61
+ 'services/hierarchy-service.ts': 'A parent change reads the proposed parent\'s chain of ancestors and the moved Task\'s sub-tree over every ' +
62
+ 'Task, whoever may see it — a hidden descendant still closes a cycle (FR-027, R-15) — starting from the two ' +
63
+ 'ids the caller obtained through `loadVisible`, under the hierarchy lock; it hands back a refusal, never a Task.',
64
+ 'services/record-link-service.ts': 'Reads, writes and deletes the `task_record_links` rows of one Task the caller loaded through `loadVisible` ' +
65
+ '(and, to write, may change), keyed by that id; the Tasks of one record are listed by `task-service.ts` under ' +
66
+ 'the visibility pre-filter. A link narrows and widens nobody\'s view of the Task (Q2 = A).',
67
+ 'services/relation-service.ts': 'Writes and deletes the one `task_relations` row of two Tasks the caller loaded through `loadVisible` and may ' +
68
+ 'change; the related Tasks a reader is shown are read by `task-service.ts` under the visibility pre-filter.',
69
+ 'services/workflow-config-service.ts': 'A status is platform configuration: changing what it means, or removing it, asks how many Tasks are in it ' +
70
+ 'and moves them to the replacement **whoever may see them**, because a Task the operator cannot see is ' +
71
+ 'still in the status (FR-016, research R-1). It moves the ids `task-reassignment.ts` locked, hands nothing ' +
72
+ 'back to the caller but the workflow, and records each move in that Task\'s own audit history.',
73
+ 'services/reminder-service.ts': 'Setting and removing reminders starts from `loadVisible` and reads the reminders and assignees of that one ' +
74
+ 'Task by its id. The delivery pass is a sweep in the system scope (research R-17): it reads the due ' +
75
+ '(reminder, recipient) pairs with their Task\'s number, title and visibility facts, platform-wide on purpose, ' +
76
+ 'and asks the audience question — `tasks:read`, the draft/private rule, the context\'s `canSeeAs` — for each ' +
77
+ 'recipient before anything is sent; a Task a recipient may not see is recorded `skipped`, never shown.',
78
+ 'services/reminder-schedule.ts': 'Moves or removes the relative reminders of one Task inside the Command that changed its due moment, keyed by ' +
79
+ 'the id that Command locked after its caller loaded the Task through `loadVisible`.',
80
+ 'services/digest-service.ts': 'The daily digest pass, in the system scope (research R-18): for each claimed subscriber it reads the open ' +
81
+ 'Tasks assigned to them, due today or before, and asks the audience question — `tasks:read`, the ' +
82
+ 'draft/private rule, the context\'s `canSeeAs` — of each before it is listed.',
83
+ 'services/maintenance-service.ts': 'The #450 clean-up, run in the system scope its worker enters (its probe answers one bit, outside any scope): it ' +
84
+ 'walks the distinct context ids of each context type whose present owner can say which still exist, and reads ' +
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
+ 'ungroup Command, which re-reads it under the lock. Nothing read is shown or sent to anybody.',
87
+ 'services/task-write-port.ts': '`deleteInContext` lists the ids of one context for its owner — the module that registered the context type ' +
88
+ 'and is deleting its own record — and hands each to the delete Command. `createMany` looks up which of the ' +
89
+ 'source keys it was handed that one context already holds, for the same owner, and answers their ids in their ' +
90
+ 'place: ids of Tasks that owner created in its own record (R-19).',
91
+ };
92
+ /** The columns of {@link TaskRow}, over `tasks` aliased `t`. */
93
+ export const TASK_COLUMNS = `t."id", t."number", t."title", t."description", t."status",
94
+ to_char(t."due_on", 'YYYY-MM-DD') as "due_on", t."due_at", to_char(t."start_on", 'YYYY-MM-DD') as "start_on",
95
+ t."priority_code", t."is_draft", t."is_private", t."parent_task_id", t."source_key", t."custom_field_values",
96
+ t."published_at", t."completed_at", t."created_by_admin_user_id",
97
+ t."context_type", t."context_id", t."context_group_id", t."context_note", t."created_at", t."updated_at"`;
98
+ export function isUuid(value) {
99
+ return isUuidShape(value);
100
+ }
101
+ /** What {@link TaskVisibility.canSee} is asked about one row. */
102
+ export function visibilityFacts(row) {
103
+ return {
104
+ contextType: row.context_type,
105
+ contextId: row.context_id,
106
+ createdByAdminUserId: row.created_by_admin_user_id,
107
+ draft: row.is_draft,
108
+ private: row.is_private,
109
+ };
110
+ }
111
+ /** The administrator behind the current request, or `null` for the system. */
112
+ export function actingAdminUserId() {
113
+ const actor = getTenantContext()?.actor;
114
+ return actor?.kind === 'admin' && actor.id ? actor.id : null;
115
+ }
116
+ /** Someone else's private Task: readable and deletable by a `tasks:see_private` holder, nothing else. */
117
+ export function isSomeoneElsesPrivate(row) {
118
+ return row.is_private && row.created_by_admin_user_id !== actingAdminUserId();
119
+ }
120
+ export class TaskAccess {
121
+ deps;
122
+ constructor(deps) {
123
+ this.deps = deps;
124
+ }
125
+ /** One Task the caller may see, or `null` — hidden and missing alike. */
126
+ async findVisible(id) {
127
+ if (!isUuid(id))
128
+ return null;
129
+ const rows = (await this.deps.emFactory().execute(`select ${TASK_COLUMNS} from "tasks" t where t."id" = ?`, [
130
+ id,
131
+ ]));
132
+ const row = rows[0];
133
+ if (!row)
134
+ return null;
135
+ return (await this.deps.visibility.canSee(visibilityFacts(row))) ? row : null;
136
+ }
137
+ /** The **only** way a route or a service obtains a Task: 404 `TASK_NOT_FOUND` for one hidden or missing. */
138
+ async loadVisible(id) {
139
+ const row = await this.findVisible(id);
140
+ if (!row)
141
+ throw taskNotFound();
142
+ return row;
143
+ }
144
+ /** Which of `ids` the caller may see — the ones hidden, missing or malformed are absent. */
145
+ async visibleIds(ids) {
146
+ const candidates = [...new Set(ids.filter(isUuid))];
147
+ if (candidates.length === 0)
148
+ return new Set();
149
+ const visible = await this.deps.visibility.condition('t');
150
+ const rows = (await this.deps.emFactory().execute(`select t."id" from "tasks" t where t."id" = any(?::uuid[])${visible ? ` and ${visible.sql}` : ''}`, [`{${candidates.join(',')}}`, ...(visible?.params ?? [])]));
151
+ return new Set(rows.map((row) => row.id));
152
+ }
153
+ /**
154
+ * The Task a write has just committed, read by id **without** visibility: the
155
+ * write may have moved it into a context the caller does not see, and
156
+ * answering 404 for a change that committed would misreport it. Never a first
157
+ * read — its id comes from a Command that ran after `loadVisible` or created it.
158
+ */
159
+ async rowAfterWrite(id) {
160
+ const rows = (await this.deps.emFactory().execute(`select ${TASK_COLUMNS} from "tasks" t where t."id" = ?`, [
161
+ id,
162
+ ]));
163
+ if (!rows[0])
164
+ throw taskNotFound();
165
+ return rows[0];
166
+ }
167
+ /**
168
+ * Any write but a delete: someone else's private Task — which only a holder
169
+ * of `tasks:see_private` sees at all — answers 403 `TASK_PRIVATE_READ_ONLY`.
170
+ * A context's own say (`canChangeTasks`) is asked where 163 asked it: when a
171
+ * Task goes into or out of a record (`task-checks.ts`).
172
+ */
173
+ assertMayChange(row) {
174
+ if (isSomeoneElsesPrivate(row)) {
175
+ throw new HttpError(403, ERROR_CODES.TASK_PRIVATE_READ_ONLY, 'This private Task belongs to someone else: it may be read or deleted, not changed.');
176
+ }
177
+ }
178
+ /** A delete: the record owner's `canChangeTasks` for a Task in a context (163 T147). */
179
+ async assertMayDelete(row) {
180
+ await assertContextLetsDelete(this.deps.contexts, { contextType: row.context_type, contextId: row.context_id });
181
+ }
182
+ }
183
+ //# sourceMappingURL=task-access.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-access.js","sourceRoot":"","sources":["../../../src/backend/services/task-access.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,42 @@
1
+ import type { EntityManager } from '@mikro-orm/postgresql';
2
+ import type { AssetReferenceDescriptor, AssetReferenceRegistryPort } from '@endora-commerce/contracts';
3
+ import type { OwnerReadCheck } from './owner-read-permissions.js';
4
+ import type { TaskAccess } from './task-access.js';
5
+ import type { TaskVisibility } from './task-visibility.js';
6
+ /**
7
+ * Tasks → `assetReferenceRegistry`: a Task's attachments are references to
8
+ * files of the asset library, and the library refuses to delete a file that is
9
+ * still referenced (`specs/165-task-management/` FR-008, research R-7;
10
+ * Projects' `project-asset-references.ts`, the model).
11
+ *
12
+ * **Referential integrity, not a surface**, so the registry honours it while
13
+ * this module is switched off: the attachments survive a deactivation, and a
14
+ * scanner that stopped answering would let an operator delete a file that
15
+ * comes back as a broken attachment when Tasks is switched on again. The push
16
+ * is made from a contribution-only boot hook with no presence probe.
17
+ *
18
+ * One batched statement, platform-wide on purpose: the question is "does
19
+ * anything still use this file", asked by whoever deletes it in the library —
20
+ * who need not be somebody who may see the Task. For the same reason the label
21
+ * is the Task's number and never its title.
22
+ *
23
+ * **Reader-restricted** (`specs/166-asset-reference-visibility/` FR-002,
24
+ * contracts/ports.md §1.1): a file of the library is shown only to a reader
25
+ * who may see at least one record using it, so the descriptor also says which
26
+ * Tasks the ambient caller may see — by the module's one read path,
27
+ * {@link TaskVisibility}, and `tasks:read`, which that path leaves to the
28
+ * routes. The library asks it only while Tasks is present and never for the
29
+ * system or a wildcard holder; the services are resolved per call, never at
30
+ * boot, so the hook stays contribution-only.
31
+ */
32
+ export interface TaskAssetRestrictionDeps {
33
+ /** The module's `TaskAccess`, resolved per call. */
34
+ access: () => Pick<TaskAccess, 'visibleIds'>;
35
+ /** The module's `TaskVisibility`, resolved per call. */
36
+ visibility: () => Pick<TaskVisibility, 'condition'>;
37
+ /** Whether the ambient caller holds `tasks:read` (or the wildcard). */
38
+ mayReadTasks: OwnerReadCheck;
39
+ }
40
+ export declare function registerTaskAssetReferences(registry: AssetReferenceRegistryPort, emFactory: () => EntityManager, restriction: TaskAssetRestrictionDeps): void;
41
+ export declare function taskAttachmentReferenceDescriptor(emFactory: () => EntityManager, restriction: TaskAssetRestrictionDeps): AssetReferenceDescriptor;
42
+ //# sourceMappingURL=task-asset-references.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-asset-references.d.ts","sourceRoot":"","sources":["../../../src/backend/services/task-asset-references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,wBAAwB,EAGxB,0BAA0B,EAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,wBAAwB;IACvC,oDAAoD;IACpD,MAAM,EAAE,MAAM,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC7C,wDAAwD;IACxD,UAAU,EAAE,MAAM,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IACpD,uEAAuE;IACvE,YAAY,EAAE,cAAc,CAAC;CAC9B;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,0BAA0B,EACpC,SAAS,EAAE,MAAM,aAAa,EAC9B,WAAW,EAAE,wBAAwB,GACpC,IAAI,CAEN;AAED,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,aAAa,EAC9B,WAAW,EAAE,wBAAwB,GACpC,wBAAwB,CAsB1B"}
@@ -0,0 +1,52 @@
1
+ export function registerTaskAssetReferences(registry, emFactory, restriction) {
2
+ registry.register(taskAttachmentReferenceDescriptor(emFactory, restriction));
3
+ }
4
+ export function taskAttachmentReferenceDescriptor(emFactory, restriction) {
5
+ return {
6
+ ownerModuleId: 'tasks',
7
+ async findReferences(assetIds) {
8
+ if (assetIds.length === 0)
9
+ return [];
10
+ const rows = (await emFactory().execute(`select t."id"::text as "id", t."number" as "number", a."asset_id"::text as "asset_id"
11
+ from "task_attachments" a
12
+ join "tasks" t on t."id" = a."task_id"
13
+ where a."asset_id" in (${assetIds.map(() => '?').join(', ')})
14
+ order by t."number"`, [...assetIds]));
15
+ return rows.map((row) => ({
16
+ assetId: row.asset_id,
17
+ kind: 'task_attachment',
18
+ entityId: row.id,
19
+ label: `Task ${row.number}`,
20
+ }));
21
+ },
22
+ readerRestriction: taskAttachmentReaderRestriction(emFactory, restriction),
23
+ };
24
+ }
25
+ function taskAttachmentReaderRestriction(emFactory, deps) {
26
+ const allReferencedAssetIds = async () => {
27
+ const rows = (await emFactory().execute(`select distinct a."asset_id"::text as "asset_id" from "task_attachments" a`));
28
+ return rows.map((row) => row.asset_id);
29
+ };
30
+ return {
31
+ async visibleEntityIds(entityIds) {
32
+ if (!(await deps.mayReadTasks()))
33
+ return new Set();
34
+ return deps.access().visibleIds(entityIds);
35
+ },
36
+ async assetIdsWithHiddenReferences() {
37
+ if (!(await deps.mayReadTasks()))
38
+ return allReferencedAssetIds();
39
+ const visible = await deps.visibility().condition('t');
40
+ if (visible === null)
41
+ return [];
42
+ // `is not true`: a row the predicate cannot decide is hidden, never shown.
43
+ const rows = (await emFactory().execute(`select distinct a."asset_id"::text as "asset_id"
44
+ from "task_attachments" a
45
+ join "tasks" t on t."id" = a."task_id"
46
+ where (${visible.sql}) is not true`, visible.params));
47
+ return rows.map((row) => row.asset_id);
48
+ },
49
+ allReferencedAssetIds,
50
+ };
51
+ }
52
+ //# sourceMappingURL=task-asset-references.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-asset-references.js","sourceRoot":"","sources":["../../../src/backend/services/task-asset-references.ts"],"names":[],"mappings":"AA8CA,MAAM,UAAU,2BAA2B,CACzC,QAAoC,EACpC,SAA8B,EAC9B,WAAqC;IAErC,QAAQ,CAAC,QAAQ,CAAC,iCAAiC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,SAA8B,EAC9B,WAAqC;IAErC,OAAO;QACL,aAAa,EAAE,OAAO;QACtB,KAAK,CAAC,cAAc,CAAC,QAAkB;YACrC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,CAAC,MAAM,SAAS,EAAE,CAAC,OAAO,CACrC;;;mCAG2B,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;8BACvC,EACtB,CAAC,GAAG,QAAQ,CAAC,CACd,CAA4D,CAAC;YAC9D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACxB,OAAO,EAAE,GAAG,CAAC,QAAQ;gBACrB,IAAI,EAAE,iBAAiB;gBACvB,QAAQ,EAAE,GAAG,CAAC,EAAE;gBAChB,KAAK,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE;aAC5B,CAAC,CAAC,CAAC;QACN,CAAC;QACD,iBAAiB,EAAE,+BAA+B,CAAC,SAAS,EAAE,WAAW,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,SAA8B,EAC9B,IAA8B;IAE9B,MAAM,qBAAqB,GAAG,KAAK,IAAuB,EAAE;QAC1D,MAAM,IAAI,GAAG,CAAC,MAAM,SAAS,EAAE,CAAC,OAAO,CACrC,4EAA4E,CAC7E,CAAgC,CAAC;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC,CAAC;IACF,OAAO;QACL,KAAK,CAAC,gBAAgB,CAAC,SAA4B;YACjD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;gBAAE,OAAO,IAAI,GAAG,EAAE,CAAC;YACnD,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC;QACD,KAAK,CAAC,4BAA4B;YAChC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;gBAAE,OAAO,qBAAqB,EAAE,CAAC;YACjE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACvD,IAAI,OAAO,KAAK,IAAI;gBAAE,OAAO,EAAE,CAAC;YAChC,2EAA2E;YAC3E,MAAM,IAAI,GAAG,CAAC,MAAM,SAAS,EAAE,CAAC,OAAO,CACrC;;;mBAGW,OAAO,CAAC,GAAG,eAAe,EACrC,OAAO,CAAC,MAAM,CACf,CAAgC,CAAC;YAClC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC;QACD,qBAAqB;KACtB,CAAC;AACJ,CAAC"}
@@ -0,0 +1,18 @@
1
+ import type { AuditReferenceRegistryPort } from '@endora-commerce/contracts';
2
+ import type { TaskService } from './task-service.js';
3
+ /**
4
+ * What a `task` audit row is called, and where the Admin UI shows it.
5
+ *
6
+ * Every Command of this module is recorded against `task` and the Task's id,
7
+ * so the dashboard's recent activity names a Task by its number and title and
8
+ * links to its screen through this one resolver. It reads through the
9
+ * visibility seam, under the reader's own context: a Task whose context the
10
+ * reader may not see gets no label — the audit row falls back to its snapshot
11
+ * and renders no link.
12
+ *
13
+ * `tasks` is operator-switchable and `audit_logs` is not; the registry skips a
14
+ * contributor that is not effectively present, which is why this is a push
15
+ * from a contribution-only boot hook and not a port `audit_logs` resolves.
16
+ */
17
+ export declare function registerTaskAuditReferences(registry: AuditReferenceRegistryPort, tasks: () => Pick<TaskService, 'visibleRowsByIds'>): void;
18
+ //# sourceMappingURL=task-audit-references.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-audit-references.d.ts","sourceRoot":"","sources":["../../../src/backend/services/task-audit-references.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,0BAA0B,EACpC,KAAK,EAAE,MAAM,IAAI,CAAC,WAAW,EAAE,kBAAkB,CAAC,GACjD,IAAI,CAWN"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * What a `task` audit row is called, and where the Admin UI shows it.
3
+ *
4
+ * Every Command of this module is recorded against `task` and the Task's id,
5
+ * so the dashboard's recent activity names a Task by its number and title and
6
+ * links to its screen through this one resolver. It reads through the
7
+ * visibility seam, under the reader's own context: a Task whose context the
8
+ * reader may not see gets no label — the audit row falls back to its snapshot
9
+ * and renders no link.
10
+ *
11
+ * `tasks` is operator-switchable and `audit_logs` is not; the registry skips a
12
+ * contributor that is not effectively present, which is why this is a push
13
+ * from a contribution-only boot hook and not a port `audit_logs` resolves.
14
+ */
15
+ export function registerTaskAuditReferences(registry, tasks) {
16
+ registry.register({
17
+ ownerModuleId: 'tasks',
18
+ referenceType: 'task',
19
+ resolve: async (ids) => (await tasks().visibleRowsByIds(ids)).map((row) => ({
20
+ id: row.id,
21
+ label: `${row.number} ${row.title}`,
22
+ url: `/tasks/${row.id}`,
23
+ })),
24
+ });
25
+ }
26
+ //# sourceMappingURL=task-audit-references.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-audit-references.js","sourceRoot":"","sources":["../../../src/backend/services/task-audit-references.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,2BAA2B,CACzC,QAAoC,EACpC,KAAkD;IAElD,QAAQ,CAAC,QAAQ,CAAC;QAChB,aAAa,EAAE,OAAO;QACtB,aAAa,EAAE,MAAM;QACrB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CACrB,CAAC,MAAM,KAAK,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAClD,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE;YACnC,GAAG,EAAE,UAAU,GAAG,CAAC,EAAE,EAAE;SACxB,CAAC,CAAC;KACN,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,78 @@
1
+ import { type AdminUserReadPort, type PermissionReadPort, type TaskContext } from '@endora-commerce/contracts';
2
+ import type { TaskContextRegistry } from './task-context-registry.js';
3
+ /**
4
+ * The checks a Task write makes before its first Command runs, shared by the
5
+ * HTTP service and the write port so both refuse alike.
6
+ */
7
+ /** Every named assignee is an active administrator, or the whole write is refused. */
8
+ export declare function assertAssignable(adminUsers: AdminUserReadPort, adminUserIds: ReadonlyArray<string | null | undefined>): Promise<void>;
9
+ /**
10
+ * What the Tasks screens assign (`specs/165-task-management/` FR-001,
11
+ * `contracts/admin-api.md` §1): every named assignee is an active
12
+ * administrator **who holds `tasks:read`** — somebody who could not open the
13
+ * Task is not given it — or the whole write is 422 `TASK_ASSIGNEE_INVALID`.
14
+ * For a Task in a context, {@link assertAssigneesSeeContext} follows.
15
+ *
16
+ * The write port keeps {@link assertAssignable} alone: a context's owner
17
+ * assigns the people its own rules name (163 behaviour), and they are told only
18
+ * when they may see the Task. A Project's Stage Tasks go to the Member holding
19
+ * each definition's Role, who need not hold `tasks:read` or `projects:read`;
20
+ * refusing one of them would refuse the whole batch, and entering the Stage
21
+ * would record `tasks_materialize_failed` for a Task nobody else would get
22
+ * (issue #506, owner ruling 2026-10-29: the HTTP routes only).
23
+ */
24
+ export declare function assertMayBeAssigned(adminUsers: AdminUserReadPort, permissions: PermissionReadPort, adminUserIds: readonly string[]): Promise<void>;
25
+ /**
26
+ * Every named assignee of a Task in a context may see that record — its
27
+ * owner's `canSeeAs` answers yes — or the write is 422 `TASK_ASSIGNEE_INVALID`
28
+ * naming the first who may not (spec, Edge Cases; issue #506, option A). A
29
+ * Task in no context asks nothing. An owner that is not present vouches for
30
+ * nobody, though a Task of one is hidden before this is reached. The HTTP
31
+ * routes only: see {@link assertMayBeAssigned} for why the write port does not.
32
+ */
33
+ export declare function assertAssigneesSeeContext(contexts: Pick<TaskContextRegistry, 'presentFor'>, adminUsers: AdminUserReadPort, context: {
34
+ contextType: string | null;
35
+ contextId: string | null;
36
+ } | null, adminUserIds: readonly string[]): Promise<void>;
37
+ /**
38
+ * A context an administrator puts a Task into on the Tasks screens (FR-031):
39
+ * its type registered by a **present** module, the record one the caller may
40
+ * see, and — when the record has groups (a Project's Stages) — one of those
41
+ * groups named. A Task belongs to a group of such a record, never to the
42
+ * record alone. Asked under the caller's own context.
43
+ */
44
+ export declare function assertContextForCaller(contexts: TaskContextRegistry, context: TaskContext): Promise<void>;
45
+ /**
46
+ * Taking a Task out of the context it is in — detaching it, or moving it to
47
+ * another record — is the context owner's to allow (`canChangeTasks`), not only
48
+ * `tasks:write`'s: otherwise a holder who merely sees a record could publish
49
+ * its Tasks to every holder of `tasks:read` (T144). Moving between the groups
50
+ * of one record is not asked. An owner that is off hides the Task before this
51
+ * is reached; one that is unregistered refuses.
52
+ */
53
+ export declare function assertMayTakeOut(contexts: TaskContextRegistry, current: {
54
+ contextType: string | null;
55
+ contextId: string | null;
56
+ }, next: TaskContext | null): Promise<void>;
57
+ /**
58
+ * Putting a Task into a record — creating it there, or moving it there from
59
+ * elsewhere — is the record owner's to allow too (`canChangeTasks`, T147):
60
+ * `tasks:write` and sight of the record are not enough to add to its work.
61
+ * Moving between the groups of one record is not asked. Asked after
62
+ * {@link assertContextForCaller}, which names a record the caller does not see.
63
+ */
64
+ export declare function assertMayPutIn(contexts: TaskContextRegistry, current: {
65
+ contextType: string | null;
66
+ contextId: string | null;
67
+ } | null, next: TaskContext): Promise<void>;
68
+ /**
69
+ * Deleting a Task of a record is the record owner's to allow (`canChangeTasks`,
70
+ * T147). The caller sees the Task — a 404 would misreport it — so the refusal
71
+ * is `403` `FORBIDDEN`, the answer to a permission the caller lacks. A Task of
72
+ * no record is `tasks:write`'s alone.
73
+ */
74
+ export declare function assertMayDelete(contexts: TaskContextRegistry, current: {
75
+ contextType: string | null;
76
+ contextId: string | null;
77
+ }): Promise<void>;
78
+ //# sourceMappingURL=task-checks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-checks.d.ts","sourceRoot":"","sources":["../../../src/backend/services/task-checks.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EACjB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE;;;GAGG;AAEH,sFAAsF;AACtF,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,iBAAiB,EAC7B,YAAY,EAAE,aAAa,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GACrD,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,iBAAiB,EAC7B,WAAW,EAAE,kBAAkB,EAC/B,YAAY,EAAE,SAAS,MAAM,EAAE,GAC9B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,IAAI,CAAC,mBAAmB,EAAE,YAAY,CAAC,EACjD,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,EACxE,YAAY,EAAE,SAAS,MAAM,EAAE,GAC9B,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB/G;AAgBD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACjE,IAAI,EAAE,WAAW,GAAG,IAAI,GACvB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,EACxE,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE;IAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAChE,OAAO,CAAC,IAAI,CAAC,CAKf"}