sf-flow-coverage 0.2.0 → 0.4.0

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.
Files changed (82) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/README.md +142 -17
  3. package/lib/commands/flowcov/gate.d.ts +1 -0
  4. package/lib/commands/flowcov/gate.js +15 -2
  5. package/lib/commands/flowcov/gate.js.map +1 -1
  6. package/lib/commands/flowcov/readiness.js +25 -3
  7. package/lib/commands/flowcov/readiness.js.map +1 -1
  8. package/lib/commands/flowcov/transform.d.ts +15 -0
  9. package/lib/commands/flowcov/transform.js +78 -0
  10. package/lib/commands/flowcov/transform.js.map +1 -0
  11. package/lib/core/apexTemplate.d.ts +16 -1
  12. package/lib/core/apexTemplate.js +462 -104
  13. package/lib/core/apexTemplate.js.map +1 -1
  14. package/lib/core/conditions.d.ts +107 -0
  15. package/lib/core/conditions.js +481 -0
  16. package/lib/core/conditions.js.map +1 -0
  17. package/lib/core/coverageCheck.d.ts +8 -0
  18. package/lib/core/coverageCheck.js +12 -0
  19. package/lib/core/coverageCheck.js.map +1 -0
  20. package/lib/core/coverageFormats.d.ts +7 -0
  21. package/lib/core/coverageFormats.js +77 -0
  22. package/lib/core/coverageFormats.js.map +1 -0
  23. package/lib/core/criteria.d.ts +40 -0
  24. package/lib/core/criteria.js +262 -0
  25. package/lib/core/criteria.js.map +1 -0
  26. package/lib/core/elementCoverage.d.ts +9 -0
  27. package/lib/core/elementCoverage.js +27 -0
  28. package/lib/core/elementCoverage.js.map +1 -0
  29. package/lib/core/flowElementLines.d.ts +13 -0
  30. package/lib/core/flowElementLines.js +44 -0
  31. package/lib/core/flowElementLines.js.map +1 -0
  32. package/lib/core/flowFingerprint.d.ts +37 -0
  33. package/lib/core/flowFingerprint.js +142 -0
  34. package/lib/core/flowFingerprint.js.map +1 -0
  35. package/lib/core/flowGraph.d.ts +144 -0
  36. package/lib/core/flowGraph.js +279 -0
  37. package/lib/core/flowGraph.js.map +1 -0
  38. package/lib/core/flowSettings.d.ts +16 -0
  39. package/lib/core/flowSettings.js +49 -0
  40. package/lib/core/flowSettings.js.map +1 -0
  41. package/lib/core/flowTypes.d.ts +6 -0
  42. package/lib/core/flowTypes.js +17 -0
  43. package/lib/core/flowTypes.js.map +1 -1
  44. package/lib/core/flowValues.d.ts +14 -0
  45. package/lib/core/flowValues.js +43 -0
  46. package/lib/core/flowValues.js.map +1 -0
  47. package/lib/core/flowXml.d.ts +1 -1
  48. package/lib/core/flowXml.js +6 -39
  49. package/lib/core/flowXml.js.map +1 -1
  50. package/lib/core/formula.d.ts +48 -0
  51. package/lib/core/formula.js +227 -0
  52. package/lib/core/formula.js.map +1 -0
  53. package/lib/core/gate.d.ts +10 -1
  54. package/lib/core/gate.js +64 -7
  55. package/lib/core/gate.js.map +1 -1
  56. package/lib/core/orgCoverageSource.d.ts +9 -0
  57. package/lib/core/orgCoverageSource.js +68 -12
  58. package/lib/core/orgCoverageSource.js.map +1 -1
  59. package/lib/core/readiness.d.ts +5 -0
  60. package/lib/core/readiness.js +24 -10
  61. package/lib/core/readiness.js.map +1 -1
  62. package/lib/core/requiredFields.d.ts +53 -3
  63. package/lib/core/requiredFields.js +158 -10
  64. package/lib/core/requiredFields.js.map +1 -1
  65. package/lib/core/scaffold.js +50 -4
  66. package/lib/core/scaffold.js.map +1 -1
  67. package/lib/core/toolingQuery.d.ts +5 -0
  68. package/lib/core/toolingQuery.js +9 -1
  69. package/lib/core/toolingQuery.js.map +1 -1
  70. package/lib/core/transform.d.ts +36 -0
  71. package/lib/core/transform.js +62 -0
  72. package/lib/core/transform.js.map +1 -0
  73. package/lib/core/types.d.ts +79 -1
  74. package/lib/index.d.ts +6 -1
  75. package/lib/index.js +3 -1
  76. package/lib/index.js.map +1 -1
  77. package/messages/flowcov.gate.md +19 -1
  78. package/messages/flowcov.readiness.md +4 -2
  79. package/messages/flowcov.scaffold.md +5 -1
  80. package/messages/flowcov.transform.md +33 -0
  81. package/oclif.manifest.json +113 -4
  82. package/package.json +1 -1
