sf-flow-coverage 0.0.0-stage → 0.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.md +9 -0
- package/README.md +275 -2
- package/lib/commands/flowcov/gate.d.ts +17 -0
- package/lib/commands/flowcov/gate.js +82 -0
- package/lib/commands/flowcov/gate.js.map +1 -0
- package/lib/commands/flowcov/readiness.d.ts +17 -0
- package/lib/commands/flowcov/readiness.js +87 -0
- package/lib/commands/flowcov/readiness.js.map +1 -0
- package/lib/commands/flowcov/scaffold.d.ts +18 -0
- package/lib/commands/flowcov/scaffold.js +76 -0
- package/lib/commands/flowcov/scaffold.js.map +1 -0
- package/lib/core/apexTemplate.d.ts +18 -0
- package/lib/core/apexTemplate.js +310 -0
- package/lib/core/apexTemplate.js.map +1 -0
- package/lib/core/flowTypes.d.ts +16 -0
- package/lib/core/flowTypes.js +29 -0
- package/lib/core/flowTypes.js.map +1 -0
- package/lib/core/flowXml.d.ts +8 -0
- package/lib/core/flowXml.js +97 -0
- package/lib/core/flowXml.js.map +1 -0
- package/lib/core/gate.d.ts +20 -0
- package/lib/core/gate.js +92 -0
- package/lib/core/gate.js.map +1 -0
- package/lib/core/git.d.ts +13 -0
- package/lib/core/git.js +81 -0
- package/lib/core/git.js.map +1 -0
- package/lib/core/orgCoverageSource.d.ts +17 -0
- package/lib/core/orgCoverageSource.js +108 -0
- package/lib/core/orgCoverageSource.js.map +1 -0
- package/lib/core/projectFiles.d.ts +9 -0
- package/lib/core/projectFiles.js +48 -0
- package/lib/core/projectFiles.js.map +1 -0
- package/lib/core/readiness.d.ts +12 -0
- package/lib/core/readiness.js +37 -0
- package/lib/core/readiness.js.map +1 -0
- package/lib/core/requiredFields.d.ts +27 -0
- package/lib/core/requiredFields.js +75 -0
- package/lib/core/requiredFields.js.map +1 -0
- package/lib/core/scaffold.d.ts +18 -0
- package/lib/core/scaffold.js +79 -0
- package/lib/core/scaffold.js.map +1 -0
- package/lib/core/toolingQuery.d.ts +7 -0
- package/lib/core/toolingQuery.js +16 -0
- package/lib/core/toolingQuery.js.map +1 -0
- package/lib/core/types.d.ts +117 -0
- package/lib/core/types.js +2 -0
- package/lib/core/types.js.map +1 -0
- package/lib/index.d.ts +14 -0
- package/lib/index.js +10 -0
- package/lib/index.js.map +1 -0
- package/messages/flowcov.gate.md +49 -0
- package/messages/flowcov.readiness.md +39 -0
- package/messages/flowcov.scaffold.md +59 -0
- package/oclif.manifest.json +317 -0
- package/package.json +311 -3
|
@@ -0,0 +1,310 @@
|
|
|
1
|
+
import { escapeApexString } from './flowXml.js';
|
|
2
|
+
const MAX_CLASS_NAME = 40;
|
|
3
|
+
const CLASS_SUFFIX = '_FlowTest';
|
|
4
|
+
const INDENT = ' ';
|
|
5
|
+
/** Required fields (with test values) for common standard objects. Custom objects get a TODO. */
|
|
6
|
+
const REQUIRED_FIELDS = {
|
|
7
|
+
Account: { Name: "'Test Account'" },
|
|
8
|
+
Contact: { LastName: "'Test'" },
|
|
9
|
+
Lead: { LastName: "'Test'", Company: "'Test Company'" },
|
|
10
|
+
Opportunity: { Name: "'Test Opportunity'", StageName: "'Prospecting'", CloseDate: 'Date.today().addDays(30)' },
|
|
11
|
+
Case: { Subject: "'Test Case'" },
|
|
12
|
+
Campaign: { Name: "'Test Campaign'" },
|
|
13
|
+
Product2: { Name: "'Test Product'" },
|
|
14
|
+
Task: { Subject: "'Test Task'" },
|
|
15
|
+
Event: { Subject: "'Test Event'", DurationInMinutes: '30', ActivityDateTime: 'Datetime.now()' },
|
|
16
|
+
Contract: { AccountId: 'null /* TODO: set an Account Id */' },
|
|
17
|
+
Order: { AccountId: 'null /* TODO: set an Account Id */', EffectiveDate: 'Date.today()', Status: "'Draft'" },
|
|
18
|
+
};
|
|
19
|
+
/** Builds a valid Apex class name `<Flow>_FlowTest`, at most 40 characters. */
|
|
20
|
+
export function apexTestClassName(flowName) {
|
|
21
|
+
let base = flowName
|
|
22
|
+
.replace(/[^A-Za-z0-9_]/g, '_')
|
|
23
|
+
.replace(/_+/g, '_')
|
|
24
|
+
.replace(/^_+|_+$/g, '');
|
|
25
|
+
if (!/^[A-Za-z]/.test(base))
|
|
26
|
+
base = `F${base}`;
|
|
27
|
+
base = base.slice(0, MAX_CLASS_NAME - CLASS_SUFFIX.length).replace(/_+$/, '');
|
|
28
|
+
return `${base}${CLASS_SUFFIX}`;
|
|
29
|
+
}
|
|
30
|
+
export function flowKind(flow) {
|
|
31
|
+
const processType = flow.processType?.toLowerCase();
|
|
32
|
+
if (processType !== 'autolaunchedflow')
|
|
33
|
+
return 'process';
|
|
34
|
+
const trigger = flow.triggerType;
|
|
35
|
+
if (trigger?.startsWith('Record') && flow.object)
|
|
36
|
+
return 'record';
|
|
37
|
+
if (trigger === 'PlatformEvent' && flow.object)
|
|
38
|
+
return 'platformEvent';
|
|
39
|
+
if (trigger === 'Scheduled')
|
|
40
|
+
return 'scheduled';
|
|
41
|
+
return 'autolaunched';
|
|
42
|
+
}
|
|
43
|
+
const camel = (name) => {
|
|
44
|
+
const cleaned = name.replace(/__c$|__e$/i, '').replace(/[^A-Za-z0-9]/g, '');
|
|
45
|
+
return cleaned.charAt(0).toLowerCase() + cleaned.slice(1);
|
|
46
|
+
};
|
|
47
|
+
function header(flow, description) {
|
|
48
|
+
return [
|
|
49
|
+
'/**',
|
|
50
|
+
` * Starter test generated by sf-flow-coverage for the Flow ${flow.name}${flow.label ? ` (${flow.label})` : ''}.`,
|
|
51
|
+
` * ${description}`,
|
|
52
|
+
' * Running this test gives the Flow coverage toward "Deploy processes and flows as active".',
|
|
53
|
+
' * Replace the TODOs with real data and assertions on what the Flow does.',
|
|
54
|
+
' */',
|
|
55
|
+
'@IsTest',
|
|
56
|
+
];
|
|
57
|
+
}
|
|
58
|
+
function isSimpleField(field) {
|
|
59
|
+
return /^[A-Za-z][A-Za-z0-9_]*$/.test(field);
|
|
60
|
+
}
|
|
61
|
+
/** Entry-criteria fields the generator can set directly (field EqualTo literal). */
|
|
62
|
+
function settableCriteria(filters) {
|
|
63
|
+
return filters.filter((f) => f.operator === 'EqualTo' && f.apexValue !== undefined && isSimpleField(f.field));
|
|
64
|
+
}
|
|
65
|
+
function criteriaTodos(flow, settable) {
|
|
66
|
+
const todos = [];
|
|
67
|
+
for (const filter of flow.filters) {
|
|
68
|
+
if (settable.includes(filter))
|
|
69
|
+
continue;
|
|
70
|
+
const value = filter.rawValue === undefined ? '' : ` ${filter.rawValue}`;
|
|
71
|
+
todos.push(`// TODO: entry criteria: ${filter.field} ${filter.operator}${value}`);
|
|
72
|
+
}
|
|
73
|
+
if (flow.filterFormula)
|
|
74
|
+
todos.push(`// TODO: entry criteria formula: ${flow.filterFormula.replace(/\s+/g, ' ')}`);
|
|
75
|
+
if (flow.filterLogic && !['and', 'or'].includes(flow.filterLogic.toLowerCase())) {
|
|
76
|
+
todos.push(`// TODO: entry criteria logic: ${flow.filterLogic}`);
|
|
77
|
+
}
|
|
78
|
+
return todos;
|
|
79
|
+
}
|
|
80
|
+
/** Described required fields win over the built-in list for standard objects. */
|
|
81
|
+
function knownRequired(object, required) {
|
|
82
|
+
return required[object] ?? REQUIRED_FIELDS[object];
|
|
83
|
+
}
|
|
84
|
+
function recordFields(object, criteria, required) {
|
|
85
|
+
const fields = new Map(Object.entries(knownRequired(object, required) ?? {}));
|
|
86
|
+
for (const filter of criteria)
|
|
87
|
+
fields.set(filter.field, filter.apexValue);
|
|
88
|
+
return [...fields].map(([field, value]) => `${field} = ${value}`);
|
|
89
|
+
}
|
|
90
|
+
function newRecord(object, variable, fields, indent, required) {
|
|
91
|
+
const lines = [];
|
|
92
|
+
if (fields.length === 0) {
|
|
93
|
+
lines.push(`${indent}${object} ${variable} = new ${object}();`);
|
|
94
|
+
}
|
|
95
|
+
else {
|
|
96
|
+
lines.push(`${indent}${object} ${variable} = new ${object}(`);
|
|
97
|
+
fields.forEach((field, i) => lines.push(`${indent}${INDENT}${field}${i < fields.length - 1 ? ',' : ''}`));
|
|
98
|
+
lines.push(`${indent});`);
|
|
99
|
+
}
|
|
100
|
+
if (!knownRequired(object, required))
|
|
101
|
+
lines.push(`${indent}// TODO: set the required fields for ${object}`);
|
|
102
|
+
return lines;
|
|
103
|
+
}
|
|
104
|
+
function recordMethods(flow, required) {
|
|
105
|
+
const object = flow.object;
|
|
106
|
+
// A fixed name avoids Apex reserved words (`case`, `order`, `group`) that object names produce.
|
|
107
|
+
const variable = 'testRecord';
|
|
108
|
+
const settable = settableCriteria(flow.filters);
|
|
109
|
+
const todos = criteriaTodos(flow, settable);
|
|
110
|
+
const i2 = INDENT.repeat(2);
|
|
111
|
+
const requery = (assertion) => [
|
|
112
|
+
`${i2}${object} result = [SELECT Id FROM ${object} WHERE Id = :${variable}.Id];`,
|
|
113
|
+
`${i2}// TODO: query and assert the fields this Flow sets`,
|
|
114
|
+
`${i2}${assertion}`,
|
|
115
|
+
];
|
|
116
|
+
const method = (name, body) => [
|
|
117
|
+
`${INDENT}@IsTest`,
|
|
118
|
+
`${INDENT}static void ${name}() {`,
|
|
119
|
+
...body,
|
|
120
|
+
`${INDENT}}`,
|
|
121
|
+
];
|
|
122
|
+
const createBody = () => [
|
|
123
|
+
...newRecord(object, variable, recordFields(object, settable, required), i2, required),
|
|
124
|
+
...todos.map((t) => `${i2}${t}`),
|
|
125
|
+
'',
|
|
126
|
+
`${i2}Test.startTest();`,
|
|
127
|
+
`${i2}insert ${variable};`,
|
|
128
|
+
`${i2}Test.stopTest();`,
|
|
129
|
+
'',
|
|
130
|
+
...requery(`Assert.isNotNull(result.Id, 'The ${object} should be saved');`),
|
|
131
|
+
];
|
|
132
|
+
const updateBody = () => {
|
|
133
|
+
const lines = [
|
|
134
|
+
...newRecord(object, variable, recordFields(object, [], required), i2, required),
|
|
135
|
+
`${i2}insert ${variable};`,
|
|
136
|
+
'',
|
|
137
|
+
`${i2}Test.startTest();`,
|
|
138
|
+
];
|
|
139
|
+
for (const filter of settable)
|
|
140
|
+
lines.push(`${i2}${variable}.${filter.field} = ${filter.apexValue};`);
|
|
141
|
+
lines.push(...todos.map((t) => `${i2}${t}`));
|
|
142
|
+
if (settable.length === 0 && todos.length === 0)
|
|
143
|
+
lines.push(`${i2}// TODO: change the fields this Flow reacts to`);
|
|
144
|
+
lines.push(`${i2}update ${variable};`, `${i2}Test.stopTest();`, '');
|
|
145
|
+
return [...lines, ...requery(`Assert.isNotNull(result.Id, 'The ${object} should still exist');`)];
|
|
146
|
+
};
|
|
147
|
+
const deleteBody = () => [
|
|
148
|
+
...newRecord(object, variable, recordFields(object, settable, required), i2, required),
|
|
149
|
+
...todos.map((t) => `${i2}${t}`),
|
|
150
|
+
`${i2}insert ${variable};`,
|
|
151
|
+
'',
|
|
152
|
+
`${i2}Test.startTest();`,
|
|
153
|
+
`${i2}delete ${variable};`,
|
|
154
|
+
`${i2}Test.stopTest();`,
|
|
155
|
+
'',
|
|
156
|
+
`${i2}// TODO: assert what this Flow does when the record is deleted`,
|
|
157
|
+
`${i2}Assert.areEqual(0, [SELECT COUNT() FROM ${object} WHERE Id = :${variable}.Id], 'The ${object} should be deleted');`,
|
|
158
|
+
];
|
|
159
|
+
switch (flow.recordTriggerType) {
|
|
160
|
+
case 'Update':
|
|
161
|
+
return method('runsFlowOnUpdate', updateBody());
|
|
162
|
+
case 'CreateAndUpdate':
|
|
163
|
+
return [...method('runsFlowOnCreate', createBody()), '', ...method('runsFlowOnUpdate', updateBody())];
|
|
164
|
+
case 'Delete':
|
|
165
|
+
return method('runsFlowOnDelete', deleteBody());
|
|
166
|
+
default:
|
|
167
|
+
return method('runsFlowOnCreate', createBody());
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
function inputValue(variable) {
|
|
171
|
+
if (variable.isCollection) {
|
|
172
|
+
const element = {
|
|
173
|
+
String: 'String',
|
|
174
|
+
Picklist: 'String',
|
|
175
|
+
Multipicklist: 'String',
|
|
176
|
+
Boolean: 'Boolean',
|
|
177
|
+
Number: 'Decimal',
|
|
178
|
+
Currency: 'Decimal',
|
|
179
|
+
Date: 'Date',
|
|
180
|
+
DateTime: 'Datetime',
|
|
181
|
+
};
|
|
182
|
+
if (variable.dataType === 'SObject' && variable.objectType)
|
|
183
|
+
return `new List<${variable.objectType}>()`;
|
|
184
|
+
if (element[variable.dataType])
|
|
185
|
+
return `new List<${element[variable.dataType]}>()`;
|
|
186
|
+
return 'null';
|
|
187
|
+
}
|
|
188
|
+
switch (variable.dataType) {
|
|
189
|
+
case 'String':
|
|
190
|
+
case 'Picklist':
|
|
191
|
+
case 'Multipicklist':
|
|
192
|
+
return "'test'";
|
|
193
|
+
case 'Boolean':
|
|
194
|
+
return 'false';
|
|
195
|
+
case 'Number':
|
|
196
|
+
case 'Currency':
|
|
197
|
+
return '0';
|
|
198
|
+
case 'Date':
|
|
199
|
+
return 'Date.today()';
|
|
200
|
+
case 'DateTime':
|
|
201
|
+
return 'Datetime.now()';
|
|
202
|
+
default:
|
|
203
|
+
return 'null';
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
function interviewMethod(flow, name, notes, required) {
|
|
207
|
+
const i2 = INDENT.repeat(2);
|
|
208
|
+
const lines = [`${INDENT}@IsTest`, `${INDENT}static void ${name}() {`, ...notes.map((n) => `${i2}// ${n}`)];
|
|
209
|
+
lines.push(`${i2}Map<String, Object> inputs = new Map<String, Object>();`);
|
|
210
|
+
for (const variable of flow.variables.filter((v) => v.isInput)) {
|
|
211
|
+
if (variable.dataType === 'SObject' && variable.objectType && !variable.isCollection) {
|
|
212
|
+
const local = `${camel(variable.name) || 'input'}Input`;
|
|
213
|
+
lines.push(...newRecord(variable.objectType, local, recordFields(variable.objectType, [], required), i2, required));
|
|
214
|
+
lines.push(`${i2}insert ${local};`, `${i2}inputs.put('${escapeApexString(variable.name)}', ${local});`);
|
|
215
|
+
}
|
|
216
|
+
else {
|
|
217
|
+
const type = variable.apexClass ?? variable.objectType ?? variable.dataType;
|
|
218
|
+
lines.push(`${i2}inputs.put('${escapeApexString(variable.name)}', ${inputValue(variable)}); // TODO: ${type}${variable.isCollection ? ' collection' : ''}`);
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
lines.push('', `${i2}Test.startTest();`, `${i2}Flow.Interview interview = Flow.Interview.createInterview('${escapeApexString(flow.name)}', inputs);`, `${i2}interview.start();`, `${i2}Test.stopTest();`, '', `${i2}// TODO: assert what this Flow does`);
|
|
222
|
+
for (const variable of flow.variables.filter((v) => v.isOutput)) {
|
|
223
|
+
lines.push(`${i2}Object ${camel(variable.name) || 'output'}Output = interview.getVariableValue('${escapeApexString(variable.name)}');`);
|
|
224
|
+
}
|
|
225
|
+
lines.push(`${i2}Assert.isNotNull(interview, 'The Flow interview should run');`, `${INDENT}}`);
|
|
226
|
+
return lines;
|
|
227
|
+
}
|
|
228
|
+
function platformEventMethod(flow, required) {
|
|
229
|
+
const event = flow.object;
|
|
230
|
+
const i2 = INDENT.repeat(2);
|
|
231
|
+
const settable = settableCriteria(flow.filters);
|
|
232
|
+
return [
|
|
233
|
+
`${INDENT}@IsTest`,
|
|
234
|
+
`${INDENT}static void runsFlowOnEvent() {`,
|
|
235
|
+
...newRecord(event, 'testEvent', recordFields(event, settable, required), i2, required).filter((l) => !l.includes('TODO: set the required')),
|
|
236
|
+
`${i2}// TODO: set the event fields this Flow reads`,
|
|
237
|
+
...criteriaTodos(flow, settable).map((t) => `${i2}${t}`),
|
|
238
|
+
'',
|
|
239
|
+
`${i2}Test.startTest();`,
|
|
240
|
+
`${i2}EventBus.publish(testEvent);`,
|
|
241
|
+
`${i2}Test.getEventBus().deliver();`,
|
|
242
|
+
`${i2}Test.stopTest();`,
|
|
243
|
+
'',
|
|
244
|
+
`${i2}// TODO: assert what this Flow does when the event is delivered`,
|
|
245
|
+
`${i2}Assert.isNotNull(testEvent, 'The event should be published');`,
|
|
246
|
+
`${INDENT}}`,
|
|
247
|
+
];
|
|
248
|
+
}
|
|
249
|
+
function processMethod(flow) {
|
|
250
|
+
const i2 = INDENT.repeat(2);
|
|
251
|
+
return [
|
|
252
|
+
`${INDENT}@IsTest`,
|
|
253
|
+
`${INDENT}static void runsProcess() {`,
|
|
254
|
+
`${i2}// TODO: ${flow.processType ?? 'This'} processes start when a record changes or an event fires.`,
|
|
255
|
+
`${i2}// Insert or update a record that meets this process's criteria between startTest and stopTest.`,
|
|
256
|
+
`${i2}Test.startTest();`,
|
|
257
|
+
`${i2}Test.stopTest();`,
|
|
258
|
+
'',
|
|
259
|
+
`${i2}// TODO: assert what this process does`,
|
|
260
|
+
`${i2}Assert.isTrue(true, 'Replace with real assertions');`,
|
|
261
|
+
`${INDENT}}`,
|
|
262
|
+
];
|
|
263
|
+
}
|
|
264
|
+
/** Generates a starter Apex test class for a Flow from its metadata. */
|
|
265
|
+
export function generateApexTest(flow, options = {}) {
|
|
266
|
+
const required = options.requiredFields ?? {};
|
|
267
|
+
const className = apexTestClassName(flow.name);
|
|
268
|
+
const kind = flowKind(flow);
|
|
269
|
+
let description;
|
|
270
|
+
let methods;
|
|
271
|
+
switch (kind) {
|
|
272
|
+
case 'record':
|
|
273
|
+
description = `Record-triggered on ${flow.object} (${flow.recordTriggerType ?? 'Create'}, ${flow.triggerType}).`;
|
|
274
|
+
methods = recordMethods(flow, required);
|
|
275
|
+
break;
|
|
276
|
+
case 'platformEvent':
|
|
277
|
+
description = `Triggered by the platform event ${flow.object}.`;
|
|
278
|
+
methods = platformEventMethod(flow, required);
|
|
279
|
+
break;
|
|
280
|
+
case 'scheduled':
|
|
281
|
+
description = 'Schedule-triggered. Apex tests cannot fire the schedule, so this test starts the Flow directly.';
|
|
282
|
+
methods = interviewMethod(flow, 'runsFlow', [
|
|
283
|
+
flow.object
|
|
284
|
+
? `TODO: this Flow runs for ${flow.object} records on a schedule; $Record is not set when started from Apex.`
|
|
285
|
+
: 'TODO: this Flow runs on a schedule; it is started directly here.',
|
|
286
|
+
'If the Flow depends on $Record, move its logic to an autolaunched subflow and test that instead.',
|
|
287
|
+
], required);
|
|
288
|
+
break;
|
|
289
|
+
case 'autolaunched':
|
|
290
|
+
description = 'Autolaunched (no trigger).';
|
|
291
|
+
methods = interviewMethod(flow, 'runsFlow', [], required);
|
|
292
|
+
break;
|
|
293
|
+
default:
|
|
294
|
+
description = `Process type ${flow.processType ?? 'unknown'}.`;
|
|
295
|
+
methods = processMethod(flow);
|
|
296
|
+
}
|
|
297
|
+
const body = [...header(flow, description), `private class ${className} {`, ...methods, '}', ''].join('\n');
|
|
298
|
+
return { className, body, kind };
|
|
299
|
+
}
|
|
300
|
+
export function apexClassMetaXml(apiVersion) {
|
|
301
|
+
return [
|
|
302
|
+
'<?xml version="1.0" encoding="UTF-8"?>',
|
|
303
|
+
'<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">',
|
|
304
|
+
` <apiVersion>${apiVersion}</apiVersion>`,
|
|
305
|
+
' <status>Active</status>',
|
|
306
|
+
'</ApexClass>',
|
|
307
|
+
'',
|
|
308
|
+
].join('\n');
|
|
309
|
+
}
|
|
310
|
+
//# sourceMappingURL=apexTemplate.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"apexTemplate.js","sourceRoot":"","sources":["../../src/core/apexTemplate.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Flow process types that count toward the 75% coverage requirement for
|
|
3
|
+
* "Deploy processes and flows as active": autolaunched Flows (including
|
|
4
|
+
* record-triggered, platform event and scheduled), and Process Builder processes.
|
|
5
|
+
*/
|
|
6
|
+
export declare const COUNTED_PROCESS_TYPES: readonly ['AutoLaunchedFlow', 'Workflow', 'CustomEvent', 'InvocableProcess'];
|
|
7
|
+
export declare const DEFAULT_THRESHOLD = 75;
|
|
8
|
+
export declare function isCountedProcessType(processType: string | undefined): boolean;
|
|
9
|
+
export declare function qualifiedFlowName(developerName: string, namespacePrefix?: string | null): string;
|
|
10
|
+
/** Splits `ns__Flow_Name` into namespace and developer name. Flow names cannot contain `__`, so the first one is the separator. */
|
|
11
|
+
export declare function splitFlowName(flowName: string): {
|
|
12
|
+
namespacePrefix?: string;
|
|
13
|
+
developerName: string;
|
|
14
|
+
};
|
|
15
|
+
/** Returns the Flow API name for a source-format (`.flow-meta.xml`) or metadata-format (`.flow`) file path, or undefined. */
|
|
16
|
+
export declare function flowNameFromPath(filePath: string): string | undefined;
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Flow process types that count toward the 75% coverage requirement for
|
|
3
|
+
* "Deploy processes and flows as active": autolaunched Flows (including
|
|
4
|
+
* record-triggered, platform event and scheduled), and Process Builder processes.
|
|
5
|
+
*/
|
|
6
|
+
export const COUNTED_PROCESS_TYPES = ['AutoLaunchedFlow', 'Workflow', 'CustomEvent', 'InvocableProcess'];
|
|
7
|
+
export const DEFAULT_THRESHOLD = 75;
|
|
8
|
+
export function isCountedProcessType(processType) {
|
|
9
|
+
if (!processType)
|
|
10
|
+
return false;
|
|
11
|
+
const lower = processType.toLowerCase();
|
|
12
|
+
return COUNTED_PROCESS_TYPES.some((t) => t.toLowerCase() === lower);
|
|
13
|
+
}
|
|
14
|
+
export function qualifiedFlowName(developerName, namespacePrefix) {
|
|
15
|
+
return namespacePrefix ? `${namespacePrefix}__${developerName}` : developerName;
|
|
16
|
+
}
|
|
17
|
+
/** Splits `ns__Flow_Name` into namespace and developer name. Flow names cannot contain `__`, so the first one is the separator. */
|
|
18
|
+
export function splitFlowName(flowName) {
|
|
19
|
+
const index = flowName.indexOf('__');
|
|
20
|
+
if (index <= 0)
|
|
21
|
+
return { developerName: flowName };
|
|
22
|
+
return { namespacePrefix: flowName.slice(0, index), developerName: flowName.slice(index + 2) };
|
|
23
|
+
}
|
|
24
|
+
const FLOW_FILE = /([^/\\]+)\.flow(?:-meta\.xml)?$/;
|
|
25
|
+
/** Returns the Flow API name for a source-format (`.flow-meta.xml`) or metadata-format (`.flow`) file path, or undefined. */
|
|
26
|
+
export function flowNameFromPath(filePath) {
|
|
27
|
+
return FLOW_FILE.exec(filePath)?.[1];
|
|
28
|
+
}
|
|
29
|
+
//# sourceMappingURL=flowTypes.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"flowTypes.js","sourceRoot":"","sources":["../../src/core/flowTypes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,kBAAkB,EAAE,UAAU,EAAE,aAAa,EAAE,kBAAkB,CAAU,CAAC;AAElH,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAEpC,MAAM,UAAU,oBAAoB,CAAC,WAA+B;IAClE,IAAI,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IAC/B,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IACxC,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,aAAqB,EAAE,eAA+B;IACtF,OAAO,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,KAAK,aAAa,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;AAClF,CAAC;AAED,mIAAmI;AACnI,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;IACnD,OAAO,EAAE,eAAe,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;AACjG,CAAC;AAED,MAAM,SAAS,GAAG,iCAAiC,CAAC;AAEpD,6HAA6H;AAC7H,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type { FlowMetadata } from './types.js';
|
|
2
|
+
export declare function escapeApexString(value: string): string;
|
|
3
|
+
/**
|
|
4
|
+
* Reads the parts of a Flow metadata file needed to judge whether it counts toward
|
|
5
|
+
* the deploy-as-active coverage requirement and to scaffold an Apex test for it.
|
|
6
|
+
* Throws when the content is not a Flow.
|
|
7
|
+
*/
|
|
8
|
+
export declare function parseFlowXml(name: string, xml: string): FlowMetadata;
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import { XMLParser } from 'fast-xml-parser';
|
|
2
|
+
const parser = new XMLParser({
|
|
3
|
+
ignoreAttributes: true,
|
|
4
|
+
parseTagValue: false,
|
|
5
|
+
trimValues: true,
|
|
6
|
+
isArray: (_name, jpath) => ['Flow.variables', 'Flow.start.filters'].includes(String(jpath)),
|
|
7
|
+
});
|
|
8
|
+
function text(value) {
|
|
9
|
+
if (value === undefined || value === null)
|
|
10
|
+
return undefined;
|
|
11
|
+
if (typeof value === 'string')
|
|
12
|
+
return value;
|
|
13
|
+
if (typeof value === 'number' || typeof value === 'boolean')
|
|
14
|
+
return String(value);
|
|
15
|
+
return undefined;
|
|
16
|
+
}
|
|
17
|
+
function asRecord(value) {
|
|
18
|
+
return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
|
|
19
|
+
}
|
|
20
|
+
function asArray(value) {
|
|
21
|
+
return Array.isArray(value) ? value.filter((v) => !!asRecord(v)) : [];
|
|
22
|
+
}
|
|
23
|
+
export function escapeApexString(value) {
|
|
24
|
+
return value.replace(/\\/g, '\\\\').replace(/'/g, "\\'").replace(/\r?\n/g, '\\n');
|
|
25
|
+
}
|
|
26
|
+
function parseFilterValue(value) {
|
|
27
|
+
if (!value)
|
|
28
|
+
return {};
|
|
29
|
+
const stringValue = text(value.stringValue);
|
|
30
|
+
if (stringValue !== undefined)
|
|
31
|
+
return { apexValue: `'${escapeApexString(stringValue)}'`, rawValue: stringValue };
|
|
32
|
+
const booleanValue = text(value.booleanValue);
|
|
33
|
+
if (booleanValue !== undefined)
|
|
34
|
+
return { apexValue: booleanValue === 'true' ? 'true' : 'false', rawValue: booleanValue };
|
|
35
|
+
const numberValue = text(value.numberValue);
|
|
36
|
+
if (numberValue !== undefined && !Number.isNaN(Number(numberValue))) {
|
|
37
|
+
return { apexValue: numberValue, rawValue: numberValue };
|
|
38
|
+
}
|
|
39
|
+
const dateValue = text(value.dateValue);
|
|
40
|
+
if (dateValue !== undefined)
|
|
41
|
+
return { apexValue: `Date.valueOf('${escapeApexString(dateValue)}')`, rawValue: dateValue };
|
|
42
|
+
const raw = text(value.elementReference) ?? text(value.dateTimeValue);
|
|
43
|
+
return raw === undefined ? {} : { rawValue: raw };
|
|
44
|
+
}
|
|
45
|
+
function parseFilters(start) {
|
|
46
|
+
return asArray(start.filters).flatMap((filter) => {
|
|
47
|
+
const field = text(filter.field);
|
|
48
|
+
const operator = text(filter.operator);
|
|
49
|
+
if (!field || !operator)
|
|
50
|
+
return [];
|
|
51
|
+
return [{ field, operator, ...parseFilterValue(asRecord(filter.value)) }];
|
|
52
|
+
});
|
|
53
|
+
}
|
|
54
|
+
function parseVariables(flow) {
|
|
55
|
+
return asArray(flow.variables).flatMap((variable) => {
|
|
56
|
+
const name = text(variable.name);
|
|
57
|
+
if (!name)
|
|
58
|
+
return [];
|
|
59
|
+
return [
|
|
60
|
+
{
|
|
61
|
+
name,
|
|
62
|
+
dataType: text(variable.dataType) ?? 'String',
|
|
63
|
+
isInput: text(variable.isInput) === 'true',
|
|
64
|
+
isOutput: text(variable.isOutput) === 'true',
|
|
65
|
+
isCollection: text(variable.isCollection) === 'true',
|
|
66
|
+
objectType: text(variable.objectType),
|
|
67
|
+
apexClass: text(variable.apexClass),
|
|
68
|
+
},
|
|
69
|
+
];
|
|
70
|
+
});
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Reads the parts of a Flow metadata file needed to judge whether it counts toward
|
|
74
|
+
* the deploy-as-active coverage requirement and to scaffold an Apex test for it.
|
|
75
|
+
* Throws when the content is not a Flow.
|
|
76
|
+
*/
|
|
77
|
+
export function parseFlowXml(name, xml) {
|
|
78
|
+
const doc = asRecord(parser.parse(xml));
|
|
79
|
+
const flow = asRecord(doc?.Flow);
|
|
80
|
+
if (!flow)
|
|
81
|
+
throw new Error(`${name} is not a Flow metadata file (no <Flow> root element).`);
|
|
82
|
+
const start = asRecord(flow.start) ?? {};
|
|
83
|
+
return {
|
|
84
|
+
name,
|
|
85
|
+
label: text(flow.label),
|
|
86
|
+
processType: text(flow.processType),
|
|
87
|
+
status: text(flow.status),
|
|
88
|
+
triggerType: text(start.triggerType),
|
|
89
|
+
recordTriggerType: text(start.recordTriggerType),
|
|
90
|
+
object: text(start.object),
|
|
91
|
+
filters: parseFilters(start),
|
|
92
|
+
filterLogic: text(start.filterLogic),
|
|
93
|
+
filterFormula: text(start.filterFormula),
|
|
94
|
+
variables: parseVariables(flow),
|
|
95
|
+
};
|
|
96
|
+
}
|
|
97
|
+
//# sourceMappingURL=flowXml.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"flowXml.js","sourceRoot":"","sources":["../../src/core/flowXml.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { CoverageSource, FlowMetadata, GateResult } from './types.js';
|
|
2
|
+
/** A Flow the gate should check. `metadata` is present when it came from a changed file. */
|
|
3
|
+
export type GateCandidate = {
|
|
4
|
+
flowName: string;
|
|
5
|
+
path?: string;
|
|
6
|
+
metadata?: FlowMetadata;
|
|
7
|
+
};
|
|
8
|
+
/** Reads the Flows changed between `from` and `to` (PR semantics: merge base of `from` to `to`). */
|
|
9
|
+
export declare function collectChangedFlows(cwd: string, from: string, to: string): Promise<GateCandidate[]>;
|
|
10
|
+
export type GateOptions = {
|
|
11
|
+
source: CoverageSource;
|
|
12
|
+
candidates: GateCandidate[];
|
|
13
|
+
/** Minimum element coverage per Flow, 0-100. 0 means any covering test is enough. */
|
|
14
|
+
minElementCoverage?: number;
|
|
15
|
+
};
|
|
16
|
+
/**
|
|
17
|
+
* Requires coverage for each changed Flow, not just the org-wide total Salesforce checks.
|
|
18
|
+
* Coverage is read from the org, so run this after deploying the branch and running Apex tests.
|
|
19
|
+
*/
|
|
20
|
+
export declare function evaluateGate(options: GateOptions): Promise<GateResult>;
|
package/lib/core/gate.js
ADDED
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
import { flowNameFromPath, isCountedProcessType } from './flowTypes.js';
|
|
2
|
+
import { parseFlowXml } from './flowXml.js';
|
|
3
|
+
import { getChangedFlowFiles, showFileAtRevision } from './git.js';
|
|
4
|
+
/** Reads the Flows changed between `from` and `to` (PR semantics: merge base of `from` to `to`). */
|
|
5
|
+
export async function collectChangedFlows(cwd, from, to) {
|
|
6
|
+
const files = await getChangedFlowFiles(cwd, from, to);
|
|
7
|
+
const candidates = [];
|
|
8
|
+
for (const path of files) {
|
|
9
|
+
const flowName = flowNameFromPath(path);
|
|
10
|
+
const xml = await showFileAtRevision(cwd, to, path);
|
|
11
|
+
candidates.push({ flowName, path, metadata: parseFlowXml(flowName, xml) });
|
|
12
|
+
}
|
|
13
|
+
return candidates;
|
|
14
|
+
}
|
|
15
|
+
function skipReason(metadata) {
|
|
16
|
+
if (!metadata)
|
|
17
|
+
return undefined;
|
|
18
|
+
if (!isCountedProcessType(metadata.processType)) {
|
|
19
|
+
return `Process type ${metadata.processType ?? 'unknown'} does not count toward deploy-as-active coverage.`;
|
|
20
|
+
}
|
|
21
|
+
if (metadata.status && metadata.status !== 'Active') {
|
|
22
|
+
return `Status is ${metadata.status}; only active Flows need coverage.`;
|
|
23
|
+
}
|
|
24
|
+
return undefined;
|
|
25
|
+
}
|
|
26
|
+
/**
|
|
27
|
+
* Requires coverage for each changed Flow, not just the org-wide total Salesforce checks.
|
|
28
|
+
* Coverage is read from the org, so run this after deploying the branch and running Apex tests.
|
|
29
|
+
*/
|
|
30
|
+
export async function evaluateGate(options) {
|
|
31
|
+
const minElementCoverage = options.minElementCoverage ?? 0;
|
|
32
|
+
const results = [];
|
|
33
|
+
const toCheck = [];
|
|
34
|
+
for (const candidate of options.candidates) {
|
|
35
|
+
const reason = skipReason(candidate.metadata);
|
|
36
|
+
if (reason)
|
|
37
|
+
results.push({ flowName: candidate.flowName, path: candidate.path, status: 'skip', reason, tests: [] });
|
|
38
|
+
else
|
|
39
|
+
toCheck.push(candidate);
|
|
40
|
+
}
|
|
41
|
+
const coverage = await options.source.getFlowCoverage(toCheck.map((c) => c.flowName));
|
|
42
|
+
const byName = new Map(coverage.map((c) => [c.flowName, c]));
|
|
43
|
+
for (const candidate of toCheck) {
|
|
44
|
+
const flow = byName.get(candidate.flowName);
|
|
45
|
+
const base = { flowName: candidate.flowName, path: candidate.path };
|
|
46
|
+
if (!flow) {
|
|
47
|
+
results.push({
|
|
48
|
+
...base,
|
|
49
|
+
status: 'fail',
|
|
50
|
+
reason: 'Flow not found in the target org. Deploy the branch and run Apex tests before running the gate.',
|
|
51
|
+
tests: [],
|
|
52
|
+
});
|
|
53
|
+
continue;
|
|
54
|
+
}
|
|
55
|
+
const details = {
|
|
56
|
+
...base,
|
|
57
|
+
versionNumber: flow.versionNumber,
|
|
58
|
+
elementCoveragePercent: flow.elementCoveragePercent,
|
|
59
|
+
tests: flow.tests,
|
|
60
|
+
};
|
|
61
|
+
if (!isCountedProcessType(flow.processType)) {
|
|
62
|
+
results.push({
|
|
63
|
+
...details,
|
|
64
|
+
status: 'skip',
|
|
65
|
+
reason: `Process type ${flow.processType} does not count toward deploy-as-active coverage.`,
|
|
66
|
+
});
|
|
67
|
+
}
|
|
68
|
+
else if (!flow.covered) {
|
|
69
|
+
results.push({
|
|
70
|
+
...details,
|
|
71
|
+
status: 'fail',
|
|
72
|
+
reason: `No Apex test runs version ${flow.versionNumber ?? '?'} of this Flow.`,
|
|
73
|
+
});
|
|
74
|
+
}
|
|
75
|
+
else if (flow.elementCoveragePercent < minElementCoverage) {
|
|
76
|
+
results.push({
|
|
77
|
+
...details,
|
|
78
|
+
status: 'fail',
|
|
79
|
+
reason: `Element coverage ${flow.elementCoveragePercent}% is below the required ${minElementCoverage}%.`,
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
else {
|
|
83
|
+
results.push({ ...details, status: 'pass', reason: `Covered by ${flow.tests.length} test method(s).` });
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
return {
|
|
87
|
+
passed: results.every((r) => r.status !== 'fail'),
|
|
88
|
+
minElementCoverage,
|
|
89
|
+
flows: results,
|
|
90
|
+
};
|
|
91
|
+
}
|
|
92
|
+
//# sourceMappingURL=gate.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../src/core/gate.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
export declare function isGitRepo(cwd: string): Promise<boolean>;
|
|
2
|
+
/**
|
|
3
|
+
* Counts commits that touched each Flow file, keyed by Flow API name.
|
|
4
|
+
* Returns undefined when `cwd` is not inside a git repository.
|
|
5
|
+
*/
|
|
6
|
+
export declare function getFlowChurn(cwd: string, since?: string): Promise<Map<string, number> | undefined>;
|
|
7
|
+
/**
|
|
8
|
+
* Flow files added, modified, or renamed between the merge base of `from` and `to`
|
|
9
|
+
* (the same range a pull request shows). Paths are relative to the repository root.
|
|
10
|
+
*/
|
|
11
|
+
export declare function getChangedFlowFiles(cwd: string, from: string, to: string): Promise<string[]>;
|
|
12
|
+
/** Reads a file's content at a git revision. `filePath` is relative to the repository root. */
|
|
13
|
+
export declare function showFileAtRevision(cwd: string, revision: string, filePath: string): Promise<string>;
|