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

package/types/acorex-platform-workflow.d.ts

@@ -1166,6 +1166,20 @@ interface AXPClaimWorkflowTaskRequest {
 interface AXPClaimWorkflowTaskResponse {
     success: boolean;
     error?: string;
+    errorCode?: string;
+}
+/**
+ * Reassign a human-task bookmark to the current user without resuming the workflow.
+ */
+interface AXPReassignWorkflowTaskToSelfRequest {
+    instanceId: string;
+    bookmarkId: string;
+    stepId: string;
+}
+interface AXPReassignWorkflowTaskToSelfResponse {
+    success: boolean;
+    error?: string;
+    errorCode?: string;
 }
 
 /**
@@ -1208,6 +1222,10 @@ interface AXPWorkflowEngine {
      * Engines that do not support pooling should omit this method.
      */
     claimTask?(request: AXPClaimWorkflowTaskRequest): Promise<AXPClaimWorkflowTaskResponse>;
+    /**
+     * Optional: reassign a human-task bookmark to the current user (requires permission on the engine).
+     */
+    reassignTaskToSelf?(request: AXPReassignWorkflowTaskToSelfRequest): Promise<AXPReassignWorkflowTaskToSelfResponse>;
 }
 /**
  * Injection token for workflow engine.
@@ -1215,6 +1233,35 @@ interface AXPWorkflowEngine {
  */
 declare const AXP_WORKFLOW_ENGINE: InjectionToken<AXPWorkflowEngine>;
 
+/**
+ * Stable workflow engine error codes for UI branching (toasts, take-over flow, etc.).
+ */
+declare const AXP_WORKFLOW_ERROR_CODES: {
+    readonly TASK_NOT_ASSIGNEE: "WORKFLOW_TASK_NOT_ASSIGNEE";
+    readonly CLAIM_REQUIRED: "WORKFLOW_CLAIM_REQUIRED";
+    readonly REASSIGN_NOT_ALLOWED: "WORKFLOW_REASSIGN_NOT_ALLOWED";
+};
+type AXPWorkflowErrorCode = (typeof AXP_WORKFLOW_ERROR_CODES)[keyof typeof AXP_WORKFLOW_ERROR_CODES];
+/**
+ * Business-rule failure from {@link AXPWorkflowEngine} (expected, user-facing).
+ */
+declare class AXPWorkflowEngineError extends Error {
+    readonly code: AXPWorkflowErrorCode;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: AXPWorkflowErrorCode, details?: Record<string, unknown> | undefined);
+}
+/**
+ * Resolves a stable error code from an unknown thrown value.
+ */
+declare function getWorkflowEngineErrorCode(error: unknown): AXPWorkflowErrorCode | undefined;
+/**
+ * Resolves a user-facing message and optional code from an unknown thrown value.
+ */
+declare function getWorkflowEngineErrorInfo(error: unknown): {
+    message: string;
+    code?: AXPWorkflowErrorCode;
+};
+
 /**
  * Result of starting a workflow.
  */
@@ -1301,6 +1348,10 @@ interface WorkflowResumeResult {
      * Error message (if failed).
      */
     error?: string;
+    /**
+     * Stable engine error code when available (e.g. WORKFLOW_TASK_NOT_ASSIGNEE).
+     */
+    errorCode?: string;
 }
 /**
  * Result of claiming a pooled workflow task (cartable / candidate pool).
@@ -1309,6 +1360,16 @@ interface WorkflowClaimTaskResult {
     success: boolean;
     instanceId: string;
     error?: string;
+    errorCode?: string;
+}
+/**
+ * Result of reassigning a human-task bookmark to the current user.
+ */
+interface WorkflowReassignTaskToSelfResult {
+    success: boolean;
+    instanceId: string;
+    error?: string;
+    errorCode?: string;
 }
 /**
  * Workflow Manager - Facade for workflow lifecycle orchestration.
@@ -1408,6 +1469,11 @@ declare class AXPWorkflowManager {
      * Supported only when the injected workflow engine implements {@link AXPWorkflowEngine.claimTask}.
      */
     claimTask(instanceId: string, bookmarkId: string, stepId: string): Promise<WorkflowClaimTaskResult>;
+    /**
+     * Reassign a human-task bookmark to the current user without advancing the workflow.
+     * Supported only when the injected workflow engine implements {@link AXPWorkflowEngine.reassignTaskToSelf}.
+     */
+    reassignTaskToSelf(instanceId: string, bookmarkId: string, stepId: string): Promise<WorkflowReassignTaskToSelfResult>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXPWorkflowManager, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPWorkflowManager>;
 }
@@ -1814,5 +1880,5 @@ declare class AXPWorkflowDefinitionService {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXPWorkflowDefinitionService>;
 }
 
