@acorex/modules 21.0.0-next.44 → 21.0.0-next.45

package/fesm2022/acorex-modules-workflow-management.mjs

@@ -13,7 +13,7 @@ import { AXPWidgetGroupEnum, AXP_WIDGETS_EDITOR_CATEGORY, AXPWidgetSerialization
 import { AXPBarChartWidget, AXPHeatmapChartWidget, AXPDonutChartWidget, AXPLineChartWidget, AXPGaugeChartWidget, AXPFunnelChartWidget, AXPKpiDetailsWidget, AXPKpiProgressWidget, AXPKpiSegmentedWidget, AXPKpiStatCardWidget } from '@acorex/modules/dashboard-management';
 import { AXP_NAME_PROPERTY, AXP_DATA_PATH_PROPERTY } from '@acorex/platform/layout/widgets';
 import { provideCommandSetups } from '@acorex/platform/runtime';
-import { AXPWorkflowManager, AXPWorkflowDefinitionService, AXP_WORKFLOW_PROVIDER, AXP_ACTIVITY_CATEGORY_PROVIDER, AXP_ACTIVITY_PROVIDER, AXP_WORKFLOW_CATEGORY_PROVIDER } from '@acorex/platform/workflow';
+import { AXPWorkflowManager, AXP_WORKFLOW_ERROR_CODES, AXPWorkflowDefinitionService, AXP_WORKFLOW_PROVIDER, AXP_ACTIVITY_CATEGORY_PROVIDER, AXP_ACTIVITY_PROVIDER, AXP_WORKFLOW_CATEGORY_PROVIDER } from '@acorex/platform/workflow';
 import { AXDialogService } from '@acorex/components/dialog';
 import { AXTranslationService } from '@acorex/core/translation';
 import { AXPopupService } from '@acorex/components/popup';
@@ -144,6 +144,15 @@ const RootConfig = {
     },
 };
 
+const AXMPermissionsKeys = {
+    WorkflowManagement: {
+        Management: 'WorkflowManagement:Permission:Management',
+    },
+    WorkflowInstance: {
+        ReassignToSelf: 'WorkflowManagement:Permission:WorkflowInstance.ReassignToSelf',
+    },
+};
+
 class AXMWorkflowManagementModuleEntityProvider {
     preload() {
         const module = RootConfig.module.name;
@@ -1422,17 +1431,18 @@ class ShowToastActivity {
     //#region ----   AXPCommand Implementation   ----
     async execute(input) {
         try {
-            // Translate message and title if they are translation keys
-            const message = await this.translationService.translateAsync(input.message);
-            const title = input.title ? await this.translationService.translateAsync(input.title) : undefined;
-            // Show toast notification
+            const toastInput = ShowToastActivity.resolvePayload(input);
+            const message = await this.translationService.translateAsync(toastInput.message);
+            const title = toastInput.title
+                ? await this.translationService.translateAsync(toastInput.title)
+                : undefined;
             this.toastService.show({
-                color: input.type || 'default',
+                color: toastInput.type || 'default',
                 title: title,
                 content: message,
-                closeButton: input.closeButton ?? true,
-                timeOut: input.timeOut ?? 3000,
-                timeOutProgress: input.timeOutProgress ?? false,
+                closeButton: toastInput.closeButton ?? true,
+                timeOut: toastInput.timeOut ?? 3000,
+                timeOutProgress: toastInput.timeOutProgress ?? false,
             });
             return {
                 success: true,
@@ -1456,6 +1466,34 @@ class ShowToastActivity {
             };
         }
     }
+    /**
+     * Resolves {@link ShowToastInput} from a direct workflow payload or entity command envelope.
+     */
+    static resolvePayload(input) {
+        const direct = ShowToastActivity.tryDirectPayload(input);
+        if (direct !== null) {
+            return direct;
+        }
+        const envelope = input;
+        const fromContext = envelope.__context__?.options;
+        if (fromContext !== undefined && ShowToastActivity.tryDirectPayload(fromContext) !== null) {
+            return fromContext;
+        }
+        const fromOptions = envelope.options;
+        if (fromOptions !== undefined && ShowToastActivity.tryDirectPayload(fromOptions) !== null) {
+            return fromOptions;
+        }
+        throw new Error('ShowToastActivity: expected ShowToastInput or envelope with __context__.options / options containing message.');
+    }
+    static tryDirectPayload(value) {
+        if (typeof value === 'object' &&
+            value !== null &&
+            'message' in value &&
+            typeof value.message === 'string') {
+            return value;
+        }
+        return null;
+    }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: ShowToastActivity, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
     static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: ShowToastActivity }); }
 }
