@salesforce/plugin-deploy-retrieve 3.22.5 → 3.22.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 (3) hide show
  1. package/README.md +17 -17
  2. package/oclif.manifest.json +372 -372
  3. package/package.json +5 -5
package/README.md CHANGED
@@ -141,7 +141,7 @@ FLAG DESCRIPTIONS
141
141
  If you specify this flag, don’t specify --metadata or --source-dir.
142
142
  ```
143
143
 
144
- _See code: [src/commands/project/convert/mdapi.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/convert/mdapi.ts)_
144
+ _See code: [src/commands/project/convert/mdapi.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/convert/mdapi.ts)_
145
145
 
146
146
  ## `sf project convert source`
147
147
 
@@ -214,7 +214,7 @@ FLAG DESCRIPTIONS
214
214
  Override the api version used for api requests made by this command
215
215
  ```
216
216
 
217
- _See code: [src/commands/project/convert/source.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/convert/source.ts)_
217
+ _See code: [src/commands/project/convert/source.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/convert/source.ts)_
218
218
 
219
219
  ## `sf project convert source-behavior`
220
220
 
@@ -273,7 +273,7 @@ EXAMPLES
273
273
  $ sf project convert source-behavior --behavior decomposePermissionSetBeta --dry-run --preserve-temp-dir
274
274
  ```
275
275
 
276
- _See code: [src/commands/project/convert/source-behavior.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/convert/source-behavior.ts)_
276
+ _See code: [src/commands/project/convert/source-behavior.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/convert/source-behavior.ts)_
277
277
 
278
278
  ## `sf project delete source`
279
279
 
@@ -413,7 +413,7 @@ FLAG DESCRIPTIONS
413
413
  - Separate the test names with spaces: --tests Test1 Test2 "Test With Space"
414
414
  ```
415
415
 
416
- _See code: [src/commands/project/delete/source.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/delete/source.ts)_
416
+ _See code: [src/commands/project/delete/source.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/delete/source.ts)_
417
417
 
418
418
  ## `sf project delete tracking`
419
419
 
@@ -450,7 +450,7 @@ EXAMPLES
450
450
  $ sf project delete tracking --target-org my-scratch
451
451
  ```
452
452
 
453
- _See code: [src/commands/project/delete/tracking.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/delete/tracking.ts)_
453
+ _See code: [src/commands/project/delete/tracking.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/delete/tracking.ts)_
454
454
 
455
455
  ## `sf project deploy cancel`
456
456
 
@@ -522,7 +522,7 @@ FLAG DESCRIPTIONS
522
522
  project deploy report".
523
523
  ```
524
524
 
525
- _See code: [src/commands/project/deploy/cancel.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/deploy/cancel.ts)_
525
+ _See code: [src/commands/project/deploy/cancel.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/deploy/cancel.ts)_
526
526
 
527
527
  ## `sf project deploy preview`
528
528
 
@@ -605,7 +605,7 @@ FLAG DESCRIPTIONS
605
605
  All child components are included. If you specify this flag, don’t specify --metadata or --source-dir.
606
606
  ```
607
607
 
608
- _See code: [src/commands/project/deploy/preview.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/deploy/preview.ts)_
608
+ _See code: [src/commands/project/deploy/preview.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/deploy/preview.ts)_
609
609
 
610
610
  ## `sf project deploy quick`
611
611
 
@@ -689,7 +689,7 @@ FLAG DESCRIPTIONS
689
689
  deploy report".
690
690
  ```
691
691
 
692
- _See code: [src/commands/project/deploy/quick.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/deploy/quick.ts)_
692
+ _See code: [src/commands/project/deploy/quick.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/deploy/quick.ts)_
693
693
 
694
694
  ## `sf project deploy report`
695
695
 
@@ -781,7 +781,7 @@ FLAG DESCRIPTIONS
781
781
  --coverage-formatters lcov --coverage-formatters clover
782
782
  ```
783
783
 
784
- _See code: [src/commands/project/deploy/report.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/deploy/report.ts)_
784
+ _See code: [src/commands/project/deploy/report.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/deploy/report.ts)_
785
785
 
786
786
  ## `sf project deploy resume`
787
787
 
@@ -866,7 +866,7 @@ FLAG DESCRIPTIONS
866
866
  --coverage-formatters lcov --coverage-formatters clover
867
867
  ```
868
868
 
869
- _See code: [src/commands/project/deploy/resume.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/deploy/resume.ts)_
869
+ _See code: [src/commands/project/deploy/resume.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/deploy/resume.ts)_
870
870
 
871
871
  ## `sf project deploy start`
872
872
 
@@ -1102,7 +1102,7 @@ FLAG DESCRIPTIONS
1102
1102
  --coverage-formatters lcov --coverage-formatters clover
1103
1103
  ```
1104
1104
 
1105
- _See code: [src/commands/project/deploy/start.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/deploy/start.ts)_
1105
+ _See code: [src/commands/project/deploy/start.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/deploy/start.ts)_
1106
1106
 
1107
1107
  ## `sf project deploy validate`
1108
1108
 
@@ -1275,7 +1275,7 @@ FLAG DESCRIPTIONS
1275
1275
  --coverage-formatters lcov --coverage-formatters clover
1276
1276
  ```
1277
1277
 
1278
- _See code: [src/commands/project/deploy/validate.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/deploy/validate.ts)_
1278
+ _See code: [src/commands/project/deploy/validate.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/deploy/validate.ts)_
1279
1279
 
1280
1280
  ## `sf project generate manifest`
1281
1281
 
@@ -1371,7 +1371,7 @@ EXAMPLES
1371
1371
  $ sf project generate manifest --from-org test@myorg.com --excluded-metadata StandardValueSet
1372
1372
  ```
1373
1373
 
1374
- _See code: [src/commands/project/generate/manifest.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/generate/manifest.ts)_
1374
+ _See code: [src/commands/project/generate/manifest.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/generate/manifest.ts)_
1375
1375
 
1376
1376
  ## `sf project list ignored`
1377
1377
 
@@ -1413,7 +1413,7 @@ EXAMPLES
1413
1413
  $ sf project list ignored --source-dir package.xml
1414
1414
  ```
1415
1415
 
1416
- _See code: [src/commands/project/list/ignored.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/list/ignored.ts)_
1416
+ _See code: [src/commands/project/list/ignored.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/list/ignored.ts)_
1417
1417
 
1418
1418
  ## `sf project reset tracking`
1419
1419
 
@@ -1462,7 +1462,7 @@ EXAMPLES
1462
1462
  $ sf project reset tracking --revision 30
1463
1463
  ```
1464
1464
 
1465
- _See code: [src/commands/project/reset/tracking.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/reset/tracking.ts)_
1465
+ _See code: [src/commands/project/reset/tracking.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/reset/tracking.ts)_
1466
1466
 
1467
1467
  ## `sf project retrieve preview`
1468
1468
 
@@ -1516,7 +1516,7 @@ FLAG DESCRIPTIONS
1516
1516
  production orgs.
1517
1517
  ```