-export { AXPActivityDefinitionService, AXPWorkflowAction, AXPWorkflowContext, AXPWorkflowDefinitionService, AXPWorkflowError, AXPWorkflowEventService, AXPWorkflowFunction, AXPWorkflowLocalEngine, AXPWorkflowManager, AXPWorkflowModule, AXPWorkflowRegistryService, AXPWorkflowService, AXP_ACTIVITY_CATEGORY_PROVIDER, AXP_ACTIVITY_PROVIDER, AXP_WORKFLOW_CATEGORY_PROVIDER, AXP_WORKFLOW_ENGINE, AXP_WORKFLOW_PROVIDER, AXP_WORKFLOW_TASK_BOARD_ACTIVITY_TYPES, ActivityExecutor, WorkflowExpressionScopeService, axpIsWorkflowTaskBoardActivityType, createWorkFlowEvent, ofType };
-export type { AXPActivityCategory, AXPActivityCategoryProvider, AXPActivityCategoryProviderToken, AXPActivityDefinition, AXPActivityExecutionContextState, AXPActivityIncident, AXPActivityProvider, AXPActivityProviderToken, AXPActivityStatus, AXPActivityVariable, AXPBookmark, AXPClaimWorkflowTaskRequest, AXPClaimWorkflowTaskResponse, AXPCompletionCallbackState, AXPConnection, AXPElsaWorkflowExtensions, AXPExceptionState, AXPFrontActivityCompleteRequest, AXPFrontActivityCompleteResponse, AXPGetWorkflowStateRequest, AXPResumeWorkflowRequest, AXPResumeWorkflowResponse, AXPStartWorkflowRequest, AXPStartWorkflowResponse, AXPTaskType, AXPWorkflow, AXPWorkflowActionInput, AXPWorkflowActivityInstance, AXPWorkflowBinding, AXPWorkflowCategory, AXPWorkflowCategoryProvider, AXPWorkflowCategoryProviderToken, AXPWorkflowCondition, AXPWorkflowConditionType, AXPWorkflowDefinition, AXPWorkflowEngine, AXPWorkflowEvent, AXPWorkflowExtensions, AXPWorkflowFaultState, AXPWorkflowGraph, AXPWorkflowInstance, AXPWorkflowInstanceState, AXPWorkflowModuleConfigs, AXPWorkflowNextStep, AXPWorkflowOutputProperty, AXPWorkflowProvider, AXPWorkflowProviderToken, AXPWorkflowState, AXPWorkflowStatus, AXPWorkflowStep, AXPWorkflowSubStatus, AXPWorkflowTask, ActivityExecutionResult, WorkflowClaimTaskResult, WorkflowCompleteResult, WorkflowExpressionContext, WorkflowResumeResult, WorkflowStartResult };
+export { AXPActivityDefinitionService, AXPWorkflowAction, AXPWorkflowContext, AXPWorkflowDefinitionService, AXPWorkflowEngineError, AXPWorkflowError, AXPWorkflowEventService, AXPWorkflowFunction, AXPWorkflowLocalEngine, AXPWorkflowManager, AXPWorkflowModule, AXPWorkflowRegistryService, AXPWorkflowService, AXP_ACTIVITY_CATEGORY_PROVIDER, AXP_ACTIVITY_PROVIDER, AXP_WORKFLOW_CATEGORY_PROVIDER, AXP_WORKFLOW_ENGINE, AXP_WORKFLOW_ERROR_CODES, AXP_WORKFLOW_PROVIDER, AXP_WORKFLOW_TASK_BOARD_ACTIVITY_TYPES, ActivityExecutor, WorkflowExpressionScopeService, axpIsWorkflowTaskBoardActivityType, createWorkFlowEvent, getWorkflowEngineErrorCode, getWorkflowEngineErrorInfo, ofType };
+export type { AXPActivityCategory, AXPActivityCategoryProvider, AXPActivityCategoryProviderToken, AXPActivityDefinition, AXPActivityExecutionContextState, AXPActivityIncident, AXPActivityProvider, AXPActivityProviderToken, AXPActivityStatus, AXPActivityVariable, AXPBookmark, AXPClaimWorkflowTaskRequest, AXPClaimWorkflowTaskResponse, AXPCompletionCallbackState, AXPConnection, AXPElsaWorkflowExtensions, AXPExceptionState, AXPFrontActivityCompleteRequest, AXPFrontActivityCompleteResponse, AXPGetWorkflowStateRequest, AXPReassignWorkflowTaskToSelfRequest, AXPReassignWorkflowTaskToSelfResponse, AXPResumeWorkflowRequest, AXPResumeWorkflowResponse, AXPStartWorkflowRequest, AXPStartWorkflowResponse, AXPTaskType, AXPWorkflow, AXPWorkflowActionInput, AXPWorkflowActivityInstance, AXPWorkflowBinding, AXPWorkflowCategory, AXPWorkflowCategoryProvider, AXPWorkflowCategoryProviderToken, AXPWorkflowCondition, AXPWorkflowConditionType, AXPWorkflowDefinition, AXPWorkflowEngine, AXPWorkflowErrorCode, AXPWorkflowEvent, AXPWorkflowExtensions, AXPWorkflowFaultState, AXPWorkflowGraph, AXPWorkflowInstance, AXPWorkflowInstanceState, AXPWorkflowModuleConfigs, AXPWorkflowNextStep, AXPWorkflowOutputProperty, AXPWorkflowProvider, AXPWorkflowProviderToken, AXPWorkflowState, AXPWorkflowStatus, AXPWorkflowStep, AXPWorkflowSubStatus, AXPWorkflowTask, ActivityExecutionResult, WorkflowClaimTaskResult, WorkflowCompleteResult, WorkflowExpressionContext, WorkflowReassignTaskToSelfResult, WorkflowResumeResult, WorkflowStartResult };

