@rytass/bpm-core-nestjs-module 0.23.0 → 0.24.0

package/src/lib/workflow-engine/stuck-approval-instance.object.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StuckApprovalInstanceObject = void 0;
+const tslib_1 = require("tslib");
+const graphql_1 = require("@nestjs/graphql");
+const workflow_engine_enums_1 = require("./workflow-engine.enums");
+/**
+ * An approval instance that could not move on to its next stage, as the
+ * administrator's stuck-instances screen lists it: one row per instance, from
+ * its latest unresolved failure.
+ */
+let StuckApprovalInstanceObject = class StuckApprovalInstanceObject {
+};
+exports.StuckApprovalInstanceObject = StuckApprovalInstanceObject;
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => graphql_1.ID, { description: 'The stuck instance.' }),
+    tslib_1.__metadata("design:type", String)
+], StuckApprovalInstanceObject.prototype, "instanceId", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)({ description: 'Title of the stuck instance.' }),
+    tslib_1.__metadata("design:type", String)
+], StuckApprovalInstanceObject.prototype, "instanceTitle", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => graphql_1.ID, { description: 'The template the instance was filed from.' }),
+    tslib_1.__metadata("design:type", String)
+], StuckApprovalInstanceObject.prototype, "templateId", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => String, {
+        description: 'Name of that template; null when it can no longer be read.',
+        nullable: true,
+    }),
+    tslib_1.__metadata("design:type", Object)
+], StuckApprovalInstanceObject.prototype, "templateName", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)({ description: 'Who filed the instance.' }),
+    tslib_1.__metadata("design:type", String)
+], StuckApprovalInstanceObject.prototype, "initiatorMemberId", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => workflow_engine_enums_1.StuckApprovalInstanceKindEnum, {
+        description: 'DECISION: a decision on a task could not move the instance on. ' +
+            'RESUBMIT: the initiator resubmitted a returned instance and it could not start.',
+    }),
+    tslib_1.__metadata("design:type", String)
+], StuckApprovalInstanceObject.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => String, {
+        description: 'The node the failed decision was made on; null for RESUBMIT.',
+        nullable: true,
+    }),
+    tslib_1.__metadata("design:type", Object)
+], StuckApprovalInstanceObject.prototype, "nodeId", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => String, {
+        description: 'Display name of that node, read from the instance workflow snapshot; ' +
+            'null for RESUBMIT or when the node carries no label.',
+        nullable: true,
+    }),
+    tslib_1.__metadata("design:type", Object)
+], StuckApprovalInstanceObject.prototype, "nodeLabel", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => graphql_1.ID, {
+        description: 'The task the failed decision was made on; null for RESUBMIT.',
+        nullable: true,
+    }),
+    tslib_1.__metadata("design:type", Object)
+], StuckApprovalInstanceObject.prototype, "taskId", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => [String], {
+        description: 'Who has to press again now, read when the list is loaded. DECISION: ' +
+            'the members whose seat on the task is PENDING or CLAIMED (WAITING ' +
+            'seats are not their turn yet), or the assignee of a task that has no ' +
+            'candidate rows at all; it follows a later reassignment. RESUBMIT: the ' +
+            'initiator only.',
+    }),
+    tslib_1.__metadata("design:type", Array)
+], StuckApprovalInstanceObject.prototype, "pendingActorMemberIds", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => String, {
+        description: 'The member the failed attempt was made as. For an automatic approval ' +
+            'this is the holder the system picked, who did not press anything: ' +
+            'read `automatic` first.',
+        nullable: true,
+    }),
+    tslib_1.__metadata("design:type", Object)
+], StuckApprovalInstanceObject.prototype, "failedActorMemberId", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)(() => String, {
+        description: "'SLA_AUTO_APPROVE' when the failed attempt was the system approving " +
+            'an overdue task, null when a person pressed the button.',
+        nullable: true,
+    }),
+    tslib_1.__metadata("design:type", Object)
+], StuckApprovalInstanceObject.prototype, "automatic", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)({
+        description: 'Why the instance could not move on, as the operator saw it.',
+    }),
+    tslib_1.__metadata("design:type", String)
+], StuckApprovalInstanceObject.prototype, "message", void 0);
+tslib_1.__decorate([
+    (0, graphql_1.Field)({ description: 'When the failed attempt was recorded.' }),
+    tslib_1.__metadata("design:type", Date)
+], StuckApprovalInstanceObject.prototype, "failedAt", void 0);
+exports.StuckApprovalInstanceObject = StuckApprovalInstanceObject = tslib_1.__decorate([
+    (0, graphql_1.ObjectType)('StuckApprovalInstance')
+], StuckApprovalInstanceObject);
+//# sourceMappingURL=stuck-approval-instance.object.js.map

