@salesforce/core 3.7.4 → 4.0.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 (46) hide show
  1. package/CHANGELOG.md +215 -0
  2. package/lib/config/configStore.js +2 -1
  3. package/lib/config/envVars.d.ts +20 -5
  4. package/lib/config/envVars.js +70 -5
  5. package/lib/crypto/keyChainImpl.js +0 -1
  6. package/lib/exported.d.ts +4 -2
  7. package/lib/exported.js +5 -1
  8. package/lib/lifecycleEvents.js +1 -1
  9. package/lib/logger.js +0 -1
  10. package/lib/org/authInfo.js +2 -3
  11. package/lib/org/connection.d.ts +6 -1
  12. package/lib/org/connection.js +13 -0
  13. package/lib/org/org.d.ts +12 -2
  14. package/lib/org/org.js +39 -36
  15. package/lib/org/scratchOrgCreate.d.ts +43 -0
  16. package/lib/org/scratchOrgCreate.js +142 -0
  17. package/lib/org/scratchOrgErrorCodes.d.ts +4 -0
  18. package/lib/org/scratchOrgErrorCodes.js +62 -0
  19. package/lib/org/scratchOrgFeatureDeprecation.d.ts +26 -0
  20. package/lib/org/scratchOrgFeatureDeprecation.js +110 -0
  21. package/lib/org/scratchOrgInfoApi.d.ts +94 -0
  22. package/lib/org/scratchOrgInfoApi.js +350 -0
  23. package/lib/org/scratchOrgInfoGenerator.d.ts +63 -0
  24. package/lib/org/scratchOrgInfoGenerator.js +223 -0
  25. package/lib/org/scratchOrgSettingsGenerator.d.ts +56 -0
  26. package/lib/org/scratchOrgSettingsGenerator.js +210 -0
  27. package/lib/org/user.js +4 -3
  28. package/lib/status/pollingClient.d.ts +2 -2
  29. package/lib/status/pollingClient.js +8 -2
  30. package/lib/status/streamingClient.d.ts +1 -1
  31. package/lib/util/jsonXmlTools.d.ts +14 -0
  32. package/lib/util/jsonXmlTools.js +41 -0
  33. package/lib/util/mapKeys.d.ts +14 -0
  34. package/lib/util/mapKeys.js +48 -0
  35. package/lib/util/zipWriter.d.ts +14 -0
  36. package/lib/util/zipWriter.js +68 -0
  37. package/lib/webOAuthServer.js +1 -1
  38. package/messages/envVars.md +53 -13
  39. package/messages/org.md +4 -0
  40. package/messages/scratchOrgCreate.md +27 -0
  41. package/messages/scratchOrgErrorCodes.md +99 -0
  42. package/messages/scratchOrgFeatureDeprecation.md +11 -0
  43. package/messages/scratchOrgInfoApi.md +11 -0
  44. package/messages/scratchOrgInfoGenerator.md +19 -0
  45. package/messages/user.md +4 -0
  46. package/package.json +5 -1
@@ -12,15 +12,15 @@ Speed of the spinner in milliseconds. Default is 60.
12
12
 
13
13
  # httpProxy
14
14
 
15
- HTTP URL and port of the proxy server when using Salesforce CLI behind a corporate firewall or web proxy.
15
+ HTTP URL and port of the proxy server when using Salesforce CLI behind a corporate firewall or web proxy.
16
16
 
17
17
  # httpsProxy
18
18
 
19
- HTTPS URL and port of the proxy server when using Salesforce CLI behind a corporate firewall or web proxy.
19
+ HTTPS URL and port of the proxy server when using Salesforce CLI behind a corporate firewall or web proxy.
20
20
 
21
21
  # nodeExtraCaCerts
22
22
 
23
- Fully qualified path to your self-signed certificate. Will be installed after you run "sfdx update".
23
+ Fully qualified path to your self-signed certificate. Will be installed after you run "sfdx update".
24
24
 
25
25
  # nodeTlsRejectUnauthorized
26
26
 
@@ -36,7 +36,7 @@ The API version for a specific project or all projects. Default value is the API
36
36
 
37
37
  # sfdxAudienceUrl
38
38
 
39
- URL that overrides the aud (audience) field used for JWT authentication so that it matches the expected value of the authorization server URL for the org you’re logging into.
39
+ URL that overrides the aud (audience) field used for JWT authentication so that it matches the expected value of the authorization server URL for the org you’re logging into.
40
40
 
41
41
  # sfdxCodeCoverageRequirement
42
42
 
@@ -44,7 +44,7 @@ Code coverage percentages that are displayed in green when you run force:apex:te
44
44
 
45
45
  # sfdxContentType
46
46
 
47
- Set to JSON so that all CLI commands output results in JSON format.
47
+ Set to JSON so that all CLI commands output results in JSON format.
48
48
 
