@salesforce/core 3.31.7 → 3.31.8

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 -222
  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 -553
  112. package/lib/testSetup.js +871 -871
  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
@@ -1,63 +1,63 @@
1
- import { AsyncOptionalCreatable } from '@salesforce/kit';
2
- import { JsonMap, Optional } from '@salesforce/ts-types';
3
- export declare type SfToken = {
4
- token: string;
5
- url: string;
6
- user?: string;
7
- timestamp: string;
8
- } & JsonMap;
9
- export declare type SfTokens = {
10
- [key: string]: SfToken;
11
- };
12
- export declare class TokenAccessor extends AsyncOptionalCreatable {
13
- private config;
14
- /**
15
- * Return all tokens.
16
- *
17
- * @param decrypt
18
- * @returns {SfTokens}
19
- */
20
- getAll(decrypt?: boolean): SfTokens;
21
- /**
22
- * Return a token for the provided name.
23
- *
24
- * @param name
25
- * @param decrypt
26
- * @returns {Optional<SfToken>}
27
- */
28
- get(name: string, decrypt?: boolean): Optional<SfToken>;
29
- /**
30
- * Return true if a given name has a token associated with it.
31
- *
32
- * @param name
33
- * @returns {boolean}
34
- */
35
- has(name: string): boolean;
36
- /**
37
- * Set the token for the provided name.
38
- *
39
- * @param name
40
- * @param token
41
- */
42
- set(name: string, token: Partial<SfToken>): void;
43
- /**
44
- * Update the token for the provided name.
45
- *
46
- * @param name
47
- * @param token
48
- */
49
- update(name: string, token: Partial<SfToken>): void;
50
- /**
51
- * Unet the token for the provided name.
52
- *
53
- * @param name
54
- */
55
- unset(name: string): void;
56
- /**
57
- * Write the contents to the token file.
58
- *
59
- * @returns {Promise<SfTokens>}
60
- */
61
- write(): Promise<SfTokens>;
62
- protected init(): Promise<void>;
63
- }
1
+ import { AsyncOptionalCreatable } from '@salesforce/kit';
2
+ import { JsonMap, Optional } from '@salesforce/ts-types';
3
+ export declare type SfToken = {
4
+ token: string;
5
+ url: string;
6
+ user?: string;
7
+ timestamp: string;
8
+ } & JsonMap;
9
+ export declare type SfTokens = {
10
+ [key: string]: SfToken;
11
+ };
12
+ export declare class TokenAccessor extends AsyncOptionalCreatable {
13
+ private config;
14
+ /**
15
+ * Return all tokens.
16
+ *
17
+ * @param decrypt
18
+ * @returns {SfTokens}
19
+ */
20
+ getAll(decrypt?: boolean): SfTokens;
21
+ /**
22
+ * Return a token for the provided name.
23
+ *
24
+ * @param name
25
+ * @param decrypt
26
+ * @returns {Optional<SfToken>}
27
+ */
28
+ get(name: string, decrypt?: boolean): Optional<SfToken>;
29
+ /**
30
+ * Return true if a given name has a token associated with it.
31
+ *
32
+ * @param name
33
+ * @returns {boolean}
34
+ */
35
+ has(name: string): boolean;
36
+ /**
37
+ * Set the token for the provided name.
38
+ *
39
+ * @param name
40
+ * @param token
41
+ */
42
+ set(name: string, token: Partial<SfToken>): void;
43
+ /**
44
+ * Update the token for the provided name.
45
+ *
46
+ * @param name
47
+ * @param token
48
+ */
49
+ update(name: string, token: Partial<SfToken>): void;
50
+ /**
51
+ * Unet the token for the provided name.
52
+ *
53
+ * @param name
54
+ */
55
+ unset(name: string): void;
56
+ /**
57
+ * Write the contents to the token file.
58
+ *
59
+ * @returns {Promise<SfTokens>}
60
+ */
61
+ write(): Promise<SfTokens>;
62
+ protected init(): Promise<void>;
63
+ }
@@ -1,80 +1,80 @@
1
- "use strict";
2
- /*
3
- * Copyright (c) 2021, 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
- Object.defineProperty(exports, "__esModule", { value: true });
9
- exports.TokenAccessor = void 0;
10
- const kit_1 = require("@salesforce/kit");
11
- const tokensConfig_1 = require("../../config/tokensConfig");
12
- class TokenAccessor extends kit_1.AsyncOptionalCreatable {
13
- /**
14
- * Return all tokens.
15
- *
16
- * @param decrypt
17
- * @returns {SfTokens}
18
- */
19
- getAll(decrypt = false) {
20
- return this.config.getContents(decrypt) || {};
21
- }
22
- /**
23
- * Return a token for the provided name.
24
- *
25
- * @param name
26
- * @param decrypt
27
- * @returns {Optional<SfToken>}
28
- */
29
- get(name, decrypt = false) {
30
- return this.config.get(name, decrypt);
31
- }
32
- /**
33
- * Return true if a given name has a token associated with it.
34
- *
35
- * @param name
36
- * @returns {boolean}
37
- */
38
- has(name) {
39
- return !!this.getAll()[name];
40
- }
41
- /**
42
- * Set the token for the provided name.
43
- *
44
- * @param name
45
- * @param token
46
- */
47
- set(name, token) {
48
- this.config.set(name, token);
49
- }
50
- /**
51
- * Update the token for the provided name.
52
- *
53
- * @param name
54
- * @param token
55
- */
56
- update(name, token) {
57
- this.config.update(name, token);
58
- }
59
- /**
60
- * Unet the token for the provided name.
61
- *
62
- * @param name
63
- */
64
- unset(name) {
65
- this.config.unset(name);
66
- }
67
- /**
68
- * Write the contents to the token file.
69
- *
70
- * @returns {Promise<SfTokens>}
71
- */
72
- async write() {
73
- return this.config.write();
74
- }
75
- async init() {
76
- this.config = await tokensConfig_1.TokensConfig.create();
77
- }
78
- }
79
- exports.TokenAccessor = TokenAccessor;
1
+ "use strict";
2
+ /*
3
+ * Copyright (c) 2021, 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
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ exports.TokenAccessor = void 0;
10
+ const kit_1 = require("@salesforce/kit");
11
+ const tokensConfig_1 = require("../../config/tokensConfig");
12
+ class TokenAccessor extends kit_1.AsyncOptionalCreatable {
13
+ /**
14
+ * Return all tokens.
15
+ *
16
+ * @param decrypt
17
+ * @returns {SfTokens}
18
+ */
19
+ getAll(decrypt = false) {
20
+ return this.config.getContents(decrypt) || {};
21
+ }
22
+ /**
23
+ * Return a token for the provided name.
24
+ *
25
+ * @param name
26
+ * @param decrypt
27
+ * @returns {Optional<SfToken>}
28
+ */
29
+ get(name, decrypt = false) {
30
+ return this.config.get(name, decrypt);
31
+ }
32
+ /**
33
+ * Return true if a given name has a token associated with it.
34
+ *
35
+ * @param name
36
+ * @returns {boolean}
37
+ */
38
+ has(name) {
39
+ return !!this.getAll()[name];
40
+ }
41
+ /**
42
+ * Set the token for the provided name.
43
+ *
44
+ * @param name
45
+ * @param token
46
+ */
47
+ set(name, token) {
48
+ this.config.set(name, token);
49
+ }
50
+ /**
51
+ * Update the token for the provided name.
52
+ *
53
+ * @param name
54
+ * @param token
55
+ */
56
+ update(name, token) {
57
+ this.config.update(name, token);
58
+ }
59
+ /**
60
+ * Unet the token for the provided name.
61
+ *
62
+ * @param name
63
+ */
64
+ unset(name) {
65
+ this.config.unset(name);
66
+ }
67
+ /**
68
+ * Write the contents to the token file.
69
+ *
70
+ * @returns {Promise<SfTokens>}
71
+ */
72
+ async write() {
73
+ return this.config.write();
74
+ }
75
+ async init() {
76
+ this.config = await tokensConfig_1.TokensConfig.create();
77
+ }
78
+ }
79
+ exports.TokenAccessor = TokenAccessor;
80
80
  //# sourceMappingURL=tokenAccessor.js.map