@@ -1,54 +1,20 @@
1
1
  import { XMLParser } from 'fast-xml-parser';
2
+ import { GRAPH_ARRAY_PATHS, parseFlowGraph } from './flowGraph.js';
3
+ import { asArray, asRecord, parseFlowValue, text } from './flowValues.js';
4
+ export { escapeApexString } from './flowValues.js';
2
5
  const parser = new XMLParser({
3
6
  ignoreAttributes: true,
4
7
  parseTagValue: false,
5
8
  trimValues: true,
6
- isArray: (_name, jpath) => ['Flow.variables', 'Flow.start.filters'].includes(String(jpath)),
9
+ isArray: (_name, jpath) => ['Flow.variables', 'Flow.start.filters', ...GRAPH_ARRAY_PATHS].includes(String(jpath)),
7
10
  });
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
11
  function parseFilters(start) {
46
12
  return asArray(start.filters).flatMap((filter) => {
47
13
  const field = text(filter.field);
48
14
  const operator = text(filter.operator);
49
15
  if (!field || !operator)
50
16
  return [];
51
- return [{ field, operator, ...parseFilterValue(asRecord(filter.value)) }];
17
+ return [{ field, operator, ...parseFlowValue(asRecord(filter.value)) }];
52
18
  });
53
19
  }
54
20
  function parseVariables(flow) {
@@ -92,6 +58,7 @@ export function parseFlowXml(name, xml) {
92
58
  filterLogic: text(start.filterLogic),
93
59
  filterFormula: text(start.filterFormula),
94
60
  variables: parseVariables(flow),
61
+ graph: parseFlowGraph(flow),
95
62
  };
96
63
  }
97
64
  //# sourceMappingURL=flowXml.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"flowXml.js","sourceRoot":"","sources":["../../src/core/flowXml.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"flowXml.js","sourceRoot":"","sources":["../../src/core/flowXml.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,48 @@