package/src/lib/workflow-engine/stuck-approval-instance.object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stuck-approval-instance.object.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/workflow-engine/stuck-approval-instance.object.ts"],"names":[],"mappings":";;;;AAAA,6CAAwD;AACxD,mEAAwE;AAExE;;;;GAIG;AAEI,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;CAiFvC,CAAA;AAjFY,kEAA2B;AAEtC;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,YAAE,EAAE,EAAE,WAAW,EAAE,qBAAqB,EAAE,CAAC;;+DACpC;AAGpB;IADC,IAAA,eAAK,EAAC,EAAE,WAAW,EAAE,8BAA8B,EAAE,CAAC;;kEAChC;AAGvB;IADC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,YAAE,EAAE,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC;;+DAC1D;AAMpB;IAJC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,EAAE;QACnB,WAAW,EAAE,4DAA4D;QACzE,QAAQ,EAAE,IAAI;KACf,CAAC;;iEAC2B;AAG7B;IADC,IAAA,eAAK,EAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;;sEACvB;AAO3B;IALC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,qDAA6B,EAAE;QAC1C,WAAW,EACT,iEAAiE;YACjE,iFAAiF;KACpF,CAAC;;yDACmC;AAOrC;IALC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,EAAE;QACnB,WAAW,EACT,8DAA8D;QAChE,QAAQ,EAAE,IAAI;KACf,CAAC;;2DACqB;AAQvB;IANC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,EAAE;QACnB,WAAW,EACT,uEAAuE;YACvE,sDAAsD;QACxD,QAAQ,EAAE,IAAI;KACf,CAAC;;8DACwB;AAM1B;IAJC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,YAAE,EAAE;QACf,WAAW,EAAE,8DAA8D;QAC3E,QAAQ,EAAE,IAAI;KACf,CAAC;;2DACqB;AAUvB;IARC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE;QACrB,WAAW,EACT,sEAAsE;YACtE,oEAAoE;YACpE,uEAAuE;YACvE,wEAAwE;YACxE,iBAAiB;KACpB,CAAC;;0EAC+B;AASjC;IAPC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,EAAE;QACnB,WAAW,EACT,uEAAuE;YACvE,oEAAoE;YACpE,yBAAyB;QAC3B,QAAQ,EAAE,IAAI;KACf,CAAC;;wEACkC;AAQpC;IANC,IAAA,eAAK,EAAC,GAAG,EAAE,CAAC,MAAM,EAAE;QACnB,WAAW,EACT,sEAAsE;YACtE,yDAAyD;QAC3D,QAAQ,EAAE,IAAI;KACf,CAAC;;8DACwB;AAK1B;IAHC,IAAA,eAAK,EAAC;QACL,WAAW,EAAE,6DAA6D;KAC3E,CAAC;;4DACe;AAGjB;IADC,IAAA,eAAK,EAAC,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC;sCACrD,IAAI;6DAAC;sCAhFL,2BAA2B;IADvC,IAAA,oBAAU,EAAC,uBAAuB,CAAC;GACvB,2BAA2B,CAiFvC"}

package/src/lib/workflow-engine/stuck-approval-instance.query.d.ts