@@ -1,4 +1,4 @@
1
- export * from './accessors/orgAccessor';
2
- export * from './accessors/aliasAccessor';
3
- export * from './accessors/tokenAccessor';
4
- export * from './stateAggregator';
1
+ export * from './accessors/orgAccessor';
2
+ export * from './accessors/aliasAccessor';
3
+ export * from './accessors/tokenAccessor';
4
+ export * from './stateAggregator';
@@ -1,27 +1,27 @@
1
- "use strict";
2
- /*
3
- * Copyright (c) 2021, 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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
9
- if (k2 === undefined) k2 = k;
10
- var desc = Object.getOwnPropertyDescriptor(m, k);
11
- if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
12
- desc = { enumerable: true, get: function() { return m[k]; } };
13
- }
14
- Object.defineProperty(o, k2, desc);
15
- }) : (function(o, m, k, k2) {
16
- if (k2 === undefined) k2 = k;
17
- o[k2] = m[k];
18
- }));
19
- var __exportStar = (this && this.__exportStar) || function(m, exports) {
20
- for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
21
- };
22
- Object.defineProperty(exports, "__esModule", { value: true });
23
- __exportStar(require("./accessors/orgAccessor"), exports);
24
- __exportStar(require("./accessors/aliasAccessor"), exports);
25
- __exportStar(require("./accessors/tokenAccessor"), exports);
26
- __exportStar(require("./stateAggregator"), exports);
1
+ "use strict";
2
+ /*
3
+ * Copyright (c) 2021, 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 __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
9
+ if (k2 === undefined) k2 = k;
10
+ var desc = Object.getOwnPropertyDescriptor(m, k);
11
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
12
+ desc = { enumerable: true, get: function() { return m[k]; } };
13
+ }
14
+ Object.defineProperty(o, k2, desc);
15
+ }) : (function(o, m, k, k2) {
16
+ if (k2 === undefined) k2 = k;
17
+ o[k2] = m[k];
18
+ }));
19
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
20
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
21
+ };
22
+ Object.defineProperty(exports, "__esModule", { value: true });
23
+ __exportStar(require("./accessors/orgAccessor"), exports);
24
+ __exportStar(require("./accessors/aliasAccessor"), exports);
25
+ __exportStar(require("./accessors/tokenAccessor"), exports);
26
+ __exportStar(require("./stateAggregator"), exports);
27
27
  //# sourceMappingURL=index.js.map
@@ -1,25 +1,25 @@
1
- import { AsyncOptionalCreatable } from '@salesforce/kit';
2
- import { AliasAccessor } from './accessors/aliasAccessor';
3
- import { OrgAccessor } from './accessors/orgAccessor';
4
- import { SandboxAccessor } from './accessors/sandboxAccessor';
5
- import { TokenAccessor } from './accessors/tokenAccessor';
6
- export declare class StateAggregator extends AsyncOptionalCreatable {
7
- private static instanceMap;
8
- aliases: AliasAccessor;
9
- orgs: OrgAccessor;
10
- sandboxes: SandboxAccessor;
11
- tokens: TokenAccessor;
12
- /**
13
- * Reuse a StateAggregator if one was already created for the current global state directory
14
- * Otherwise, create one and adds it to map for future reuse.
15
- * HomeDir might be stubbed in tests
16
- */
17
- static getInstance(): Promise<StateAggregator>;
18
- /**
19
- * Clear the cache to force reading from disk.
20
- *
21
- * *NOTE: Only call this method if you must and you know what you are doing.*
22
- */
23
- static clearInstance(path?: string): void;
24
- protected init(): Promise<void>;
25
- }
1
+ import { AsyncOptionalCreatable } from '@salesforce/kit';
2
+ import { AliasAccessor } from './accessors/aliasAccessor';
3
+ import { OrgAccessor } from './accessors/orgAccessor';
4
+ import { SandboxAccessor } from './accessors/sandboxAccessor';
5
+ import { TokenAccessor } from './accessors/tokenAccessor';
6
+ export declare class StateAggregator extends AsyncOptionalCreatable {
7
+ private static instanceMap;
8
+ aliases: AliasAccessor;
9
+ orgs: OrgAccessor;
10
+ sandboxes: SandboxAccessor;
11
+ tokens: TokenAccessor;
12
+ /**
13
+ * Reuse a StateAggregator if one was already created for the current global state directory
14
+ * Otherwise, create one and adds it to map for future reuse.
15
+ * HomeDir might be stubbed in tests
16
+ */
17
+ static getInstance(): Promise<StateAggregator>;
18
+ /**
19
+ * Clear the cache to force reading from disk.
20
+ *
21
+ * *NOTE: Only call this method if you must and you know what you are doing.*
22
+ */
23
+ static clearInstance(path?: string): void;
24
+ protected init(): Promise<void>;
25
+ }
@@ -1,46 +1,46 @@
1
- "use strict";
2
- /*
3
- * Copyright (c) 2022, 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
- Object.defineProperty(exports, "__esModule", { value: true });
9
- exports.StateAggregator = void 0;
10
- const kit_1 = require("@salesforce/kit");
11
- const global_1 = require("../global");
12
- const aliasAccessor_1 = require("./accessors/aliasAccessor");
13
- const orgAccessor_1 = require("./accessors/orgAccessor");
14
- const sandboxAccessor_1 = require("./accessors/sandboxAccessor");
15
- const tokenAccessor_1 = require("./accessors/tokenAccessor");
16
- class StateAggregator extends kit_1.AsyncOptionalCreatable {
17
- /**
18
- * Reuse a StateAggregator if one was already created for the current global state directory
19
- * Otherwise, create one and adds it to map for future reuse.
20
- * HomeDir might be stubbed in tests
21
- */
22
- static async getInstance() {
23
- if (!StateAggregator.instanceMap.has(global_1.Global.DIR)) {
24
- StateAggregator.instanceMap.set(global_1.Global.DIR, await StateAggregator.create());
25
- }
26
- // TS assertion is valid because there either was one OR it was just now instantiated
27
- return StateAggregator.instanceMap.get(global_1.Global.DIR);
28
- }
29
- /**
30
- * Clear the cache to force reading from disk.
31
- *
32
- * *NOTE: Only call this method if you must and you know what you are doing.*
33
- */
34
- static clearInstance(path = global_1.Global.DIR) {
35
- StateAggregator.instanceMap.delete(path);
36
- }
37
- async init() {
38
- this.orgs = await orgAccessor_1.OrgAccessor.create();
39
- this.sandboxes = await sandboxAccessor_1.SandboxAccessor.create();
40
- this.aliases = await aliasAccessor_1.AliasAccessor.create();
41
- this.tokens = await tokenAccessor_1.TokenAccessor.create();
42
- }
43
- }
44
- exports.StateAggregator = StateAggregator;
45
- StateAggregator.instanceMap = new Map();
1
+ "use strict";
2
+ /*
3
+ * Copyright (c) 2022, 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
+ Object.defineProperty(exports, "__esModule", { value: true });
9
+ exports.StateAggregator = void 0;
10
+ const kit_1 = require("@salesforce/kit");
11
+ const global_1 = require("../global");
12
+ const aliasAccessor_1 = require("./accessors/aliasAccessor");
13
+ const orgAccessor_1 = require("./accessors/orgAccessor");
14
+ const sandboxAccessor_1 = require("./accessors/sandboxAccessor");
15
+ const tokenAccessor_1 = require("./accessors/tokenAccessor");
16
+ class StateAggregator extends kit_1.AsyncOptionalCreatable {
17
+ /**
18
+ * Reuse a StateAggregator if one was already created for the current global state directory
19
+ * Otherwise, create one and adds it to map for future reuse.
20
+ * HomeDir might be stubbed in tests
21
+ */
22
+ static async getInstance() {
23
+ if (!StateAggregator.instanceMap.has(global_1.Global.DIR)) {
24
+ StateAggregator.instanceMap.set(global_1.Global.DIR, await StateAggregator.create());
25
+ }
26
+ // TS assertion is valid because there either was one OR it was just now instantiated
27
+ return StateAggregator.instanceMap.get(global_1.Global.DIR);
28
+ }
29
+ /**
30
+ * Clear the cache to force reading from disk.
31
+ *
32
+ * *NOTE: Only call this method if you must and you know what you are doing.*
33
+ */
34
+ static clearInstance(path = global_1.Global.DIR) {
35
+ StateAggregator.instanceMap.delete(path);
36
+ }
37
+ async init() {
38
+ this.orgs = await orgAccessor_1.OrgAccessor.create();
39
+ this.sandboxes = await sandboxAccessor_1.SandboxAccessor.create();
40
+ this.aliases = await aliasAccessor_1.AliasAccessor.create();
41
+ this.tokens = await tokenAccessor_1.TokenAccessor.create();
42
+ }
43
+ }
44
+ exports.StateAggregator = StateAggregator;
45
+ StateAggregator.instanceMap = new Map();
46
46
  //# sourceMappingURL=stateAggregator.js.map