1
+ /**
2
+ * A parsed Salesforce formula. Every node keeps its source text, so a part the generator can't
3
+ * use can still be quoted in a TODO.
4
+ */
5
+ export type Expr = {
6
+ text: string;
7
+ } & ({
8
+ kind: 'string';
9
+ value: string;
10
+ } | {
11
+ kind: 'number';
12
+ value: string;
13
+ } | {
14
+ kind: 'boolean';
15
+ value: boolean;
16
+ } | {
17
+ kind: 'null';
18
+ }
19
+ /** A merge field (`{!$Record.Status__c}`) or a bare reference (`$Record.Status__c`, `myVariable`). */
20
+ | {
21
+ kind: 'ref';
22
+ path: string;
23
+ }
24
+ /** A function call; `name` is upper case. */
25
+ | {
26
+ kind: 'call';
27
+ name: string;
28
+ args: Expr[];
29
+ } | {
30
+ kind: 'binary';
31
+ op: string;
32
+ left: Expr;
33
+ right: Expr;
34
+ } | {
35
+ kind: 'unary';
36
+ op: string;
37
+ operand: Expr;
38
+ });
39
+ /** Parses a formula. Undefined when it isn't valid formula syntax. */
40
+ export declare function parseFormula(source: string): Expr | undefined;
41
+ /** An Apex date or datetime expression, for stepping comparisons by days. */
42
+ export declare const isApexDate: (apex: string) => boolean;
43
+ export declare const isApexDatetime: (apex: string) => boolean;
44
+ /**
45
+ * The Apex expression for a formula value: literals, `TODAY()`, `NOW()`, `DATE(y, m, d)`,
46
+ * `DATEVALUE("...")`, a date plus or minus days, and constant arithmetic. Undefined otherwise.
47
+ */
48
+ export declare function formulaToApex(expr: Expr): string | undefined;
@@ -0,0 +1,227 @@
1
+ import { escapeApexString } from './flowValues.js';
2
+ const OPERATORS = [
3
+ '&&',
4
+ '||',
5
+ '==',
6
+ '!=',
7
+ '<>',
8
+ '<=',
9
+ '>=',
10
+ '=',
11
+ '<',
12
+ '>',
13
+ '+',
14
+ '-',
15
+ '*',
16
+ '/',
17
+ '^',
18
+ '&',
19
+ '(',
20
+ ')',
21
+ ',',
22
+ '!',
23
+ ];
24
+ function tokenize(source) {
25
+ const tokens = [];
26
+ let i = 0;
27
+ while (i < source.length) {
28
+ const char = source[i];
29
+ if (/\s/.test(char)) {
30
+ i++;
31
+ continue;
32
+ }
33
+ const start = i;
34
+ if (source.startsWith('{!', i)) {
35
+ const end = source.indexOf('}', i);
36
+ if (end === -1)
37
+ return undefined;
38
+ tokens.push({ kind: 'ref', value: source.slice(i + 2, end).trim(), start, end: end + 1 });
39
+ i = end + 1;
40
+ continue;
41
+ }
42
+ if (char === '"' || char === "'") {
43
+ let value = '';
44
+ i++;
45
+ while (i < source.length && source[i] !== char) {
46
+ if (source[i] === '\\' && i + 1 < source.length)
47
+ i++;
48
+ value += source[i];
49
+ i++;
50
+ }
51
+ if (i >= source.length)
52
+ return undefined;
53
+ i++;
54
+ tokens.push({ kind: 'string', value, start, end: i });
55
+ continue;
56
+ }
57
+ const number = /^\d+(\.\d+)?/.exec(source.slice(i));
58
+ if (number) {
59
+ i += number[0].length;
60
+ tokens.push({ kind: 'number', value: number[0], start, end: i });
61
+ continue;
62
+ }
63
+ const ident = /^[A-Za-z_$][\w$]*(\.[A-Za-z_$][\w$]*)*/.exec(source.slice(i));
64
+ if (ident) {
65
+ i += ident[0].length;
66
+ tokens.push({ kind: 'ident', value: ident[0], start, end: i });
67
+ continue;
68
+ }
69
+ const op = OPERATORS.find((o) => source.startsWith(o, i));
70
+ if (!op)
71
+ return undefined;
72
+ i += op.length;
73
+ tokens.push({ kind: 'op', value: op, start, end: i });
74
+ }
75
+ return tokens;
76
+ }
77
+ /** Binary operators from loosest to tightest. */
78
+ const LEVELS = [['||'], ['&&'], ['=', '==', '!=', '<>'], ['<', '>', '<=', '>='], ['+', '-', '&'], ['*', '/'], ['^']];
79
+ /** Parses a formula. Undefined when it isn't valid formula syntax. */
80
+ export function parseFormula(source) {
81
+ const tokens = tokenize(source);
82
+ if (!tokens || tokens.length === 0)
83
+ return undefined;
84
+ let position = 0;
85
+ const peek = () => tokens[position];
86
+ const isOp = (value) => peek()?.kind === 'op' && peek()?.value === value;
87
+ const fail = () => {
88
+ throw new SyntaxError('formula');
89
+ };
90
+ /** Source text from token `first` to the last token read, whitespace collapsed. */
91
+ const textFrom = (first) => source
92
+ .slice(tokens[first].start, tokens[position - 1].end)
93
+ .replace(/\s+/g, ' ')
94
+ .trim();
95
+ const expect = (value) => {
96
+ if (!isOp(value))
97
+ fail();
98
+ position++;
99
+ };
100
+ const primary = () => {
101
+ const first = position;
102
+ const token = peek() ?? fail();
103
+ position++;
104
+ switch (token.kind) {
105
+ case 'string':
106
+ return { kind: 'string', value: token.value, text: textFrom(first) };
107
+ case 'number':
108
+ return { kind: 'number', value: token.value, text: textFrom(first) };
109
+ case 'ref':
110
+ return { kind: 'ref', path: token.value, text: textFrom(first) };
111
+ case 'ident': {
112
+ if (isOp('(')) {
113
+ position++;
114
+ const args = [];
115
+ if (!isOp(')')) {
116
+ args.push(expression(0));
117
+ while (isOp(',')) {
118
+ position++;
119
+ args.push(expression(0));
120
+ }
121
+ }
122
+ expect(')');
123
+ return { kind: 'call', name: token.value.toUpperCase(), args, text: textFrom(first) };
124
+ }
125
+ const upper = token.value.toUpperCase();
126
+ if (upper === 'TRUE' || upper === 'FALSE')
127
+ return { kind: 'boolean', value: upper === 'TRUE', text: textFrom(first) };
128
+ if (upper === 'NULL')
129
+ return { kind: 'null', text: textFrom(first) };
130
+ return { kind: 'ref', path: token.value, text: textFrom(first) };
131
+ }
132
+ default:
133
+ if (token.value === '(') {
134
+ const inner = expression(0);
135
+ expect(')');
136
+ return inner;
137
+ }
138
+ if (token.value === '-' || token.value === '+' || token.value === '!') {
139
+ const operand = primary();
140
+ return { kind: 'unary', op: token.value, operand, text: textFrom(first) };
141
+ }
142
+ return fail();
143
+ }
144
+ };
145
+ const expression = (level) => {
146
+ if (level >= LEVELS.length)
147
+ return primary();
148
+ const first = position;
149
+ let left = expression(level + 1);
150
+ while (peek()?.kind === 'op' && LEVELS[level].includes(peek()?.value)) {
151
+ const op = tokens[position++].value;
152
+ const right = expression(level + 1);
153
+ left = { kind: 'binary', op, left, right, text: textFrom(first) };
154
+ }
155
+ return left;
156
+ };
157
+ try {
158
+ const expr = expression(0);
159
+ return position === tokens.length ? expr : undefined;
160
+ }
161
+ catch {
162
+ return undefined;
163
+ }
164
+ }
165
+ /** An Apex date or datetime expression, for stepping comparisons by days. */
166
+ export const isApexDate = (apex) => apex.startsWith('Date.');
167
+ export const isApexDatetime = (apex) => apex.startsWith('Datetime.');
168
+ /**
169
+ * The Apex expression for a formula value: literals, `TODAY()`, `NOW()`, `DATE(y, m, d)`,
170
+ * `DATEVALUE("...")`, a date plus or minus days, and constant arithmetic. Undefined otherwise.
171
+ */
172
+ export function formulaToApex(expr) {
173
+ switch (expr.kind) {
174
+ case 'string':
175
+ return `'${escapeApexString(expr.value)}'`;
176
+ case 'number':
177
+ return expr.value;
178
+ case 'boolean':
179
+ return String(expr.value);
180
+ case 'unary': {
181
+ const operand = formulaToApex(expr.operand);
182
+ if (operand === undefined || expr.op === '!')
183
+ return undefined;
184
+ if (expr.op === '+')
185
+ return operand;
186
+ return /^-?\d+(\.\d+)?$/.test(operand) ? String(-Number(operand)) : undefined;
187
+ }
188
+ case 'call': {
189
+ const args = expr.args.map(formulaToApex);
190
+ if (expr.name === 'TODAY' && args.length === 0)
191
+ return 'Date.today()';
192
+ if (expr.name === 'NOW' && args.length === 0)
193
+ return 'Datetime.now()';
194
+ if (expr.name === 'DATE' && args.length === 3 && args.every((a) => a !== undefined && /^\d+$/.test(a))) {
195
+ return `Date.newInstance(${args.join(', ')})`;
196
+ }
197
+ if (expr.name === 'DATEVALUE' &&
198
+ expr.args[0]?.kind === 'string' &&
199
+ /^\d{4}-\d{2}-\d{2}$/.test(expr.args[0].value)) {
200
+ return `Date.valueOf('${expr.args[0].value}')`;
201
+ }
202
+ return undefined;
203
+ }
204
+ case 'binary': {
205
+ if (expr.op !== '+' && expr.op !== '-' && expr.op !== '*' && expr.op !== '/')
206
+ return undefined;
207
+ const left = formulaToApex(expr.left);
208
+ const right = formulaToApex(expr.right);
209
+ if (left === undefined || right === undefined)
210
+ return undefined;
211
+ const numeric = /^-?\d+(\.\d+)?$/;
212
+ if (numeric.test(left) && numeric.test(right)) {
213
+ const [a, b] = [Number(left), Number(right)];
214
+ const value = expr.op === '+' ? a + b : expr.op === '-' ? a - b : expr.op === '*' ? a * b : b === 0 ? NaN : a / b;
215
+ return Number.isFinite(value) ? String(Number(value.toFixed(10))) : undefined;
216
+ }
217
+ // A date (or datetime) plus or minus a number of days.
218
+ if ((isApexDate(left) || isApexDatetime(left)) && numeric.test(right) && (expr.op === '+' || expr.op === '-')) {
219
+ return `${left}.addDays(${expr.op === '-' ? -Number(right) : Number(right)})`;
220
+ }
221
+ return undefined;
222
+ }
223
+ default:
224
+ return undefined;
225
+ }
226
+ }
227
+ //# sourceMappingURL=formula.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"formula.js","sourceRoot":"","sources":["../../src/core/formula.ts"],"names":[],"mappings":"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"}
@@ -1,9 +1,12 @@
1
- import type { CoverageSource, FlowMetadata, GateResult } from './types.js';
1
+ import { type FlowFingerprint } from './flowFingerprint.js';
2
+ import type { ContentCheck, CoverageSource, FlowMetadata, GateResult } from './types.js';
2
3
  /** A Flow the gate should check. `metadata` is present when it came from a changed file. */
