sf-flow-coverage 0.2.0 → 0.3.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 (39) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +30 -3
  3. package/lib/commands/flowcov/gate.d.ts +1 -0
  4. package/lib/commands/flowcov/gate.js +12 -1
  5. package/lib/commands/flowcov/gate.js.map +1 -1
  6. package/lib/core/apexTemplate.d.ts +8 -2
  7. package/lib/core/apexTemplate.js +304 -54
  8. package/lib/core/apexTemplate.js.map +1 -1
  9. package/lib/core/filterFormula.d.ts +10 -0
  10. package/lib/core/filterFormula.js +153 -0
  11. package/lib/core/filterFormula.js.map +1 -0
  12. package/lib/core/flowFingerprint.d.ts +27 -0
  13. package/lib/core/flowFingerprint.js +128 -0
  14. package/lib/core/flowFingerprint.js.map +1 -0
  15. package/lib/core/flowGraph.d.ts +94 -0
  16. package/lib/core/flowGraph.js +288 -0
  17. package/lib/core/flowGraph.js.map +1 -0
  18. package/lib/core/flowValues.d.ts +14 -0
  19. package/lib/core/flowValues.js +43 -0
  20. package/lib/core/flowValues.js.map +1 -0
  21. package/lib/core/flowXml.d.ts +1 -1
  22. package/lib/core/flowXml.js +6 -39
  23. package/lib/core/flowXml.js.map +1 -1
  24. package/lib/core/gate.d.ts +10 -1
  25. package/lib/core/gate.js +45 -6
  26. package/lib/core/gate.js.map +1 -1
  27. package/lib/core/orgCoverageSource.d.ts +6 -0
  28. package/lib/core/orgCoverageSource.js +43 -8
  29. package/lib/core/orgCoverageSource.js.map +1 -1
  30. package/lib/core/requiredFields.d.ts +30 -2
  31. package/lib/core/requiredFields.js +114 -7
  32. package/lib/core/requiredFields.js.map +1 -1
  33. package/lib/core/scaffold.js +31 -4
  34. package/lib/core/scaffold.js.map +1 -1
  35. package/lib/core/types.d.ts +29 -1
  36. package/messages/flowcov.gate.md +16 -0
  37. package/messages/flowcov.scaffold.md +3 -1
  38. package/oclif.manifest.json +18 -3
  39. package/package.json +1 -1
@@ -1,3 +1,4 @@
1
+ import { fingerprintFromMetadata } from './flowFingerprint.js';
1
2
  import { COUNTED_PROCESS_TYPES, qualifiedFlowName, splitFlowName } from './flowTypes.js';
2
3
  const CHUNK_SIZE = 200;
3
4
  const FLOW_FIELDS = 'Id, VersionNumber, ProcessType, Status, Definition.DeveloperName, Definition.NamespacePrefix';
@@ -10,6 +11,19 @@ function chunk(items, size = CHUNK_SIZE) {
10
11
  return chunks;
11
12
  }
12
13
  const soqlList = (values) => values.map((v) => `'${v.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`).join(', ');
14
+ /** Whether the version `getFlowCoverage` read is the one a deploy most likely produced. */
15
+ function versionInfo(definition) {
16
+ const { ActiveVersionId: active, LatestVersionId: latest } = definition;
17
+ if (!active)
18
+ return { versionState: 'noActiveVersion' };
19
+ if (latest && idKey(latest) !== idKey(active)) {
20
+ return {
21
+ versionState: 'newerInactiveVersion',
22
+ latestVersionNumber: definition.LatestVersion?.VersionNumber ?? undefined,
23
+ };
24
+ }
25
+ return { versionState: 'current' };
26
+ }
13
27
  /** Reads Flow coverage from FlowTestCoverage, which Salesforce fills in when Apex tests run in the org. */