@@ -0,0 +1,22 @@
+import { EntityManager } from 'typeorm';
+import { ActivityLogEntity } from './activity-log.entity';
+import { ApprovalInstanceEntity } from './approval-instance.entity';
+import { TaskStatusEnum } from './workflow-engine.enums';
+/**
+ * The rule above for one instance, given its `ADVANCE_FAILED` and
+ * `INSTANCE_RESUBMITTED` rows in `seq` order and the ids of the tasks among
+ * them that are still open.
+ */
+export declare function readUnresolvedInstanceFailures(instance: ApprovalInstanceEntity, logs: readonly ActivityLogEntity[], openTaskIds: ReadonlySet<string>): readonly ActivityLogEntity[];
+/**
+ * One page of stuck instances, as the ids of the failure that describes each:
+ * its latest unresolved `ADVANCE_FAILED` (highest `seq`). Newest failure first:
+ * `created_at` is the transaction start, so `seq` breaks a tie within one
+ * transaction, and the instance id any tie left after that.
+ */
+export declare function readStuckFailurePage(manager: EntityManager, openTaskStatuses: readonly TaskStatusEnum[], page: {
+    readonly offset: number;
+    readonly limit: number;
+}): Promise<readonly string[]>;
+/** How many instances {@link readStuckFailurePage} pages through. */
+export declare function countStuckInstances(manager: EntityManager, openTaskStatuses: readonly TaskStatusEnum[]): Promise<number>;

