sf-flow-coverage 0.1.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 (43) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +52 -13
  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 +10 -2
  7. package/lib/core/apexTemplate.js +327 -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 +12 -1
  25. package/lib/core/gate.js +60 -6
  26. package/lib/core/gate.js.map +1 -1
  27. package/lib/core/git.d.ts +7 -2
  28. package/lib/core/git.js +104 -58
  29. package/lib/core/git.js.map +1 -1
  30. package/lib/core/orgCoverageSource.d.ts +6 -0
  31. package/lib/core/orgCoverageSource.js +43 -8
  32. package/lib/core/orgCoverageSource.js.map +1 -1
  33. package/lib/core/requiredFields.d.ts +39 -2
  34. package/lib/core/requiredFields.js +131 -6
  35. package/lib/core/requiredFields.js.map +1 -1
  36. package/lib/core/scaffold.js +32 -5
  37. package/lib/core/scaffold.js.map +1 -1
  38. package/lib/core/types.d.ts +29 -1
  39. package/messages/flowcov.gate.md +17 -1
  40. package/messages/flowcov.readiness.md +2 -2
  41. package/messages/flowcov.scaffold.md +3 -1
  42. package/oclif.manifest.json +20 -5
  43. package/package.json +10 -9
package/lib/core/git.d.ts CHANGED
@@ -1,7 +1,12 @@
1
+ /**
2
+ * Parses a `--since` value: an ISO date (`2026-01-31`, `2026-01-31T12:00:00Z`) or
3
+ * `<n> days|weeks|months|years ago`. Throws for anything else.
4
+ */
5
+ export declare function parseSince(value: string, now?: Date): Date;
1
6
  export declare function isGitRepo(cwd: string): Promise<boolean>;
2
7
  /**
3
- * Counts commits that touched each Flow file, keyed by Flow API name.
4
- * Returns undefined when `cwd` is not inside a git repository.
8
+ * Counts commits that touched each Flow file, keyed by Flow API name. Merge commits are not
9
+ * counted, as with `git log --name-only`. Returns undefined when `cwd` is not inside a git repository.
5
10
  */
6
11
  export declare function getFlowChurn(cwd: string, since?: string): Promise<Map<string, number> | undefined>;