package/fesm2022/acorex-platform-common-common-settings.provider-lWz_f-Ia.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"acorex-platform-common-common-settings.provider-lWz_f-Ia.mjs","sources":["../../../../libs/platform/common/src/lib/configs/common-settings.provider.ts"],"sourcesContent":["import { Injectable, Injector } from '@angular/core';\nimport { AXPPlatformScope } from '@acorex/platform/core';\nimport { AXPWidgetsCatalog } from '@acorex/platform/layout/widget-core';\nimport { AXPSettingDefinitionProvider, AXPSettingDefinitionProviderContext } from '../settings';\nimport { AXPCommonSettings } from './common-settings.key';\n\nconst I18N = '@general:settings';\n\n@Injectable()\nexport class AXPCommonSettingProvider implements AXPSettingDefinitionProvider {\n  constructor(private _injector: Injector) {}\n\n  async provide(context: AXPSettingDefinitionProviderContext): Promise<void> {\n    // Define the 'General Settings' group\n    context\n      .group('general')\n      ?.addSection(\n        'notifications',\n        `${I18N}.general.notifications.title`,\n        `${I18N}.general.notifications.description`,\n      )\n      // Add the 'Enable Operation Toasts' setting\n      .addSetting({\n        key: AXPCommonSettings.EnableOperationToasts,\n        title: `${I18N}.general.notifications.enable-operation-toasts.title`,\n        scope: AXPPlatformScope.User,\n        isInherited: true,\n        defaultValue: true,\n        widget: {\n          type: AXPWidgetsCatalog.toggle,\n          options: {\n            label: null,\n          },\n        },\n\n        description: `${I18N}.general.notifications.enable-operation-toasts.description`,\n      })\n\n      // End the 'Notifications' section\n      .endSection()\n      .addSection('entity', `${I18N}.general.entity.title`, `${I18N}.general.entity.description`)\n      // Add the 'Enable Operation Toasts' setting\n      .addSetting({\n        key: AXPCommonSettings.EntityFilterApplyMode,\n        title: `${I18N}.general.entity.filter-apply-mode.title`,\n        scope: AXPPlatformScope.User,\n        isInherited: true,\n        defaultValue: 'auto',\n        widget: {\n          type: AXPWidgetsCatalog.select,\n          options: {\n            label: null,\n            valueField: 'value',\n            textField: 'text',\n            dataSource: [\n              { value: 'auto', text: `${I18N}.general.entity.filter-apply-mode.options.auto` },\n              { value: 'manual', text: `${I18N}.general.entity.filter-apply-mode.options.manual` },\n            ],\n          },\n        },\n\n        description: `${I18N}.general.entity.filter-apply-mode.description`,\n      })\n      .addSetting({\n        key: AXPCommonSettings.ShowCategoryColumnsByDefault,\n        title: `${I18N}.general.entity.show-category-columns-by-default.title`,\n        scope: AXPPlatformScope.User,\n        isInherited: true,\n        defaultValue: false,\n        widget: {\n          type: AXPWidgetsCatalog.toggle,\n          options: {\n            label: null,\n          },\n        },\n        description: `${I18N}.general.entity.show-category-columns-by-default.description`,\n      })\n      .addSetting({\n        key: AXPCommonSettings.ApplyLayoutOrdering,\n        title: `${I18N}.general.entity.apply-layout-ordering.title`,\n        scope: AXPPlatformScope.User,\n        isInherited: true,\n        defaultValue: true,\n        widget: {\n          type: AXPWidgetsCatalog.toggle,\n          options: {\n            label: null,\n          },\n        },\n        description: `${I18N}.general.entity.apply-layout-ordering.description`,\n      })\n      .addSetting({\n        key: AXPCommonSettings.RedirectToDetailsAfterCreate,\n        title: `${I18N}.general.entity.redirect-to-details-after-create.title`,\n        scope: AXPPlatformScope.User,\n        isInherited: true,\n        defaultValue: true,\n        widget: {\n          type: AXPWidgetsCatalog.toggle,\n          options: {\n            label: null,\n          },\n        },\n        description: `${I18N}.general.entity.redirect-to-details-after-create.description`,\n      })\n      .addSetting({\n        key: AXPCommonSettings.ShowPageBadge,\n        title: `${I18N}.general.entity.show-page-badge.title`,\n        scope: AXPPlatformScope.User,\n        isInherited: true,\n        defaultValue: true,\n        widget: {\n          type: AXPWidgetsCatalog.toggle,\n          options: {\n            label: null,\n          },\n        },\n        description: `${I18N}.general.entity.show-page-badge.description`,\n      })\n\n      // End the 'Entity Settings' section\n      .endSection()\n      // End the 'General Settings' group\n      .endGroup();\n  }\n}\n"],"names":[],"mappings":"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"}