@rytass/bpm-core-nestjs-module 0.13.5 → 0.14.0

package/src/lib/workflow-engine/workflow-engine.enums.d.ts

@@ -34,7 +34,9 @@ export declare enum TaskCandidateStatusEnum {
     COMPLETED = "COMPLETED",
     PENDING = "PENDING",
     SUPERSEDED = "SUPERSEDED",
-    TRANSFERRED = "TRANSFERRED"
+    TRANSFERRED = "TRANSFERRED",
+    /** SEQUENTIAL task, not this candidate's turn yet. */
+    WAITING = "WAITING"
 }
 export declare enum TaskDecisionActionEnum {
     APPROVED = "APPROVED",
@@ -54,6 +56,8 @@ export declare enum ActivityLogEventTypeEnum {
     SERVICE_TASK_EXECUTED = "SERVICE_TASK_EXECUTED",
     SERVICE_TASK_FAILED = "SERVICE_TASK_FAILED",
     SLA_TRIGGERED = "SLA_TRIGGERED",
+    /** A SEQUENTIAL task passed to its next candidate. */
+    TASK_CANDIDATE_ACTIVATED = "TASK_CANDIDATE_ACTIVATED",
     TASK_CREATED = "TASK_CREATED",
     TASK_DECIDED = "TASK_DECIDED",
     TOKEN_ADVANCED = "TOKEN_ADVANCED",

package/src/lib/workflow-engine/workflow-engine.enums.js

@@ -45,6 +45,8 @@ var TaskCandidateStatusEnum;
     TaskCandidateStatusEnum["PENDING"] = "PENDING";
     TaskCandidateStatusEnum["SUPERSEDED"] = "SUPERSEDED";
     TaskCandidateStatusEnum["TRANSFERRED"] = "TRANSFERRED";
+    /** SEQUENTIAL task, not this candidate's turn yet. */
+    TaskCandidateStatusEnum["WAITING"] = "WAITING";
 })(TaskCandidateStatusEnum || (exports.TaskCandidateStatusEnum = TaskCandidateStatusEnum = {}));
 var TaskDecisionActionEnum;
 (function (TaskDecisionActionEnum) {
@@ -66,6 +68,8 @@ var ActivityLogEventTypeEnum;
     ActivityLogEventTypeEnum["SERVICE_TASK_EXECUTED"] = "SERVICE_TASK_EXECUTED";
     ActivityLogEventTypeEnum["SERVICE_TASK_FAILED"] = "SERVICE_TASK_FAILED";
     ActivityLogEventTypeEnum["SLA_TRIGGERED"] = "SLA_TRIGGERED";
+    /** A SEQUENTIAL task passed to its next candidate. */
+    ActivityLogEventTypeEnum["TASK_CANDIDATE_ACTIVATED"] = "TASK_CANDIDATE_ACTIVATED";
     ActivityLogEventTypeEnum["TASK_CREATED"] = "TASK_CREATED";
     ActivityLogEventTypeEnum["TASK_DECIDED"] = "TASK_DECIDED";
     ActivityLogEventTypeEnum["TOKEN_ADVANCED"] = "TOKEN_ADVANCED";

package/src/lib/workflow-engine/workflow-engine.enums.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-engine.enums.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/workflow-engine/workflow-engine.enums.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow-engine.enums.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/workflow-engine/workflow-engine.enums.ts"],"names":[],"mappings":";;;AAAA,6CAAmD;AAEnD,IAAY,yBAQX;AARD,WAAY,yBAAyB;IACnC,kDAAqB,CAAA;IACrB,oDAAuB,CAAA;IACvB,4CAAe,CAAA;IACf,gDAAmB,CAAA;IACnB,kDAAqB,CAAA;IACrB,kDAAqB,CAAA;IACrB,gDAAmB,CAAA;AACrB,CAAC,EARW,yBAAyB,yCAAzB,yBAAyB,QAQpC;AAED,IAAY,4BAIX;AAJD,WAAY,4BAA4B;IACtC,2CAAW,CAAA;IACX,yCAAS,CAAA;IACT,6CAAa,CAAA;AACf,CAAC,EAJW,4BAA4B,4CAA5B,4BAA4B,QAIvC;AAED,IAAY,uBAIX;AAJD,WAAY,uBAAuB;IACjC,4CAAiB,CAAA;IACjB,gDAAqB,CAAA;IACrB,8CAAmB,CAAA;AACrB,CAAC,EAJW,uBAAuB,uCAAvB,uBAAuB,QAIlC;AAED,IAAY,cAMX;AAND,WAAY,cAAc;IACxB,yCAAuB,CAAA;IACvB,yCAAuB,CAAA;IACvB,6CAA2B,CAAA;IAC3B,qCAAmB,CAAA;IACnB,6CAA2B,CAAA;AAC7B,CAAC,EANW,cAAc,8BAAd,cAAc,QAMzB;AAED,IAAY,sBAGX;AAHD,WAAY,sBAAsB;IAChC,6DAAmC,CAAA;IACnC,yDAA+B,CAAA;AACjC,CAAC,EAHW,sBAAsB,sCAAtB,sBAAsB,QAGjC;AAED,IAAY,uBASX;AATD,WAAY,uBAAuB;IACjC,kDAAuB,CAAA;IACvB,8CAAmB,CAAA;IACnB,kDAAuB,CAAA;IACvB,8CAAmB,CAAA;IACnB,oDAAyB,CAAA;IACzB,sDAA2B,CAAA;IAC3B,sDAAsD;IACtD,8CAAmB,CAAA;AACrB,CAAC,EATW,uBAAuB,uCAAvB,uBAAuB,QASlC;AAED,IAAY,sBAKX;AALD,WAAY,sBAAsB;IAChC,+CAAqB,CAAA;IACrB,+CAAqB,CAAA;IACrB,+CAAqB,CAAA;IACrB,qDAA2B,CAAA;AAC7B,CAAC,EALW,sBAAsB,sCAAtB,sBAAsB,QAKjC;AAED,IAAY,wBAoBX;AApBD,WAAY,wBAAwB;IAClC,mFAAuD,CAAA;IACvD,+EAAmD,CAAA;IACnD,uFAA2D,CAAA;IAC3D,iFAAqD,CAAA;IACrD,qEAAyC,CAAA;IACzC,yEAA6C,CAAA;IAC7C,iEAAqC,CAAA;IACrC,mEAAuC,CAAA;IACvC,2EAA+C,CAAA;IAC/C,uEAA2C,CAAA;IAC3C,2DAA+B,CAAA;IAC/B,sDAAsD;IACtD,iFAAqD,CAAA;IACrD,yDAA6B,CAAA;IAC7B,yDAA6B,CAAA;IAC7B,6DAAiC,CAAA;IACjC,2DAA+B,CAAA;IAC/B,kFAAkF;IAClF,iFAAqD,CAAA;AACvD,CAAC,EApBW,wBAAwB,wCAAxB,wBAAwB,QAoBnC;AAED,IAAA,0BAAgB,EAAC,yBAAyB,EAAE;IAC1C,IAAI,EAAE,uBAAuB;CAC9B,CAAC,CAAC;AAEH,IAAA,0BAAgB,EAAC,4BAA4B,EAAE;IAC7C,IAAI,EAAE,0BAA0B;CACjC,CAAC,CAAC;AAEH,IAAA,0BAAgB,EAAC,uBAAuB,EAAE;IACxC,IAAI,EAAE,qBAAqB;CAC5B,CAAC,CAAC;AAEH,IAAA,0BAAgB,EAAC,cAAc,EAAE;IAC/B,IAAI,EAAE,YAAY;CACnB,CAAC,CAAC;AAEH,IAAA,0BAAgB,EAAC,sBAAsB,EAAE;IACvC,IAAI,EAAE,oBAAoB;CAC3B,CAAC,CAAC;AAEH,IAAA,0BAAgB,EAAC,uBAAuB,EAAE;IACxC,IAAI,EAAE,qBAAqB;CAC5B,CAAC,CAAC;AAEH,IAAA,0BAAgB,EAAC,sBAAsB,EAAE;IACvC,IAAI,EAAE,oBAAoB;CAC3B,CAAC,CAAC;AAEH,IAAA,0BAAgB,EAAC,wBAAwB,EAAE;IACzC,IAAI,EAAE,sBAAsB;CAC7B,CAAC,CAAC"}

package/src/lib/workflow-engine/workflow-engine.service.d.ts

@@ -129,9 +129,26 @@ export declare class WorkflowEngineService {
     private loadAdhocOperationContext;
     private recordAdhocDirectiveActivity;
     private createAdhocTaskForDirective;
+    private resolveAdhocTaskCandidates;
     private spawnCountersignTasksForNode;
     private hasOpenTasksForTokenNode;
     private handleAdhocPreApprovalRejection;
+    /**
+     * Follows a TRANSFERRED task to the task that replaced it, repeatedly, and
+     * returns the last one reached. A transfer leaves no pointer on either task
+     * row; the link is the `transferredFromTaskId` in the payload of the
+     * TASK_CREATED activity written for the replacement. When the trail stops
+     * (no such activity, or its task is gone) the last task reached is returned,
+     * so a caller sees the transferred row exactly as it did before.
+     */
+    private readTransferSuccessorTask;
+    /**
+     * The requester's candidate row on a SEQUENTIAL origin task. A task that was
+     * transferred mid-order continues as a replacement that carries only the
+     * candidates still to sign, so a requester who already signed is found on an
+     * earlier task of the transfer chain instead.
+     */
+    private readSequentialRequesterCandidate;
     private readOpenTaskRecipientMemberIds;
     private dispatchAdhocStageNotifications;
     private dispatchAdhocCompletionNotifications;
@@ -142,6 +159,14 @@ export declare class WorkflowEngineService {
     private simulateWorkflowPath;
     private readDryRunAvailableOutgoingEdges;
     private evaluateDryRunEdge;
+    /**
+     * The dry-run assignee of a user task. Only resolvers whose dry run yields
+     * real member ids (DIRECT, DYNAMIC_FORM, EXPRESSION and ORG_MANAGER, which
+     * reads the initiator snapshot) can be checked against the initiator; the
+     * others resolve to placeholders and are left as they are.
+     */
+    private resolveDryRunAssignment;
+    private readDryRunMemberIds;
     private resolveDryRunAssigneeMemberId;
     getApprovalInstance(id: string, scope?: WorkflowReadScope): Promise<ApprovalInstanceEntity>;
     listApprovalInstances(scope?: WorkflowReadScope, options?: ListApprovalInstancesOptions): Promise<readonly ApprovalInstanceEntity[]>;
@@ -183,6 +208,8 @@ export declare class WorkflowEngineService {
     private advanceTokenToOutgoingNodes;
     private isNodeEntryConditionMet;
     private skipNodeByEntryCondition;
+    private skipNodeByInitiatorExclusion;
+    private skipNode;
     private readAvailableOutgoingEdges;
     private evaluateWorkflowEdge;
     private readLastDecisionContext;
@@ -190,13 +217,45 @@ export declare class WorkflowEngineService {
     private forkTokenAlongEdges;
     private completeTokenAtEndNode;
     private createUserTaskForToken;
+    /**
+     * Hands a SEQUENTIAL task to the lowest-`sequence` candidate still WAITING.
+     * A task without a WAITING candidate (every other policy, and SEQUENTIAL
+     * tasks created before candidates were ordered) is left alone.
+     */
+    private activateNextSequentialCandidate;
+    /**
+     * Re-resolves the delegation of a candidate whose turn has come. When the
+     * delegate already holds another candidate row on the task, the stored values
+     * are kept: (task_id, member_id) is unique, and that member signs from the
+     * row they already have. On a node that excludes the initiator the stored
+     * values are kept as well when the new delegation path would run through the
+     * initiator: creation already filtered such paths out, and a delegation added
+     * while the candidate waited must not bring them back.
+     */
+    private resolveActivationDelegation;
     private markTaskCandidateDecision;
     private transferTask;
+    /**
+     * Resolves who gets the node's task. `null` means the node asked to be
+     * skipped (`excludeInitiator.whenEmpty = SKIP_NODE`) because the initiator
+     * was the only approver — the sole caller creates no task and advances the
+     * token instead.
+     */
     private resolveRuntimeTaskCandidates;
-    private applyDelegationToResolvedCandidates;
+    private resolveInitiatorManagerReplacements;
+    private buildDelegationContext;
+    private delegateResolvedCandidates;
     private resolveApproverResolver;
     private resolvePositionCandidates;
     private resolveInitiatorManagerCandidates;
+    /**
+     * Walks up the initiator's manager chain, nearest manager first, until a
+     * manager whose position level reaches `minPositionLevel` is added. The
+     * list is returned nearest manager first.
+     */
+    private resolveOrgManagerChainCandidates;
+    /** Highest position level over the member's active memberships, or `null`. */
+    private readMemberPositionLevel;
     private resolveFallbackAssignee;
     private resolveManagerMemberIdsFromOrganization;
     private resolveManagerMemberIdsAtLevel;