3
4
  export type GateCandidate = {
4
5
  flowName: string;
5
6
  path?: string;
6
7
  metadata?: FlowMetadata;
8
+ /** Content fingerprint of the changed file, compared with the org's version. */
9
+ fingerprint?: FlowFingerprint;
7
10
  /** Why the changed file couldn't be read as a Flow; the gate fails it. */
8
11
  error?: string;
9
12
  };
@@ -14,9 +17,15 @@ export type GateOptions = {
14
17
  candidates: GateCandidate[];
15
18
  /** Minimum element coverage per Flow, 0-100. 0 means any covering test is enough. */
16
19
  minElementCoverage?: number;
20
+ /** What to do when the org's version differs from the changed file. Defaults to `warn`. */
21
+ contentCheck?: ContentCheck;
17
22
  };
18
23
  /**
19
24
  * Requires coverage for each changed Flow, not just the org-wide total Salesforce checks.
20
25
  * Coverage is read from the org, so run this after deploying the branch and running Apex tests.
26
+ * Fails a Flow whose org versions suggest the branch was deployed inactive, since the coverage
27
+ * read would then belong to an older version (or to none). When a candidate has a fingerprint,
28
+ * also compares it with the org's version and warns (or fails) when they differ, which catches
29
+ * a branch that was never deployed.
21
30
  */
