@endora-commerce/mod-tasks 0.0.0-stage → 0.109.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 +75 -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 +184 -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 +209 -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 +184 -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 +168 -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 +567 -0
  541. package/i18n/pl.json +567 -0
  542. package/package.json +102 -3
  543. package/tailwind.css +14 -0
@@ -0,0 +1,113 @@
1
+ import { ADMIN_PERMISSION_WILDCARD, foldDiacritics, mentionedAdminUserIds, } from '@endora-commerce/contracts';
2
+ import { actingAdminUserId } from './task-access.js';
3
+ import { tellAfterCommit } from './task-notifier.js';
4
+ /** How many people the mention list offers for one search (admin-api §3). */
5
+ export const MENTIONABLE_LIMIT = 20;
6
+ const TASKS_READ_PERMISSION = 'tasks:read';
7
+ /**
8
+ * The people `next` mentions and `previous` did not — who a save tells. Pure,
9
+ * so the Command that saves a text works it out from the text it replaces
10
+ * (Projects' `newlyMentioned`, copied — the platform surface is narrow).
11
+ */
12
+ export function newlyMentioned(previous, next) {
13
+ const before = new Set(mentionedAdminUserIds(previous));
14
+ return [...new Set(mentionedAdminUserIds(next))].filter((id) => !before.has(id));
15
+ }
16
+ function personName(person) {
17
+ return `${person.firstName} ${person.lastName}`.trim() || person.email;
18
+ }
19
+ function isActive(person) {
20
+ return person.status === 'active' && person.deletedAt === null;
21
+ }
22
+ /**
23
+ * Whether **another** administrator may see a Task — who may be assigned,
24
+ * mentioned or told about it (`specs/165-task-management/` R-3, R-5; 163
25
+ * F-14). They must hold `tasks:read`; a draft is its Creator's alone; a private
26
+ * Task is its Creator's alone here (nobody is mentioned in one, research R-5);
27
+ * a Task in a context needs the context's owner to say yes (`canSeeAs`), and an
28
+ * owner that is not present vouches for nobody.
29
+ */
30
+ export function createTaskAudience(deps) {
31
+ return async function maySee(adminUserId, task) {
32
+ if ((task.is_draft || task.is_private) && adminUserId !== task.created_by_admin_user_id)
33
+ return false;
34
+ const held = await deps.permissions.listPermissions(adminUserId);
35
+ if (!held.includes(ADMIN_PERMISSION_WILDCARD) && !held.includes(TASKS_READ_PERMISSION))
36
+ return false;
37
+ if (task.context_type === null || task.context_id === null)
38
+ return true;
39
+ const descriptor = deps.contexts.presentFor(task.context_type);
40
+ return descriptor !== null && (await descriptor.canSeeAs(adminUserId, task.context_id));
41
+ };
42
+ }
43
+ /**
44
+ * People mentioned in a Task's description (and, from User Story 4, its
45
+ * comments) — `specs/165-task-management/` FR-006, research R-5; Projects'
46
+ * `mention-service.ts`, the model.
47
+ *
48
+ * **Who may be mentioned** is somebody who may see the Task: an active
49
+ * administrator holding `tasks:read` who passes {@link createTaskAudience}. On
50
+ * the create form, before there is a Task, the holders of `tasks:read`.
51
+ *
52
+ * **Who is told** is decided again when the text is saved, because the token
53
+ * is text and can be typed by hand: the same question, and never the author.
54
+ * The bell entry names the Task by number, never the text. Told after the
55
+ * commit, under `tellAfterCommit`.
56
+ */
57
+ export class TaskMentionService {
58
+ deps;
59
+ constructor(deps) {
60
+ this.deps = deps;
61
+ }
62
+ /** `GET /tasks/lookups/mentionable?taskId=&q=` — at most {@link MENTIONABLE_LIMIT}, by name. */
63
+ async mentionable(query) {
64
+ // The Task first: one the caller may not see is 404 as one that does not exist.
65
+ const task = query.taskId !== undefined ? await this.deps.access.loadVisible(query.taskId) : null;
66
+ const needle = foldDiacritics(query.q ?? '')
67
+ .trim()
68
+ .toLowerCase();
69
+ const candidates = (await this.deps.adminUsers.listAll({ activeOnly: true }))
70
+ .filter(isActive)
71
+ .map((admin) => ({ admin, name: personName(admin) }))
72
+ .filter(({ admin, name }) => needle === '' || [name, admin.email].some((value) => foldDiacritics(value).toLowerCase().includes(needle)))
73
+ .sort((a, b) => a.name.localeCompare(b.name) || a.admin.id.localeCompare(b.admin.id));
74
+ const options = [];
75
+ // In name order, stopping at the limit: the questions below are asked of
76
+ // as many people as the list shows, not of every administrator.
77
+ for (const { admin, name } of candidates) {
78
+ if (options.length >= MENTIONABLE_LIMIT)
79
+ break;
80
+ const allowed = task !== null ? await this.deps.audience(admin.id, task) : await this.#readsTasks(admin.id);
81
+ if (allowed)
82
+ options.push({ id: admin.id, name, email: admin.email });
83
+ }
84
+ return options;
85
+ }
86
+ /**
87
+ * Tell the newly mentioned who may see the Task, after the save committed;
88
+ * answers who was addressed. Never the author; a draft tells nobody (it is
89
+ * its Creator's alone until published).
90
+ */
91
+ async tell(task, mentioned) {
92
+ const author = actingAdminUserId();
93
+ const ids = [...new Set(mentioned)].filter((id) => id !== author);
94
+ if (ids.length === 0)
95
+ return [];
96
+ const people = (await this.deps.adminUsers.findByIds(ids)).filter(isActive);
97
+ const addressed = [];
98
+ for (const person of people) {
99
+ await tellAfterCommit(task.id, async () => {
100
+ if (!(await this.deps.audience(person.id, task)))
101
+ return;
102
+ await this.deps.notifier.mentioned({ targetAdminUserId: person.id, taskId: task.id, number: task.number });
103
+ addressed.push(person.id);
104
+ });
105
+ }
106
+ return addressed;
107
+ }
108
+ async #readsTasks(adminUserId) {
109
+ const held = await this.deps.permissions.listPermissions(adminUserId);
110
+ return held.includes(ADMIN_PERMISSION_WILDCARD) || held.includes(TASKS_READ_PERMISSION);
111
+ }
112
+ }
113
+ //# sourceMappingURL=mention-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mention-service.js","sourceRoot":"","sources":["../../../src/backend/services/mention-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ import { type PermissionReadPort } from '@endora-commerce/contracts';
2
+ /**
3
+ * What a referenced or linked record shows is its owner's data, and
4
+ * `tasks:read` is not a permission to read it (`specs/165-task-management/`
5
+ * research R-5, R-16 — a copy of Projects' `owner-read-permissions.ts`, not an
6
+ * import: the platform surface is deliberately narrow and the shape is a few
7
+ * lines).
8
+ *
9
+ * An Order is named only to a caller who also holds `orders:read`, a Product
10
+ * to one holding `catalog:read`, a Quote Request to one holding `rfqs:handle`
11
+ * (that module's one code, which gates its reads too), an Opportunity to one
12
+ * holding `crm:read` and a Project to one holding `projects:read`. Anybody else
13
+ * sees that a record is referenced, and no more. The system actor — a worker —
14
+ * is nobody's session and is not narrowed; any other caller without an
15
+ * administrator behind it is answered no.
16
+ *
17
+ * **Asked by a service, after the owner's presence is decided** — never as a
18
+ * `requireAdmin` on a route for a switchable owner: while that module is off
19
+ * its code cannot be granted to anybody, and a route gate naming it would
20
+ * answer 403 where the contract says 503 (D-173).
21
+ */
22
+ export declare const ORDERS_READ_PERMISSION = "orders:read";
23
+ export declare const CATALOG_READ_PERMISSION = "catalog:read";
24
+ export declare const QUOTE_REQUESTS_READ_PERMISSION = "rfqs:handle";
25
+ export declare const CRM_READ_PERMISSION = "crm:read";
26
+ export declare const PROJECTS_READ_PERMISSION = "projects:read";
27
+ /**
28
+ * This module's own read code. `TaskVisibility` leaves it to the routes, so a
29
+ * question asked behind another module's gate — which Tasks the asset library
30
+ * may show a file of (`specs/166-asset-reference-visibility/` FR-002) — asks it
31
+ * here: a reader without it sees no Task.
32
+ */
33
+ export declare const TASKS_READ_PERMISSION = "tasks:read";
34
+ /** Whether whoever is behind the request may read what one other module owns. */
35
+ export type OwnerReadCheck = () => Promise<boolean>;
36
+ /** The checks a service that renders another module's data is handed. */
37
+ export interface OwnerReadChecks {
38
+ orders: OwnerReadCheck;
39
+ products: OwnerReadCheck;
40
+ quoteRequests: OwnerReadCheck;
41
+ opportunities: OwnerReadCheck;
42
+ projects: OwnerReadCheck;
43
+ }
44
+ /**
45
+ * One check. A function rather than a literal at the composition site:
46
+ * `check:port-catches` follows the port through the value.
47
+ */
48
+ export declare function createOwnerReadCheck(permissions: PermissionReadPort, permission: string): OwnerReadCheck;
49
+ export declare function createOwnerReadChecks(permissions: PermissionReadPort): OwnerReadChecks;
50
+ //# sourceMappingURL=owner-read-permissions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"owner-read-permissions.d.ts","sourceRoot":"","sources":["../../../src/backend/services/owner-read-permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAIhG;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AACpD,eAAO,MAAM,uBAAuB,iBAAiB,CAAC;AACtD,eAAO,MAAM,8BAA8B,gBAAgB,CAAC;AAC5D,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAC9C,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AACxD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD,iFAAiF;AACjF,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpD,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,aAAa,EAAE,cAAc,CAAC;IAC9B,aAAa,EAAE,cAAc,CAAC;IAC9B,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,CAOxG;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,kBAAkB,GAAG,eAAe,CAQtF"}
@@ -0,0 +1,58 @@
1
+ import { ADMIN_PERMISSION_WILDCARD } from '@endora-commerce/contracts';
2
+ import { actingAdminUserId } from './task-access.js';
3
+ import { isSystemActor } from './task-visibility.js';
4
+ /**
5
+ * What a referenced or linked record shows is its owner's data, and
6
+ * `tasks:read` is not a permission to read it (`specs/165-task-management/`
7
+ * research R-5, R-16 — a copy of Projects' `owner-read-permissions.ts`, not an
8
+ * import: the platform surface is deliberately narrow and the shape is a few
9
+ * lines).
10
+ *
11
+ * An Order is named only to a caller who also holds `orders:read`, a Product
12
+ * to one holding `catalog:read`, a Quote Request to one holding `rfqs:handle`
13
+ * (that module's one code, which gates its reads too), an Opportunity to one
14
+ * holding `crm:read` and a Project to one holding `projects:read`. Anybody else
15
+ * sees that a record is referenced, and no more. The system actor — a worker —
16
+ * is nobody's session and is not narrowed; any other caller without an
17
+ * administrator behind it is answered no.
18
+ *
19
+ * **Asked by a service, after the owner's presence is decided** — never as a
20
+ * `requireAdmin` on a route for a switchable owner: while that module is off
21
+ * its code cannot be granted to anybody, and a route gate naming it would
22
+ * answer 403 where the contract says 503 (D-173).
23
+ */
24
+ export const ORDERS_READ_PERMISSION = 'orders:read';
25
+ export const CATALOG_READ_PERMISSION = 'catalog:read';
26
+ export const QUOTE_REQUESTS_READ_PERMISSION = 'rfqs:handle';
27
+ export const CRM_READ_PERMISSION = 'crm:read';
28
+ export const PROJECTS_READ_PERMISSION = 'projects:read';
29
+ /**
30
+ * This module's own read code. `TaskVisibility` leaves it to the routes, so a
31
+ * question asked behind another module's gate — which Tasks the asset library
32
+ * may show a file of (`specs/166-asset-reference-visibility/` FR-002) — asks it
33
+ * here: a reader without it sees no Task.
34
+ */
35
+ export const TASKS_READ_PERMISSION = 'tasks:read';
36
+ /**
37
+ * One check. A function rather than a literal at the composition site:
38
+ * `check:port-catches` follows the port through the value.
39
+ */
40
+ export function createOwnerReadCheck(permissions, permission) {
41
+ return async () => {
42
+ const adminUserId = actingAdminUserId();
43
+ if (adminUserId === null)
44
+ return isSystemActor();
45
+ const held = await permissions.listPermissions(adminUserId);
46
+ return held.includes(ADMIN_PERMISSION_WILDCARD) || held.includes(permission);
47
+ };
48
+ }
49
+ export function createOwnerReadChecks(permissions) {
50
+ return {
51
+ orders: createOwnerReadCheck(permissions, ORDERS_READ_PERMISSION),
52
+ products: createOwnerReadCheck(permissions, CATALOG_READ_PERMISSION),
53
+ quoteRequests: createOwnerReadCheck(permissions, QUOTE_REQUESTS_READ_PERMISSION),
54
+ opportunities: createOwnerReadCheck(permissions, CRM_READ_PERMISSION),
55
+ projects: createOwnerReadCheck(permissions, PROJECTS_READ_PERMISSION),
56
+ };
57
+ }
58
+ //# sourceMappingURL=owner-read-permissions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"owner-read-permissions.js","sourceRoot":"","sources":["../../../src/backend/services/owner-read-permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAA2B,MAAM,4BAA4B,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AACpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAC;AACtD,MAAM,CAAC,MAAM,8BAA8B,GAAG,aAAa,CAAC;AAC5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;AAC9C,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AACxD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAclD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAA+B,EAAE,UAAkB;IACtF,OAAO,KAAK,IAAI,EAAE;QAChB,MAAM,WAAW,GAAG,iBAAiB,EAAE,CAAC;QACxC,IAAI,WAAW,KAAK,IAAI;YAAE,OAAO,aAAa,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC/E,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,WAA+B;IACnE,OAAO;QACL,MAAM,EAAE,oBAAoB,CAAC,WAAW,EAAE,sBAAsB,CAAC;QACjE,QAAQ,EAAE,oBAAoB,CAAC,WAAW,EAAE,uBAAuB,CAAC;QACpE,aAAa,EAAE,oBAAoB,CAAC,WAAW,EAAE,8BAA8B,CAAC;QAChF,aAAa,EAAE,oBAAoB,CAAC,WAAW,EAAE,mBAAmB,CAAC;QACrE,QAAQ,EAAE,oBAAoB,CAAC,WAAW,EAAE,wBAAwB,CAAC;KACtE,CAAC;AACJ,CAAC"}
@@ -0,0 +1,76 @@
1
+ import type { EntityManager } from '@mikro-orm/postgresql';
2
+ import { type CreateTaskPriorityBody, type TaskPriorityConfig, type UpdateTaskPriorityBody } from '@endora-commerce/contracts';
3
+ import type { CommandBus } from '@endora-commerce/platform/commands';
4
+ import { HttpError } from '@endora-commerce/platform/http';
5
+ import type { AuditPort } from '@endora-commerce/platform/kernel';
6
+ import type { TaskVisibility } from './task-visibility.js';
7
+ import type { TaskWorkflowRead } from './task-workflow-read.js';
8
+ export interface TaskPriorityServiceDeps {
9
+ emFactory: () => EntityManager;
10
+ workflow: Pick<TaskWorkflowRead, 'priorities'>;
11
+ visibility: Pick<TaskVisibility, 'condition'>;
12
+ commandBus: CommandBus;
13
+ /** The kernel's audit port: one `tasks.task.priority_change` row per Task a removal moves. */
14
+ auditLog: AuditPort;
15
+ }
16
+ /**
17
+ * The refusals of a priority write, under the workflow's code and its `rule`
18
+ * detail — the priority list is "the same shape as statuses"
19
+ * (`contracts/admin-api.md` §4):
20
+ * - `priority_code_taken` — a priority with that code exists;
21
+ * - `priority_replacement_required` — Tasks hold the priority being removed,
22
+ * and neither another priority nor `none` was named for them (FR-024).
23
+ */
24
+ export type TaskPriorityConfigRule = 'priority_code_taken' | 'priority_replacement_required';
25
+ /** The `replacement` that clears the priority of the Tasks holding a removed one. */
26
+ export declare const NO_PRIORITY = "none";
27
+ /**
28
+ * The unknown priority code travels as `details.priorityCode`, never as
29
+ * `details.code`: the envelope reads `details.code` as a refusal token that
30
+ * picks the sentence, and an operator-configured code is not one (issue #569).
31
+ */
32
+ export declare function priorityUnknown(code: string): HttpError;
33
+ /**
34
+ * The operator's priority list (`specs/165-task-management/` FR-009, FR-024,
35
+ * research R-9; `contracts/admin-api.md` §4) — read from User Story 1 on,
36
+ * configured from User Story 9 on.
37
+ *
38
+ * A Task holds a priority by its code. **The in-use count the list shows** is
39
+ * the number of Tasks the caller may see holding it — the count composes the
40
+ * visibility pre-filter, so a count says nothing of a Task the caller may not
41
+ * see.
42
+ *
43
+ * **Every write is one Command** against `task_priority` and the code
44
+ * (Constitution XIII). **Removing a priority in use moves its Tasks** to the
45
+ * replacement the operator names, or clears it (`none`) — every Task holding
46
+ * it, platform-wide, whoever may see it (drafts and private Tasks included):
47
+ * the priority is configuration, and that is not a write on any one Task, so
48
+ * no Task's own guards are asked. Each move is a `tasks.task.priority_change`
49
+ * row in that Task's history with `reason: 'priority_removed'`, on the
50
+ * removal's transaction ({@link holdTasksFor}, shared with the status
51
+ * removal). At most {@link TASK_STATUS_REASSIGN_MAX} Tasks move in one
52
+ * removal.
53
+ */
54
+ export declare class TaskPriorityService {
55
+ #private;
56
+ private readonly deps;
57
+ constructor(deps: TaskPriorityServiceDeps);
58
+ /** `GET /tasks/priorities` — by weight, most urgent first. */
59
+ list(): Promise<TaskPriorityConfig[]>;
60
+ /** `POST /tasks/priorities` — answers the list as it stands afterwards. */
61
+ create(input: CreateTaskPriorityBody): Promise<TaskPriorityConfig[]>;
62
+ /** `PATCH /tasks/priorities/:code` — names, colour, position. The code is immutable. */
63
+ update(code: string, patch: UpdateTaskPriorityBody): Promise<TaskPriorityConfig[]>;
64
+ /**
65
+ * `DELETE /tasks/priorities/:code?replacement=` (FR-024). While Tasks hold
66
+ * the priority, `replacement` names the one they get, or `none` — else 422
67
+ * `TASK_WORKFLOW_INVALID {rule: 'priority_replacement_required'}`; an unknown
68
+ * replacement is 422 `TASK_PRIORITY_UNKNOWN`. Above
69
+ * {@link TASK_STATUS_REASSIGN_MAX} Tasks, 409 `TASK_STATUS_IN_USE_TOO_MANY`
70
+ * and nothing moves.
71
+ */
72
+ delete(code: string, replacement: string | undefined): Promise<TaskPriorityConfig[]>;
73
+ /** A code the list holds — else 422 `TASK_PRIORITY_UNKNOWN`. `null` (no priority) always passes. */
74
+ assertKnown(code: string | null): Promise<void>;
75
+ }
76
+ //# sourceMappingURL=priority-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"priority-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/priority-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAGlE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;IAC/C,UAAU,EAAE,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IAC9C,UAAU,EAAE,UAAU,CAAC;IACvB,8FAA8F;IAC9F,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,sBAAsB,GAAG,qBAAqB,GAAG,+BAA+B,CAAC;AAoB7F,qFAAqF;AACrF,eAAO,MAAM,WAAW,SAAS,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAIvD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,mBAAmB;;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,uBAAuB;IAE1D,8DAA8D;IACxD,IAAI,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAY3C,2EAA2E;IACrE,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAuB1E,wFAAwF;IAClF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAoBxF;;;;;;;OAOG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA8C1F,oGAAoG;IAC9F,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAuBtD"}
@@ -0,0 +1,188 @@
1
+ import { LockMode } from '@mikro-orm/core';
2
+ import { ERROR_CODES, TASK_STATUS_REASSIGN_MAX, } from '@endora-commerce/contracts';
3
+ import { HttpError } from '@endora-commerce/platform/http';
4
+ import { TaskPriority } from '../entities/task-priority.entity.js';
5
+ import { heldIds, holdTasksFor, recordReassignments } from './task-reassignment.js';
6
+ function priorityInvalid(rule, message) {
7
+ return new HttpError(422, ERROR_CODES.TASK_WORKFLOW_INVALID, message, { rule, code: rule });
8
+ }
9
+ function priorityNotFound(code) {
10
+ return new HttpError(404, ERROR_CODES.NOT_FOUND, `Task priority "${code}" not found.`, { priorityCode: code });
11
+ }
12
+ function snapshot(priority) {
13
+ return {
14
+ code: priority.code,
15
+ name: priority.name,
16
+ defaultName: priority.defaultName,
17
+ weight: priority.weight,
18
+ color: priority.color,
19
+ };
20
+ }
21
+ /** The `replacement` that clears the priority of the Tasks holding a removed one. */
22
+ export const NO_PRIORITY = 'none';
23
+ /**
24
+ * The unknown priority code travels as `details.priorityCode`, never as
25
+ * `details.code`: the envelope reads `details.code` as a refusal token that
26
+ * picks the sentence, and an operator-configured code is not one (issue #569).
27
+ */
28
+ export function priorityUnknown(code) {
29
+ return new HttpError(422, ERROR_CODES.TASK_PRIORITY_UNKNOWN, `"${code}" is not a configured priority.`, {
30
+ priorityCode: code,
31
+ });
32
+ }
33
+ /**
34
+ * The operator's priority list (`specs/165-task-management/` FR-009, FR-024,
35
+ * research R-9; `contracts/admin-api.md` §4) — read from User Story 1 on,
36
+ * configured from User Story 9 on.
37
+ *
38
+ * A Task holds a priority by its code. **The in-use count the list shows** is
39
+ * the number of Tasks the caller may see holding it — the count composes the
40
+ * visibility pre-filter, so a count says nothing of a Task the caller may not
41
+ * see.
42
+ *
43
+ * **Every write is one Command** against `task_priority` and the code
44
+ * (Constitution XIII). **Removing a priority in use moves its Tasks** to the
45
+ * replacement the operator names, or clears it (`none`) — every Task holding
46
+ * it, platform-wide, whoever may see it (drafts and private Tasks included):
47
+ * the priority is configuration, and that is not a write on any one Task, so
48
+ * no Task's own guards are asked. Each move is a `tasks.task.priority_change`
49
+ * row in that Task's history with `reason: 'priority_removed'`, on the
50
+ * removal's transaction ({@link holdTasksFor}, shared with the status
51
+ * removal). At most {@link TASK_STATUS_REASSIGN_MAX} Tasks move in one
52
+ * removal.
53
+ */
54
+ export class TaskPriorityService {
55
+ deps;
56
+ constructor(deps) {
57
+ this.deps = deps;
58
+ }
59
+ /** `GET /tasks/priorities` — by weight, most urgent first. */
60
+ async list() {
61
+ const [priorities, inUse] = await Promise.all([this.deps.workflow.priorities(), this.#inUse()]);
62
+ return priorities.map((priority) => ({
63
+ code: priority.code,
64
+ name: priority.name,
65
+ defaultName: priority.defaultName,
66
+ color: priority.color,
67
+ weight: priority.weight,
68
+ inUseCount: inUse.get(priority.code) ?? 0,
69
+ }));
70
+ }
71
+ /** `POST /tasks/priorities` — answers the list as it stands afterwards. */
72
+ async create(input) {
73
+ await this.deps.commandBus.run({
74
+ action: 'tasks.priority.create',
75
+ objectType: 'task_priority',
76
+ objectId: input.code,
77
+ run: async ({ em: commandEm }) => {
78
+ const em = commandEm;
79
+ if (await em.findOne(TaskPriority, { code: input.code })) {
80
+ throw priorityInvalid('priority_code_taken', `A priority with the code "${input.code}" already exists.`);
81
+ }
82
+ const priority = em.create(TaskPriority, {
83
+ code: input.code,
84
+ name: { ...input.name },
85
+ defaultName: input.name.en,
86
+ color: input.color,
87
+ weight: input.weight,
88
+ });
89
+ return { result: undefined, before: null, after: snapshot(priority) };
90
+ },
91
+ });
92
+ return this.list();
93
+ }
94
+ /** `PATCH /tasks/priorities/:code` — names, colour, position. The code is immutable. */
95
+ async update(code, patch) {
96
+ await this.deps.commandBus.run({
97
+ action: 'tasks.priority.update',
98
+ objectType: 'task_priority',
99
+ objectId: code,
100
+ run: async ({ em: commandEm }) => {
101
+ const priority = await this.#locked(commandEm, code);
102
+ const before = snapshot(priority);
103
+ if (patch.name !== undefined) {
104
+ priority.name = { ...patch.name };
105
+ priority.defaultName = patch.name.en;
106
+ }
107
+ if (patch.color !== undefined)
108
+ priority.color = patch.color;
109
+ if (patch.weight !== undefined)
110
+ priority.weight = patch.weight;
111
+ return { result: undefined, before, after: snapshot(priority) };
112
+ },
113
+ });
114
+ return this.list();
115
+ }
116
+ /**
117
+ * `DELETE /tasks/priorities/:code?replacement=` (FR-024). While Tasks hold
118
+ * the priority, `replacement` names the one they get, or `none` — else 422
119
+ * `TASK_WORKFLOW_INVALID {rule: 'priority_replacement_required'}`; an unknown
120
+ * replacement is 422 `TASK_PRIORITY_UNKNOWN`. Above
121
+ * {@link TASK_STATUS_REASSIGN_MAX} Tasks, 409 `TASK_STATUS_IN_USE_TOO_MANY`
122
+ * and nothing moves.
123
+ */
124
+ async delete(code, replacement) {
125
+ await this.deps.commandBus.run({
126
+ action: 'tasks.priority.delete',
127
+ objectType: 'task_priority',
128
+ objectId: code,
129
+ run: async ({ em: commandEm }) => {
130
+ const em = commandEm;
131
+ const priority = await this.#locked(em, code);
132
+ const held = await holdTasksFor(em, 'priority_code', code, {
133
+ message: `More than ${TASK_STATUS_REASSIGN_MAX} Tasks have the priority "${code}". Change some of them first.`,
134
+ // `code` keys the sentence: the status removal's code, said of a priority.
135
+ details: { priorityCode: code, code: 'priority' },
136
+ });
137
+ let moved = 0;
138
+ if (held.length > 0) {
139
+ if (replacement === undefined || replacement === code) {
140
+ throw priorityInvalid('priority_replacement_required', `Tasks have the priority "${code}": name the priority they get, or none.`);
141
+ }
142
+ const target = replacement === NO_PRIORITY ? null : replacement;
143
+ // The replacement is held until this commits: it cannot be removed under the move.
144
+ if (target !== null && !(await em.findOne(TaskPriority, { code: target }, { lockMode: LockMode.PESSIMISTIC_WRITE }))) {
145
+ throw priorityUnknown(target);
146
+ }
147
+ await em.execute(`update "tasks" set "priority_code" = ?, "updated_at" = ? where "id" = any(?::uuid[])`, [
148
+ target,
149
+ new Date(),
150
+ heldIds(held),
151
+ ]);
152
+ recordReassignments(this.deps.auditLog, em, held, 'tasks.task.priority_change', () => ({
153
+ before: { priorityCode: code },
154
+ after: { priorityCode: target, reason: 'priority_removed' },
155
+ }));
156
+ moved = held.length;
157
+ }
158
+ const before = { ...snapshot(priority), ...(moved > 0 ? { replacement, moved } : {}) };
159
+ em.remove(priority);
160
+ return { result: undefined, before, after: null };
161
+ },
162
+ });
163
+ return this.list();
164
+ }
165
+ /** A code the list holds — else 422 `TASK_PRIORITY_UNKNOWN`. `null` (no priority) always passes. */
166
+ async assertKnown(code) {
167
+ if (code === null)
168
+ return;
169
+ const priorities = await this.deps.workflow.priorities();
170
+ if (!priorities.some((priority) => priority.code === code))
171
+ throw priorityUnknown(code);
172
+ }
173
+ /** The priority row, locked for this Command. */
174
+ async #locked(em, code) {
175
+ const priority = await em.findOne(TaskPriority, { code }, { lockMode: LockMode.PESSIMISTIC_WRITE });
176
+ if (!priority)
177
+ throw priorityNotFound(code);
178
+ return priority;
179
+ }
180
+ async #inUse() {
181
+ const visible = await this.deps.visibility.condition('t');
182
+ const rows = (await this.deps.emFactory().execute(`select t."priority_code", count(*)::int as "n" from "tasks" t
183
+ where t."priority_code" is not null ${visible ? `and ${visible.sql}` : ''}
184
+ group by t."priority_code"`, visible?.params ?? []));
185
+ return new Map(rows.map((row) => [row.priority_code, Number(row.n)]));
186
+ }
187
+ }
188
+ //# sourceMappingURL=priority-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"priority-service.js","sourceRoot":"","sources":["../../../src/backend/services/priority-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,73 @@
1
+ import type { EntityManager } from '@mikro-orm/postgresql';
2
+ import { type OrderListPort, type OrderReadPort, type TaskLink, type TaskLinkKind, type TaskLinkTarget, type TaskLookupOption } from '@endora-commerce/contracts';
3
+ import type { CommandBus } from '@endora-commerce/platform/commands';
4
+ import type { OwnerReadChecks } from './owner-read-permissions.js';
5
+ import type { TaskRecordOwners } from './record-owners.js';
6
+ import type { TaskReferenceService } from './reference-service.js';
7
+ import { type TaskAccess } from './task-access.js';
8
+ /** How many records the link picker offers for one search. */
9
+ export declare const RECORD_LOOKUP_LIMIT = 20;
10
+ export interface TaskRecordLinkServiceDeps {
11
+ emFactory: () => EntityManager;
12
+ commandBus: CommandBus;
13
+ access: Pick<TaskAccess, 'loadVisible' | 'assertMayChange'>;
14
+ /** The resolver a reference goes through — a link is named exactly as a reference to its record is. */
15
+ references: Pick<TaskReferenceService, 'resolveTargets'>;
16
+ /** `orders`' read port and list — lazy, resolved per call. `orders` cannot be switched off. */
17
+ orders: Pick<OrderReadPort, 'findByIds'>;
18
+ orderList: OrderListPort;
19
+ /** The one door to Opportunities and Quote Requests — asked `isPresent` first. */
20
+ owners: Pick<TaskRecordOwners, 'isPresent' | 'labels' | 'search'>;
21
+ mayRead: Pick<OwnerReadChecks, 'orders' | 'quoteRequests' | 'opportunities'>;
22
+ }
23
+ /**
24
+ * A Task's links to the Opportunities, Orders and Quote Requests it is about
25
+ * (`specs/165-task-management/` User Story 6, FR-031 – FR-033, research R-16),
26
+ * kept in `task_record_links` by value.
27
+ *
28
+ * - **Validated when made, never after.** The record's owner is present, the
29
+ * caller holds that owner's read code (`crm:read`, `orders:read`,
30
+ * `rfqs:handle`) and the owner's port finds the record — otherwise 422
31
+ * `TASK_LINK_INVALID`, the three alike. Presence is decided before the port
32
+ * is asked; nothing is caught. Removing a link is never validated: a link of
33
+ * a module that is off can be removed.
34
+ * - **No effect on who sees the Task** (owner ruling Q2 = A). A link is a
35
+ * reference: shown to each reader through the same resolver as a reference
36
+ * to the record (`TaskReferenceService.resolveTargets`), *unavailable* to a
37
+ * reader who may not read it, while its owner is off, or once it is gone.
38
+ * - **Idempotent.** Linking a record already linked answers the existing link
39
+ * and records nothing; the same record twice in a create body is one link.
40
+ * - **In the Task's history**: `tasks.task.link` / `tasks.task.unlink`, the
41
+ * record named by kind and id; a create records its links in its own entry.
42
+ *
43
+ * Every read of `task_record_links` here is keyed by a Task id `TaskAccess`
44
+ * handed out; the Tasks of one record are listed by `TaskService` under the
45
+ * visibility pre-filter.
46
+ */
47
+ export declare class TaskRecordLinkService {
48
+ #private;
49
+ private readonly deps;
50
+ constructor(deps: TaskRecordLinkServiceDeps);
51
+ /**
52
+ * The targets of a write, each one the caller may link — distinct, in the
53
+ * order given — or 422 `TASK_LINK_INVALID` for the first that is not.
54
+ */
55
+ assertLinkable(targets: readonly TaskLinkTarget[]): Promise<TaskLinkTarget[]>;
56
+ /** The links of one Task the caller obtained through `TaskAccess`, each resolved for the reader. */
57
+ linksOf(taskId: string): Promise<TaskLink[]>;
58
+ /** `POST /tasks/:id/links` — the link, and whether it is new. */
59
+ link(taskId: string, target: TaskLinkTarget): Promise<{
60
+ link: TaskLink;
61
+ created: boolean;
62
+ }>;
63
+ /** `DELETE /tasks/:id/links/:linkId` — 404 for a link this Task does not have. */
64
+ unlink(taskId: string, linkId: string): Promise<void>;
65
+ /**
66
+ * `GET /tasks/lookups/records?kind=&q=` — what the link picker offers: the
67
+ * records of one kind the caller may read, while the owner is on; nothing
68
+ * otherwise. A Quote Request is offered by its number typed in full (its
69
+ * port publishes no search).
70
+ */
71
+ records(kind: TaskLinkKind, q: string | undefined): Promise<TaskLookupOption[]>;
72
+ }
73
+ //# sourceMappingURL=record-link-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"record-link-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/record-link-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAErE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAwB,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG3D,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAQtC,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,iBAAiB,CAAC,CAAC;IAC5D,uGAAuG;IACvG,UAAU,EAAE,IAAI,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,CAAC;IACzD,+FAA+F;IAC/F,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;IACzC,SAAS,EAAE,aAAa,CAAC;IACzB,kFAAkF;IAClF,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAClE,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,eAAe,GAAG,eAAe,CAAC,CAAC;CAC9E;AAyBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,qBAAqB;;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,yBAAyB;IAE5D;;;OAGG;IACG,cAAc,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAiBnF,oGAAoG;IAC9F,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAuBlD,iEAAiE;IAC3D,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IA4BjG,kFAAkF;IAC5E,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB3D;;;;;OAKG;IACG,OAAO,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAmCtF"}