49
49
  # sfdxDefaultdevhubusername
50
50
 
@@ -56,11 +56,11 @@ Username or alias of your default org. Overrides the defaultusername configurati
56
56
 
57
57
  # sfdxDisableAutoupdate
58
58
 
59
- Set to true to disable the auto-update feature of Salesforce CLI. Default value is false.
59
+ Set to true to disable the auto-update feature of Salesforce CLI. Default value is false.
60
60
 
61
61
  # sfdxAutoupdateDisable
62
62
 
63
- Set to true to disable the auto-update feature of Salesforce CLI. Default value is false.
63
+ Set to true to disable the auto-update feature of Salesforce CLI. Default value is false.
64
64
 
65
65
  # sfdxDisableSourceMemberPolling
66
66
 
@@ -80,7 +80,7 @@ Time, in seconds, that Salesforce CLI waits for the Lightning Experience custom
80
80
 
81
81
  # sfdxImprovedCodeCoverage
82
82
 
83
- Set to true to scope Apex test results to the classes entered during a test run when running force:apex:test:\*.
83
+ Set to true to scope Apex test results to the classes entered during a test run when running force:apex:test:\*.
84
84
 
85
85
  # sfdxInstanceUrl
86
86
 
@@ -134,6 +134,26 @@ Number of seconds you want the force:source:push command to keep polling the Sou
134
134
 
135
135
  Set to false to disable the progress bar when running force:mdapi:deploy, force:source:deploy, or force:source:push.
136
136
 
137
+ # sfdxLazyLoadModules
138
+
139
+ Set to true to enable lazy loading of sfdx modules
140
+
141
+ # sfdxS3Host
142
+
143
+ URL to S3 host
144
+
145
+ # sfdxUpdateInstructions
146
+
147
+ Text that describes how to update sfdx
148
+
149
+ # sfdxInstaller
150
+
151
+ Boolean indicating that the installer is running
152
+
153
+ # sfdxEnv
154
+
155
+ Describes if sfdx is in "demo" mode
156
+
137
157
  # sfTargetOrg
138
158
 
139
159
  Username or alias of your default org. Overrides the target-org configuration variable.
@@ -152,7 +172,7 @@ API version for a specific project or all projects. Default value is the API ver
152
172
 
153
173
  # sfAudienceUrl
154
174
 
155
- URL that overrides the aud (audience) field used for JWT authentication so that it matches the expected value of the authorization server URL for the org you’re logging into.
175
+ URL that overrides the aud (audience) field used for JWT authentication so that it matches the expected value of the authorization server URL for the org you’re logging into.
156
176
 
157
177
  # sfCodeCoverageRequirement
158
178
 
@@ -160,15 +180,15 @@ Code coverage percentages that are displayed in green when you run the Apex test
160
180
 
161
181
  # sfContentType
162
182
 
163
- Set to JSON so that all CLI commands output results in JSON format.
183
+ Set to JSON so that all CLI commands output results in JSON format.
164
184
 
165
185
  # sfDisableAutoupdate
166
186
 
167
- Set to true to disable the auto-update feature of Salesforce CLI. Default value is false.
187
+ Set to true to disable the auto-update feature of Salesforce CLI. Default value is false.
168
188
 
169
189
  # sfAutoupdateDisable
170
190
 
171
- Set to true to disable the auto-update feature of Salesforce CLI. Default value is false.
191
+ Set to true to disable the auto-update feature of Salesforce CLI. Default value is false.
172
192
 
173
193
  # sfDisableSourceMemberPolling
174
194
 
@@ -188,7 +208,7 @@ Time, in seconds, that Salesforce CLI waits for the Lightning Experience custom
188
208
 
189
209
  # sfImprovedCodeCoverage
190
210
 
191
- Set to true to scope Apex test results to the classes entered during a test run when running the Apex test commands.
211
+ Set to true to scope Apex test results to the classes entered during a test run when running the Apex test commands.
192
212
 
193
213
  # sfInstanceUrl
194
214
 
@@ -237,3 +257,23 @@ Number of seconds you want the source push command to keep polling the SourceMem
237
257
  # sfUseProgressBar
238
258
 
239
259
  Set to false to disable the progress bar when running the metadata deploy command.
260
+
261
+ # sfLazyLoadModules
262
+
263
+ Set to true to enable lazy loading of sf modules
264
+
265
+ # sfS3Host
266
+
267
+ URL to S3 host
268
+
269
+ # sfUpdateInstructions
270
+
271
+ Text that describes how to update sf
272
+
273
+ # sfInstaller
274
+
275
+ Boolean indicating that the installer is running
276
+
277
+ # sfEnv
278
+
279
+ Describes if sf is in "demo" mode
package/messages/org.md CHANGED
@@ -41,3 +41,7 @@ The sandbox %s does not have an authorized username.
41
41
  # orgPollingTimeout
