@salesforce/plugin-org 3.0.5 → 3.0.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.
package/README.md CHANGED
@@ -107,7 +107,9 @@ the [SandboxNuts](https://github.com/salesforcecli/plugin-org/actions/workflows/
107
107
  - [`sf org create scratch`](#sf-org-create-scratch)
108
108
  - [`sf org delete sandbox`](#sf-org-delete-sandbox)
109
109
  - [`sf org delete scratch`](#sf-org-delete-scratch)
110
+ - [`sf org disable tracking`](#sf-org-disable-tracking)
110
111
  - [`sf org display`](#sf-org-display)
112
+ - [`sf org enable tracking`](#sf-org-enable-tracking)
111
113
  - [`sf org list`](#sf-org-list)
112
114
  - [`sf org list metadata`](#sf-org-list-metadata)
113
115
  - [`sf org list metadata-types`](#sf-org-list-metadata-types)
@@ -160,7 +162,7 @@ FLAG DESCRIPTIONS
160
162
  for a number of minutes, the client exits. Specify a longer wait time if timeouts occur frequently.
161
163
  ```
162
164
 
163
- _See code: [src/commands/force/org/clone.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.5/src/commands/force/org/clone.ts)_
165
+ _See code: [src/commands/force/org/clone.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/force/org/clone.ts)_
164
166
 
165
167
  ## `sf force org create`
166
168
 
@@ -208,7 +210,7 @@ EXAMPLES
208
210
  $ sf force org create -t sandbox -f config/dev-sandbox-def.json -a MyDevSandbox -u prodOrg
209
211
  ```
210
212
 
211
- _See code: [src/commands/force/org/create.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.5/src/commands/force/org/create.ts)_
213
+ _See code: [src/commands/force/org/create.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/force/org/create.ts)_
212
214
 
213
215
  ## `sf force org delete`
214
216
 
@@ -240,7 +242,7 @@ EXAMPLES
240
242
  $ sf force org delete -u MyOrgAlias -p
241
243
  ```
242
244
 
243
- _See code: [src/commands/force/org/delete.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.5/src/commands/force/org/delete.ts)_
245
+ _See code: [src/commands/force/org/delete.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/force/org/delete.ts)_
244
246
 
245
247
  ## `sf force org status`
246
248
 
@@ -278,7 +280,7 @@ EXAMPLES
278
280
  $ sf force org status --sandboxname DevSbx1 --wait 45 --setdefaultusername -u prodOrg
279
281
  ```
280
282
 
281
- _See code: [src/commands/force/org/status.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.5/src/commands/force/org/status.ts)_
283
+ _See code: [src/commands/force/org/status.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/force/org/status.ts)_
282
284
 
283
285
  ## `sf org create sandbox`
284
286
 
@@ -383,7 +385,7 @@ FLAG DESCRIPTIONS
383
385
  sandbox.
384
386
  ```
385
387
 
386
- _See code: [src/commands/org/create/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.5/src/commands/org/create/sandbox.ts)_
388
+ _See code: [src/commands/org/create/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/org/create/sandbox.ts)_
387
389
 
388
390
  ## `sf org create scratch`
389
391
 
@@ -536,7 +538,7 @@ FLAG DESCRIPTIONS
536
538
  Omit this flag to have Salesforce generate a unique username for your org.
537
539
  ```
538
540
 
539
- _See code: [src/commands/org/create/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.5/src/commands/org/create/scratch.ts)_
541
+ _See code: [src/commands/org/create/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/org/create/scratch.ts)_
540
542
 
541
543
  ## `sf org delete sandbox`
542
544
 
@@ -580,7 +582,7 @@ EXAMPLES
580
582
  $ sf org delete sandbox --target-org my-sandbox --no-prompt
581
583
  ```
582
584
 
583
- _See code: [src/commands/org/delete/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.5/src/commands/org/delete/sandbox.ts)_
585
+ _See code: [src/commands/org/delete/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/org/delete/sandbox.ts)_
584
586
 
585
587
  ## `sf org delete scratch`
586
588
 
@@ -622,7 +624,44 @@ EXAMPLES
622
624
  $ sf org delete scratch --target-org my-scratch-org --no-prompt
623
625
  ```
624
626
 
625
- _See code: [src/commands/org/delete/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.5/src/commands/org/delete/scratch.ts)_
627
+ _See code: [src/commands/org/delete/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/org/delete/scratch.ts)_
628
+
629
+ ## `sf org disable tracking`
630
+
631
+ Prevent Salesforce CLI from tracking changes in your source files between your project and an org.
632
+
633
+ ```
634
+ USAGE
635
+ $ sf org disable tracking -o <value> [--json]
636
+
637
+ FLAGS
638
+ -o, --target-org=<value> (required) Username or alias of the target org.
639
+
640
+ GLOBAL FLAGS
641
+ --json Format output as json.
642
+
643
+ DESCRIPTION
644
+ Prevent Salesforce CLI from tracking changes in your source files between your project and an org.
645
+
646
+ Disabling source tracking has no direct effect on the org, it affects only your local environment. Specifically,
647
+ Salesforce CLI stores the setting in the org's local configuration file so that no source tracking operations are
648
+ executed when working with the org.
649
+
650
+ EXAMPLES
651
+ Disable source tracking for an org with alias "myscratch":
652
+
653
+ $ sf org disable tracking --target-org myscratch
654
+
655
+ Disable source tracking for an org using a username:
656
+
657
+ $ sf org disable tracking --target-org you@example.com
658
+
659
+ Disable source tracking for your default org:
660
+
661
+ $ sf org disable tracking
662
+ ```
663
+
664
+ _See code: [src/commands/org/disable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/org/disable/tracking.ts)_
626
665
 
627
666
  ## `sf org display`
628
667
 
@@ -665,7 +704,47 @@ EXAMPLES
665
704
  $ sf org display --target-org TestOrg1 --verbose
666
705
  ```
667
706
 
668
- _See code: [src/commands/org/display.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.5/src/commands/org/display.ts)_
707
+ _See code: [src/commands/org/display.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/org/display.ts)_
708
+
709
+ ## `sf org enable tracking`
710
+
711
+ Allow Salesforce CLI to track changes in your source files between your project and an org.
712
+
713
+ ```
714
+ USAGE
715
+ $ sf org enable tracking -o <value> [--json]
716
+
717
+ FLAGS
718
+ -o, --target-org=<value> (required) Username or alias of the target org.
719
+
720
+ GLOBAL FLAGS
721
+ --json Format output as json.
722
+
723
+ DESCRIPTION
724
+ Allow Salesforce CLI to track changes in your source files between your project and an org.
725
+
726
+ Enabling source tracking has no direct effect on the org, it affects only your local environment. Specifically,
727
+ Salesforce CLI stores the setting in the org's local configuration file so that source tracking operations are
728
+ executed when working with the org.
729
+
730
+ This command throws an error if the org doesn't support tracking. Examples of orgs that don't support source tracking
731
+ include Developer Edition orgs, production orgs, Partial Copy sandboxes, and Full sandboxes.
732
+
733
+ EXAMPLES
734
+ Enable source tracking for an org with alias "myscratch":
735
+
736
+ $ sf org enable tracking --target-org myscratch
737
+
738
+ Enable source tracking for an org using a username:
739
+
740
+ $ sf org enable tracking --target-org you@example.com
741
+
742
+ Enable source tracking for your default org:
743
+
744
+ $ sf org enable tracking
745
+ ```
746
+
747
+ _See code: [src/commands/org/enable/tracking.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/org/enable/tracking.ts)_
669
748
 
670
749
  ## `sf org list`
671
750
 
@@ -703,7 +782,7 @@ EXAMPLES
703
782
  $ sf org list --clean
704
783
  ```
705
784
 
706
- _See code: [src/commands/org/list.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.5/src/commands/org/list.ts)_
785
+ _See code: [src/commands/org/list.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/org/list.ts)_
707
786
 
708
787
  ## `sf org list metadata`
709
788
 
@@ -767,7 +846,7 @@ FLAG DESCRIPTIONS
767
846
  Examples of metadata types that use folders are Dashboard, Document, EmailTemplate, and Report.
768
847
  ```
769
848
 
770
- _See code: [src/commands/org/list/metadata.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.5/src/commands/org/list/metadata.ts)_
849
+ _See code: [src/commands/org/list/metadata.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/org/list/metadata.ts)_
771
850
 
772
851
  ## `sf org list metadata-types`
773
852
 
@@ -820,7 +899,7 @@ FLAG DESCRIPTIONS
820
899
  Override the api version used for api requests made by this command
821
900
  ```
822
901
 
823
- _See code: [src/commands/org/list/metadata-types.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.5/src/commands/org/list/metadata-types.ts)_
902
+ _See code: [src/commands/org/list/metadata-types.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/org/list/metadata-types.ts)_
824
903
 
825
904
  ## `sf org open`
826
905
 
@@ -885,7 +964,7 @@ EXAMPLES
885
964
  $ sf org open --source-file force-app/main/default/flows/Hello.flow-meta.xml
886
965
  ```
887
966
 
888
- _See code: [src/commands/org/open.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.5/src/commands/org/open.ts)_
967
+ _See code: [src/commands/org/open.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/org/open.ts)_
889
968
 
890
969
  ## `sf org resume sandbox`
891
970
 
@@ -947,7 +1026,7 @@ FLAG DESCRIPTIONS
947
1026
  returns the job ID. To resume checking the sandbox creation, rerun this command.
948
1027
  ```
949
1028
 
950
- _See code: [src/commands/org/resume/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.5/src/commands/org/resume/sandbox.ts)_
1029
+ _See code: [src/commands/org/resume/sandbox.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/org/resume/sandbox.ts)_
951
1030
 
952
1031
  ## `sf org resume scratch`
953
1032
 
@@ -993,6 +1072,6 @@ FLAG DESCRIPTIONS
993
1072
  The job ID is valid for 24 hours after you start the scratch org creation.
994
1073
  ```
995
1074
 
996
- _See code: [src/commands/org/resume/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.5/src/commands/org/resume/scratch.ts)_
1075
+ _See code: [src/commands/org/resume/scratch.ts](https://github.com/salesforcecli/plugin-org/blob/3.0.7/src/commands/org/resume/scratch.ts)_
997
1076
 
998
1077
  <!-- commandsstop -->
@@ -0,0 +1,14 @@
1
+ import { SfCommand } from '@salesforce/sf-plugins-core';
2
+ export type OrgDisableTrackingResult = {
3
+ tracksSource: boolean;
4
+ username: string;
5
+ };
6
+ export default class OrgDisableTracking extends SfCommand<OrgDisableTrackingResult> {
7
+ static readonly summary: string;
8
+ static readonly description: string;
9
+ static readonly examples: string[];
10
+ static readonly flags: {
11
+ 'target-org': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
12
+ };
13
+ run(): Promise<OrgDisableTrackingResult>;
14
+ }
@@ -0,0 +1,30 @@
1
+ /*
2
+ * Copyright (c) 2023, salesforce.com, inc.
3
+ * All rights reserved.
4
+ * Licensed under the BSD 3-Clause license.
5
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
6
+ */
7
+ import { dirname } from 'node:path';
8
+ import { fileURLToPath } from 'node:url';
9
+ import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
10
+ import { Messages } from '@salesforce/core';
11
+ Messages.importMessagesDirectory(dirname(fileURLToPath(import.meta.url)));
12
+ const messages = Messages.loadMessages('@salesforce/plugin-org', 'org.disable.tracking');
13
+ export default class OrgDisableTracking extends SfCommand {
14
+ static summary = messages.getMessage('summary');
15
+ static description = messages.getMessage('description');
16
+ static examples = messages.getMessages('examples');
17
+ static flags = {
18
+ 'target-org': Flags.requiredOrg(),
19
+ };
20
+ async run() {
21
+ const { flags } = await this.parse(OrgDisableTracking);
22
+ await flags['target-org'].setTracksSource(false);
23
+ this.logSuccess(messages.getMessage('success', [flags['target-org'].getUsername()]));
24
+ return {
25
+ tracksSource: await flags['target-org'].tracksSource(),
26
+ username: flags['target-org'].getUsername(),
27
+ };
28
+ }
29
+ }
30
+ //# sourceMappingURL=tracking.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tracking.js","sourceRoot":"","sources":["../../../../src/commands/org/disable/tracking.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,QAAQ,CAAC,uBAAuB,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC1E,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,wBAAwB,EAAE,sBAAsB,CAAC,CAAC;AAOzF,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,SAAmC;IAC1E,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,KAAK,CAAC,WAAW,EAAE;KAClC,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACvD,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;QACrF,OAAO;YACL,YAAY,EAAE,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC,YAAY,EAAE;YACtD,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,WAAW,EAAY;SACtD,CAAC;IACJ,CAAC"}
@@ -0,0 +1,14 @@
1
+ import { SfCommand } from '@salesforce/sf-plugins-core';
2
+ export type OrgEnableTrackingResult = {
3
+ tracksSource: boolean;
4
+ username: string;
5
+ };
6
+ export default class OrgEnableTracking extends SfCommand<OrgEnableTrackingResult> {
7
+ static readonly summary: string;
8
+ static readonly description: string;
9
+ static readonly examples: string[];
10
+ static readonly flags: {
11
+ 'target-org': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
12
+ };
13
+ run(): Promise<OrgEnableTrackingResult>;
14
+ }
@@ -0,0 +1,34 @@
1
+ /*
2
+ * Copyright (c) 2023, salesforce.com, inc.
3
+ * All rights reserved.
4
+ * Licensed under the BSD 3-Clause license.
5
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
6
+ */
7
+ import { dirname } from 'node:path';
8
+ import { fileURLToPath } from 'node:url';
9
+ import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
10
+ import { Messages } from '@salesforce/core';
11
+ Messages.importMessagesDirectory(dirname(fileURLToPath(import.meta.url)));
12
+ const messages = Messages.loadMessages('@salesforce/plugin-org', 'org.enable.tracking');
13
+ export default class OrgEnableTracking extends SfCommand {
14
+ static summary = messages.getMessage('summary');
15
+ static description = messages.getMessage('description');
16
+ static examples = messages.getMessages('examples');
17
+ static flags = {
18
+ 'target-org': Flags.requiredOrg(),
19
+ };
20
+ async run() {
21
+ const { flags } = await this.parse(OrgEnableTracking);
22
+ // can this org do tracking?
23
+ if (!(await flags['target-org'].supportsSourceTracking())) {
24
+ throw messages.createError('error.TrackingNotAvailable');
25
+ }
26
+ await flags['target-org'].setTracksSource(true);
27
+ this.logSuccess(messages.getMessage('success', [flags['target-org'].getUsername()]));
28
+ return {
29
+ tracksSource: await flags['target-org'].tracksSource(),
30
+ username: flags['target-org'].getUsername(),
31
+ };
32
+ }
33
+ }
34
+ //# sourceMappingURL=tracking.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tracking.js","sourceRoot":"","sources":["../../../../src/commands/org/enable/tracking.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,QAAQ,CAAC,uBAAuB,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC1E,MAAM,QAAQ,GAAG,QAAQ,CAAC,YAAY,CAAC,wBAAwB,EAAE,qBAAqB,CAAC,CAAC;AAOxF,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,SAAkC;IACxE,MAAM,CAAU,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,CAAU,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAE5D,MAAM,CAAU,KAAK,GAAG;QAC7B,YAAY,EAAE,KAAK,CAAC,WAAW,EAAE;KAClC,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAEtD,4BAA4B;QAC5B,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC,sBAAsB,EAAE,CAAC,EAAE;YACzD,MAAM,QAAQ,CAAC,WAAW,CAAC,4BAA4B,CAAC,CAAC;SAC1D;QAED,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;QACrF,OAAO;YACL,YAAY,EAAE,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC,YAAY,EAAE;YACtD,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,WAAW,EAAY;SACtD,CAAC;IACJ,CAAC"}
@@ -0,0 +1,25 @@
1
+ # summary
2
+
3
+ Prevent Salesforce CLI from tracking changes in your source files between your project and an org.
4
+
5
+ # description
6
+
7
+ Disabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that no source tracking operations are executed when working with the org.
8
+
9
+ # examples
10
+
11
+ - Disable source tracking for an org with alias "myscratch":
12
+
13
+ <%= config.bin %> <%= command.id %> --target-org myscratch
14
+
15
+ - Disable source tracking for an org using a username:
16
+
17
+ <%= config.bin %> <%= command.id %> --target-org you@example.com
18
+
19
+ - Disable source tracking for your default org:
20
+
21
+ <%= config.bin %> <%= command.id %>
22
+
23
+ # success
24
+
25
+ Disabled source tracking for %s.
@@ -0,0 +1,39 @@
1
+ # summary
2
+
3
+ Allow Salesforce CLI to track changes in your source files between your project and an org.
4
+
5
+ # description
6
+
7
+ Enabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that source tracking operations are executed when working with the org.
8
+
9
+ This command throws an error if the org doesn't support tracking. Examples of orgs that don't support source tracking include Developer Edition orgs, production orgs, Partial Copy sandboxes, and Full sandboxes.
10
+
11
+ # examples
12
+
13
+ - Enable source tracking for an org with alias "myscratch":
14
+
15
+ <%= config.bin %> <%= command.id %> --target-org myscratch
16
+
17
+ - Enable source tracking for an org using a username:
18
+
19
+ <%= config.bin %> <%= command.id %> --target-org you@example.com
20
+
21
+ - Enable source tracking for your default org:
22
+
23
+ <%= config.bin %> <%= command.id %>
24
+
25
+ # success
26
+
27
+ Enabled source tracking for %s.
28
+
29
+ # error.TrackingNotAvailable
30
+
31
+ You can't enable source tracking on this org because the SourceMember Tooling API object isn't available, or you don't have access to it.
32
+
33
+ # error.TrackingNotAvailable.actions
34
+
35
+ - If the org is a Developer or Developer Pro sandbox, make sure that the associated production org has enabled source tracking in sandboxes. See https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_setup_enable_source_tracking_sandboxes.htm.
36
+
37
+ - Make sure that your user can access the SourceMember Tooling API object.
38
+
39
+ - You can't enable source tracking on Developer Edition orgs, production orgs, Partial Copy sandboxes, or Full sandboxes.
package/oclif.lock CHANGED
@@ -962,11 +962,11 @@
962
962
  integrity sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==
963
963
 
964
964
  "@salesforce/cli-plugins-testkit@^5.0.3":
965
- version "5.0.3"
966
- resolved "https://registry.yarnpkg.com/@salesforce/cli-plugins-testkit/-/cli-plugins-testkit-5.0.3.tgz#c1b066d499f9d29f918a9337c37e0d01a9313631"
967
- integrity sha512-fIW7xdyUNb8pPn8hUtIR2zsCD+dXTK7WC0OJG5m+XMM/LTLFTh31ygaKEACbdWlrpJSySfB2WOmOPMx5cRZsPQ==
965
+ version "5.0.4"
966
+ resolved "https://registry.yarnpkg.com/@salesforce/cli-plugins-testkit/-/cli-plugins-testkit-5.0.4.tgz#523c459f43822d7b24bff5117aeda7f77ed5e26c"
967
+ integrity sha512-8pquViVBCd5sF6nBXgLgwymEBE6pSAS376R9qq7rxuV+PSFCC5bnzQaKm2ugY+s5vXKNcV6WcmBHNCQnGv+M7Q==
968
968
  dependencies:
969
- "@salesforce/core" "^5.3.17"
969
+ "@salesforce/core" "^5.3.20"
970
970
  "@salesforce/kit" "^3.0.15"
971
971
  "@salesforce/ts-types" "^2.0.6"
972
972
  "@types/shelljs" "^0.8.15"
@@ -1029,10 +1029,10 @@
1029
1029
  resolved "https://registry.yarnpkg.com/@salesforce/dev-config/-/dev-config-4.1.0.tgz#e529576466d074e7a5f1441236510fef123da01e"
1030
1030
  integrity sha512-2iDDepiIwjXHS5IVY7pwv8jMo4xWosJ7p/UTj+lllpB/gnJiYLhjJPE4Z3FCGFKyvfg5jGaimCd8Ca6bLGsCQA==
1031
1031
 
1032
- "@salesforce/dev-scripts@^7.1.0":
1033
- version "7.1.0"
1034
- resolved "https://registry.yarnpkg.com/@salesforce/dev-scripts/-/dev-scripts-7.1.0.tgz#123708d4f494d8b95464b90c28993141986e84bc"
1035
- integrity sha512-79x6QgENORLyCrr9b4MO2pPq8N7d9ILj83vOtAp5NLreAfjZN/c5TEEHuIZKZ3UaO+hkwbtzv3Qs6CyNxiasWA==
1032
+ "@salesforce/dev-scripts@^7.1.1":
1033
+ version "7.1.1"
1034
+ resolved "https://registry.yarnpkg.com/@salesforce/dev-scripts/-/dev-scripts-7.1.1.tgz#549b58fb7e8c2410ce594c46f780a0907618f19f"
1035
+ integrity sha512-6SL+QDOMZCnmU4Lu2ZCjqsMRcHw96mnjUOPE7b2HcfmfPo2a/hAYUtv8v7UsZ/+3UPbSf+XsLJfUsF15QIUWrg==
1036
1036
  dependencies:
1037
1037
  "@commitlint/cli" "^17.1.2"
1038
1038
  "@commitlint/config-conventional" "^17.1.0"
@@ -1482,6 +1482,118 @@
1482
1482
  "scratch:delete:org"
1483
1483
  ]
1484
1484
  },
1485
+ "org:disable:tracking": {
1486
+ "aliases": [],
1487
+ "args": {},
1488
+ "description": "Disabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that no source tracking operations are executed when working with the org.",
1489
+ "examples": [
1490
+ "Disable source tracking for an org with alias \"myscratch\":\n<%= config.bin %> <%= command.id %> --target-org myscratch",
1491
+ "Disable source tracking for an org using a username:\n<%= config.bin %> <%= command.id %> --target-org you@example.com",
1492
+ "Disable source tracking for your default org:\n<%= config.bin %> <%= command.id %>"
1493
+ ],
1494
+ "flags": {
1495
+ "json": {
1496
+ "description": "Format output as json.",
1497
+ "helpGroup": "GLOBAL",
1498
+ "name": "json",
1499
+ "allowNo": false,
1500
+ "type": "boolean"
1501
+ },
1502
+ "target-org": {
1503
+ "char": "o",
1504
+ "name": "target-org",
1505
+ "noCacheDefault": true,
1506
+ "required": true,
1507
+ "summary": "Username or alias of the target org.",
1508
+ "hasDynamicHelp": true,
1509
+ "multiple": false,
1510
+ "type": "option"
1511
+ }
1512
+ },
1513
+ "hasDynamicHelp": true,
1514
+ "hiddenAliases": [],
1515
+ "id": "org:disable:tracking",
1516
+ "pluginAlias": "@salesforce/plugin-org",
1517
+ "pluginName": "@salesforce/plugin-org",
1518
+ "pluginType": "core",
1519
+ "strict": true,
1520
+ "summary": "Prevent Salesforce CLI from tracking changes in your source files between your project and an org.",
1521
+ "enableJsonFlag": true,
1522
+ "SF_ENV": "SF_ENV",
1523
+ "isESM": true,
1524
+ "relativePath": [
1525
+ "lib",
1526
+ "commands",
1527
+ "org",
1528
+ "disable",
1529
+ "tracking.js"
1530
+ ],
1531
+ "aliasPermutations": [],
1532
+ "permutations": [
1533
+ "org:disable:tracking",
1534
+ "disable:org:tracking",
1535
+ "disable:tracking:org",
1536
+ "org:tracking:disable",
1537
+ "tracking:org:disable",
1538
+ "tracking:disable:org"
1539
+ ]
1540
+ },
1541
+ "org:enable:tracking": {
1542
+ "aliases": [],
1543
+ "args": {},
1544
+ "description": "Enabling source tracking has no direct effect on the org, it affects only your local environment. Specifically, Salesforce CLI stores the setting in the org's local configuration file so that source tracking operations are executed when working with the org.\n\nThis command throws an error if the org doesn't support tracking. Examples of orgs that don't support source tracking include Developer Edition orgs, production orgs, Partial Copy sandboxes, and Full sandboxes.",
1545
+ "examples": [
1546
+ "Enable source tracking for an org with alias \"myscratch\":\n<%= config.bin %> <%= command.id %> --target-org myscratch",
1547
+ "Enable source tracking for an org using a username:\n<%= config.bin %> <%= command.id %> --target-org you@example.com",
1548
+ "Enable source tracking for your default org:\n<%= config.bin %> <%= command.id %>"
1549
+ ],
1550
+ "flags": {
1551
+ "json": {
1552
+ "description": "Format output as json.",
1553
+ "helpGroup": "GLOBAL",
1554
+ "name": "json",
1555
+ "allowNo": false,
1556
+ "type": "boolean"
1557
+ },
1558
+ "target-org": {
1559
+ "char": "o",
1560
+ "name": "target-org",
1561
+ "noCacheDefault": true,
1562
+ "required": true,
1563
+ "summary": "Username or alias of the target org.",
1564
+ "hasDynamicHelp": true,
1565
+ "multiple": false,
1566
+ "type": "option"
1567
+ }
1568
+ },
1569
+ "hasDynamicHelp": true,
1570
+ "hiddenAliases": [],
1571
+ "id": "org:enable:tracking",
1572
+ "pluginAlias": "@salesforce/plugin-org",
1573
+ "pluginName": "@salesforce/plugin-org",
1574
+ "pluginType": "core",
1575
+ "strict": true,
1576
+ "summary": "Allow Salesforce CLI to track changes in your source files between your project and an org.",
1577
+ "enableJsonFlag": true,
1578
+ "SF_ENV": "SF_ENV",
1579
+ "isESM": true,
1580
+ "relativePath": [
1581
+ "lib",
1582
+ "commands",
1583
+ "org",
1584
+ "enable",
1585
+ "tracking.js"
1586
+ ],
1587
+ "aliasPermutations": [],
1588
+ "permutations": [
1589
+ "org:enable:tracking",
1590
+ "enable:org:tracking",
1591
+ "enable:tracking:org",
1592
+ "org:tracking:enable",
1593
+ "tracking:org:enable",
1594
+ "tracking:enable:org"
1595
+ ]
1596
+ },
1485
1597
  "org:list:metadata-types": {
1486
1598
  "aliases": [
1487
1599
  "force:mdapi:describemetadata"
@@ -1903,5 +2015,5 @@
1903
2015
  ]
1904
2016
  }
1905
2017
  },
1906
- "version": "3.0.5"
2018
+ "version": "3.0.7"
1907
2019
  }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@salesforce/plugin-org",
3
3
  "description": "Commands to interact with Salesforce orgs",
4
- "version": "3.0.5",
4
+ "version": "3.0.7",
5
5
  "author": "Salesforce",
6
6
  "bugs": "https://github.com/forcedotcom/cli/issues",
7
7
  "dependencies": {
@@ -15,7 +15,7 @@
15
15
  "devDependencies": {
16
16
  "@oclif/plugin-command-snapshot": "^5.0.2",
17
17
  "@salesforce/cli-plugins-testkit": "^5.0.3",
18
- "@salesforce/dev-scripts": "^7.1.0",
18
+ "@salesforce/dev-scripts": "^7.1.1",
19
19
  "@salesforce/plugin-command-reference": "^3.0.46",
20
20
  "@salesforce/ts-sinon": "1.4.19",
21
21
  "@types/shelljs": "^0.8.14",
@@ -70,8 +70,15 @@
70
70
  },
71
71
  "delete": {
72
72
  "description": "Delete scratch orgs, sandboxes, org shapes, and org snapshots."
73
+ },
74
+ "enable": {
75
+ "description": "Enable source tracking in an org."
76
+ },
77
+ "disable": {
78
+ "description": "Disable source tracking in an org."
73
79
  }
74
- }
80
+ },
81
+ "external": true
75
82
  },
76
83
  "force": {
77
84
  "external": true,
@@ -217,7 +224,7 @@
217
224
  "exports": "./lib/index.js",
218
225
  "type": "module",
219
226
  "sfdx": {
220
- "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/3.0.5.crt",
221
- "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/3.0.5.sig"
227
+ "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/3.0.7.crt",
228
+ "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-org/3.0.7.sig"
222
229
  }
223
230
  }