@acorex-platform/module-task-management-client 0.0.21

package/fesm2022/acorex-platform-module-task-management-client-start-task-flow.command-ChCuTFV-.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"acorex-platform-module-task-management-client-start-task-flow.command-ChCuTFV-.mjs","sources":["../../../../libs/modules/task-management/client/src/lib/features/task/commands/start-task-flow.command.ts"],"sourcesContent":["//#region ---- Imports ----\n\nimport { AXPCommand, type AXPCommandExecuteResultPromise } from '@acorex-platform/framework-shared/runtime';\nimport { type AXPEntityReference, AXPRuntimeCommandResult } from '@acorex-platform/framework-shared/core';\nimport { AXToastService } from '@acorex/components/toast';\n\nimport { AXPEntityService } from '@acorex-platform/framework-client/layout/entity';\n\nimport { AXPWorkflowManager } from '@acorex-platform/framework-client/workflow';\nimport { defaultTo, get, isEmpty, merge } from 'lodash';\nimport { inject, Injectable } from '@angular/core';\nimport { AXPTaskManagementCommandKeys } from '@acorex-platform/module-task-management-client/contracts';\nimport { RootConfig } from '@acorex-platform/module-task-management-client/contracts';\nimport type { AXMTaskManagementTaskTypeEntityModel } from '@acorex-platform/module-task-management-client/contracts';\n\n//#endregion\n\n//#region ---- Types ----\n\nexport interface StartTaskFlowInput {\n  workflowId?: string;\n  taskTypeId?: string;\n  subjectRef?: AXPEntityReference;\n  projectTypeId?: string;\n  input?: Record<string, unknown>;\n  options?: StartTaskFlowOptions;\n}\n\nexport interface StartTaskFlowOptions {\n  workflowId: string;\n  input: {\n    taskTypeId: string;\n    subjectRef: AXPEntityReference;\n    projectTypeId?: string;\n    taskTypeTitle?: string;\n  } & Record<string, unknown>;\n}\n\n//#endregion\n\n/**\n * Starts a workflow for a {@link TaskManagement.Task} when the task type defines {@link workflowConfig}.\n */\n@Injectable({ providedIn: 'root' })\nexport class StartTaskFlowCommand implements AXPCommand<StartTaskFlowInput, void> {\n  //#region ---- Services & Dependencies ----\n\n  private readonly toastService = inject(AXToastService);\n  private readonly entityService = inject(AXPEntityService);\n  private readonly workflowManager = inject(AXPWorkflowManager);\n\n  //#endregion\n\n  //#region ---- Command Implementation ----\n\n  async execute(input: StartTaskFlowInput): AXPCommandExecuteResultPromise<void> {\n    const options = (input?.options ?? input) as StartTaskFlowOptions;\n    const flowInput = defaultTo(options?.input, {} as StartTaskFlowOptions['input']);\n    const workflowId = (options?.workflowId ?? input?.workflowId)?.trim();\n    const taskTypeId = flowInput?.taskTypeId?.trim();\n    const subjectRef = flowInput?.subjectRef ?? input?.subjectRef;\n    const projectTypeId = flowInput?.projectTypeId?.trim() ?? input?.projectTypeId?.trim();\n\n    if (!workflowId || !taskTypeId || !subjectRef?.id || !subjectRef?.type) {\n      return { success: false, message: { text: 'Missing workflow, task type, or subject reference.' } };\n    }\n\n    try {\n      const taskType = await this.loadTaskType(taskTypeId);\n      if (!taskType) {\n        return { success: false, message: { text: 'Task type not found.' } };\n      }\n\n      if (projectTypeId) {\n        const allowed = await this.isTaskTypeAllowedForProjectType(projectTypeId, taskTypeId);\n        if (!allowed) {\n          return { success: false, message: { text: 'Task type is not allowed for this project type.' } };\n        }\n      }\n\n      const defaultInput = defaultTo(get(taskType, 'workflowConfig.defaultInput'), {});\n      const startResult = await this.workflowManager.start(workflowId, merge(\n        defaultInput,\n        {\n          taskTypeId,\n          taskTypeTitle: flowInput.taskTypeTitle ?? taskType.title,\n          subjectRef,\n          ...(projectTypeId ? { projectTypeId } : {}),\n          refId: subjectRef.id,\n          refType: subjectRef.type,\n          correlationId: this.buildCorrelationId(subjectRef.id, taskTypeId, workflowId),\n        },\n        flowInput,\n      ));\n\n      if (!startResult.success) {\n        this.toastService.show({\n          color: 'danger',\n          title: 'Workflow Execution Failed',\n          content: startResult.error ?? 'Unknown error',\n          closeButton: true,\n          timeOut: 5000,\n        });\n        return { success: false, message: { text: startResult.error ?? 'Unknown error' } };\n      }\n\n      return { success: true, kind: 'object', data: undefined };\n    } catch (error: unknown) {\n      const message = error instanceof Error ? error.message : 'Unknown error';\n      console.error('[StartTaskFlowCommand]', error);\n      this.toastService.show({\n        color: 'danger',\n        title: 'Workflow Execution Error',\n        content: message,\n        closeButton: true,\n        timeOut: 5000,\n      });\n      return { success: false, message: { text: message } };\n    }\n  }\n\n  //#endregion\n\n  //#region ---- Helpers ----\n\n  private async loadTaskType(taskTypeId: string): Promise<AXMTaskManagementTaskTypeEntityModel | null> {\n    const row = await this.entityService\n      .withEntity(RootConfig.module.name, RootConfig.entities.taskType.name)\n      .data()\n      .byKey(taskTypeId);\n    return (row ?? null) as AXMTaskManagementTaskTypeEntityModel | null;\n  }\n\n  private async isTaskTypeAllowedForProjectType(projectTypeId: string, taskTypeId: string): Promise<boolean> {\n    const projectType = (await this.entityService\n      .withEntity('ProjectManagement', 'ProjectType')\n      .data()\n      .byKey(projectTypeId)) as {\n      allowedTaskTypeIds?: string[];\n      allowedTaskTypes?: Array<{ id: string }>;\n    } | null;\n\n    if (!projectType) {\n      return false;\n    }\n\n    const allowedIds = projectType.allowedTaskTypes?.map((row) => row.id).filter(Boolean) ?? [];\n    if (!isEmpty(allowedIds)) {\n      return allowedIds.includes(taskTypeId);\n    }\n\n    return defaultTo(projectType.allowedTaskTypeIds, []).includes(taskTypeId);\n  }\n\n  private buildCorrelationId(subjectId: string, taskTypeId: string, workflowId: string): string {\n    return `${subjectId}:${taskTypeId}:${workflowId}`;\n  }\n\n  //#endregion\n}\n\nexport const START_TASK_FLOW_COMMAND_KEY = AXPTaskManagementCommandKeys.Task.StartFlow;\n"],"names":[],"mappings":"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"}