@salesforce/core 3.30.14 → 3.31.7

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 (153) hide show
  1. package/LICENSE.txt +11 -11
  2. package/README.md +222 -227
  3. package/lib/config/aliasesConfig.d.ts +12 -12
  4. package/lib/config/aliasesConfig.js +27 -27
  5. package/lib/config/authInfoConfig.d.ts +19 -19
  6. package/lib/config/authInfoConfig.js +34 -34
  7. package/lib/config/config.d.ts +311 -311
  8. package/lib/config/config.js +574 -574
  9. package/lib/config/configAggregator.d.ts +232 -232
  10. package/lib/config/configAggregator.js +379 -379
  11. package/lib/config/configFile.d.ts +199 -199
  12. package/lib/config/configFile.js +340 -340
  13. package/lib/config/configGroup.d.ts +141 -141
  14. package/lib/config/configGroup.js +224 -224
  15. package/lib/config/configStore.d.ts +241 -241
  16. package/lib/config/configStore.js +352 -352
  17. package/lib/config/envVars.d.ts +101 -101
  18. package/lib/config/envVars.js +456 -456
  19. package/lib/config/orgUsersConfig.d.ts +31 -31
  20. package/lib/config/orgUsersConfig.js +41 -41
  21. package/lib/config/sandboxOrgConfig.d.ts +37 -37
  22. package/lib/config/sandboxOrgConfig.js +50 -50
  23. package/lib/config/sandboxProcessCache.d.ts +16 -16
  24. package/lib/config/sandboxProcessCache.js +37 -37
  25. package/lib/config/tokensConfig.d.ts +10 -10
  26. package/lib/config/tokensConfig.js +28 -28
  27. package/lib/config/ttlConfig.d.ts +34 -34
  28. package/lib/config/ttlConfig.js +54 -54
  29. package/lib/crypto/crypto.d.ts +54 -54
  30. package/lib/crypto/crypto.js +220 -220
  31. package/lib/crypto/keyChain.d.ts +8 -8
  32. package/lib/crypto/keyChain.js +61 -61
  33. package/lib/crypto/keyChainImpl.d.ts +116 -116
  34. package/lib/crypto/keyChainImpl.js +486 -486
  35. package/lib/crypto/secureBuffer.d.ts +46 -46
  36. package/lib/crypto/secureBuffer.js +82 -82
  37. package/lib/deviceOauthService.d.ts +71 -71
  38. package/lib/deviceOauthService.js +191 -191
  39. package/lib/exported.d.ts +38 -38
  40. package/lib/exported.js +118 -118
  41. package/lib/global.d.ts +70 -70
  42. package/lib/global.js +109 -109
  43. package/lib/lifecycleEvents.d.ts +93 -93
  44. package/lib/lifecycleEvents.js +188 -188
  45. package/lib/logger.d.ts +381 -381
  46. package/lib/logger.js +734 -734
  47. package/lib/messages.d.ts +291 -291
  48. package/lib/messages.js +543 -543
  49. package/lib/org/authInfo.d.ts +344 -344
  50. package/lib/org/authInfo.js +892 -892
  51. package/lib/org/authRemover.d.ts +88 -88
  52. package/lib/org/authRemover.js +182 -182
  53. package/lib/org/connection.d.ts +197 -197
  54. package/lib/org/connection.js +395 -395
  55. package/lib/org/index.d.ts +6 -6
  56. package/lib/org/index.js +28 -28
  57. package/lib/org/org.d.ts +558 -558
  58. package/lib/org/org.js +1267 -1267
  59. package/lib/org/orgConfigProperties.d.ts +69 -69
  60. package/lib/org/orgConfigProperties.js +136 -136
  61. package/lib/org/permissionSetAssignment.d.ts +35 -35
  62. package/lib/org/permissionSetAssignment.js +125 -125
  63. package/lib/org/scratchOrgCache.d.ts +20 -20
  64. package/lib/org/scratchOrgCache.js +32 -32
  65. package/lib/org/scratchOrgCreate.d.ts +54 -54
  66. package/lib/org/scratchOrgCreate.js +216 -216
  67. package/lib/org/scratchOrgErrorCodes.d.ts +10 -10
  68. package/lib/org/scratchOrgErrorCodes.js +88 -88
  69. package/lib/org/scratchOrgFeatureDeprecation.d.ts +26 -26
  70. package/lib/org/scratchOrgFeatureDeprecation.js +109 -109
  71. package/lib/org/scratchOrgInfoApi.d.ts +68 -68
  72. package/lib/org/scratchOrgInfoApi.js +413 -413
  73. package/lib/org/scratchOrgInfoGenerator.d.ts +64 -64
  74. package/lib/org/scratchOrgInfoGenerator.js +241 -241
  75. package/lib/org/scratchOrgLifecycleEvents.d.ts +10 -10
  76. package/lib/org/scratchOrgLifecycleEvents.js +40 -40
  77. package/lib/org/scratchOrgSettingsGenerator.d.ts +78 -78
  78. package/lib/org/scratchOrgSettingsGenerator.js +276 -276
  79. package/lib/org/scratchOrgTypes.d.ts +43 -43
  80. package/lib/org/scratchOrgTypes.js +8 -8
  81. package/lib/org/user.d.ts +187 -187
  82. package/lib/org/user.js +448 -448
  83. package/lib/schema/printer.d.ts +79 -79
  84. package/lib/schema/printer.js +260 -260
  85. package/lib/schema/validator.d.ts +70 -70
  86. package/lib/schema/validator.js +169 -169
  87. package/lib/sfError.d.ts +73 -73
  88. package/lib/sfError.js +136 -136
  89. package/lib/sfProject.d.ts +357 -357
  90. package/lib/sfProject.js +671 -671
  91. package/lib/stateAggregator/accessors/aliasAccessor.d.ts +98 -98
  92. package/lib/stateAggregator/accessors/aliasAccessor.js +145 -145
  93. package/lib/stateAggregator/accessors/orgAccessor.d.ts +101 -101
  94. package/lib/stateAggregator/accessors/orgAccessor.js +240 -240
  95. package/lib/stateAggregator/accessors/sandboxAccessor.d.ts +8 -8
  96. package/lib/stateAggregator/accessors/sandboxAccessor.js +27 -27
  97. package/lib/stateAggregator/accessors/tokenAccessor.d.ts +63 -63
  98. package/lib/stateAggregator/accessors/tokenAccessor.js +79 -79
  99. package/lib/stateAggregator/index.d.ts +4 -4
  100. package/lib/stateAggregator/index.js +26 -26
  101. package/lib/stateAggregator/stateAggregator.d.ts +25 -25
  102. package/lib/stateAggregator/stateAggregator.js +45 -45
  103. package/lib/status/myDomainResolver.d.ts +66 -66
  104. package/lib/status/myDomainResolver.js +124 -124
  105. package/lib/status/pollingClient.d.ts +85 -85
  106. package/lib/status/pollingClient.js +115 -115
  107. package/lib/status/streamingClient.d.ts +244 -244
  108. package/lib/status/streamingClient.js +436 -436
  109. package/lib/status/types.d.ts +89 -89
  110. package/lib/status/types.js +17 -17
  111. package/lib/testSetup.d.ts +553 -530
  112. package/lib/testSetup.js +871 -727
  113. package/lib/util/cache.d.ts +11 -11
  114. package/lib/util/cache.js +69 -69
  115. package/lib/util/checkLightningDomain.d.ts +1 -1
  116. package/lib/util/checkLightningDomain.js +28 -28
  117. package/lib/util/directoryWriter.d.ts +12 -12
  118. package/lib/util/directoryWriter.js +53 -53
  119. package/lib/util/getJwtAudienceUrl.d.ts +4 -4
  120. package/lib/util/getJwtAudienceUrl.js +18 -18
  121. package/lib/util/internal.d.ts +58 -58
  122. package/lib/util/internal.js +118 -118
  123. package/lib/util/jsonXmlTools.d.ts +14 -14
  124. package/lib/util/jsonXmlTools.js +38 -38
  125. package/lib/util/mapKeys.d.ts +14 -14
  126. package/lib/util/mapKeys.js +51 -51
  127. package/lib/util/sfdc.d.ts +52 -52
  128. package/lib/util/sfdc.js +85 -85
  129. package/lib/util/sfdcUrl.d.ts +72 -72
  130. package/lib/util/sfdcUrl.js +215 -215
  131. package/lib/util/structuredWriter.d.ts +9 -9
  132. package/lib/util/structuredWriter.js +2 -2
  133. package/lib/util/zipWriter.d.ts +16 -16
  134. package/lib/util/zipWriter.js +67 -67
  135. package/lib/webOAuthServer.d.ts +156 -156
  136. package/lib/webOAuthServer.js +388 -388
  137. package/messages/auth.md +37 -37
  138. package/messages/config.md +156 -156
  139. package/messages/connection.md +30 -30
  140. package/messages/core.json +20 -20
  141. package/messages/core.md +67 -67
  142. package/messages/encryption.md +85 -85
  143. package/messages/envVars.md +303 -303
  144. package/messages/org.md +63 -63
  145. package/messages/permissionSetAssignment.md +31 -31
  146. package/messages/scratchOrgCreate.md +23 -23
  147. package/messages/scratchOrgErrorCodes.md +115 -115
  148. package/messages/scratchOrgFeatureDeprecation.md +11 -11
  149. package/messages/scratchOrgInfoApi.md +15 -15
  150. package/messages/scratchOrgInfoGenerator.md +23 -23
  151. package/messages/streaming.md +23 -23
  152. package/messages/user.md +35 -35
  153. package/package.json +97 -97