@@ -2470,21 +2508,14 @@ class AXMAutomationEvaluatorScopeProvider {
 }
 //#endregion
 
-const AXMPermissionsKeys = {
-    WorkflowManagement: {
-        Management: 'WorkflowManagement:Permission:Management',
-    },
-};
-
 class AXMPermissionDefinitionProvider {
-    constructor() {
-        this.translationService = inject(AXTranslationService);
-    }
     async define(context) {
-        const trans = async (key) => await this.translationService.translateAsync(`@workflow-management:${key}`);
         const keys = AXMPermissionsKeys;
-        const MODULE_PERMISSIONS = '@workflow-management:module.permissions';
-        context.addGroup(RootConfig.module.name, `${MODULE_PERMISSIONS}.title`, `${MODULE_PERMISSIONS}.description`);
+        context
+            .addGroup(RootConfig.module.name, '@workflow-management:module.permissions.title', '@workflow-management:module.permissions.description')
+            .addPermission(keys.WorkflowInstance.ReassignToSelf, '@workflow-management:workflow-instance.permissions.reassign-to-self.title', '@workflow-management:workflow-instance.permissions.reassign-to-self.description')
+            .endPermission()
+            .endGroup();
     }
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMPermissionDefinitionProvider, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
     static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.9", ngImport: i0, type: AXMPermissionDefinitionProvider }); }
@@ -2493,6 +2524,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
             type: Injectable
         }] });
 