1518
1518
 
1519
- _See code: [src/commands/project/retrieve/preview.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/retrieve/preview.ts)_
1519
+ _See code: [src/commands/project/retrieve/preview.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/retrieve/preview.ts)_
1520
1520
 
1521
1521
  ## `sf project retrieve start`
1522
1522
 
@@ -1689,6 +1689,6 @@ FLAG DESCRIPTIONS
1689
1689
  If you specify this flag, don’t specify --metadata or --source-dir.
1690
1690
  ```
1691
1691
 
1692
- _See code: [src/commands/project/retrieve/start.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.5/src/commands/project/retrieve/start.ts)_
1692
+ _See code: [src/commands/project/retrieve/start.ts](https://github.com/salesforcecli/plugin-deploy-retrieve/blob/3.22.7/src/commands/project/retrieve/start.ts)_
1693
1693
 
1694
1694
  <!-- commandsstop -->
@@ -405,20 +405,18 @@
405
405
  "source:convert:project"
406
406
  ]
407
407
  },
408
- "project:generate:manifest": {
408
+ "project:delete:source": {
409
409
  "aliases": [
410
- "force:source:manifest:create"
410
+ "force:source:delete"
411
411
  ],
412
412
  "args": {},
413
413
  "deprecateAliases": true,
414
- "description": "Create a manifest from a list of metadata components (--metadata) or from one or more local directories that contain source files (--source-dir). You can specify either of these flags, not both.\n\nUse --type to specify the type of manifest you want to create. The resulting manifest files have specific names, such as the standard package.xml or destructiveChanges.xml to delete metadata. Valid values for this flag, and their respective file names, are:\n\n * package : package.xml (default)\n * pre : destructiveChangesPre.xml\n * post : destructiveChangesPost.xml\n * destroy : destructiveChanges.xml\n\nSee https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_deleting_files.htm for information about these destructive manifest files.\n\nUse --name to specify a custom name for the generated manifest if the pre-defined ones don’t suit your needs. You can specify either --type or --name, but not both.\n\nTo include multiple metadata components, either set multiple --metadata <name> flags or a single --metadata flag with multiple names separated by spaces. Enclose names that contain spaces in one set of double quotes. The same syntax applies to --include-packages and --source-dir.\n\nTo build a manifest from the metadata in an org, use the --from-org flag. You can combine --from-org with the --metadata flag to include only certain metadata types, or with the --excluded-metadata flag to exclude certain metadata types. When building a manifest from an org, the command makes many concurrent API calls to discover the metadata that exists in the org. To limit the number of concurrent requests, use the SF_LIST_METADATA_BATCH_SIZE environment variable and set it to a size that works best for your org and environment. If you experience timeouts or inconsistent manifest contents, then setting this environment variable can improve accuracy. However, the command takes longer to run because it sends fewer requests at a time.",
414
+ "description": "Use this command to delete components from orgs that don’t have source tracking. To remove deleted items from orgs that have source tracking enabled, \"<%= config.bin %> project deploy start\".\n\nWhen you run this command, both the local source file and the metadata component in the org are deleted.\n\nTo delete multiple metadata components, either set multiple --metadata <name> flags or a single --metadata flag with multiple names separated by spaces. Enclose names that contain spaces in one set of double quotes. The same syntax applies to --source-dir.",
415
415
  "examples": [
416
- "Create a manifest for deploying or retrieving all Apex classes and custom objects:\n$ <%= config.bin %> <%= command.id %> --metadata ApexClass --metadata CustomObject",
417
- "Create a manifest for deleting the specified Apex class:\n$ <%= config.bin %> <%= command.id %> --metadata ApexClass:MyApexClass --type destroy",
418
- "Create a manifest for deploying or retrieving all the metadata components in the specified local directory; name the file myNewManifest.xml:\n$ <%= config.bin %> <%= command.id %> --source-dir force-app --name myNewManifest",
419
- "Create a manifest from the metadata components in the specified org and include metadata in any unlocked packages:\n$ <%= config.bin %> <%= command.id %> --from-org test@myorg.com --include-packages unlocked",
420
- "Create a manifest from specific metadata types in an org:\n$ <%= config.bin %> <%= command.id %> --from-org test@myorg.com --metadata ApexClass,CustomObject,CustomLabels",
421
- "Create a manifest from all metadata components in an org excluding specific metadata types:\n$ <%= config.bin %> <%= command.id %> --from-org test@myorg.com --excluded-metadata StandardValueSet"
416
+ "Delete all local Apex source files and all Apex classes from the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --metadata ApexClass --target-org my-scratch",
417
+ "Delete a specific Apex class and a Profile that has a space in it from your default org; don't prompt for confirmation:\n<%= config.bin %> <%= command.id %> --metadata ApexClass:MyFabulousApexClass --metadata \"Profile: My Profile\" --no-prompt",
418
+ "Run the tests that aren’t in any managed packages as part of the deletion; if the delete succeeds, and the org has source-tracking enabled, update the source tracking information:\n<%= config.bin %> <%= command.id %> --metadata ApexClass --test-level RunLocalTests --track-source",
419
+ "Delete the Apex source files in a directory and the corresponding components from your default org:\n<%= config.bin %> <%= command.id %> --source-dir force-app/main/default/classes"
422
420
  ],
423
421
  "flags": {
424
422
  "json": {
@@ -457,137 +455,149 @@
457
455
  "multiple": false,
458
456
  "type": "option"
459
457
  },
460
- "metadata": {
461
- "char": "m",
462
- "name": "metadata",
463
- "summary": "Names of metadata components to include in the manifest.",
464
- "delimiter": ",",
465
- "hasDynamicHelp": false,
466
- "multiple": true,
467
- "type": "option"
468
- },
469
- "source-dir": {
458
+ "target-org": {
470
459
  "aliases": [
471
- "sourcepath"
460
+ "targetusername",
461
+ "u"
472
462
  ],
473
- "char": "p",
463
+ "char": "o",
474
464
  "deprecateAliases": true,
475
- "name": "source-dir",
476
- "summary": "Paths to the local source files to include in the manifest.",
477
- "delimiter": ",",
478
- "hasDynamicHelp": false,
479
- "multiple": true,
465
+ "name": "target-org",
466
+ "noCacheDefault": true,
467
+ "required": true,
468
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
469
+ "hasDynamicHelp": true,
470
+ "multiple": false,
480
471
  "type": "option"
481
472
  },
482
- "name": {
473
+ "check-only": {
483
474
  "aliases": [
484
- "manifestname"
475
+ "checkonly"
485
476
  ],
486
- "char": "n",
477
+ "char": "c",
487
478
  "deprecateAliases": true,
488
- "exclusive": [
489
- "type"
490
- ],
491
- "name": "name",
492
- "summary": "Name of a custom manifest file to create.",
493
- "hasDynamicHelp": false,
479
+ "description": "IMPORTANT: Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.\n\nValidates the deleted metadata and runs all Apex tests, but prevents the deletion from being saved to the org.\n\nIf you change a field type from Master-Detail to Lookup or vice versa, that change isn’t supported when using the --check-only flag to test a deletion (validation). This kind of change isn’t supported for test deletions to avoid the risk of data loss or corruption. If a change that isn’t supported for test deletions is included in a deletion package, the test deletion fails and issues an error.\n\nIf your deletion package changes a field type from Master-Detail to Lookup or vice versa, you can still validate the changes prior to deploying to Production by performing a full deletion to another test Sandbox. A full deletion includes a validation of the changes as part of the deletion process.\n\nNote: A Metadata API deletion that includes Master-Detail relationships deletes all detail records in the Recycle Bin in the following cases.\n\n 1. For a deletion with a new Master-Detail field, soft delete (send to the Recycle Bin) all detail records before proceeding to delete the Master-Detail field, or the deletion fails. During the deletion, detail records are permanently deleted from the Recycle Bin and cannot be recovered.\n\n 2. For a deletion that converts a Lookup field relationship to a Master-Detail relationship, detail records must reference a master record or be soft-deleted (sent to the Recycle Bin) for the deletion to succeed. However, a successful deletion permanently deletes any detail records in the Recycle Bin.",
480
+ "name": "check-only",
481
+ "summary": "Validate delete command but don't delete anything from the org or the local project.",
482
+ "allowNo": false,
483
+ "type": "boolean"
484
+ },
485
+ "wait": {
486
+ "char": "w",
487
+ "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you.",
488
+ "name": "wait",
489
+ "summary": "Number of minutes to wait for the command to finish.",
490
+ "hasDynamicHelp": true,
494
491
  "multiple": false,
495
492
  "type": "option"
496
493
  },
497
- "type": {
494
+ "tests": {
495
+ "description": "If a test name contains a space, enclose it in double quotes.\nFor multiple test names, use one of the following formats:\n\n- Repeat the flag for multiple test names: --tests Test1 --tests Test2 --tests \"Test With Space\"\n- Separate the test names with spaces: --tests Test1 Test2 \"Test With Space\"",
496
+ "helpGroup": "Test",
497
+ "name": "tests",
498
+ "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
499
+ "hasDynamicHelp": false,
500
+ "multiple": true,
501
+ "type": "option"
502
+ },
503
+ "test-level": {
498
504
  "aliases": [
499
- "manifesttype"
505
+ "testlevel"
500
506
  ],
501
- "char": "t",
507
+ "char": "l",
502
508
  "deprecateAliases": true,
503
- "exclusive": [
504
- "name"
505
- ],
506
- "name": "type",
507
- "summary": "Type of manifest to create; the type determines the name of the created file.",
509
+ "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package and target org. For more information, see “Running Tests in a Deployment” in the Metadata API Developer Guide.",
510
+ "helpGroup": "Test",
511
+ "name": "test-level",
512
+ "summary": "Deployment Apex testing level.",
508
513
  "hasDynamicHelp": false,
509
514
  "multiple": false,
510
515
  "options": [
511
- "pre",
512
- "post",
513
- "destroy",
514
- "package"
516
+ "NoTestRun",
517
+ "RunSpecifiedTests",
518
+ "RunLocalTests",
519
+ "RunAllTestsInOrg"
515
520
  ],
516
521
  "type": "option"
517
522
  },
518
- "include-packages": {
523
+ "no-prompt": {
519
524
  "aliases": [
520
- "includepackages"
521
- ],
522
- "char": "c",
523
- "dependsOn": [
524
- "from-org"
525
+ "noprompt"
525
526
  ],
527
+ "char": "r",
526
528
  "deprecateAliases": true,
527
- "name": "include-packages",
528
- "summary": "Package types (managed, unlocked) whose metadata is included in the manifest; by default, metadata in managed and unlocked packages is excluded. Metadata in unmanaged packages is always included.",
529
+ "name": "no-prompt",
530
+ "summary": "Don't prompt for delete confirmation.",
531
+ "allowNo": false,
532
+ "type": "boolean"
533
+ },
534
+ "metadata": {
535
+ "char": "m",
536
+ "description": "If you specify this flag, don’t specify --source-dir.",
537
+ "name": "metadata",
538
+ "summary": "Metadata components to delete.",
529
539
  "delimiter": ",",
530
540
  "hasDynamicHelp": false,
531
541
  "multiple": true,
532
- "options": [
533
- "managed",
534
- "unlocked"
535
- ],
536
542
  "type": "option"
537
543
  },
538
- "excluded-metadata": {
539
- "name": "excluded-metadata",
540
- "relationships": [
541
- {
542
- "type": "some",
543
- "flags": [
544
- "from-org",
545
- "source-dir"
546
- ]
547
- }
544
+ "source-dir": {
545
+ "aliases": [
546
+ "sourcepath"
548
547
  ],
549
- "summary": "Metadata types to exclude when building a manifest from an org. Specify the name of the type, not the name of a specific component.",
548
+ "char": "p",
549
+ "deprecateAliases": true,
550
+ "description": "The supplied paths can be a single file (in which case the operation is applied to only one file) or a folder (in which case the operation is applied to all metadata types in the directory and its sub-directories).\n\nIf you specify this flag, don’t specify --metadata.",
551
+ "name": "source-dir",
552
+ "summary": "Source file paths to delete.",
550
553
  "delimiter": ",",
551
554
  "hasDynamicHelp": false,
552
555
  "multiple": true,
553
556
  "type": "option"
554
557
  },
555
- "from-org": {
558
+ "track-source": {
556
559
  "aliases": [
557
- "fromorg"
560
+ "tracksource"
558
561
  ],
562
+ "char": "t",
559
563
  "deprecateAliases": true,
560
564
  "exclusive": [
561
- "source-dir"
565
+ "check-only"
562
566
  ],
563
- "name": "from-org",
564
- "summary": "Username or alias of the org that contains the metadata components from which to build a manifest.",
565
- "hasDynamicHelp": false,
566
- "multiple": false,
567
- "type": "option"
567
+ "name": "track-source",
568
+ "summary": "If the delete succeeds, update the source tracking information.",
569
+ "allowNo": false,
570
+ "type": "boolean"
568
571
  },
569
- "output-dir": {
572
+ "force-overwrite": {
570
573
  "aliases": [
571
- "outputdir",
572
- "o"
574
+ "forceoverwrite"
575
+ ],
576
+ "char": "f",
577
+ "dependsOn": [
578
+ "track-source"
573
579
  ],
574
- "char": "d",
575
580
  "deprecateAliases": true,
576
- "name": "output-dir",
577
- "summary": "Directory to save the created manifest.",
578
- "hasDynamicHelp": false,
579
- "multiple": false,
580
- "type": "option"
581
+ "name": "force-overwrite",
582
+ "summary": "Ignore conflict warnings and overwrite changes to the org.",
583
+ "allowNo": false,
584
+ "type": "boolean"
585
+ },
586
+ "verbose": {
587
+ "name": "verbose",
588
+ "summary": "Verbose output of the delete result.",
589
+ "allowNo": false,
590
+ "type": "boolean"
581
591
  }
582
592
  },
583
- "hasDynamicHelp": false,
593
+ "hasDynamicHelp": true,
584
594
  "hiddenAliases": [],
585
- "id": "project:generate:manifest",
595
+ "id": "project:delete:source",
586
596
  "pluginAlias": "@salesforce/plugin-deploy-retrieve",
587
597
  "pluginName": "@salesforce/plugin-deploy-retrieve",
588
598
  "pluginType": "core",
589
599
  "strict": true,
590
- "summary": "Create a project manifest that lists the metadata components you want to deploy or retrieve.",
600
+ "summary": "Delete source from your project and from a non-source-tracked org.",
591
601
  "enableJsonFlag": true,
592
602
  "requiresProject": true,
593
603
  "isESM": true,
@@ -595,54 +605,35 @@
595
605
  "lib",
596
606
  "commands",
597
607
  "project",
598
- "generate",
599
- "manifest.js"
608
+ "delete",
609
+ "source.js"
600
610
  ],
601
611
  "aliasPermutations": [
602
- "force:source:manifest:create",
603
- "source:force:manifest:create",
604
- "source:manifest:force:create",
605
- "source:manifest:create:force",
606
- "force:manifest:source:create",
607
- "manifest:force:source:create",
608
- "manifest:source:force:create",
609
- "manifest:source:create:force",
610
- "force:manifest:create:source",
611
- "manifest:force:create:source",
612
- "manifest:create:force:source",
613
- "manifest:create:source:force",
614
- "force:source:create:manifest",
615
- "source:force:create:manifest",
616
- "source:create:force:manifest",
617
- "source:create:manifest:force",
618
- "force:create:source:manifest",
619
- "create:force:source:manifest",
620
- "create:source:force:manifest",
621
- "create:source:manifest:force",
622
- "force:create:manifest:source",
623
- "create:force:manifest:source",
624
- "create:manifest:force:source",
625
- "create:manifest:source:force"
612
+ "force:source:delete",
613
+ "source:force:delete",
614
+ "source:delete:force",
615
+ "force:delete:source",
616
+ "delete:force:source",
617
+ "delete:source:force"
626
618
  ],
627
619
  "permutations": [
628
- "project:generate:manifest",
629
- "generate:project:manifest",
630
- "generate:manifest:project",
631
- "project:manifest:generate",
632
- "manifest:project:generate",
633
- "manifest:generate:project"
620
+ "project:delete:source",
621
+ "delete:project:source",
622
+ "delete:source:project",
623
+ "project:source:delete",
624
+ "source:project:delete",
625
+ "source:delete:project"
634
626
  ]
635
627
  },
636
- "project:deploy:cancel": {
628
+ "project:delete:tracking": {
637
629
  "aliases": [
638
- "deploy:metadata:cancel"
630
+ "force:source:tracking:clear"
639
631
  ],
640
632
  "args": {},
641
633
  "deprecateAliases": true,
642
- "description": "Use this command to cancel a deploy operation that hasn't yet completed in the org. Deploy operations include standard deploys, quick deploys, deploy validations, and deploy cancellations.\n\nRun this command by either passing it a job ID or specifying the --use-most-recent flag to use the job ID of the most recent deploy operation.",
634
+ "description": "WARNING: This command deletes or overwrites all existing source tracking files. Use with extreme caution.\n\nDeletes all local source tracking information. When you next run 'project deploy preview', Salesforce CLI displays all local and remote files as changed, and any files with the same name are listed as conflicts.",
643
635
  "examples": [
644
- "Cancel a deploy operation using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 0Af0x000017yLUFCA2",
645
- "Cancel the most recent deploy operation:\n<%= config.bin %> <%= command.id %> --use-most-recent"
636
+ "Delete local source tracking for the org with alias \"my-scratch\":\n$ <%= config.bin %> <%= command.id %> --target-org my-scratch"
646
637
  ],
647
638
  "flags": {
648
639
  "json": {
@@ -660,17 +651,145 @@
660
651
  "multiple": false,
661
652
  "type": "option"
662
653
  },
663
- "target-org": {
664
- "char": "o",
665
- "name": "target-org",
666
- "noCacheDefault": true,
667
- "summary": "Username or alias of the target org.",
668
- "hasDynamicHelp": true,
669
- "multiple": false,
670
- "type": "option"
671
- },
672
- "async": {
673
- "description": "The command immediately returns the control of the terminal to you. This way, you can continue to use the CLI. To resume watching the cancellation, run \"<%= config.bin %> project deploy resume\". To check the status of the cancellation, run \"<%= config.bin %> project deploy report\".",
654
+ "api-version": {
655
+ "aliases": [
656
+ "apiversion"
657
+ ],
658
+ "deprecateAliases": true,
659
+ "description": "Override the api version used for api requests made by this command",
660
+ "name": "api-version",
661
+ "hasDynamicHelp": false,
662
+ "multiple": false,
663
+ "type": "option"
664
+ },
665
+ "loglevel": {
666
+ "deprecated": {
667
+ "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
668
+ },
669
+ "hidden": true,
670
+ "name": "loglevel",
671
+ "hasDynamicHelp": false,
672
+ "multiple": false,
673
+ "type": "option"
674
+ },
675
+ "target-org": {
676
+ "aliases": [
677
+ "targetusername",
678
+ "u"
679
+ ],
680
+ "char": "o",
681
+ "deprecateAliases": true,
682
+ "name": "target-org",
683
+ "noCacheDefault": true,
684
+ "required": true,
685
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
686
+ "hasDynamicHelp": true,
687
+ "multiple": false,
688
+ "type": "option"
689
+ },
690
+ "no-prompt": {
691
+ "aliases": [
692
+ "noprompt"
693
+ ],
694
+ "char": "p",
695
+ "deprecateAliases": true,
696
+ "name": "no-prompt",
697
+ "summary": "Don't prompt for source tracking override confirmation.",
698
+ "allowNo": false,
699
+ "type": "boolean"
700
+ }
701
+ },
702
+ "hasDynamicHelp": true,
703
+ "hiddenAliases": [],
704
+ "id": "project:delete:tracking",
705
+ "pluginAlias": "@salesforce/plugin-deploy-retrieve",
706
+ "pluginName": "@salesforce/plugin-deploy-retrieve",
707
+ "pluginType": "core",
708
+ "strict": true,
709
+ "summary": "Delete all local source tracking information.",
710
+ "enableJsonFlag": true,
711
+ "requiresProject": true,
712
+ "isESM": true,
713
+ "relativePath": [
714
+ "lib",
715
+ "commands",
716
+ "project",
717
+ "delete",
718
+ "tracking.js"
719
+ ],
720
+ "aliasPermutations": [
721
+ "force:source:tracking:clear",
722
+ "source:force:tracking:clear",
723
+ "source:tracking:force:clear",
724
+ "source:tracking:clear:force",
725
+ "force:tracking:source:clear",
726
+ "tracking:force:source:clear",
727
+ "tracking:source:force:clear",
728
+ "tracking:source:clear:force",
729
+ "force:tracking:clear:source",
730
+ "tracking:force:clear:source",
731
+ "tracking:clear:force:source",
732
+ "tracking:clear:source:force",
733
+ "force:source:clear:tracking",
734
+ "source:force:clear:tracking",
735
+ "source:clear:force:tracking",
736
+ "source:clear:tracking:force",
737
+ "force:clear:source:tracking",
738
+ "clear:force:source:tracking",
739
+ "clear:source:force:tracking",
740
+ "clear:source:tracking:force",
741
+ "force:clear:tracking:source",
742
+ "clear:force:tracking:source",
743
+ "clear:tracking:force:source",
744
+ "clear:tracking:source:force"
745
+ ],
746
+ "permutations": [
747
+ "project:delete:tracking",
748
+ "delete:project:tracking",
749
+ "delete:tracking:project",
750
+ "project:tracking:delete",
751
+ "tracking:project:delete",
752
+ "tracking:delete:project"
753
+ ]
754
+ },
755
+ "project:deploy:cancel": {
756
+ "aliases": [
757
+ "deploy:metadata:cancel"
758
+ ],
759
+ "args": {},
760
+ "deprecateAliases": true,
761
+ "description": "Use this command to cancel a deploy operation that hasn't yet completed in the org. Deploy operations include standard deploys, quick deploys, deploy validations, and deploy cancellations.\n\nRun this command by either passing it a job ID or specifying the --use-most-recent flag to use the job ID of the most recent deploy operation.",
762
+ "examples": [
763
+ "Cancel a deploy operation using a job ID:\n<%= config.bin %> <%= command.id %> --job-id 0Af0x000017yLUFCA2",
764
+ "Cancel the most recent deploy operation:\n<%= config.bin %> <%= command.id %> --use-most-recent"
765
+ ],
766
+ "flags": {
767
+ "json": {
768
+ "description": "Format output as json.",
769
+ "helpGroup": "GLOBAL",
770
+ "name": "json",
771
+ "allowNo": false,
772
+ "type": "boolean"
773
+ },
774
+ "flags-dir": {
775
+ "helpGroup": "GLOBAL",
776
+ "name": "flags-dir",
777
+ "summary": "Import flag values from a directory.",
778
+ "hasDynamicHelp": false,
779
+ "multiple": false,
780
+ "type": "option"
781
+ },
782
+ "target-org": {
783
+ "char": "o",
784
+ "name": "target-org",
785
+ "noCacheDefault": true,
786
+ "summary": "Username or alias of the target org.",
787
+ "hasDynamicHelp": true,
788
+ "multiple": false,
789
+ "type": "option"
790
+ },
791
+ "async": {
792
+ "description": "The command immediately returns the control of the terminal to you. This way, you can continue to use the CLI. To resume watching the cancellation, run \"<%= config.bin %> project deploy resume\". To check the status of the cancellation, run \"<%= config.bin %> project deploy report\".",
674
793
  "exclusive": [
675
794
  "wait"
676
795
  ],
@@ -2128,18 +2247,20 @@
2128
2247
  "validate:deploy:project"
2129
2248
  ]
2130
2249
  },
2131
- "project:delete:source": {
2250
+ "project:generate:manifest": {
2132
2251
  "aliases": [
2133
- "force:source:delete"
2252
+ "force:source:manifest:create"
2134
2253
  ],
2135
2254
  "args": {},
2136
2255
  "deprecateAliases": true,
2137
- "description": "Use this command to delete components from orgs that don’t have source tracking. To remove deleted items from orgs that have source tracking enabled, \"<%= config.bin %> project deploy start\".\n\nWhen you run this command, both the local source file and the metadata component in the org are deleted.\n\nTo delete multiple metadata components, either set multiple --metadata <name> flags or a single --metadata flag with multiple names separated by spaces. Enclose names that contain spaces in one set of double quotes. The same syntax applies to --source-dir.",
2256
+ "description": "Create a manifest from a list of metadata components (--metadata) or from one or more local directories that contain source files (--source-dir). You can specify either of these flags, not both.\n\nUse --type to specify the type of manifest you want to create. The resulting manifest files have specific names, such as the standard package.xml or destructiveChanges.xml to delete metadata. Valid values for this flag, and their respective file names, are:\n\n * package : package.xml (default)\n * pre : destructiveChangesPre.xml\n * post : destructiveChangesPost.xml\n * destroy : destructiveChanges.xml\n\nSee https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_deploy_deleting_files.htm for information about these destructive manifest files.\n\nUse --name to specify a custom name for the generated manifest if the pre-defined ones don’t suit your needs. You can specify either --type or --name, but not both.\n\nTo include multiple metadata components, either set multiple --metadata <name> flags or a single --metadata flag with multiple names separated by spaces. Enclose names that contain spaces in one set of double quotes. The same syntax applies to --include-packages and --source-dir.\n\nTo build a manifest from the metadata in an org, use the --from-org flag. You can combine --from-org with the --metadata flag to include only certain metadata types, or with the --excluded-metadata flag to exclude certain metadata types. When building a manifest from an org, the command makes many concurrent API calls to discover the metadata that exists in the org. To limit the number of concurrent requests, use the SF_LIST_METADATA_BATCH_SIZE environment variable and set it to a size that works best for your org and environment. If you experience timeouts or inconsistent manifest contents, then setting this environment variable can improve accuracy. However, the command takes longer to run because it sends fewer requests at a time.",
2138
2257
  "examples": [
2139
- "Delete all local Apex source files and all Apex classes from the org with alias \"my-scratch\":\n<%= config.bin %> <%= command.id %> --metadata ApexClass --target-org my-scratch",
2140
- "Delete a specific Apex class and a Profile that has a space in it from your default org; don't prompt for confirmation:\n<%= config.bin %> <%= command.id %> --metadata ApexClass:MyFabulousApexClass --metadata \"Profile: My Profile\" --no-prompt",
2141
- "Run the tests that aren’t in any managed packages as part of the deletion; if the delete succeeds, and the org has source-tracking enabled, update the source tracking information:\n<%= config.bin %> <%= command.id %> --metadata ApexClass --test-level RunLocalTests --track-source",
2142
- "Delete the Apex source files in a directory and the corresponding components from your default org:\n<%= config.bin %> <%= command.id %> --source-dir force-app/main/default/classes"
2258
+ "Create a manifest for deploying or retrieving all Apex classes and custom objects:\n$ <%= config.bin %> <%= command.id %> --metadata ApexClass --metadata CustomObject",
2259
+ "Create a manifest for deleting the specified Apex class:\n$ <%= config.bin %> <%= command.id %> --metadata ApexClass:MyApexClass --type destroy",
2260
+ "Create a manifest for deploying or retrieving all the metadata components in the specified local directory; name the file myNewManifest.xml:\n$ <%= config.bin %> <%= command.id %> --source-dir force-app --name myNewManifest",
2261
+ "Create a manifest from the metadata components in the specified org and include metadata in any unlocked packages:\n$ <%= config.bin %> <%= command.id %> --from-org test@myorg.com --include-packages unlocked",
2262
+ "Create a manifest from specific metadata types in an org:\n$ <%= config.bin %> <%= command.id %> --from-org test@myorg.com --metadata ApexClass,CustomObject,CustomLabels",
2263
+ "Create a manifest from all metadata components in an org excluding specific metadata types:\n$ <%= config.bin %> <%= command.id %> --from-org test@myorg.com --excluded-metadata StandardValueSet"
2143
2264
  ],
2144
2265
  "flags": {
2145
2266
  "json": {
@@ -2178,87 +2299,10 @@
2178
2299
  "multiple": false,
2179
2300
  "type": "option"
2180
2301
  },
2181
- "target-org": {
2182
- "aliases": [
2183
- "targetusername",
2184
- "u"
2185
- ],
2186
- "char": "o",
2187
- "deprecateAliases": true,
2188
- "name": "target-org",
2189
- "noCacheDefault": true,
2190
- "required": true,
2191
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
2192
- "hasDynamicHelp": true,
2193
- "multiple": false,
2194
- "type": "option"
2195
- },
2196
- "check-only": {
2197
- "aliases": [
2198
- "checkonly"
2199
- ],
2200
- "char": "c",
2201
- "deprecateAliases": true,
2202
- "description": "IMPORTANT: Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.\n\nValidates the deleted metadata and runs all Apex tests, but prevents the deletion from being saved to the org.\n\nIf you change a field type from Master-Detail to Lookup or vice versa, that change isn’t supported when using the --check-only flag to test a deletion (validation). This kind of change isn’t supported for test deletions to avoid the risk of data loss or corruption. If a change that isn’t supported for test deletions is included in a deletion package, the test deletion fails and issues an error.\n\nIf your deletion package changes a field type from Master-Detail to Lookup or vice versa, you can still validate the changes prior to deploying to Production by performing a full deletion to another test Sandbox. A full deletion includes a validation of the changes as part of the deletion process.\n\nNote: A Metadata API deletion that includes Master-Detail relationships deletes all detail records in the Recycle Bin in the following cases.\n\n 1. For a deletion with a new Master-Detail field, soft delete (send to the Recycle Bin) all detail records before proceeding to delete the Master-Detail field, or the deletion fails. During the deletion, detail records are permanently deleted from the Recycle Bin and cannot be recovered.\n\n 2. For a deletion that converts a Lookup field relationship to a Master-Detail relationship, detail records must reference a master record or be soft-deleted (sent to the Recycle Bin) for the deletion to succeed. However, a successful deletion permanently deletes any detail records in the Recycle Bin.",
2203
- "name": "check-only",
2204
- "summary": "Validate delete command but don't delete anything from the org or the local project.",
2205
- "allowNo": false,
2206
- "type": "boolean"
2207
- },
2208
- "wait": {
2209
- "char": "w",
2210
- "description": "If the command continues to run after the wait period, the CLI returns control of the terminal window to you.",
2211
- "name": "wait",
2212
- "summary": "Number of minutes to wait for the command to finish.",
2213
- "hasDynamicHelp": true,
2214
- "multiple": false,
2215
- "type": "option"
2216
- },
2217
- "tests": {
2218
- "description": "If a test name contains a space, enclose it in double quotes.\nFor multiple test names, use one of the following formats:\n\n- Repeat the flag for multiple test names: --tests Test1 --tests Test2 --tests \"Test With Space\"\n- Separate the test names with spaces: --tests Test1 Test2 \"Test With Space\"",
2219
- "helpGroup": "Test",
2220
- "name": "tests",
2221
- "summary": "Apex tests to run when --test-level is RunSpecifiedTests.",
2222
- "hasDynamicHelp": false,
2223
- "multiple": true,
2224
- "type": "option"
2225
- },
2226
- "test-level": {
2227
- "aliases": [
2228
- "testlevel"
2229
- ],
2230
- "char": "l",
2231
- "deprecateAliases": true,
2232
- "description": "Valid values are:\n\n- NoTestRun — No tests are run. This test level applies only to deployments to development environments, such as sandbox, Developer Edition, or trial orgs. This test level is the default for development environments.\n\n- RunSpecifiedTests — Runs only the tests that you specify with the --tests flag. Code coverage requirements differ from the default coverage requirements when using this test level. Executed tests must comprise a minimum of 75% code coverage for each class and trigger in the deployment package. This coverage is computed for each class and trigger individually and is different than the overall coverage percentage.\n\n- RunLocalTests — All tests in your org are run, except the ones that originate from installed managed and unlocked packages. This test level is the default for production deployments that include Apex classes or triggers.\n\n- RunAllTestsInOrg — All tests in your org are run, including tests of managed packages.\n\nIf you don’t specify a test level, the default behavior depends on the contents of your deployment package and target org. For more information, see “Running Tests in a Deployment” in the Metadata API Developer Guide.",
2233
- "helpGroup": "Test",
2234
- "name": "test-level",
2235
- "summary": "Deployment Apex testing level.",
2236
- "hasDynamicHelp": false,
2237
- "multiple": false,
2238
- "options": [
2239
- "NoTestRun",
2240
- "RunSpecifiedTests",
2241
- "RunLocalTests",
2242
- "RunAllTestsInOrg"
2243
- ],
2244
- "type": "option"
2245
- },
2246
- "no-prompt": {
2247
- "aliases": [
2248
- "noprompt"
2249
- ],
2250
- "char": "r",
2251
- "deprecateAliases": true,
2252
- "name": "no-prompt",
2253
- "summary": "Don't prompt for delete confirmation.",
2254
- "allowNo": false,
2255
- "type": "boolean"
2256
- },
2257
2302
  "metadata": {
2258
2303
  "char": "m",
2259
- "description": "If you specify this flag, don’t specify --source-dir.",
2260
2304
  "name": "metadata",
2261
- "summary": "Metadata components to delete.",
2305
+ "summary": "Names of metadata components to include in the manifest.",
2262
2306
  "delimiter": ",",
2263
2307
  "hasDynamicHelp": false,
2264
2308
  "multiple": true,
@@ -2270,166 +2314,122 @@
2270
2314
  ],
2271
2315
  "char": "p",
2272
2316
  "deprecateAliases": true,
2273
- "description": "The supplied paths can be a single file (in which case the operation is applied to only one file) or a folder (in which case the operation is applied to all metadata types in the directory and its sub-directories).\n\nIf you specify this flag, don’t specify --metadata.",
2274
2317
  "name": "source-dir",
2275
- "summary": "Source file paths to delete.",
2318
+ "summary": "Paths to the local source files to include in the manifest.",
2276
2319
  "delimiter": ",",
2277
2320
  "hasDynamicHelp": false,
2278
2321
  "multiple": true,
2279
2322
  "type": "option"
2280
2323
  },
2281
- "track-source": {
2324
+ "name": {
2282
2325
  "aliases": [
2283
- "tracksource"
2326
+ "manifestname"
2284
2327
  ],
2285
- "char": "t",
2328
+ "char": "n",
2286
2329
  "deprecateAliases": true,
2287
2330
  "exclusive": [
2288
- "check-only"
2331
+ "type"
2289
2332
  ],
2290
- "name": "track-source",
2291
- "summary": "If the delete succeeds, update the source tracking information.",
2292
- "allowNo": false,
2293
- "type": "boolean"
2333
+ "name": "name",
2334
+ "summary": "Name of a custom manifest file to create.",
2335
+ "hasDynamicHelp": false,
2336
+ "multiple": false,
2337
+ "type": "option"
2294
2338
  },
2295
- "force-overwrite": {
2339
+ "type": {
2296
2340
  "aliases": [
2297
- "forceoverwrite"
2298
- ],
2299
- "char": "f",
2300
- "dependsOn": [
2301
- "track-source"
2341
+ "manifesttype"
2302
2342
  ],
2343
+ "char": "t",
2303
2344
  "deprecateAliases": true,
2304
- "name": "force-overwrite",
2305
- "summary": "Ignore conflict warnings and overwrite changes to the org.",
2306
- "allowNo": false,
2307
- "type": "boolean"
2308
- },
2309
- "verbose": {
2310
- "name": "verbose",
2311
- "summary": "Verbose output of the delete result.",
2312
- "allowNo": false,
2313
- "type": "boolean"
2314
- }
2315
- },
2316
- "hasDynamicHelp": true,
2317
- "hiddenAliases": [],
2318
- "id": "project:delete:source",
2319
- "pluginAlias": "@salesforce/plugin-deploy-retrieve",
2320
- "pluginName": "@salesforce/plugin-deploy-retrieve",
2321
- "pluginType": "core",
2322
- "strict": true,
2323
- "summary": "Delete source from your project and from a non-source-tracked org.",
2324
- "enableJsonFlag": true,
2325
- "requiresProject": true,
2326
- "isESM": true,
2327
- "relativePath": [
2328
- "lib",
2329
- "commands",
2330
- "project",
2331
- "delete",
2332
- "source.js"
2333
- ],
2334
- "aliasPermutations": [
2335
- "force:source:delete",
2336
- "source:force:delete",
2337
- "source:delete:force",
2338
- "force:delete:source",
2339
- "delete:force:source",
2340
- "delete:source:force"
2341
- ],
2342
- "permutations": [
2343
- "project:delete:source",
2344
- "delete:project:source",
2345
- "delete:source:project",
2346
- "project:source:delete",
2347
- "source:project:delete",
2348
- "source:delete:project"
2349
- ]
2350
- },
2351
- "project:delete:tracking": {
2352
- "aliases": [
2353
- "force:source:tracking:clear"
2354
- ],
2355
- "args": {},
2356
- "deprecateAliases": true,
2357
- "description": "WARNING: This command deletes or overwrites all existing source tracking files. Use with extreme caution.\n\nDeletes all local source tracking information. When you next run 'project deploy preview', Salesforce CLI displays all local and remote files as changed, and any files with the same name are listed as conflicts.",
2358
- "examples": [
2359
- "Delete local source tracking for the org with alias \"my-scratch\":\n$ <%= config.bin %> <%= command.id %> --target-org my-scratch"
2360
- ],
2361
- "flags": {
2362
- "json": {
2363
- "description": "Format output as json.",
2364
- "helpGroup": "GLOBAL",
2365
- "name": "json",
2366
- "allowNo": false,
2367
- "type": "boolean"
2368
- },
2369
- "flags-dir": {
2370
- "helpGroup": "GLOBAL",
2371
- "name": "flags-dir",
2372
- "summary": "Import flag values from a directory.",
2345
+ "exclusive": [
2346
+ "name"
2347
+ ],
2348
+ "name": "type",
2349
+ "summary": "Type of manifest to create; the type determines the name of the created file.",
2373
2350
  "hasDynamicHelp": false,
2374
2351
  "multiple": false,
2352
+ "options": [
2353
+ "pre",
2354
+ "post",
2355
+ "destroy",
2356
+ "package"
2357
+ ],
2375
2358
  "type": "option"
2376
2359
  },
2377
- "api-version": {
2360
+ "include-packages": {
2378
2361
  "aliases": [
2379
- "apiversion"
2362
+ "includepackages"
2363
+ ],
2364
+ "char": "c",
2365
+ "dependsOn": [
2366
+ "from-org"
2380
2367
  ],
2381
2368
  "deprecateAliases": true,
2382
- "description": "Override the api version used for api requests made by this command",
2383
- "name": "api-version",
2369
+ "name": "include-packages",
2370
+ "summary": "Package types (managed, unlocked) whose metadata is included in the manifest; by default, metadata in managed and unlocked packages is excluded. Metadata in unmanaged packages is always included.",
2371
+ "delimiter": ",",
2384
2372
  "hasDynamicHelp": false,
2385
- "multiple": false,
2373
+ "multiple": true,
2374
+ "options": [
2375
+ "managed",
2376
+ "unlocked"
2377
+ ],
2386
2378
  "type": "option"
2387
2379
  },
2388
- "loglevel": {
2389
- "deprecated": {
2390
- "message": "The loglevel flag is no longer in use on this command. You may use it without error, but it will be ignored.\nSet the log level using the `SFDX_LOG_LEVEL` environment variable."
2391
- },
2392
- "hidden": true,
2393
- "name": "loglevel",
2380
+ "excluded-metadata": {
2381
+ "name": "excluded-metadata",
2382
+ "relationships": [
2383
+ {
2384
+ "type": "some",
2385
+ "flags": [
2386
+ "from-org",
2387
+ "source-dir"
2388
+ ]
2389
+ }
2390
+ ],
2391
+ "summary": "Metadata types to exclude when building a manifest from an org. Specify the name of the type, not the name of a specific component.",
2392
+ "delimiter": ",",
2394
2393
  "hasDynamicHelp": false,
2395
- "multiple": false,
2394
+ "multiple": true,
2396
2395
  "type": "option"
2397
2396
  },
2398
- "target-org": {
2397
+ "from-org": {
2399
2398
  "aliases": [
2400
- "targetusername",
2401
- "u"
2399
+ "fromorg"
2402
2400
  ],
2403
- "char": "o",
2404
2401
  "deprecateAliases": true,
2405
- "name": "target-org",
2406
- "noCacheDefault": true,
2407
- "required": true,
2408
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
2409
- "hasDynamicHelp": true,
2402
+ "exclusive": [
2403
+ "source-dir"
2404
+ ],
2405
+ "name": "from-org",
2406
+ "summary": "Username or alias of the org that contains the metadata components from which to build a manifest.",
2407
+ "hasDynamicHelp": false,
2410
2408
  "multiple": false,
2411
2409
  "type": "option"
2412
2410
  },
2413
- "no-prompt": {
2411
+ "output-dir": {
2414
2412
  "aliases": [
2415
- "noprompt"
2413
+ "outputdir",
2414
+ "o"
2416
2415
  ],
2417
- "char": "p",
2416
+ "char": "d",
2418
2417
  "deprecateAliases": true,
2419
- "name": "no-prompt",
2420
- "summary": "Don't prompt for source tracking override confirmation.",
2421
- "allowNo": false,
2422
- "type": "boolean"
2418
+ "name": "output-dir",
2419
+ "summary": "Directory to save the created manifest.",
2420
+ "hasDynamicHelp": false,
2421
+ "multiple": false,
2422
+ "type": "option"
2423
2423
  }
2424
2424
  },
2425
- "hasDynamicHelp": true,
2425
+ "hasDynamicHelp": false,
2426
2426
  "hiddenAliases": [],
2427
- "id": "project:delete:tracking",
2427
+ "id": "project:generate:manifest",
2428
2428
  "pluginAlias": "@salesforce/plugin-deploy-retrieve",
2429
2429
  "pluginName": "@salesforce/plugin-deploy-retrieve",
2430
2430
  "pluginType": "core",
2431
2431
  "strict": true,
2432
- "summary": "Delete all local source tracking information.",
2432
+ "summary": "Create a project manifest that lists the metadata components you want to deploy or retrieve.",
2433
2433
  "enableJsonFlag": true,
2434
2434
  "requiresProject": true,
2435
2435
  "isESM": true,
@@ -2437,42 +2437,42 @@
2437
2437
  "lib",
2438
2438
  "commands",
2439
2439
  "project",
2440
- "delete",
2441
- "tracking.js"
2440
+ "generate",
2441
+ "manifest.js"
2442
2442
  ],
2443
2443
  "aliasPermutations": [
2444
- "force:source:tracking:clear",
2445
- "source:force:tracking:clear",
2446
- "source:tracking:force:clear",
2447
- "source:tracking:clear:force",
2448
- "force:tracking:source:clear",
2449
- "tracking:force:source:clear",
2450
- "tracking:source:force:clear",
2451
- "tracking:source:clear:force",
2452
- "force:tracking:clear:source",
2453
- "tracking:force:clear:source",
2454
- "tracking:clear:force:source",
2455
- "tracking:clear:source:force",
2456
- "force:source:clear:tracking",
2457
- "source:force:clear:tracking",
2458
- "source:clear:force:tracking",
2459
- "source:clear:tracking:force",
2460
- "force:clear:source:tracking",
2461
- "clear:force:source:tracking",
2462
- "clear:source:force:tracking",
2463
- "clear:source:tracking:force",
2464
- "force:clear:tracking:source",
2465
- "clear:force:tracking:source",
2466
- "clear:tracking:force:source",
2467
- "clear:tracking:source:force"
2444
+ "force:source:manifest:create",
2445
+ "source:force:manifest:create",
2446
+ "source:manifest:force:create",
2447
+ "source:manifest:create:force",
2448
+ "force:manifest:source:create",
2449
+ "manifest:force:source:create",
2450
+ "manifest:source:force:create",
2451
+ "manifest:source:create:force",
2452
+ "force:manifest:create:source",
2453
+ "manifest:force:create:source",
2454
+ "manifest:create:force:source",
2455
+ "manifest:create:source:force",
2456
+ "force:source:create:manifest",
2457
+ "source:force:create:manifest",
2458
+ "source:create:force:manifest",
2459
+ "source:create:manifest:force",
2460
+ "force:create:source:manifest",
2461
+ "create:force:source:manifest",
2462
+ "create:source:force:manifest",
2463
+ "create:source:manifest:force",
2464
+ "force:create:manifest:source",
2465
+ "create:force:manifest:source",
2466
+ "create:manifest:force:source",
2467
+ "create:manifest:source:force"
2468
2468
  ],
2469
2469
  "permutations": [
2470
- "project:delete:tracking",
2471
- "delete:project:tracking",
2472
- "delete:tracking:project",
2473
- "project:tracking:delete",
2474
- "tracking:project:delete",
2475
- "tracking:delete:project"
2470
+ "project:generate:manifest",
2471
+ "generate:project:manifest",
2472
+ "generate:manifest:project",
2473
+ "project:manifest:generate",
2474
+ "manifest:project:generate",
2475
+ "manifest:generate:project"
2476
2476
  ]
2477
2477
  },
2478
2478
  "project:list:ignored": {
@@ -3051,5 +3051,5 @@
3051
3051
  ]
3052
3052
  }
3053
3053
  },
3054
- "version": "3.22.5"
3054
+ "version": "3.22.7"
3055
3055
  }
package/package.json CHANGED
@@ -1,17 +1,17 @@
1
1
  {
2
2
  "name": "@salesforce/plugin-deploy-retrieve",
3
3
  "description": "deploy and retrieve commands for sf",
4
- "version": "3.22.5",
4
+ "version": "3.22.7",
5
5
  "author": "Salesforce",
6
6
  "bugs": "https://github.com/forcedotcom/cli/issues",
7
7
  "dependencies": {
8
8
  "@inquirer/prompts": "^7.4.1",
9
9
  "@oclif/core": "^4.2.10",
10
10
  "@oclif/multi-stage-output": "^0.8.12",
11
- "@salesforce/apex-node": "^8.1.19",
11
+ "@salesforce/apex-node": "^8.1.24",
12
12
  "@salesforce/core": "^8.8.7",
13
13
  "@salesforce/kit": "^3.2.3",
14
- "@salesforce/plugin-info": "^3.4.51",
14
+ "@salesforce/plugin-info": "^3.4.56",
15
15
  "@salesforce/sf-plugins-core": "^12.2.1",
16
16
  "@salesforce/source-deploy-retrieve": "^12.19.2",
17
17
  "@salesforce/source-tracking": "^7.3.20",
@@ -255,7 +255,7 @@
255
255
  "exports": "./lib/index.js",
256
256
  "type": "module",
257
257
  "sfdx": {
258
- "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-deploy-retrieve/3.22.5.crt",
259
- "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-deploy-retrieve/3.22.5.sig"
258
+ "publicKeyUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-deploy-retrieve/3.22.7.crt",
259
+ "signatureUrl": "https://developer.salesforce.com/media/salesforce-cli/security/@salesforce/plugin-deploy-retrieve/3.22.7.sig"
260
260
  }
261
261
  }