package/lib/sfError.js CHANGED
@@ -1,137 +1,137 @@
1
- "use strict";
2
- /*
3
- * Copyright (c) 2020, salesforce.com, inc.
4
- * All rights reserved.
5
- * Licensed under the BSD 3-Clause license.
6
- * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
7
- */
8
- var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
9
- if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
10
- if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
11
- return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
12
- };
13
- var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
14
- if (kind === "m") throw new TypeError("Private method is not writable");
15
- if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
16
- if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
17
- return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
18
- };
19
- var _SfError_code;
20
- Object.defineProperty(exports, "__esModule", { value: true });
21
- exports.SfdxError = exports.SfError = void 0;
22
- const kit_1 = require("@salesforce/kit");
23
- const ts_types_1 = require("@salesforce/ts-types");
24
- /**
25
- * A generalized sfdx error which also contains an action. The action is used in the
26
- * CLI to help guide users past the error.
27
- *
28
- * To throw an error in a synchronous function you must either pass the error message and actions
29
- * directly to the constructor, e.g.
30
- *
31
- * ```
32
- * // To load a message bundle (Note that __dirname should contain a messages folder)
33
- * Messages.importMessagesDirectory(__dirname);
34
- * const messages = Messages.load('myPackageName', 'myBundleName');
35
- *
36
- * // To throw a non-bundle based error:
37
- * throw new SfError(message.getMessage('myError'), 'MyErrorName');
38
- * ```
39
- */
40
- class SfError extends kit_1.NamedError {
41
- /**
42
- * Create an SfError.
43
- *
44
- * @param message The error message.
45
- * @param name The error name. Defaults to 'SfError'.
46
- * @param actions The action message(s).
47
- * @param exitCodeOrCause The exit code which will be used by SfdxCommand or he underlying error that caused this error to be raised.
48
- * @param cause The underlying error that caused this error to be raised.
49
- */
50
- constructor(message, name, actions, exitCodeOrCause, cause) {
51
- cause = exitCodeOrCause instanceof Error ? exitCodeOrCause : cause;
52
- super(name ?? 'SfError', message || name, cause);
53
- /**
54
- * Some errors support `error.code` instead of `error.name`. This keeps backwards compatability.
55
- */
56
- _SfError_code.set(this, void 0);
57
- this.actions = actions;
58
- if (typeof exitCodeOrCause === 'number') {
59
- this.exitCode = exitCodeOrCause;
60
- }
61
- else {
62
- this.exitCode = 1;
63
- }
64
- }
65
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
66
- get code() {
67
- return __classPrivateFieldGet(this, _SfError_code, "f") ?? this.name;
68
- }
69
- set code(code) {
70
- __classPrivateFieldSet(this, _SfError_code, code, "f");
71
- }
72
- /**
73
- * Convert an Error to an SfError.
74
- *
75
- * @param err The error to convert.
76
- */
77
- static wrap(err) {
78
- if ((0, ts_types_1.isString)(err)) {
79
- return new SfError(err);
80
- }
81
- if (err instanceof SfError) {
82
- return err;
83
- }
84
- const sfError = new SfError(err.message, err.name, undefined, err);
85
- // If the original error has a code, use that instead of name.
86
- if ((0, ts_types_1.hasString)(err, 'code')) {
87
- sfError.code = err.code;
88
- }
89
- return sfError;
90
- }
91
- /**
92
- * Sets the context of the error. For convenience `this` object is returned.
93
- *
94
- * @param context The command name.
95
- */
96
- setContext(context) {
97
- this.context = context;
98
- return this;
99
- }
100
- /**
101
- * An additional payload for the error. For convenience `this` object is returned.
102
- *
103
- * @param data The payload data.
104
- */
105
- setData(data) {
106
- this.data = data;
107
- return this;
108
- }
109
- /**
110
- * Convert an {@link SfError} state to an object. Returns a plain object representing the state of this error.
111
- */
112
- toObject() {
113
- const obj = {
114
- name: this.name,
115
- message: this.message || this.name,
116
- exitCode: this.exitCode,
117
- actions: this.actions,
118
- };
119
- if (this.context) {
120
- obj.context = this.context;
121
- }
122
- if (this.data) {
123
- // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment
124
- obj.data = this.data;
125
- }
126
- return obj;
127
- }
128
- }
129
- exports.SfError = SfError;
130
- _SfError_code = new WeakMap();
131
- /**
132
- * @deprecated use SfError instead
133
- */
134
- class SfdxError extends SfError {
135
- }
136
- exports.SfdxError = SfdxError;
1
+ "use strict";
2
+ /*
3
+ * Copyright (c) 2020, salesforce.com, inc.
4
+ * All rights reserved.
5
+ * Licensed under the BSD 3-Clause license.
6
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
7
+ */
8
+ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
9
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
10
+ if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
11
+ return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
12
+ };
13
+ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
14
+ if (kind === "m") throw new TypeError("Private method is not writable");
15
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
16
+ if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
17
+ return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
18
+ };
19
+ var _SfError_code;
20
+ Object.defineProperty(exports, "__esModule", { value: true });
21
+ exports.SfdxError = exports.SfError = void 0;
22
+ const kit_1 = require("@salesforce/kit");
23
+ const ts_types_1 = require("@salesforce/ts-types");
24
+ /**
25
+ * A generalized sfdx error which also contains an action. The action is used in the
26
+ * CLI to help guide users past the error.
27
+ *
28
+ * To throw an error in a synchronous function you must either pass the error message and actions
29
+ * directly to the constructor, e.g.
30
+ *
31
+ * ```
32
+ * // To load a message bundle (Note that __dirname should contain a messages folder)
33
+ * Messages.importMessagesDirectory(__dirname);
34
+ * const messages = Messages.load('myPackageName', 'myBundleName');
35
+ *
36
+ * // To throw a non-bundle based error:
37
+ * throw new SfError(message.getMessage('myError'), 'MyErrorName');
38
+ * ```
39
+ */
40
+ class SfError extends kit_1.NamedError {
41
+ /**
42
+ * Create an SfError.
43
+ *
44
+ * @param message The error message.
45
+ * @param name The error name. Defaults to 'SfError'.
46
+ * @param actions The action message(s).
47
+ * @param exitCodeOrCause The exit code which will be used by SfdxCommand or he underlying error that caused this error to be raised.
48
+ * @param cause The underlying error that caused this error to be raised.
49
+ */
50
+ constructor(message, name, actions, exitCodeOrCause, cause) {
51
+ cause = exitCodeOrCause instanceof Error ? exitCodeOrCause : cause;
52
+ super(name ?? 'SfError', message || name, cause);
53
+ /**
54
+ * Some errors support `error.code` instead of `error.name`. This keeps backwards compatability.
55
+ */
56
+ _SfError_code.set(this, void 0);
57
+ this.actions = actions;
58
+ if (typeof exitCodeOrCause === 'number') {
59
+ this.exitCode = exitCodeOrCause;
60
+ }
61
+ else {
62
+ this.exitCode = 1;
63
+ }
64
+ }
65
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
66
+ get code() {
67
+ return __classPrivateFieldGet(this, _SfError_code, "f") ?? this.name;
68
+ }
69
+ set code(code) {
70
+ __classPrivateFieldSet(this, _SfError_code, code, "f");
71
+ }
72
+ /**
73
+ * Convert an Error to an SfError.
74
+ *
75
+ * @param err The error to convert.
76
+ */
77
+ static wrap(err) {
78
+ if ((0, ts_types_1.isString)(err)) {
79
+ return new SfError(err);
80
+ }
81
+ if (err instanceof SfError) {
82
+ return err;
83
+ }
84
+ const sfError = new SfError(err.message, err.name, undefined, err);
85
+ // If the original error has a code, use that instead of name.
86
+ if ((0, ts_types_1.hasString)(err, 'code')) {
87
+ sfError.code = err.code;
88
+ }
89
+ return sfError;
90
+ }
91
+ /**
92
+ * Sets the context of the error. For convenience `this` object is returned.
93
+ *
94
+ * @param context The command name.
95
+ */
96
+ setContext(context) {
97
+ this.context = context;
98
+ return this;
99
+ }
100
+ /**
101
+ * An additional payload for the error. For convenience `this` object is returned.
102
+ *
103
+ * @param data The payload data.
104
+ */
105
+ setData(data) {
106
+ this.data = data;
107
+ return this;
108
+ }
109
+ /**
110
+ * Convert an {@link SfError} state to an object. Returns a plain object representing the state of this error.
111
+ */
112
+ toObject() {
113
+ const obj = {
114
+ name: this.name,
115
+ message: this.message || this.name,
116
+ exitCode: this.exitCode,
117
+ actions: this.actions,
118
+ };
119
+ if (this.context) {
120
+ obj.context = this.context;
121
+ }
122
+ if (this.data) {
123
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-assignment
124
+ obj.data = this.data;
125
+ }
126
+ return obj;
127
+ }
128
+ }
129
+ exports.SfError = SfError;
130
+ _SfError_code = new WeakMap();
131
+ /**
132
+ * @deprecated use SfError instead
133
+ */
134
+ class SfdxError extends SfError {
135
+ }
136
+ exports.SfdxError = SfdxError;
137
137
  //# sourceMappingURL=sfError.js.map