+//#region ----   Imports   ----
+//#endregion
+//#region ----   Permission Helpers   ----
+/** Permission to reassign a human-task workflow bookmark to the current user. */
+const AXM_WORKFLOW_REASSIGN_TO_SELF_PERMISSION = AXMPermissionsKeys.WorkflowInstance.ReassignToSelf;
+/**
+ * Returns whether the current session may reassign a human-task to themselves.
+ */
+function canReassignWorkflowTaskToSelf(sessionService) {
+    return sessionService.authorize(AXM_WORKFLOW_REASSIGN_TO_SELF_PERMISSION);
+}
+//#endregion
+
 /**
  * Injection token for provider config. Use when registering via DI (provide token + useFactory with deps).
  * When creating via useFactory: () => new AXPGenericWorkflowTaskProvider({ ... }), config is passed in the closure.
@@ -2526,8 +2570,12 @@ class AXPGenericWorkflowTaskProvider extends AXPWorkflowTaskProvider {
         this.workflowInstanceData = this.entityService
             .withEntity('WorkflowManagement', 'WorkflowInstance')
             .data();
+        this.userEntityData = this.entityService.withEntity('SecurityManagement', 'User').data();
         this.translationService = inject(AXTranslationService);
         this.workflowManager = inject(AXPWorkflowManager);
+        this.sessionService = inject(AXPSessionService);
+        this.toastService = inject(AXToastService);
+        this.dialogService = inject(AXDialogService);
         this.config = config;
     }
     //#endregion
@@ -2566,6 +2614,87 @@ class AXPGenericWorkflowTaskProvider extends AXPWorkflowTaskProvider {
             return [];
         return value.map((id) => String(id)).filter((s) => s.length > 0);
     }
+    /**
+     * Human-task assigned to another user; current user may take over when permitted.
+     */
+    isReassignableHumanTaskPayload(payload) {
+        if (payload.activityType !== 'workflow-activity:human-task') {
+            return false;
+        }
+        const assigned = this.normalizeUserIdList(payload.assignedUserIds);
+        if (assigned.length === 0) {
+            return false;
+        }
+        const currentUserId = this.sessionService.user?.id;
+        if (currentUserId == null) {
+            return false;
+        }
+        return !assigned.includes(String(currentUserId));
+    }
+    canTakeOverTask() {
+        return canReassignWorkflowTaskToSelf(this.sessionService);
+    }
+    //#region ----   Task Command UX   ----
+    async showWorkflowTaskToast(contentKey, color = 'danger') {
+        const title = await this.translationService.translateAsync('@general:messages.generic.error.title');
+        const content = await this.translationService.translateAsync(contentKey);
+        this.toastService.show({ color, title, content });
+    }
+    async confirmReassignToSelf() {
+        const title = await this.translationService.translateAsync('@workflow-management:tasks.dialogs.reassign-to-self.title');
+        const message = await this.translationService.translateAsync('@workflow-management:tasks.dialogs.reassign-to-self.message');
+        const dialogResult = await this.dialogService.confirm(title, message, 'warning', 'horizontal', false, 'cancel');
+        return dialogResult.result === true;
+    }
+    async reassignTaskToSelf(instanceId, bookmarkId, activityId) {
+        const result = await this.workflowManager.reassignTaskToSelf(instanceId, bookmarkId, activityId);
+        if (result.success) {
+            return true;
+        }
+        await this.showWorkflowTaskToast('@workflow-management:tasks.errors.reassign-failed');
+        return false;
+    }
+    async resumeWorkflowTask(instanceId, bookmarkId, activityId, outcome, userInput, taskToken) {
+        let result = await this.workflowManager.resume(instanceId, activityId, outcome, userInput, taskToken);
+        if (result.success ||
+            result.errorCode !== AXP_WORKFLOW_ERROR_CODES.TASK_NOT_ASSIGNEE ||
+            !this.canTakeOverTask()) {
+            if (!result.success) {
+                const toastKey = result.errorCode === AXP_WORKFLOW_ERROR_CODES.TASK_NOT_ASSIGNEE
+                    ? '@workflow-management:tasks.errors.not-assignee'
+                    : undefined;
+                if (toastKey) {
+                    await this.showWorkflowTaskToast(toastKey);
+                }
+                else if (result.error) {
+                    this.toastService.show({
+                        color: 'danger',
+                        title: await this.translationService.translateAsync('@general:messages.generic.error.title'),
+                        content: result.error,
+                    });
+                }
+            }
+            return result;
+        }
+        const confirmed = await this.confirmReassignToSelf();
+        if (!confirmed) {
+            return { success: false, instanceId, error: result.error, errorCode: result.errorCode };
+        }
+        const reassigned = await this.reassignTaskToSelf(instanceId, bookmarkId, activityId);
+        if (!reassigned) {
+            return { success: false, instanceId, error: result.error, errorCode: result.errorCode };
+        }
+        result = await this.workflowManager.resume(instanceId, activityId, outcome, userInput, taskToken);
+        if (!result.success) {
+            this.toastService.show({
+                color: 'danger',
+                title: await this.translationService.translateAsync('@general:messages.generic.error.title'),
+                content: result.error ?? 'Failed to resume workflow',
+            });
+        }
+        return result;
+    }
+    //#endregion
     /**
      * Get tasks from suspended workflow instances.
      *
@@ -2655,7 +2784,7 @@ class AXPGenericWorkflowTaskProvider extends AXPWorkflowTaskProvider {
                             }
                         }
                         // Map bookmark to task
-                        const task = this.mapBookmarkToTask(instance, bookmark, payload);
+                        const task = await this.mapBookmarkToTask(instance, bookmark, payload);
                         tasks.push(task);
                     }
                     catch {
@@ -2679,10 +2808,52 @@ class AXPGenericWorkflowTaskProvider extends AXPWorkflowTaskProvider {
         const active = bookmarks.filter((b) => !b.isConsumed && !b.consumed);
         return active;
     }
+    /**
+     * Task-board reporter: signed-in user who is viewing the app (workflow initiator context).
+     */
+    buildReporterFromSession(instance) {
+        const sessionUser = this.sessionService.user;
+        if (sessionUser?.id) {
+            const label = sessionUser.title?.trim() || sessionUser.name?.trim() || sessionUser.id;
+            return { id: sessionUser.id, type: 'user', fullName: label };
+        }
+        const audit = instance.auditInfo?.created?.by;
+        return {
+            id: audit?.id ?? '',
+            type: 'user',
+            fullName: audit?.fullName ?? '',
+        };
+    }
+    /**
+     * Resolve platform user id to a display label for the task board grid.
+     */
+    async resolveAssigneeReference(userId) {
+        const id = userId?.trim();
+        if (!id) {
+            return undefined;
+        }
+        try {
+            const row = await this.userEntityData.byKey(id);
+            if (!row || typeof row !== 'object') {
+                return { id, type: 'user', fullName: id };
+            }
+            const displayName = 'displayName' in row ? String(row.displayName ?? '').trim() : '';
+            const username = 'username' in row ? String(row.username ?? '').trim() : '';
+            const fullName = displayName || username || id;
+            const ref = { id, type: 'user', fullName };
+            if (username) {
+                ref.username = username;
+            }
+            return ref;
+        }
+        catch {
+            return { id, type: 'user', fullName: id };
+        }
+    }
     /**
      * Map bookmark to task board task format.
      */