7
12
  /**
package/lib/core/git.js CHANGED
@@ -1,81 +1,127 @@
1
- import { execFile } from 'node:child_process';
2
- import { promisify } from 'node:util';
1
+ import { resolve as resolvePath } from 'node:path';
2
+ import { openRepository } from '@scolladon/tsgit';
3
3
  import { flowNameFromPath } from './flowTypes.js';
4
- const execFileAsync = promisify(execFile);
5
- const FLOW_PATHSPECS = ['*.flow-meta.xml', '*.flow'];
6
- const MAX_BUFFER = 64 * 1024 * 1024;
7
- async function git(cwd, args) {
8
- const { stdout } = await execFileAsync('git', ['-c', 'core.quotePath=false', ...args], {
9
- cwd,
10
- maxBuffer: MAX_BUFFER,
11
- windowsHide: true,
12
- });
13
- return stdout;
14
- }
15
- export async function isGitRepo(cwd) {
4
+ async function withRepo(cwd, work) {
5
+ // tsgit requires an absolute path; --project-dir defaults to '.'.
6
+ const repo = await openRepository({ cwd: resolvePath(cwd) });
16
7
  try {
17
- return (await git(cwd, ['rev-parse', '--is-inside-work-tree'])).trim() === 'true';
8
+ return await work(repo);
9
+ }
10
+ finally {
11
+ await repo.dispose();
12
+ }
13
+ }
14
+ /** Resolves a revision (branch, tag, `HEAD~1`, oid...) to an object id. */
15
+ async function resolve(repo, revision) {
16
+ const [entry] = await repo.revParse(revision);
17
+ if (entry?.kind !== 'object')
18
+ throw new Error(`Git revision "${revision}" does not resolve to a commit.`);
19
+ return entry.id;
20
+ }
21
+ /** The path a change leaves behind (its old path for deletions). */
22
+ function changedPath(change) {
23
+ switch (change.type) {
24
+ case 'add':
25
+ case 'rename':
26
+ case 'copy':
27
+ return String(change.newPath);
28
+ case 'delete':
29
+ return String(change.oldPath);
30
+ default:
31
+ return String(change.path);
32
+ }
33
+ }
34
+ const RELATIVE_SINCE = /^(\d+)\s+(day|week|month|year)s?\s+ago$/i;
35
+ /**
36
+ * Parses a `--since` value: an ISO date (`2026-01-31`, `2026-01-31T12:00:00Z`) or
37
+ * `<n> days|weeks|months|years ago`. Throws for anything else.
38
+ */
39
+ export function parseSince(value, now = new Date()) {
40
+ const trimmed = value.trim();
41
+ const relative = RELATIVE_SINCE.exec(trimmed);
42
+ if (relative) {
43
+ const amount = Number(relative[1]);
44
+ const date = new Date(now);
45
+ const unit = relative[2].toLowerCase();
46
+ if (unit === 'day')
47
+ date.setUTCDate(date.getUTCDate() - amount);
48
+ else if (unit === 'week')
49
+ date.setUTCDate(date.getUTCDate() - amount * 7);
50
+ else if (unit === 'month')
51
+ date.setUTCMonth(date.getUTCMonth() - amount);
52
+ else
53
+ date.setUTCFullYear(date.getUTCFullYear() - amount);
54
+ return date;
18
55
  }
19
- catch {
20
- return false;
56
+ const date = /^\d{4}-\d{2}-\d{2}/.test(trimmed) ? new Date(trimmed) : undefined;
57
+ if (!date || Number.isNaN(date.getTime())) {
58
+ throw new Error(`Unsupported --since value "${value}". Use a date (2026-01-31) or "<n> days|weeks|months|years ago".`);
21
59
  }
60
+ return date;
22
61
  }
23
- async function hasCommits(cwd) {
62
+ const errorCode = (error) => error?.data?.code;
63
+ /** Whether `cwd` is in a repository, and whether that repository has commits. Opening is lazy, so ask for HEAD. */
64
+ async function headState(repo) {
24
65
  try {
25
- await git(cwd, ['rev-parse', '--verify', '--quiet', 'HEAD']);
26
- return true;
66
+ await resolve(repo, 'HEAD');
67
+ return 'born';
27
68
  }
28
- catch {
29
- return false;
69
+ catch (error) {
70
+ return errorCode(error) === 'NOT_A_REPOSITORY' ? 'none' : 'unborn';
30
71
  }
31
72
  }
73
+ export async function isGitRepo(cwd) {
74
+ return withRepo(cwd, async (repo) => (await headState(repo)) !== 'none');
75
+ }
32
76
  /**
33
- * Counts commits that touched each Flow file, keyed by Flow API name.
34
- * Returns undefined when `cwd` is not inside a git repository.
77
+ * Counts commits that touched each Flow file, keyed by Flow API name. Merge commits are not
78
+ * counted, as with `git log --name-only`. Returns undefined when `cwd` is not inside a git repository.
35
79
  */
36
80
  export async function getFlowChurn(cwd, since) {
37
- if (!(await isGitRepo(cwd)))
38
- return undefined;
39
- // A repository with no commits yet has no history to count (and `git log` would fail).
40
- if (!(await hasCommits(cwd)))
41
- return new Map();
42
- const args = ['log', '--format=', '--name-only'];
43
- if (since)
44
- args.push(`--since=${since}`);
45
- const output = await git(cwd, [...args, '--', ...FLOW_PATHSPECS]);
46
- const churn = new Map();
47
- for (const line of output.split('\n')) {
48
- const name = flowNameFromPath(line.trim());
49
- if (name)
50
- churn.set(name, (churn.get(name) ?? 0) + 1);
51
- }
52
- return churn;
81
+ const sinceSeconds = since === undefined ? undefined : parseSince(since).getTime() / 1000;
82
+ return withRepo(cwd, async (repo) => {
83
+ const state = await headState(repo);
84
+ if (state === 'none')
85
+ return undefined;
86
+ const churn = new Map();
87
+ // A repository with no commits yet has no history to count.
88
+ if (state === 'unborn')
89
+ return churn;
90
+ for (const entry of await repo.whatchanged()) {
91
+ if (sinceSeconds !== undefined && entry.committer.timestamp < sinceSeconds)
92
+ continue;
93
+ for (const change of entry.changes.changes) {
94
+ const name = flowNameFromPath(changedPath(change));
95
+ if (name)
96
+ churn.set(name, (churn.get(name) ?? 0) + 1);
97
+ }
98
+ }
99
+ return churn;
100
+ });
53
101
  }
54
102
  /**
55
103
  * Flow files added, modified, or renamed between the merge base of `from` and `to`
56
104
  * (the same range a pull request shows). Paths are relative to the repository root.
57
105
  */
58
106
  export async function getChangedFlowFiles(cwd, from, to) {
59
- const output = await git(cwd, [
60
- 'diff',
61
- '--name-status',
62
- '--diff-filter=AMR',
63
- `${from}...${to}`,
64
- '--',
65
- ...FLOW_PATHSPECS,
66
- ]);
67
- const paths = [];
68
- for (const line of output.split('\n')) {
69
- const parts = line.split('\t');
70
- // Renames are "R100<TAB>old<TAB>new"; everything else is "M<TAB>path".
71
- const filePath = parts.at(-1)?.trim();
72
- if (parts.length >= 2 && filePath && flowNameFromPath(filePath))
73
- paths.push(filePath);
74
- }
75
- return paths;
107
+ return withRepo(cwd, async (repo) => {
108
+ const fromId = await resolve(repo, from);
109
+ const toId = await resolve(repo, to);
110
+ const [base] = await repo.primitives.mergeBase([fromId, toId]);
111
+ if (!base)
112
+ throw new Error(`Git revisions "${from}" and "${to}" have no common history.`);
113
+ const diff = await repo.diff({ from: String(base), to: String(toId), recursive: true, detectRenames: true });
114
+ return diff.changes
115
+ .filter((change) => change.type === 'add' || change.type === 'modify' || change.type === 'rename')
116
+ .map(changedPath)
117
+ .filter((path) => flowNameFromPath(path) !== undefined);
118
+ });
76
119
  }
77
120
  /** Reads a file's content at a git revision. `filePath` is relative to the repository root. */
78
121
  export async function showFileAtRevision(cwd, revision, filePath) {
79
- return git(cwd, ['show', `${revision}:${filePath.replace(/\\/g, '/')}`]);
122
+ return withRepo(cwd, async (repo) => {
123
+ const file = await repo.readFileAt(revision, filePath.replace(/\\/g, '/'));
124
+ return new TextDecoder().decode(file.content);
125
+ });
80
126
  }
81
127
  //# sourceMappingURL=git.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/core/git.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/core/git.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,4 @@
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 {
@@ -5,6 +6,11 @@ export declare class OrgCoverageSource implements CoverageSource {
5
6
  constructor(query: ToolingQuery);
6
7
  listActiveCountedFlows(): Promise<FlowCoverage[]>;
7
8
  getFlowCoverage(flowNames: string[]): Promise<FlowCoverage[]>;
9
+ /**
10
+ * The Tooling API returns `Flow.Metadata` only when a query returns one row, so this reads one
11
+ * version per query. Returns undefined when the query fails or returns no content.
12
+ */
13
+ getFlowFingerprint(flowVersionId: string): Promise<FlowFingerprint | undefined>;
8
14
  private queryInChunks;
9
15
  private buildCoverage;
10
16
  /**
@@ -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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"}
@@ -23,5 +23,42 @@ export type RequiredFieldMap = Record<string, Record<string, string>>;
23
23
  export declare function apexValueForField(field: DescribeField): string | undefined;
24
24
  /** Fields a test must set to insert a record: createable, not nillable, and not defaulted by the platform. */
25
25
  export declare function requiredFieldValues(fields: DescribeField[]): Record<string, string>;
26
- /** Describes each object once and returns its required fields. Objects that can't be described are left out. */
27
- export declare function loadRequiredFields(objects: string[], describe: DescribeObject): Promise<RequiredFieldMap>;
26
+ /**
27
+ * A value for every field a test could set, used to meet `IsNull false` entry criteria.
28
+ * Lookups are left out: a made-up null Id can't satisfy "is not null".
29
+ */
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>;
39
+ export type ObjectFields = {
40
+ requiredFields: RequiredFieldMap;
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[]>;
47
+ };
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>;
@@ -56,10 +56,130 @@ export function requiredFieldValues(fields) {
56
56
  }
57
57
  return values;
58
58
  }
59
- /** Describes each object once and returns its required fields. Objects that can't be described are left out. */
60
- export async function loadRequiredFields(objects, describe) {
61
- const map = {};
59
+ /**
60
+ * A value for every field a test could set, used to meet `IsNull false` entry criteria.
61
+ * Lookups are left out: a made-up null Id can't satisfy "is not null".
62
+ */
63
+ export function settableFieldValues(fields) {
64
+ const values = {};
65
+ for (const field of fields) {
66
+ if (!field.createable || field.calculated || field.autoNumber || field.type === 'reference')
67
+ continue;
68
+ const value = apexValueForField(field);
69
+ if (value !== undefined)
70
+ values[field.name] = value;
71
+ }
72
+ return values;
73
+ }
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()) {
62
180
  for (const object of [...new Set(objects)]) {
181
+ if (object in into.requiredFields)
182
+ continue;
63
183
  let fields;
64
184
  try {
65
185
  fields = await describe(object);
@@ -67,9 +187,14 @@ export async function loadRequiredFields(objects, describe) {
67
187
  catch {
68
188
  fields = undefined;
69
189
  }
70
- if (fields)
71
- map[object] = requiredFieldValues(fields);
190
+ if (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);
196
+ }
72
197
  }
73
- return map;
198
+ return into;
74
199
  }
75
200
  //# sourceMappingURL=requiredFields.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"requiredFields.js","sourceRoot":"","sources":["../../src/core/requiredFields.ts"],"names":[],"mappings":"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"}
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 { loadRequiredFields } 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,11 +82,13 @@ export async function scaffoldTests(options) {
57
82
  }
58
83
  flows.push({ flowName, flow });
59
84
  }
60
- const requiredFields = options.describe
61
- ? await loadRequiredFields(flows.flatMap((f) => objectsToCreate(f.flow)), options.describe)
62
- : {};
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
- const test = generateApexTest(flow, { requiredFields });
91
+ const test = generateApexTest(flow, objectFields);
65
92
  const classPath = join(outputDir, `${test.className}.cls`);
66
93
  if (!options.force && (await exists(classPath))) {
67
94
  result.skipped.push({ flowName, reason: `${classPath} already exists. Use --force to overwrite.` });