14
28
  export class OrgCoverageSource {
15
29
  query;
@@ -25,15 +39,36 @@ export class OrgCoverageSource {
25
39
  return [];
26
40
  const wanted = new Set(flowNames);
27
41
  const developerNames = [...new Set(flowNames.map((n) => splitFlowName(n).developerName))];
28
- const definitions = await this.queryInChunks(developerNames, (list) => `SELECT Id, DeveloperName, NamespacePrefix, ActiveVersionId, LatestVersionId FROM FlowDefinition WHERE DeveloperName IN (${list})`);
29
- const versionIds = definitions
30
- .filter((d) => wanted.has(qualifiedFlowName(d.DeveloperName, d.NamespacePrefix)))
31
- .map((d) => d.ActiveVersionId ?? d.LatestVersionId)
32
- .filter((id) => !!id);
33
- if (versionIds.length === 0)
42
+ const definitions = await this.queryInChunks(developerNames, (list) => `SELECT Id, DeveloperName, NamespacePrefix, ActiveVersionId, LatestVersionId, LatestVersion.VersionNumber FROM FlowDefinition WHERE DeveloperName IN (${list})`);
43
+ const definitionByVersion = new Map();
44
+ for (const definition of definitions) {
45
+ if (!wanted.has(qualifiedFlowName(definition.DeveloperName, definition.NamespacePrefix)))
46
+ continue;
47
+ const versionId = definition.ActiveVersionId ?? definition.LatestVersionId;
48
+ if (versionId)
49
+ definitionByVersion.set(idKey(versionId), definition);
50
+ }
51
+ if (definitionByVersion.size === 0)
34
52
  return [];
35
- const flows = await this.queryInChunks(versionIds, (list) => `SELECT ${FLOW_FIELDS} FROM Flow WHERE Id IN (${list})`);
36
- return this.buildCoverage(flows);
53
+ const flows = await this.queryInChunks([...definitionByVersion.values()].map((d) => (d.ActiveVersionId ?? d.LatestVersionId)), (list) => `SELECT ${FLOW_FIELDS} FROM Flow WHERE Id IN (${list})`);
54
+ const coverage = await this.buildCoverage(flows);
55
+ return coverage.map((flow) => {
56
+ const definition = definitionByVersion.get(idKey(flow.flowVersionId));
57
+ return definition ? { ...flow, ...versionInfo(definition) } : flow;
58
+ });
59
+ }
60
+ /**
61
+ * The Tooling API returns `Flow.Metadata` only when a query returns one row, so this reads one
62
+ * version per query. Returns undefined when the query fails or returns no content.
63
+ */
64
+ async getFlowFingerprint(flowVersionId) {
65
+ try {
66
+ const [record] = await this.query(`SELECT Metadata FROM Flow WHERE Id = ${soqlList([flowVersionId])}`);
67
+ return record?.Metadata ? fingerprintFromMetadata(record.Metadata) : undefined;
68
+ }
69
+ catch {
70
+ return undefined;
71
+ }
37
72
  }
38
73
  async queryInChunks(values, buildSoql) {
39
74
  const results = [];
@@ -1 +1 @@
1
- {"version":3,"file":"orgCoverageSource.js","sourceRoot":"","sources":["../../src/core/orgCoverageSource.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"orgCoverageSource.js","sourceRoot":"","sources":["../../src/core/orgCoverageSource.ts"],"names":[],"mappings":"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"}
@@ -28,9 +28,37 @@ export declare function requiredFieldValues(fields: DescribeField[]): Record<str
28
28
  * Lookups are left out: a made-up null Id can't satisfy "is not null".
29
29
  */
30
30
  export declare function settableFieldValues(fields: DescribeField[]): Record<string, string>;
31
+ /**
32
+ * An Apex literal that differs from `apexValueForField`'s value for the same field, so an update
33
+ * changes the field whether the insert left it empty or filled it. Undefined when there's no safe
34
+ * second value (lookups, single-value picklists, unknown types).
35
+ */
36
+ export declare function changedValueForField(field: DescribeField): string | undefined;
37
+ /** A changed value for every field a test could update, used to meet `IsChanged` entry criteria. */
38
+ export declare function changedFieldValues(fields: DescribeField[]): Record<string, string>;
31
39
  export type ObjectFields = {
32
40
  requiredFields: RequiredFieldMap;
33
41
  fieldValues: RequiredFieldMap;
42
+ changedValues: RequiredFieldMap;
43
+ /** The object each lookup field points to, per object. Only lookups to a single object are listed. */
44
+ lookups: Record<string, Record<string, string>>;
45
+ /** Fields that stay empty when a test doesn't set them (no default value), per object. */
46
+ nullWhenUnset: Record<string, string[]>;
34
47
  };
35
- /** Describes each object once. Objects that can't be described are left out. */
36
- export declare function loadObjectFields(objects: string[], describe: DescribeObject): Promise<ObjectFields>;
48
+ export declare const emptyObjectFields: () => ObjectFields;
49
+ /** Lookup targets a test points at an existing record instead of inserting one. */
50
+ export declare const EXISTING_RECORD_IDS: Record<string, string>;
51
+ /** Whether a generated test can insert a record of `object` to fill a lookup to it. */
52
+ export declare const canInsertParent: (object: string) => boolean;
53
+ /**
54
+ * Fields a new record leaves empty unless the test sets them: createable, nillable, and with no
55
+ * default value. Lets a test know how the Flow's decisions read the fields it doesn't set.
56
+ */
57
+ export declare function nullWhenUnsetFields(fields: DescribeField[]): string[];
58
+ /** Createable lookups to exactly one object (polymorphic lookups like `WhatId` are left out). */
59
+ export declare function lookupTargets(fields: DescribeField[]): Record<string, string>;
60
+ /**
61
+ * Describes each object once, adding to `into` when given. Objects already in `into`, and
62
+ * objects that can't be described, are skipped.
63
+ */
64
+ export declare function loadObjectFields(objects: string[], describe: DescribeObject, into?: ObjectFields): Promise<ObjectFields>;
@@ -71,11 +71,115 @@ export function settableFieldValues(fields) {
71
71
  }
72
72
  return values;
73
73
  }
74
- /** Describes each object once. Objects that can't be described are left out. */
75
- export async function loadObjectFields(objects, describe) {
76
- const requiredFields = {};
77
- const fieldValues = {};
74
+ /**
75
+ * An Apex literal that differs from `apexValueForField`'s value for the same field, so an update
76
+ * changes the field whether the insert left it empty or filled it. Undefined when there's no safe
77
+ * second value (lookups, single-value picklists, unknown types).
78
+ */
79
+ export function changedValueForField(field) {
80
+ switch (field.type) {
81
+ case 'string':
82
+ case 'textarea':
83
+ case 'encryptedstring':
84
+ return textValue(field, 'Changed');
85
+ case 'email':
86
+ return "'changed@example.com'";
87
+ case 'phone':
88
+ return "'5555550199'";
89
+ case 'url':
90
+ return "'https://example.org'";
91
+ case 'int':
92
+ case 'double':
93
+ case 'currency':
94
+ case 'percent':
95
+ return '2';
96
+ case 'date':
97
+ return 'Date.today().addDays(1)';
98
+ case 'datetime':
99
+ return 'Datetime.now().addDays(1)';
100
+ case 'time':
101
+ return 'Time.newInstance(13, 0, 0, 0)';
102
+ case 'boolean':
103
+ return 'true';
104
+ case 'picklist':
105
+ case 'multipicklist': {
106
+ const first = apexValueForField(field);
107
+ const other = (field.picklistValues ?? []).find((v) => v.active && `'${escapeApexString(v.value)}'` !== first);
108
+ return other ? `'${escapeApexString(other.value)}'` : undefined;
109
+ }
110
+ default:
111
+ return undefined;
112
+ }
113
+ }
114
+ /** A changed value for every field a test could update, used to meet `IsChanged` entry criteria. */
115
+ export function changedFieldValues(fields) {
116
+ const values = {};
117
+ for (const field of fields) {
118
+ if (!field.createable || field.calculated || field.autoNumber)
119
+ continue;
120
+ const value = changedValueForField(field);
121
+ if (value !== undefined)
122
+ values[field.name] = value;
123
+ }
124
+ return values;
125
+ }
126
+ export const emptyObjectFields = () => ({
127
+ requiredFields: {},
128
+ fieldValues: {},
129
+ changedValues: {},
130
+ lookups: {},
131
+ nullWhenUnset: {},
132
+ });
133
+ /** Lookup targets a test points at an existing record instead of inserting one. */
134
+ export const EXISTING_RECORD_IDS = {
135
+ User: 'UserInfo.getUserId()',
136
+ Pricebook2: 'Test.getStandardPricebookId()',
137
+ };
138
+ /** Setup objects a test can't simply insert (or would hit mixed DML with); their lookups stay TODOs. */
139
+ const NOT_INSERTABLE = new Set([
140
+ 'BusinessHours',
141
+ 'Group',
142
+ 'Organization',
143
+ 'PermissionSet',
144
+ 'Profile',
145
+ 'RecordType',
146
+ 'UserRole',
147
+ ]);
148
+ /** Whether a generated test can insert a record of `object` to fill a lookup to it. */
149
+ export const canInsertParent = (object) => !NOT_INSERTABLE.has(object) && !(object in EXISTING_RECORD_IDS);
150
+ /**
151
+ * Fields a new record leaves empty unless the test sets them: createable, nillable, and with no
152
+ * default value. Lets a test know how the Flow's decisions read the fields it doesn't set.
153
+ */
154
+ export function nullWhenUnsetFields(fields) {
155
+ return fields
156
+ .filter((field) => field.createable &&
157
+ field.nillable &&
158
+ !field.defaultedOnCreate &&
159
+ !field.calculated &&
160
+ !field.autoNumber &&
161
+ !(field.picklistValues ?? []).some((value) => value.defaultValue))
162
+ .map((field) => field.name);
163
+ }
164
+ /** Createable lookups to exactly one object (polymorphic lookups like `WhatId` are left out). */
165
+ export function lookupTargets(fields) {
166
+ const targets = {};
167
+ for (const field of fields) {
168
+ if (field.type !== 'reference' || !field.createable || field.calculated)
169
+ continue;
170
+ if (field.referenceTo?.length === 1)
171
+ targets[field.name] = field.referenceTo[0];
172
+ }
173
+ return targets;
174
+ }
175
+ /**
176
+ * Describes each object once, adding to `into` when given. Objects already in `into`, and
177
+ * objects that can't be described, are skipped.
178
+ */
179
+ export async function loadObjectFields(objects, describe, into = emptyObjectFields()) {
78
180
  for (const object of [...new Set(objects)]) {
181
+ if (object in into.requiredFields)
182
+ continue;
79
183
  let fields;
80
184
  try {
81
185
  fields = await describe(object);
@@ -84,10 +188,13 @@ export async function loadObjectFields(objects, describe) {
84
188
  fields = undefined;
85
189
  }
86
190
  if (fields) {
87
- requiredFields[object] = requiredFieldValues(fields);
88
- fieldValues[object] = settableFieldValues(fields);
191
+ into.requiredFields[object] = requiredFieldValues(fields);
192
+ into.fieldValues[object] = settableFieldValues(fields);
193
+ into.changedValues[object] = changedFieldValues(fields);
194
+ into.lookups[object] = lookupTargets(fields);
195
+ into.nullWhenUnset[object] = nullWhenUnsetFields(fields);
89
196
  }
90
197
  }
91
- return { requiredFields, fieldValues };
198
+ return into;
92
199
  }
93
200
  //# sourceMappingURL=requiredFields.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"requiredFields.js","sourceRoot":"","sources":["../../src/core/requiredFields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAsBhD,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAEtE,SAAS,SAAS,CAAC,KAAoB,EAAE,IAAY;IACnD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1E,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC;AACrD,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,iBAAiB,CAAC,KAAoB;IACpD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU,CAAC;QAChB,KAAK,iBAAiB;YACpB,OAAO,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAClC,KAAK,OAAO;YACV,OAAO,oBAAoB,CAAC;QAC9B,KAAK,OAAO;YACV,OAAO,cAAc,CAAC;QACxB,KAAK,KAAK;YACR,OAAO,uBAAuB,CAAC;QACjC,KAAK,KAAK,CAAC;QACX,KAAK,QAAQ,CAAC;QACd,KAAK,UAAU,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,GAAG,CAAC;QACb,KAAK,MAAM;YACT,OAAO,cAAc,CAAC;QACxB,KAAK,UAAU;YACb,OAAO,gBAAgB,CAAC;QAC1B,KAAK,MAAM;YACT,OAAO,+BAA+B,CAAC;QACzC,KAAK,SAAS;YACZ,OAAO,OAAO,CAAC;QACjB,KAAK,UAAU,CAAC;QAChB,KAAK,eAAe,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACpE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;YAC/D,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;QACpE,CAAC;QACD,KAAK,WAAW;YACd,OAAO,uBAAuB,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,QAAQ,QAAQ,CAAC;QAC3F;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,8GAA8G;AAC9G,MAAM,UAAU,mBAAmB,CAAC,MAAuB;IACzD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,iBAAiB;YAAE,SAAS;QAC7E,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,IAAI,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QAC5F,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAuB;IACzD,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;YAAE,SAAS;QACtG,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAiB,EAAE,QAAwB;IAChF,MAAM,cAAc,GAAqB,EAAE,CAAC;IAC5C,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC3C,IAAI,MAAmC,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACX,cAAc,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;YACrD,WAAW,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;AACzC,CAAC"}
1
+ {"version":3,"file":"requiredFields.js","sourceRoot":"","sources":["../../src/core/requiredFields.ts"],"names":[],"mappings":"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"}
@@ -1,10 +1,11 @@
1
1
  import { access, mkdir, readFile, writeFile } from 'node:fs/promises';
2
2
  import { join } from 'node:path';
3
3
  import { apexClassMetaXml, flowKind, generateApexTest } from './apexTemplate.js';
4
+ import { parseFilterFormula } from './filterFormula.js';
4
5
  import { isCountedProcessType } from './flowTypes.js';
5
6
  import { parseFlowXml } from './flowXml.js';
6
7
  import { findFlowFiles, readProjectConfig } from './projectFiles.js';
7
- import { loadObjectFields } from './requiredFields.js';
8
+ import { canInsertParent, emptyObjectFields, loadObjectFields, } from './requiredFields.js';
8
9
  export const DEFAULT_APEX_API_VERSION = '65.0';
9
10
  /** sObjects a generated test creates records of. */
10
11
  function objectsToCreate(flow) {
@@ -16,6 +17,30 @@ function objectsToCreate(flow) {
16
17
  objects.push(flow.object);
17
18
  return objects;
18
19
  }
20
+ /** Entry-criteria fields on the triggering record, from filters and a simple formula. */
21
+ function criteriaFields(flow) {
22
+ const formulaFilters = flow.filterFormula ? (parseFilterFormula(flow.filterFormula) ?? []) : [];
23
+ return new Set([...flow.filters, ...formulaFilters].map((f) => f.field));
24
+ }
25
+ /**
26
+ * Objects a generated test inserts as parents: targets of lookups that are required, or that
27
+ * the entry criteria reference, on the records the test creates. One level deep: a parent's
28
+ * own required lookups stay TODOs.
29
+ */
30
+ function parentObjects(flows, fields) {
31
+ const parents = [];
32
+ for (const flow of flows) {
33
+ const criteria = criteriaFields(flow);
34
+ for (const object of objectsToCreate(flow)) {
35
+ for (const [field, target] of Object.entries(fields.lookups[object] ?? {})) {
36
+ const used = field in (fields.requiredFields[object] ?? {}) || (object === flow.object && criteria.has(field));
37
+ if (used && canInsertParent(target))
38
+ parents.push(target);
39
+ }
40
+ }
41
+ }
42
+ return parents;
43
+ }
19
44
  async function exists(path) {
20
45
  try {
21
46
  await access(path);
@@ -57,9 +82,11 @@ export async function scaffoldTests(options) {
57
82
  }
58
83
  flows.push({ flowName, flow });
59
84
  }
60
- const objectFields = options.describe
61
- ? await loadObjectFields(flows.flatMap((f) => objectsToCreate(f.flow)), options.describe)
62
- : { requiredFields: {}, fieldValues: {} };
85
+ const objectFields = emptyObjectFields();
86
+ if (options.describe) {
87
+ await loadObjectFields(flows.flatMap((f) => objectsToCreate(f.flow)), options.describe, objectFields);
88
+ await loadObjectFields(parentObjects(flows.map((f) => f.flow), objectFields), options.describe, objectFields);
89
+ }
63
90
  for (const { flowName, flow } of flows) {
64
91
  const test = generateApexTest(flow, objectFields);
65
92
  const classPath = join(outputDir, `${test.className}.cls`);
@@ -1 +1 @@
1
- {"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/core/scaffold.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/core/scaffold.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,5 @@
1
+ import type { FlowFingerprint } from './flowFingerprint.js';
2
+ import type { FlowGraph } from './flowGraph.js';
1
3
  /** One Apex test method that ran a Flow version. */
2
4
  export type FlowTestRef = {
3
5
  className: string;
@@ -18,7 +20,17 @@ export type FlowCoverage = {
18
20
  /** Elements covered across all tests, 0-100. */
19
21
  elementCoveragePercent: number;
20
22
  tests: FlowTestRef[];
23
+ /**
24
+ * How this version relates to the Flow's other versions, when known (set by `getFlowCoverage`):
25
+ * - `current`: it is the active version and the latest one.
26
+ * - `noActiveVersion`: no version is active; this is the latest, inactive version.
27
+ * - `newerInactiveVersion`: it is active, but a newer inactive version exists.
28
+ */
29
+ versionState?: FlowVersionState;
30
+ /** Version number of the Flow's latest version, when it differs from `versionNumber`. */
31
+ latestVersionNumber?: number;
21
32
  };
33
+ export type FlowVersionState = 'current' | 'noActiveVersion' | 'newerInactiveVersion';
22
34
  /**
23
35
  * Where Flow coverage comes from. Today the only implementation reads FlowTestCoverage
24
36
  * through the Tooling API; this seam exists so Flow Builder Test Mode coverage can be
@@ -27,8 +39,16 @@ export type FlowCoverage = {
27
39
  export type CoverageSource = {
28
40
  /** Every active Flow version that counts toward the deploy-as-active coverage requirement. */
29
41
  listActiveCountedFlows(): Promise<FlowCoverage[]>;
30
- /** Coverage for the named Flows (active version, else latest). Names missing from the org are omitted. */
42
+ /**
43
+ * Coverage for the named Flows (active version, else latest), with `versionState` set.
44
+ * Names missing from the org are omitted.
45
+ */
31
46
  getFlowCoverage(flowNames: string[]): Promise<FlowCoverage[]>;
47
+ /**
48
+ * Fingerprint of a Flow version's content, to compare with source. Undefined when the
49
+ * source can't read the version's content.
50
+ */
51
+ getFlowFingerprint?(flowVersionId: string): Promise<FlowFingerprint | undefined>;
32
52
  };
33
53
  /** Runs a Tooling API SOQL query and returns every record (all pages). */
34
54
  export type ToolingQuery = <T extends Record<string, unknown>>(soql: string) => Promise<T[]>;
@@ -39,6 +59,8 @@ export type FlowFilter = {
39
59
  apexValue?: string;
40
60
  /** Raw value text, for TODO comments. */
41
61
  rawValue?: string;
62
+ /** The entry-criteria formula term this filter was read from, for TODO comments. */
63
+ formulaTerm?: string;
42
64
  };
43
65
  export type FlowVariable = {
44
66
  name: string;
@@ -64,6 +86,8 @@ export type FlowMetadata = {
64
86
  filters: FlowFilter[];
65
87
  filterLogic?: string;
66
88
  filterFormula?: string;
89
+ /** The Flow's elements, for working out what a test can assert. */
90
+ graph?: FlowGraph;
67
91
  variables: FlowVariable[];
68
92
  };
69
93
  export type ReadinessFlow = {
@@ -97,7 +121,11 @@ export type GateFlowResult = {
97
121
  versionNumber?: number;
98
122
  elementCoveragePercent?: number;
99
123
  tests: FlowTestRef[];
124
+ /** Problems that don't change `status`, such as an org version that differs from source. */
125
+ warnings?: string[];
100
126
  };
127
+ /** What the gate does when the org's Flow content differs from source. */
128
+ export type ContentCheck = 'warn' | 'fail' | 'off';
101
129
  export type GateResult = {
102
130
  passed: boolean;
103
131
  minElementCoverage: number;
@@ -8,6 +8,10 @@ Salesforce only checks that the org-wide total stays at or above 75%, so a singl
8
8
 
9
9
  Coverage is read from FlowTestCoverage in the target org. Deploy the branch to the target org and run Apex tests there with `sf apex run test --code-coverage` before running the gate. Without `--code-coverage`, Salesforce records no Flow coverage. Flows that don't count toward deploy-as-active (screen Flows, inactive Flows) are skipped.
10
10
 
11
+ The gate also fails a Flow when the org has no active version of it, or when its active version is older than its latest version. Both usually mean the branch was deployed inactive, so the org's coverage doesn't belong to the version in the pull request.
12
+
13
+ With --from, the gate also compares each changed Flow at --to with the org's version: process type, start trigger and entry criteria, and the names of its elements and resources. A difference usually means the branch wasn't deployed to the org. By default this is a warning; use --content-check to fail instead, or to skip the comparison. The comparison doesn't look inside elements, so it can miss a change that only edits an existing element.
14
+
11
15
  Exits with code 1 when any Flow fails.
12
16
 
13
17
  # examples
@@ -20,6 +24,10 @@ Exits with code 1 when any Flow fails.
20
24
 
21
25
  <%= config.bin %> <%= command.id %> --target-org ci-sandbox --from origin/main --min-element-coverage 60
22
26
 
27
+ - Fail when the org runs a different version of a changed Flow than the branch:
28
+
29
+ <%= config.bin %> <%= command.id %> --target-org ci-sandbox --from origin/main --content-check fail
30
+
23
31
  - Check named Flows without git:
24
32
 
25
33
  <%= config.bin %> <%= command.id %> --target-org ci-sandbox --flow Account_After_Save --flow Close_Cases
@@ -44,6 +52,14 @@ Git repository to read changed Flows from.
44
52
 
45
53
  Minimum percentage of each Flow's elements that tests must run.
46
54
 
55
+ # flags.content-check.summary
56
+
57
+ What to do when a changed Flow's content differs from the org's version.
58
+
59
+ # flags.content-check.description
60
+
61
+ "warn" prints a warning, "fail" fails a Flow that would otherwise pass, and "off" skips the comparison (and its one Tooling API query per Flow). Only applies with --from.
62
+
47
63
  # error.noInput
48
64
 
49
65
  Provide --from to check changed Flows, or --flow to check named Flows.
@@ -4,7 +4,9 @@ Generate starter Apex tests for Flows.
4
4
 
5
5
  # description
6
6
 
7
- Reads each Flow's metadata file from the project and writes an Apex test class named `<Flow>_FlowTest` that runs it: record-triggered Flows get a record built from the trigger object and entry criteria, autolaunched Flows are started with Flow.Interview and their input variables, and platform event Flows publish the event. When a target org is available (--target-org or a default org), the command describes each object the test creates and fills in its required fields and any fields the entry criteria require to be set (IsNull false). The generated tests have TODOs for anything it can't fill in and placeholder assertions.
7
+ Reads each Flow's metadata file from the project and writes an Apex test class named `<Flow>_FlowTest` that runs it: record-triggered Flows get a record built from the trigger object and entry criteria, autolaunched Flows are started with Flow.Interview and their input variables, and platform event Flows publish the event. When a target org is available (--target-org or a default org), the command describes each object the test creates and fills in its required fields, the fields the entry criteria need, and parent records for required lookups.
8
+
9
+ For record-triggered Flows, the command follows the Flow's elements for the record the test creates. It asserts the fields the Flow is certain to set, and when the Flow is certain to stop the save with a custom error, the test expects that error. Fields the Flow sets only on a decision outcome the command can't predict get commented-out assertions. The generated tests have TODOs for anything the command can't fill in.
8
10
 
9
11
  Only Apex tests count toward deploying Flows as active, so this command generates Apex, not Flow Builder tests.
10
12
 
@@ -3,10 +3,11 @@
3
3
  "flowcov:gate": {
4
4
  "aliases": [],
5
5
  "args": {},
6
- "description": "Salesforce only checks that the org-wide total stays at or above 75%, so a single Flow with no tests can still be deployed as active. This gate checks each changed Flow on its own: every active autolaunched Flow or process changed between --from and --to must be run by at least one Apex test, and optionally reach a minimum element coverage.\n\nCoverage is read from FlowTestCoverage in the target org. Deploy the branch to the target org and run Apex tests there with `sf apex run test --code-coverage` before running the gate. Without `--code-coverage`, Salesforce records no Flow coverage. Flows that don't count toward deploy-as-active (screen Flows, inactive Flows) are skipped.\n\nExits with code 1 when any Flow fails.",
6
+ "description": "Salesforce only checks that the org-wide total stays at or above 75%, so a single Flow with no tests can still be deployed as active. This gate checks each changed Flow on its own: every active autolaunched Flow or process changed between --from and --to must be run by at least one Apex test, and optionally reach a minimum element coverage.\n\nCoverage is read from FlowTestCoverage in the target org. Deploy the branch to the target org and run Apex tests there with `sf apex run test --code-coverage` before running the gate. Without `--code-coverage`, Salesforce records no Flow coverage. Flows that don't count toward deploy-as-active (screen Flows, inactive Flows) are skipped.\n\nThe gate also fails a Flow when the org has no active version of it, or when its active version is older than its latest version. Both usually mean the branch was deployed inactive, so the org's coverage doesn't belong to the version in the pull request.\n\nWith --from, the gate also compares each changed Flow at --to with the org's version: process type, start trigger and entry criteria, and the names of its elements and resources. A difference usually means the branch wasn't deployed to the org. By default this is a warning; use --content-check to fail instead, or to skip the comparison. The comparison doesn't look inside elements, so it can miss a change that only edits an existing element.\n\nExits with code 1 when any Flow fails.",
7
7
  "examples": [
8
8
  "Check the Flows changed in a pull request:\n<%= config.bin %> <%= command.id %> --target-org ci-sandbox --from origin/main --to HEAD",
9
9
  "Also require 60% element coverage per Flow:\n<%= config.bin %> <%= command.id %> --target-org ci-sandbox --from origin/main --min-element-coverage 60",
10
+ "Fail when the org runs a different version of a changed Flow than the branch:\n<%= config.bin %> <%= command.id %> --target-org ci-sandbox --from origin/main --content-check fail",
10
11
  "Check named Flows without git:\n<%= config.bin %> <%= command.id %> --target-org ci-sandbox --flow Account_After_Save --flow Close_Cases"
11
12
  ],
12
13
  "flags": {
@@ -86,6 +87,20 @@
86
87
  "hasDynamicHelp": false,
87
88
  "multiple": false,
88
89
  "type": "option"
90
+ },
91
+ "content-check": {
92
+ "description": "\"warn\" prints a warning, \"fail\" fails a Flow that would otherwise pass, and \"off\" skips the comparison (and its one Tooling API query per Flow). Only applies with --from.",
93
+ "name": "content-check",
94
+ "summary": "What to do when a changed Flow's content differs from the org's version.",
95
+ "default": "warn",
96
+ "hasDynamicHelp": false,
97
+ "multiple": false,
98
+ "options": [
99
+ "warn",
100
+ "fail",
101
+ "off"
102
+ ],
103
+ "type": "option"
89
104
  }
90
105
  },
91
106
  "hasDynamicHelp": true,
@@ -208,7 +223,7 @@
208
223
  "flowcov:scaffold": {
209
224
  "aliases": [],
210
225
  "args": {},
211
- "description": "Reads each Flow's metadata file from the project and writes an Apex test class named `<Flow>_FlowTest` that runs it: record-triggered Flows get a record built from the trigger object and entry criteria, autolaunched Flows are started with Flow.Interview and their input variables, and platform event Flows publish the event. When a target org is available (--target-org or a default org), the command describes each object the test creates and fills in its required fields and any fields the entry criteria require to be set (IsNull false). The generated tests have TODOs for anything it can't fill in and placeholder assertions.\n\nOnly Apex tests count toward deploying Flows as active, so this command generates Apex, not Flow Builder tests.",
226
+ "description": "Reads each Flow's metadata file from the project and writes an Apex test class named `<Flow>_FlowTest` that runs it: record-triggered Flows get a record built from the trigger object and entry criteria, autolaunched Flows are started with Flow.Interview and their input variables, and platform event Flows publish the event. When a target org is available (--target-org or a default org), the command describes each object the test creates and fills in its required fields, the fields the entry criteria need, and parent records for required lookups.\n\nFor record-triggered Flows, the command follows the Flow's elements for the record the test creates. It asserts the fields the Flow is certain to set, and when the Flow is certain to stop the save with a custom error, the test expects that error. Fields the Flow sets only on a decision outcome the command can't predict get commented-out assertions. The generated tests have TODOs for anything the command can't fill in.\n\nOnly Apex tests count toward deploying Flows as active, so this command generates Apex, not Flow Builder tests.",
212
227
  "examples": [
213
228
  "Generate a test for one Flow:\n<%= config.bin %> <%= command.id %> --flow Account_After_Save",
214
229
  "Generate tests for every active Flow the org has no coverage for:\n<%= config.bin %> <%= command.id %> --uncovered --target-org prod",
@@ -313,5 +328,5 @@
313
328
  ]
314
329
  }
315
330
  },
316
- "version": "0.2.0"
331
+ "version": "0.3.0"
317
332
  }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "sf-flow-coverage",
3
3
  "description": "Get your Salesforce org ready to deploy Flows as active: find uncovered Flows, gate coverage per Flow in pull requests, and scaffold Apex tests.",
4
- "version": "0.2.0",
4
+ "version": "0.3.0",
5
5
  "dependencies": {
6
6
  "@oclif/core": "5.1.12",
7
7
  "@salesforce/core": "9.4.6",