@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,40 @@
|
|
|
1
|
+
import type { OrderListPort, RecordDocumentLookupResponse, TaskDocumentLookupQuery } from '@endora-commerce/contracts';
|
|
2
|
+
import type { OwnerReadChecks } from './owner-read-permissions.js';
|
|
3
|
+
import type { TaskRecordOwners } from './record-owners.js';
|
|
4
|
+
/** How many documents each group of the `@@` list offers for one search (CRM's bound). */
|
|
5
|
+
export declare const DOCUMENT_LIST_GROUP_LIMIT = 10;
|
|
6
|
+
export interface TaskDocumentLookupServiceDeps {
|
|
7
|
+
/** `orders`' list — lazy, resolved per call. `orders` cannot be switched off. */
|
|
8
|
+
orders: OrderListPort;
|
|
9
|
+
/** The one door to Quote Requests, Opportunities and Projects — asked `isPresent` first. */
|
|
10
|
+
owners: Pick<TaskRecordOwners, 'isPresent' | 'search'>;
|
|
11
|
+
/** Tasks the caller may see by number or title — this module's own visibility seam. */
|
|
12
|
+
tasks: (q: string, limit: number) => Promise<ReadonlyArray<{
|
|
13
|
+
id: string;
|
|
14
|
+
number: string;
|
|
15
|
+
title: string;
|
|
16
|
+
}>>;
|
|
17
|
+
mayRead: Pick<OwnerReadChecks, 'orders' | 'quoteRequests' | 'opportunities' | 'projects'>;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* The `@@` document list of a Task's texts (`specs/165-task-management/`
|
|
21
|
+
* FR-005, research R-5; `contracts/admin-api.md` §3
|
|
22
|
+
* `GET /tasks/lookups/documents`) — one grouped answer, Orders · Quote
|
|
23
|
+
* Requests · Tasks · Opportunities · Projects, the shape CRM and Projects
|
|
24
|
+
* serve.
|
|
25
|
+
*
|
|
26
|
+
* A group is in the answer only for a caller holding its owner's read code
|
|
27
|
+
* (`orders:read`, `rfqs:handle`, `crm:read`, `projects:read`; Tasks are the
|
|
28
|
+
* caller's own `tasks:read`) and only while its owner is present: a group
|
|
29
|
+
* nobody may open is not offered empty, it is not offered. A Task belongs to
|
|
30
|
+
* no Organization, so Orders are those within the caller's own reach, and a
|
|
31
|
+
* Quote Request is offered only by its number typed in full. Presence is
|
|
32
|
+
* decided before each switchable owner is asked; nothing is caught.
|
|
33
|
+
*/
|
|
34
|
+
export declare class TaskDocumentLookupService {
|
|
35
|
+
#private;
|
|
36
|
+
private readonly deps;
|
|
37
|
+
constructor(deps: TaskDocumentLookupServiceDeps);
|
|
38
|
+
documents(query: TaskDocumentLookupQuery): Promise<RecordDocumentLookupResponse>;
|
|
39
|
+
}
|
|
40
|
+
//# sourceMappingURL=document-lookup-service.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"document-lookup-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/document-lookup-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAGb,4BAA4B,EAC5B,uBAAuB,EACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAwB,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,0FAA0F;AAC1F,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,MAAM,WAAW,6BAA6B;IAC5C,iFAAiF;IACjF,MAAM,EAAE,aAAa,CAAC;IACtB,4FAA4F;IAC5F,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,QAAQ,CAAC,CAAC;IACvD,uFAAuF;IACvF,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAC3G,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,eAAe,GAAG,eAAe,GAAG,UAAU,CAAC,CAAC;CAC3F;AAWD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,yBAAyB;;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,6BAA6B;IAE1D,SAAS,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,4BAA4B,CAAC;CAoCvF"}
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
/** How many documents each group of the `@@` list offers for one search (CRM's bound). */
|
|
2
|
+
export const DOCUMENT_LIST_GROUP_LIMIT = 10;
|
|
3
|
+
const SWITCHABLE_GROUPS = [
|
|
4
|
+
{ kind: 'quote_request', check: 'quoteRequests' },
|
|
5
|
+
{ kind: 'opportunity', check: 'opportunities' },
|
|
6
|
+
{ kind: 'project', check: 'projects' },
|
|
7
|
+
];
|
|
8
|
+
/**
|
|
9
|
+
* The `@@` document list of a Task's texts (`specs/165-task-management/`
|
|
10
|
+
* FR-005, research R-5; `contracts/admin-api.md` §3
|
|
11
|
+
* `GET /tasks/lookups/documents`) — one grouped answer, Orders · Quote
|
|
12
|
+
* Requests · Tasks · Opportunities · Projects, the shape CRM and Projects
|
|
13
|
+
* serve.
|
|
14
|
+
*
|
|
15
|
+
* A group is in the answer only for a caller holding its owner's read code
|
|
16
|
+
* (`orders:read`, `rfqs:handle`, `crm:read`, `projects:read`; Tasks are the
|
|
17
|
+
* caller's own `tasks:read`) and only while its owner is present: a group
|
|
18
|
+
* nobody may open is not offered empty, it is not offered. A Task belongs to
|
|
19
|
+
* no Organization, so Orders are those within the caller's own reach, and a
|
|
20
|
+
* Quote Request is offered only by its number typed in full. Presence is
|
|
21
|
+
* decided before each switchable owner is asked; nothing is caught.
|
|
22
|
+
*/
|
|
23
|
+
export class TaskDocumentLookupService {
|
|
24
|
+
deps;
|
|
25
|
+
constructor(deps) {
|
|
26
|
+
this.deps = deps;
|
|
27
|
+
}
|
|
28
|
+
async documents(query) {
|
|
29
|
+
const q = (query.q ?? '').trim();
|
|
30
|
+
const [orders, tasks, ...switchable] = await Promise.all([
|
|
31
|
+
this.deps.mayRead.orders().then((may) => (may ? this.#orders(q) : null)),
|
|
32
|
+
this.deps
|
|
33
|
+
.tasks(q, DOCUMENT_LIST_GROUP_LIMIT)
|
|
34
|
+
.then((found) => found.map((task) => ({ id: task.id, label: task.number, sublabel: task.title }))),
|
|
35
|
+
...SWITCHABLE_GROUPS.map(async ({ kind, check }) => {
|
|
36
|
+
if (!this.deps.owners.isPresent(kind))
|
|
37
|
+
return null;
|
|
38
|
+
if (!(await this.deps.mayRead[check]()))
|
|
39
|
+
return null;
|
|
40
|
+
const found = await this.deps.owners.search(kind, q, DOCUMENT_LIST_GROUP_LIMIT);
|
|
41
|
+
return found.map((record) => ({
|
|
42
|
+
id: record.id,
|
|
43
|
+
label: record.label,
|
|
44
|
+
...(record.sublabel ? { sublabel: record.sublabel } : {}),
|
|
45
|
+
}));
|
|
46
|
+
}),
|
|
47
|
+
]);
|
|
48
|
+
const [quoteRequests, opportunities, projects] = switchable;
|
|
49
|
+
const groups = [];
|
|
50
|
+
const push = (kind, items) => {
|
|
51
|
+
if (items)
|
|
52
|
+
groups.push({ kind, items });
|
|
53
|
+
};
|
|
54
|
+
push('order', orders);
|
|
55
|
+
push('quote_request', quoteRequests);
|
|
56
|
+
push('task', tasks);
|
|
57
|
+
push('opportunity', opportunities);
|
|
58
|
+
push('project', projects);
|
|
59
|
+
return { groups };
|
|
60
|
+
}
|
|
61
|
+
/** Orders by number within the caller's reach, newest placed first — `orders`' own list. */
|
|
62
|
+
async #orders(q) {
|
|
63
|
+
const page = await this.deps.orders.list({ ...(q !== '' ? { q } : {}), page: 1, pageSize: DOCUMENT_LIST_GROUP_LIMIT });
|
|
64
|
+
return page.rows.map((row) => ({ id: row.id, label: row.businessId }));
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
//# sourceMappingURL=document-lookup-service.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"document-lookup-service.js","sourceRoot":"","sources":["../../../src/backend/services/document-lookup-service.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
import type { EntityManager } from '@mikro-orm/postgresql';
|
|
2
|
+
import type { Command, CommandBus } from '@endora-commerce/platform/commands';
|
|
3
|
+
import type { TaskAccess, TaskRow } from './task-access.js';
|
|
4
|
+
/**
|
|
5
|
+
* The sub-task hierarchy (`specs/165-task-management/` User Story 5, FR-027,
|
|
6
|
+
* FR-029, research R-15).
|
|
7
|
+
*
|
|
8
|
+
* **One lock for every change of the hierarchy.** A parent change, a Task
|
|
9
|
+
* created under a parent and a Task deleted with sub-tasks each take
|
|
10
|
+
* `pg_advisory_xact_lock(hashtext('tasks.hierarchy'))` inside their Command's
|
|
11
|
+
* transaction before reading anything, then read the chain and the sub-tree
|
|
12
|
+
* they decide on. Two changes that would only together form a cycle — `a`
|
|
13
|
+
* under `b` and `b` under `a` — therefore run one after the other, and the
|
|
14
|
+
* second reads what the first committed and is refused. Parent changes are
|
|
15
|
+
* rare, so one platform-wide lock is cheaper to reason about than row locks on
|
|
16
|
+
* two branches.
|
|
17
|
+
*
|
|
18
|
+
* **The rules are about the structure, not the reader** (`domain/hierarchy.ts`):
|
|
19
|
+
* the chain and the sub-tree are read over every Task, whoever may see it, by
|
|
20
|
+
* ids the caller obtained through `TaskAccess` — the Task being moved and the
|
|
21
|
+
* parent it asked for — so a hidden descendant still closes a cycle. What the
|
|
22
|
+
* reader is told is the refusal, never a Task.
|
|
23
|
+
*
|
|
24
|
+
* **Who may change it.** The Task that moves is the caller's to change
|
|
25
|
+
* (`assertMayChange`); so is the parent it goes under — hanging a Task under
|
|
26
|
+
* somebody else's private Task changes what that Task shows. A parent the
|
|
27
|
+
* caller may not see is 404 `TASK_NOT_FOUND`, as one that does not exist.
|
|
28
|
+
*/
|
|
29
|
+
/** Serialises every change of the sub-task hierarchy (R-15). */
|
|
30
|
+
export declare function lockHierarchy(em: EntityManager): Promise<void>;
|
|
31
|
+
/**
|
|
32
|
+
* Refuse `taskId` (or a Task being created, `null`) as a sub-task of
|
|
33
|
+
* `parentId` when that would close a cycle or nest too deep. Run inside a
|
|
34
|
+
* Command, **after** {@link lockHierarchy}. A parent deleted meanwhile is
|
|
35
|
+
* 404 `TASK_NOT_FOUND`.
|
|
36
|
+
*/
|
|
37
|
+
export declare function assertParentFits(em: EntityManager, taskId: string | null, parentId: string): Promise<void>;
|
|
38
|
+
/**
|
|
39
|
+
* `tasks.task.parent_change` — `parentTaskId` set or cleared, under the
|
|
40
|
+
* hierarchy lock. `false` when the Task already has that parent (nothing
|
|
41
|
+
* written, nothing audited). The audit state names the parent by id only:
|
|
42
|
+
* the trail is not tenant-scoped, and a reader of this Task's history need
|
|
43
|
+
* not be one who may see the parent.
|
|
44
|
+
*/
|
|
45
|
+
export declare function changeTaskParentCommand(id: string, parentId: string | null): Command<boolean>;
|
|
46
|
+
export interface TaskHierarchyServiceDeps {
|
|
47
|
+
commandBus: CommandBus;
|
|
48
|
+
access: Pick<TaskAccess, 'loadVisible' | 'assertMayChange'>;
|
|
49
|
+
}
|
|
50
|
+
export declare class TaskHierarchyService {
|
|
51
|
+
private readonly deps;
|
|
52
|
+
constructor(deps: TaskHierarchyServiceDeps);
|
|
53
|
+
/**
|
|
54
|
+
* A parent the caller may hang a Task under: one they may see (404
|
|
55
|
+
* otherwise) and change (403 `TASK_PRIVATE_READ_ONLY` for somebody else's
|
|
56
|
+
* private Task). The structure is checked by the writing Command.
|
|
57
|
+
*/
|
|
58
|
+
assertMayAdopt(parentId: string): Promise<void>;
|
|
59
|
+
/**
|
|
60
|
+
* Make `row` — a Task the caller loaded through `TaskAccess` and may change
|
|
61
|
+
* — a sub-task of `parentId`, or top-level with `null`. `false` when nothing
|
|
62
|
+
* changed.
|
|
63
|
+
*/
|
|
64
|
+
setParent(row: TaskRow, parentId: string | null): Promise<boolean>;
|
|
65
|
+
}
|
|
66
|
+
//# sourceMappingURL=hierarchy-service.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hierarchy-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/hierarchy-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAI9E,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAI5D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,gEAAgE;AAChE,wBAAsB,aAAa,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpE;AAiBD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsChH;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAiB7F;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,UAAU,CAAC;IACvB,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,iBAAiB,CAAC,CAAC;CAC7D;AAED,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,wBAAwB;IAE3D;;;;OAIG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD;;;;OAIG;IACG,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;CAKzE"}
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
import { LockMode } from '@mikro-orm/core';
|
|
2
|
+
import { ERROR_CODES, TASK_HIERARCHY_DEPTH_MAX } from '@endora-commerce/contracts';
|
|
3
|
+
import { HttpError } from '@endora-commerce/platform/http';
|
|
4
|
+
import { parentChangeRefusal } from '../domain/hierarchy.js';
|
|
5
|
+
import { Task } from '../entities/task.entity.js';
|
|
6
|
+
import { taskNotFound } from './task-errors.js';
|
|
7
|
+
import { TASK_AUDIT_OBJECT_TYPE } from './task-history-service.js';
|
|
8
|
+
/**
|
|
9
|
+
* The sub-task hierarchy (`specs/165-task-management/` User Story 5, FR-027,
|
|
10
|
+
* FR-029, research R-15).
|
|
11
|
+
*
|
|
12
|
+
* **One lock for every change of the hierarchy.** A parent change, a Task
|
|
13
|
+
* created under a parent and a Task deleted with sub-tasks each take
|
|
14
|
+
* `pg_advisory_xact_lock(hashtext('tasks.hierarchy'))` inside their Command's
|
|
15
|
+
* transaction before reading anything, then read the chain and the sub-tree
|
|
16
|
+
* they decide on. Two changes that would only together form a cycle — `a`
|
|
17
|
+
* under `b` and `b` under `a` — therefore run one after the other, and the
|
|
18
|
+
* second reads what the first committed and is refused. Parent changes are
|
|
19
|
+
* rare, so one platform-wide lock is cheaper to reason about than row locks on
|
|
20
|
+
* two branches.
|
|
21
|
+
*
|
|
22
|
+
* **The rules are about the structure, not the reader** (`domain/hierarchy.ts`):
|
|
23
|
+
* the chain and the sub-tree are read over every Task, whoever may see it, by
|
|
24
|
+
* ids the caller obtained through `TaskAccess` — the Task being moved and the
|
|
25
|
+
* parent it asked for — so a hidden descendant still closes a cycle. What the
|
|
26
|
+
* reader is told is the refusal, never a Task.
|
|
27
|
+
*
|
|
28
|
+
* **Who may change it.** The Task that moves is the caller's to change
|
|
29
|
+
* (`assertMayChange`); so is the parent it goes under — hanging a Task under
|
|
30
|
+
* somebody else's private Task changes what that Task shows. A parent the
|
|
31
|
+
* caller may not see is 404 `TASK_NOT_FOUND`, as one that does not exist.
|
|
32
|
+
*/
|
|
33
|
+
/** Serialises every change of the sub-task hierarchy (R-15). */
|
|
34
|
+
export async function lockHierarchy(em) {
|
|
35
|
+
await em.execute(`select pg_advisory_xact_lock(hashtext('tasks.hierarchy'))`);
|
|
36
|
+
}
|
|
37
|
+
function refused(reason) {
|
|
38
|
+
return reason === 'cycle'
|
|
39
|
+
? new HttpError(422, ERROR_CODES.TASK_PARENT_CYCLE, 'A task cannot be a sub-task of itself or of one of its own sub-tasks.')
|
|
40
|
+
: new HttpError(422, ERROR_CODES.TASK_HIERARCHY_TOO_DEEP, `Sub-tasks can be nested at most ${TASK_HIERARCHY_DEPTH_MAX} levels deep.`, { maxDepth: TASK_HIERARCHY_DEPTH_MAX });
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Refuse `taskId` (or a Task being created, `null`) as a sub-task of
|
|
44
|
+
* `parentId` when that would close a cycle or nest too deep. Run inside a
|
|
45
|
+
* Command, **after** {@link lockHierarchy}. A parent deleted meanwhile is
|
|
46
|
+
* 404 `TASK_NOT_FOUND`.
|
|
47
|
+
*/
|
|
48
|
+
export async function assertParentFits(em, taskId, parentId) {
|
|
49
|
+
// The parent and its ancestors, the parent first. Bounded, so a chain that
|
|
50
|
+
// is already too deep — or a cycle no write could have made — still ends.
|
|
51
|
+
const chain = (await em.execute(`with recursive "chain"("id", "parent_task_id", "level") as (
|
|
52
|
+
select t."id", t."parent_task_id", 1 from "tasks" t where t."id" = ?
|
|
53
|
+
union all
|
|
54
|
+
select p."id", p."parent_task_id", c."level" + 1
|
|
55
|
+
from "tasks" p join "chain" c on p."id" = c."parent_task_id"
|
|
56
|
+
where c."level" <= ?
|
|
57
|
+
)
|
|
58
|
+
select "id" from "chain" order by "level" asc`, [parentId, TASK_HIERARCHY_DEPTH_MAX]));
|
|
59
|
+
if (chain.length === 0)
|
|
60
|
+
throw taskNotFound();
|
|
61
|
+
let subtreeHeight = 1;
|
|
62
|
+
if (taskId !== null) {
|
|
63
|
+
const [row] = (await em.execute(`with recursive "tree"("id", "level") as (
|
|
64
|
+
select t."id", 1 from "tasks" t where t."id" = ?
|
|
65
|
+
union all
|
|
66
|
+
select c."id", tr."level" + 1
|
|
67
|
+
from "tasks" c join "tree" tr on c."parent_task_id" = tr."id"
|
|
68
|
+
where tr."level" <= ?
|
|
69
|
+
)
|
|
70
|
+
select max("level")::int as "height" from "tree"`, [taskId, TASK_HIERARCHY_DEPTH_MAX]));
|
|
71
|
+
subtreeHeight = Number(row?.height ?? 1);
|
|
72
|
+
}
|
|
73
|
+
const refusal = parentChangeRefusal(taskId, parentId, { parentChain: chain.map((link) => link.id), subtreeHeight });
|
|
74
|
+
if (refusal)
|
|
75
|
+
throw refused(refusal);
|
|
76
|
+
}
|
|
77
|
+
/**
|
|
78
|
+
* `tasks.task.parent_change` — `parentTaskId` set or cleared, under the
|
|
79
|
+
* hierarchy lock. `false` when the Task already has that parent (nothing
|
|
80
|
+
* written, nothing audited). The audit state names the parent by id only:
|
|
81
|
+
* the trail is not tenant-scoped, and a reader of this Task's history need
|
|
82
|
+
* not be one who may see the parent.
|
|
83
|
+
*/
|
|
84
|
+
export function changeTaskParentCommand(id, parentId) {
|
|
85
|
+
return {
|
|
86
|
+
action: 'tasks.task.parent_change',
|
|
87
|
+
objectType: TASK_AUDIT_OBJECT_TYPE,
|
|
88
|
+
objectId: id,
|
|
89
|
+
run: async ({ em }) => {
|
|
90
|
+
const tx = em;
|
|
91
|
+
await lockHierarchy(tx);
|
|
92
|
+
const task = await tx.findOne(Task, { id }, { lockMode: LockMode.PESSIMISTIC_WRITE });
|
|
93
|
+
if (!task)
|
|
94
|
+
throw taskNotFound();
|
|
95
|
+
const current = task.parentTaskId ?? null;
|
|
96
|
+
if (current === parentId)
|
|
97
|
+
return { result: false, skipAudit: true };
|
|
98
|
+
if (parentId !== null)
|
|
99
|
+
await assertParentFits(tx, id, parentId);
|
|
100
|
+
task.parentTaskId = parentId;
|
|
101
|
+
return { result: true, before: { parentTaskId: current }, after: { parentTaskId: parentId } };
|
|
102
|
+
},
|
|
103
|
+
};
|
|
104
|
+
}
|
|
105
|
+
export class TaskHierarchyService {
|
|
106
|
+
deps;
|
|
107
|
+
constructor(deps) {
|
|
108
|
+
this.deps = deps;
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* A parent the caller may hang a Task under: one they may see (404
|
|
112
|
+
* otherwise) and change (403 `TASK_PRIVATE_READ_ONLY` for somebody else's
|
|
113
|
+
* private Task). The structure is checked by the writing Command.
|
|
114
|
+
*/
|
|
115
|
+
async assertMayAdopt(parentId) {
|
|
116
|
+
const parent = await this.deps.access.loadVisible(parentId);
|
|
117
|
+
this.deps.access.assertMayChange(parent);
|
|
118
|
+
}
|
|
119
|
+
/**
|
|
120
|
+
* Make `row` — a Task the caller loaded through `TaskAccess` and may change
|
|
121
|
+
* — a sub-task of `parentId`, or top-level with `null`. `false` when nothing
|
|
122
|
+
* changed.
|
|
123
|
+
*/
|
|
124
|
+
async setParent(row, parentId) {
|
|
125
|
+
if ((row.parent_task_id ?? null) === parentId)
|
|
126
|
+
return false;
|
|
127
|
+
if (parentId !== null && parentId !== row.id)
|
|
128
|
+
await this.assertMayAdopt(parentId);
|
|
129
|
+
return this.deps.commandBus.run(changeTaskParentCommand(row.id, parentId));
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
//# sourceMappingURL=hierarchy-service.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hierarchy-service.js","sourceRoot":"","sources":["../../../src/backend/services/hierarchy-service.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import type { EntityManager } from '@mikro-orm/postgresql';
|
|
2
|
+
import type { CommandBus } from '@endora-commerce/platform/commands';
|
|
3
|
+
import type { AuditPort } from '@endora-commerce/platform/kernel';
|
|
4
|
+
import type { TaskContextRegistry } from './task-context-registry.js';
|
|
5
|
+
/**
|
|
6
|
+
* The maintenance pass — Tasks never stay orphaned (`specs/165-task-management/`
|
|
7
|
+
* research R-19, FR-040, SC-006; issue #450).
|
|
8
|
+
*
|
|
9
|
+
* A context's owner deletes its record's Tasks through `taskWritePort` only
|
|
10
|
+
* while Tasks is on; a Project deleted while Tasks was off keeps its Tasks,
|
|
11
|
+
* hidden for good, and a Stage deleted then keeps its Tasks in a group no
|
|
12
|
+
* screen shows. This pass, the third of the `tasks-reminders` tick, at most
|
|
13
|
+
* every fifteen minutes, asks each owner which of its contexts still exist:
|
|
14
|
+
*
|
|
15
|
+
* - the Tasks of a context that is gone are deleted, one `tasks.task.delete`
|
|
16
|
+
* Command each, as the system, `reason: 'context_gone'` — their sub-tasks
|
|
17
|
+
* become top-level as on any deletion, and `tasks.task.deleted.v1` goes out;
|
|
18
|
+
* - the Tasks of a group that is gone lose it, one `tasks.task.update` each,
|
|
19
|
+
* `reason: 'context_group_gone'`.
|
|
20
|
+
*
|
|
21
|
+
* **Only present owners that implement `existingContexts` are asked.**
|
|
22
|
+
* `registry.present()` leaves out an owner that is off, so a Project whose
|
|
23
|
+
* module is off is never taken for deleted (FR-040), and an owner without the
|
|
24
|
+
* method is never cleaned. The owner's answer is **regardless of who may see**
|
|
25
|
+
* — which is why the pass runs only in the system scope its worker enters, and
|
|
26
|
+
* the owner refuses anybody else.
|
|
27
|
+
*
|
|
28
|
+
* Contexts are walked by id, {@link MAINTENANCE_BATCH} distinct ids of one type
|
|
29
|
+
* at a time, so a pass's memory does not grow with the table. Every write
|
|
30
|
+
* re-reads its Task under the lock and leaves one that moved meanwhile.
|
|
31
|
+
*
|
|
32
|
+
* Reads of `tasks` here are the platform-wide sweep's own: it learns ids, never
|
|
33
|
+
* hands a Task to anybody, and writes only through the Task Commands.
|
|
34
|
+
*/
|
|
35
|
+
/** Distinct context ids asked of an owner at once. */
|
|
36
|
+
export declare const MAINTENANCE_BATCH = 500;
|
|
37
|
+
export interface TaskMaintenanceServiceDeps {
|
|
38
|
+
emFactory: () => EntityManager;
|
|
39
|
+
commandBus: CommandBus;
|
|
40
|
+
contexts: Pick<TaskContextRegistry, 'present'>;
|
|
41
|
+
/** The kernel's audit port — a deleted Task's former sub-tasks each record why they lost their parent. */
|
|
42
|
+
auditLog: AuditPort;
|
|
43
|
+
}
|
|
44
|
+
export interface TaskMaintenancePassSummary {
|
|
45
|
+
deleted: number;
|
|
46
|
+
ungrouped: number;
|
|
47
|
+
}
|
|
48
|
+
export declare class TaskMaintenanceService {
|
|
49
|
+
#private;
|
|
50
|
+
private readonly deps;
|
|
51
|
+
constructor(deps: TaskMaintenanceServiceDeps);
|
|
52
|
+
/**
|
|
53
|
+
* Whether a pass could have anything to do — yes or no, outside any scope
|
|
54
|
+
* (issue #120): some Task has a context of a type an owner able to answer
|
|
55
|
+
* registered. No such owner present: no question at all.
|
|
56
|
+
*/
|
|
57
|
+
hasWork(): Promise<boolean>;
|
|
58
|
+
/** One pass, in the system scope. */
|
|
59
|
+
pass(): Promise<TaskMaintenancePassSummary>;
|
|
60
|
+
}
|
|
61
|
+
//# sourceMappingURL=maintenance-service.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"maintenance-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/maintenance-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAGlE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,sDAAsD;AACtD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;IAC/C,0GAA0G;IAC1G,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,qBAAa,sBAAsB;;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,0BAA0B;IAO7D;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAQjC,qCAAqC;IAC/B,IAAI,IAAI,OAAO,CAAC,0BAA0B,CAAC;CA6ElD"}
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
import { anyRowExists } from './scheduled-work-probe.js';
|
|
2
|
+
import { deleteTaskCommand, ungroupTaskCommand } from './task-commands.js';
|
|
3
|
+
/**
|
|
4
|
+
* The maintenance pass — Tasks never stay orphaned (`specs/165-task-management/`
|
|
5
|
+
* research R-19, FR-040, SC-006; issue #450).
|
|
6
|
+
*
|
|
7
|
+
* A context's owner deletes its record's Tasks through `taskWritePort` only
|
|
8
|
+
* while Tasks is on; a Project deleted while Tasks was off keeps its Tasks,
|
|
9
|
+
* hidden for good, and a Stage deleted then keeps its Tasks in a group no
|
|
10
|
+
* screen shows. This pass, the third of the `tasks-reminders` tick, at most
|
|
11
|
+
* every fifteen minutes, asks each owner which of its contexts still exist:
|
|
12
|
+
*
|
|
13
|
+
* - the Tasks of a context that is gone are deleted, one `tasks.task.delete`
|
|
14
|
+
* Command each, as the system, `reason: 'context_gone'` — their sub-tasks
|
|
15
|
+
* become top-level as on any deletion, and `tasks.task.deleted.v1` goes out;
|
|
16
|
+
* - the Tasks of a group that is gone lose it, one `tasks.task.update` each,
|
|
17
|
+
* `reason: 'context_group_gone'`.
|
|
18
|
+
*
|
|
19
|
+
* **Only present owners that implement `existingContexts` are asked.**
|
|
20
|
+
* `registry.present()` leaves out an owner that is off, so a Project whose
|
|
21
|
+
* module is off is never taken for deleted (FR-040), and an owner without the
|
|
22
|
+
* method is never cleaned. The owner's answer is **regardless of who may see**
|
|
23
|
+
* — which is why the pass runs only in the system scope its worker enters, and
|
|
24
|
+
* the owner refuses anybody else.
|
|
25
|
+
*
|
|
26
|
+
* Contexts are walked by id, {@link MAINTENANCE_BATCH} distinct ids of one type
|
|
27
|
+
* at a time, so a pass's memory does not grow with the table. Every write
|
|
28
|
+
* re-reads its Task under the lock and leaves one that moved meanwhile.
|
|
29
|
+
*
|
|
30
|
+
* Reads of `tasks` here are the platform-wide sweep's own: it learns ids, never
|
|
31
|
+
* hands a Task to anybody, and writes only through the Task Commands.
|
|
32
|
+
*/
|
|
33
|
+
/** Distinct context ids asked of an owner at once. */
|
|
34
|
+
export const MAINTENANCE_BATCH = 500;
|
|
35
|
+
export class TaskMaintenanceService {
|
|
36
|
+
deps;
|
|
37
|
+
constructor(deps) {
|
|
38
|
+
this.deps = deps;
|
|
39
|
+
}
|
|
40
|
+
/** The present owners that can say which of their contexts exist. */
|
|
41
|
+
#cleanable() {
|
|
42
|
+
return this.deps.contexts.present().filter((d) => typeof d.existingContexts === 'function');
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Whether a pass could have anything to do — yes or no, outside any scope
|
|
46
|
+
* (issue #120): some Task has a context of a type an owner able to answer
|
|
47
|
+
* registered. No such owner present: no question at all.
|
|
48
|
+
*/
|
|
49
|
+
async hasWork() {
|
|
50
|
+
const types = this.#cleanable().map((d) => d.contextType);
|
|
51
|
+
if (types.length === 0)
|
|
52
|
+
return false;
|
|
53
|
+
return anyRowExists(this.deps.emFactory(), [
|
|
54
|
+
{ from: `from "tasks" where "context_type" in (${types.map(() => '?').join(', ')})`, params: types },
|
|
55
|
+
]);
|
|
56
|
+
}
|
|
57
|
+
/** One pass, in the system scope. */
|
|
58
|
+
async pass() {
|
|
59
|
+
const summary = { deleted: 0, ungrouped: 0 };
|
|
60
|
+
for (const owner of this.#cleanable()) {
|
|
61
|
+
let after = null;
|
|
62
|
+
for (;;) {
|
|
63
|
+
const ids = await this.#contextIds(owner.contextType, after);
|
|
64
|
+
if (ids.length === 0)
|
|
65
|
+
break;
|
|
66
|
+
after = ids[ids.length - 1];
|
|
67
|
+
const existing = await owner.existingContexts(ids);
|
|
68
|
+
const gone = ids.filter((id) => !existing.has(id));
|
|
69
|
+
summary.deleted += await this.#deleteIn(owner.contextType, gone);
|
|
70
|
+
summary.ungrouped += await this.#ungroupIn(owner.contextType, ids.filter((id) => existing.has(id)), existing);
|
|
71
|
+
if (ids.length < MAINTENANCE_BATCH)
|
|
72
|
+
break;
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
return summary;
|
|
76
|
+
}
|
|
77
|
+
/** The next batch of distinct context ids of `contextType`, in id order, after `after`. */
|
|
78
|
+
async #contextIds(contextType, after) {
|
|
79
|
+
const rows = (await this.deps.emFactory().execute(`select distinct "context_id" from "tasks"
|
|
80
|
+
where "context_type" = ? and "context_id" is not null${after === null ? '' : ' and "context_id" > ?'}
|
|
81
|
+
order by "context_id" limit ?`, after === null ? [contextType, MAINTENANCE_BATCH] : [contextType, after, MAINTENANCE_BATCH]));
|
|
82
|
+
return rows.map((row) => row.context_id);
|
|
83
|
+
}
|
|
84
|
+
/** Delete every Task of the gone contexts, each by its own Command. */
|
|
85
|
+
async #deleteIn(contextType, gone) {
|
|
86
|
+
if (gone.length === 0)
|
|
87
|
+
return 0;
|
|
88
|
+
const doomed = (await this.deps.emFactory().execute(`select "id", "context_id" from "tasks"
|
|
89
|
+
where "context_type" = ? and "context_id" = any(?::uuid[]) order by "created_at", "id"`, [contextType, `{${gone.join(',')}}`]));
|
|
90
|
+
let deleted = 0;
|
|
91
|
+
for (const task of doomed) {
|
|
92
|
+
const result = await this.deps.commandBus.run(deleteTaskCommand(task.id, this.deps.auditLog, {
|
|
93
|
+
reason: 'context_gone',
|
|
94
|
+
onlyIn: { contextType, contextId: task.context_id },
|
|
95
|
+
}));
|
|
96
|
+
if (result.deleted)
|
|
97
|
+
deleted += 1;
|
|
98
|
+
}
|
|
99
|
+
return deleted;
|
|
100
|
+
}
|
|
101
|
+
/** Take the gone groups off the Tasks of the contexts that exist. */
|
|
102
|
+
async #ungroupIn(contextType, kept, existing) {
|
|
103
|
+
if (kept.length === 0)
|
|
104
|
+
return 0;
|
|
105
|
+
const grouped = (await this.deps.emFactory().execute(`select "id", "context_id", "context_group_id" from "tasks"
|
|
106
|
+
where "context_type" = ? and "context_id" = any(?::uuid[]) and "context_group_id" is not null
|
|
107
|
+
order by "id"`, [contextType, `{${kept.join(',')}}`]));
|
|
108
|
+
let ungrouped = 0;
|
|
109
|
+
for (const task of grouped) {
|
|
110
|
+
if (existing.get(task.context_id)?.has(task.context_group_id))
|
|
111
|
+
continue;
|
|
112
|
+
const changed = await this.deps.commandBus.run(ungroupTaskCommand(task.id, { contextType, contextId: task.context_id, contextGroupId: task.context_group_id }));
|
|
113
|
+
if (changed)
|
|
114
|
+
ungrouped += 1;
|
|
115
|
+
}
|
|
116
|
+
return ungrouped;
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
//# sourceMappingURL=maintenance-service.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"maintenance-service.js","sourceRoot":"","sources":["../../../src/backend/services/maintenance-service.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import { type AdminUserReadPort, type PermissionReadPort, type TaskAssigneeOption } from '@endora-commerce/contracts';
|
|
2
|
+
import { type TaskAccess, type TaskRow } from './task-access.js';
|
|
3
|
+
import type { TaskContextRegistry } from './task-context-registry.js';
|
|
4
|
+
import { type TaskNotifier } from './task-notifier.js';
|
|
5
|
+
/** How many people the mention list offers for one search (admin-api §3). */
|
|
6
|
+
export declare const MENTIONABLE_LIMIT = 20;
|
|
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 declare function newlyMentioned(previous: string | null | undefined, next: string | null | undefined): string[];
|
|
13
|
+
/** What is asked about a Task when deciding whether somebody else may see it. */
|
|
14
|
+
export type TaskAudienceFacts = Pick<TaskRow, 'created_by_admin_user_id' | 'is_draft' | 'is_private' | 'context_type' | 'context_id'>;
|
|
15
|
+
export interface TaskAudienceDeps {
|
|
16
|
+
permissions: PermissionReadPort;
|
|
17
|
+
contexts: Pick<TaskContextRegistry, 'presentFor'>;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Whether **another** administrator may see a Task — who may be assigned,
|
|
21
|
+
* mentioned or told about it (`specs/165-task-management/` R-3, R-5; 163
|
|
22
|
+
* F-14). They must hold `tasks:read`; a draft is its Creator's alone; a private
|
|
23
|
+
* Task is its Creator's alone here (nobody is mentioned in one, research R-5);
|
|
24
|
+
* a Task in a context needs the context's owner to say yes (`canSeeAs`), and an
|
|
25
|
+
* owner that is not present vouches for nobody.
|
|
26
|
+
*/
|
|
27
|
+
export declare function createTaskAudience(deps: TaskAudienceDeps): (adminUserId: string, task: TaskAudienceFacts) => Promise<boolean>;
|
|
28
|
+
export type TaskAudience = ReturnType<typeof createTaskAudience>;
|
|
29
|
+
export interface TaskMentionServiceDeps {
|
|
30
|
+
access: Pick<TaskAccess, 'loadVisible'>;
|
|
31
|
+
audience: TaskAudience;
|
|
32
|
+
/** Ports of other modules — lazy, resolved per call, never captured. */
|
|
33
|
+
adminUsers: AdminUserReadPort;
|
|
34
|
+
permissions: PermissionReadPort;
|
|
35
|
+
notifier: Pick<TaskNotifier, 'mentioned'>;
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* People mentioned in a Task's description (and, from User Story 4, its
|
|
39
|
+
* comments) — `specs/165-task-management/` FR-006, research R-5; Projects'
|
|
40
|
+
* `mention-service.ts`, the model.
|
|
41
|
+
*
|
|
42
|
+
* **Who may be mentioned** is somebody who may see the Task: an active
|
|
43
|
+
* administrator holding `tasks:read` who passes {@link createTaskAudience}. On
|
|
44
|
+
* the create form, before there is a Task, the holders of `tasks:read`.
|
|
45
|
+
*
|
|
46
|
+
* **Who is told** is decided again when the text is saved, because the token
|
|
47
|
+
* is text and can be typed by hand: the same question, and never the author.
|
|
48
|
+
* The bell entry names the Task by number, never the text. Told after the
|
|
49
|
+
* commit, under `tellAfterCommit`.
|
|
50
|
+
*/
|
|
51
|
+
export declare class TaskMentionService {
|
|
52
|
+
#private;
|
|
53
|
+
private readonly deps;
|
|
54
|
+
constructor(deps: TaskMentionServiceDeps);
|
|
55
|
+
/** `GET /tasks/lookups/mentionable?taskId=&q=` — at most {@link MENTIONABLE_LIMIT}, by name. */
|
|
56
|
+
mentionable(query: {
|
|
57
|
+
taskId?: string | undefined;
|
|
58
|
+
q?: string | undefined;
|
|
59
|
+
}): Promise<TaskAssigneeOption[]>;
|
|
60
|
+
/**
|
|
61
|
+
* Tell the newly mentioned who may see the Task, after the save committed;
|
|
62
|
+
* answers who was addressed. Never the author; a draft tells nobody (it is
|
|
63
|
+
* its Creator's alone until published).
|
|
64
|
+
*/
|
|
65
|
+
tell(task: TaskAudienceFacts & {
|
|
66
|
+
id: string;
|
|
67
|
+
number: string;
|
|
68
|
+
}, mentioned: readonly string[]): Promise<string[]>;
|
|
69
|
+
}
|
|
70
|
+
//# sourceMappingURL=mention-service.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"mention-service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/mention-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,iBAAiB,EAEtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAqB,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAExE,6EAA6E;AAC7E,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAIpC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAG7G;AAUD,iFAAiF;AACjF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,OAAO,EACP,0BAA0B,GAAG,UAAU,GAAG,YAAY,GAAG,cAAc,GAAG,YAAY,CACvF,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,IAAI,CAAC,mBAAmB,EAAE,YAAY,CAAC,CAAC;CACnD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,IAC1B,aAAa,MAAM,EAAE,MAAM,iBAAiB,KAAG,OAAO,CAAC,OAAO,CAAC,CAQ7F;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEjE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IACxC,QAAQ,EAAE,YAAY,CAAC;IACvB,wEAAwE;IACxE,UAAU,EAAE,iBAAiB,CAAC;IAC9B,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAkB;;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,sBAAsB;IAEzD,gGAAgG;IAC1F,WAAW,CAAC,KAAK,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA0BhH;;;;OAIG;IACG,IAAI,CAAC,IAAI,EAAE,iBAAiB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAoBtH"}
|