22
31
  export declare function evaluateGate(options: GateOptions): Promise<GateResult>;
package/lib/core/gate.js CHANGED
@@ -1,4 +1,7 @@
1
- import { flowNameFromPath, isCountedProcessType } from './flowTypes.js';
1
+ import { missingCoverageWarning } from './coverageCheck.js';
2
+ import { describeElements, findUncoveredElements } from './elementCoverage.js';
3
+ import { compareFingerprints, fingerprintFromXml } from './flowFingerprint.js';
4
+ import { flowNameFromPath, isCountedProcessType, isProcessBuilder, PROCESS_BUILDER_ADVICE, processTypeLabel, } from './flowTypes.js';
2
5
  import { parseFlowXml } from './flowXml.js';
3
6
  import { getChangedFlowFiles, showFileAtRevision } from './git.js';
4
7
  /** Reads the Flows changed between `from` and `to` (PR semantics: merge base of `from` to `to`). */
@@ -9,7 +12,7 @@ export async function collectChangedFlows(cwd, from, to) {
9
12
  const flowName = flowNameFromPath(path);
10
13
  const xml = await showFileAtRevision(cwd, to, path);
11
14
  try {
12
- candidates.push({ flowName, path, metadata: parseFlowXml(flowName, xml) });
15
+ candidates.push({ flowName, path, metadata: parseFlowXml(flowName, xml), fingerprint: fingerprintFromXml(xml) });
13
16
  }
14
17
  catch (error) {
15
18
  candidates.push({ flowName, path, error: error.message });
@@ -17,6 +20,30 @@ export async function collectChangedFlows(cwd, from, to) {
17
20
  }
18
21
  return candidates;
19
22
  }
23
+ function coverageOutcome(flow, minElementCoverage) {
24
+ if (!flow.covered) {
25
+ return { status: 'fail', reason: `No Apex test runs version ${flow.versionNumber ?? '?'} of this Flow.` };
26
+ }
27
+ if (flow.elementCoveragePercent < minElementCoverage) {
28
+ return {
29
+ status: 'fail',
30
+ reason: `Element coverage ${flow.elementCoveragePercent}% is below the required ${minElementCoverage}%.`,
31
+ };
32
+ }
33
+ return { status: 'pass', reason: `Covered by ${flow.tests.length} test method(s).` };
34
+ }
35
+ /** Describes how the org's version differs from the changed file, or undefined when it matches or can't be read. */
36
+ async function contentMismatch(source, candidate, flow) {
37
+ if (!candidate.fingerprint || !source.getFlowFingerprint)
38
+ return undefined;
39
+ const orgFingerprint = await source.getFlowFingerprint(flow.flowVersionId);
40
+ if (!orgFingerprint)
41
+ return undefined;
42
+ const differences = compareFingerprints(candidate.fingerprint, orgFingerprint);
43
+ if (differences.length === 0)
44
+ return undefined;
45
+ return `The org's version ${flow.versionNumber ?? '?'} differs from ${candidate.path ?? 'source'} (${differences.join('; ')}), so coverage may be stale. Deploy the branch, run Apex tests, then rerun the gate.`;
46
+ }
20
47
  function skipReason(metadata) {
21
48
  if (!metadata)
22
49
  return undefined;
@@ -31,9 +58,14 @@ function skipReason(metadata) {
31
58
  /**
32
59
  * Requires coverage for each changed Flow, not just the org-wide total Salesforce checks.
33
60
  * Coverage is read from the org, so run this after deploying the branch and running Apex tests.
61
+ * Fails a Flow whose org versions suggest the branch was deployed inactive, since the coverage
62
+ * read would then belong to an older version (or to none). When a candidate has a fingerprint,
63
+ * also compares it with the org's version and warns (or fails) when they differ, which catches
64
+ * a branch that was never deployed.
34
65
  */
35
66
  export async function evaluateGate(options) {
36
67
  const minElementCoverage = options.minElementCoverage ?? 0;
68
+ const contentCheck = options.contentCheck ?? 'warn';
37
69
  const results = [];
38
70
  const toCheck = [];
39
71
  for (const candidate of options.candidates) {
@@ -80,28 +112,53 @@ export async function evaluateGate(options) {
80
112
  reason: `Process type ${flow.processType} does not count toward deploy-as-active coverage.`,
81
113
  });
82
114
  }
83
- else if (!flow.covered) {
115
+ else if (flow.versionState === 'noActiveVersion') {
84
116
  results.push({
85
117
  ...details,
86
118
  status: 'fail',
87
- reason: `No Apex test runs version ${flow.versionNumber ?? '?'} of this Flow.`,
119
+ reason: `No version of this Flow is active in the org (latest is version ${flow.versionNumber ?? '?'}, ${flow.status ?? 'inactive'}). Deploy it as active or activate it, run Apex tests, then rerun the gate.`,
88
120
  });
89
121
  }
90
- else if (flow.elementCoveragePercent < minElementCoverage) {
122
+ else if (flow.versionState === 'newerInactiveVersion') {
91
123
  results.push({
92
124
  ...details,
93
125
  status: 'fail',
94
- reason: `Element coverage ${flow.elementCoveragePercent}% is below the required ${minElementCoverage}%.`,
126
+ reason: `The org's active version ${flow.versionNumber ?? '?'} is older than its latest version ${flow.latestVersionNumber ?? '?'}, which is inactive, so coverage may be stale. Activate the latest version, run Apex tests, then rerun the gate.`,
95
127
  });
96
128
  }
97
129
  else {
98
- results.push({ ...details, status: 'pass', reason: `Covered by ${flow.tests.length} test method(s).` });
130
+ const result = { ...details, ...coverageOutcome(flow, minElementCoverage) };
131
+ const uncovered = await findUncoveredElements(options.source, flow);
132
+ if (uncovered) {
133
+ result.uncoveredElements = uncovered;
134
+ if (result.status === 'fail' && uncovered.length > 0) {
135
+ result.reason = `${result.reason} Not run by any test: ${describeElements(uncovered)}.`;
136
+ }
137
+ }
138
+ const mismatch = contentCheck === 'off' ? undefined : await contentMismatch(options.source, candidate, flow);
139
+ if (mismatch && contentCheck === 'fail' && result.status === 'pass') {
140
+ result.status = 'fail';
141
+ result.reason = mismatch;
142
+ }
143
+ else if (mismatch) {
144
+ result.warnings = [mismatch];
145
+ }
146
+ if (isProcessBuilder(flow.processType)) {
147
+ result.warnings = [
148
+ ...(result.warnings ?? []),
149
+ `This is a ${processTypeLabel(flow.processType)} process. ${PROCESS_BUILDER_ADVICE}`,
150
+ ];
151
+ }
152
+ results.push(result);
99
153
  }
100
154
  }
155
+ // A changed Flow with no test is normal; every Flow in the org having none is not.
156
+ const warning = await missingCoverageWarning(options.source, coverage.some((c) => isCountedProcessType(c.processType) && !c.covered));
101
157
  return {
102
158
  passed: results.every((r) => r.status !== 'fail'),
103
159
  minElementCoverage,
104
160
  flows: results,
161
+ warnings: warning ? [warning] : [],
105
162
  };
106
163
  }
107
164
  //# sourceMappingURL=gate.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"gate.js","sourceRoot":"","sources":["../../src/core/gate.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"gate.js","sourceRoot":"","sources":["../../src/core/gate.ts"],"names":[],"mappings":"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"}
@@ -1,10 +1,19 @@
1
+ import { type FlowFingerprint } from './flowFingerprint.js';
1
2
  import type { CoverageSource, FlowCoverage, ToolingQuery } from './types.js';
2
3
  /** Reads Flow coverage from FlowTestCoverage, which Salesforce fills in when Apex tests run in the org. */
3
4
  export declare class OrgCoverageSource implements CoverageSource {
4
5
  private readonly query;
6
+ private readonly fingerprints;
5
7
  constructor(query: ToolingQuery);
6
8
  listActiveCountedFlows(): Promise<FlowCoverage[]>;
7
9
  getFlowCoverage(flowNames: string[]): Promise<FlowCoverage[]>;
10
+ /**
11
+ * The Tooling API returns `Flow.Metadata` only when a query returns one row, so this reads one
12
+ * version per query. Returns undefined when the query fails or returns no content.
13
+ */
14
+ hasAnyFlowCoverage(): Promise<boolean>;
15
+ getFlowFingerprint(flowVersionId: string): Promise<FlowFingerprint | undefined>;
16
+ private readFingerprint;
8
17
  private queryInChunks;
9
18
  private buildCoverage;
10
19
  /**