package/src/lib/workflow-engine/stuck-approval-instance.query.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readUnresolvedInstanceFailures = readUnresolvedInstanceFailures;
+exports.readStuckFailurePage = readStuckFailurePage;
+exports.countStuckInstances = countStuckInstances;
+const typeorm_1 = require("typeorm");
+const activity_log_entity_1 = require("./activity-log.entity");
+const approval_instance_entity_1 = require("./approval-instance.entity");
+const task_entity_1 = require("./task.entity");
+const workflow_engine_enums_1 = require("./workflow-engine.enums");
+/*
+ * Which `ADVANCE_FAILED` rows still describe a stuck instance, written twice:
+ * `readUnresolvedInstanceFailures` in TypeScript, for the duplicate check that
+ * runs when a failure is recorded, and `createUnresolvedFailureQuery` in SQL,
+ * for the administrator's stuck list, so that list can be paged and counted by
+ * the database. The two must say the same thing; change them together.
+ *
+ * - `DECISION`: the instance is RUNNING and the failed task is still open.
+ *   Once the task is done, cancelled, transferred or the instance has ended,
+ *   the case has moved on or been taken over.
+ * - `RESUBMIT`: the instance is RETURNED and no later `INSTANCE_RESUBMITTED`
+ *   exists.
+ * - Any other `kind`: never unresolved.
+ *
+ * Not exported from the package: both are internals of the workflow engine.
+ */
+/** The `kind` of an `ADVANCE_FAILED` payload, trimmed; `null` when absent. */
+function readFailureKind(failure) {
+    const value = failure.payload['kind'];
+    return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+/**
+ * The rule above for one instance, given its `ADVANCE_FAILED` and
+ * `INSTANCE_RESUBMITTED` rows in `seq` order and the ids of the tasks among
+ * them that are still open.
+ */
+function readUnresolvedInstanceFailures(instance, logs, openTaskIds) {
+    return logs.filter((failure, index) => {
+        if (failure.eventType !== workflow_engine_enums_1.ActivityLogEventTypeEnum.ADVANCE_FAILED) {
+            return false;
+        }
+        const kind = readFailureKind(failure);
+        if (kind === 'DECISION') {
+            return (instance.state === workflow_engine_enums_1.ApprovalInstanceStateEnum.RUNNING &&
+                failure.taskId !== null &&
+                openTaskIds.has(failure.taskId));
+        }
+        if (kind === 'RESUBMIT') {
+            return (instance.state === workflow_engine_enums_1.ApprovalInstanceStateEnum.RETURNED &&
+                !logs
+                    .slice(index + 1)
+                    .some((log) => log.eventType === workflow_engine_enums_1.ActivityLogEventTypeEnum.INSTANCE_RESUBMITTED));
+        }
+        return false;
+    });
+}
+/*
+ * TypeORM rewrites `alias.property` to the quoted column only when the next
+ * character is a space, a comma or a closing bracket; before a line break it
+ * leaves the path bare, which Postgres folds to lower case and cannot find. So
+ * every condition below is a single line.
+ */
+const FAILURE_KIND_SQL = `TRIM("failure"."payload"->>'kind')`;
+/**
+ * The rule above as SQL: every unresolved `ADVANCE_FAILED` row (alias
+ * `failure`), joined to its instance (alias `stuckInstance`).
+ */
+function createUnresolvedFailureQuery(manager, openTaskStatuses) {
+    const query = manager
+        .createQueryBuilder(activity_log_entity_1.ActivityLogEntity, 'failure')
+        .innerJoin(approval_instance_entity_1.ApprovalInstanceEntity, 'stuckInstance', 'stuckInstance.id = failure.instanceId');
+    const openTask = query
+        .subQuery()
+        .select('1')
+        .from(task_entity_1.TaskEntity, 'failedTask')
+        .where('failedTask.id = failure.taskId ')
+        .andWhere('failedTask.status IN (:...stuckOpenTaskStatuses) ')
+        .getQuery();
+    const laterResubmission = query
+        .subQuery()
+        .select('1')
+        .from(activity_log_entity_1.ActivityLogEntity, 'resubmitted')
+        .where('resubmitted.instanceId = failure.instanceId ')
+        .andWhere('resubmitted.eventType = :stuckResubmittedEventType ')
+        .andWhere('resubmitted.seq > failure.seq ')
+        .getQuery();
+    // The event type is a literal, not a parameter: Postgres can use the
+    // partial index `IDX_activity_logs_advance_failed` (migration 0000000033000)
+    // only when the plan can see the value matches its WHERE clause.
+    return query
+        .where(`failure.eventType = '${workflow_engine_enums_1.ActivityLogEventTypeEnum.ADVANCE_FAILED}' `)
+        .andWhere(new typeorm_1.Brackets((either) => {
+        either
+            .where(`${FAILURE_KIND_SQL} = 'DECISION' AND stuckInstance.state = :stuckRunningState AND EXISTS ${openTask}`)
+            .orWhere(`${FAILURE_KIND_SQL} = 'RESUBMIT' AND stuckInstance.state = :stuckReturnedState AND NOT EXISTS ${laterResubmission}`);
+    }))
+        .setParameters({
+        stuckOpenTaskStatuses: [...openTaskStatuses],
+        stuckResubmittedEventType: workflow_engine_enums_1.ActivityLogEventTypeEnum.INSTANCE_RESUBMITTED,
+        stuckReturnedState: workflow_engine_enums_1.ApprovalInstanceStateEnum.RETURNED,
+        stuckRunningState: workflow_engine_enums_1.ApprovalInstanceStateEnum.RUNNING,
+    });
+}
+/**
+ * One page of stuck instances, as the ids of the failure that describes each:
+ * its latest unresolved `ADVANCE_FAILED` (highest `seq`). Newest failure first:
+ * `created_at` is the transaction start, so `seq` breaks a tie within one
+ * transaction, and the instance id any tie left after that.
+ */
+async function readStuckFailurePage(manager, openTaskStatuses, page) {
+    const latest = createUnresolvedFailureQuery(manager, openTaskStatuses)
+        .select('failure.id', 'failureId')
+        .addSelect('failure.instanceId', 'instanceId')
+        .addSelect('failure.createdAt', 'createdAt')
+        .addSelect('failure.seq', 'seq')
+        .distinctOn(['failure.instanceId'])
+        .orderBy('failure.instanceId', 'ASC')
+        .addOrderBy('failure.seq', 'DESC');
+    const rows = await manager
+        .createQueryBuilder()
+        .select('"latest"."failureId"', 'failureId')
+        .from(`(${latest.getQuery()})`, 'latest')
+        .setParameters(latest.getParameters())
+        .orderBy('"latest"."createdAt"', 'DESC')
+        .addOrderBy('"latest"."seq"', 'DESC')
+        .addOrderBy('"latest"."instanceId"', 'ASC')
+        .offset(page.offset)
+        .limit(page.limit)
+        .getRawMany();
+    return rows.map((row) => row.failureId);
+}
+/** How many instances {@link readStuckFailurePage} pages through. */
+async function countStuckInstances(manager, openTaskStatuses) {
+    const row = await createUnresolvedFailureQuery(manager, openTaskStatuses)
+        .select('COUNT(DISTINCT failure.instanceId)', 'count')
+        .getRawOne();
+    return Number(row?.count ?? 0);
+}
+//# sourceMappingURL=stuck-approval-instance.query.js.map

package/src/lib/workflow-engine/stuck-approval-instance.query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stuck-approval-instance.query.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/workflow-engine/stuck-approval-instance.query.ts"],"names":[],"mappings":"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"}

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

@@ -55,6 +55,11 @@ export declare enum MemberTaskRoleEnum {
     ASSIGNEE = "ASSIGNEE",
     CANDIDATE = "CANDIDATE"
 }
+/** What stopped a stuck instance: a decision on a task, or a resubmission after a return. */
+export declare enum StuckApprovalInstanceKindEnum {
+    DECISION = "DECISION",
+    RESUBMIT = "RESUBMIT"
+}
 export declare enum TaskReassignmentOutcomeEnum {
     REASSIGNED = "REASSIGNED",
     REJECTED = "REJECTED",
@@ -86,6 +91,12 @@ export declare enum ActivityLogEventTypeEnum {
     ADHOC_DIRECTIVE_CANCELLED = "ADHOC_DIRECTIVE_CANCELLED",
     ADHOC_DIRECTIVE_CREATED = "ADHOC_DIRECTIVE_CREATED",
     ADHOC_PRE_APPROVAL_RETURNED = "ADHOC_PRE_APPROVAL_RETURNED",
+    /**
+     * A decision or a resubmission could not move the instance on (the next stage
+     * had no resolvable approver, say). The transaction rolled back, so the task
+     * is still open or the instance is still returned; this row is the only trace.
+     */
+    ADVANCE_FAILED = "ADVANCE_FAILED",
     ENGINE_PROCESS_REQUESTED = "ENGINE_PROCESS_REQUESTED",
     INSTANCE_CANCELLED = "INSTANCE_CANCELLED",
     /** SLA `TERMINATE_INSTANCE` ended the instance; it has no actor. */

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ActivityLogEventTypeEnum = exports.TaskDecisionActionEnum = exports.TaskReassignmentErrorCodeEnum = exports.TaskReassignmentOutcomeEnum = exports.MemberTaskRoleEnum = exports.TaskCandidateStatusEnum = exports.TaskAssignmentTypeEnum = exports.TaskStatusEnum = exports.WorkflowTokenStatusEnum = exports.ApprovalInstanceSortDirectionEnum = exports.ApprovalInstanceFieldFilterOperatorEnum = exports.ApprovalInstanceListViewEnum = exports.ApprovalInstanceStateEnum = void 0;
+exports.ActivityLogEventTypeEnum = exports.TaskDecisionActionEnum = exports.TaskReassignmentErrorCodeEnum = exports.TaskReassignmentOutcomeEnum = exports.StuckApprovalInstanceKindEnum = exports.MemberTaskRoleEnum = exports.TaskCandidateStatusEnum = exports.TaskAssignmentTypeEnum = exports.TaskStatusEnum = exports.WorkflowTokenStatusEnum = exports.ApprovalInstanceSortDirectionEnum = exports.ApprovalInstanceFieldFilterOperatorEnum = exports.ApprovalInstanceListViewEnum = exports.ApprovalInstanceStateEnum = void 0;
 const graphql_1 = require("@nestjs/graphql");
 var ApprovalInstanceStateEnum;
 (function (ApprovalInstanceStateEnum) {
@@ -68,6 +68,12 @@ var MemberTaskRoleEnum;
     MemberTaskRoleEnum["ASSIGNEE"] = "ASSIGNEE";
     MemberTaskRoleEnum["CANDIDATE"] = "CANDIDATE";
 })(MemberTaskRoleEnum || (exports.MemberTaskRoleEnum = MemberTaskRoleEnum = {}));
+/** What stopped a stuck instance: a decision on a task, or a resubmission after a return. */
+var StuckApprovalInstanceKindEnum;
+(function (StuckApprovalInstanceKindEnum) {
+    StuckApprovalInstanceKindEnum["DECISION"] = "DECISION";
+    StuckApprovalInstanceKindEnum["RESUBMIT"] = "RESUBMIT";
+})(StuckApprovalInstanceKindEnum || (exports.StuckApprovalInstanceKindEnum = StuckApprovalInstanceKindEnum = {}));
 var TaskReassignmentOutcomeEnum;
 (function (TaskReassignmentOutcomeEnum) {
     TaskReassignmentOutcomeEnum["REASSIGNED"] = "REASSIGNED";
@@ -103,6 +109,12 @@ var ActivityLogEventTypeEnum;
     ActivityLogEventTypeEnum["ADHOC_DIRECTIVE_CANCELLED"] = "ADHOC_DIRECTIVE_CANCELLED";
     ActivityLogEventTypeEnum["ADHOC_DIRECTIVE_CREATED"] = "ADHOC_DIRECTIVE_CREATED";
     ActivityLogEventTypeEnum["ADHOC_PRE_APPROVAL_RETURNED"] = "ADHOC_PRE_APPROVAL_RETURNED";
+    /**
+     * A decision or a resubmission could not move the instance on (the next stage
+     * had no resolvable approver, say). The transaction rolled back, so the task
+     * is still open or the instance is still returned; this row is the only trace.
+     */
+    ActivityLogEventTypeEnum["ADVANCE_FAILED"] = "ADVANCE_FAILED";
     ActivityLogEventTypeEnum["ENGINE_PROCESS_REQUESTED"] = "ENGINE_PROCESS_REQUESTED";
     ActivityLogEventTypeEnum["INSTANCE_CANCELLED"] = "INSTANCE_CANCELLED";
     /** SLA `TERMINATE_INSTANCE` ended the instance; it has no actor. */
@@ -157,6 +169,9 @@ var ActivityLogEventTypeEnum;
 (0, graphql_1.registerEnumType)(MemberTaskRoleEnum, {
     name: 'MemberTaskRole',
 });
+(0, graphql_1.registerEnumType)(StuckApprovalInstanceKindEnum, {
+    name: 'StuckApprovalInstanceKind',
+});
 (0, graphql_1.registerEnumType)(TaskReassignmentOutcomeEnum, {
     name: 'TaskReassignmentOutcome',
 });

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":"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"}

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

@@ -4,6 +4,7 @@ import { AdhocPreApprovalRejectBehaviorEnum } from './adhoc.enums';
 import { ApprovalInstanceEntity } from './approval-instance.entity';
 import { AdhocNotificationInput } from './dto/adhoc-notification.input';
 import { AdhocTargetInput } from './dto/adhoc-target.input';
+import { AdminCancelApprovalInstanceInput } from './dto/admin-cancel-approval-instance.input';
 import { CancelApprovalInstanceInput } from './dto/cancel-approval-instance.input';
 import { DecideTaskInput } from './dto/decide-task.input';
 import { DryRunApprovalWorkflowInput } from './dto/dry-run-approval-workflow.input';
@@ -25,6 +26,7 @@ export declare class WorkflowEngineMutations {
     reassignMemberTasks(input: ReassignMemberTasksInput, currentMemberId: string): Promise<readonly TaskReassignmentResultObject[]>;
     reassignTask(input: ReassignTaskInput, currentMemberId: string): Promise<TaskReassignmentResultObject>;
     cancelApprovalInstance(input: CancelApprovalInstanceInput, currentMemberId: string): Promise<ApprovalInstanceEntity>;
+    adminCancelApprovalInstance(input: AdminCancelApprovalInstanceInput, currentMemberId: string): Promise<ApprovalInstanceEntity>;
     resubmitApprovalInstance(input: ResubmitApprovalInstanceInput, currentMemberId: string, authContext: BPMAuthContext): Promise<ApprovalInstanceEntity>;
     dryRunApprovalWorkflow(input: DryRunApprovalWorkflowInput): Promise<WorkflowDryRunResultObject>;
     requestAdhocCountersign(taskId: string, target: AdhocTargetInput, comment: string | null, currentMemberId: string): Promise<AdhocDirectiveEntity>;

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

@@ -10,6 +10,7 @@ const adhoc_enums_1 = require("./adhoc.enums");
 const approval_instance_entity_1 = require("./approval-instance.entity");
 const adhoc_notification_input_1 = require("./dto/adhoc-notification.input");
 const adhoc_target_input_1 = require("./dto/adhoc-target.input");
+const admin_cancel_approval_instance_input_1 = require("./dto/admin-cancel-approval-instance.input");
 const cancel_approval_instance_input_1 = require("./dto/cancel-approval-instance.input");
 const decide_task_input_1 = require("./dto/decide-task.input");
 const dry_run_approval_workflow_input_1 = require("./dto/dry-run-approval-workflow.input");
@@ -70,6 +71,7 @@ let WorkflowEngineMutations = class WorkflowEngineMutations {
             dryRun: input.dryRun,
             fromMemberId: input.fromMemberId,
             reason: input.reason,
+            taskIds: input.taskIds,
             toMemberId: input.toMemberId,
         });
     }
@@ -88,6 +90,13 @@ let WorkflowEngineMutations = class WorkflowEngineMutations {
             cancelledByMemberId: currentMemberId,
         });
     }
+    async adminCancelApprovalInstance(input, currentMemberId) {
+        return this.workflowEngineService.adminCancelApprovalInstance({
+            cancelledByMemberId: currentMemberId,
+            instanceId: input.instanceId,
+            reason: input.reason,
+        });
+    }
     async resubmitApprovalInstance(input, currentMemberId, authContext) {
         return this.workflowEngineService.resubmitApprovalInstance({
             ...input,
@@ -170,9 +179,12 @@ tslib_1.__decorate([
 ], WorkflowEngineMutations.prototype, "decideTask", null);
 tslib_1.__decorate([
     (0, graphql_1.Mutation)(() => [task_reassignment_object_1.TaskReassignmentResultObject], {
-        description: 'Administrator: moves every open task the source member holds to the ' +
-            'target, one transaction per task, one result per task. Set dryRun to ' +
-            'report the outcomes without writing.',
+        description: 'Administrator: moves the open tasks the source member holds (all of ' +
+            'them, or only taskIds) to the target, one transaction per task, one ' +
+            'result per task. Set dryRun to ' +
+            'report the outcomes without writing. Set taskIds to move only those ' +
+            'tasks (ids the member does not hold return no result row); omit it for ' +
+            'every open task, and an empty list is refused.',
     }),
     (0, bpm_auth_1.BPMAdminOnly)(),
     tslib_1.__param(0, (0, graphql_1.Args)('input')),
@@ -203,6 +215,22 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:paramtypes", [cancel_approval_instance_input_1.CancelApprovalInstanceInput, String]),
     tslib_1.__metadata("design:returntype", Promise)
 ], WorkflowEngineMutations.prototype, "cancelApprovalInstance", null);
+tslib_1.__decorate([
+    (0, graphql_1.Mutation)(() => approval_instance_entity_1.ApprovalInstanceEntity, {
+        description: 'Administrator: ends a running or returned instance whoever started ' +
+            'it. The reason is required; it is recorded on the instance and sent ' +
+            'to the initiator as an in-app notification (not sent when the ' +
+            'administrator is the initiator). The cancellation is recorded with ' +
+            '`cancelledByAdministrator: true` so a host can tell it from the ' +
+            'initiator withdrawing.',
+    }),
+    (0, bpm_auth_1.BPMAdminOnly)(),
+    tslib_1.__param(0, (0, graphql_1.Args)('input')),
+    tslib_1.__param(1, (0, bpm_auth_1.BPMCurrentMemberId)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [admin_cancel_approval_instance_input_1.AdminCancelApprovalInstanceInput, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], WorkflowEngineMutations.prototype, "adminCancelApprovalInstance", null);
 tslib_1.__decorate([
     (0, graphql_1.Mutation)(() => approval_instance_entity_1.ApprovalInstanceEntity),
     tslib_1.__param(0, (0, graphql_1.Args)('input')),

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

@@ -1 +1 @@
-{"version":3,"file":"workflow-engine.mutations.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/workflow-engine/workflow-engine.mutations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow-engine.mutations.js","sourceRoot":"","sources":["../../../../../../libs/bpm-core/src/lib/workflow-engine/workflow-engine.mutations.ts"],"names":[],"mappings":"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"}

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

@@ -1,6 +1,6 @@
 import { ModuleRef } from '@nestjs/core';
 import { BPMAuthContext } from '../bpm-auth';
-import { InactiveMemberOpenTasksRecord, MemberOpenTaskRecord } from './workflow-engine.service';
+import { InactiveMemberOpenTasksRecord, MemberOpenTaskRecord, StuckApprovalInstanceRecord } from './workflow-engine.service';
 import { ActivityLogEntity } from './activity-log.entity';
 import { AdhocDirectiveEntity } from './adhoc-directive.entity';
 import { ApprovalInstanceEntity } from './approval-instance.entity';
@@ -32,6 +32,8 @@ export declare class WorkflowEngineQueries {
     approvalHistoryTaskCount(currentMemberId: string, instanceState: ApprovalInstanceStateEnum | null, templateIds: readonly string[] | null, templateKey: string | null): Promise<number>;
     memberOpenTasks(memberId: string): Promise<readonly MemberOpenTaskRecord[]>;
     inactiveMembersWithOpenTasks(): Promise<readonly InactiveMemberOpenTasksRecord[]>;
+    stuckApprovalInstances(page: number | null, pageSize: number | null): Promise<readonly StuckApprovalInstanceRecord[]>;
+    stuckApprovalInstanceCount(): Promise<number>;
     launchableApprovalTemplates(currentMemberId: string, currentAuthContext: BPMAuthContext): Promise<readonly ApprovalTemplateEntity[]>;
     taskDecisions(taskId: string, currentAuthContext: BPMAuthContext): Promise<readonly TaskDecisionEntity[]>;
     taskCandidates(taskId: string, currentAuthContext: BPMAuthContext): Promise<readonly TaskCandidateEntity[]>;

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

@@ -8,6 +8,7 @@ const graphql_1 = require("@nestjs/graphql");
 const bpm_auth_1 = require("../bpm-auth");
 const identity_service_1 = require("../identity/identity.service");
 const task_reassignment_object_1 = require("./task-reassignment.object");
+const stuck_approval_instance_object_1 = require("./stuck-approval-instance.object");
 const activity_log_entity_1 = require("./activity-log.entity");
 const adhoc_directive_entity_1 = require("./adhoc-directive.entity");
 const approval_instance_entity_1 = require("./approval-instance.entity");
@@ -119,6 +120,15 @@ let WorkflowEngineQueries = class WorkflowEngineQueries {
         }
         return this.workflowEngineService.listInactiveMembersWithOpenTasks((memberIds) => identityService.resolveInactiveMembers(memberIds));
     }
+    async stuckApprovalInstances(page, pageSize) {
+        return this.workflowEngineService.listStuckApprovalInstances({
+            page: page ?? undefined,
+            pageSize: pageSize ?? undefined,
+        });
+    }
+    async stuckApprovalInstanceCount() {
+        return this.workflowEngineService.countStuckApprovalInstances();
+    }
     async launchableApprovalTemplates(currentMemberId, currentAuthContext) {
         return this.workflowEngineService.listLaunchableApprovalTemplates(currentMemberId, currentAuthContext);
     }
@@ -381,6 +391,30 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:paramtypes", []),
     tslib_1.__metadata("design:returntype", Promise)
 ], WorkflowEngineQueries.prototype, "inactiveMembersWithOpenTasks", null);
+tslib_1.__decorate([
+    (0, graphql_1.Query)(() => [stuck_approval_instance_object_1.StuckApprovalInstanceObject], {
+        description: 'Administrator: the RUNNING or RETURNED instances that could not move ' +
+            'on to their next stage and still cannot, newest failure first, one ' +
+            'row each. Each row says who has to press again now. Always paged: ' +
+            'page defaults to 1, pageSize to 20 (at most 100); ' +
+            'stuckApprovalInstanceCount gives the total.',
+    }),
+    (0, bpm_auth_1.BPMAdminOnly)(),
+    tslib_1.__param(0, (0, graphql_1.Args)('page', { nullable: true, type: () => graphql_1.Int })),
+    tslib_1.__param(1, (0, graphql_1.Args)('pageSize', { nullable: true, type: () => graphql_1.Int })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], WorkflowEngineQueries.prototype, "stuckApprovalInstances", null);
+tslib_1.__decorate([
+    (0, graphql_1.Query)(() => graphql_1.Int, {
+        description: 'Administrator: how many instances stuckApprovalInstances pages through.',
+    }),
+    (0, bpm_auth_1.BPMAdminOnly)(),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], WorkflowEngineQueries.prototype, "stuckApprovalInstanceCount", null);
 tslib_1.__decorate([
     (0, graphql_1.Query)(() => [approval_template_entity_1.ApprovalTemplateEntity]),
     tslib_1.__param(0, (0, bpm_auth_1.BPMCurrentMemberId)()),