42
42
 
43
43
  Sandbox status is %s; timed out waiting for completion.
44
+
45
+ # NotFoundOnDevHub
46
+
47
+ The scratch org does not belong to the dev hub username %s.
@@ -0,0 +1,27 @@
1
+ # UnsupportedSnapshotOrgCreateOptionsError
2
+
3
+ Org snapshots don’t support one or more options you specified: %s.
4
+
5
+ # SourceStatusResetFailureError
6
+
7
+ Successfully created org with ID: %s and name: %s. Unfortunately, source tracking isn’t working as expected. If you run force:source:status, the results may be incorrect. Try again by creating another scratch org.
8
+
9
+ # DurationDaysValidationMinError
10
+
11
+ Expected 'durationDays' greater than or equal to %s but received %s.
12
+
13
+ # DurationDaysValidationMaxError
14
+
15
+ Expected 'durationDays' less than or equal to %s but received %s.
16
+
17
+ # DurationDaysNotIntError
18
+
19
+ Expected 'durationDays' to be an integer number.
20
+
21
+ # RetryNotIntError
22
+
23
+ Expected 'retry' to be an integer number.
24
+
25
+ # WaitValidationMaxError
26
+
27
+ Expected 'wait' greater than or equal to %s but received %s.
@@ -0,0 +1,99 @@
1
+ # SignupFailedError
2
+
3
+ The request to create a scratch org failed with error code: %s.
4
+
5
+ # SignupFailedUnknownError
6
+
7
+ An unknown server error occurred. Please try again. If you still see this error, contact Salesforce support for assistance. Include the information from 'sfdx force:data:record:get -s ScratchOrgInfo -i %s -u %s'.
8
+
9
+ # SignupFailedActionError
10
+
11
+ See https://developer.salesforce.com/docs/atlas.en-us.api.meta/api/sforce_api_objects_signuprequest.htm for information on error code %s.
12
+
13
+ # SignupUnexpectedError
14
+
15
+ The request to create a scratch org returned an unexpected status
16
+
17
+ # INVALID_ID_FIELD
18
+
19
+ Provide a valid template ID, in the format 0TTxxxxxxxxxxxx.
20
+
21
+ # T-0002
22
+
23
+ We couldn’t find a template or snapshot with the ID or name specified in the scratch org definition. If you’re sure the ID is correct, contact Salesforce Support.
24
+
25
+ # T-0003
26
+
27
+ The template specified in the scratch org definition is unapproved. Contact Salesforce Support to request template approval.
28
+
29
+ # T-0004
30
+
31
+ The Trialforce Source Organization (TSO) for the template doesn’t exist or has expired.
32
+
33
+ # S-1006
34
+
35
+ Provide a valid email address in your scratch org definition or your %s file.
36
+
37
+ # S-2006
38
+
39
+ Provide a valid country code in your scratch org definition or your %s file.
40
+
41
+ # S-1017
42
+
43
+ Specify a namespace that’s used by a release org associated with your Dev Hub org.
44
+
45
+ # S-1018
46
+
47
+ Provide a valid My Domain value. This value can’t include double hyphens, end in a hyphen, include restricted words, or be more than 40 characters long.
48
+
49
+ # S-1019
50
+
51
+ The My Domain value you chose is already in use.
52
+
53
+ # S-1026
54
+
55
+ Provide a valid namespace value. This value must begin with a letter. It can’t include consecutive underscores, end in an underscore, be more than 15 characters long, or be a restricted or reserved namespace. Only alphanumeric characters and underscores are allowed.
56
+
57
+ # S-9999
58
+
59
+ A fatal signup error occurred. Please try again. If you still see this error, contact Salesforce Support for assistance.
60
+
61
+ # SH-0001
62
+
63
+ Can’t create scratch org. Contact the source org admin to add your Dev Hub org ID to Setup > Org Shape. Then try again.
64
+
65
+ # SH-0002
66
+
67
+ Can’t create scratch org. No org shape exists for the specified sourceOrg. Create an org shape and try again.
68
+
69
+ # SH-0003
70
+
71
+ Can’t create scratch org from org shape. The org shape version is outdated. Recreate the org shape and try again.
72
+
73
+ # C-1007
74
+
75
+ The username provided to the org:create command is already in use. Run 'force:org:list --clean' to remove stale org authentications or create the org with a different username.
76
+
77
+ # C-1015
78
+
79
+ We encountered a problem while registering your My Domain value with the DNS provider. Please try again.
80
+
81
+ # C-1016
82
+
83
+ We encountered a problem while attempting to configure and approve the Connected App for your org. Verify the Connected App configuration with your Salesforce admin.
84
+
85
+ # C-1017
86
+
87
+ Provide a valid namespace prefix. This value must begin with a letter. It can’t include consecutive underscores, end in an underscore, be more than 15 characters long, or be a restricted or reserved namespace. Only alphanumeric characters and underscores are allowed.
88
+
89
+ # C-1020
90
+
91
+ We couldn't find a template with the ID specified in the scratch org definition. If you’re sure the ID is correct, contact Salesforce Support.
92
+
93
+ # C-1027
94
+
95
+ The template specified in the Scratch Definition isn’t supported. Specify a generic edition (such as Developer or Enterprise), or specify a template ID.
96
+
97
+ # C-9999
98
+
99
+ A fatal signup error occurred. Please try again. If you still see this error, contact Salesforce Support for assistance
@@ -0,0 +1,11 @@
1
+ # quantifiedFeatureWithoutQuantityWarning
2
+
3
+ The feature %s will be deprecated in a future release. It's been replaced by %s:<value>, which requires you to specify a quantity.
4
+
5
+ # mappedFeatureWarning
6
+
7
+ The feature %s has been deprecated. It has been replaced with %s in this scratch org create request.
8
+
9
+ # deprecatedFeatureWarning
10
+
11
+ The feature %s has been deprecated. It has been removed from the list of requested features.
@@ -0,0 +1,11 @@
1
+ # SignupFieldsMissingError
2
+
3
+ Required fields are missing for org creation: [%s]
4
+
5
+ # SignupDuplicateSettingsSpecifiedError
6
+
7
+ You cannot use 'settings' and `'orgPreferences' in your scratch definition file, please specify one or the other.
8
+
9
+ # DeprecatedPrefFormat
10
+
11
+ We've deprecated OrgPreferences. Update the scratch org definition file to replace OrgPreferences with their corresponding settings.
@@ -0,0 +1,19 @@
1
+ # Package2AncestorsIdsKeyNotSupportedError
2
+
3
+ The package2AncestorIds key is no longer supported in a scratch org definition. Ancestors defined in sfdx-project.json will be included in the scratch org.",
4
+
5
+ # InvalidAncestorVersionFormatError
6
+
7
+ The ancestor versionNumber must be in the format major.minor.patch but the value found is %s",
8
+
9
+ # NoMatchingAncestorError
10
+
11
+ The ancestorId for ancestorVersion %s can't be found. Package ID %s.",
12
+
13
+ # AncestorNotReleasedError
14
+
15
+ The ancestor package version [%s] specified in the sfdx-project.json file may exist hasn’t been promoted and released. Release the ancestor package version before specifying it as the ancestor in a new package or patch version.",
16
+
17
+ # AncestorIdVersionMismatchError
18
+
19
+ The ancestorVersion in sfdx-project.json is not the version expected for the ancestorId you supplied. ancestorVersion %s. ancestorID %s."
package/messages/user.md CHANGED
@@ -29,3 +29,7 @@ Invalid complexity value. Specify a value between 0 and 5, inclusive.
29
29
  # lengthOutOfBound
30
30
 
31
31
  Invalid length value. Specify a value between 8 and 1000, inclusive.
32
+
33
+ # problemsDescribingTheUserObject
34
+
35
+ Problems occurred while attempting to describe the user object.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@salesforce/core",
3
- "version": "3.7.4",
3
+ "version": "4.0.0",
4
4
  "description": "Core libraries to interact with SFDX projects, orgs, and APIs.",
5
5
  "main": "lib/exported",
6
6
  "types": "lib/exported.d.ts",
@@ -34,6 +34,7 @@
34
34
  "!lib/**/*.map"
35
35
  ],
36
36
  "dependencies": {
37
+ "@oclif/core": "^1.3.1",
37
38
  "@salesforce/bunyan": "^2.0.0",
38
39
  "@salesforce/kit": "^1.5.28",
39
40
  "@salesforce/schemas": "^1.1.0",
@@ -41,6 +42,8 @@
41
42
  "@types/graceful-fs": "^4.1.5",
42
43
  "@types/mkdirp": "^1.0.2",
43
44
  "@types/semver": "^7.3.9",
45
+ "archiver": "^5.3.0",
46
+ "js2xmlparser": "^4.0.1",
44
47
  "change-case": "^4.1.2",
45
48
  "debug": "^3.2.7",
46
49
  "faye": "^1.4.0",
@@ -57,6 +60,7 @@
57
60
  "@salesforce/dev-scripts": "^2.0.0",
58
61
  "@salesforce/prettier-config": "^0.0.2",
59
62
  "@salesforce/ts-sinon": "^1.3.21",
63
+ "@types/archiver": "^5.3.1",
60
64
  "@types/debug": "0.0.31",
61
65
  "@types/jsen": "0.0.21",
62
66
  "@types/jsonwebtoken": "8.5.7",