@masterteam/work-center 0.0.66 → 0.0.68

package/fesm2022/masterteam-work-center.mjs

@@ -19,7 +19,7 @@ import { ClientForm } from '@masterteam/forms/client-form';
 import { HttpClient } from '@angular/common/http';
 import { Router, ActivatedRoute } from '@angular/router';
 import { Drawer } from '@masterteam/components/drawer';
-import { RuntimeActionContextStore, RuntimeActionRunner, resolveActionLabel } from '@masterteam/components/runtime-action';
+import { RuntimeActionContextStore, RuntimeActionRunner, RUNTIME_ACTION_CONFIRM_DIALOG, hasActionFormFields, buildActionPayload, resolveActionLabel } from '@masterteam/components/runtime-action';
 import { Action, Selector, State, Store, select } from '@ngxs/store';
 import { handleApiRequest } from '@masterteam/components';
 import { ClientInstancePreview } from '@masterteam/client-components/client-instance-preview';
@@ -27,6 +27,7 @@ import { EntitiesPreview } from '@masterteam/components/entities';
 import { Tabs } from '@masterteam/components/tabs';
 import { DiscussionThread } from '@masterteam/discussion';
 import { StructureBuilder } from '@masterteam/structure-builder';
+import { ConfirmationService } from '@masterteam/components/confirmation';
 
 class WorkCenterClientFormModal {
     modal = inject(ModalService);
@@ -2350,14 +2351,281 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.8", ngImpor
                     }, template: "<ng-container *transloco=\"let t; prefix: 'workCenter'\">\r\n  @if (details().type === \"ProcessStep\") {\r\n    <mt-work-center-process-step-type\r\n      [details]=\"details()\"\r\n      [lookups]=\"lookups()\"\r\n      [readOnly]=\"readOnly()\"\r\n    />\r\n  } @else if (details().type === \"ProcessRequest\") {\r\n    <mt-work-center-process-request-type\r\n      [details]=\"details()\"\r\n      [lookups]=\"lookups()\"\r\n      [readOnly]=\"readOnly()\"\r\n    />\r\n  } @else if (details().type === \"EscalationInstance\") {\r\n    <mt-work-center-escalation-instance-type\r\n      [details]=\"details()\"\r\n      [readOnly]=\"readOnly()\"\r\n    />\r\n  } @else if (details().type === \"Module\" || details().type === \"GeneralTask\") {\r\n    <mt-work-center-module-type\r\n      [details]=\"details()\"\r\n      [lookups]=\"lookups()\"\r\n      [readOnly]=\"readOnly()\"\r\n    />\r\n  } @else {\r\n    <div class=\"mt-modal-content flex h-full items-center justify-center p-4\">\r\n      <p class=\"text-sm text-surface-500\">{{ t(\"modal.unsupportedType\") }}</p>\r\n    </div>\r\n  }\r\n</ng-container>\r\n" }]
         }], propDecorators: { details: [{ type: i0.Input, args: [{ isSignal: true, alias: "details", required: true }] }], lookups: [{ type: i0.Input, args: [{ isSignal: true, alias: "lookups", required: false }] }], readOnly: [{ type: i0.Input, args: [{ isSignal: true, alias: "readOnly", required: false }] }] } });
 
