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