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.
- package/CHANGELOG.md +24 -0
- package/README.md +142 -17
- package/lib/commands/flowcov/gate.d.ts +1 -0
- package/lib/commands/flowcov/gate.js +15 -2
- package/lib/commands/flowcov/gate.js.map +1 -1
- package/lib/commands/flowcov/readiness.js +25 -3
- package/lib/commands/flowcov/readiness.js.map +1 -1
- package/lib/commands/flowcov/transform.d.ts +15 -0
- package/lib/commands/flowcov/transform.js +78 -0
- package/lib/commands/flowcov/transform.js.map +1 -0
- package/lib/core/apexTemplate.d.ts +16 -1
- package/lib/core/apexTemplate.js +462 -104
- package/lib/core/apexTemplate.js.map +1 -1
- package/lib/core/conditions.d.ts +107 -0
- package/lib/core/conditions.js +481 -0
- package/lib/core/conditions.js.map +1 -0
- package/lib/core/coverageCheck.d.ts +8 -0
- package/lib/core/coverageCheck.js +12 -0
- package/lib/core/coverageCheck.js.map +1 -0
- package/lib/core/coverageFormats.d.ts +7 -0
- package/lib/core/coverageFormats.js +77 -0
- package/lib/core/coverageFormats.js.map +1 -0
- package/lib/core/criteria.d.ts +40 -0
- package/lib/core/criteria.js +262 -0
- package/lib/core/criteria.js.map +1 -0
- package/lib/core/elementCoverage.d.ts +9 -0
- package/lib/core/elementCoverage.js +27 -0
- package/lib/core/elementCoverage.js.map +1 -0
- package/lib/core/flowElementLines.d.ts +13 -0
- package/lib/core/flowElementLines.js +44 -0
- package/lib/core/flowElementLines.js.map +1 -0
- package/lib/core/flowFingerprint.d.ts +37 -0
- package/lib/core/flowFingerprint.js +142 -0
- package/lib/core/flowFingerprint.js.map +1 -0
- package/lib/core/flowGraph.d.ts +144 -0
- package/lib/core/flowGraph.js +279 -0
- package/lib/core/flowGraph.js.map +1 -0
- package/lib/core/flowSettings.d.ts +16 -0
- package/lib/core/flowSettings.js +49 -0
- package/lib/core/flowSettings.js.map +1 -0
- package/lib/core/flowTypes.d.ts +6 -0
- package/lib/core/flowTypes.js +17 -0
- package/lib/core/flowTypes.js.map +1 -1
- package/lib/core/flowValues.d.ts +14 -0
- package/lib/core/flowValues.js +43 -0
- package/lib/core/flowValues.js.map +1 -0
- package/lib/core/flowXml.d.ts +1 -1
- package/lib/core/flowXml.js +6 -39
- package/lib/core/flowXml.js.map +1 -1
- package/lib/core/formula.d.ts +48 -0
- package/lib/core/formula.js +227 -0
- package/lib/core/formula.js.map +1 -0
- package/lib/core/gate.d.ts +10 -1
- package/lib/core/gate.js +64 -7
- package/lib/core/gate.js.map +1 -1
- package/lib/core/orgCoverageSource.d.ts +9 -0
- package/lib/core/orgCoverageSource.js +68 -12
- package/lib/core/orgCoverageSource.js.map +1 -1
- package/lib/core/readiness.d.ts +5 -0
- package/lib/core/readiness.js +24 -10
- package/lib/core/readiness.js.map +1 -1
- package/lib/core/requiredFields.d.ts +53 -3
- package/lib/core/requiredFields.js +158 -10
- package/lib/core/requiredFields.js.map +1 -1
- package/lib/core/scaffold.js +50 -4
- package/lib/core/scaffold.js.map +1 -1
- package/lib/core/toolingQuery.d.ts +5 -0
- package/lib/core/toolingQuery.js +9 -1
- package/lib/core/toolingQuery.js.map +1 -1
- package/lib/core/transform.d.ts +36 -0
- package/lib/core/transform.js +62 -0
- package/lib/core/transform.js.map +1 -0
- package/lib/core/types.d.ts +79 -1
- package/lib/index.d.ts +6 -1
- package/lib/index.js +3 -1
- package/lib/index.js.map +1 -1
- package/messages/flowcov.gate.md +19 -1
- package/messages/flowcov.readiness.md +4 -2
- package/messages/flowcov.scaffold.md +5 -1
- package/messages/flowcov.transform.md +33 -0
- package/oclif.manifest.json +113 -4
- 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,9 +11,23 @@ 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;
|
|
30
|
+
fingerprints = new Map();
|
|
16
31
|
constructor(query) {
|
|
17
32
|
this.query = query;
|
|
18
33
|
}
|
|
@@ -25,15 +40,55 @@ export class OrgCoverageSource {
|
|
|
25
40
|
return [];
|
|
26
41
|
const wanted = new Set(flowNames);
|
|
27
42
|
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
|
|
30
|
-
|
|
31
|
-
.
|
|
32
|
-
|
|
33
|
-
|
|
43
|
+
const definitions = await this.queryInChunks(developerNames, (list) => `SELECT Id, DeveloperName, NamespacePrefix, ActiveVersionId, LatestVersionId, LatestVersion.VersionNumber FROM FlowDefinition WHERE DeveloperName IN (${list})`);
|
|
44
|
+
const definitionByVersion = new Map();
|
|
45
|
+
for (const definition of definitions) {
|
|
46
|
+
if (!wanted.has(qualifiedFlowName(definition.DeveloperName, definition.NamespacePrefix)))
|
|
47
|
+
continue;
|
|
48
|
+
const versionId = definition.ActiveVersionId ?? definition.LatestVersionId;
|
|
49
|
+
if (versionId)
|
|
50
|
+
definitionByVersion.set(idKey(versionId), definition);
|
|
51
|
+
}
|
|
52
|
+
if (definitionByVersion.size === 0)
|
|
34
53
|
return [];
|
|
35
|
-
const flows = await this.queryInChunks(
|
|
36
|
-
|
|
54
|
+
const flows = await this.queryInChunks([...definitionByVersion.values()].map((d) => (d.ActiveVersionId ?? d.LatestVersionId)), (list) => `SELECT ${FLOW_FIELDS} FROM Flow WHERE Id IN (${list})`);
|
|
55
|
+
const coverage = await this.buildCoverage(flows);
|
|
56
|
+
return coverage.map((flow) => {
|
|
57
|
+
const definition = definitionByVersion.get(idKey(flow.flowVersionId));
|
|
58
|
+
return definition ? { ...flow, ...versionInfo(definition) } : flow;
|
|
59
|
+
});
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* The Tooling API returns `Flow.Metadata` only when a query returns one row, so this reads one
|
|
63
|
+
* version per query. Returns undefined when the query fails or returns no content.
|
|
64
|
+
*/
|
|
65
|
+
async hasAnyFlowCoverage() {
|
|
66
|
+
try {
|
|
67
|
+
return (await this.query('SELECT Id FROM FlowTestCoverage LIMIT 1')).length > 0;
|
|
68
|
+
}
|
|
69
|
+
catch {
|
|
70
|
+
// Without an answer, don't claim coverage is missing.
|
|
71
|
+
return true;
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
getFlowFingerprint(flowVersionId) {
|
|
75
|
+
// The gate's content check and its uncovered-element list both ask for the same versions.
|
|
76
|
+
const key = idKey(flowVersionId);
|
|
77
|
+
let fingerprint = this.fingerprints.get(key);
|
|
78
|
+
if (!fingerprint) {
|
|
79
|
+
fingerprint = this.readFingerprint(flowVersionId);
|
|
80
|
+
this.fingerprints.set(key, fingerprint);
|
|
81
|
+
}
|
|
82
|
+
return fingerprint;
|
|
83
|
+
}
|
|
84
|
+
async readFingerprint(flowVersionId) {
|
|
85
|
+
try {
|
|
86
|
+
const [record] = await this.query(`SELECT Metadata FROM Flow WHERE Id = ${soqlList([flowVersionId])}`);
|
|
87
|
+
return record?.Metadata ? fingerprintFromMetadata(record.Metadata) : undefined;
|
|
88
|
+
}
|
|
89
|
+
catch {
|
|
90
|
+
return undefined;
|
|
91
|
+
}
|
|
37
92
|
}
|
|
38
93
|
async queryInChunks(values, buildSoql) {
|
|
39
94
|
const results = [];
|
|
@@ -56,10 +111,10 @@ export class OrgCoverageSource {
|
|
|
56
111
|
const rows = rowsByVersion.get(idKey(flow.Id)) ?? [];
|
|
57
112
|
const elementsTotal = Math.max(0, ...rows.map((r) => (r.NumElementsCovered ?? 0) + (r.NumElementsNotCovered ?? 0)));
|
|
58
113
|
const bestSingleTest = Math.max(0, ...rows.map((r) => r.NumElementsCovered ?? 0));
|
|
59
|
-
const
|
|
60
|
-
? new Set(rows.flatMap((r) => [...(coveredElements.get(idKey(r.Id)) ?? [])]))
|
|
61
|
-
:
|
|
62
|
-
const elementsCovered = Math.min(Math.max(bestSingleTest,
|
|
114
|
+
const coveredNames = coveredElements
|
|
115
|
+
? new Set(rows.flatMap((r) => [...(coveredElements.get(idKey(r.Id)) ?? [])]))
|
|
116
|
+
: undefined;
|
|
117
|
+
const elementsCovered = Math.min(Math.max(bestSingleTest, coveredNames?.size ?? 0), elementsTotal);
|
|
63
118
|
const tests = rows.map((r) => ({
|
|
64
119
|
className: (r.ApexTestClassId && classNames.get(idKey(r.ApexTestClassId))) || r.ApexTestClassId || 'unknown',
|
|
65
120
|
methodName: r.TestMethodName ?? 'unknown',
|
|
@@ -75,6 +130,7 @@ export class OrgCoverageSource {
|
|
|
75
130
|
elementsTotal,
|
|
76
131
|
elementCoveragePercent: elementsTotal > 0 ? Math.round((elementsCovered / elementsTotal) * 1000) / 10 : 0,
|
|
77
132
|
tests,
|
|
133
|
+
coveredElementNames: coveredNames && [...coveredNames].sort(),
|
|
78
134
|
};
|
|
79
135
|
});
|
|
80
136
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"orgCoverageSource.js","sourceRoot":"","sources":["../../src/core/orgCoverageSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;
|
|
1
|
+
{"version":3,"file":"orgCoverageSource.js","sourceRoot":"","sources":["../../src/core/orgCoverageSource.ts"],"names":[],"mappings":"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"}
|
package/lib/core/readiness.d.ts
CHANGED
|
@@ -1,9 +1,14 @@
|
|
|
1
|
+
import { type DataQuery, type MetadataRead } from './flowSettings.js';
|
|
1
2
|
import type { CoverageSource, ReadinessResult } from './types.js';
|
|
2
3
|
export type ReadinessOptions = {
|
|
3
4
|
source: CoverageSource;
|
|
4
5
|
/** Commit counts per Flow API name, used to rank uncovered Flows. */
|
|
5
6
|
churn?: Map<string, number>;
|
|
6
7
|
threshold?: number;
|
|
8
|
+
/** Reads org settings, to report whether deploy-as-active is already on. */
|
|
9
|
+
metadataRead?: MetadataRead;
|
|
10
|
+
/** Queries org data, to tell production from sandboxes for the deploy-as-active advice. */
|
|
11
|
+
dataQuery?: DataQuery;
|
|
7
12
|
};
|
|
8
13
|
/**
|
|
9
14
|
* Measures the org against the deploy-as-active coverage requirement: the share of
|
package/lib/core/readiness.js
CHANGED
|
@@ -1,4 +1,7 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { missingCoverageWarning } from './coverageCheck.js';
|
|
2
|
+
import { findUncoveredElements } from './elementCoverage.js';
|
|
3
|
+
import { readDeployAsActive, readIsSandbox } from './flowSettings.js';
|
|
4
|
+
import { DEFAULT_THRESHOLD, isProcessBuilder } from './flowTypes.js';
|
|
2
5
|
/**
|
|
3
6
|
* Measures the org against the deploy-as-active coverage requirement: the share of
|
|
4
7
|
* active autolaunched Flows and processes that at least one Apex test runs.
|
|
@@ -6,15 +9,21 @@ import { DEFAULT_THRESHOLD } from './flowTypes.js';
|
|
|
6
9
|
export async function buildReadinessReport(options) {
|
|
7
10
|
const threshold = options.threshold ?? DEFAULT_THRESHOLD;
|
|
8
11
|
const coverage = await options.source.listActiveCountedFlows();
|
|
9
|
-
const flows =
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
12
|
+
const flows = [];
|
|
13
|
+
for (const c of coverage) {
|
|
14
|
+
// Sequential on purpose: one Tooling API query per partly covered Flow.
|
|
15
|
+
const uncoveredElements = await findUncoveredElements(options.source, c);
|
|
16
|
+
flows.push({
|
|
17
|
+
flowName: c.flowName,
|
|
18
|
+
processType: c.processType,
|
|
19
|
+
versionNumber: c.versionNumber,
|
|
20
|
+
covered: c.covered,
|
|
21
|
+
elementCoveragePercent: c.elementCoveragePercent,
|
|
22
|
+
tests: c.tests,
|
|
23
|
+
changes: options.churn ? (options.churn.get(c.flowName) ?? 0) : undefined,
|
|
24
|
+
...(uncoveredElements ? { uncoveredElements } : {}),
|
|
25
|
+
});
|
|
26
|
+
}
|
|
18
27
|
flows.sort((a, b) => Number(a.covered) - Number(b.covered) ||
|
|
19
28
|
(b.changes ?? 0) - (a.changes ?? 0) ||
|
|
20
29
|
a.flowName.localeCompare(b.flowName));
|
|
@@ -23,6 +32,7 @@ export async function buildReadinessReport(options) {
|
|
|
23
32
|
// With no active Flows to cover, Salesforce has nothing to block.
|
|
24
33
|
const coveragePercent = totalFlows === 0 ? 100 : Math.round((coveredFlows / totalFlows) * 1000) / 10;
|
|
25
34
|
const flowsNeeded = Math.max(0, Math.ceil((threshold * totalFlows) / 100) - coveredFlows);
|
|
35
|
+
const warning = await missingCoverageWarning(options.source, totalFlows > 0 && coveredFlows === 0);
|
|
26
36
|
return {
|
|
27
37
|
threshold,
|
|
28
38
|
totalFlows,
|
|
@@ -31,7 +41,11 @@ export async function buildReadinessReport(options) {
|
|
|
31
41
|
coveragePercent,
|
|
32
42
|
ready: flowsNeeded === 0,
|
|
33
43
|
flowsNeeded,
|
|
44
|
+
processBuilderProcesses: flows.filter((f) => isProcessBuilder(f.processType)).length,
|
|
34
45
|
flows,
|
|
46
|
+
deployAsActive: options.metadataRead ? await readDeployAsActive(options.metadataRead) : undefined,
|
|
47
|
+
isSandbox: options.dataQuery ? await readIsSandbox(options.dataQuery) : undefined,
|
|
48
|
+
warnings: warning ? [warning] : [],
|
|
35
49
|
};
|
|
36
50
|
}
|
|
37
51
|
//# sourceMappingURL=readiness.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../../src/core/readiness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;
|
|
1
|
+
{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../../src/core/readiness.ts"],"names":[],"mappings":"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"}
|
|
@@ -14,9 +14,18 @@ export type DescribeField = {
|
|
|
14
14
|
defaultValue?: boolean;
|
|
15
15
|
}> | null;
|
|
16
16
|
referenceTo?: string[] | null;
|
|
17
|
+
/** The field's default value, such as a checkbox's `true` or `false`. */
|
|
18
|
+
defaultValue?: unknown;
|
|
19
|
+
/** For lookups, the relationship name used in paths such as `Account__r.Type`. */
|
|
20
|
+
relationshipName?: string | null;
|
|
17
21
|
};
|
|
18
22
|
/** Describes an sObject's fields. Returns undefined when the object can't be described. */
|
|
19
|
-
export type DescribeObject = (objectName: string) => Promise<DescribeField[] | undefined>;
|
|
23
|
+
export type DescribeObject = (objectName: string) => Promise<DescribeField[] | DescribeResult | undefined>;
|
|
24
|
+
/** An sObject describe: its fields, and its record types when known. */
|
|
25
|
+
export type DescribeResult = {
|
|
26
|
+
fields: DescribeField[];
|
|
27
|
+
recordTypeInfos?: unknown[];
|
|
28
|
+
};
|
|
20
29
|
/** Field name to Apex literal, per object. */
|
|
21
30
|
export type RequiredFieldMap = Record<string, Record<string, string>>;
|
|
22
31
|
/** An Apex literal for a required field, or undefined when no safe value can be made up. */
|
|
@@ -28,9 +37,50 @@ export declare function requiredFieldValues(fields: DescribeField[]): Record<str
|
|
|
28
37
|
* Lookups are left out: a made-up null Id can't satisfy "is not null".
|
|
29
38
|
*/
|
|
30
39
|
export declare function settableFieldValues(fields: DescribeField[]): Record<string, string>;
|
|
40
|
+
/**
|
|
41
|
+
* An Apex literal that differs from `apexValueForField`'s value for the same field, so an update
|
|
42
|
+
* changes the field whether the insert left it empty or filled it. Undefined when there's no safe
|
|
43
|
+
* second value (lookups, single-value picklists, unknown types).
|
|
44
|
+
*/
|
|
45
|
+
export declare function changedValueForField(field: DescribeField): string | undefined;
|
|
46
|
+
/** A changed value for every field a test could update, used to meet `IsChanged` entry criteria. */
|
|
47
|
+
export declare function changedFieldValues(fields: DescribeField[]): Record<string, string>;
|
|
31
48
|
export type ObjectFields = {
|
|
32
49
|
requiredFields: RequiredFieldMap;
|
|
33
50
|
fieldValues: RequiredFieldMap;
|
|
51
|
+
changedValues: RequiredFieldMap;
|
|
52
|
+
/** The object each lookup field points to, per object. Only lookups to a single object are listed. */
|
|
53
|
+
lookups: Record<string, Record<string, string>>;
|
|
54
|
+
/** Lookup field per relationship name (`Account__r` to `Account__c`), per object. */
|
|
55
|
+
relationships: Record<string, Record<string, string>>;
|
|
56
|
+
/** How many record types each object has, including Master, when the describe says. */
|
|
57
|
+
recordTypes: Record<string, number>;
|
|
58
|
+
/** What a new record holds in each field a test doesn't set, per object (see `unsetFieldValues`). */
|
|
59
|
+
unsetValues: Record<string, Record<string, string | null>>;
|
|
34
60
|
};
|
|
35
|
-
|
|
36
|
-
|
|
61
|
+
export declare const emptyObjectFields: () => ObjectFields;
|
|
62
|
+
/** Lookup targets a test points at an existing record instead of inserting one. */
|
|
63
|
+
export declare const EXISTING_RECORD_IDS: Record<string, string>;
|
|
64
|
+
/** Parents are inserted this many levels deep at most: parent, grandparent, great-grandparent. */
|
|
65
|
+
export declare const MAX_PARENT_DEPTH = 3;
|
|
66
|
+
/** Whether a generated test can insert a record of `object` to fill a lookup to it. */
|
|
67
|
+
export declare const canInsertParent: (object: string) => boolean;
|
|
68
|
+
/**
|
|
69
|
+
* What a new record holds in each field the test doesn't set, as an Apex literal (or `null`):
|
|
70
|
+
* empty for nillable fields with no default, a checkbox's default, and the default picklist
|
|
71
|
+
* value when the object has no record types that could change it (`recordTypes` of 1 or
|
|
72
|
+
* fewer). Lets a test follow the Flow's decisions on fields it doesn't set.
|
|
73
|
+
*/
|
|
74
|
+
export declare function unsetFieldValues(fields: DescribeField[], recordTypes?: number): Record<string, string | null>;
|
|
75
|
+
/** Lookup field per relationship name, for criteria on related records. */
|
|
76
|
+
export declare function relationshipLookups(fields: DescribeField[]): Record<string, string>;
|
|
77
|
+
/**
|
|
78
|
+
* The object each createable lookup points to. A polymorphic lookup (`WhatId`, `OwnerId`) gets
|
|
79
|
+
* the running user when it can point at users, else the first object a test can insert.
|
|
80
|
+
*/
|
|
81
|
+
export declare function lookupTargets(fields: DescribeField[]): Record<string, string>;
|
|
82
|
+
/**
|
|
83
|
+
* Describes each object once, adding to `into` when given. Objects already in `into`, and
|
|
84
|
+
* objects that can't be described, are skipped.
|
|
85
|
+
*/
|
|
86
|
+
export declare function loadObjectFields(objects: string[], describe: DescribeObject, into?: ObjectFields): Promise<ObjectFields>;
|
|
@@ -71,23 +71,171 @@ export function settableFieldValues(fields) {
|
|
|
71
71
|
}
|
|
72
72
|
return values;
|
|
73
73
|
}
|
|
74
|
-
/**
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
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
|
+
relationships: {},
|
|
132
|
+
recordTypes: {},
|
|
133
|
+
unsetValues: {},
|
|
134
|
+
});
|
|
135
|
+
/** Lookup targets a test points at an existing record instead of inserting one. */
|
|
136
|
+
export const EXISTING_RECORD_IDS = {
|
|
137
|
+
User: 'UserInfo.getUserId()',
|
|
138
|
+
Pricebook2: 'Test.getStandardPricebookId()',
|
|
139
|
+
};
|
|
140
|
+
/** Setup objects a test can't simply insert (or would hit mixed DML with); their lookups stay TODOs. */
|
|
141
|
+
const NOT_INSERTABLE = new Set([
|
|
142
|
+
'BusinessHours',
|
|
143
|
+
'Group',
|
|
144
|
+
'Organization',
|
|
145
|
+
'PermissionSet',
|
|
146
|
+
'Profile',
|
|
147
|
+
'RecordType',
|
|
148
|
+
'UserRole',
|
|
149
|
+
]);
|
|
150
|
+
/** Parents are inserted this many levels deep at most: parent, grandparent, great-grandparent. */
|
|
151
|
+
export const MAX_PARENT_DEPTH = 3;
|
|
152
|
+
/** Whether a generated test can insert a record of `object` to fill a lookup to it. */
|
|
153
|
+
export const canInsertParent = (object) => !NOT_INSERTABLE.has(object) && !(object in EXISTING_RECORD_IDS);
|
|
154
|
+
/**
|
|
155
|
+
* What a new record holds in each field the test doesn't set, as an Apex literal (or `null`):
|
|
156
|
+
* empty for nillable fields with no default, a checkbox's default, and the default picklist
|
|
157
|
+
* value when the object has no record types that could change it (`recordTypes` of 1 or
|
|
158
|
+
* fewer). Lets a test follow the Flow's decisions on fields it doesn't set.
|
|
159
|
+
*/
|
|
160
|
+
export function unsetFieldValues(fields, recordTypes) {
|
|
161
|
+
const values = {};
|
|
162
|
+
for (const field of fields) {
|
|
163
|
+
if (!field.createable || field.calculated || field.autoNumber)
|
|
164
|
+
continue;
|
|
165
|
+
const pickDefault = (field.picklistValues ?? []).find((value) => value.active && value.defaultValue);
|
|
166
|
+
if (field.type === 'boolean' && (field.defaultValue === true || field.defaultValue === false)) {
|
|
167
|
+
values[field.name] = String(field.defaultValue);
|
|
168
|
+
}
|
|
169
|
+
else if (field.type === 'boolean' && (field.defaultValue === 'true' || field.defaultValue === 'false')) {
|
|
170
|
+
values[field.name] = field.defaultValue;
|
|
171
|
+
}
|
|
172
|
+
else if (pickDefault) {
|
|
173
|
+
// Record types can give a picklist a different default.
|
|
174
|
+
if (field.type === 'picklist' && recordTypes !== undefined && recordTypes <= 1) {
|
|
175
|
+
values[field.name] = `'${escapeApexString(pickDefault.value)}'`;
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
else if (field.nillable && !field.defaultedOnCreate) {
|
|
179
|
+
values[field.name] = null;
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
return values;
|
|
183
|
+
}
|
|
184
|
+
/** Lookup field per relationship name, for criteria on related records. */
|
|
185
|
+
export function relationshipLookups(fields) {
|
|
186
|
+
const relationships = {};
|
|
187
|
+
for (const field of fields) {
|
|
188
|
+
if (field.type === 'reference' && field.relationshipName)
|
|
189
|
+
relationships[field.relationshipName] = field.name;
|
|
190
|
+
}
|
|
191
|
+
return relationships;
|
|
192
|
+
}
|
|
193
|
+
/**
|
|
194
|
+
* The object each createable lookup points to. A polymorphic lookup (`WhatId`, `OwnerId`) gets
|
|
195
|
+
* the running user when it can point at users, else the first object a test can insert.
|
|
196
|
+
*/
|
|
197
|
+
export function lookupTargets(fields) {
|
|
198
|
+
const targets = {};
|
|
199
|
+
for (const field of fields) {
|
|
200
|
+
if (field.type !== 'reference' || !field.createable || field.calculated)
|
|
201
|
+
continue;
|
|
202
|
+
const options = field.referenceTo ?? [];
|
|
203
|
+
const target = options.length === 1
|
|
204
|
+
? options[0]
|
|
205
|
+
: (options.find((o) => o in EXISTING_RECORD_IDS) ?? options.find((o) => canInsertParent(o)));
|
|
206
|
+
if (target)
|
|
207
|
+
targets[field.name] = target;
|
|
208
|
+
}
|
|
209
|
+
return targets;
|
|
210
|
+
}
|
|
211
|
+
/**
|
|
212
|
+
* Describes each object once, adding to `into` when given. Objects already in `into`, and
|
|
213
|
+
* objects that can't be described, are skipped.
|
|
214
|
+
*/
|
|
215
|
+
export async function loadObjectFields(objects, describe, into = emptyObjectFields()) {
|
|
78
216
|
for (const object of [...new Set(objects)]) {
|
|
79
|
-
|
|
217
|
+
if (object in into.requiredFields)
|
|
218
|
+
continue;
|
|
219
|
+
let result;
|
|
80
220
|
try {
|
|
81
|
-
|
|
221
|
+
result = await describe(object);
|
|
82
222
|
}
|
|
83
223
|
catch {
|
|
84
|
-
|
|
224
|
+
result = undefined;
|
|
225
|
+
}
|
|
226
|
+
const fields = Array.isArray(result) ? result : result?.fields;
|
|
227
|
+
if (result && !Array.isArray(result) && result.recordTypeInfos) {
|
|
228
|
+
into.recordTypes[object] = result.recordTypeInfos.length;
|
|
85
229
|
}
|
|
86
230
|
if (fields) {
|
|
87
|
-
requiredFields[object] = requiredFieldValues(fields);
|
|
88
|
-
fieldValues[object] = settableFieldValues(fields);
|
|
231
|
+
into.requiredFields[object] = requiredFieldValues(fields);
|
|
232
|
+
into.fieldValues[object] = settableFieldValues(fields);
|
|
233
|
+
into.changedValues[object] = changedFieldValues(fields);
|
|
234
|
+
into.lookups[object] = lookupTargets(fields);
|
|
235
|
+
into.relationships[object] = relationshipLookups(fields);
|
|
236
|
+
into.unsetValues[object] = unsetFieldValues(fields, into.recordTypes[object]);
|
|
89
237
|
}
|
|
90
238
|
}
|
|
91
|
-
return
|
|
239
|
+
return into;
|
|
92
240
|
}
|
|
93
241
|
//# 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;
|
|
1
|
+
{"version":3,"file":"requiredFields.js","sourceRoot":"","sources":["../../src/core/requiredFields.ts"],"names":[],"mappings":"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"}
|
package/lib/core/scaffold.js
CHANGED
|
@@ -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 { entryCondition, fieldPaths } from './conditions.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, MAX_PARENT_DEPTH, } 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,44 @@ function objectsToCreate(flow) {
|
|
|
16
17
|
objects.push(flow.object);
|
|
17
18
|
return objects;
|
|
18
19
|
}
|
|
20
|
+
/**
|
|
21
|
+
* Lookup fields the entry criteria read on the triggering record: lookups compared directly
|
|
22
|
+
* (`Account__c`) and the lookups behind related fields (`Account__r.Type`).
|
|
23
|
+
*/
|
|
24
|
+
function criteriaLookups(flow, relationships) {
|
|
25
|
+
const lookups = new Set();
|
|
26
|
+
for (const path of fieldPaths(entryCondition(flow))) {
|
|
27
|
+
if (path.length === 1)
|
|
28
|
+
lookups.add(path[0]);
|
|
29
|
+
else if (relationships[path[0]])
|
|
30
|
+
lookups.add(relationships[path[0]]);
|
|
31
|
+
}
|
|
32
|
+
return lookups;
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Objects a generated test inserts as parents: targets of lookups that are required, or that
|
|
36
|
+
* the entry criteria reference, on the records the test creates.
|
|
37
|
+
*/
|
|
38
|
+
function parentObjects(flows, fields) {
|
|
39
|
+
const parents = [];
|
|
40
|
+
for (const flow of flows) {
|
|
41
|
+
for (const object of objectsToCreate(flow)) {
|
|
42
|
+
const criteria = object === flow.object ? criteriaLookups(flow, fields.relationships[object] ?? {}) : new Set();
|
|
43
|
+
for (const [field, target] of Object.entries(fields.lookups[object] ?? {})) {
|
|
44
|
+
const used = field in (fields.requiredFields[object] ?? {}) || criteria.has(field);
|
|
45
|
+
if (used && canInsertParent(target))
|
|
46
|
+
parents.push(target);
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
return parents;
|
|
51
|
+
}
|
|
52
|
+
/** Targets of the required lookups on the given (already described) parent objects. */
|
|
53
|
+
function grandparentObjects(objects, fields) {
|
|
54
|
+
return objects.flatMap((object) => Object.entries(fields.lookups[object] ?? {})
|
|
55
|
+
.filter(([field, target]) => field in (fields.requiredFields[object] ?? {}) && canInsertParent(target))
|
|
56
|
+
.map(([, target]) => target));
|
|
57
|
+
}
|
|
19
58
|
async function exists(path) {
|
|
20
59
|
try {
|
|
21
60
|
await access(path);
|
|
@@ -57,9 +96,16 @@ export async function scaffoldTests(options) {
|
|
|
57
96
|
}
|
|
58
97
|
flows.push({ flowName, flow });
|
|
59
98
|
}
|
|
60
|
-
const objectFields =
|
|
61
|
-
|
|
62
|
-
|
|
99
|
+
const objectFields = emptyObjectFields();
|
|
100
|
+
if (options.describe) {
|
|
101
|
+
await loadObjectFields(flows.flatMap((f) => objectsToCreate(f.flow)), options.describe, objectFields);
|
|
102
|
+
let level = parentObjects(flows.map((f) => f.flow), objectFields);
|
|
103
|
+
for (let depth = 1; depth <= MAX_PARENT_DEPTH && level.length > 0; depth++) {
|
|
104
|
+
const fresh = [...new Set(level)].filter((object) => !(object in objectFields.requiredFields));
|
|
105
|
+
await loadObjectFields(fresh, options.describe, objectFields);
|
|
106
|
+
level = grandparentObjects(fresh, objectFields);
|
|
107
|
+
}
|
|
108
|
+
}
|
|
63
109
|
for (const { flowName, flow } of flows) {
|
|
64
110
|
const test = generateApexTest(flow, objectFields);
|
|
65
111
|
const classPath = join(outputDir, `${test.className}.cls`);
|
package/lib/core/scaffold.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/core/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,
|
|
1
|
+
{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/core/scaffold.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,7 +1,12 @@
|
|
|
1
1
|
import type { Connection } from '@salesforce/core';
|
|
2
|
+
import type { DataQuery, MetadataRead } from './flowSettings.js';
|
|
2
3
|
import type { DescribeObject } from './requiredFields.js';
|
|
3
4
|
import type { ToolingQuery } from './types.js';
|
|
4
5
|
/** Adapts an org connection to the ToolingQuery used by OrgCoverageSource, fetching every page. */
|
|
5
6
|
export declare function toolingQuery(connection: Pick<Connection, 'tooling'>): ToolingQuery;
|
|
7
|
+
/** Adapts an org connection to a data API query, fetching every page. */
|
|
8
|
+
export declare function dataQuery(connection: Pick<Connection, 'query'>): DataQuery;
|
|
9
|
+
/** Adapts an org connection to the MetadataRead used to read org settings. */
|
|
10
|
+
export declare function metadataRead(connection: Pick<Connection, 'metadata'>): MetadataRead;
|
|
6
11
|
/** Adapts an org connection to the DescribeObject used by scaffolding to fill required fields. */
|
|
7
12
|
export declare function describeObject(connection: Pick<Connection, 'describe'>): DescribeObject;
|