/
goalApprovalRequestVote.ts
100 lines (87 loc) · 3.02 KB
/
goalApprovalRequestVote.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
/*
* Copyright © 2019 Atomist, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
import { logger } from "@atomist/automation-client/lib/util/logger";
import { RepoContext } from "../context/SdmContext";
import { SdmGoalEvent } from "../goal/SdmGoalEvent";
/**
* Represents a vote on a approval request
*/
export enum GoalApprovalRequestVote {
/**
* Voter decided to abstain from voting
*/
Abstain = "abstain",
/**
* Voter decided to grant the approval request
*/
Granted = "granted",
/**
* Voter decided to deny the approval request
*/
Denied = "denied",
}
/**
* Result from executing GoalApprovalRequestVoter
*/
export interface GoalApprovalRequestVoteResult {
/**
* The vote
*/
vote: GoalApprovalRequestVote;
/**
* Optional text describing why the decision was being made
*/
reason?: string;
}
/**
* Invocation of a GoalApprovalRequestVoter
*/
export interface GoalApprovalRequestVoterInvocation extends RepoContext {
/**
* Goal that was requested for approval
*/
goal: SdmGoalEvent;
}
/**
* Voter on a request to approve a goal
*/
export type GoalApprovalRequestVoter =
(garvi: GoalApprovalRequestVoterInvocation) => Promise<GoalApprovalRequestVoteResult>;
/**
* Decide resulting vote on a set of votes
*/
export type GoalApprovalRequestVoteDecisionManager =
(...votes: GoalApprovalRequestVoteResult[]) => GoalApprovalRequestVote;
/**
* Default GoalApprovalRequestVoteDecisionManager that decides unanimously on votes.
* One denied vote will deny the approval request; all granted votes with grant the request.
* All other votes with result in an abstained approval request.
* @param votes
*/
export const UnanimousGoalApprovalRequestVoteDecisionManager: GoalApprovalRequestVoteDecisionManager =
(...votes: GoalApprovalRequestVoteResult[]) => {
logger.debug(`Deciding on provided votes '${votes.map(v => v.vote).join(", ")}'`);
if (votes.some(v => v.vote === GoalApprovalRequestVote.Denied)) {
logger.debug("At least one denied vote. Denying approval request");
return GoalApprovalRequestVote.Denied;
} else if (!votes.some(v => v.vote !== GoalApprovalRequestVote.Granted)) {
logger.debug("All votes granted. Granting approval request");
return GoalApprovalRequestVote.Granted;
} else {
logger.debug("Some abstain and granted votes. Abstaining approval request");
return GoalApprovalRequestVote.Abstain;
}
};