+const FORM_VALIDATION_WARNINGS = 'FormValidationWarnings';
+/** Handles the process action validation handshake owned by Work Center. */
+class WorkCenterActionValidationHandler {
+    confirmation = inject(ConfirmationService);
+    runner = inject(RuntimeActionRunner);
+    transloco = inject(TranslocoService);
+    async recover(action, error, submittedPayload, defaultAfterSuccess) {
+        const validationError = readProcessActionValidationError(error);
+        if (validationError?.kind !== FORM_VALIDATION_WARNINGS ||
+            !validationError.requiresAcknowledgement ||
+            !validationError.validationWarningsToken) {
+            return null;
+        }
+        const confirmed = await this.confirmWarnings(this.resolveValidationMessages(validationError));
+        if (!confirmed) {
+            return {
+                status: 'cancelled',
+                actionKey: action.actionKey,
+                afterSuccess: null,
+            };
+        }
+        const retryPayload = {
+            ...(submittedPayload ?? {}),
+            validationWarningsToken: validationError.validationWarningsToken,
+        };
+        // This descriptor is intentionally ephemeral. A later action rebuilds its
+        // payload from the current form and therefore cannot reuse this token.
+        return this.runner.execute({
+            ...action,
+            needConfirmation: false,
+            payloadKeys: Object.keys(retryPayload),
+            payloadTemplate: retryPayload,
+        }, { defaultAfterSuccess, silent: true });
+    }
+    resolveErrorMessage(error, fallback) {
+        const validationError = readProcessActionValidationError(error);
+        if (validationError) {
+            const messages = this.resolveValidationMessages(validationError);
+            if (messages.length)
+                return messages.join('\n');
+            if (validationError.message)
+                return validationError.message;
+        }
+        return readHttpErrorMessage(error) ?? fallback;
+    }
+    resolveValidationMessages(validationError) {
+        const messages = [];
+        const seen = new Set();
+        for (const result of validationError.results) {
+            if (result.passed === true && result.isEvaluationError !== true)
+                continue;
+            const message = resolveLocalizedText(result.message, this.transloco.getActiveLang()) ??
+                readNonEmptyString(result.errorMessage);
+            if (!message || seen.has(message))
+                continue;
+            seen.add(message);
+            messages.push(message);
+        }
+        if (!messages.length && validationError.message) {
+            messages.push(validationError.message);
+        }
+        return messages;
+    }
+    confirmWarnings(messages) {
+        const warningLines = messages.map((message) => `• ${message}`).join('\n');
+        const question = this.transloco.translate('workCenter.actions.validationWarningsQuestion');
+        const message = warningLines ? `${warningLines}\n\n${question}` : question;
+        return new Promise((resolve) => {
+            let settled = false;
+            const settle = (value) => {
+                if (settled)
+                    return;
+                settled = true;
+                resolve(value);
+            };
+            this.confirmation.confirm({
+                type: 'dialog',
+                header: this.transloco.translate('workCenter.actions.validationWarningsHeader'),
+                message,
+                icon: 'alert.alert-triangle',
+                acceptLabel: this.transloco.translate('workCenter.actions.acknowledgeAndContinue'),
+                rejectLabel: this.transloco.translate('workCenter.modal.cancel'),
+                acceptButton: { severity: 'warn' },
+                rejectButton: { severity: 'secondary', variant: 'outlined' },
+                accept: () => settle(true),
+                reject: () => settle(false),
+            });
+        });
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.8", ngImport: i0, type: WorkCenterActionValidationHandler, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.8", ngImport: i0, type: WorkCenterActionValidationHandler, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.8", ngImport: i0, type: WorkCenterActionValidationHandler, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+function readProcessActionValidationError(error) {
+    const body = readRecord(error)?.['error'] ?? error;
+    const envelope = readRecord(body);
+    const errors = readRecord(envelope?.['errors']);
+    const details = readRecord(errors?.['details']);
+    const kind = readNonEmptyString(details?.['kind']);
+    if (!kind)
+        return null;
+    const validation = readRecord(details?.['validation']);
+    const results = Array.isArray(validation?.['results'])
+        ? validation['results']
+            .map((result) => readRecord(result))
+            .filter((result) => !!result)
+            .map((result) => result)
+        : [];
+    return {
+        kind,
+        requiresAcknowledgement: details?.['requiresAcknowledgement'] === true,
+        validationWarningsToken: readNonEmptyString(details?.['validationWarningsToken']),
+        message: readNonEmptyString(errors?.['message']),
+        results,
+    };
+}
+function resolveLocalizedText(value, activeLang) {
+    const direct = readNonEmptyString(value);
+    if (direct)
+        return direct;
+    const record = readRecord(value);
+    if (!record)
+        return null;
+    const normalizedLang = activeLang.trim();
+    const baseLang = normalizedLang.split('-')[0];
+    for (const candidate of [
+        record[normalizedLang],
+        record[baseLang],
+        record['display'],
+        record['en'],
+        record['ar'],
+    ]) {
+        const text = readNonEmptyString(candidate);
+        if (text)
+            return text;
+    }
+    return null;
+}
+function readHttpErrorMessage(error) {
+    const record = readRecord(error);
+    const body = readRecord(record?.['error']);
+    const errors = readRecord(body?.['errors']);
+    return (readNonEmptyString(errors?.['message']) ??
+        readNonEmptyString(body?.['message']) ??
+        readNonEmptyString(record?.['message']));
+}
+function readRecord(value) {
+    return value && typeof value === 'object'
+        ? value
+        : null;
+}
+function readNonEmptyString(value) {
+    if (typeof value !== 'string')
+        return null;
+    const normalized = value.trim();
+    return normalized.length ? normalized : null;
+}
+
+/** Executes Work Center actions while preserving form payloads for validation retries. */
+class WorkCenterRuntimeActionExecutor {
+    runner = inject(RuntimeActionRunner);
+    actionContext = inject(RuntimeActionContextStore);
+    modal = inject(ModalService);
+    validation = inject(WorkCenterActionValidationHandler);
+    confirmDialogClass = inject(RUNTIME_ACTION_CONFIRM_DIALOG, {
+        optional: true,
+    });
+    async execute(action, defaultAfterSuccess) {
+        if (action.needConfirmation &&
+            hasActionFormFields(action) &&
+            this.confirmDialogClass) {
+            return this.executeFormAction(action, defaultAfterSuccess);
+        }
+        let submittedPayload;
+        let result = await this.runner.execute(action, {
+            defaultAfterSuccess,
+            silent: true,
+            externalPayloadResolvers: {
+                values: () => this.actionContext.resolveFormValues(),
+            },
+            transformPayload: (payload) => {
+                submittedPayload = payload;
+                return payload;
+            },
+        });
+        if (result.status === 'error') {
+            result =
+                (await this.validation.recover(action, result.error, submittedPayload, defaultAfterSuccess)) ?? result;
+        }
+        return result;
+    }
+    executeFormAction(action, defaultAfterSuccess) {
+        return new Promise((resolve) => {
+            let pendingRun = null;
+            let finalResult = null;
+            const ref = this.modal.openModal(this.confirmDialogClass, 'dialog', {
+                header: resolveActionLabel(action),
+                width: '40rem',
+                dismissableMask: true,
+                inputValues: {
+                    action,
+                    onSubmit: async (formValue) => {
+                        const submittedPayload = buildActionPayload(action, formValue, {
+                            values: () => this.actionContext.resolveFormValues(),
+                        });
+                        const executablePayload = submittedPayload ?? {};
+                        const executableAction = {
+                            ...action,
+                            needConfirmation: false,
+                            payloadKeys: Object.keys(executablePayload),
+                            payloadTemplate: executablePayload,
+                        };
+                        pendingRun = (async () => {
+                            let result = await this.runner.execute(executableAction, {
+                                defaultAfterSuccess,
+                                silent: true,
+                            });
+                            if (result.status === 'error') {
+                                result =
+                                    (await this.validation.recover(action, result.error, submittedPayload, defaultAfterSuccess)) ?? result;
+                            }
+                            return result;
+                        })();
+                        finalResult = await pendingRun;
+                        // Every backend outcome leaves the action dialog. The footer then
+                        // refreshes on success or displays the actionable validation error.
+                        return true;
+                    },
+                },
+            });
+            ref.onClose.pipe(take(1)).subscribe(async () => {
+                if (finalResult) {
+                    resolve(finalResult);
+                    return;
+                }
+                if (pendingRun) {
+                    try {
+                        resolve(await pendingRun);
+                    }
+                    catch (error) {
+                        resolve({
+                            status: 'error',
+                            actionKey: action.actionKey,
+                            afterSuccess: null,
+                            error,
+                        });
+                    }
+                    return;
+                }
+                resolve({
+                    status: 'cancelled',
+                    actionKey: action.actionKey,
+                    afterSuccess: null,
+                });
+            });
+        });
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.8", ngImport: i0, type: WorkCenterRuntimeActionExecutor, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.8", ngImport: i0, type: WorkCenterRuntimeActionExecutor });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.8", ngImport: i0, type: WorkCenterRuntimeActionExecutor, decorators: [{
+            type: Injectable
+        }] });
+
 const DEFAULT_GENERAL_TASK_MODAL_STYLE_CLASS = '!w-[70vw] !h-[90vh]';
 class WorkCenterItemModalFooterActions {
     http = inject(HttpClient);
-    runner = inject(RuntimeActionRunner);
-    actionContext = inject(RuntimeActionContextStore);
     facade = inject(WorkCenterFacade);
     modal = inject(ModalService);
     transloco = inject(TranslocoService);
+    actionValidation = inject(WorkCenterActionValidationHandler);
+    actionExecutor = inject(WorkCenterRuntimeActionExecutor);
     loadSub;
     lastContextKey = null;
     currentExecution = null;
@@ -2439,13 +2707,7 @@ class WorkCenterItemModalFooterActions {
         this.pendingActionKey.set(action.actionKey);
         const execution = { actionKey: action.actionKey, cancelled: false };
         this.currentExecution = execution;
-        const result = await this.runner.execute(action, {
-            defaultAfterSuccess: resolveDefaultAfterSuccess(action.actionKey),
-            silent: true,
-            externalPayloadResolvers: {
-                values: () => this.actionContext.resolveFormValues(),
-            },
-        });
+        const result = await this.actionExecutor.execute(action, resolveDefaultAfterSuccess(action.actionKey));
         if (execution.cancelled) {
             return;
         }
@@ -2455,9 +2717,9 @@ class WorkCenterItemModalFooterActions {
             return;
         }
         if (result.status === 'error') {
-            const message = result.error instanceof Error
-                ? result.error.message
-                : `Failed to execute ${action.label}.`;
+            const message = this.actionValidation.resolveErrorMessage(result.error, this.transloco.translate('workCenter.actions.executeFailed', {
+                action: action.label,
+            }));
             this.error.set(message);
             return;
         }
@@ -2562,13 +2824,13 @@ class WorkCenterItemModalFooterActions {
         };
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.8", ngImport: i0, type: WorkCenterItemModalFooterActions, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.8", type: WorkCenterItemModalFooterActions, isStandalone: true, selector: "mt-work-center-item-modal-footer-actions", inputs: { contextKey: { classPropertyName: "contextKey", publicName: "contextKey", isSignal: true, isRequired: false, transformFunction: null }, previewLevelTarget: { classPropertyName: "previewLevelTarget", publicName: "previewLevelTarget", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { actionExecuted: "actionExecuted", previewLevelSelected: "previewLevelSelected", visibilityChange: "visibilityChange" }, host: { classAttribute: "flex w-full flex-1 flex-wrap items-center justify-end gap-2" }, ngImport: i0, template: "<ng-container *transloco=\"let t; prefix: 'workCenter'\">\r\n  @if (shouldRender()) {\r\n    @if (error(); as error) {\r\n      <span class=\"me-auto max-w-md text-sm text-red-600\">\r\n        {{ error }}\r\n      </span>\r\n    } @else if (loading() && !displayActions().length) {\r\n      <span class=\"me-auto text-sm text-surface-500\">{{\r\n        t(\"modal.loadingActions\")\r\n      }}</span>\r\n    }\r\n\r\n    @if (previewLevelTarget(); as previewLevelTarget) {\r\n      <mt-button\r\n        [label]=\"previewLevelLabel(previewLevelTarget, t)\"\r\n        severity=\"secondary\"\r\n        variant=\"outlined\"\r\n        [disabled]=\"loading() || !!pendingActionKey()\"\r\n        (onClick)=\"previewLevelSelected.emit(previewLevelTarget)\"\r\n      />\r\n    }\r\n\r\n    @for (action of displayActions(); track action.actionKey + action.url) {\r\n      <mt-button\r\n        [label]=\"action.label\"\r\n        [severity]=\"action.severity\"\r\n        [variant]=\"action.variant\"\r\n        [disabled]=\"loading() || !!pendingActionKey()\"\r\n        [loading]=\"pendingActionKey() === action.actionKey\"\r\n        (onClick)=\"executeAction(action)\"\r\n      />\r\n    }\r\n  }\r\n</ng-container>\r\n", dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: TranslocoDirective, selector: "[transloco]", inputs: ["transloco", "translocoParams", "translocoScope", "translocoRead", "translocoPrefix", "translocoLang", "translocoLoadingTpl"] }, { kind: "component", type: Button, selector: "mt-button", inputs: ["icon", "label", "tooltip", "class", "type", "styleClass", "severity", "badge", "variant", "badgeSeverity", "size", "iconPos", "autofocus", "fluid", "raised", "rounded", "text", "plain", "outlined", "link", "disabled", "loading", "pInputs"], outputs: ["onClick", "onFocus", "onBlur"] }] });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.8", type: WorkCenterItemModalFooterActions, isStandalone: true, selector: "mt-work-center-item-modal-footer-actions", inputs: { contextKey: { classPropertyName: "contextKey", publicName: "contextKey", isSignal: true, isRequired: false, transformFunction: null }, previewLevelTarget: { classPropertyName: "previewLevelTarget", publicName: "previewLevelTarget", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { actionExecuted: "actionExecuted", previewLevelSelected: "previewLevelSelected", visibilityChange: "visibilityChange" }, host: { classAttribute: "flex w-full flex-1 flex-wrap items-center justify-end gap-2" }, providers: [WorkCenterRuntimeActionExecutor], ngImport: i0, template: "<ng-container *transloco=\"let t; prefix: 'workCenter'\">\n  @if (shouldRender()) {\n    @if (error(); as error) {\n      <span class=\"me-auto max-w-md whitespace-pre-line text-sm text-red-600\">\n        {{ error }}\n      </span>\n    } @else if (loading() && !displayActions().length) {\n      <span class=\"me-auto text-sm text-surface-500\">{{\n        t(\"modal.loadingActions\")\n      }}</span>\n    }\n\n    @if (previewLevelTarget(); as previewLevelTarget) {\n      <mt-button\n        [label]=\"previewLevelLabel(previewLevelTarget, t)\"\n        severity=\"secondary\"\n        variant=\"outlined\"\n        [disabled]=\"loading() || !!pendingActionKey()\"\n        (onClick)=\"previewLevelSelected.emit(previewLevelTarget)\"\n      />\n    }\n\n    @for (action of displayActions(); track action.actionKey + action.url) {\n      <mt-button\n        [label]=\"action.label\"\n        [severity]=\"action.severity\"\n        [variant]=\"action.variant\"\n        [disabled]=\"loading() || !!pendingActionKey()\"\n        [loading]=\"pendingActionKey() === action.actionKey\"\n        (onClick)=\"executeAction(action)\"\n      />\n    }\n  }\n</ng-container>\n", dependencies: [{ kind: "ngmodule", type: CommonModule }, { kind: "directive", type: TranslocoDirective, selector: "[transloco]", inputs: ["transloco", "translocoParams", "translocoScope", "translocoRead", "translocoPrefix", "translocoLang", "translocoLoadingTpl"] }, { kind: "component", type: Button, selector: "mt-button", inputs: ["icon", "label", "tooltip", "class", "type", "styleClass", "severity", "badge", "variant", "badgeSeverity", "size", "iconPos", "autofocus", "fluid", "raised", "rounded", "text", "plain", "outlined", "link", "disabled", "loading", "pInputs"], outputs: ["onClick", "onFocus", "onBlur"] }] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.8", ngImport: i0, type: WorkCenterItemModalFooterActions, decorators: [{
             type: Component,
             args: [{ selector: 'mt-work-center-item-modal-footer-actions', standalone: true, imports: [CommonModule, TranslocoDirective, Button], host: {
                         class: 'flex w-full flex-1 flex-wrap items-center justify-end gap-2',
-                    }, template: "<ng-container *transloco=\"let t; prefix: 'workCenter'\">\r\n  @if (shouldRender()) {\r\n    @if (error(); as error) {\r\n      <span class=\"me-auto max-w-md text-sm text-red-600\">\r\n        {{ error }}\r\n      </span>\r\n    } @else if (loading() && !displayActions().length) {\r\n      <span class=\"me-auto text-sm text-surface-500\">{{\r\n        t(\"modal.loadingActions\")\r\n      }}</span>\r\n    }\r\n\r\n    @if (previewLevelTarget(); as previewLevelTarget) {\r\n      <mt-button\r\n        [label]=\"previewLevelLabel(previewLevelTarget, t)\"\r\n        severity=\"secondary\"\r\n        variant=\"outlined\"\r\n        [disabled]=\"loading() || !!pendingActionKey()\"\r\n        (onClick)=\"previewLevelSelected.emit(previewLevelTarget)\"\r\n      />\r\n    }\r\n\r\n    @for (action of displayActions(); track action.actionKey + action.url) {\r\n      <mt-button\r\n        [label]=\"action.label\"\r\n        [severity]=\"action.severity\"\r\n        [variant]=\"action.variant\"\r\n        [disabled]=\"loading() || !!pendingActionKey()\"\r\n        [loading]=\"pendingActionKey() === action.actionKey\"\r\n        (onClick)=\"executeAction(action)\"\r\n      />\r\n    }\r\n  }\r\n</ng-container>\r\n" }]
+                    }, providers: [WorkCenterRuntimeActionExecutor], template: "<ng-container *transloco=\"let t; prefix: 'workCenter'\">\n  @if (shouldRender()) {\n    @if (error(); as error) {\n      <span class=\"me-auto max-w-md whitespace-pre-line text-sm text-red-600\">\n        {{ error }}\n      </span>\n    } @else if (loading() && !displayActions().length) {\n      <span class=\"me-auto text-sm text-surface-500\">{{\n        t(\"modal.loadingActions\")\n      }}</span>\n    }\n\n    @if (previewLevelTarget(); as previewLevelTarget) {\n      <mt-button\n        [label]=\"previewLevelLabel(previewLevelTarget, t)\"\n        severity=\"secondary\"\n        variant=\"outlined\"\n        [disabled]=\"loading() || !!pendingActionKey()\"\n        (onClick)=\"previewLevelSelected.emit(previewLevelTarget)\"\n      />\n    }\n\n    @for (action of displayActions(); track action.actionKey + action.url) {\n      <mt-button\n        [label]=\"action.label\"\n        [severity]=\"action.severity\"\n        [variant]=\"action.variant\"\n        [disabled]=\"loading() || !!pendingActionKey()\"\n        [loading]=\"pendingActionKey() === action.actionKey\"\n        (onClick)=\"executeAction(action)\"\n      />\n    }\n  }\n</ng-container>\n" }]
         }], ctorParameters: () => [], propDecorators: { contextKey: [{ type: i0.Input, args: [{ isSignal: true, alias: "contextKey", required: false }] }], previewLevelTarget: [{ type: i0.Input, args: [{ isSignal: true, alias: "previewLevelTarget", required: false }] }], actionExecuted: [{ type: i0.Output, args: ["actionExecuted"] }], previewLevelSelected: [{ type: i0.Output, args: ["previewLevelSelected"] }], visibilityChange: [{ type: i0.Output, args: ["visibilityChange"] }] } });
 function normalizeMethod(value) {
     if (!value || typeof value !== 'string') {