@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.
- package/LICENSE +21 -0
- package/README.md +61 -2
- package/dist/admin/api.d.ts +121 -0
- package/dist/admin/api.d.ts.map +1 -0
- package/dist/admin/api.js +262 -0
- package/dist/admin/api.js.map +1 -0
- package/dist/admin/components/AssigneePicker.d.ts +36 -0
- package/dist/admin/components/AssigneePicker.d.ts.map +1 -0
- package/dist/admin/components/AssigneePicker.js +64 -0
- package/dist/admin/components/AssigneePicker.js.map +1 -0
- package/dist/admin/components/BoardCardFieldsEditor.d.ts +23 -0
- package/dist/admin/components/BoardCardFieldsEditor.d.ts.map +1 -0
- package/dist/admin/components/BoardCardFieldsEditor.js +138 -0
- package/dist/admin/components/BoardCardFieldsEditor.js.map +1 -0
- package/dist/admin/components/ContextLabel.d.ts +13 -0
- package/dist/admin/components/ContextLabel.d.ts.map +1 -0
- package/dist/admin/components/ContextLabel.js +18 -0
- package/dist/admin/components/ContextLabel.js.map +1 -0
- package/dist/admin/components/ContextSection.d.ts +27 -0
- package/dist/admin/components/ContextSection.d.ts.map +1 -0
- package/dist/admin/components/ContextSection.js +60 -0
- package/dist/admin/components/ContextSection.js.map +1 -0
- package/dist/admin/components/DigestControl.d.ts +15 -0
- package/dist/admin/components/DigestControl.d.ts.map +1 -0
- package/dist/admin/components/DigestControl.js +102 -0
- package/dist/admin/components/DigestControl.js.map +1 -0
- package/dist/admin/components/LinkedRecordsSection.d.ts +25 -0
- package/dist/admin/components/LinkedRecordsSection.d.ts.map +1 -0
- package/dist/admin/components/LinkedRecordsSection.js +93 -0
- package/dist/admin/components/LinkedRecordsSection.js.map +1 -0
- package/dist/admin/components/LookupPicker.d.ts +26 -0
- package/dist/admin/components/LookupPicker.d.ts.map +1 -0
- package/dist/admin/components/LookupPicker.js +42 -0
- package/dist/admin/components/LookupPicker.js.map +1 -0
- package/dist/admin/components/RelatedTasksSection.d.ts +19 -0
- package/dist/admin/components/RelatedTasksSection.d.ts.map +1 -0
- package/dist/admin/components/RelatedTasksSection.js +64 -0
- package/dist/admin/components/RelatedTasksSection.js.map +1 -0
- package/dist/admin/components/RemindersSection.d.ts +22 -0
- package/dist/admin/components/RemindersSection.d.ts.map +1 -0
- package/dist/admin/components/RemindersSection.js +107 -0
- package/dist/admin/components/RemindersSection.js.map +1 -0
- package/dist/admin/components/StatusBadge.d.ts +13 -0
- package/dist/admin/components/StatusBadge.d.ts.map +1 -0
- package/dist/admin/components/StatusBadge.js +12 -0
- package/dist/admin/components/StatusBadge.js.map +1 -0
- package/dist/admin/components/SubtasksSection.d.ts +25 -0
- package/dist/admin/components/SubtasksSection.d.ts.map +1 -0
- package/dist/admin/components/SubtasksSection.js +76 -0
- package/dist/admin/components/SubtasksSection.js.map +1 -0
- package/dist/admin/components/TaskAttachments.d.ts +24 -0
- package/dist/admin/components/TaskAttachments.d.ts.map +1 -0
- package/dist/admin/components/TaskAttachments.js +135 -0
- package/dist/admin/components/TaskAttachments.js.map +1 -0
- package/dist/admin/components/TaskBoard.d.ts +44 -0
- package/dist/admin/components/TaskBoard.d.ts.map +1 -0
- package/dist/admin/components/TaskBoard.js +295 -0
- package/dist/admin/components/TaskBoard.js.map +1 -0
- package/dist/admin/components/TaskCard.d.ts +14 -0
- package/dist/admin/components/TaskCard.d.ts.map +1 -0
- package/dist/admin/components/TaskCard.js +125 -0
- package/dist/admin/components/TaskCard.js.map +1 -0
- package/dist/admin/components/TaskComments.d.ts +18 -0
- package/dist/admin/components/TaskComments.d.ts.map +1 -0
- package/dist/admin/components/TaskComments.js +58 -0
- package/dist/admin/components/TaskComments.js.map +1 -0
- package/dist/admin/components/TaskCustomFields.d.ts +15 -0
- package/dist/admin/components/TaskCustomFields.d.ts.map +1 -0
- package/dist/admin/components/TaskCustomFields.js +66 -0
- package/dist/admin/components/TaskCustomFields.js.map +1 -0
- package/dist/admin/components/TaskFieldInputs.d.ts +47 -0
- package/dist/admin/components/TaskFieldInputs.d.ts.map +1 -0
- package/dist/admin/components/TaskFieldInputs.js +79 -0
- package/dist/admin/components/TaskFieldInputs.js.map +1 -0
- package/dist/admin/components/TaskFilters.d.ts +34 -0
- package/dist/admin/components/TaskFilters.d.ts.map +1 -0
- package/dist/admin/components/TaskFilters.js +100 -0
- package/dist/admin/components/TaskFilters.js.map +1 -0
- package/dist/admin/components/TaskMarkers.d.ts +13 -0
- package/dist/admin/components/TaskMarkers.d.ts.map +1 -0
- package/dist/admin/components/TaskMarkers.js +20 -0
- package/dist/admin/components/TaskMarkers.js.map +1 -0
- package/dist/admin/components/TaskPicker.d.ts +21 -0
- package/dist/admin/components/TaskPicker.d.ts.map +1 -0
- package/dist/admin/components/TaskPicker.js +56 -0
- package/dist/admin/components/TaskPicker.js.map +1 -0
- package/dist/admin/components/ViewModeToggle.d.ts +12 -0
- package/dist/admin/components/ViewModeToggle.d.ts.map +1 -0
- package/dist/admin/components/ViewModeToggle.js +18 -0
- package/dist/admin/components/ViewModeToggle.js.map +1 -0
- package/dist/admin/components/priorities/TaskPriorityDeleteDialog.d.ts +20 -0
- package/dist/admin/components/priorities/TaskPriorityDeleteDialog.d.ts.map +1 -0
- package/dist/admin/components/priorities/TaskPriorityDeleteDialog.js +59 -0
- package/dist/admin/components/priorities/TaskPriorityDeleteDialog.js.map +1 -0
- package/dist/admin/components/priorities/TaskPriorityDialog.d.ts +29 -0
- package/dist/admin/components/priorities/TaskPriorityDialog.d.ts.map +1 -0
- package/dist/admin/components/priorities/TaskPriorityDialog.js +88 -0
- package/dist/admin/components/priorities/TaskPriorityDialog.js.map +1 -0
- package/dist/admin/components/tags/TaskTagDeleteDialog.d.ts +16 -0
- package/dist/admin/components/tags/TaskTagDeleteDialog.d.ts.map +1 -0
- package/dist/admin/components/tags/TaskTagDeleteDialog.js +34 -0
- package/dist/admin/components/tags/TaskTagDeleteDialog.js.map +1 -0
- package/dist/admin/components/tags/TaskTagDialog.d.ts +27 -0
- package/dist/admin/components/tags/TaskTagDialog.d.ts.map +1 -0
- package/dist/admin/components/tags/TaskTagDialog.js +60 -0
- package/dist/admin/components/tags/TaskTagDialog.js.map +1 -0
- package/dist/admin/components/task-columns.d.ts +5 -0
- package/dist/admin/components/task-columns.d.ts.map +1 -0
- package/dist/admin/components/task-columns.js +72 -0
- package/dist/admin/components/task-columns.js.map +1 -0
- package/dist/admin/components/workflow/TaskStatusDeleteDialog.d.ts +21 -0
- package/dist/admin/components/workflow/TaskStatusDeleteDialog.d.ts.map +1 -0
- package/dist/admin/components/workflow/TaskStatusDeleteDialog.js +63 -0
- package/dist/admin/components/workflow/TaskStatusDeleteDialog.js.map +1 -0
- package/dist/admin/components/workflow/TaskStatusDialog.d.ts +32 -0
- package/dist/admin/components/workflow/TaskStatusDialog.d.ts.map +1 -0
- package/dist/admin/components/workflow/TaskStatusDialog.js +102 -0
- package/dist/admin/components/workflow/TaskStatusDialog.js.map +1 -0
- package/dist/admin/components/workflow/TaskStatusesTable.d.ts +20 -0
- package/dist/admin/components/workflow/TaskStatusesTable.d.ts.map +1 -0
- package/dist/admin/components/workflow/TaskStatusesTable.js +25 -0
- package/dist/admin/components/workflow/TaskStatusesTable.js.map +1 -0
- package/dist/admin/index.d.ts +20 -0
- package/dist/admin/index.d.ts.map +1 -0
- package/dist/admin/index.js +121 -0
- package/dist/admin/index.js.map +1 -0
- package/dist/admin/lib/current-admin.d.ts +6 -0
- package/dist/admin/lib/current-admin.d.ts.map +1 -0
- package/dist/admin/lib/current-admin.js +11 -0
- package/dist/admin/lib/current-admin.js.map +1 -0
- package/dist/admin/lib/labels.d.ts +30 -0
- package/dist/admin/lib/labels.d.ts.map +1 -0
- package/dist/admin/lib/labels.js +76 -0
- package/dist/admin/lib/labels.js.map +1 -0
- package/dist/admin/lib/references.d.ts +16 -0
- package/dist/admin/lib/references.d.ts.map +1 -0
- package/dist/admin/lib/references.js +53 -0
- package/dist/admin/lib/references.js.map +1 -0
- package/dist/admin/lib/settings-paths.d.ts +10 -0
- package/dist/admin/lib/settings-paths.d.ts.map +1 -0
- package/dist/admin/lib/settings-paths.js +10 -0
- package/dist/admin/lib/settings-paths.js.map +1 -0
- package/dist/admin/lib/task-filters.d.ts +69 -0
- package/dist/admin/lib/task-filters.d.ts.map +1 -0
- package/dist/admin/lib/task-filters.js +180 -0
- package/dist/admin/lib/task-filters.js.map +1 -0
- package/dist/admin/lib/use-editor-focus.d.ts +25 -0
- package/dist/admin/lib/use-editor-focus.d.ts.map +1 -0
- package/dist/admin/lib/use-editor-focus.js +54 -0
- package/dist/admin/lib/use-editor-focus.js.map +1 -0
- package/dist/admin/lib/use-task-vocabulary.d.ts +15 -0
- package/dist/admin/lib/use-task-vocabulary.d.ts.map +1 -0
- package/dist/admin/lib/use-task-vocabulary.js +26 -0
- package/dist/admin/lib/use-task-vocabulary.js.map +1 -0
- package/dist/admin/pages/MyTasksPage.d.ts +17 -0
- package/dist/admin/pages/MyTasksPage.d.ts.map +1 -0
- package/dist/admin/pages/MyTasksPage.js +96 -0
- package/dist/admin/pages/MyTasksPage.js.map +1 -0
- package/dist/admin/pages/TaskCreate.d.ts +34 -0
- package/dist/admin/pages/TaskCreate.d.ts.map +1 -0
- package/dist/admin/pages/TaskCreate.js +146 -0
- package/dist/admin/pages/TaskCreate.js.map +1 -0
- package/dist/admin/pages/TaskDetail.d.ts +33 -0
- package/dist/admin/pages/TaskDetail.d.ts.map +1 -0
- package/dist/admin/pages/TaskDetail.js +431 -0
- package/dist/admin/pages/TaskDetail.js.map +1 -0
- package/dist/admin/pages/TasksPage.d.ts +21 -0
- package/dist/admin/pages/TasksPage.d.ts.map +1 -0
- package/dist/admin/pages/TasksPage.js +145 -0
- package/dist/admin/pages/TasksPage.js.map +1 -0
- package/dist/admin/pages/settings/TaskGeneralSettingsPage.d.ts +13 -0
- package/dist/admin/pages/settings/TaskGeneralSettingsPage.d.ts.map +1 -0
- package/dist/admin/pages/settings/TaskGeneralSettingsPage.js +75 -0
- package/dist/admin/pages/settings/TaskGeneralSettingsPage.js.map +1 -0
- package/dist/admin/pages/settings/TaskPrioritiesPage.d.ts +16 -0
- package/dist/admin/pages/settings/TaskPrioritiesPage.d.ts.map +1 -0
- package/dist/admin/pages/settings/TaskPrioritiesPage.js +75 -0
- package/dist/admin/pages/settings/TaskPrioritiesPage.js.map +1 -0
- package/dist/admin/pages/settings/TaskTagsPage.d.ts +16 -0
- package/dist/admin/pages/settings/TaskTagsPage.d.ts.map +1 -0
- package/dist/admin/pages/settings/TaskTagsPage.js +68 -0
- package/dist/admin/pages/settings/TaskTagsPage.js.map +1 -0
- package/dist/admin/pages/settings/TaskWorkflowPage.d.ts +22 -0
- package/dist/admin/pages/settings/TaskWorkflowPage.d.ts.map +1 -0
- package/dist/admin/pages/settings/TaskWorkflowPage.js +110 -0
- package/dist/admin/pages/settings/TaskWorkflowPage.js.map +1 -0
- package/dist/admin/zones/OpportunityTasksPanel.d.ts +7 -0
- package/dist/admin/zones/OpportunityTasksPanel.d.ts.map +1 -0
- package/dist/admin/zones/OpportunityTasksPanel.js +9 -0
- package/dist/admin/zones/OpportunityTasksPanel.js.map +1 -0
- package/dist/admin/zones/OrderTasksPanel.d.ts +7 -0
- package/dist/admin/zones/OrderTasksPanel.d.ts.map +1 -0
- package/dist/admin/zones/OrderTasksPanel.js +9 -0
- package/dist/admin/zones/OrderTasksPanel.js.map +1 -0
- package/dist/admin/zones/QuoteRequestTasksPanel.d.ts +7 -0
- package/dist/admin/zones/QuoteRequestTasksPanel.d.ts.map +1 -0
- package/dist/admin/zones/QuoteRequestTasksPanel.js +9 -0
- package/dist/admin/zones/QuoteRequestTasksPanel.js.map +1 -0
- package/dist/admin/zones/TasksPanel.d.ts +22 -0
- package/dist/admin/zones/TasksPanel.d.ts.map +1 -0
- package/dist/admin/zones/TasksPanel.js +59 -0
- package/dist/admin/zones/TasksPanel.js.map +1 -0
- package/dist/backend/admin-search-provider.d.ts +38 -0
- package/dist/backend/admin-search-provider.d.ts.map +1 -0
- package/dist/backend/admin-search-provider.js +48 -0
- package/dist/backend/admin-search-provider.js.map +1 -0
- package/dist/backend/domain/board-card-fields.d.ts +35 -0
- package/dist/backend/domain/board-card-fields.d.ts.map +1 -0
- package/dist/backend/domain/board-card-fields.js +98 -0
- package/dist/backend/domain/board-card-fields.js.map +1 -0
- package/dist/backend/domain/due-moment.d.ts +28 -0
- package/dist/backend/domain/due-moment.d.ts.map +1 -0
- package/dist/backend/domain/due-moment.js +66 -0
- package/dist/backend/domain/due-moment.js.map +1 -0
- package/dist/backend/domain/hierarchy.d.ts +36 -0
- package/dist/backend/domain/hierarchy.d.ts.map +1 -0
- package/dist/backend/domain/hierarchy.js +13 -0
- package/dist/backend/domain/hierarchy.js.map +1 -0
- package/dist/backend/domain/list-cursor.d.ts +27 -0
- package/dist/backend/domain/list-cursor.d.ts.map +1 -0
- package/dist/backend/domain/list-cursor.js +75 -0
- package/dist/backend/domain/list-cursor.js.map +1 -0
- package/dist/backend/domain/task-status-graph.d.ts +73 -0
- package/dist/backend/domain/task-status-graph.d.ts.map +1 -0
- package/dist/backend/domain/task-status-graph.js +90 -0
- package/dist/backend/domain/task-status-graph.js.map +1 -0
- package/dist/backend/email-templates/digest-defaults.d.ts +30 -0
- package/dist/backend/email-templates/digest-defaults.d.ts.map +1 -0
- package/dist/backend/email-templates/digest-defaults.js +50 -0
- package/dist/backend/email-templates/digest-defaults.js.map +1 -0
- package/dist/backend/email-templates/reminder-defaults.d.ts +24 -0
- package/dist/backend/email-templates/reminder-defaults.d.ts.map +1 -0
- package/dist/backend/email-templates/reminder-defaults.js +46 -0
- package/dist/backend/email-templates/reminder-defaults.js.map +1 -0
- package/dist/backend/entities/task-assignee.entity.d.ts +15 -0
- package/dist/backend/entities/task-assignee.entity.d.ts.map +1 -0
- package/dist/backend/entities/task-assignee.entity.js +47 -0
- package/dist/backend/entities/task-assignee.entity.js.map +1 -0
- package/dist/backend/entities/task-attachment.entity.d.ts +15 -0
- package/dist/backend/entities/task-attachment.entity.d.ts.map +1 -0
- package/dist/backend/entities/task-attachment.entity.js +53 -0
- package/dist/backend/entities/task-attachment.entity.js.map +1 -0
- package/dist/backend/entities/task-comment.entity.d.ts +17 -0
- package/dist/backend/entities/task-comment.entity.d.ts.map +1 -0
- package/dist/backend/entities/task-comment.entity.js +62 -0
- package/dist/backend/entities/task-comment.entity.js.map +1 -0
- package/dist/backend/entities/task-digest-subscription.entity.d.ts +15 -0
- package/dist/backend/entities/task-digest-subscription.entity.d.ts.map +1 -0
- package/dist/backend/entities/task-digest-subscription.entity.js +46 -0
- package/dist/backend/entities/task-digest-subscription.entity.js.map +1 -0
- package/dist/backend/entities/task-list-saved-view.entity.d.ts +25 -0
- package/dist/backend/entities/task-list-saved-view.entity.d.ts.map +1 -0
- package/dist/backend/entities/task-list-saved-view.entity.js +74 -0
- package/dist/backend/entities/task-list-saved-view.entity.js.map +1 -0
- package/dist/backend/entities/task-priority.entity.d.ts +17 -0
- package/dist/backend/entities/task-priority.entity.d.ts.map +1 -0
- package/dist/backend/entities/task-priority.entity.js +66 -0
- package/dist/backend/entities/task-priority.entity.js.map +1 -0
- package/dist/backend/entities/task-record-link.entity.d.ts +17 -0
- package/dist/backend/entities/task-record-link.entity.d.ts.map +1 -0
- package/dist/backend/entities/task-record-link.entity.js +58 -0
- package/dist/backend/entities/task-record-link.entity.js.map +1 -0
- package/dist/backend/entities/task-reference.entity.d.ts +21 -0
- package/dist/backend/entities/task-reference.entity.d.ts.map +1 -0
- package/dist/backend/entities/task-reference.entity.js +60 -0
- package/dist/backend/entities/task-reference.entity.js.map +1 -0
- package/dist/backend/entities/task-relation.entity.d.ts +13 -0
- package/dist/backend/entities/task-relation.entity.d.ts.map +1 -0
- package/dist/backend/entities/task-relation.entity.js +45 -0
- package/dist/backend/entities/task-relation.entity.js.map +1 -0
- package/dist/backend/entities/task-reminder-delivery.entity.d.ts +18 -0
- package/dist/backend/entities/task-reminder-delivery.entity.d.ts.map +1 -0
- package/dist/backend/entities/task-reminder-delivery.entity.js +53 -0
- package/dist/backend/entities/task-reminder-delivery.entity.js.map +1 -0
- package/dist/backend/entities/task-reminder.entity.d.ts +21 -0
- package/dist/backend/entities/task-reminder.entity.d.ts.map +1 -0
- package/dist/backend/entities/task-reminder.entity.js +70 -0
- package/dist/backend/entities/task-reminder.entity.js.map +1 -0
- package/dist/backend/entities/task-status-transition.entity.d.ts +14 -0
- package/dist/backend/entities/task-status-transition.entity.d.ts.map +1 -0
- package/dist/backend/entities/task-status-transition.entity.js +48 -0
- package/dist/backend/entities/task-status-transition.entity.js.map +1 -0
- package/dist/backend/entities/task-status.entity.d.ts +29 -0
- package/dist/backend/entities/task-status.entity.d.ts.map +1 -0
- package/dist/backend/entities/task-status.entity.js +85 -0
- package/dist/backend/entities/task-status.entity.js.map +1 -0
- package/dist/backend/entities/task-tag-assignment.entity.d.ts +10 -0
- package/dist/backend/entities/task-tag-assignment.entity.d.ts.map +1 -0
- package/dist/backend/entities/task-tag-assignment.entity.js +35 -0
- package/dist/backend/entities/task-tag-assignment.entity.js.map +1 -0
- package/dist/backend/entities/task-tag.entity.d.ts +14 -0
- package/dist/backend/entities/task-tag.entity.d.ts.map +1 -0
- package/dist/backend/entities/task-tag.entity.js +50 -0
- package/dist/backend/entities/task-tag.entity.js.map +1 -0
- package/dist/backend/entities/task.entity.d.ts +66 -0
- package/dist/backend/entities/task.entity.d.ts.map +1 -0
- package/dist/backend/entities/task.entity.js +175 -0
- package/dist/backend/entities/task.entity.js.map +1 -0
- package/dist/backend/index.d.ts +40 -0
- package/dist/backend/index.d.ts.map +1 -0
- package/dist/backend/index.js +642 -0
- package/dist/backend/index.js.map +1 -0
- package/dist/backend/routes/routes.board.d.ts +21 -0
- package/dist/backend/routes/routes.board.d.ts.map +1 -0
- package/dist/backend/routes/routes.board.js +28 -0
- package/dist/backend/routes/routes.board.js.map +1 -0
- package/dist/backend/routes/routes.collaboration.d.ts +30 -0
- package/dist/backend/routes/routes.collaboration.d.ts.map +1 -0
- package/dist/backend/routes/routes.collaboration.js +124 -0
- package/dist/backend/routes/routes.collaboration.js.map +1 -0
- package/dist/backend/routes/routes.priorities.d.ts +15 -0
- package/dist/backend/routes/routes.priorities.d.ts.map +1 -0
- package/dist/backend/routes/routes.priorities.js +27 -0
- package/dist/backend/routes/routes.priorities.js.map +1 -0
- package/dist/backend/routes/routes.reminders.d.ts +23 -0
- package/dist/backend/routes/routes.reminders.d.ts.map +1 -0
- package/dist/backend/routes/routes.reminders.js +36 -0
- package/dist/backend/routes/routes.reminders.js.map +1 -0
- package/dist/backend/routes/routes.settings.d.ts +16 -0
- package/dist/backend/routes/routes.settings.d.ts.map +1 -0
- package/dist/backend/routes/routes.settings.js +19 -0
- package/dist/backend/routes/routes.settings.js.map +1 -0
- package/dist/backend/routes/routes.tags.d.ts +15 -0
- package/dist/backend/routes/routes.tags.d.ts.map +1 -0
- package/dist/backend/routes/routes.tags.js +27 -0
- package/dist/backend/routes/routes.tags.js.map +1 -0
- package/dist/backend/routes/routes.tasks.d.ts +42 -0
- package/dist/backend/routes/routes.tasks.d.ts.map +1 -0
- package/dist/backend/routes/routes.tasks.js +109 -0
- package/dist/backend/routes/routes.tasks.js.map +1 -0
- package/dist/backend/routes/routes.views.d.ts +17 -0
- package/dist/backend/routes/routes.views.d.ts.map +1 -0
- package/dist/backend/routes/routes.views.js +29 -0
- package/dist/backend/routes/routes.views.js.map +1 -0
- package/dist/backend/routes/routes.workflow.d.ts +19 -0
- package/dist/backend/routes/routes.workflow.d.ts.map +1 -0
- package/dist/backend/routes/routes.workflow.js +34 -0
- package/dist/backend/routes/routes.workflow.js.map +1 -0
- package/dist/backend/saved-view-actor.d.ts +16 -0
- package/dist/backend/saved-view-actor.d.ts.map +1 -0
- package/dist/backend/saved-view-actor.js +24 -0
- package/dist/backend/saved-view-actor.js.map +1 -0
- package/dist/backend/services/attachment-active-content.d.ts +22 -0
- package/dist/backend/services/attachment-active-content.d.ts.map +1 -0
- package/dist/backend/services/attachment-active-content.js +80 -0
- package/dist/backend/services/attachment-active-content.js.map +1 -0
- package/dist/backend/services/attachment-service.d.ts +71 -0
- package/dist/backend/services/attachment-service.d.ts.map +1 -0
- package/dist/backend/services/attachment-service.js +236 -0
- package/dist/backend/services/attachment-service.js.map +1 -0
- package/dist/backend/services/board-card-field-service.d.ts +36 -0
- package/dist/backend/services/board-card-field-service.d.ts.map +1 -0
- package/dist/backend/services/board-card-field-service.js +71 -0
- package/dist/backend/services/board-card-field-service.js.map +1 -0
- package/dist/backend/services/board-service.d.ts +38 -0
- package/dist/backend/services/board-service.d.ts.map +1 -0
- package/dist/backend/services/board-service.js +57 -0
- package/dist/backend/services/board-service.js.map +1 -0
- package/dist/backend/services/comment-service.d.ts +61 -0
- package/dist/backend/services/comment-service.d.ts.map +1 -0
- package/dist/backend/services/comment-service.js +219 -0
- package/dist/backend/services/comment-service.js.map +1 -0
- package/dist/backend/services/context-lookup.d.ts +19 -0
- package/dist/backend/services/context-lookup.d.ts.map +1 -0
- package/dist/backend/services/context-lookup.js +53 -0
- package/dist/backend/services/context-lookup.js.map +1 -0
- package/dist/backend/services/digest-service.d.ts +88 -0
- package/dist/backend/services/digest-service.d.ts.map +1 -0
- package/dist/backend/services/digest-service.js +212 -0
- package/dist/backend/services/digest-service.js.map +1 -0
- package/dist/backend/services/document-lookup-service.d.ts +40 -0
- package/dist/backend/services/document-lookup-service.d.ts.map +1 -0
- package/dist/backend/services/document-lookup-service.js +67 -0
- package/dist/backend/services/document-lookup-service.js.map +1 -0
- package/dist/backend/services/hierarchy-service.d.ts +66 -0
- package/dist/backend/services/hierarchy-service.d.ts.map +1 -0
- package/dist/backend/services/hierarchy-service.js +132 -0
- package/dist/backend/services/hierarchy-service.js.map +1 -0
- package/dist/backend/services/maintenance-service.d.ts +61 -0
- package/dist/backend/services/maintenance-service.d.ts.map +1 -0
- package/dist/backend/services/maintenance-service.js +119 -0
- package/dist/backend/services/maintenance-service.js.map +1 -0
- package/dist/backend/services/mention-service.d.ts +70 -0
- package/dist/backend/services/mention-service.d.ts.map +1 -0
- package/dist/backend/services/mention-service.js +113 -0
- package/dist/backend/services/mention-service.js.map +1 -0
- package/dist/backend/services/owner-read-permissions.d.ts +50 -0
- package/dist/backend/services/owner-read-permissions.d.ts.map +1 -0
- package/dist/backend/services/owner-read-permissions.js +58 -0
- package/dist/backend/services/owner-read-permissions.js.map +1 -0
- package/dist/backend/services/priority-service.d.ts +76 -0
- package/dist/backend/services/priority-service.d.ts.map +1 -0
- package/dist/backend/services/priority-service.js +188 -0
- package/dist/backend/services/priority-service.js.map +1 -0
- package/dist/backend/services/record-link-service.d.ts +73 -0
- package/dist/backend/services/record-link-service.d.ts.map +1 -0
- package/dist/backend/services/record-link-service.js +187 -0
- package/dist/backend/services/record-link-service.js.map +1 -0
- package/dist/backend/services/record-owners.d.ts +52 -0
- package/dist/backend/services/record-owners.d.ts.map +1 -0
- package/dist/backend/services/record-owners.js +54 -0
- package/dist/backend/services/record-owners.js.map +1 -0
- package/dist/backend/services/reference-service.d.ts +77 -0
- package/dist/backend/services/reference-service.d.ts.map +1 -0
- package/dist/backend/services/reference-service.js +184 -0
- package/dist/backend/services/reference-service.js.map +1 -0
- package/dist/backend/services/relation-service.d.ts +39 -0
- package/dist/backend/services/relation-service.d.ts.map +1 -0
- package/dist/backend/services/relation-service.js +77 -0
- package/dist/backend/services/relation-service.js.map +1 -0
- package/dist/backend/services/reminder-schedule.d.ts +28 -0
- package/dist/backend/services/reminder-schedule.d.ts.map +1 -0
- package/dist/backend/services/reminder-schedule.js +60 -0
- package/dist/backend/services/reminder-schedule.js.map +1 -0
- package/dist/backend/services/reminder-service.d.ts +93 -0
- package/dist/backend/services/reminder-service.d.ts.map +1 -0
- package/dist/backend/services/reminder-service.js +370 -0
- package/dist/backend/services/reminder-service.js.map +1 -0
- package/dist/backend/services/saved-view-service.d.ts +65 -0
- package/dist/backend/services/saved-view-service.d.ts.map +1 -0
- package/dist/backend/services/saved-view-service.js +209 -0
- package/dist/backend/services/saved-view-service.js.map +1 -0
- package/dist/backend/services/scheduled-work-probe.d.ts +34 -0
- package/dist/backend/services/scheduled-work-probe.d.ts.map +1 -0
- package/dist/backend/services/scheduled-work-probe.js +30 -0
- package/dist/backend/services/scheduled-work-probe.js.map +1 -0
- package/dist/backend/services/tag-service.d.ts +53 -0
- package/dist/backend/services/tag-service.d.ts.map +1 -0
- package/dist/backend/services/tag-service.js +165 -0
- package/dist/backend/services/tag-service.js.map +1 -0
- package/dist/backend/services/task-access.d.ts +95 -0
- package/dist/backend/services/task-access.d.ts.map +1 -0
- package/dist/backend/services/task-access.js +184 -0
- package/dist/backend/services/task-access.js.map +1 -0
- package/dist/backend/services/task-asset-references.d.ts +42 -0
- package/dist/backend/services/task-asset-references.d.ts.map +1 -0
- package/dist/backend/services/task-asset-references.js +52 -0
- package/dist/backend/services/task-asset-references.js.map +1 -0
- package/dist/backend/services/task-audit-references.d.ts +18 -0
- package/dist/backend/services/task-audit-references.d.ts.map +1 -0
- package/dist/backend/services/task-audit-references.js +26 -0
- package/dist/backend/services/task-audit-references.js.map +1 -0
- package/dist/backend/services/task-checks.d.ts +78 -0
- package/dist/backend/services/task-checks.d.ts.map +1 -0
- package/dist/backend/services/task-checks.js +148 -0
- package/dist/backend/services/task-checks.js.map +1 -0
- package/dist/backend/services/task-commands.d.ts +199 -0
- package/dist/backend/services/task-commands.d.ts.map +1 -0
- package/dist/backend/services/task-commands.js +483 -0
- package/dist/backend/services/task-commands.js.map +1 -0
- package/dist/backend/services/task-context-registry.d.ts +34 -0
- package/dist/backend/services/task-context-registry.d.ts.map +1 -0
- package/dist/backend/services/task-context-registry.js +49 -0
- package/dist/backend/services/task-context-registry.js.map +1 -0
- package/dist/backend/services/task-custom-fields.d.ts +21 -0
- package/dist/backend/services/task-custom-fields.d.ts.map +1 -0
- package/dist/backend/services/task-custom-fields.js +34 -0
- package/dist/backend/services/task-custom-fields.js.map +1 -0
- package/dist/backend/services/task-email.d.ts +116 -0
- package/dist/backend/services/task-email.d.ts.map +1 -0
- package/dist/backend/services/task-email.js +128 -0
- package/dist/backend/services/task-email.js.map +1 -0
- package/dist/backend/services/task-errors.d.ts +34 -0
- package/dist/backend/services/task-errors.d.ts.map +1 -0
- package/dist/backend/services/task-errors.js +56 -0
- package/dist/backend/services/task-errors.js.map +1 -0
- package/dist/backend/services/task-history-service.d.ts +34 -0
- package/dist/backend/services/task-history-service.d.ts.map +1 -0
- package/dist/backend/services/task-history-service.js +185 -0
- package/dist/backend/services/task-history-service.js.map +1 -0
- package/dist/backend/services/task-notifier.d.ts +85 -0
- package/dist/backend/services/task-notifier.d.ts.map +1 -0
- package/dist/backend/services/task-notifier.js +96 -0
- package/dist/backend/services/task-notifier.js.map +1 -0
- package/dist/backend/services/task-number.d.ts +17 -0
- package/dist/backend/services/task-number.d.ts.map +1 -0
- package/dist/backend/services/task-number.js +30 -0
- package/dist/backend/services/task-number.js.map +1 -0
- package/dist/backend/services/task-read-port.d.ts +25 -0
- package/dist/backend/services/task-read-port.d.ts.map +1 -0
- package/dist/backend/services/task-read-port.js +38 -0
- package/dist/backend/services/task-read-port.js.map +1 -0
- package/dist/backend/services/task-reassignment.d.ts +43 -0
- package/dist/backend/services/task-reassignment.d.ts.map +1 -0
- package/dist/backend/services/task-reassignment.js +41 -0
- package/dist/backend/services/task-reassignment.js.map +1 -0
- package/dist/backend/services/task-service.d.ts +219 -0
- package/dist/backend/services/task-service.d.ts.map +1 -0
- package/dist/backend/services/task-service.js +1112 -0
- package/dist/backend/services/task-service.js.map +1 -0
- package/dist/backend/services/task-settings-service.d.ts +23 -0
- package/dist/backend/services/task-settings-service.d.ts.map +1 -0
- package/dist/backend/services/task-settings-service.js +30 -0
- package/dist/backend/services/task-settings-service.js.map +1 -0
- package/dist/backend/services/task-transition-service.d.ts +56 -0
- package/dist/backend/services/task-transition-service.d.ts.map +1 -0
- package/dist/backend/services/task-transition-service.js +125 -0
- package/dist/backend/services/task-transition-service.js.map +1 -0
- package/dist/backend/services/task-visibility.d.ts +102 -0
- package/dist/backend/services/task-visibility.d.ts.map +1 -0
- package/dist/backend/services/task-visibility.js +106 -0
- package/dist/backend/services/task-visibility.js.map +1 -0
- package/dist/backend/services/task-workflow-read.d.ts +15 -0
- package/dist/backend/services/task-workflow-read.d.ts.map +1 -0
- package/dist/backend/services/task-workflow-read.js +53 -0
- package/dist/backend/services/task-workflow-read.js.map +1 -0
- package/dist/backend/services/task-write-port.d.ts +65 -0
- package/dist/backend/services/task-write-port.d.ts.map +1 -0
- package/dist/backend/services/task-write-port.js +115 -0
- package/dist/backend/services/task-write-port.js.map +1 -0
- package/dist/backend/services/time-zone-validator.d.ts +15 -0
- package/dist/backend/services/time-zone-validator.d.ts.map +1 -0
- package/dist/backend/services/time-zone-validator.js +28 -0
- package/dist/backend/services/time-zone-validator.js.map +1 -0
- package/dist/backend/services/workflow-config-service.d.ts +69 -0
- package/dist/backend/services/workflow-config-service.d.ts.map +1 -0
- package/dist/backend/services/workflow-config-service.js +262 -0
- package/dist/backend/services/workflow-config-service.js.map +1 -0
- package/dist/backend/workers/tasks-reminders-worker.d.ts +102 -0
- package/dist/backend/workers/tasks-reminders-worker.d.ts.map +1 -0
- package/dist/backend/workers/tasks-reminders-worker.js +134 -0
- package/dist/backend/workers/tasks-reminders-worker.js.map +1 -0
- package/dist/manifest.d.ts +168 -0
- package/dist/manifest.d.ts.map +1 -0
- package/dist/manifest.js +374 -0
- package/dist/manifest.js.map +1 -0
- package/dist/migrations/20261026T133731_tasks_init.d.ts +23 -0
- package/dist/migrations/20261026T133731_tasks_init.d.ts.map +1 -0
- package/dist/migrations/20261026T133731_tasks_init.js +61 -0
- package/dist/migrations/20261026T133731_tasks_init.js.map +1 -0
- package/dist/migrations/20261028T140002_tasks_task_management.d.ts +34 -0
- package/dist/migrations/20261028T140002_tasks_task_management.d.ts.map +1 -0
- package/dist/migrations/20261028T140002_tasks_task_management.js +371 -0
- package/dist/migrations/20261028T140002_tasks_task_management.js.map +1 -0
- package/dist/migrations/index.d.ts +16 -0
- package/dist/migrations/index.d.ts.map +1 -0
- package/dist/migrations/index.js +16 -0
- package/dist/migrations/index.js.map +1 -0
- package/docs/tasks.md +597 -0
- package/i18n/en.json +567 -0
- package/i18n/pl.json +567 -0
- package/package.json +102 -3
- package/tailwind.css +14 -0
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import { ERROR_CODES } from '@endora-commerce/contracts';
|
|
2
|
+
import { recordAuditFromContext } from '@endora-commerce/platform/commands';
|
|
3
|
+
import { HttpError } from '@endora-commerce/platform/http';
|
|
4
|
+
import { TASK_AUDIT_OBJECT_TYPE } from './task-history-service.js';
|
|
5
|
+
function pair(one, other) {
|
|
6
|
+
return one < other ? [one, other] : [other, one];
|
|
7
|
+
}
|
|
8
|
+
export class TaskRelationService {
|
|
9
|
+
deps;
|
|
10
|
+
constructor(deps) {
|
|
11
|
+
this.deps = deps;
|
|
12
|
+
}
|
|
13
|
+
/** `PUT /tasks/:id/relations/:otherId`. `true` when the link is new. */
|
|
14
|
+
async relate(taskId, otherId) {
|
|
15
|
+
const [task, other] = await this.#both(taskId, otherId);
|
|
16
|
+
const [a, b] = pair(task, other);
|
|
17
|
+
return this.deps.commandBus.run({
|
|
18
|
+
action: 'tasks.task.relate',
|
|
19
|
+
objectType: TASK_AUDIT_OBJECT_TYPE,
|
|
20
|
+
objectId: task,
|
|
21
|
+
run: async ({ em, actor }) => {
|
|
22
|
+
if (actor.actorAdminUserId === null) {
|
|
23
|
+
// `created_by_admin_user_id` is not null: a link is made by somebody.
|
|
24
|
+
throw new Error('tasks: two Tasks are related by an administrator; the ambient actor is none.');
|
|
25
|
+
}
|
|
26
|
+
const tx = em;
|
|
27
|
+
const inserted = (await tx.execute(`insert into "task_relations" ("task_a_id", "task_b_id", "created_by_admin_user_id", "created_at")
|
|
28
|
+
values (?, ?, ?, now())
|
|
29
|
+
on conflict do nothing returning "task_a_id"`, [a, b, actor.actorAdminUserId]));
|
|
30
|
+
if (inserted.length === 0)
|
|
31
|
+
return { result: false, skipAudit: true };
|
|
32
|
+
this.#recordOther(tx, 'tasks.task.relate', other, task, true);
|
|
33
|
+
return { result: true, before: { relatedTaskId: null }, after: { relatedTaskId: other } };
|
|
34
|
+
},
|
|
35
|
+
});
|
|
36
|
+
}
|
|
37
|
+
/** `DELETE /tasks/:id/relations/:otherId`. `true` when a link was removed. */
|
|
38
|
+
async unrelate(taskId, otherId) {
|
|
39
|
+
const [task, other] = await this.#both(taskId, otherId);
|
|
40
|
+
const [a, b] = pair(task, other);
|
|
41
|
+
return this.deps.commandBus.run({
|
|
42
|
+
action: 'tasks.task.unrelate',
|
|
43
|
+
objectType: TASK_AUDIT_OBJECT_TYPE,
|
|
44
|
+
objectId: task,
|
|
45
|
+
run: async ({ em }) => {
|
|
46
|
+
const tx = em;
|
|
47
|
+
const deleted = (await tx.execute(`delete from "task_relations" where "task_a_id" = ? and "task_b_id" = ? returning "task_a_id"`, [a, b]));
|
|
48
|
+
if (deleted.length === 0)
|
|
49
|
+
return { result: false, skipAudit: true };
|
|
50
|
+
this.#recordOther(tx, 'tasks.task.unrelate', other, task, false);
|
|
51
|
+
return { result: true, before: { relatedTaskId: other }, after: { relatedTaskId: null } };
|
|
52
|
+
},
|
|
53
|
+
});
|
|
54
|
+
}
|
|
55
|
+
/** Both Tasks, visible and changeable by the caller — their ids. */
|
|
56
|
+
async #both(taskId, otherId) {
|
|
57
|
+
if (taskId === otherId) {
|
|
58
|
+
throw new HttpError(400, ERROR_CODES.VALIDATION_FAILED, 'A task cannot be related to itself.');
|
|
59
|
+
}
|
|
60
|
+
const task = await this.deps.access.loadVisible(taskId);
|
|
61
|
+
const other = await this.deps.access.loadVisible(otherId);
|
|
62
|
+
this.deps.access.assertMayChange(task);
|
|
63
|
+
this.deps.access.assertMayChange(other);
|
|
64
|
+
return [task.id, other.id];
|
|
65
|
+
}
|
|
66
|
+
/** The other Task's own history entry, on the Command's transaction. */
|
|
67
|
+
#recordOther(em, action, objectId, relatedTaskId, related) {
|
|
68
|
+
recordAuditFromContext(this.deps.auditLog, em, {
|
|
69
|
+
action,
|
|
70
|
+
objectType: TASK_AUDIT_OBJECT_TYPE,
|
|
71
|
+
objectId,
|
|
72
|
+
stateBefore: { relatedTaskId: related ? null : relatedTaskId },
|
|
73
|
+
stateAfter: { relatedTaskId: related ? relatedTaskId : null },
|
|
74
|
+
});
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
//# sourceMappingURL=relation-service.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"relation-service.js","sourceRoot":"","sources":["../../../src/backend/services/relation-service.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type { EntityManager } from '@mikro-orm/postgresql';
|
|
2
|
+
import type { AuditPort } from '@endora-commerce/platform/kernel';
|
|
3
|
+
/**
|
|
4
|
+
* The moment a relative reminder counts back from (data-model §5): the due
|
|
5
|
+
* time when the Task has one, else 09:00 of its due date in `tasks.time_zone`,
|
|
6
|
+
* else none.
|
|
7
|
+
*/
|
|
8
|
+
export declare function dueMomentOf(due: {
|
|
9
|
+
dueOn: string | null;
|
|
10
|
+
dueAt: Date | null;
|
|
11
|
+
}, timeZone: string): Date | null;
|
|
12
|
+
/**
|
|
13
|
+
* Keep a Task's relative reminders on its due moment (`specs/165-task-management/`
|
|
14
|
+
* US7 scenario 3, research R-17) — run **inside** the Command that changed the
|
|
15
|
+
* due date or time, on its transaction, by the id that Command locked.
|
|
16
|
+
*
|
|
17
|
+
* - **A new moment** moves each relative reminder to it, less its offset. A
|
|
18
|
+
* reminder whose moment moved is a new reminder: its delivery rows go, so it
|
|
19
|
+
* fires again at the new moment (a reminder already sent for an old due date
|
|
20
|
+
* says nothing about the new one).
|
|
21
|
+
* - **No moment any more** removes them, each with an audit row
|
|
22
|
+
* `tasks.reminder.removed_with_due` on the Task, which its history shows —
|
|
23
|
+
* that is how the reminder's creator is told on the Task.
|
|
24
|
+
*
|
|
25
|
+
* Absolute reminders are the caller's chosen moments and are never touched.
|
|
26
|
+
*/
|
|
27
|
+
export declare function followDueMoment(em: EntityManager, auditLog: AuditPort, taskId: string, moment: Date | null): Promise<void>;
|
|
28
|
+
//# sourceMappingURL=reminder-schedule.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reminder-schedule.d.ts","sourceRoot":"","sources":["../../../src/backend/services/reminder-schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAIlE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAG5G;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,aAAa,EACjB,QAAQ,EAAE,SAAS,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,IAAI,GAAG,IAAI,GAClB,OAAO,CAAC,IAAI,CAAC,CA0Cf"}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
import { recordAuditFromContext } from '@endora-commerce/platform/commands';
|
|
2
|
+
import { dateOnlyMoment } from '../domain/due-moment.js';
|
|
3
|
+
import { TASK_AUDIT_OBJECT_TYPE } from './task-history-service.js';
|
|
4
|
+
/**
|
|
5
|
+
* The moment a relative reminder counts back from (data-model §5): the due
|
|
6
|
+
* time when the Task has one, else 09:00 of its due date in `tasks.time_zone`,
|
|
7
|
+
* else none.
|
|
8
|
+
*/
|
|
9
|
+
export function dueMomentOf(due, timeZone) {
|
|
10
|
+
if (due.dueAt)
|
|
11
|
+
return due.dueAt;
|
|
12
|
+
return due.dueOn ? dateOnlyMoment(due.dueOn, timeZone) : null;
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Keep a Task's relative reminders on its due moment (`specs/165-task-management/`
|
|
16
|
+
* US7 scenario 3, research R-17) — run **inside** the Command that changed the
|
|
17
|
+
* due date or time, on its transaction, by the id that Command locked.
|
|
18
|
+
*
|
|
19
|
+
* - **A new moment** moves each relative reminder to it, less its offset. A
|
|
20
|
+
* reminder whose moment moved is a new reminder: its delivery rows go, so it
|
|
21
|
+
* fires again at the new moment (a reminder already sent for an old due date
|
|
22
|
+
* says nothing about the new one).
|
|
23
|
+
* - **No moment any more** removes them, each with an audit row
|
|
24
|
+
* `tasks.reminder.removed_with_due` on the Task, which its history shows —
|
|
25
|
+
* that is how the reminder's creator is told on the Task.
|
|
26
|
+
*
|
|
27
|
+
* Absolute reminders are the caller's chosen moments and are never touched.
|
|
28
|
+
*/
|
|
29
|
+
export async function followDueMoment(em, auditLog, taskId, moment) {
|
|
30
|
+
if (moment === null) {
|
|
31
|
+
const removed = (await em.execute(`delete from "task_reminders" where "task_id" = ? and "mode" = 'relative'
|
|
32
|
+
returning "id", "offset_minutes", "remind_at", "recipient_admin_user_ids", "created_by_admin_user_id"`, [taskId]));
|
|
33
|
+
for (const row of removed) {
|
|
34
|
+
recordAuditFromContext(auditLog, em, {
|
|
35
|
+
action: 'tasks.reminder.removed_with_due',
|
|
36
|
+
objectType: TASK_AUDIT_OBJECT_TYPE,
|
|
37
|
+
objectId: taskId,
|
|
38
|
+
stateBefore: {
|
|
39
|
+
reminderId: row.id,
|
|
40
|
+
mode: 'relative',
|
|
41
|
+
offsetMinutes: Number(row.offset_minutes),
|
|
42
|
+
remindAt: new Date(row.remind_at).toISOString(),
|
|
43
|
+
recipientIds: row.recipient_admin_user_ids,
|
|
44
|
+
createdById: row.created_by_admin_user_id,
|
|
45
|
+
},
|
|
46
|
+
stateAfter: null,
|
|
47
|
+
});
|
|
48
|
+
}
|
|
49
|
+
return;
|
|
50
|
+
}
|
|
51
|
+
await em.execute(`with "moved" as (
|
|
52
|
+
update "task_reminders"
|
|
53
|
+
set "remind_at" = ?::timestamptz - make_interval(mins => "offset_minutes")
|
|
54
|
+
where "task_id" = ? and "mode" = 'relative'
|
|
55
|
+
and "remind_at" <> ?::timestamptz - make_interval(mins => "offset_minutes")
|
|
56
|
+
returning "id"
|
|
57
|
+
)
|
|
58
|
+
delete from "task_reminder_deliveries" d using "moved" m where d."reminder_id" = m."id"`, [moment, taskId, moment]);
|
|
59
|
+
}
|
|
60
|
+
//# sourceMappingURL=reminder-schedule.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reminder-schedule.js","sourceRoot":"","sources":["../../../src/backend/services/reminder-schedule.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAiD,EAAE,QAAgB;IAC7F,IAAI,GAAG,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC;IAChC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAChE,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,EAAiB,EACjB,QAAmB,EACnB,MAAc,EACd,MAAmB;IAEnB,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAC/B;6GACuG,EACvG,CAAC,MAAM,CAAC,CACT,CAMC,CAAC;QACH,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,sBAAsB,CAAC,QAAQ,EAAE,EAAE,EAAE;gBACnC,MAAM,EAAE,iCAAiC;gBACzC,UAAU,EAAE,sBAAsB;gBAClC,QAAQ,EAAE,MAAM;gBAChB,WAAW,EAAE;oBACX,UAAU,EAAE,GAAG,CAAC,EAAE;oBAClB,IAAI,EAAE,UAAU;oBAChB,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC;oBACzC,QAAQ,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;oBAC/C,YAAY,EAAE,GAAG,CAAC,wBAAwB;oBAC1C,WAAW,EAAE,GAAG,CAAC,wBAAwB;iBAC1C;gBACD,UAAU,EAAE,IAAI;aACjB,CAAC,CAAC;QACL,CAAC;QACD,OAAO;IACT,CAAC;IACD,MAAM,EAAE,CAAC,OAAO,CACd;;;;;;;6FAOyF,EACzF,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CACzB,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
import type { EntityManager } from '@mikro-orm/postgresql';
|
|
2
|
+
import { type AdminNotificationRecordPort, type AdminUserReadPort, type CreateTaskReminderBody, type PermissionReadPort, type TaskReminder } from '@endora-commerce/contracts';
|
|
3
|
+
import type { CommandBus } from '@endora-commerce/platform/commands';
|
|
4
|
+
import type { TaskAudience } from './mention-service.js';
|
|
5
|
+
import { type TaskAccess } from './task-access.js';
|
|
6
|
+
import type { TaskEmail } from './task-email.js';
|
|
7
|
+
/** The most (reminder, recipient) pairs one pass handles. The next tick — a minute later — takes the rest. */
|
|
8
|
+
export declare const TASK_REMINDER_BATCH_SIZE = 200;
|
|
9
|
+
export interface TaskReminderSweepSummary {
|
|
10
|
+
/** Bell and e-mail sent (or the bell alone while the e-mail could not go). */
|
|
11
|
+
delivered: number;
|
|
12
|
+
/** Recorded and not sent: the Task closed or a draft, or the recipient may not see it. */
|
|
13
|
+
skipped: number;
|
|
14
|
+
/** Recorded and not sent: more than `TASK_REMINDER_GRACE_MS` late. */
|
|
15
|
+
expired: number;
|
|
16
|
+
/** Another pass claimed it first. */
|
|
17
|
+
lost: number;
|
|
18
|
+
}
|
|
19
|
+
export interface TaskReminderServiceDeps {
|
|
20
|
+
emFactory: () => EntityManager;
|
|
21
|
+
commandBus: CommandBus;
|
|
22
|
+
access: Pick<TaskAccess, 'loadVisible' | 'assertMayChange'>;
|
|
23
|
+
/** Whether another administrator may see a Task — `tasks:read`, draft/private, the context's say. */
|
|
24
|
+
audience: TaskAudience;
|
|
25
|
+
/** Ports of other modules — lazy, resolved per call, never captured. */
|
|
26
|
+
adminUsers: AdminUserReadPort;
|
|
27
|
+
permissions: PermissionReadPort;
|
|
28
|
+
/** `admin_notifications`' record port: the bell entry, written on the delivery's own transaction. */
|
|
29
|
+
bell: AdminNotificationRecordPort<EntityManager>;
|
|
30
|
+
/** Whether `admin_notifications` is present — asked before the bell, never caught behind it. */
|
|
31
|
+
bellPresent: () => boolean;
|
|
32
|
+
email: TaskEmail;
|
|
33
|
+
/** `tasks.time_zone`, read per call. */
|
|
34
|
+
timeZone: () => Promise<string>;
|
|
35
|
+
log: (message: string, context: Record<string, unknown>) => void;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Reminders on a Task (`specs/165-task-management/` User Story 7, FR-034,
|
|
39
|
+
* FR-035, SC-004; research R-17).
|
|
40
|
+
*
|
|
41
|
+
* **Setting them.** A writer adds a reminder at a moment or some minutes
|
|
42
|
+
* before the due moment (09:00 of a date-only due date in `tasks.time_zone`),
|
|
43
|
+
* for recipients among themselves and the Task's assignees, at most ten per
|
|
44
|
+
* Task; the reminder's creator or any writer removes it. Each is a Command on
|
|
45
|
+
* the Task, so its history shows it. A relative reminder follows the due
|
|
46
|
+
* moment inside the Command that moves it (`reminder-schedule.ts`).
|
|
47
|
+
*
|
|
48
|
+
* **Delivering them — exactly once to the bell, at most once by e-mail.** A
|
|
49
|
+
* pass reads the (reminder, recipient) pairs due and not yet handled, and for
|
|
50
|
+
* each writes one `task_reminder_deliveries` row, whose unique key is the
|
|
51
|
+
* claim:
|
|
52
|
+
*
|
|
53
|
+
* - more than {@link TASK_REMINDER_GRACE_MS} late — after downtime, or while
|
|
54
|
+
* Tasks was off — it is `expired` and nothing is sent, so nothing piles up
|
|
55
|
+
* to be sent later (US7 scenario 6);
|
|
56
|
+
* - a closed Task, a draft, or a recipient who is no longer active, may not
|
|
57
|
+
* read Tasks or may not see this one (its context, a private Task) — it is
|
|
58
|
+
* `skipped` (scenario 4);
|
|
59
|
+
* - otherwise it is `delivered`: the row and the bell entry are written in
|
|
60
|
+
* **one** transaction, through `admin_notifications`' co-transactional
|
|
61
|
+
* `recordWithin`, so a concurrent pass that finds the row taken writes no
|
|
62
|
+
* bell — the bell is exactly once; the e-mail is sent after the commit, with
|
|
63
|
+
* the delivery row as its message id — a crash between the two loses the
|
|
64
|
+
* e-mail, never doubles it.
|
|
65
|
+
*
|
|
66
|
+
* The pass runs in the system scope the worker enters; every statement over a
|
|
67
|
+
* Task-owned table here reads by ids the pass found or `TaskAccess` handed out
|
|
68
|
+
* (`TASK_ACCESS_READERS` names this file). Delivery rows are bookkeeping, not
|
|
69
|
+
* a change to a Task: Commands with no audit entry, as CRM's and Projects'
|
|
70
|
+
* sweeps are.
|
|
71
|
+
*/
|
|
72
|
+
export declare class TaskReminderService {
|
|
73
|
+
#private;
|
|
74
|
+
private readonly deps;
|
|
75
|
+
constructor(deps: TaskReminderServiceDeps);
|
|
76
|
+
/** `GET /tasks/:id/reminders` — the caller's own reminders and those that name the caller. */
|
|
77
|
+
list(taskId: string): Promise<TaskReminder[]>;
|
|
78
|
+
/** The reminders of a Task the caller has already loaded that the caller may be shown (admin-api §1). */
|
|
79
|
+
forReader(taskId: string): Promise<TaskReminder[]>;
|
|
80
|
+
/** `POST /tasks/:id/reminders`. */
|
|
81
|
+
add(taskId: string, body: CreateTaskReminderBody): Promise<TaskReminder>;
|
|
82
|
+
/** `DELETE /tasks/:id/reminders/:reminderId` — the reminder's creator, or a writer. */
|
|
83
|
+
remove(taskId: string, reminderId: string): Promise<void>;
|
|
84
|
+
/**
|
|
85
|
+
* Whether a {@link sweep} at `now` would handle anything — **yes or no, and
|
|
86
|
+
* nothing else** (issue #120): asked before the worker opens its system
|
|
87
|
+
* scope, outside any tenant context, over the pass's own row source.
|
|
88
|
+
*/
|
|
89
|
+
hasWork(now?: Date): Promise<boolean>;
|
|
90
|
+
/** One pass. `now` is the clock, handed in so that a test needs no sleep. */
|
|
91
|
+
sweep(now?: Date): Promise<TaskReminderSweepSummary>;
|
|
92
|
+
}
|
|
93
|
+
//# sourceMappingURL=reminder-service.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reminder-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/reminder-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAKL,KAAK,2BAA2B,EAChC,KAAK,iBAAiB,EAEtB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAKrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EAA6B,KAAK,UAAU,EAAgB,MAAM,kBAAkB,CAAC;AAC5F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,8GAA8G;AAC9G,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAsE5C,MAAM,WAAW,wBAAwB;IACvC,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,iBAAiB,CAAC,CAAC;IAC5D,qGAAqG;IACrG,QAAQ,EAAE,YAAY,CAAC;IACvB,wEAAwE;IACxE,UAAU,EAAE,iBAAiB,CAAC;IAC9B,WAAW,EAAE,kBAAkB,CAAC;IAChC,qGAAqG;IACrG,IAAI,EAAE,2BAA2B,CAAC,aAAa,CAAC,CAAC;IACjD,gGAAgG;IAChG,WAAW,EAAE,MAAM,OAAO,CAAC;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAClE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,mBAAmB;;IAClB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,uBAAuB;IAI1D,8FAA8F;IACxF,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAKnD,yGAAyG;IACnG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAYxD,mCAAmC;IAC7B,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,YAAY,CAAC;IAmE9E,uFAAuF;IACjF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC/D;;;;OAIG;IACG,OAAO,CAAC,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,6EAA6E;IACvE,KAAK,CAAC,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,wBAAwB,CAAC;CAgMvE"}
|
|
@@ -0,0 +1,370 @@
|
|
|
1
|
+
import { ADMIN_PERMISSION_WILDCARD, ERROR_CODES, TASK_REMINDER_GRACE_MS, TASK_REMINDERS_MAX, } from '@endora-commerce/contracts';
|
|
2
|
+
import { HttpError } from '@endora-commerce/platform/http';
|
|
3
|
+
import { rethrowIfModuleDisabled } from '@endora-commerce/platform/kernel';
|
|
4
|
+
import { randomUUID } from 'crypto';
|
|
5
|
+
import { lockedTask } from './task-commands.js';
|
|
6
|
+
import { dueMomentOf } from './reminder-schedule.js';
|
|
7
|
+
import { anyRowExists } from './scheduled-work-probe.js';
|
|
8
|
+
import { actingAdminUserId, isUuid } from './task-access.js';
|
|
9
|
+
import { TASK_AUDIT_OBJECT_TYPE } from './task-history-service.js';
|
|
10
|
+
import { taskLinkPath, taskNotificationText } from './task-notifier.js';
|
|
11
|
+
/** The most (reminder, recipient) pairs one pass handles. The next tick — a minute later — takes the rest. */
|
|
12
|
+
export const TASK_REMINDER_BATCH_SIZE = 200;
|
|
13
|
+
const TASKS_WRITE_PERMISSION = 'tasks:write';
|
|
14
|
+
function reminderInvalid(reason, message) {
|
|
15
|
+
return new HttpError(422, ERROR_CODES.TASK_REMINDER_INVALID, message, [{ path: 'reminder', issue: reason }]);
|
|
16
|
+
}
|
|
17
|
+
function personName(person) {
|
|
18
|
+
return `${person.firstName} ${person.lastName}`.trim() || person.email;
|
|
19
|
+
}
|
|
20
|
+
function isActive(person) {
|
|
21
|
+
return person.status === 'active' && person.deletedAt === null;
|
|
22
|
+
}
|
|
23
|
+
const REMINDER_COLUMNS = `r."id", r."task_id", r."created_by_admin_user_id", r."mode", r."remind_at", r."offset_minutes",
|
|
24
|
+
r."recipient_admin_user_ids", r."created_at",
|
|
25
|
+
not exists (select 1 from unnest(r."recipient_admin_user_ids") as u("admin_user_id")
|
|
26
|
+
where not exists (select 1 from "task_reminder_deliveries" d
|
|
27
|
+
where d."reminder_id" = r."id" and d."admin_user_id" = u."admin_user_id")) as "done"`;
|
|
28
|
+
/**
|
|
29
|
+
* The (reminder, recipient) pairs due at `now` that nobody has handled yet —
|
|
30
|
+
* **the one statement of it**, read by the pass to act and by the probe to ask
|
|
31
|
+
* whether there is anything to act on, so the two cannot drift.
|
|
32
|
+
*/
|
|
33
|
+
function duePairs(now) {
|
|
34
|
+
return {
|
|
35
|
+
from: `from "task_reminders" r
|
|
36
|
+
join "tasks" t on t."id" = r."task_id"
|
|
37
|
+
cross join lateral unnest(r."recipient_admin_user_ids") as u("admin_user_id")
|
|
38
|
+
where r."remind_at" <= ?
|
|
39
|
+
and not exists (select 1 from "task_reminder_deliveries" d
|
|
40
|
+
where d."reminder_id" = r."id" and d."admin_user_id" = u."admin_user_id")`,
|
|
41
|
+
params: [now],
|
|
42
|
+
};
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Reminders on a Task (`specs/165-task-management/` User Story 7, FR-034,
|
|
46
|
+
* FR-035, SC-004; research R-17).
|
|
47
|
+
*
|
|
48
|
+
* **Setting them.** A writer adds a reminder at a moment or some minutes
|
|
49
|
+
* before the due moment (09:00 of a date-only due date in `tasks.time_zone`),
|
|
50
|
+
* for recipients among themselves and the Task's assignees, at most ten per
|
|
51
|
+
* Task; the reminder's creator or any writer removes it. Each is a Command on
|
|
52
|
+
* the Task, so its history shows it. A relative reminder follows the due
|
|
53
|
+
* moment inside the Command that moves it (`reminder-schedule.ts`).
|
|
54
|
+
*
|
|
55
|
+
* **Delivering them — exactly once to the bell, at most once by e-mail.** A
|
|
56
|
+
* pass reads the (reminder, recipient) pairs due and not yet handled, and for
|
|
57
|
+
* each writes one `task_reminder_deliveries` row, whose unique key is the
|
|
58
|
+
* claim:
|
|
59
|
+
*
|
|
60
|
+
* - more than {@link TASK_REMINDER_GRACE_MS} late — after downtime, or while
|
|
61
|
+
* Tasks was off — it is `expired` and nothing is sent, so nothing piles up
|
|
62
|
+
* to be sent later (US7 scenario 6);
|
|
63
|
+
* - a closed Task, a draft, or a recipient who is no longer active, may not
|
|
64
|
+
* read Tasks or may not see this one (its context, a private Task) — it is
|
|
65
|
+
* `skipped` (scenario 4);
|
|
66
|
+
* - otherwise it is `delivered`: the row and the bell entry are written in
|
|
67
|
+
* **one** transaction, through `admin_notifications`' co-transactional
|
|
68
|
+
* `recordWithin`, so a concurrent pass that finds the row taken writes no
|
|
69
|
+
* bell — the bell is exactly once; the e-mail is sent after the commit, with
|
|
70
|
+
* the delivery row as its message id — a crash between the two loses the
|
|
71
|
+
* e-mail, never doubles it.
|
|
72
|
+
*
|
|
73
|
+
* The pass runs in the system scope the worker enters; every statement over a
|
|
74
|
+
* Task-owned table here reads by ids the pass found or `TaskAccess` handed out
|
|
75
|
+
* (`TASK_ACCESS_READERS` names this file). Delivery rows are bookkeeping, not
|
|
76
|
+
* a change to a Task: Commands with no audit entry, as CRM's and Projects'
|
|
77
|
+
* sweeps are.
|
|
78
|
+
*/
|
|
79
|
+
export class TaskReminderService {
|
|
80
|
+
deps;
|
|
81
|
+
constructor(deps) {
|
|
82
|
+
this.deps = deps;
|
|
83
|
+
}
|
|
84
|
+
// --- Setting reminders --------------------------------------------------------
|
|
85
|
+
/** `GET /tasks/:id/reminders` — the caller's own reminders and those that name the caller. */
|
|
86
|
+
async list(taskId) {
|
|
87
|
+
const task = await this.deps.access.loadVisible(taskId);
|
|
88
|
+
return this.forReader(task.id);
|
|
89
|
+
}
|
|
90
|
+
/** The reminders of a Task the caller has already loaded that the caller may be shown (admin-api §1). */
|
|
91
|
+
async forReader(taskId) {
|
|
92
|
+
const me = actingAdminUserId();
|
|
93
|
+
if (me === null)
|
|
94
|
+
return [];
|
|
95
|
+
const rows = (await this.deps.emFactory().execute(`select ${REMINDER_COLUMNS} from "task_reminders" r
|
|
96
|
+
where r."task_id" = ? and (r."created_by_admin_user_id" = ? or ? = any(r."recipient_admin_user_ids"))
|
|
97
|
+
order by r."remind_at", r."created_at", r."id"`, [taskId, me, me]));
|
|
98
|
+
return this.#shape(rows);
|
|
99
|
+
}
|
|
100
|
+
/** `POST /tasks/:id/reminders`. */
|
|
101
|
+
async add(taskId, body) {
|
|
102
|
+
const task = await this.deps.access.loadVisible(taskId);
|
|
103
|
+
this.deps.access.assertMayChange(task);
|
|
104
|
+
const me = actingAdminUserId();
|
|
105
|
+
if (me === null)
|
|
106
|
+
throw new Error('tasks: a reminder is set by an administrator; the ambient actor is none.');
|
|
107
|
+
const assignees = await this.#assigneesOf(task.id);
|
|
108
|
+
const allowed = new Set([me, ...assignees]);
|
|
109
|
+
if (body.recipientIds.some((id) => !allowed.has(id))) {
|
|
110
|
+
throw reminderInvalid('recipients', 'A reminder goes to you or to the task’s assignees, and to nobody else.');
|
|
111
|
+
}
|
|
112
|
+
let remindAt;
|
|
113
|
+
if (body.offsetMinutes !== undefined) {
|
|
114
|
+
const moment = dueMomentOf({ dueOn: task.due_on, dueAt: task.due_at === null ? null : new Date(task.due_at) }, await this.deps.timeZone());
|
|
115
|
+
if (moment === null) {
|
|
116
|
+
throw reminderInvalid('no_due_moment', 'A reminder before the due date needs a task with a due date.');
|
|
117
|
+
}
|
|
118
|
+
remindAt = new Date(moment.getTime() - body.offsetMinutes * 60_000);
|
|
119
|
+
}
|
|
120
|
+
else {
|
|
121
|
+
remindAt = new Date(body.remindAt);
|
|
122
|
+
}
|
|
123
|
+
const id = randomUUID();
|
|
124
|
+
const mode = body.offsetMinutes !== undefined ? 'relative' : 'absolute';
|
|
125
|
+
const offsetMinutes = body.offsetMinutes ?? null;
|
|
126
|
+
await this.deps.commandBus.run({
|
|
127
|
+
action: 'tasks.reminder.add',
|
|
128
|
+
objectType: TASK_AUDIT_OBJECT_TYPE,
|
|
129
|
+
objectId: task.id,
|
|
130
|
+
run: async ({ em }) => {
|
|
131
|
+
const tx = em;
|
|
132
|
+
// Under the Task's lock, so two adds at once cannot both be the tenth.
|
|
133
|
+
await lockedTask(tx, task.id);
|
|
134
|
+
const [{ count }] = (await tx.execute(`select count(*)::int as "count" from "task_reminders" where "task_id" = ?`, [task.id]));
|
|
135
|
+
if (count >= TASK_REMINDERS_MAX) {
|
|
136
|
+
throw reminderInvalid('too_many', `A task has at most ${TASK_REMINDERS_MAX} reminders.`);
|
|
137
|
+
}
|
|
138
|
+
await tx.execute(`insert into "task_reminders" ("id", "task_id", "created_by_admin_user_id", "mode", "remind_at",
|
|
139
|
+
"offset_minutes", "recipient_admin_user_ids", "created_at")
|
|
140
|
+
values (?, ?, ?, ?, ?, ?, ?::uuid[], now())`, [id, task.id, me, mode, remindAt, offsetMinutes, `{${body.recipientIds.join(',')}}`]);
|
|
141
|
+
return {
|
|
142
|
+
result: undefined,
|
|
143
|
+
before: null,
|
|
144
|
+
after: {
|
|
145
|
+
reminderId: id,
|
|
146
|
+
mode,
|
|
147
|
+
remindAt: remindAt.toISOString(),
|
|
148
|
+
offsetMinutes,
|
|
149
|
+
recipientIds: [...body.recipientIds],
|
|
150
|
+
createdById: me,
|
|
151
|
+
},
|
|
152
|
+
};
|
|
153
|
+
},
|
|
154
|
+
});
|
|
155
|
+
const [created] = await this.#byIds(task.id, [id]);
|
|
156
|
+
return created;
|
|
157
|
+
}
|
|
158
|
+
/** `DELETE /tasks/:id/reminders/:reminderId` — the reminder's creator, or a writer. */
|
|
159
|
+
async remove(taskId, reminderId) {
|
|
160
|
+
const task = await this.deps.access.loadVisible(taskId);
|
|
161
|
+
this.deps.access.assertMayChange(task);
|
|
162
|
+
const me = actingAdminUserId();
|
|
163
|
+
const [reminder] = isUuid(reminderId) ? await this.#byIds(task.id, [reminderId]) : [];
|
|
164
|
+
if (!reminder)
|
|
165
|
+
throw new HttpError(404, ERROR_CODES.NOT_FOUND, 'This task has no such reminder.');
|
|
166
|
+
if (reminder.createdBy?.id !== me && !(await this.#mayWrite(me))) {
|
|
167
|
+
throw new HttpError(403, ERROR_CODES.FORBIDDEN, 'Only the person who set this reminder, or a task editor, may remove it.');
|
|
168
|
+
}
|
|
169
|
+
await this.deps.commandBus.run({
|
|
170
|
+
action: 'tasks.reminder.remove',
|
|
171
|
+
objectType: TASK_AUDIT_OBJECT_TYPE,
|
|
172
|
+
objectId: task.id,
|
|
173
|
+
run: async ({ em }) => {
|
|
174
|
+
const deleted = (await em.execute(`delete from "task_reminders" where "id" = ? and "task_id" = ? returning "id"`, [reminder.id, task.id]));
|
|
175
|
+
if (deleted.length === 0)
|
|
176
|
+
return { result: undefined, skipAudit: true };
|
|
177
|
+
return {
|
|
178
|
+
result: undefined,
|
|
179
|
+
before: {
|
|
180
|
+
reminderId: reminder.id,
|
|
181
|
+
mode: reminder.mode,
|
|
182
|
+
remindAt: reminder.remindAt,
|
|
183
|
+
offsetMinutes: reminder.offsetMinutes,
|
|
184
|
+
recipientIds: reminder.recipients.map((r) => r.id),
|
|
185
|
+
createdById: reminder.createdBy?.id ?? null,
|
|
186
|
+
},
|
|
187
|
+
after: null,
|
|
188
|
+
};
|
|
189
|
+
},
|
|
190
|
+
});
|
|
191
|
+
}
|
|
192
|
+
// --- Delivering them ------------------------------------------------------------
|
|
193
|
+
/**
|
|
194
|
+
* Whether a {@link sweep} at `now` would handle anything — **yes or no, and
|
|
195
|
+
* nothing else** (issue #120): asked before the worker opens its system
|
|
196
|
+
* scope, outside any tenant context, over the pass's own row source.
|
|
197
|
+
*/
|
|
198
|
+
async hasWork(now = new Date()) {
|
|
199
|
+
return anyRowExists(this.deps.emFactory(), [duePairs(now)]);
|
|
200
|
+
}
|
|
201
|
+
/** One pass. `now` is the clock, handed in so that a test needs no sleep. */
|
|
202
|
+
async sweep(now = new Date()) {
|
|
203
|
+
const summary = { delivered: 0, skipped: 0, expired: 0, lost: 0 };
|
|
204
|
+
const due = duePairs(now);
|
|
205
|
+
const pairs = (await this.deps.emFactory().execute(`select r."id" as "reminder_id", u."admin_user_id", r."remind_at", t."id" as "task_id", t."number", t."title",
|
|
206
|
+
to_char(t."due_on", 'YYYY-MM-DD') as "due_on", t."due_at", t."is_draft", t."is_private",
|
|
207
|
+
t."created_by_admin_user_id", t."context_type", t."context_id",
|
|
208
|
+
exists (select 1 from "task_statuses" cs
|
|
209
|
+
where cs."code" = t."status" and cs."category" in ('done', 'cancelled')) as "closed"
|
|
210
|
+
${due.from}
|
|
211
|
+
order by r."remind_at", r."id", u."admin_user_id"
|
|
212
|
+
limit ?`, [...due.params, TASK_REMINDER_BATCH_SIZE]));
|
|
213
|
+
if (pairs.length === 0)
|
|
214
|
+
return summary;
|
|
215
|
+
const graceStart = now.getTime() - TASK_REMINDER_GRACE_MS;
|
|
216
|
+
const expired = pairs.filter((pair) => new Date(pair.remind_at).getTime() < graceStart);
|
|
217
|
+
const current = pairs.filter((pair) => new Date(pair.remind_at).getTime() >= graceStart);
|
|
218
|
+
summary.expired += await this.#record(expired, 'expired');
|
|
219
|
+
const people = new Map((await this.deps.adminUsers.findByIds([...new Set(current.map((pair) => pair.admin_user_id))])).map((person) => [
|
|
220
|
+
person.id,
|
|
221
|
+
person,
|
|
222
|
+
]));
|
|
223
|
+
const skipped = [];
|
|
224
|
+
const deliverable = [];
|
|
225
|
+
for (const pair of current) {
|
|
226
|
+
const person = people.get(pair.admin_user_id);
|
|
227
|
+
if (!person || !isActive(person) || pair.closed || pair.is_draft || !(await this.#maySee(pair))) {
|
|
228
|
+
skipped.push(pair);
|
|
229
|
+
}
|
|
230
|
+
else {
|
|
231
|
+
deliverable.push({ pair, person });
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
summary.skipped += await this.#record(skipped, 'skipped');
|
|
235
|
+
const timeZone = deliverable.length > 0 ? await this.deps.timeZone() : null;
|
|
236
|
+
for (const { pair, person } of deliverable) {
|
|
237
|
+
try {
|
|
238
|
+
const deliveryId = await this.#deliver(pair);
|
|
239
|
+
if (deliveryId === null) {
|
|
240
|
+
summary.lost += 1;
|
|
241
|
+
continue;
|
|
242
|
+
}
|
|
243
|
+
summary.delivered += 1;
|
|
244
|
+
await this.deps.email.reminder({
|
|
245
|
+
deliveryId,
|
|
246
|
+
taskId: pair.task_id,
|
|
247
|
+
adminUserId: person.id,
|
|
248
|
+
to: person.email,
|
|
249
|
+
preferredLanguage: person.preferredLanguage ?? null,
|
|
250
|
+
number: pair.number,
|
|
251
|
+
title: pair.title,
|
|
252
|
+
dueOn: pair.due_on,
|
|
253
|
+
dueAt: pair.due_at === null ? null : new Date(pair.due_at),
|
|
254
|
+
timeZone: timeZone,
|
|
255
|
+
});
|
|
256
|
+
}
|
|
257
|
+
catch (error) {
|
|
258
|
+
// A module switched off under a delivery is never absorbed; anything
|
|
259
|
+
// else costs this pair alone — its row was not written, so the next
|
|
260
|
+
// tick takes it again.
|
|
261
|
+
rethrowIfModuleDisabled(error);
|
|
262
|
+
this.deps.log('tasks: delivering a reminder raised', {
|
|
263
|
+
reminderId: pair.reminder_id,
|
|
264
|
+
adminUserId: pair.admin_user_id,
|
|
265
|
+
error: error instanceof Error ? error.message : String(error),
|
|
266
|
+
});
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
return summary;
|
|
270
|
+
}
|
|
271
|
+
/**
|
|
272
|
+
* One delivery: the row — the claim — and the bell entry on one transaction.
|
|
273
|
+
* `null` when the row was there already: another pass delivered it, and this
|
|
274
|
+
* one writes no bell and sends no e-mail.
|
|
275
|
+
*/
|
|
276
|
+
async #deliver(pair) {
|
|
277
|
+
const bell = this.deps.bellPresent();
|
|
278
|
+
return this.deps.commandBus.run({
|
|
279
|
+
action: 'tasks.reminder.deliver',
|
|
280
|
+
objectType: 'task_reminder',
|
|
281
|
+
objectId: pair.reminder_id,
|
|
282
|
+
run: async ({ em }) => {
|
|
283
|
+
const tx = em;
|
|
284
|
+
const inserted = (await tx.execute(`insert into "task_reminder_deliveries" ("id", "reminder_id", "admin_user_id", "outcome", "recorded_at")
|
|
285
|
+
values (?, ?, ?, 'delivered', now())
|
|
286
|
+
on conflict ("reminder_id", "admin_user_id") do nothing
|
|
287
|
+
returning "id"`, [randomUUID(), pair.reminder_id, pair.admin_user_id]));
|
|
288
|
+
const deliveryId = inserted[0]?.id ?? null;
|
|
289
|
+
if (deliveryId !== null && bell) {
|
|
290
|
+
const text = taskNotificationText.reminder(pair.number);
|
|
291
|
+
this.deps.bell.recordWithin(tx, {
|
|
292
|
+
audience: 'admin_user',
|
|
293
|
+
targetAdminUserId: pair.admin_user_id,
|
|
294
|
+
kind: 'tasks.task.reminder',
|
|
295
|
+
subjectType: 'task',
|
|
296
|
+
subjectId: pair.task_id,
|
|
297
|
+
title: text.title,
|
|
298
|
+
titleMessage: text.titleMessage,
|
|
299
|
+
linkPath: taskLinkPath(pair.task_id),
|
|
300
|
+
});
|
|
301
|
+
}
|
|
302
|
+
return { result: deliveryId, skipAudit: true };
|
|
303
|
+
},
|
|
304
|
+
});
|
|
305
|
+
}
|
|
306
|
+
/** Record `pairs` as handled with `outcome` and nothing sent. Answers how many rows this pass wrote. */
|
|
307
|
+
async #record(pairs, outcome) {
|
|
308
|
+
if (pairs.length === 0)
|
|
309
|
+
return 0;
|
|
310
|
+
return this.deps.commandBus.run({
|
|
311
|
+
action: `tasks.reminder.${outcome === 'expired' ? 'expire' : 'skip'}`,
|
|
312
|
+
objectType: 'task_reminder',
|
|
313
|
+
objectId: 'sweep',
|
|
314
|
+
run: async ({ em }) => {
|
|
315
|
+
const values = pairs.map(() => `(?::uuid, ?::uuid, ?::uuid, ?, now())`).join(', ');
|
|
316
|
+
const inserted = (await em.execute(`insert into "task_reminder_deliveries" ("id", "reminder_id", "admin_user_id", "outcome", "recorded_at")
|
|
317
|
+
values ${values}
|
|
318
|
+
on conflict ("reminder_id", "admin_user_id") do nothing
|
|
319
|
+
returning "id"`, pairs.flatMap((pair) => [randomUUID(), pair.reminder_id, pair.admin_user_id, outcome])));
|
|
320
|
+
return { result: inserted.length, skipAudit: true };
|
|
321
|
+
},
|
|
322
|
+
});
|
|
323
|
+
}
|
|
324
|
+
/** Whether the recipient may see the Task now: `tasks:read`, the draft/private rule, the context's say. */
|
|
325
|
+
async #maySee(pair) {
|
|
326
|
+
return this.deps.audience(pair.admin_user_id, {
|
|
327
|
+
created_by_admin_user_id: pair.created_by_admin_user_id,
|
|
328
|
+
is_draft: pair.is_draft,
|
|
329
|
+
is_private: pair.is_private,
|
|
330
|
+
context_type: pair.context_type,
|
|
331
|
+
context_id: pair.context_id,
|
|
332
|
+
});
|
|
333
|
+
}
|
|
334
|
+
// --- Reads --------------------------------------------------------------------
|
|
335
|
+
async #assigneesOf(taskId) {
|
|
336
|
+
const rows = (await this.deps.emFactory().execute(`select "admin_user_id" from "task_assignees" where "task_id" = ?`, [taskId]));
|
|
337
|
+
return rows.map((row) => row.admin_user_id);
|
|
338
|
+
}
|
|
339
|
+
async #byIds(taskId, ids) {
|
|
340
|
+
const rows = (await this.deps.emFactory().execute(`select ${REMINDER_COLUMNS} from "task_reminders" r where r."task_id" = ? and r."id" = any(?::uuid[])`, [taskId, `{${ids.join(',')}}`]));
|
|
341
|
+
return this.#shape(rows);
|
|
342
|
+
}
|
|
343
|
+
async #mayWrite(adminUserId) {
|
|
344
|
+
if (adminUserId === null)
|
|
345
|
+
return false;
|
|
346
|
+
const held = await this.deps.permissions.listPermissions(adminUserId);
|
|
347
|
+
return held.includes(ADMIN_PERMISSION_WILDCARD) || held.includes(TASKS_WRITE_PERMISSION);
|
|
348
|
+
}
|
|
349
|
+
async #shape(rows) {
|
|
350
|
+
const ids = [...new Set(rows.flatMap((row) => [row.created_by_admin_user_id, ...row.recipient_admin_user_ids]))];
|
|
351
|
+
const people = new Map((ids.length > 0 ? await this.deps.adminUsers.findByIds(ids) : []).map((person) => [person.id, person]));
|
|
352
|
+
return rows.map((row) => {
|
|
353
|
+
const creator = people.get(row.created_by_admin_user_id);
|
|
354
|
+
return {
|
|
355
|
+
id: row.id,
|
|
356
|
+
mode: row.mode,
|
|
357
|
+
remindAt: new Date(row.remind_at).toISOString(),
|
|
358
|
+
offsetMinutes: row.offset_minutes === null ? null : Number(row.offset_minutes),
|
|
359
|
+
recipients: row.recipient_admin_user_ids.map((id) => {
|
|
360
|
+
const person = people.get(id);
|
|
361
|
+
return { id, name: person ? personName(person) : '', active: person ? isActive(person) : false };
|
|
362
|
+
}),
|
|
363
|
+
createdBy: creator ? { id: creator.id, name: personName(creator) } : null,
|
|
364
|
+
done: Boolean(row.done),
|
|
365
|
+
createdAt: new Date(row.created_at).toISOString(),
|
|
366
|
+
};
|
|
367
|
+
});
|
|
368
|
+
}
|
|
369
|
+
}
|
|
370
|
+
//# sourceMappingURL=reminder-service.js.map
|