-    mapBookmarkToTask(instance, bookmark, payload) {
+    async mapBookmarkToTask(instance, bookmark, payload) {
         // Extract dates
         const dueDate = payload.dueDate
             ? typeof payload.dueDate === 'string'
@@ -2702,6 +2873,8 @@ class AXPGenericWorkflowTaskProvider extends AXPWorkflowTaskProvider {
         const priority = this.mapPriorityToTaskPriority(payload.priority || 'Normal');
         // Build title
         const title = payload.title || payload.activityName || 'Workflow Task';
+        const assigneeId = payload.assignedUserIds?.[0];
+        const assignee = await this.resolveAssigneeReference(assigneeId);
         return {
             id: bookmark.id, // Use bookmark ID as task ID
             title,
@@ -2709,24 +2882,14 @@ class AXPGenericWorkflowTaskProvider extends AXPWorkflowTaskProvider {
             startDate,
             endDate,
             allDay: false,
-            assignee: payload.assignedUserIds && payload.assignedUserIds.length > 0
-                ? {
-                    id: payload.assignedUserIds[0], // Use first assigned user
-                    type: 'user',
-                    fullName: '', // Will be populated if user data is loaded
-                }
-                : undefined,
+            assignee,
             index: 2,
             status: {
                 id: AXPSystemStatuses.Pending.name,
                 title: this.translationService.translateSync('@workflow-management:tasks.states.pending'),
             },
             priority,
-            reporter: {
-                id: instance.auditInfo?.created?.by?.id || '',
-                type: 'user',
-                fullName: instance.auditInfo?.created?.by?.fullName || '',
-            },
+            reporter: this.buildReporterFromSession(instance),
             data: {
                 // Store workflow instance and bookmark metadata
                 instanceId: instance.id,
@@ -2798,6 +2961,13 @@ class AXPGenericWorkflowTaskProvider extends AXPWorkflowTaskProvider {
                 };
             }
             const claimResult = await this.workflowManager.claimTask(instanceId, bookmarkId, activityId);
+            if (!claimResult.success && claimResult.error) {
+                this.toastService.show({
+                    color: 'danger',
+                    title: await this.translationService.translateAsync('@general:messages.generic.error.title'),
+                    content: claimResult.error,
+                });
+            }
             return {
                 success: claimResult.success,
                 message: claimResult.error
@@ -2807,35 +2977,45 @@ class AXPGenericWorkflowTaskProvider extends AXPWorkflowTaskProvider {
                     : undefined,
             };
         }
-        // Handle workflow resume commands
-        if (command.name === 'WorkflowManagement.WorkflowInstance:Resume' || command.name === 'resume-workflow') {
-            if (!instanceId || !taskToken || !activityId) {
+        if (command.name === 'WorkflowManagement.WorkflowInstance:ReassignToSelf') {
+            if (!instanceId || !bookmarkId || !activityId) {
                 return {
                     success: false,
                     message: {
-                        text: 'Missing required parameters: instanceId, taskToken, activityId',
+                        text: 'Missing required parameters: instanceId, bookmarkId, activityId',
                     },
                 };
             }
-            try {
-                const result = await this.workflowManager.resume(instanceId, activityId, outcome, userInput, taskToken);
-                return {
-                    success: result.success,
-                    message: result.error
-                        ? {
-                            text: result.error,
-                        }
-                        : undefined,
-                };
+            if (!this.canTakeOverTask()) {
+                await this.showWorkflowTaskToast('@workflow-management:tasks.errors.not-assignee');
+                return { success: false };
+            }
+            const confirmed = await this.confirmReassignToSelf();
+            if (!confirmed) {
+                return { success: true };
             }
-            catch (error) {
+            const reassigned = await this.reassignTaskToSelf(instanceId, bookmarkId, activityId);
+            return { success: reassigned };
+        }
+        // Handle workflow resume commands
+        if (command.name === 'WorkflowManagement.WorkflowInstance:Resume' || command.name === 'resume-workflow') {
+            if (!instanceId || !taskToken || !activityId) {
                 return {
                     success: false,
                     message: {
-                        text: error instanceof Error ? error.message : 'Failed to resume workflow',
+                        text: 'Missing required parameters: instanceId, taskToken, activityId',
                     },
                 };
             }
+            const result = await this.resumeWorkflowTask(instanceId, bookmarkId, activityId, outcome, userInput, taskToken);
+            return {
+                success: result.success,
+                message: result.error
+                    ? {
+                        text: result.error,
+                    }
+                    : undefined,
+            };
         }
         return { success: true };
     }
@@ -2872,6 +3052,23 @@ class AXPGenericWorkflowTaskProvider extends AXPWorkflowTaskProvider {
             });
             return actions;
         }
+        if (this.isReassignableHumanTaskPayload(payload) && this.canTakeOverTask()) {
+            actions.push({
+                name: 'reassign-to-self',
+                title: this.translationService.translateSync('@workflow-management:tasks.actions.reassign-to-self.title'),
+                icon: 'fa-light fa-user-check',
+                color: 'warning',
+                priority: 'secondary',
+                command: {
+                    name: 'WorkflowManagement.WorkflowInstance:ReassignToSelf',
+                    options: {
+                        instanceId: taskData.instanceId,
+                        bookmarkId: taskData.bookmarkId,
+                        activityId: taskData.activityId,
+                    },
+                },
+            });
+        }
         // Extract actions from payload
         if (payload.actions) {
             const allActions = [...(payload.actions.prefix || []), ...(payload.actions.suffix || [])];
@@ -3315,5 +3512,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.9", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { AXCCategoryProvider, AXMMenuProvider, AXMWorkflowActivitiesDefinitionProvider, AXMWorkflowManagementModule, AXMWorkflowManagementModuleEntityProvider, AXPCreateEntityActivity, AXPGenericWorkflowTaskProvider, AXP_GENERIC_WORKFLOW_TASK_PROVIDER_CONFIG, CartableTaskActivity, CollectSignatureActivity, CreateEntityFormActivity, HumanTaskActivity, RootConfig, ShowConfirmPopupActivity, ShowLayoutPopupActivity, ShowToastActivity };
+export { AXCCategoryProvider, AXMMenuProvider, AXMPermissionsKeys, AXMWorkflowActivitiesDefinitionProvider, AXMWorkflowManagementModule, AXMWorkflowManagementModuleEntityProvider, AXPCreateEntityActivity, AXPGenericWorkflowTaskProvider, AXP_GENERIC_WORKFLOW_TASK_PROVIDER_CONFIG, CartableTaskActivity, CollectSignatureActivity, CreateEntityFormActivity, HumanTaskActivity, RootConfig, ShowConfirmPopupActivity, ShowLayoutPopupActivity, ShowToastActivity };
 //# sourceMappingURL=acorex-modules-workflow-management.mjs.map