@@ -1,66 +1,66 @@
1
- /// <reference types="node" />
2
- import { URL } from 'url';
3
- import { AsyncOptionalCreatable, Duration } from '@salesforce/kit';
4
- /**
5
- * A class used to resolve MyDomains. After a ScratchOrg is created its host name my not be propagated to the
6
- * Salesforce DNS service. This service is not exclusive to Salesforce My Domain URL and could be used for any hostname.
7
- *
8
- * ```
9
- * (async () => {
10
- * const options: MyDomainResolver.Options = {
11
- * url: new URL('http://mydomain.salesforce.com'),
12
- * timeout: Duration.minutes(5),
13
- * frequency: Duration.seconds(10)
14
- * };
15
- * const resolver: MyDomainResolver = await MyDomainResolver.create(options);
16
- * const ipAddress: AnyJson = await resolver.resolve();
17
- * console.log(`Successfully resolved host: ${options.url} to address: ${ipAddress}`);
18
- * })();
19
- * ```
20
- */
21
- export declare class MyDomainResolver extends AsyncOptionalCreatable<MyDomainResolver.Options> {
22
- static DEFAULT_DOMAIN: URL;
23
- private logger;
24
- private options;
25
- /**
26
- * Constructor
27
- * **Do not directly construct instances of this class -- use {@link MyDomainResolver.create} instead.**
28
- *
29
- * @param options The options for the class instance
30
- */
31
- constructor(options?: MyDomainResolver.Options);
32
- getTimeout(): Duration;
33
- getFrequency(): Duration;
34
- /**
35
- * Method that performs the dns lookup of the host. If the lookup fails the internal polling client will try again
36
- * given the optional interval. Returns the resolved ip address.
37
- *
38
- * If SFDX_DISABLE_DNS_CHECK environment variable is set to true, it will immediately return the host without
39
- * executing the dns loookup.
40
- */
41
- resolve(): Promise<string>;
42
- getCnames(): Promise<string[]>;
43
- /**
44
- * Used to initialize asynchronous components.
45
- */
46
- protected init(): Promise<void>;
47
- }
48
- export declare namespace MyDomainResolver {
49
- /**
50
- * Options for the MyDomain DNS resolver.
51
- */
52
- interface Options {
53
- /**
54
- * The host to resolve.
55
- */
56
- url: URL;
57
- /**
58
- * The retry interval.
59
- */
60
- timeout?: Duration;
61
- /**
62
- * The retry timeout.
63
- */
64
- frequency?: Duration;
65
- }
66
- }
1
+ /// <reference types="node" />
2
+ import { URL } from 'url';
3
+ import { AsyncOptionalCreatable, Duration } from '@salesforce/kit';
4
+ /**
5
+ * A class used to resolve MyDomains. After a ScratchOrg is created its host name my not be propagated to the
6
+ * Salesforce DNS service. This service is not exclusive to Salesforce My Domain URL and could be used for any hostname.
7
+ *
8
+ * ```
9
+ * (async () => {
10
+ * const options: MyDomainResolver.Options = {
11
+ * url: new URL('http://mydomain.salesforce.com'),
12
+ * timeout: Duration.minutes(5),
13
+ * frequency: Duration.seconds(10)
14
+ * };
15
+ * const resolver: MyDomainResolver = await MyDomainResolver.create(options);
16
+ * const ipAddress: AnyJson = await resolver.resolve();
17
+ * console.log(`Successfully resolved host: ${options.url} to address: ${ipAddress}`);
18
+ * })();
19
+ * ```
20
+ */
21
+ export declare class MyDomainResolver extends AsyncOptionalCreatable<MyDomainResolver.Options> {
22
+ static DEFAULT_DOMAIN: URL;
23
+ private logger;
24
+ private options;
25
+ /**
26
+ * Constructor
27
+ * **Do not directly construct instances of this class -- use {@link MyDomainResolver.create} instead.**
28
+ *
29
+ * @param options The options for the class instance
30
+ */
31
+ constructor(options?: MyDomainResolver.Options);
32
+ getTimeout(): Duration;
33
+ getFrequency(): Duration;
34
+ /**
35
+ * Method that performs the dns lookup of the host. If the lookup fails the internal polling client will try again
36
+ * given the optional interval. Returns the resolved ip address.
37
+ *
38
+ * If SFDX_DISABLE_DNS_CHECK environment variable is set to true, it will immediately return the host without
39
+ * executing the dns loookup.
40
+ */
41
+ resolve(): Promise<string>;
42
+ getCnames(): Promise<string[]>;
43
+ /**
44
+ * Used to initialize asynchronous components.
45
+ */
46
+ protected init(): Promise<void>;
47
+ }
48
+ export declare namespace MyDomainResolver {
49
+ /**
50
+ * Options for the MyDomain DNS resolver.
51
+ */
52
+ interface Options {
53
+ /**
54
+ * The host to resolve.
55
+ */
56
+ url: URL;
57
+ /**
58
+ * The retry interval.
59
+ */
60
+ timeout?: Duration;
61
+ /**
62
+ * The retry timeout.
63
+ */
64
+ frequency?: Duration;
65
+ }
66
+ }