sfdx-hardis 6.0.2-beta202508110129.0 → 6.0.2-beta202508111754.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +3 -3
  3. package/lib/commands/hardis/org/configure/data.js +19 -5
  4. package/lib/commands/hardis/org/configure/data.js.map +1 -1
  5. package/lib/commands/hardis/org/configure/files.js +6 -1
  6. package/lib/commands/hardis/org/configure/files.js.map +1 -1
  7. package/lib/commands/hardis/org/generate/packagexmlfull.js +11 -2
  8. package/lib/commands/hardis/org/generate/packagexmlfull.js.map +1 -1
  9. package/lib/commands/hardis/org/select.js +1 -1
  10. package/lib/commands/hardis/project/clean/references.js +3 -4
  11. package/lib/commands/hardis/project/clean/references.js.map +1 -1
  12. package/lib/commands/hardis/scratch/pull.js +1 -0
  13. package/lib/commands/hardis/scratch/pull.js.map +1 -1
  14. package/lib/commands/hardis/work/new.js +20 -20
  15. package/lib/commands/hardis/work/new.js.map +1 -1
  16. package/lib/commands/hardis/work/refresh.js +2 -2
  17. package/lib/commands/hardis/work/refresh.js.map +1 -1
  18. package/lib/commands/hardis/work/save.js +14 -14
  19. package/lib/commands/hardis/work/save.js.map +1 -1
  20. package/lib/common/utils/deployUtils.js +18 -6
  21. package/lib/common/utils/deployUtils.js.map +1 -1
  22. package/lib/common/utils/gitUtils.js +27 -5
  23. package/lib/common/utils/gitUtils.js.map +1 -1
  24. package/lib/common/utils/index.d.ts +1 -1
  25. package/lib/common/utils/index.js +26 -10
  26. package/lib/common/utils/index.js.map +1 -1
  27. package/lib/common/utils/orgUtils.js +1 -1
  28. package/lib/common/utils/orgUtils.js.map +1 -1
  29. package/lib/common/utils/prompts.js +3 -3
  30. package/lib/common/utils/prompts.js.map +1 -1
  31. package/lib/common/utils/xmlUtils.js +1 -4
  32. package/lib/common/utils/xmlUtils.js.map +1 -1
  33. package/lib/common/websocketClient.js +2 -1
  34. package/lib/common/websocketClient.js.map +1 -1
  35. package/messages/org.md +2 -2
  36. package/oclif.manifest.json +1033 -1026
  37. package/package.json +1 -1
@@ -3914,7 +3914,7 @@
3914
3914
  "hardis:work:new": {
3915
3915
  "aliases": [],
3916
3916
  "args": {},
3917
- "description": "\n## Command Behavior\n\n**Assisted menu to start working on a Salesforce task, streamlining the setup of your development environment.**\n\nThis command guides you through the process of preparing your local environment and a Salesforce org for a new development or configuration task. It automates several steps, ensuring consistency and adherence to project standards.\n\nKey features include:\n\n- **Git Branch Management:** Ensures your local Git repository is up-to-date with the target branch and creates a new Git branch with a formatted name based on your task details. Branch naming conventions can be customized via the `branchPrefixChoices` property in `.sfdx-hardis.yml`.\n- **Org Provisioning & Initialization:** Facilitates the creation and initialization of either a scratch org or a source-tracked sandbox. The configuration for org initialization (e.g., package installation, source push, permission set assignments, Apex script execution, data loading) can be defined in `config/.sfdx-hardis.yml- **Project-Specific Configuration:** Supports defining multiple target branches (`availableTargetBranches`) and projects (`availableProjects`) in `.sfdx-hardis.yml`, allowing for tailored task workflows.\n- **Task Name Validation:** Enforces task name formatting using `newTaskNameRegex` and provides examples via `newTaskNameRegexExample- **Shared Development Sandboxes:** Accounts for scenarios with shared development sandboxes, adjusting prompts to prevent accidental overwrites.\n\nAdvanced instructions are available in the [Create New Task documentation](https://sfdx-hardis.cloudity.com/salesforce-ci-cd-create-new-task/).\n\n## Technical explanations\n\nThe command's logic orchestrates various underlying processes:\n\n- **Git Operations:** Utilizes `checkGitClean`, `ensureGitBranch`, `gitCheckOutRemote`, and `git().pull()` to manage Git repository state and branches.\n- **Interactive Prompts:** Leverages the `prompts` library to gather user input for task type, source types, and task names.\n- **Configuration Management:** Reads and applies project-specific configurations from `.sfdx-hardis.yml` using `getConfig` and `setConfig- **Org Initialization Utilities:** Calls a suite of utility functions for org setup, including `initApexScripts`, `initOrgData`, `initOrgMetadatas`, `initPermissionSetAssignments`, `installPackages`, and `makeSureOrgIsConnected- **Salesforce CLI Interaction:** Executes Salesforce CLI commands (e.g., `sf config set target-org`, `sf org open`, `sf project delete tracking`) via `execCommand` and `execSfdxJson- **Dynamic Org Selection:** Presents choices for scratch orgs or sandboxes based on project configuration and existing orgs, dynamically calling `ScratchCreate.run` or `SandboxCreate.run` as needed.\n- **WebSocket Communication:** Sends refresh status messages via `WebSocketClient.sendRefreshStatusMessage()` to update connected VS Code clients.\n",
3917
+ "description": "\n## Command Behavior\n\n**Assisted menu to start working on a Salesforce User Story, streamlining the setup of your development environment.**\n\nThis command guides you through the process of preparing your local environment and a Salesforce org for a new development or configuration based User Story. It automates several steps, ensuring consistency and adherence to project standards.\n\nKey features include:\n\n- **Git Branch Management:** Ensures your local Git repository is up-to-date with the target branch and creates a new Git branch with a formatted name based on your User Story details. Branch naming conventions can be customized via the `branchPrefixChoices` property in `.sfdx-hardis.yml`.\n- **Org Provisioning & Initialization:** Facilitates the creation and initialization of either a scratch org or a source-tracked sandbox. The configuration for org initialization (e.g., package installation, source push, permission set assignments, Apex script execution, data loading) can be defined in `config/.sfdx-hardis.yml- **Project-Specific Configuration:** Supports defining multiple target branches (`availableTargetBranches`) and projects (`availableProjects`) in `.sfdx-hardis.yml`, allowing for tailored User Stories workflows.\n- **User Story Name Validation:** Enforces User Story name formatting using `newTaskNameRegex` and provides examples via `newTaskNameRegexExample- **Shared Development Sandboxes:** Accounts for scenarios with shared development sandboxes, adjusting prompts to prevent accidental overwrites.\n\nAdvanced instructions are available in the [Create New User Story documentation](https://sfdx-hardis.cloudity.com/salesforce-ci-cd-create-new-task/).\n\n## Technical explanations\n\nThe command's logic orchestrates various underlying processes:\n\n- **Git Operations:** Utilizes `checkGitClean`, `ensureGitBranch`, `gitCheckOutRemote`, and `git().pull()` to manage Git repository state and branches.\n- **Interactive Prompts:** Leverages the `prompts` library to gather user input for User Story type, source types, and User Story names.\n- **Configuration Management:** Reads and applies project-specific configurations from `.sfdx-hardis.yml` using `getConfig` and `setConfig- **Org Initialization Utilities:** Calls a suite of utility functions for org setup, including `initApexScripts`, `initOrgData`, `initOrgMetadatas`, `initPermissionSetAssignments`, `installPackages`, and `makeSureOrgIsConnected- **Salesforce CLI Interaction:** Executes Salesforce CLI commands (e.g., `sf config set target-org`, `sf org open`, `sf project delete tracking`) via `execCommand` and `execSfdxJson- **Dynamic Org Selection:** Presents choices for scratch orgs or sandboxes based on project configuration and existing orgs, dynamically calling `ScratchCreate.run` or `SandboxCreate.run` as needed.\n- **WebSocket Communication:** Sends refresh status messages via `WebSocketClient.sendRefreshStatusMessage()` to update connected VS Code clients.\n",
3918
3918
  "examples": [
3919
3919
  "$ sf hardis:work:new"
3920
3920
  ],
@@ -3991,7 +3991,7 @@
3991
3991
  "pluginType": "core",
3992
3992
  "strict": true,
3993
3993
  "enableJsonFlag": true,
3994
- "title": "New work task",
3994
+ "title": "New User Story",
3995
3995
  "requiresProject": true,
3996
3996
  "isESM": true,
3997
3997
  "relativePath": [
@@ -4085,7 +4085,7 @@
4085
4085
  "pluginType": "core",
4086
4086
  "strict": true,
4087
4087
  "enableJsonFlag": true,
4088
- "title": "Refresh work task",
4088
+ "title": "Refresh User Story branch",
4089
4089
  "requiresProject": true,
4090
4090
  "isESM": true,
4091
4091
  "relativePath": [
@@ -4195,7 +4195,7 @@
4195
4195
  "hardis:work:save": {
4196
4196
  "aliases": [],
4197
4197
  "args": {},
4198
- "description": "\n## Command Behavior\n\n**Guides the user through the process of saving their work, preparing it for a Merge Request (also named Pull Request), and pushing changes to the remote Git repository.**\n\nThis command automates several critical steps involved in finalizing a development task and integrating it into the main codebase. It ensures that your local changes are properly synchronized, cleaned, and committed before being pushed.\n\nKey functionalities include:\n\n- **Git Status Management:** Ensures a clean Git working directory by handling ongoing merges and unstaging files.\n- **Org Synchronization (Optional):** Prompts the user to pull the latest metadata updates from their scratch org or source-tracked sandbox, ensuring local files reflect the org's state.\n- **Package.xml Updates:** Automatically generates `package.xml` and `destructiveChanges.xml` files based on the Git delta between your current branch and the target branch, reflecting added, modified, and deleted metadata.\n- **Automated Source Cleaning:** Applies predefined cleaning operations to your local Salesforce sources, such as removing unwanted references, minimizing profiles, or cleaning XML files based on configurations in your `.sfdx-hardis.yml`.\n - `autoCleanTypes`: A list of automated source cleanings, configurable via [hardis:project:clean:references](${CONSTANTS.DOC_URL_ROOT}/hardis/project/clean/references/).\n - `autoRemoveUserPermissions`: A list of user permissions to automatically remove from profile metadata.\n- **Deployment Plan Generation:** Builds an automated deployment plan based on the updated `package.xml` and configured deployment splits.\n- **Commit and Push:** Guides the user to commit the changes and push them to the remote Git repository, optionally handling force pushes if a branch reset occurred.\n- **Merge Request Guidance:** Provides information and links to facilitate the creation of a merge request after the changes are pushed.\n\nExample `.sfdx-hardis.yml` configuration:\n\n```yaml\nautoCleanTypes:\n - checkPermissions\n - destructivechanges\n - datadotcom\n - minimizeProfiles\n - listViewsMine\nautoRemoveUserPermissions:\n - EnableCommunityAppLauncher\n - FieldServiceAccess\n - OmnichannelInventorySync\n - SendExternalEmailAvailable\n - UseOmnichannelInventoryAPIs\n - ViewDataLeakageEvents\n - ViewMLModels\n - ViewPlatformEvents\n - WorkCalibrationUser\n```\n\nAdvanced instructions are available in the [Publish a task documentation](${CONSTANTS.DOC_URL_ROOT}/salesforce-ci-cd-publish-task/).\n\n## Technical explanations\n\nThe command's technical implementation involves a series of orchestrated steps:\n\n- **Git Integration:** Extensively uses the `git` utility for status checks, adding files, committing, and pushing. It also leverages `sfdx-git-delta` for generating metadata differences between Git revisions.\n- **Interactive Prompts:** Employs the `prompts` library to interact with the user for decisions like pulling sources or pushing commits.\n- **Configuration Management:** Reads and updates project and user configurations using `getConfig` and `setConfig` to store preferences and deployment plans.\n- **Metadata Synchronization:** Calls `forceSourcePull` to retrieve metadata from the org and `callSfdxGitDelta` to generate `package.xml` and `destructiveChanges.xml` based on Git changes.\n- **XML Manipulation:** Utilizes `appendPackageXmlFilesContent`, `removePackageXmlFilesContent`, `parseXmlFile`, and `writeXmlFile` for modifying `package.xml` and `destructiveChanges.xml` files.\n- **Automated Cleaning:** Integrates with `CleanReferences.run` and `CleanXml.run` commands to perform automated cleaning operations on the Salesforce source files.\n- **Deployment Plan Building:** Dynamically constructs a deployment plan by analyzing the `package.xml` content and applying configured deployment splits.\n- **WebSocket Communication:** Uses `WebSocketClient.sendRefreshStatusMessage` to notify connected VS Code clients about status updates.\n- **External Tool Integration:** Requires the `sfdx-git-delta` plugin to be installed for its core functionality.\n",
4198
+ "description": "\n## Command Behavior\n\n**Guides the user through the process of saving their work, preparing it for a Merge Request (also named Pull Request), and pushing changes to the remote Git repository.**\n\nThis command automates several critical steps involved in finalizing a development User Story and integrating it into the main codebase. It ensures that your local changes are properly synchronized, cleaned, and committed before being pushed.\n\nKey functionalities include:\n\n- **Git Status Management:** Ensures a clean Git working directory by handling ongoing merges and unstaging files.\n- **Org Synchronization (Optional):** Prompts the user to pull the latest metadata updates from their scratch org or source-tracked sandbox, ensuring local files reflect the org's state.\n- **Package.xml Updates:** Automatically generates `package.xml` and `destructiveChanges.xml` files based on the Git delta between your current branch and the target branch, reflecting added, modified, and deleted metadata.\n- **Automated Source Cleaning:** Applies predefined cleaning operations to your local Salesforce sources, such as removing unwanted references, minimizing profiles, or cleaning XML files based on configurations in your `.sfdx-hardis.yml`.\n - `autoCleanTypes`: A list of automated source cleanings, configurable via [hardis:project:clean:references](${CONSTANTS.DOC_URL_ROOT}/hardis/project/clean/references/).\n - `autoRemoveUserPermissions`: A list of user permissions to automatically remove from profile metadata.\n- **Deployment Plan Generation:** Builds an automated deployment plan based on the updated `package.xml` and configured deployment splits.\n- **Commit and Push:** Guides the user to commit the changes and push them to the remote Git repository, optionally handling force pushes if a branch reset occurred.\n- **Merge Request Guidance:** Provides information and links to facilitate the creation of a merge request after the changes are pushed.\n\nExample `.sfdx-hardis.yml` configuration:\n\n```yaml\nautoCleanTypes:\n - checkPermissions\n - destructivechanges\n - datadotcom\n - minimizeProfiles\n - listViewsMine\nautoRemoveUserPermissions:\n - EnableCommunityAppLauncher\n - FieldServiceAccess\n - OmnichannelInventorySync\n - SendExternalEmailAvailable\n - UseOmnichannelInventoryAPIs\n - ViewDataLeakageEvents\n - ViewMLModels\n - ViewPlatformEvents\n - WorkCalibrationUser\n```\n\nAdvanced instructions are available in the [Publish a User Story documentation](${CONSTANTS.DOC_URL_ROOT}/salesforce-ci-cd-publish-task/).\n\n## Technical explanations\n\nThe command's technical implementation involves a series of orchestrated steps:\n\n- **Git Integration:** Extensively uses the `git` utility for status checks, adding files, committing, and pushing. It also leverages `sfdx-git-delta` for generating metadata differences between Git revisions.\n- **Interactive Prompts:** Employs the `prompts` library to interact with the user for decisions like pulling sources or pushing commits.\n- **Configuration Management:** Reads and updates project and user configurations using `getConfig` and `setConfig` to store preferences and deployment plans.\n- **Metadata Synchronization:** Calls `forceSourcePull` to retrieve metadata from the org and `callSfdxGitDelta` to generate `package.xml` and `destructiveChanges.xml` based on Git changes.\n- **XML Manipulation:** Utilizes `appendPackageXmlFilesContent`, `removePackageXmlFilesContent`, `parseXmlFile`, and `writeXmlFile` for modifying `package.xml` and `destructiveChanges.xml` files.\n- **Automated Cleaning:** Integrates with `CleanReferences.run` and `CleanXml.run` commands to perform automated cleaning operations on the Salesforce source files.\n- **Deployment Plan Building:** Dynamically constructs a deployment plan by analyzing the `package.xml` content and applying configured deployment splits.\n- **WebSocket Communication:** Uses `WebSocketClient.sendRefreshStatusMessage` to notify connected VS Code clients about status updates.\n- **External Tool Integration:** Requires the `sfdx-git-delta` plugin to be installed for its core functionality.\n",
4199
4199
  "examples": [
4200
4200
  "$ sf hardis:work:task:save",
4201
4201
  "$ sf hardis:work:task:save --nopull --nogit --noclean"
@@ -4294,7 +4294,7 @@
4294
4294
  "pluginType": "core",
4295
4295
  "strict": true,
4296
4296
  "enableJsonFlag": true,
4297
- "title": "Save work task",
4297
+ "title": "Save User Story",
4298
4298
  "requiresProject": true,
4299
4299
  "requiresSfdxPlugins": [
4300
4300
  "sfdx-git-delta"
@@ -4719,117 +4719,6 @@
4719
4719
  "extract:pull-requests:git:hardis"
4720
4720
  ]
4721
4721
  },
4722
- "hardis:org:community:update": {
4723
- "aliases": [],
4724
- "args": {},
4725
- "description": "\n## Command Behavior\n\n**Updates the status of one or more Salesforce Experience Cloud (Community) networks.**\n\nThis command provides a way to programmatically change the status of your Salesforce Communities, allowing you to manage their availability. This is particularly useful for:\n\n- **Maintenance:** Taking communities offline for planned maintenance (`DownForMaintenance`).\n- **Activation/Deactivation:** Bringing communities online or offline (`Live`, `DownForMaintenance`).\n- **Automation:** Integrating community status changes into CI/CD pipelines or scheduled jobs.\n\nKey functionalities:\n\n- **Network Selection:** You can specify one or more community network names (separated by commas) using the `--name` flag.\n- **Status Update:** You can set the new status for the selected communities using the `--status` flag. Supported values are `Live` and `DownForMaintenance`.\n- **Confirmation Prompt:** In non-CI environments, it provides a confirmation prompt before executing the update, ensuring intentional changes.\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **Salesforce SOQL Query:** It first queries the Salesforce `Network` object using SOQL to retrieve the `Id`, `Name`, and `Status` of the specified communities. This ensures that only existing communities are targeted.\n- **SObject Update:** It then constructs an array of `Network` sObjects with their `Id` and the new `Status` and performs a DML update operation using `conn.sobject(\"Network\").update()`. The `allOrNone: false` option is used to allow partial success in case some updates fail.\n- **Error Handling and Reporting:** It iterates through the update results, logging success or failure for each community. It also provides a summary of successful and erroneous updates.\n- **User Interaction:** Uses `prompts` to confirm the update action with the user when not running in a CI environment.\n- **Salesforce Connection:** Establishes a connection to the target Salesforce org using the `target-org` flag.\n",
4726
- "examples": [
4727
- "$ sf hardis:org:community:update --name 'MyNetworkName' --status DownForMaintenance",
4728
- "$ sf hardis:org:community:update --name 'MyNetworkName,MySecondNetworkName' --status Live"
4729
- ],
4730
- "flags": {
4731
- "json": {
4732
- "description": "Format output as json.",
4733
- "helpGroup": "GLOBAL",
4734
- "name": "json",
4735
- "allowNo": false,
4736
- "type": "boolean"
4737
- },
4738
- "flags-dir": {
4739
- "helpGroup": "GLOBAL",
4740
- "name": "flags-dir",
4741
- "summary": "Import flag values from a directory.",
4742
- "hasDynamicHelp": false,
4743
- "multiple": false,
4744
- "type": "option"
4745
- },
4746
- "name": {
4747
- "char": "n",
4748
- "description": "List of Networks Names that you want to update, separated by comma",
4749
- "name": "name",
4750
- "required": true,
4751
- "hasDynamicHelp": false,
4752
- "multiple": false,
4753
- "type": "option"
4754
- },
4755
- "status": {
4756
- "char": "s",
4757
- "description": "New status for the community, available values are: Live, DownForMaintenance",
4758
- "name": "status",
4759
- "required": true,
4760
- "hasDynamicHelp": false,
4761
- "multiple": false,
4762
- "type": "option"
4763
- },
4764
- "debug": {
4765
- "char": "d",
4766
- "description": "Activate debug mode (more logs)",
4767
- "name": "debug",
4768
- "allowNo": false,
4769
- "type": "boolean"
4770
- },
4771
- "target-org": {
4772
- "aliases": [
4773
- "targetusername",
4774
- "u"
4775
- ],
4776
- "char": "o",
4777
- "deprecateAliases": true,
4778
- "name": "target-org",
4779
- "noCacheDefault": true,
4780
- "required": true,
4781
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
4782
- "hasDynamicHelp": true,
4783
- "multiple": false,
4784
- "type": "option"
4785
- }
4786
- },
4787
- "hasDynamicHelp": true,
4788
- "hiddenAliases": [],
4789
- "id": "hardis:org:community:update",
4790
- "pluginAlias": "sfdx-hardis",
4791
- "pluginName": "sfdx-hardis",
4792
- "pluginType": "core",
4793
- "strict": true,
4794
- "summary": "Update a community status.",
4795
- "enableJsonFlag": true,
4796
- "isESM": true,
4797
- "relativePath": [
4798
- "lib",
4799
- "commands",
4800
- "hardis",
4801
- "org",
4802
- "community",
4803
- "update.js"
4804
- ],
4805
- "aliasPermutations": [],
4806
- "permutations": [
4807
- "hardis:org:community:update",
4808
- "org:hardis:community:update",
4809
- "org:community:hardis:update",
4810
- "org:community:update:hardis",
4811
- "hardis:community:org:update",
4812
- "community:hardis:org:update",
4813
- "community:org:hardis:update",
4814
- "community:org:update:hardis",
4815
- "hardis:community:update:org",
4816
- "community:hardis:update:org",
4817
- "community:update:hardis:org",
4818
- "community:update:org:hardis",
4819
- "hardis:org:update:community",
4820
- "org:hardis:update:community",
4821
- "org:update:hardis:community",
4822
- "org:update:community:hardis",
4823
- "hardis:update:org:community",
4824
- "update:hardis:org:community",
4825
- "update:org:hardis:community",
4826
- "update:org:community:hardis",
4827
- "hardis:update:community:org",
4828
- "update:hardis:community:org",
4829
- "update:community:hardis:org",
4830
- "update:community:org:hardis"
4831
- ]
4832
- },
4833
4722
  "hardis:org:configure:data": {
4834
4723
  "aliases": [],
4835
4724
  "args": {},
@@ -5131,6 +5020,117 @@
5131
5020
  "monitoring:configure:org:hardis"
5132
5021
  ]
5133
5022
  },
5023
+ "hardis:org:community:update": {
5024
+ "aliases": [],
5025
+ "args": {},
5026
+ "description": "\n## Command Behavior\n\n**Updates the status of one or more Salesforce Experience Cloud (Community) networks.**\n\nThis command provides a way to programmatically change the status of your Salesforce Communities, allowing you to manage their availability. This is particularly useful for:\n\n- **Maintenance:** Taking communities offline for planned maintenance (`DownForMaintenance`).\n- **Activation/Deactivation:** Bringing communities online or offline (`Live`, `DownForMaintenance`).\n- **Automation:** Integrating community status changes into CI/CD pipelines or scheduled jobs.\n\nKey functionalities:\n\n- **Network Selection:** You can specify one or more community network names (separated by commas) using the `--name` flag.\n- **Status Update:** You can set the new status for the selected communities using the `--status` flag. Supported values are `Live` and `DownForMaintenance`.\n- **Confirmation Prompt:** In non-CI environments, it provides a confirmation prompt before executing the update, ensuring intentional changes.\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **Salesforce SOQL Query:** It first queries the Salesforce `Network` object using SOQL to retrieve the `Id`, `Name`, and `Status` of the specified communities. This ensures that only existing communities are targeted.\n- **SObject Update:** It then constructs an array of `Network` sObjects with their `Id` and the new `Status` and performs a DML update operation using `conn.sobject(\"Network\").update()`. The `allOrNone: false` option is used to allow partial success in case some updates fail.\n- **Error Handling and Reporting:** It iterates through the update results, logging success or failure for each community. It also provides a summary of successful and erroneous updates.\n- **User Interaction:** Uses `prompts` to confirm the update action with the user when not running in a CI environment.\n- **Salesforce Connection:** Establishes a connection to the target Salesforce org using the `target-org` flag.\n",
5027
+ "examples": [
5028
+ "$ sf hardis:org:community:update --name 'MyNetworkName' --status DownForMaintenance",
5029
+ "$ sf hardis:org:community:update --name 'MyNetworkName,MySecondNetworkName' --status Live"
5030
+ ],
5031
+ "flags": {
5032
+ "json": {
5033
+ "description": "Format output as json.",
5034
+ "helpGroup": "GLOBAL",
5035
+ "name": "json",
5036
+ "allowNo": false,
5037
+ "type": "boolean"
5038
+ },
5039
+ "flags-dir": {
5040
+ "helpGroup": "GLOBAL",
5041
+ "name": "flags-dir",
5042
+ "summary": "Import flag values from a directory.",
5043
+ "hasDynamicHelp": false,
5044
+ "multiple": false,
5045
+ "type": "option"
5046
+ },
5047
+ "name": {
5048
+ "char": "n",
5049
+ "description": "List of Networks Names that you want to update, separated by comma",
5050
+ "name": "name",
5051
+ "required": true,
5052
+ "hasDynamicHelp": false,
5053
+ "multiple": false,
5054
+ "type": "option"
5055
+ },
5056
+ "status": {
5057
+ "char": "s",
5058
+ "description": "New status for the community, available values are: Live, DownForMaintenance",
5059
+ "name": "status",
5060
+ "required": true,
5061
+ "hasDynamicHelp": false,
5062
+ "multiple": false,
5063
+ "type": "option"
5064
+ },
5065
+ "debug": {
5066
+ "char": "d",
5067
+ "description": "Activate debug mode (more logs)",
5068
+ "name": "debug",
5069
+ "allowNo": false,
5070
+ "type": "boolean"
5071
+ },
5072
+ "target-org": {
5073
+ "aliases": [
5074
+ "targetusername",
5075
+ "u"
5076
+ ],
5077
+ "char": "o",
5078
+ "deprecateAliases": true,
5079
+ "name": "target-org",
5080
+ "noCacheDefault": true,
5081
+ "required": true,
5082
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
5083
+ "hasDynamicHelp": true,
5084
+ "multiple": false,
5085
+ "type": "option"
5086
+ }
5087
+ },
5088
+ "hasDynamicHelp": true,
5089
+ "hiddenAliases": [],
5090
+ "id": "hardis:org:community:update",
5091
+ "pluginAlias": "sfdx-hardis",
5092
+ "pluginName": "sfdx-hardis",
5093
+ "pluginType": "core",
5094
+ "strict": true,
5095
+ "summary": "Update a community status.",
5096
+ "enableJsonFlag": true,
5097
+ "isESM": true,
5098
+ "relativePath": [
5099
+ "lib",
5100
+ "commands",
5101
+ "hardis",
5102
+ "org",
5103
+ "community",
5104
+ "update.js"
5105
+ ],
5106
+ "aliasPermutations": [],
5107
+ "permutations": [
5108
+ "hardis:org:community:update",
5109
+ "org:hardis:community:update",
5110
+ "org:community:hardis:update",
5111
+ "org:community:update:hardis",
5112
+ "hardis:community:org:update",
5113
+ "community:hardis:org:update",
5114
+ "community:org:hardis:update",
5115
+ "community:org:update:hardis",
5116
+ "hardis:community:update:org",
5117
+ "community:hardis:update:org",
5118
+ "community:update:hardis:org",
5119
+ "community:update:org:hardis",
5120
+ "hardis:org:update:community",
5121
+ "org:hardis:update:community",
5122
+ "org:update:hardis:community",
5123
+ "org:update:community:hardis",
5124
+ "hardis:update:org:community",
5125
+ "update:hardis:org:community",
5126
+ "update:org:hardis:community",
5127
+ "update:org:community:hardis",
5128
+ "hardis:update:community:org",
5129
+ "update:hardis:community:org",
5130
+ "update:community:hardis:org",
5131
+ "update:community:org:hardis"
5132
+ ]
5133
+ },
5134
5134
  "hardis:org:data:delete": {
5135
5135
  "aliases": [],
5136
5136
  "args": {},
@@ -5482,15 +5482,12 @@
5482
5482
  "import:data:org:hardis"
5483
5483
  ]
5484
5484
  },
5485
- "hardis:org:diagnose:audittrail": {
5485
+ "hardis:org:files:export": {
5486
5486
  "aliases": [],
5487
5487
  "args": {},
5488
- "description": "Export Audit trail into a CSV file with selected criteria, and highlight suspect actions\n\nAlso detects updates of Custom Settings values (disable by defining `SKIP_AUDIT_TRAIL_CUSTOM_SETTINGS=true`)\n\nRegular setup actions performed in major orgs are filtered.\n\n- \"\"\n - createScratchOrg\n - changedsenderemail\n - deleteScratchOrg\n - loginasgrantedtopartnerbt\n- Certificate and Key Management\n - insertCertificate\n- Custom App Licenses\n - addeduserpackagelicense\n - granteduserpackagelicense\n - revokeduserpackagelicense\n- Customer Portal\n - createdcustomersuccessuser\n - CSPUserDisabled\n- Currency\n - updateddatedexchrate\n- Data Management\n - queueMembership\n- Email Administration\n - dkimRotationPreparationSuccessful\n - dkimRotationSuccessful\n- External Objects\n - xdsEncryptedFieldChange\n- Groups\n - groupMembership\n- Holidays\n - holiday_insert\n- Inbox mobile and legacy desktop apps\n - enableSIQUserNonEAC\n - siqUserAcceptedTOS\n- Manage Users\n - activateduser\n - createduser\n - changedcommunitynickname\n - changedemail\n - changedfederationid\n - changedpassword\n - changedinteractionuseroffon\n - changedinteractionuseronoff\n - changedmarketinguseroffon\n - changedmarketinguseronoff\n - changedofflineuseroffon\n - changedprofileforuserstdtostd\n - changedprofileforuser\n - changedprofileforusercusttostd\n - changedprofileforuserstdtocust\n - changedroleforusertonone\n - changedroleforuser\n - changedroleforuserfromnone\n - changedUserAdminVerifiedStatusVerified\n - changedUserEmailVerifiedStatusUnverified\n - changedUserEmailVerifiedStatusVerified\n - changedknowledgeuseroffon\n - changedsfcontentuseroffon\n - changedsupportuseroffon\n - changedusername\n - changedUserPhoneNumber\n - changedUserPhoneVerifiedStatusUnverified\n - changedUserPhoneVerifiedStatusVerified\n - deactivateduser\n - deleteAuthenticatorPairing\n - deleteTwoFactorInfo2\n - deleteTwoFactorTempCode\n - frozeuser\n - insertAuthenticatorPairing\n - insertTwoFactorInfo2\n - insertTwoFactorTempCode\n - lightningloginenroll\n - PermSetAssign\n - PermSetGroupAssign\n - PermSetGroupUnassign\n - PermSetLicenseAssign\n - PermSetUnassign\n - PermSetLicenseUnassign\n - registeredUserPhoneNumber\n - resetpassword\n - suNetworkAdminLogin\n - suNetworkAdminLogout\n - suOrgAdminLogin\n - suOrgAdminLogout\n - unfrozeuser\n - useremailchangesent\n- Mobile Administration\n - assigneduserstomobileconfig\n- Reporting Snapshots\n - createdReportJob\n - deletedReportJob\n- Sandboxes\n - DeleteSandbox\n\nBy default, deployment user defined in .sfdx-hardis.yml targetUsername property will be excluded.\n\nYou can define additional users to exclude in .sfdx-hardis.yml **monitoringExcludeUsernames** property.\n\nYou can also add more sections / actions considered as not suspect using property **monitoringAllowedSectionsActions**\n\nExample:\n\n```yaml\nmonitoringExcludeUsernames:\n - deploymentuser@cloudity.com\n - marketingcloud@cloudity.com\n - integration-user@cloudity.com\n\nmonitoringAllowedSectionsActions:\n \"Some section\": [] // Will ignore all actions from such section\n \"Some other section\": [\"actionType1\",\"actionType2\",\"actionType3\"] // Will ignore only those 3 actions from section \"Some other section\". Other actions in the same section will be considered as suspect.\n```\n\n## Excel output example\n\n![](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/screenshot-monitoring-audittrail-excel.jpg)\n\n## Local output example\n\n![](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/screenshot-monitoring-audittrail-local.jpg)\n\nThis command is part of [sfdx-hardis Monitoring](https://sfdx-hardis.cloudity.com/salesforce-monitoring-suspect-audit-trail/) and can output Grafana, Slack and MsTeams Notifications.\n",
5488
+ "description": "\n## Command Behavior\n\n**Exports file attachments (ContentVersion, Attachment) from a Salesforce org based on a predefined configuration.**\n\nThis command enables the mass download of files associated with Salesforce records, providing a robust solution for backing up files, migrating them to other systems, or integrating them with external document management solutions.\n\nKey functionalities:\n\n- **Configuration-Driven Export:** Relies on an `export.json` file within a designated file export project to define the export criteria, including the SOQL query for parent records, file types to export, and output naming conventions.\n- **Interactive Project Selection:** If the file export project path is not provided via the `--path` flag, it interactively prompts the user to select one.\n- **Configurable Export Options:** Allows overriding default export settings such as `chunksize` (number of records processed in a batch), `polltimeout` (timeout for Bulk API calls), and `startchunknumber` (to resume a failed export).\n- **Support for ContentVersion and Attachment:** Handles both modern Salesforce Files (ContentVersion) and older Attachments.\n\nSee this article for a practical example:\n\n[![How to mass download notes and attachments files from a Salesforce org](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/article-mass-download.jpg)](https://nicolas.vuillamy.fr/how-to-mass-download-notes-and-attachments-files-from-a-salesforce-org-83a028824afd)\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **FilesExporter Class:** The core logic is encapsulated within the `FilesExporter` class, which orchestrates the entire export process.\n- **SOQL Queries (Bulk API):** It uses Salesforce Bulk API queries to efficiently retrieve large volumes of parent record IDs and file metadata.\n- **File Download:** Downloads the actual file content from Salesforce.\n- **File System Operations:** Writes the downloaded files to the local file system, organizing them into folders based on the configured naming conventions.\n- **Configuration Loading:** Reads the `export.json` file to get the export configuration. It also allows for interactive overriding of these settings.\n- **Interactive Prompts:** Uses `selectFilesWorkspace` to allow the user to choose a file export project and `promptFilesExportConfiguration` for customizing export options.\n- **Error Handling:** Includes mechanisms to handle potential errors during the export process, such as network issues or API limits.\n",
5489
5489
  "examples": [
5490
- "$ sf hardis:org:diagnose:audittrail",
5491
- "$ sf hardis:org:diagnose:audittrail --excludeusers baptiste@titi.com",
5492
- "$ sf hardis:org:diagnose:audittrail --excludeusers baptiste@titi.com,bertrand@titi.com",
5493
- "$ sf hardis:org:diagnose:audittrail --lastndays 5"
5490
+ "$ sf hardis:org:files:export"
5494
5491
  ],
5495
5492
  "flags": {
5496
5493
  "json": {
@@ -5508,23 +5505,288 @@
5508
5505
  "multiple": false,
5509
5506
  "type": "option"
5510
5507
  },
5511
- "excludeusers": {
5512
- "char": "e",
5513
- "description": "Comma-separated list of usernames to exclude",
5514
- "name": "excludeusers",
5508
+ "path": {
5509
+ "char": "p",
5510
+ "description": "Path to the file export project",
5511
+ "name": "path",
5515
5512
  "hasDynamicHelp": false,
5516
5513
  "multiple": false,
5517
5514
  "type": "option"
5518
5515
  },
5519
- "lastndays": {
5516
+ "chunksize": {
5517
+ "char": "c",
5518
+ "description": "Number of records to add in a chunk before it is processed",
5519
+ "name": "chunksize",
5520
+ "default": 1000,
5521
+ "hasDynamicHelp": false,
5522
+ "multiple": false,
5523
+ "type": "option"
5524
+ },
5525
+ "polltimeout": {
5520
5526
  "char": "t",
5521
- "description": "Number of days to extract from today (included)",
5522
- "name": "lastndays",
5527
+ "description": "Timeout in MS for Bulk API calls",
5528
+ "name": "polltimeout",
5529
+ "default": 300000,
5523
5530
  "hasDynamicHelp": false,
5524
5531
  "multiple": false,
5525
5532
  "type": "option"
5526
5533
  },
5527
- "outputfile": {
5534
+ "startchunknumber": {
5535
+ "char": "s",
5536
+ "description": "Chunk number to start from",
5537
+ "name": "startchunknumber",
5538
+ "default": 0,
5539
+ "hasDynamicHelp": false,
5540
+ "multiple": false,
5541
+ "type": "option"
5542
+ },
5543
+ "debug": {
5544
+ "char": "d",
5545
+ "description": "Activate debug mode (more logs)",
5546
+ "name": "debug",
5547
+ "allowNo": false,
5548
+ "type": "boolean"
5549
+ },
5550
+ "websocket": {
5551
+ "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
5552
+ "name": "websocket",
5553
+ "hasDynamicHelp": false,
5554
+ "multiple": false,
5555
+ "type": "option"
5556
+ },
5557
+ "skipauth": {
5558
+ "description": "Skip authentication check when a default username is required",
5559
+ "name": "skipauth",
5560
+ "allowNo": false,
5561
+ "type": "boolean"
5562
+ },
5563
+ "target-org": {
5564
+ "aliases": [
5565
+ "targetusername",
5566
+ "u"
5567
+ ],
5568
+ "char": "o",
5569
+ "deprecateAliases": true,
5570
+ "name": "target-org",
5571
+ "noCacheDefault": true,
5572
+ "required": true,
5573
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
5574
+ "hasDynamicHelp": true,
5575
+ "multiple": false,
5576
+ "type": "option"
5577
+ }
5578
+ },
5579
+ "hasDynamicHelp": true,
5580
+ "hiddenAliases": [],
5581
+ "id": "hardis:org:files:export",
5582
+ "pluginAlias": "sfdx-hardis",
5583
+ "pluginName": "sfdx-hardis",
5584
+ "pluginType": "core",
5585
+ "strict": true,
5586
+ "enableJsonFlag": true,
5587
+ "title": "Export files",
5588
+ "requiresProject": false,
5589
+ "isESM": true,
5590
+ "relativePath": [
5591
+ "lib",
5592
+ "commands",
5593
+ "hardis",
5594
+ "org",
5595
+ "files",
5596
+ "export.js"
5597
+ ],
5598
+ "aliasPermutations": [],
5599
+ "permutations": [
5600
+ "hardis:org:files:export",
5601
+ "org:hardis:files:export",
5602
+ "org:files:hardis:export",
5603
+ "org:files:export:hardis",
5604
+ "hardis:files:org:export",
5605
+ "files:hardis:org:export",
5606
+ "files:org:hardis:export",
5607
+ "files:org:export:hardis",
5608
+ "hardis:files:export:org",
5609
+ "files:hardis:export:org",
5610
+ "files:export:hardis:org",
5611
+ "files:export:org:hardis",
5612
+ "hardis:org:export:files",
5613
+ "org:hardis:export:files",
5614
+ "org:export:hardis:files",
5615
+ "org:export:files:hardis",
5616
+ "hardis:export:org:files",
5617
+ "export:hardis:org:files",
5618
+ "export:org:hardis:files",
5619
+ "export:org:files:hardis",
5620
+ "hardis:export:files:org",
5621
+ "export:hardis:files:org",
5622
+ "export:files:hardis:org",
5623
+ "export:files:org:hardis"
5624
+ ]
5625
+ },
5626
+ "hardis:org:files:import": {
5627
+ "aliases": [],
5628
+ "args": {},
5629
+ "description": "\nThis command facilitates the mass upload of files into Salesforce, allowing you to populate records with associated documents, images, or other file types. It's a crucial tool for data migration, content seeding, or synchronizing external file repositories with Salesforce.\n\nKey functionalities:\n\n- **Configuration-Driven Import:** Relies on an `export.json` file within a designated file export project (created using `sf hardis:org:configure:files`) to determine which files to import and how they should be associated with Salesforce records.\n- **Interactive Project Selection:** If the file import project path is not provided via the `--path` flag, it interactively prompts the user to select one.\n- **Overwrite Option:** The `--overwrite` flag allows you to replace existing files in Salesforce with local versions that have the same name. Be aware that this option doubles the number of API calls used.\n- **Support for ContentVersion and Attachment:** Handles both modern Salesforce Files (ContentVersion) and older Attachments.\n\nSee this article for how to export files, which is often a prerequisite for importing:\n\n[![How to mass download notes and attachments files from a Salesforce org](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/article-mass-download.jpg)](https://nicolas.vuillamy.fr/how-to-mass-download-notes-and-attachments-files-from-a-salesforce-org-83a028824afd)\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **FilesImporter Class:** The core logic is encapsulated within the `FilesImporter` class, which orchestrates the entire import process.\n- **File System Scan:** Scans the local file system within the configured project directory to identify files for import.\n- **Salesforce API Interaction:** Uses Salesforce APIs (e.g., ContentVersion, Attachment) to upload files and associate them with records.\n- **Configuration Loading:** Reads the `export.json` file to get the import configuration, including SOQL queries to identify parent records for file association.\n- **Interactive Prompts:** Uses `selectFilesWorkspace` to allow the user to choose a file import project and `prompts` for confirming the overwrite behavior.\n- **Error Handling:** Includes mechanisms to handle potential errors during the import process, such as API limits or file upload failures.\n",
5630
+ "examples": [
5631
+ "$ sf hardis:org:files:import"
5632
+ ],
5633
+ "flags": {
5634
+ "json": {
5635
+ "description": "Format output as json.",
5636
+ "helpGroup": "GLOBAL",
5637
+ "name": "json",
5638
+ "allowNo": false,
5639
+ "type": "boolean"
5640
+ },
5641
+ "flags-dir": {
5642
+ "helpGroup": "GLOBAL",
5643
+ "name": "flags-dir",
5644
+ "summary": "Import flag values from a directory.",
5645
+ "hasDynamicHelp": false,
5646
+ "multiple": false,
5647
+ "type": "option"
5648
+ },
5649
+ "path": {
5650
+ "char": "p",
5651
+ "description": "Path to the file export project",
5652
+ "name": "path",
5653
+ "hasDynamicHelp": false,
5654
+ "multiple": false,
5655
+ "type": "option"
5656
+ },
5657
+ "overwrite": {
5658
+ "char": "f",
5659
+ "description": "Override existing files (doubles the number of API calls)",
5660
+ "name": "overwrite",
5661
+ "allowNo": false,
5662
+ "type": "boolean"
5663
+ },
5664
+ "debug": {
5665
+ "char": "d",
5666
+ "description": "Activate debug mode (more logs)",
5667
+ "name": "debug",
5668
+ "allowNo": false,
5669
+ "type": "boolean"
5670
+ },
5671
+ "websocket": {
5672
+ "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
5673
+ "name": "websocket",
5674
+ "hasDynamicHelp": false,
5675
+ "multiple": false,
5676
+ "type": "option"
5677
+ },
5678
+ "skipauth": {
5679
+ "description": "Skip authentication check when a default username is required",
5680
+ "name": "skipauth",
5681
+ "allowNo": false,
5682
+ "type": "boolean"
5683
+ },
5684
+ "target-org": {
5685
+ "aliases": [
5686
+ "targetusername",
5687
+ "u"
5688
+ ],
5689
+ "char": "o",
5690
+ "deprecateAliases": true,
5691
+ "name": "target-org",
5692
+ "noCacheDefault": true,
5693
+ "required": true,
5694
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
5695
+ "hasDynamicHelp": true,
5696
+ "multiple": false,
5697
+ "type": "option"
5698
+ }
5699
+ },
5700
+ "hasDynamicHelp": true,
5701
+ "hiddenAliases": [],
5702
+ "id": "hardis:org:files:import",
5703
+ "pluginAlias": "sfdx-hardis",
5704
+ "pluginName": "sfdx-hardis",
5705
+ "pluginType": "core",
5706
+ "strict": true,
5707
+ "enableJsonFlag": true,
5708
+ "title": "Import files",
5709
+ "requiresProject": false,
5710
+ "isESM": true,
5711
+ "relativePath": [
5712
+ "lib",
5713
+ "commands",
5714
+ "hardis",
5715
+ "org",
5716
+ "files",
5717
+ "import.js"
5718
+ ],
5719
+ "aliasPermutations": [],
5720
+ "permutations": [
5721
+ "hardis:org:files:import",
5722
+ "org:hardis:files:import",
5723
+ "org:files:hardis:import",
5724
+ "org:files:import:hardis",
5725
+ "hardis:files:org:import",
5726
+ "files:hardis:org:import",
5727
+ "files:org:hardis:import",
5728
+ "files:org:import:hardis",
5729
+ "hardis:files:import:org",
5730
+ "files:hardis:import:org",
5731
+ "files:import:hardis:org",
5732
+ "files:import:org:hardis",
5733
+ "hardis:org:import:files",
5734
+ "org:hardis:import:files",
5735
+ "org:import:hardis:files",
5736
+ "org:import:files:hardis",
5737
+ "hardis:import:org:files",
5738
+ "import:hardis:org:files",
5739
+ "import:org:hardis:files",
5740
+ "import:org:files:hardis",
5741
+ "hardis:import:files:org",
5742
+ "import:hardis:files:org",
5743
+ "import:files:hardis:org",
5744
+ "import:files:org:hardis"
5745
+ ]
5746
+ },
5747
+ "hardis:org:diagnose:audittrail": {
5748
+ "aliases": [],
5749
+ "args": {},
5750
+ "description": "Export Audit trail into a CSV file with selected criteria, and highlight suspect actions\n\nAlso detects updates of Custom Settings values (disable by defining `SKIP_AUDIT_TRAIL_CUSTOM_SETTINGS=true`)\n\nRegular setup actions performed in major orgs are filtered.\n\n- \"\"\n - createScratchOrg\n - changedsenderemail\n - deleteScratchOrg\n - loginasgrantedtopartnerbt\n- Certificate and Key Management\n - insertCertificate\n- Custom App Licenses\n - addeduserpackagelicense\n - granteduserpackagelicense\n - revokeduserpackagelicense\n- Customer Portal\n - createdcustomersuccessuser\n - CSPUserDisabled\n- Currency\n - updateddatedexchrate\n- Data Management\n - queueMembership\n- Email Administration\n - dkimRotationPreparationSuccessful\n - dkimRotationSuccessful\n- External Objects\n - xdsEncryptedFieldChange\n- Groups\n - groupMembership\n- Holidays\n - holiday_insert\n- Inbox mobile and legacy desktop apps\n - enableSIQUserNonEAC\n - siqUserAcceptedTOS\n- Manage Users\n - activateduser\n - createduser\n - changedcommunitynickname\n - changedemail\n - changedfederationid\n - changedpassword\n - changedinteractionuseroffon\n - changedinteractionuseronoff\n - changedmarketinguseroffon\n - changedmarketinguseronoff\n - changedofflineuseroffon\n - changedprofileforuserstdtostd\n - changedprofileforuser\n - changedprofileforusercusttostd\n - changedprofileforuserstdtocust\n - changedroleforusertonone\n - changedroleforuser\n - changedroleforuserfromnone\n - changedUserAdminVerifiedStatusVerified\n - changedUserEmailVerifiedStatusUnverified\n - changedUserEmailVerifiedStatusVerified\n - changedknowledgeuseroffon\n - changedsfcontentuseroffon\n - changedsupportuseroffon\n - changedusername\n - changedUserPhoneNumber\n - changedUserPhoneVerifiedStatusUnverified\n - changedUserPhoneVerifiedStatusVerified\n - deactivateduser\n - deleteAuthenticatorPairing\n - deleteTwoFactorInfo2\n - deleteTwoFactorTempCode\n - frozeuser\n - insertAuthenticatorPairing\n - insertTwoFactorInfo2\n - insertTwoFactorTempCode\n - lightningloginenroll\n - PermSetAssign\n - PermSetGroupAssign\n - PermSetGroupUnassign\n - PermSetLicenseAssign\n - PermSetUnassign\n - PermSetLicenseUnassign\n - registeredUserPhoneNumber\n - resetpassword\n - suNetworkAdminLogin\n - suNetworkAdminLogout\n - suOrgAdminLogin\n - suOrgAdminLogout\n - unfrozeuser\n - useremailchangesent\n- Mobile Administration\n - assigneduserstomobileconfig\n- Reporting Snapshots\n - createdReportJob\n - deletedReportJob\n- Sandboxes\n - DeleteSandbox\n\nBy default, deployment user defined in .sfdx-hardis.yml targetUsername property will be excluded.\n\nYou can define additional users to exclude in .sfdx-hardis.yml **monitoringExcludeUsernames** property.\n\nYou can also add more sections / actions considered as not suspect using property **monitoringAllowedSectionsActions**\n\nExample:\n\n```yaml\nmonitoringExcludeUsernames:\n - deploymentuser@cloudity.com\n - marketingcloud@cloudity.com\n - integration-user@cloudity.com\n\nmonitoringAllowedSectionsActions:\n \"Some section\": [] // Will ignore all actions from such section\n \"Some other section\": [\"actionType1\",\"actionType2\",\"actionType3\"] // Will ignore only those 3 actions from section \"Some other section\". Other actions in the same section will be considered as suspect.\n```\n\n## Excel output example\n\n![](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/screenshot-monitoring-audittrail-excel.jpg)\n\n## Local output example\n\n![](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/screenshot-monitoring-audittrail-local.jpg)\n\nThis command is part of [sfdx-hardis Monitoring](https://sfdx-hardis.cloudity.com/salesforce-monitoring-suspect-audit-trail/) and can output Grafana, Slack and MsTeams Notifications.\n",
5751
+ "examples": [
5752
+ "$ sf hardis:org:diagnose:audittrail",
5753
+ "$ sf hardis:org:diagnose:audittrail --excludeusers baptiste@titi.com",
5754
+ "$ sf hardis:org:diagnose:audittrail --excludeusers baptiste@titi.com,bertrand@titi.com",
5755
+ "$ sf hardis:org:diagnose:audittrail --lastndays 5"
5756
+ ],
5757
+ "flags": {
5758
+ "json": {
5759
+ "description": "Format output as json.",
5760
+ "helpGroup": "GLOBAL",
5761
+ "name": "json",
5762
+ "allowNo": false,
5763
+ "type": "boolean"
5764
+ },
5765
+ "flags-dir": {
5766
+ "helpGroup": "GLOBAL",
5767
+ "name": "flags-dir",
5768
+ "summary": "Import flag values from a directory.",
5769
+ "hasDynamicHelp": false,
5770
+ "multiple": false,
5771
+ "type": "option"
5772
+ },
5773
+ "excludeusers": {
5774
+ "char": "e",
5775
+ "description": "Comma-separated list of usernames to exclude",
5776
+ "name": "excludeusers",
5777
+ "hasDynamicHelp": false,
5778
+ "multiple": false,
5779
+ "type": "option"
5780
+ },
5781
+ "lastndays": {
5782
+ "char": "t",
5783
+ "description": "Number of days to extract from today (included)",
5784
+ "name": "lastndays",
5785
+ "hasDynamicHelp": false,
5786
+ "multiple": false,
5787
+ "type": "option"
5788
+ },
5789
+ "outputfile": {
5528
5790
  "char": "f",
5529
5791
  "description": "Force the path and name of output report file. Must end with .csv",
5530
5792
  "name": "outputfile",
@@ -6631,268 +6893,6 @@
6631
6893
  "unusedusers:diagnose:org:hardis"
6632
6894
  ]
6633
6895
  },
6634
- "hardis:org:files:export": {
6635
- "aliases": [],
6636
- "args": {},
6637
- "description": "\n## Command Behavior\n\n**Exports file attachments (ContentVersion, Attachment) from a Salesforce org based on a predefined configuration.**\n\nThis command enables the mass download of files associated with Salesforce records, providing a robust solution for backing up files, migrating them to other systems, or integrating them with external document management solutions.\n\nKey functionalities:\n\n- **Configuration-Driven Export:** Relies on an `export.json` file within a designated file export project to define the export criteria, including the SOQL query for parent records, file types to export, and output naming conventions.\n- **Interactive Project Selection:** If the file export project path is not provided via the `--path` flag, it interactively prompts the user to select one.\n- **Configurable Export Options:** Allows overriding default export settings such as `chunksize` (number of records processed in a batch), `polltimeout` (timeout for Bulk API calls), and `startchunknumber` (to resume a failed export).\n- **Support for ContentVersion and Attachment:** Handles both modern Salesforce Files (ContentVersion) and older Attachments.\n\nSee this article for a practical example:\n\n[![How to mass download notes and attachments files from a Salesforce org](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/article-mass-download.jpg)](https://nicolas.vuillamy.fr/how-to-mass-download-notes-and-attachments-files-from-a-salesforce-org-83a028824afd)\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **FilesExporter Class:** The core logic is encapsulated within the `FilesExporter` class, which orchestrates the entire export process.\n- **SOQL Queries (Bulk API):** It uses Salesforce Bulk API queries to efficiently retrieve large volumes of parent record IDs and file metadata.\n- **File Download:** Downloads the actual file content from Salesforce.\n- **File System Operations:** Writes the downloaded files to the local file system, organizing them into folders based on the configured naming conventions.\n- **Configuration Loading:** Reads the `export.json` file to get the export configuration. It also allows for interactive overriding of these settings.\n- **Interactive Prompts:** Uses `selectFilesWorkspace` to allow the user to choose a file export project and `promptFilesExportConfiguration` for customizing export options.\n- **Error Handling:** Includes mechanisms to handle potential errors during the export process, such as network issues or API limits.\n",
6638
- "examples": [
6639
- "$ sf hardis:org:files:export"
6640
- ],
6641
- "flags": {
6642
- "json": {
6643
- "description": "Format output as json.",
6644
- "helpGroup": "GLOBAL",
6645
- "name": "json",
6646
- "allowNo": false,
6647
- "type": "boolean"
6648
- },
6649
- "flags-dir": {
6650
- "helpGroup": "GLOBAL",
6651
- "name": "flags-dir",
6652
- "summary": "Import flag values from a directory.",
6653
- "hasDynamicHelp": false,
6654
- "multiple": false,
6655
- "type": "option"
6656
- },
6657
- "path": {
6658
- "char": "p",
6659
- "description": "Path to the file export project",
6660
- "name": "path",
6661
- "hasDynamicHelp": false,
6662
- "multiple": false,
6663
- "type": "option"
6664
- },
6665
- "chunksize": {
6666
- "char": "c",
6667
- "description": "Number of records to add in a chunk before it is processed",
6668
- "name": "chunksize",
6669
- "default": 1000,
6670
- "hasDynamicHelp": false,
6671
- "multiple": false,
6672
- "type": "option"
6673
- },
6674
- "polltimeout": {
6675
- "char": "t",
6676
- "description": "Timeout in MS for Bulk API calls",
6677
- "name": "polltimeout",
6678
- "default": 300000,
6679
- "hasDynamicHelp": false,
6680
- "multiple": false,
6681
- "type": "option"
6682
- },
6683
- "startchunknumber": {
6684
- "char": "s",
6685
- "description": "Chunk number to start from",
6686
- "name": "startchunknumber",
6687
- "default": 0,
6688
- "hasDynamicHelp": false,
6689
- "multiple": false,
6690
- "type": "option"
6691
- },
6692
- "debug": {
6693
- "char": "d",
6694
- "description": "Activate debug mode (more logs)",
6695
- "name": "debug",
6696
- "allowNo": false,
6697
- "type": "boolean"
6698
- },
6699
- "websocket": {
6700
- "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
6701
- "name": "websocket",
6702
- "hasDynamicHelp": false,
6703
- "multiple": false,
6704
- "type": "option"
6705
- },
6706
- "skipauth": {
6707
- "description": "Skip authentication check when a default username is required",
6708
- "name": "skipauth",
6709
- "allowNo": false,
6710
- "type": "boolean"
6711
- },
6712
- "target-org": {
6713
- "aliases": [
6714
- "targetusername",
6715
- "u"
6716
- ],
6717
- "char": "o",
6718
- "deprecateAliases": true,
6719
- "name": "target-org",
6720
- "noCacheDefault": true,
6721
- "required": true,
6722
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
6723
- "hasDynamicHelp": true,
6724
- "multiple": false,
6725
- "type": "option"
6726
- }
6727
- },
6728
- "hasDynamicHelp": true,
6729
- "hiddenAliases": [],
6730
- "id": "hardis:org:files:export",
6731
- "pluginAlias": "sfdx-hardis",
6732
- "pluginName": "sfdx-hardis",
6733
- "pluginType": "core",
6734
- "strict": true,
6735
- "enableJsonFlag": true,
6736
- "title": "Export files",
6737
- "requiresProject": false,
6738
- "isESM": true,
6739
- "relativePath": [
6740
- "lib",
6741
- "commands",
6742
- "hardis",
6743
- "org",
6744
- "files",
6745
- "export.js"
6746
- ],
6747
- "aliasPermutations": [],
6748
- "permutations": [
6749
- "hardis:org:files:export",
6750
- "org:hardis:files:export",
6751
- "org:files:hardis:export",
6752
- "org:files:export:hardis",
6753
- "hardis:files:org:export",
6754
- "files:hardis:org:export",
6755
- "files:org:hardis:export",
6756
- "files:org:export:hardis",
6757
- "hardis:files:export:org",
6758
- "files:hardis:export:org",
6759
- "files:export:hardis:org",
6760
- "files:export:org:hardis",
6761
- "hardis:org:export:files",
6762
- "org:hardis:export:files",
6763
- "org:export:hardis:files",
6764
- "org:export:files:hardis",
6765
- "hardis:export:org:files",
6766
- "export:hardis:org:files",
6767
- "export:org:hardis:files",
6768
- "export:org:files:hardis",
6769
- "hardis:export:files:org",
6770
- "export:hardis:files:org",
6771
- "export:files:hardis:org",
6772
- "export:files:org:hardis"
6773
- ]
6774
- },
6775
- "hardis:org:files:import": {
6776
- "aliases": [],
6777
- "args": {},
6778
- "description": "\nThis command facilitates the mass upload of files into Salesforce, allowing you to populate records with associated documents, images, or other file types. It's a crucial tool for data migration, content seeding, or synchronizing external file repositories with Salesforce.\n\nKey functionalities:\n\n- **Configuration-Driven Import:** Relies on an `export.json` file within a designated file export project (created using `sf hardis:org:configure:files`) to determine which files to import and how they should be associated with Salesforce records.\n- **Interactive Project Selection:** If the file import project path is not provided via the `--path` flag, it interactively prompts the user to select one.\n- **Overwrite Option:** The `--overwrite` flag allows you to replace existing files in Salesforce with local versions that have the same name. Be aware that this option doubles the number of API calls used.\n- **Support for ContentVersion and Attachment:** Handles both modern Salesforce Files (ContentVersion) and older Attachments.\n\nSee this article for how to export files, which is often a prerequisite for importing:\n\n[![How to mass download notes and attachments files from a Salesforce org](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/article-mass-download.jpg)](https://nicolas.vuillamy.fr/how-to-mass-download-notes-and-attachments-files-from-a-salesforce-org-83a028824afd)\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **FilesImporter Class:** The core logic is encapsulated within the `FilesImporter` class, which orchestrates the entire import process.\n- **File System Scan:** Scans the local file system within the configured project directory to identify files for import.\n- **Salesforce API Interaction:** Uses Salesforce APIs (e.g., ContentVersion, Attachment) to upload files and associate them with records.\n- **Configuration Loading:** Reads the `export.json` file to get the import configuration, including SOQL queries to identify parent records for file association.\n- **Interactive Prompts:** Uses `selectFilesWorkspace` to allow the user to choose a file import project and `prompts` for confirming the overwrite behavior.\n- **Error Handling:** Includes mechanisms to handle potential errors during the import process, such as API limits or file upload failures.\n",
6779
- "examples": [
6780
- "$ sf hardis:org:files:import"
6781
- ],
6782
- "flags": {
6783
- "json": {
6784
- "description": "Format output as json.",
6785
- "helpGroup": "GLOBAL",
6786
- "name": "json",
6787
- "allowNo": false,
6788
- "type": "boolean"
6789
- },
6790
- "flags-dir": {
6791
- "helpGroup": "GLOBAL",
6792
- "name": "flags-dir",
6793
- "summary": "Import flag values from a directory.",
6794
- "hasDynamicHelp": false,
6795
- "multiple": false,
6796
- "type": "option"
6797
- },
6798
- "path": {
6799
- "char": "p",
6800
- "description": "Path to the file export project",
6801
- "name": "path",
6802
- "hasDynamicHelp": false,
6803
- "multiple": false,
6804
- "type": "option"
6805
- },
6806
- "overwrite": {
6807
- "char": "f",
6808
- "description": "Override existing files (doubles the number of API calls)",
6809
- "name": "overwrite",
6810
- "allowNo": false,
6811
- "type": "boolean"
6812
- },
6813
- "debug": {
6814
- "char": "d",
6815
- "description": "Activate debug mode (more logs)",
6816
- "name": "debug",
6817
- "allowNo": false,
6818
- "type": "boolean"
6819
- },
6820
- "websocket": {
6821
- "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
6822
- "name": "websocket",
6823
- "hasDynamicHelp": false,
6824
- "multiple": false,
6825
- "type": "option"
6826
- },
6827
- "skipauth": {
6828
- "description": "Skip authentication check when a default username is required",
6829
- "name": "skipauth",
6830
- "allowNo": false,
6831
- "type": "boolean"
6832
- },
6833
- "target-org": {
6834
- "aliases": [
6835
- "targetusername",
6836
- "u"
6837
- ],
6838
- "char": "o",
6839
- "deprecateAliases": true,
6840
- "name": "target-org",
6841
- "noCacheDefault": true,
6842
- "required": true,
6843
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
6844
- "hasDynamicHelp": true,
6845
- "multiple": false,
6846
- "type": "option"
6847
- }
6848
- },
6849
- "hasDynamicHelp": true,
6850
- "hiddenAliases": [],
6851
- "id": "hardis:org:files:import",
6852
- "pluginAlias": "sfdx-hardis",
6853
- "pluginName": "sfdx-hardis",
6854
- "pluginType": "core",
6855
- "strict": true,
6856
- "enableJsonFlag": true,
6857
- "title": "Import files",
6858
- "requiresProject": false,
6859
- "isESM": true,
6860
- "relativePath": [
6861
- "lib",
6862
- "commands",
6863
- "hardis",
6864
- "org",
6865
- "files",
6866
- "import.js"
6867
- ],
6868
- "aliasPermutations": [],
6869
- "permutations": [
6870
- "hardis:org:files:import",
6871
- "org:hardis:files:import",
6872
- "org:files:hardis:import",
6873
- "org:files:import:hardis",
6874
- "hardis:files:org:import",
6875
- "files:hardis:org:import",
6876
- "files:org:hardis:import",
6877
- "files:org:import:hardis",
6878
- "hardis:files:import:org",
6879
- "files:hardis:import:org",
6880
- "files:import:hardis:org",
6881
- "files:import:org:hardis",
6882
- "hardis:org:import:files",
6883
- "org:hardis:import:files",
6884
- "org:import:hardis:files",
6885
- "org:import:files:hardis",
6886
- "hardis:import:org:files",
6887
- "import:hardis:org:files",
6888
- "import:org:hardis:files",
6889
- "import:org:files:hardis",
6890
- "hardis:import:files:org",
6891
- "import:hardis:files:org",
6892
- "import:files:hardis:org",
6893
- "import:files:org:hardis"
6894
- ]
6895
- },
6896
6896
  "hardis:org:fix:listviewmine": {
6897
6897
  "aliases": [],
6898
6898
  "args": {},
@@ -7011,7 +7011,7 @@
7011
7011
  "hardis:org:generate:packagexmlfull": {
7012
7012
  "aliases": [],
7013
7013
  "args": {},
7014
- "description": "\n## Command Behavior\n\n**Generates a comprehensive `package.xml` file for a Salesforce org, including all metadata components, even managed ones.**\n\nThis command is essential for various Salesforce development and administration tasks, especially when you need a complete snapshot of an org's metadata. It goes beyond typical source tracking by including managed package components, which is crucial for understanding the full metadata footprint of an org.\n\nKey functionalities:\n\n- **Full Org Metadata Retrieval:** Connects to a specified Salesforce org (or prompts for one if not provided) and retrieves a complete list of all metadata types and their members.\n- **Managed Package Inclusion:** Unlike standard source retrieval, this command explicitly includes metadata from managed packages, providing a truly comprehensive `package.xml`.\n- **Customizable Output:** Allows you to specify the output file path for the generated `package.xml`.\n- **Interactive Org Selection:** If no target org is specified, it interactively prompts the user to choose an org.\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **Salesforce Metadata API Interaction:** It leverages the Salesforce Metadata API to list all available metadata types and then retrieve all components for each type.\n- **`buildOrgManifest` Utility:** The core logic for querying the org's metadata and constructing the `package.xml` is encapsulated within the `buildOrgManifest` utility function.\n- **XML Generation:** It dynamically builds the XML structure of the `package.xml` file, including the `types` and `members` elements for all retrieved metadata.\n- **File System Operations:** It writes the generated `package.xml` file to the specified output path.\n- **Interactive Prompts:** Uses `promptOrgUsernameDefault` to guide the user in selecting the target Salesforce org.\n",
7014
+ "description": "\n## Command Behavior\n\n**Generates a comprehensive `package.xml` file for a Salesforce org, including all metadata components, even managed ones.**\n\nThis command is essential for various Salesforce development and administration tasks, especially when you need a complete snapshot of an org's metadata. It goes beyond typical source tracking by including managed package components, which is crucial for understanding the full metadata footprint of an org.\n\nKey functionalities:\n\n- **Full Org Metadata Retrieval:** Connects to a specified Salesforce org (or prompts for one if not provided) and retrieves a complete list of all metadata types and their members.\n- **Managed Package Inclusion:** Unlike standard source retrieval, this command explicitly includes metadata from managed packages, providing a truly comprehensive `package.xml`.\n- **Customizable Output:** Allows you to specify the output file path for the generated `package.xml`.\n- **Interactive Org Selection:** If no target org is specified, it interactively prompts the user to choose an org. (or use --no-prompt to skip this step)\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **Salesforce Metadata API Interaction:** It leverages the Salesforce Metadata API to list all available metadata types and then retrieve all components for each type.\n- **`buildOrgManifest` Utility:** The core logic for querying the org's metadata and constructing the `package.xml` is encapsulated within the `buildOrgManifest` utility function.\n- **XML Generation:** It dynamically builds the XML structure of the `package.xml` file, including the `types` and `members` elements for all retrieved metadata.\n- **File System Operations:** It writes the generated `package.xml` file to the specified output path.\n- **Interactive Prompts:** Uses `promptOrgUsernameDefault` to guide the user in selecting the target Salesforce org.\n",
7015
7015
  "examples": [
7016
7016
  "$ sf hardis:org:generate:packagexmlfull",
7017
7017
  "$ sf hardis:org:generate:packagexmlfull --outputfile /tmp/packagexmlfull.xml",
@@ -7047,6 +7047,13 @@
7047
7047
  "allowNo": false,
7048
7048
  "type": "boolean"
7049
7049
  },
7050
+ "no-prompt": {
7051
+ "char": "n",
7052
+ "description": "Do not prompt for org username, use the default one",
7053
+ "name": "no-prompt",
7054
+ "allowNo": false,
7055
+ "type": "boolean"
7056
+ },
7050
7057
  "websocket": {
7051
7058
  "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
7052
7059
  "name": "websocket",
@@ -7973,14 +7980,12 @@
7973
7980
  "packageconfig:retrieve:org:hardis"
7974
7981
  ]
7975
7982
  },
7976
- "hardis:org:user:activateinvalid": {
7983
+ "hardis:org:test:apex": {
7977
7984
  "aliases": [],
7978
7985
  "args": {},
7979
- "description": "Update sandbox users so their email is valid\n\n Example: replaces `toto@company.com.dev.invalid` with `toto@company.com.dev.invalid`\n\nSee article below\n\n[![Reactivate all the sandbox users with .invalid emails in 3 clicks](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/article-invalid-email.jpg)](https://nicolas.vuillamy.fr/reactivate-all-the-sandbox-users-with-invalid-emails-in-3-clicks-2265af4e3a3d)\n",
7986
+ "description": "Run apex tests in Salesforce org\n\nIf following configuration is defined, it will fail if apex coverage target is not reached:\n\n- Env `APEX_TESTS_MIN_COVERAGE_ORG_WIDE` or `.sfdx-hardis` property `apexTestsMinCoverageOrgWide`\n- Env `APEX_TESTS_MIN_COVERAGE_ORG_WIDE` or `.sfdx-hardis` property `apexTestsMinCoverageOrgWide`\n\nYou can override env var SFDX_TEST_WAIT_MINUTES to wait more than 60 minutes.\n\nThis command is part of [sfdx-hardis Monitoring](https://sfdx-hardis.cloudity.com/salesforce-monitoring-apex-tests/) and can output Grafana, Slack and MsTeams Notifications.\n",
7980
7987
  "examples": [
7981
- "$ sf hardis:org:user:activateinvalid",
7982
- "$ sf hardis:org:user:activateinvalid --target-org my-user@myorg.com",
7983
- "$ sf hardis:org:user:activateinvalid --profiles 'System Administrator,MyCustomProfile' --target-org my-user@myorg.com"
7988
+ "$ sf hardis:org:test:apex"
7984
7989
  ],
7985
7990
  "flags": {
7986
7991
  "json": {
@@ -7998,12 +8003,19 @@
7998
8003
  "multiple": false,
7999
8004
  "type": "option"
8000
8005
  },
8001
- "profiles": {
8002
- "char": "p",
8003
- "description": "Comma-separated list of profiles names that you want to reactive users assigned to and with a .invalid email",
8004
- "name": "profiles",
8006
+ "testlevel": {
8007
+ "char": "l",
8008
+ "description": "Level of tests to apply to validate deployment",
8009
+ "name": "testlevel",
8010
+ "default": "RunLocalTests",
8005
8011
  "hasDynamicHelp": false,
8006
8012
  "multiple": false,
8013
+ "options": [
8014
+ "NoTestRun",
8015
+ "RunSpecifiedTests",
8016
+ "RunLocalTests",
8017
+ "RunAllTestsInOrg"
8018
+ ],
8007
8019
  "type": "option"
8008
8020
  },
8009
8021
  "debug": {
@@ -8044,60 +8056,58 @@
8044
8056
  },
8045
8057
  "hasDynamicHelp": true,
8046
8058
  "hiddenAliases": [],
8047
- "id": "hardis:org:user:activateinvalid",
8059
+ "id": "hardis:org:test:apex",
8048
8060
  "pluginAlias": "sfdx-hardis",
8049
8061
  "pluginName": "sfdx-hardis",
8050
8062
  "pluginType": "core",
8051
8063
  "strict": true,
8052
8064
  "enableJsonFlag": true,
8053
- "title": "Reactivate sandbox invalid users",
8054
- "requiresProject": false,
8065
+ "title": "Run apex tests",
8055
8066
  "isESM": true,
8056
8067
  "relativePath": [
8057
8068
  "lib",
8058
8069
  "commands",
8059
8070
  "hardis",
8060
8071
  "org",
8061
- "user",
8062
- "activateinvalid.js"
8072
+ "test",
8073
+ "apex.js"
8063
8074
  ],
8064
8075
  "aliasPermutations": [],
8065
8076
  "permutations": [
8066
- "hardis:org:user:activateinvalid",
8067
- "org:hardis:user:activateinvalid",
8068
- "org:user:hardis:activateinvalid",
8069
- "org:user:activateinvalid:hardis",
8070
- "hardis:user:org:activateinvalid",
8071
- "user:hardis:org:activateinvalid",
8072
- "user:org:hardis:activateinvalid",
8073
- "user:org:activateinvalid:hardis",
8074
- "hardis:user:activateinvalid:org",
8075
- "user:hardis:activateinvalid:org",
8076
- "user:activateinvalid:hardis:org",
8077
- "user:activateinvalid:org:hardis",
8078
- "hardis:org:activateinvalid:user",
8079
- "org:hardis:activateinvalid:user",
8080
- "org:activateinvalid:hardis:user",
8081
- "org:activateinvalid:user:hardis",
8082
- "hardis:activateinvalid:org:user",
8083
- "activateinvalid:hardis:org:user",
8084
- "activateinvalid:org:hardis:user",
8085
- "activateinvalid:org:user:hardis",
8086
- "hardis:activateinvalid:user:org",
8087
- "activateinvalid:hardis:user:org",
8088
- "activateinvalid:user:hardis:org",
8089
- "activateinvalid:user:org:hardis"
8077
+ "hardis:org:test:apex",
8078
+ "org:hardis:test:apex",
8079
+ "org:test:hardis:apex",
8080
+ "org:test:apex:hardis",
8081
+ "hardis:test:org:apex",
8082
+ "test:hardis:org:apex",
8083
+ "test:org:hardis:apex",
8084
+ "test:org:apex:hardis",
8085
+ "hardis:test:apex:org",
8086
+ "test:hardis:apex:org",
8087
+ "test:apex:hardis:org",
8088
+ "test:apex:org:hardis",
8089
+ "hardis:org:apex:test",
8090
+ "org:hardis:apex:test",
8091
+ "org:apex:hardis:test",
8092
+ "org:apex:test:hardis",
8093
+ "hardis:apex:org:test",
8094
+ "apex:hardis:org:test",
8095
+ "apex:org:hardis:test",
8096
+ "apex:org:test:hardis",
8097
+ "hardis:apex:test:org",
8098
+ "apex:hardis:test:org",
8099
+ "apex:test:hardis:org",
8100
+ "apex:test:org:hardis"
8090
8101
  ]
8091
8102
  },
8092
- "hardis:org:user:freeze": {
8103
+ "hardis:org:user:activateinvalid": {
8093
8104
  "aliases": [],
8094
8105
  "args": {},
8095
- "description": "\n## Command Behavior\n\n**Freezes Salesforce user logins, temporarily revoking access for selected users.**\n\nThis command allows administrators to freeze Salesforce user logins. It provides a controlled way to temporarily revoke user access without deactivating the user record itself. This is useful for managing user access during leaves, security incidents, or when a user's access needs to be temporarily suspended.\n\nKey functionalities:\n\n- **User Selection:** You can select users to freeze based on their assigned profiles.\n - `--includeprofiles`: Freeze users belonging to a comma-separated list of specified profiles.\n - `--excludeprofiles`: Freeze users belonging to all profiles *except* those specified in a comma-separated list.\n - If no profile flags are provided, an interactive menu will allow you to select profiles.\n- **Interactive Confirmation:** In non-CI environments, it prompts for confirmation before freezing the selected users.\n- **Bulk Freezing:** Efficiently freezes multiple user logins using Salesforce's Bulk API.\n- **Reporting:** Generates CSV and XLSX reports of the users that are about to be frozen.\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **SOQL Queries (Bulk API):** It executes SOQL queries against the `User` and `Profile` objects to identify active users based on the provided profile filters. It then queries the `UserLogin` object to find active login sessions for these users.\n- **Interactive Prompts:** Uses the `prompts` library to guide the user through profile selection and to confirm the freezing operation.\n- **Bulk Update:** It constructs an array of `UserLogin` records with their `Id` and `IsFrozen` set to `true`, then uses `bulkUpdate` to perform the mass update operation on the Salesforce org.\n- **Reporting:** It uses `generateReports` to create CSV and XLSX files containing details of the users to be frozen.\n- **Logging:** Provides clear messages about the number of users found and the success of the freezing process.\n",
8106
+ "description": "Update sandbox users so their email is valid\n\n Example: replaces `toto@company.com.dev.invalid` with `toto@company.com.dev.invalid`\n\nSee article below\n\n[![Reactivate all the sandbox users with .invalid emails in 3 clicks](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/article-invalid-email.jpg)](https://nicolas.vuillamy.fr/reactivate-all-the-sandbox-users-with-invalid-emails-in-3-clicks-2265af4e3a3d)\n",
8096
8107
  "examples": [
8097
- "$ sf hardis:org:user:freeze",
8098
- "$ sf hardis:org:user:freeze --target-org my-user@myorg.com",
8099
- "$ sf hardis:org:user:freeze --includeprofiles 'Standard'",
8100
- "$ sf hardis:org:user:freeze --excludeprofiles 'System Administrator,Some Other Profile'"
8108
+ "$ sf hardis:org:user:activateinvalid",
8109
+ "$ sf hardis:org:user:activateinvalid --target-org my-user@myorg.com",
8110
+ "$ sf hardis:org:user:activateinvalid --profiles 'System Administrator,MyCustomProfile' --target-org my-user@myorg.com"
8101
8111
  ],
8102
8112
  "flags": {
8103
8113
  "json": {
@@ -8115,35 +8125,10 @@
8115
8125
  "multiple": false,
8116
8126
  "type": "option"
8117
8127
  },
8118
- "name": {
8119
- "char": "n",
8120
- "description": "Filter according to Name criteria",
8121
- "name": "name",
8122
- "hasDynamicHelp": false,
8123
- "multiple": false,
8124
- "type": "option"
8125
- },
8126
- "includeprofiles": {
8128
+ "profiles": {
8127
8129
  "char": "p",
8128
- "description": "List of profiles that you want to freeze, separated by commas",
8129
- "name": "includeprofiles",
8130
- "hasDynamicHelp": false,
8131
- "multiple": false,
8132
- "type": "option"
8133
- },
8134
- "excludeprofiles": {
8135
- "char": "e",
8136
- "description": "List of profiles that you want to NOT freeze, separated by commas",
8137
- "name": "excludeprofiles",
8138
- "hasDynamicHelp": false,
8139
- "multiple": false,
8140
- "type": "option"
8141
- },
8142
- "maxuserdisplay": {
8143
- "char": "m",
8144
- "description": "Maximum users to display in logs",
8145
- "name": "maxuserdisplay",
8146
- "default": 100,
8130
+ "description": "Comma-separated list of profiles names that you want to reactive users assigned to and with a .invalid email",
8131
+ "name": "profiles",
8147
8132
  "hasDynamicHelp": false,
8148
8133
  "multiple": false,
8149
8134
  "type": "option"
@@ -8186,13 +8171,13 @@
8186
8171
  },
8187
8172
  "hasDynamicHelp": true,
8188
8173
  "hiddenAliases": [],
8189
- "id": "hardis:org:user:freeze",
8174
+ "id": "hardis:org:user:activateinvalid",
8190
8175
  "pluginAlias": "sfdx-hardis",
8191
8176
  "pluginName": "sfdx-hardis",
8192
8177
  "pluginType": "core",
8193
8178
  "strict": true,
8194
8179
  "enableJsonFlag": true,
8195
- "title": "Freeze user logins",
8180
+ "title": "Reactivate sandbox invalid users",
8196
8181
  "requiresProject": false,
8197
8182
  "isESM": true,
8198
8183
  "relativePath": [
@@ -8201,45 +8186,45 @@
8201
8186
  "hardis",
8202
8187
  "org",
8203
8188
  "user",
8204
- "freeze.js"
8189
+ "activateinvalid.js"
8205
8190
  ],
8206
8191
  "aliasPermutations": [],
8207
8192
  "permutations": [
8208
- "hardis:org:user:freeze",
8209
- "org:hardis:user:freeze",
8210
- "org:user:hardis:freeze",
8211
- "org:user:freeze:hardis",
8212
- "hardis:user:org:freeze",
8213
- "user:hardis:org:freeze",
8214
- "user:org:hardis:freeze",
8215
- "user:org:freeze:hardis",
8216
- "hardis:user:freeze:org",
8217
- "user:hardis:freeze:org",
8218
- "user:freeze:hardis:org",
8219
- "user:freeze:org:hardis",
8220
- "hardis:org:freeze:user",
8221
- "org:hardis:freeze:user",
8222
- "org:freeze:hardis:user",
8223
- "org:freeze:user:hardis",
8224
- "hardis:freeze:org:user",
8225
- "freeze:hardis:org:user",
8226
- "freeze:org:hardis:user",
8227
- "freeze:org:user:hardis",
8228
- "hardis:freeze:user:org",
8229
- "freeze:hardis:user:org",
8230
- "freeze:user:hardis:org",
8231
- "freeze:user:org:hardis"
8193
+ "hardis:org:user:activateinvalid",
8194
+ "org:hardis:user:activateinvalid",
8195
+ "org:user:hardis:activateinvalid",
8196
+ "org:user:activateinvalid:hardis",
8197
+ "hardis:user:org:activateinvalid",
8198
+ "user:hardis:org:activateinvalid",
8199
+ "user:org:hardis:activateinvalid",
8200
+ "user:org:activateinvalid:hardis",
8201
+ "hardis:user:activateinvalid:org",
8202
+ "user:hardis:activateinvalid:org",
8203
+ "user:activateinvalid:hardis:org",
8204
+ "user:activateinvalid:org:hardis",
8205
+ "hardis:org:activateinvalid:user",
8206
+ "org:hardis:activateinvalid:user",
8207
+ "org:activateinvalid:hardis:user",
8208
+ "org:activateinvalid:user:hardis",
8209
+ "hardis:activateinvalid:org:user",
8210
+ "activateinvalid:hardis:org:user",
8211
+ "activateinvalid:org:hardis:user",
8212
+ "activateinvalid:org:user:hardis",
8213
+ "hardis:activateinvalid:user:org",
8214
+ "activateinvalid:hardis:user:org",
8215
+ "activateinvalid:user:hardis:org",
8216
+ "activateinvalid:user:org:hardis"
8232
8217
  ]
8233
8218
  },
8234
- "hardis:org:user:unfreeze": {
8219
+ "hardis:org:user:freeze": {
8235
8220
  "aliases": [],
8236
8221
  "args": {},
8237
- "description": "\n## Command Behavior\n\n**Unfreezes Salesforce user logins, restoring access for selected users.**\n\nThis command allows administrators to unfreeze Salesforce user logins, reactivating their access to the Salesforce org. This is the counterpart to the `freeze` command and is used to restore access after a temporary suspension.\n\nKey functionalities:\n\n- **User Selection:** You can select users to unfreeze based on their assigned profiles.\n - `--includeprofiles`: Unfreeze users belonging to a comma-separated list of specified profiles.\n - `--excludeprofiles`: Unfreeze users belonging to all profiles *except* those specified in a comma-separated list.\n - If no profile flags are provided, an interactive menu will allow you to select profiles.\n- **Interactive Confirmation:** In non-CI environments, it prompts for confirmation before unfreezing the selected users.\n- **Bulk Unfreezing:** Efficiently unfreezes multiple user logins using Salesforce's Bulk API.\n- **Reporting:** Generates CSV and XLSX reports of the users that are about to be unfrozen.\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **SOQL Queries (Bulk API):** It executes SOQL queries against the `User` and `Profile` objects to identify active users based on the provided profile filters. It then queries the `UserLogin` object to find frozen login sessions for these users.\n- **Interactive Prompts:** Uses the `prompts` library to guide the user through profile selection and to confirm the unfreezing operation.\n- **Bulk Update:** It constructs an array of `UserLogin` records with their `Id` and `IsFrozen` set to `false`, then uses `bulkUpdate` to perform the mass update operation on the Salesforce org.\n- **Reporting:** It uses `generateReports` to create CSV and XLSX files containing details of the users to be unfrozen.\n- **Logging:** Provides clear messages about the number of users found and the success of the unfreezing process.\n",
8222
+ "description": "\n## Command Behavior\n\n**Freezes Salesforce user logins, temporarily revoking access for selected users.**\n\nThis command allows administrators to freeze Salesforce user logins. It provides a controlled way to temporarily revoke user access without deactivating the user record itself. This is useful for managing user access during leaves, security incidents, or when a user's access needs to be temporarily suspended.\n\nKey functionalities:\n\n- **User Selection:** You can select users to freeze based on their assigned profiles.\n - `--includeprofiles`: Freeze users belonging to a comma-separated list of specified profiles.\n - `--excludeprofiles`: Freeze users belonging to all profiles *except* those specified in a comma-separated list.\n - If no profile flags are provided, an interactive menu will allow you to select profiles.\n- **Interactive Confirmation:** In non-CI environments, it prompts for confirmation before freezing the selected users.\n- **Bulk Freezing:** Efficiently freezes multiple user logins using Salesforce's Bulk API.\n- **Reporting:** Generates CSV and XLSX reports of the users that are about to be frozen.\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **SOQL Queries (Bulk API):** It executes SOQL queries against the `User` and `Profile` objects to identify active users based on the provided profile filters. It then queries the `UserLogin` object to find active login sessions for these users.\n- **Interactive Prompts:** Uses the `prompts` library to guide the user through profile selection and to confirm the freezing operation.\n- **Bulk Update:** It constructs an array of `UserLogin` records with their `Id` and `IsFrozen` set to `true`, then uses `bulkUpdate` to perform the mass update operation on the Salesforce org.\n- **Reporting:** It uses `generateReports` to create CSV and XLSX files containing details of the users to be frozen.\n- **Logging:** Provides clear messages about the number of users found and the success of the freezing process.\n",
8238
8223
  "examples": [
8239
- "$ sf hardis:org:user:unfreeze",
8240
- "$ sf hardis:org:user:unfreeze --target-org my-user@myorg.com",
8241
- "$ sf hardis:org:user:unfreeze --includeprofiles 'Standard'",
8242
- "$ sf hardis:org:user:unfreeze --excludeprofiles 'System Administrator,Some Other Profile'"
8224
+ "$ sf hardis:org:user:freeze",
8225
+ "$ sf hardis:org:user:freeze --target-org my-user@myorg.com",
8226
+ "$ sf hardis:org:user:freeze --includeprofiles 'Standard'",
8227
+ "$ sf hardis:org:user:freeze --excludeprofiles 'System Administrator,Some Other Profile'"
8243
8228
  ],
8244
8229
  "flags": {
8245
8230
  "json": {
@@ -8267,7 +8252,7 @@
8267
8252
  },
8268
8253
  "includeprofiles": {
8269
8254
  "char": "p",
8270
- "description": "List of profiles that you want to unfreeze, separated by commas",
8255
+ "description": "List of profiles that you want to freeze, separated by commas",
8271
8256
  "name": "includeprofiles",
8272
8257
  "hasDynamicHelp": false,
8273
8258
  "multiple": false,
@@ -8275,7 +8260,7 @@
8275
8260
  },
8276
8261
  "excludeprofiles": {
8277
8262
  "char": "e",
8278
- "description": "List of profiles that you want to NOT unfreeze, separated by commas",
8263
+ "description": "List of profiles that you want to NOT freeze, separated by commas",
8279
8264
  "name": "excludeprofiles",
8280
8265
  "hasDynamicHelp": false,
8281
8266
  "multiple": false,
@@ -8328,13 +8313,13 @@
8328
8313
  },
8329
8314
  "hasDynamicHelp": true,
8330
8315
  "hiddenAliases": [],
8331
- "id": "hardis:org:user:unfreeze",
8316
+ "id": "hardis:org:user:freeze",
8332
8317
  "pluginAlias": "sfdx-hardis",
8333
8318
  "pluginName": "sfdx-hardis",
8334
8319
  "pluginType": "core",
8335
8320
  "strict": true,
8336
8321
  "enableJsonFlag": true,
8337
- "title": "Unfreeze user logins",
8322
+ "title": "Freeze user logins",
8338
8323
  "requiresProject": false,
8339
8324
  "isESM": true,
8340
8325
  "relativePath": [
@@ -8343,42 +8328,45 @@
8343
8328
  "hardis",
8344
8329
  "org",
8345
8330
  "user",
8346
- "unfreeze.js"
8331
+ "freeze.js"
8347
8332
  ],
8348
8333
  "aliasPermutations": [],
8349
8334
  "permutations": [
8350
- "hardis:org:user:unfreeze",
8351
- "org:hardis:user:unfreeze",
8352
- "org:user:hardis:unfreeze",
8353
- "org:user:unfreeze:hardis",
8354
- "hardis:user:org:unfreeze",
8355
- "user:hardis:org:unfreeze",
8356
- "user:org:hardis:unfreeze",
8357
- "user:org:unfreeze:hardis",
8358
- "hardis:user:unfreeze:org",
8359
- "user:hardis:unfreeze:org",
8360
- "user:unfreeze:hardis:org",
8361
- "user:unfreeze:org:hardis",
8362
- "hardis:org:unfreeze:user",
8363
- "org:hardis:unfreeze:user",
8364
- "org:unfreeze:hardis:user",
8365
- "org:unfreeze:user:hardis",
8366
- "hardis:unfreeze:org:user",
8367
- "unfreeze:hardis:org:user",
8368
- "unfreeze:org:hardis:user",
8369
- "unfreeze:org:user:hardis",
8370
- "hardis:unfreeze:user:org",
8371
- "unfreeze:hardis:user:org",
8372
- "unfreeze:user:hardis:org",
8373
- "unfreeze:user:org:hardis"
8335
+ "hardis:org:user:freeze",
8336
+ "org:hardis:user:freeze",
8337
+ "org:user:hardis:freeze",
8338
+ "org:user:freeze:hardis",
8339
+ "hardis:user:org:freeze",
8340
+ "user:hardis:org:freeze",
8341
+ "user:org:hardis:freeze",
8342
+ "user:org:freeze:hardis",
8343
+ "hardis:user:freeze:org",
8344
+ "user:hardis:freeze:org",
8345
+ "user:freeze:hardis:org",
8346
+ "user:freeze:org:hardis",
8347
+ "hardis:org:freeze:user",
8348
+ "org:hardis:freeze:user",
8349
+ "org:freeze:hardis:user",
8350
+ "org:freeze:user:hardis",
8351
+ "hardis:freeze:org:user",
8352
+ "freeze:hardis:org:user",
8353
+ "freeze:org:hardis:user",
8354
+ "freeze:org:user:hardis",
8355
+ "hardis:freeze:user:org",
8356
+ "freeze:hardis:user:org",
8357
+ "freeze:user:hardis:org",
8358
+ "freeze:user:org:hardis"
8374
8359
  ]
8375
8360
  },
8376
- "hardis:org:test:apex": {
8361
+ "hardis:org:user:unfreeze": {
8377
8362
  "aliases": [],
8378
8363
  "args": {},
8379
- "description": "Run apex tests in Salesforce org\n\nIf following configuration is defined, it will fail if apex coverage target is not reached:\n\n- Env `APEX_TESTS_MIN_COVERAGE_ORG_WIDE` or `.sfdx-hardis` property `apexTestsMinCoverageOrgWide`\n- Env `APEX_TESTS_MIN_COVERAGE_ORG_WIDE` or `.sfdx-hardis` property `apexTestsMinCoverageOrgWide`\n\nYou can override env var SFDX_TEST_WAIT_MINUTES to wait more than 60 minutes.\n\nThis command is part of [sfdx-hardis Monitoring](https://sfdx-hardis.cloudity.com/salesforce-monitoring-apex-tests/) and can output Grafana, Slack and MsTeams Notifications.\n",
8364
+ "description": "\n## Command Behavior\n\n**Unfreezes Salesforce user logins, restoring access for selected users.**\n\nThis command allows administrators to unfreeze Salesforce user logins, reactivating their access to the Salesforce org. This is the counterpart to the `freeze` command and is used to restore access after a temporary suspension.\n\nKey functionalities:\n\n- **User Selection:** You can select users to unfreeze based on their assigned profiles.\n - `--includeprofiles`: Unfreeze users belonging to a comma-separated list of specified profiles.\n - `--excludeprofiles`: Unfreeze users belonging to all profiles *except* those specified in a comma-separated list.\n - If no profile flags are provided, an interactive menu will allow you to select profiles.\n- **Interactive Confirmation:** In non-CI environments, it prompts for confirmation before unfreezing the selected users.\n- **Bulk Unfreezing:** Efficiently unfreezes multiple user logins using Salesforce's Bulk API.\n- **Reporting:** Generates CSV and XLSX reports of the users that are about to be unfrozen.\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **SOQL Queries (Bulk API):** It executes SOQL queries against the `User` and `Profile` objects to identify active users based on the provided profile filters. It then queries the `UserLogin` object to find frozen login sessions for these users.\n- **Interactive Prompts:** Uses the `prompts` library to guide the user through profile selection and to confirm the unfreezing operation.\n- **Bulk Update:** It constructs an array of `UserLogin` records with their `Id` and `IsFrozen` set to `false`, then uses `bulkUpdate` to perform the mass update operation on the Salesforce org.\n- **Reporting:** It uses `generateReports` to create CSV and XLSX files containing details of the users to be unfrozen.\n- **Logging:** Provides clear messages about the number of users found and the success of the unfreezing process.\n",
8380
8365
  "examples": [
8381
- "$ sf hardis:org:test:apex"
8366
+ "$ sf hardis:org:user:unfreeze",
8367
+ "$ sf hardis:org:user:unfreeze --target-org my-user@myorg.com",
8368
+ "$ sf hardis:org:user:unfreeze --includeprofiles 'Standard'",
8369
+ "$ sf hardis:org:user:unfreeze --excludeprofiles 'System Administrator,Some Other Profile'"
8382
8370
  ],
8383
8371
  "flags": {
8384
8372
  "json": {
@@ -8396,19 +8384,37 @@
8396
8384
  "multiple": false,
8397
8385
  "type": "option"
8398
8386
  },
8399
- "testlevel": {
8400
- "char": "l",
8401
- "description": "Level of tests to apply to validate deployment",
8402
- "name": "testlevel",
8403
- "default": "RunLocalTests",
8387
+ "name": {
8388
+ "char": "n",
8389
+ "description": "Filter according to Name criteria",
8390
+ "name": "name",
8391
+ "hasDynamicHelp": false,
8392
+ "multiple": false,
8393
+ "type": "option"
8394
+ },
8395
+ "includeprofiles": {
8396
+ "char": "p",
8397
+ "description": "List of profiles that you want to unfreeze, separated by commas",
8398
+ "name": "includeprofiles",
8399
+ "hasDynamicHelp": false,
8400
+ "multiple": false,
8401
+ "type": "option"
8402
+ },
8403
+ "excludeprofiles": {
8404
+ "char": "e",
8405
+ "description": "List of profiles that you want to NOT unfreeze, separated by commas",
8406
+ "name": "excludeprofiles",
8407
+ "hasDynamicHelp": false,
8408
+ "multiple": false,
8409
+ "type": "option"
8410
+ },
8411
+ "maxuserdisplay": {
8412
+ "char": "m",
8413
+ "description": "Maximum users to display in logs",
8414
+ "name": "maxuserdisplay",
8415
+ "default": 100,
8404
8416
  "hasDynamicHelp": false,
8405
8417
  "multiple": false,
8406
- "options": [
8407
- "NoTestRun",
8408
- "RunSpecifiedTests",
8409
- "RunLocalTests",
8410
- "RunAllTestsInOrg"
8411
- ],
8412
8418
  "type": "option"
8413
8419
  },
8414
8420
  "debug": {
@@ -8449,48 +8455,49 @@
8449
8455
  },
8450
8456
  "hasDynamicHelp": true,
8451
8457
  "hiddenAliases": [],
8452
- "id": "hardis:org:test:apex",
8458
+ "id": "hardis:org:user:unfreeze",
8453
8459
  "pluginAlias": "sfdx-hardis",
8454
8460
  "pluginName": "sfdx-hardis",
8455
8461
  "pluginType": "core",
8456
8462
  "strict": true,
8457
8463
  "enableJsonFlag": true,
8458
- "title": "Run apex tests",
8464
+ "title": "Unfreeze user logins",
8465
+ "requiresProject": false,
8459
8466
  "isESM": true,
8460
8467
  "relativePath": [
8461
8468
  "lib",
8462
8469
  "commands",
8463
8470
  "hardis",
8464
8471
  "org",
8465
- "test",
8466
- "apex.js"
8472
+ "user",
8473
+ "unfreeze.js"
8467
8474
  ],
8468
8475
  "aliasPermutations": [],
8469
8476
  "permutations": [
8470
- "hardis:org:test:apex",
8471
- "org:hardis:test:apex",
8472
- "org:test:hardis:apex",
8473
- "org:test:apex:hardis",
8474
- "hardis:test:org:apex",
8475
- "test:hardis:org:apex",
8476
- "test:org:hardis:apex",
8477
- "test:org:apex:hardis",
8478
- "hardis:test:apex:org",
8479
- "test:hardis:apex:org",
8480
- "test:apex:hardis:org",
8481
- "test:apex:org:hardis",
8482
- "hardis:org:apex:test",
8483
- "org:hardis:apex:test",
8484
- "org:apex:hardis:test",
8485
- "org:apex:test:hardis",
8486
- "hardis:apex:org:test",
8487
- "apex:hardis:org:test",
8488
- "apex:org:hardis:test",
8489
- "apex:org:test:hardis",
8490
- "hardis:apex:test:org",
8491
- "apex:hardis:test:org",
8492
- "apex:test:hardis:org",
8493
- "apex:test:org:hardis"
8477
+ "hardis:org:user:unfreeze",
8478
+ "org:hardis:user:unfreeze",
8479
+ "org:user:hardis:unfreeze",
8480
+ "org:user:unfreeze:hardis",
8481
+ "hardis:user:org:unfreeze",
8482
+ "user:hardis:org:unfreeze",
8483
+ "user:org:hardis:unfreeze",
8484
+ "user:org:unfreeze:hardis",
8485
+ "hardis:user:unfreeze:org",
8486
+ "user:hardis:unfreeze:org",
8487
+ "user:unfreeze:hardis:org",
8488
+ "user:unfreeze:org:hardis",
8489
+ "hardis:org:unfreeze:user",
8490
+ "org:hardis:unfreeze:user",
8491
+ "org:unfreeze:hardis:user",
8492
+ "org:unfreeze:user:hardis",
8493
+ "hardis:unfreeze:org:user",
8494
+ "unfreeze:hardis:org:user",
8495
+ "unfreeze:org:hardis:user",
8496
+ "unfreeze:org:user:hardis",
8497
+ "hardis:unfreeze:user:org",
8498
+ "unfreeze:hardis:user:org",
8499
+ "unfreeze:user:hardis:org",
8500
+ "unfreeze:user:org:hardis"
8494
8501
  ]
8495
8502
  },
8496
8503
  "hardis:package:version:create": {
@@ -8701,158 +8708,46 @@
8701
8708
  "relativePath": [
8702
8709
  "lib",
8703
8710
  "commands",
8704
- "hardis",
8705
- "package",
8706
- "version",
8707
- "list.js"
8708
- ],
8709
- "aliasPermutations": [],
8710
- "permutations": [
8711
- "hardis:package:version:list",
8712
- "package:hardis:version:list",
8713
- "package:version:hardis:list",
8714
- "package:version:list:hardis",
8715
- "hardis:version:package:list",
8716
- "version:hardis:package:list",
8717
- "version:package:hardis:list",
8718
- "version:package:list:hardis",
8719
- "hardis:version:list:package",
8720
- "version:hardis:list:package",
8721
- "version:list:hardis:package",
8722
- "version:list:package:hardis",
8723
- "hardis:package:list:version",
8724
- "package:hardis:list:version",
8725
- "package:list:hardis:version",
8726
- "package:list:version:hardis",
8727
- "hardis:list:package:version",
8728
- "list:hardis:package:version",
8729
- "list:package:hardis:version",
8730
- "list:package:version:hardis",
8731
- "hardis:list:version:package",
8732
- "list:hardis:version:package",
8733
- "list:version:hardis:package",
8734
- "list:version:package:hardis"
8735
- ]
8736
- },
8737
- "hardis:package:version:promote": {
8738
- "aliases": [],
8739
- "args": {},
8740
- "description": "\n## Command Behavior\n\n**Promotes a Salesforce package version from beta to released status in your Dev Hub.**\n\nThis command is a critical step in the package development lifecycle, marking a package version as stable and ready for production use. Once promoted, a package version can be installed in production organizations.\n\nKey functionalities:\n\n- **Package Version Selection:** Allows you to select a specific package version to promote. If the `--auto` flag is used, it automatically identifies package versions that are not yet released and promotes them.\n- **Automated Promotion:** When `--auto` is enabled, it queries for all unreleased package versions and promotes them without further user interaction.\n- **Dev Hub Integration:** Interacts with your connected Dev Hub to change the status of the package version.\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **Package Alias Retrieval:** It retrieves package aliases from your `sfdx-project.json` to identify available packages.\n- **Automated Promotion Logic:** If `--auto` is used, it executes `sf package version list --released` to get a list of already released packages and then filters the available package aliases to find those that are not yet released.\n- **Interactive Prompts:** If not in auto mode, it uses the `prompts` library to allow the user to select a package version to promote.\n- **Salesforce CLI Integration:** It constructs and executes the `sf package version promote` command, passing the package version ID.\n- **`execSfdxJson`:** This utility is used to execute the Salesforce CLI command and capture its JSON output.\n- **Error Handling:** It handles cases where a package version might already be promoted or if other errors occur during the promotion process.\n",
8741
- "examples": [
8742
- "$ sf hardis:package:version:promote",
8743
- "$ sf hardis:package:version:promote --auto"
8744
- ],
8745
- "flags": {
8746
- "json": {
8747
- "description": "Format output as json.",
8748
- "helpGroup": "GLOBAL",
8749
- "name": "json",
8750
- "allowNo": false,
8751
- "type": "boolean"
8752
- },
8753
- "flags-dir": {
8754
- "helpGroup": "GLOBAL",
8755
- "name": "flags-dir",
8756
- "summary": "Import flag values from a directory.",
8757
- "hasDynamicHelp": false,
8758
- "multiple": false,
8759
- "type": "option"
8760
- },
8761
- "auto": {
8762
- "char": "f",
8763
- "description": "Auto-detect which versions of which packages need to be promoted",
8764
- "name": "auto",
8765
- "allowNo": false,
8766
- "type": "boolean"
8767
- },
8768
- "debug": {
8769
- "char": "d",
8770
- "description": "Activate debug mode (more logs)",
8771
- "name": "debug",
8772
- "allowNo": false,
8773
- "type": "boolean"
8774
- },
8775
- "websocket": {
8776
- "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
8777
- "name": "websocket",
8778
- "hasDynamicHelp": false,
8779
- "multiple": false,
8780
- "type": "option"
8781
- },
8782
- "skipauth": {
8783
- "description": "Skip authentication check when a default username is required",
8784
- "name": "skipauth",
8785
- "allowNo": false,
8786
- "type": "boolean"
8787
- },
8788
- "target-dev-hub": {
8789
- "aliases": [
8790
- "targetdevhubusername"
8791
- ],
8792
- "char": "v",
8793
- "deprecateAliases": true,
8794
- "name": "target-dev-hub",
8795
- "noCacheDefault": true,
8796
- "required": true,
8797
- "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
8798
- "hasDynamicHelp": true,
8799
- "multiple": false,
8800
- "type": "option"
8801
- }
8802
- },
8803
- "hasDynamicHelp": true,
8804
- "hiddenAliases": [],
8805
- "id": "hardis:package:version:promote",
8806
- "pluginAlias": "sfdx-hardis",
8807
- "pluginName": "sfdx-hardis",
8808
- "pluginType": "core",
8809
- "strict": true,
8810
- "enableJsonFlag": true,
8811
- "title": "Promote new versions of package(s)",
8812
- "requiresProject": true,
8813
- "isESM": true,
8814
- "relativePath": [
8815
- "lib",
8816
- "commands",
8817
- "hardis",
8818
- "package",
8819
- "version",
8820
- "promote.js"
8821
- ],
8822
- "aliasPermutations": [],
8823
- "permutations": [
8824
- "hardis:package:version:promote",
8825
- "package:hardis:version:promote",
8826
- "package:version:hardis:promote",
8827
- "package:version:promote:hardis",
8828
- "hardis:version:package:promote",
8829
- "version:hardis:package:promote",
8830
- "version:package:hardis:promote",
8831
- "version:package:promote:hardis",
8832
- "hardis:version:promote:package",
8833
- "version:hardis:promote:package",
8834
- "version:promote:hardis:package",
8835
- "version:promote:package:hardis",
8836
- "hardis:package:promote:version",
8837
- "package:hardis:promote:version",
8838
- "package:promote:hardis:version",
8839
- "package:promote:version:hardis",
8840
- "hardis:promote:package:version",
8841
- "promote:hardis:package:version",
8842
- "promote:package:hardis:version",
8843
- "promote:package:version:hardis",
8844
- "hardis:promote:version:package",
8845
- "promote:hardis:version:package",
8846
- "promote:version:hardis:package",
8847
- "promote:version:package:hardis"
8711
+ "hardis",
8712
+ "package",
8713
+ "version",
8714
+ "list.js"
8715
+ ],
8716
+ "aliasPermutations": [],
8717
+ "permutations": [
8718
+ "hardis:package:version:list",
8719
+ "package:hardis:version:list",
8720
+ "package:version:hardis:list",
8721
+ "package:version:list:hardis",
8722
+ "hardis:version:package:list",
8723
+ "version:hardis:package:list",
8724
+ "version:package:hardis:list",
8725
+ "version:package:list:hardis",
8726
+ "hardis:version:list:package",
8727
+ "version:hardis:list:package",
8728
+ "version:list:hardis:package",
8729
+ "version:list:package:hardis",
8730
+ "hardis:package:list:version",
8731
+ "package:hardis:list:version",
8732
+ "package:list:hardis:version",
8733
+ "package:list:version:hardis",
8734
+ "hardis:list:package:version",
8735
+ "list:hardis:package:version",
8736
+ "list:package:hardis:version",
8737
+ "list:package:version:hardis",
8738
+ "hardis:list:version:package",
8739
+ "list:hardis:version:package",
8740
+ "list:version:hardis:package",
8741
+ "list:version:package:hardis"
8848
8742
  ]
8849
8743
  },
8850
- "hardis:project:configure:auth": {
8744
+ "hardis:package:version:promote": {
8851
8745
  "aliases": [],
8852
8746
  "args": {},
8853
- "description": "\n## Command Behavior\n\n**Configures authentication between a Git branch and a target Salesforce org for CI/CD deployments.**\n\nThis command facilitates the setup of automated CI/CD pipelines, enabling seamless deployments from specific Git branches to designated Salesforce orgs. It supports both standard Salesforce orgs and Dev Hub configurations, catering to various enterprise deployment workflows.\n\nKey functionalities include:\n\n- **Org Selection/Login:** Guides the user to select an existing Salesforce org or log in to a new one.\n- **Git Branch Association:** Allows associating a specific Git branch with the chosen Salesforce org.\n- **Merge Target Definition:** Enables defining target Git branches into which the configured branch can merge, ensuring controlled deployment flows.\n- **Salesforce Username Configuration:** Prompts for the Salesforce username to be used by the CI server for deployments.\n- **SSL Certificate Generation:** Automatically generates an SSL certificate for secure authentication.\n\n## Technical explanations\n\nThe command's implementation involves several key technical aspects:\n\n- **SF CLI Integration:** Utilizes \n@salesforce/sf-plugins-core\n for command structure and flag parsing.\n- **Interactive Prompts:** Employs the \nprompts\n library for interactive user input, guiding the configuration process.\n- **Git Integration:** Interacts with Git to retrieve branch information using \n`git().branch([\"--list\", \"-r\"])`\n.\n- **Configuration Management:** Leverages internal utilities (`checkConfig`, `getConfig`, `setConfig`, `setInConfigFile`) to read from and write to project-specific configuration files (e.g., `.sfdx-hardis.<branchName>.yml`).\n- **Salesforce CLI Execution:** Executes Salesforce CLI commands programmatically via `execSfdxJson` for org interactions.\n- **SSL Certificate Generation:** Calls `generateSSLCertificate` to create necessary SSL certificates for JWT-based authentication.\n- **WebSocket Communication:** Uses `WebSocketClient` for potential communication with external tools or processes, such as restarting the command in VS Code.\n- **Dependency Check:** Ensures the presence of `openssl` on the system, which is required for SSL certificate generation.\n",
8747
+ "description": "\n## Command Behavior\n\n**Promotes a Salesforce package version from beta to released status in your Dev Hub.**\n\nThis command is a critical step in the package development lifecycle, marking a package version as stable and ready for production use. Once promoted, a package version can be installed in production organizations.\n\nKey functionalities:\n\n- **Package Version Selection:** Allows you to select a specific package version to promote. If the `--auto` flag is used, it automatically identifies package versions that are not yet released and promotes them.\n- **Automated Promotion:** When `--auto` is enabled, it queries for all unreleased package versions and promotes them without further user interaction.\n- **Dev Hub Integration:** Interacts with your connected Dev Hub to change the status of the package version.\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **Package Alias Retrieval:** It retrieves package aliases from your `sfdx-project.json` to identify available packages.\n- **Automated Promotion Logic:** If `--auto` is used, it executes `sf package version list --released` to get a list of already released packages and then filters the available package aliases to find those that are not yet released.\n- **Interactive Prompts:** If not in auto mode, it uses the `prompts` library to allow the user to select a package version to promote.\n- **Salesforce CLI Integration:** It constructs and executes the `sf package version promote` command, passing the package version ID.\n- **`execSfdxJson`:** This utility is used to execute the Salesforce CLI command and capture its JSON output.\n- **Error Handling:** It handles cases where a package version might already be promoted or if other errors occur during the promotion process.\n",
8854
8748
  "examples": [
8855
- "$ sf hardis:project:configure:auth"
8749
+ "$ sf hardis:package:version:promote",
8750
+ "$ sf hardis:package:version:promote --auto"
8856
8751
  ],
8857
8752
  "flags": {
8858
8753
  "json": {
@@ -8870,10 +8765,10 @@
8870
8765
  "multiple": false,
8871
8766
  "type": "option"
8872
8767
  },
8873
- "devhub": {
8874
- "char": "b",
8875
- "description": "Configure project DevHub",
8876
- "name": "devhub",
8768
+ "auto": {
8769
+ "char": "f",
8770
+ "description": "Auto-detect which versions of which packages need to be promoted",
8771
+ "name": "auto",
8877
8772
  "allowNo": false,
8878
8773
  "type": "boolean"
8879
8774
  },
@@ -8897,20 +8792,6 @@
8897
8792
  "allowNo": false,
8898
8793
  "type": "boolean"
8899
8794
  },
8900
- "target-org": {
8901
- "aliases": [
8902
- "targetusername",
8903
- "u"
8904
- ],
8905
- "char": "o",
8906
- "deprecateAliases": true,
8907
- "name": "target-org",
8908
- "noCacheDefault": true,
8909
- "summary": "Username or alias of the target org.",
8910
- "hasDynamicHelp": true,
8911
- "multiple": false,
8912
- "type": "option"
8913
- },
8914
8795
  "target-dev-hub": {
8915
8796
  "aliases": [
8916
8797
  "targetdevhubusername"
@@ -8919,8 +8800,8 @@
8919
8800
  "deprecateAliases": true,
8920
8801
  "name": "target-dev-hub",
8921
8802
  "noCacheDefault": true,
8922
- "required": false,
8923
- "summary": "Username or alias of the Dev Hub org.",
8803
+ "required": true,
8804
+ "summary": "Username or alias of the Dev Hub org. Not required if the `target-dev-hub` configuration variable is already set.",
8924
8805
  "hasDynamicHelp": true,
8925
8806
  "multiple": false,
8926
8807
  "type": "option"
@@ -8928,52 +8809,49 @@
8928
8809
  },
8929
8810
  "hasDynamicHelp": true,
8930
8811
  "hiddenAliases": [],
8931
- "id": "hardis:project:configure:auth",
8812
+ "id": "hardis:package:version:promote",
8932
8813
  "pluginAlias": "sfdx-hardis",
8933
8814
  "pluginName": "sfdx-hardis",
8934
8815
  "pluginType": "core",
8935
8816
  "strict": true,
8936
8817
  "enableJsonFlag": true,
8937
- "title": "Configure authentication",
8938
- "requiresProject": false,
8939
- "requiresDependencies": [
8940
- "openssl"
8941
- ],
8818
+ "title": "Promote new versions of package(s)",
8819
+ "requiresProject": true,
8942
8820
  "isESM": true,
8943
8821
  "relativePath": [
8944
8822
  "lib",
8945
8823
  "commands",
8946
8824
  "hardis",
8947
- "project",
8948
- "configure",
8949
- "auth.js"
8825
+ "package",
8826
+ "version",
8827
+ "promote.js"
8950
8828
  ],
8951
8829
  "aliasPermutations": [],
8952
8830
  "permutations": [
8953
- "hardis:project:configure:auth",
8954
- "project:hardis:configure:auth",
8955
- "project:configure:hardis:auth",
8956
- "project:configure:auth:hardis",
8957
- "hardis:configure:project:auth",
8958
- "configure:hardis:project:auth",
8959
- "configure:project:hardis:auth",
8960
- "configure:project:auth:hardis",
8961
- "hardis:configure:auth:project",
8962
- "configure:hardis:auth:project",
8963
- "configure:auth:hardis:project",
8964
- "configure:auth:project:hardis",
8965
- "hardis:project:auth:configure",
8966
- "project:hardis:auth:configure",
8967
- "project:auth:hardis:configure",
8968
- "project:auth:configure:hardis",
8969
- "hardis:auth:project:configure",
8970
- "auth:hardis:project:configure",
8971
- "auth:project:hardis:configure",
8972
- "auth:project:configure:hardis",
8973
- "hardis:auth:configure:project",
8974
- "auth:hardis:configure:project",
8975
- "auth:configure:hardis:project",
8976
- "auth:configure:project:hardis"
8831
+ "hardis:package:version:promote",
8832
+ "package:hardis:version:promote",
8833
+ "package:version:hardis:promote",
8834
+ "package:version:promote:hardis",
8835
+ "hardis:version:package:promote",
8836
+ "version:hardis:package:promote",
8837
+ "version:package:hardis:promote",
8838
+ "version:package:promote:hardis",
8839
+ "hardis:version:promote:package",
8840
+ "version:hardis:promote:package",
8841
+ "version:promote:hardis:package",
8842
+ "version:promote:package:hardis",
8843
+ "hardis:package:promote:version",
8844
+ "package:hardis:promote:version",
8845
+ "package:promote:hardis:version",
8846
+ "package:promote:version:hardis",
8847
+ "hardis:promote:package:version",
8848
+ "promote:hardis:package:version",
8849
+ "promote:package:hardis:version",
8850
+ "promote:package:version:hardis",
8851
+ "hardis:promote:version:package",
8852
+ "promote:hardis:version:package",
8853
+ "promote:version:hardis:package",
8854
+ "promote:version:package:hardis"
8977
8855
  ]
8978
8856
  },
8979
8857
  "hardis:project:audit:apiversion": {
@@ -9389,6 +9267,135 @@
9389
9267
  "remotesites:audit:project:hardis"
9390
9268
  ]
9391
9269
  },
9270
+ "hardis:project:configure:auth": {
9271
+ "aliases": [],
9272
+ "args": {},
9273
+ "description": "\n## Command Behavior\n\n**Configures authentication between a Git branch and a target Salesforce org for CI/CD deployments.**\n\nThis command facilitates the setup of automated CI/CD pipelines, enabling seamless deployments from specific Git branches to designated Salesforce orgs. It supports both standard Salesforce orgs and Dev Hub configurations, catering to various enterprise deployment workflows.\n\nKey functionalities include:\n\n- **Org Selection/Login:** Guides the user to select an existing Salesforce org or log in to a new one.\n- **Git Branch Association:** Allows associating a specific Git branch with the chosen Salesforce org.\n- **Merge Target Definition:** Enables defining target Git branches into which the configured branch can merge, ensuring controlled deployment flows.\n- **Salesforce Username Configuration:** Prompts for the Salesforce username to be used by the CI server for deployments.\n- **SSL Certificate Generation:** Automatically generates an SSL certificate for secure authentication.\n\n## Technical explanations\n\nThe command's implementation involves several key technical aspects:\n\n- **SF CLI Integration:** Utilizes \n@salesforce/sf-plugins-core\n for command structure and flag parsing.\n- **Interactive Prompts:** Employs the \nprompts\n library for interactive user input, guiding the configuration process.\n- **Git Integration:** Interacts with Git to retrieve branch information using \n`git().branch([\"--list\", \"-r\"])`\n.\n- **Configuration Management:** Leverages internal utilities (`checkConfig`, `getConfig`, `setConfig`, `setInConfigFile`) to read from and write to project-specific configuration files (e.g., `.sfdx-hardis.<branchName>.yml`).\n- **Salesforce CLI Execution:** Executes Salesforce CLI commands programmatically via `execSfdxJson` for org interactions.\n- **SSL Certificate Generation:** Calls `generateSSLCertificate` to create necessary SSL certificates for JWT-based authentication.\n- **WebSocket Communication:** Uses `WebSocketClient` for potential communication with external tools or processes, such as restarting the command in VS Code.\n- **Dependency Check:** Ensures the presence of `openssl` on the system, which is required for SSL certificate generation.\n",
9274
+ "examples": [
9275
+ "$ sf hardis:project:configure:auth"
9276
+ ],
9277
+ "flags": {
9278
+ "json": {
9279
+ "description": "Format output as json.",
9280
+ "helpGroup": "GLOBAL",
9281
+ "name": "json",
9282
+ "allowNo": false,
9283
+ "type": "boolean"
9284
+ },
9285
+ "flags-dir": {
9286
+ "helpGroup": "GLOBAL",
9287
+ "name": "flags-dir",
9288
+ "summary": "Import flag values from a directory.",
9289
+ "hasDynamicHelp": false,
9290
+ "multiple": false,
9291
+ "type": "option"
9292
+ },
9293
+ "devhub": {
9294
+ "char": "b",
9295
+ "description": "Configure project DevHub",
9296
+ "name": "devhub",
9297
+ "allowNo": false,
9298
+ "type": "boolean"
9299
+ },
9300
+ "debug": {
9301
+ "char": "d",
9302
+ "description": "Activate debug mode (more logs)",
9303
+ "name": "debug",
9304
+ "allowNo": false,
9305
+ "type": "boolean"
9306
+ },
9307
+ "websocket": {
9308
+ "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
9309
+ "name": "websocket",
9310
+ "hasDynamicHelp": false,
9311
+ "multiple": false,
9312
+ "type": "option"
9313
+ },
9314
+ "skipauth": {
9315
+ "description": "Skip authentication check when a default username is required",
9316
+ "name": "skipauth",
9317
+ "allowNo": false,
9318
+ "type": "boolean"
9319
+ },
9320
+ "target-org": {
9321
+ "aliases": [
9322
+ "targetusername",
9323
+ "u"
9324
+ ],
9325
+ "char": "o",
9326
+ "deprecateAliases": true,
9327
+ "name": "target-org",
9328
+ "noCacheDefault": true,
9329
+ "summary": "Username or alias of the target org.",
9330
+ "hasDynamicHelp": true,
9331
+ "multiple": false,
9332
+ "type": "option"
9333
+ },
9334
+ "target-dev-hub": {
9335
+ "aliases": [
9336
+ "targetdevhubusername"
9337
+ ],
9338
+ "char": "v",
9339
+ "deprecateAliases": true,
9340
+ "name": "target-dev-hub",
9341
+ "noCacheDefault": true,
9342
+ "required": false,
9343
+ "summary": "Username or alias of the Dev Hub org.",
9344
+ "hasDynamicHelp": true,
9345
+ "multiple": false,
9346
+ "type": "option"
9347
+ }
9348
+ },
9349
+ "hasDynamicHelp": true,
9350
+ "hiddenAliases": [],
9351
+ "id": "hardis:project:configure:auth",
9352
+ "pluginAlias": "sfdx-hardis",
9353
+ "pluginName": "sfdx-hardis",
9354
+ "pluginType": "core",
9355
+ "strict": true,
9356
+ "enableJsonFlag": true,
9357
+ "title": "Configure authentication",
9358
+ "requiresProject": false,
9359
+ "requiresDependencies": [
9360
+ "openssl"
9361
+ ],
9362
+ "isESM": true,
9363
+ "relativePath": [
9364
+ "lib",
9365
+ "commands",
9366
+ "hardis",
9367
+ "project",
9368
+ "configure",
9369
+ "auth.js"
9370
+ ],
9371
+ "aliasPermutations": [],
9372
+ "permutations": [
9373
+ "hardis:project:configure:auth",
9374
+ "project:hardis:configure:auth",
9375
+ "project:configure:hardis:auth",
9376
+ "project:configure:auth:hardis",
9377
+ "hardis:configure:project:auth",
9378
+ "configure:hardis:project:auth",
9379
+ "configure:project:hardis:auth",
9380
+ "configure:project:auth:hardis",
9381
+ "hardis:configure:auth:project",
9382
+ "configure:hardis:auth:project",
9383
+ "configure:auth:hardis:project",
9384
+ "configure:auth:project:hardis",
9385
+ "hardis:project:auth:configure",
9386
+ "project:hardis:auth:configure",
9387
+ "project:auth:hardis:configure",
9388
+ "project:auth:configure:hardis",
9389
+ "hardis:auth:project:configure",
9390
+ "auth:hardis:project:configure",
9391
+ "auth:project:hardis:configure",
9392
+ "auth:project:configure:hardis",
9393
+ "hardis:auth:configure:project",
9394
+ "auth:hardis:configure:project",
9395
+ "auth:configure:hardis:project",
9396
+ "auth:configure:project:hardis"
9397
+ ]
9398
+ },
9392
9399
  "hardis:project:convert:profilestopermsets": {
9393
9400
  "aliases": [],
9394
9401
  "args": {},
@@ -10934,262 +10941,47 @@
10934
10941
  "hiddenAliases": [],
10935
10942
  "id": "hardis:project:clean:xml",
10936
10943
  "pluginAlias": "sfdx-hardis",
10937
- "pluginName": "sfdx-hardis",
10938
- "pluginType": "core",
10939
- "strict": true,
10940
- "enableJsonFlag": true,
10941
- "title": "Clean retrieved empty items in dx sources",
10942
- "requiresProject": true,
10943
- "isESM": true,
10944
- "relativePath": [
10945
- "lib",
10946
- "commands",
10947
- "hardis",
10948
- "project",
10949
- "clean",
10950
- "xml.js"
10951
- ],
10952
- "aliasPermutations": [],
10953
- "permutations": [
10954
- "hardis:project:clean:xml",
10955
- "project:hardis:clean:xml",
10956
- "project:clean:hardis:xml",
10957
- "project:clean:xml:hardis",
10958
- "hardis:clean:project:xml",
10959
- "clean:hardis:project:xml",
10960
- "clean:project:hardis:xml",
10961
- "clean:project:xml:hardis",
10962
- "hardis:clean:xml:project",
10963
- "clean:hardis:xml:project",
10964
- "clean:xml:hardis:project",
10965
- "clean:xml:project:hardis",
10966
- "hardis:project:xml:clean",
10967
- "project:hardis:xml:clean",
10968
- "project:xml:hardis:clean",
10969
- "project:xml:clean:hardis",
10970
- "hardis:xml:project:clean",
10971
- "xml:hardis:project:clean",
10972
- "xml:project:hardis:clean",
10973
- "xml:project:clean:hardis",
10974
- "hardis:xml:clean:project",
10975
- "xml:hardis:clean:project",
10976
- "xml:clean:hardis:project",
10977
- "xml:clean:project:hardis"
10978
- ]
10979
- },
10980
- "hardis:project:fix:profiletabs": {
10981
- "aliases": [],
10982
- "args": {},
10983
- "description": "\n## Command Behavior\n\n**Interactively updates tab visibility settings in Salesforce profiles, addressing a common issue where tab visibilities are not correctly retrieved by `sf project retrieve start`.**\n\nThis command provides a user-friendly interface to manage tab settings within your profile XML files, ensuring that your local project accurately reflects the intended tab configurations in your Salesforce org.\n\nKey functionalities:\n\n- **Interactive Tab Selection:** Displays a multi-select menu of all available tabs in your org, allowing you to choose which tabs to update.\n- **Visibility Control:** Lets you set the visibility for the selected tabs to either `DefaultOn` (Visible) or `Hidden`.\n- **Profile Selection:** Presents a multi-select menu of all .profile-meta.xml files in your project, allowing you to apply the tab visibility changes to specific profiles.\n- **XML Updates:** Modifies the <tabVisibilities> section of the selected profile XML files to reflect the chosen tab settings. If a tab visibility setting already exists for a selected tab, it will be updated; otherwise, a new one will be added.\n- **Sorted Output:** The <tabVisibilities> in the updated profile XML files are sorted alphabetically for consistency and readability.\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **SOQL Queries (Tooling API):** It queries the `TabDefinition` object using `soqlQueryTooling` to retrieve a list of all available tabs in the target org.\n- **File Discovery:** Uses `glob` to find all .profile-meta.xml files within the specified project path.\n- **Interactive Prompts:** Leverages the `prompts` library to create interactive menus for selecting tabs, visibility settings, and profiles.\n- **XML Parsing and Manipulation:** Uses `parseXmlFile` to read the content of profile XML files and `writeXmlFile` to write the modified content back. It manipulates the `tabVisibilities` array within the parsed XML to add or update tab settings.\n- **Array Sorting:** Employs the `sort-array` library to sort the `tabVisibilities` alphabetically by tab name.\n- **Logging:** Provides feedback to the user about which profiles have been updated and a summary of the changes.\n",
10984
- "examples": [
10985
- "$ sf hardis:project:fix:profiletabs"
10986
- ],
10987
- "flags": {
10988
- "json": {
10989
- "description": "Format output as json.",
10990
- "helpGroup": "GLOBAL",
10991
- "name": "json",
10992
- "allowNo": false,
10993
- "type": "boolean"
10994
- },
10995
- "flags-dir": {
10996
- "helpGroup": "GLOBAL",
10997
- "name": "flags-dir",
10998
- "summary": "Import flag values from a directory.",
10999
- "hasDynamicHelp": false,
11000
- "multiple": false,
11001
- "type": "option"
11002
- },
11003
- "path": {
11004
- "char": "p",
11005
- "description": "Root folder",
11006
- "name": "path",
11007
- "default": "/home/runner/work/sfdx-hardis/sfdx-hardis",
11008
- "hasDynamicHelp": false,
11009
- "multiple": false,
11010
- "type": "option"
11011
- },
11012
- "debug": {
11013
- "char": "d",
11014
- "description": "Activate debug mode (more logs)",
11015
- "name": "debug",
11016
- "allowNo": false,
11017
- "type": "boolean"
11018
- },
11019
- "websocket": {
11020
- "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
11021
- "name": "websocket",
11022
- "hasDynamicHelp": false,
11023
- "multiple": false,
11024
- "type": "option"
11025
- },
11026
- "skipauth": {
11027
- "description": "Skip authentication check when a default username is required",
11028
- "name": "skipauth",
11029
- "allowNo": false,
11030
- "type": "boolean"
11031
- },
11032
- "target-org": {
11033
- "aliases": [
11034
- "targetusername",
11035
- "u"
11036
- ],
11037
- "char": "o",
11038
- "deprecateAliases": true,
11039
- "name": "target-org",
11040
- "noCacheDefault": true,
11041
- "required": true,
11042
- "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
11043
- "hasDynamicHelp": true,
11044
- "multiple": false,
11045
- "type": "option"
11046
- }
11047
- },
11048
- "hasDynamicHelp": true,
11049
- "hiddenAliases": [],
11050
- "id": "hardis:project:fix:profiletabs",
11051
- "pluginAlias": "sfdx-hardis",
11052
- "pluginName": "sfdx-hardis",
11053
- "pluginType": "core",
11054
- "strict": true,
11055
- "enableJsonFlag": true,
11056
- "title": "Fix profiles to add tabs that are not retrieved by SF CLI",
11057
- "requiresProject": true,
11058
- "isESM": true,
11059
- "relativePath": [
11060
- "lib",
11061
- "commands",
11062
- "hardis",
11063
- "project",
11064
- "fix",
11065
- "profiletabs.js"
11066
- ],
11067
- "aliasPermutations": [],
11068
- "permutations": [
11069
- "hardis:project:fix:profiletabs",
11070
- "project:hardis:fix:profiletabs",
11071
- "project:fix:hardis:profiletabs",
11072
- "project:fix:profiletabs:hardis",
11073
- "hardis:fix:project:profiletabs",
11074
- "fix:hardis:project:profiletabs",
11075
- "fix:project:hardis:profiletabs",
11076
- "fix:project:profiletabs:hardis",
11077
- "hardis:fix:profiletabs:project",
11078
- "fix:hardis:profiletabs:project",
11079
- "fix:profiletabs:hardis:project",
11080
- "fix:profiletabs:project:hardis",
11081
- "hardis:project:profiletabs:fix",
11082
- "project:hardis:profiletabs:fix",
11083
- "project:profiletabs:hardis:fix",
11084
- "project:profiletabs:fix:hardis",
11085
- "hardis:profiletabs:project:fix",
11086
- "profiletabs:hardis:project:fix",
11087
- "profiletabs:project:hardis:fix",
11088
- "profiletabs:project:fix:hardis",
11089
- "hardis:profiletabs:fix:project",
11090
- "profiletabs:hardis:fix:project",
11091
- "profiletabs:fix:hardis:project",
11092
- "profiletabs:fix:project:hardis"
11093
- ]
11094
- },
11095
- "hardis:project:fix:v53flexipages": {
11096
- "aliases": [],
11097
- "args": {},
11098
- "description": "\n## Command Behavior\n\n**Fixes Salesforce FlexiPages for compatibility with API Version 53.0 (Winter '22 release) by adding missing identifiers to component instances.**\n\nSalesforce introduced a change in API Version 53.0 that requires `identifier` tags within `componentInstance` and `fieldInstance` elements in FlexiPage metadata. If these identifiers are missing, deployments to orgs with API version 53.0 or higher will fail. This command automates the process of adding these missing identifiers, ensuring your FlexiPages remain deployable.\n\nKey functionalities:\n\n- **Targeted FlexiPage Processing:** Scans all .flexipage-meta.xml files within the specified root folder (defaults to current working directory).\n- **Identifier Injection:** Inserts a unique `identifier` tag (e.g., `SFDX_HARDIS_REPLACEMENT_ID`) into `componentInstance` and `fieldInstance` elements that lack one.\n\n**Important Note:** After running this command, ensure you update your `apiVersion` to `53.0` (or higher) in your `package.xml` and `sfdx-project.json` files.\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **File Discovery:** Uses `glob` to find all .flexipage-meta.xml files.\n- **Content Reading:** Reads the XML content of each FlexiPage file.\n- **Regular Expression Replacement:** Employs a set of regular expressions to identify specific XML patterns (componentName.../componentName.../componentInstance, componentName.../componentName.../visibilityRule, fieldItem.../fieldItem.../fieldInstance) that are missing the `identifier` tag.\n- **Dynamic ID Generation:** For each match, it generates a unique identifier (e.g., `sfdxHardisIdX`) and injects it into the XML structure.\n- **File Writing:** If changes are made, the modified XML content is written back to the FlexiPage file using `fs.writeFile`.\n- **Logging:** Provides messages about which FlexiPages are being processed and a summary of the total number of identifiers added.\n",
11099
- "examples": [
11100
- "$ sf hardis:project:fix:v53flexipages"
11101
- ],
11102
- "flags": {
11103
- "json": {
11104
- "description": "Format output as json.",
11105
- "helpGroup": "GLOBAL",
11106
- "name": "json",
11107
- "allowNo": false,
11108
- "type": "boolean"
11109
- },
11110
- "flags-dir": {
11111
- "helpGroup": "GLOBAL",
11112
- "name": "flags-dir",
11113
- "summary": "Import flag values from a directory.",
11114
- "hasDynamicHelp": false,
11115
- "multiple": false,
11116
- "type": "option"
11117
- },
11118
- "path": {
11119
- "char": "p",
11120
- "description": "Root folder",
11121
- "name": "path",
11122
- "default": "/home/runner/work/sfdx-hardis/sfdx-hardis",
11123
- "hasDynamicHelp": false,
11124
- "multiple": false,
11125
- "type": "option"
11126
- },
11127
- "debug": {
11128
- "char": "d",
11129
- "description": "Activate debug mode (more logs)",
11130
- "name": "debug",
11131
- "allowNo": false,
11132
- "type": "boolean"
11133
- },
11134
- "websocket": {
11135
- "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
11136
- "name": "websocket",
11137
- "hasDynamicHelp": false,
11138
- "multiple": false,
11139
- "type": "option"
11140
- },
11141
- "skipauth": {
11142
- "description": "Skip authentication check when a default username is required",
11143
- "name": "skipauth",
11144
- "allowNo": false,
11145
- "type": "boolean"
11146
- }
11147
- },
11148
- "hasDynamicHelp": false,
11149
- "hiddenAliases": [],
11150
- "id": "hardis:project:fix:v53flexipages",
11151
- "pluginAlias": "sfdx-hardis",
11152
- "pluginName": "sfdx-hardis",
11153
- "pluginType": "core",
11154
- "strict": true,
11155
- "enableJsonFlag": true,
11156
- "title": "Fix flexipages for v53",
11157
- "requiresProject": true,
11158
- "isESM": true,
11159
- "relativePath": [
11160
- "lib",
11161
- "commands",
11162
- "hardis",
11163
- "project",
11164
- "fix",
11165
- "v53flexipages.js"
11166
- ],
11167
- "aliasPermutations": [],
11168
- "permutations": [
11169
- "hardis:project:fix:v53flexipages",
11170
- "project:hardis:fix:v53flexipages",
11171
- "project:fix:hardis:v53flexipages",
11172
- "project:fix:v53flexipages:hardis",
11173
- "hardis:fix:project:v53flexipages",
11174
- "fix:hardis:project:v53flexipages",
11175
- "fix:project:hardis:v53flexipages",
11176
- "fix:project:v53flexipages:hardis",
11177
- "hardis:fix:v53flexipages:project",
11178
- "fix:hardis:v53flexipages:project",
11179
- "fix:v53flexipages:hardis:project",
11180
- "fix:v53flexipages:project:hardis",
11181
- "hardis:project:v53flexipages:fix",
11182
- "project:hardis:v53flexipages:fix",
11183
- "project:v53flexipages:hardis:fix",
11184
- "project:v53flexipages:fix:hardis",
11185
- "hardis:v53flexipages:project:fix",
11186
- "v53flexipages:hardis:project:fix",
11187
- "v53flexipages:project:hardis:fix",
11188
- "v53flexipages:project:fix:hardis",
11189
- "hardis:v53flexipages:fix:project",
11190
- "v53flexipages:hardis:fix:project",
11191
- "v53flexipages:fix:hardis:project",
11192
- "v53flexipages:fix:project:hardis"
10944
+ "pluginName": "sfdx-hardis",
10945
+ "pluginType": "core",
10946
+ "strict": true,
10947
+ "enableJsonFlag": true,
10948
+ "title": "Clean retrieved empty items in dx sources",
10949
+ "requiresProject": true,
10950
+ "isESM": true,
10951
+ "relativePath": [
10952
+ "lib",
10953
+ "commands",
10954
+ "hardis",
10955
+ "project",
10956
+ "clean",
10957
+ "xml.js"
10958
+ ],
10959
+ "aliasPermutations": [],
10960
+ "permutations": [
10961
+ "hardis:project:clean:xml",
10962
+ "project:hardis:clean:xml",
10963
+ "project:clean:hardis:xml",
10964
+ "project:clean:xml:hardis",
10965
+ "hardis:clean:project:xml",
10966
+ "clean:hardis:project:xml",
10967
+ "clean:project:hardis:xml",
10968
+ "clean:project:xml:hardis",
10969
+ "hardis:clean:xml:project",
10970
+ "clean:hardis:xml:project",
10971
+ "clean:xml:hardis:project",
10972
+ "clean:xml:project:hardis",
10973
+ "hardis:project:xml:clean",
10974
+ "project:hardis:xml:clean",
10975
+ "project:xml:hardis:clean",
10976
+ "project:xml:clean:hardis",
10977
+ "hardis:xml:project:clean",
10978
+ "xml:hardis:project:clean",
10979
+ "xml:project:hardis:clean",
10980
+ "xml:project:clean:hardis",
10981
+ "hardis:xml:clean:project",
10982
+ "xml:hardis:clean:project",
10983
+ "xml:clean:hardis:project",
10984
+ "xml:clean:project:hardis"
11193
10985
  ]
11194
10986
  },
11195
10987
  "hardis:project:deploy:notify": {
@@ -12367,6 +12159,221 @@
12367
12159
  "validate:deploy:project:hardis"
12368
12160
  ]
12369
12161
  },
12162
+ "hardis:project:fix:profiletabs": {
12163
+ "aliases": [],
12164
+ "args": {},
12165
+ "description": "\n## Command Behavior\n\n**Interactively updates tab visibility settings in Salesforce profiles, addressing a common issue where tab visibilities are not correctly retrieved by `sf project retrieve start`.**\n\nThis command provides a user-friendly interface to manage tab settings within your profile XML files, ensuring that your local project accurately reflects the intended tab configurations in your Salesforce org.\n\nKey functionalities:\n\n- **Interactive Tab Selection:** Displays a multi-select menu of all available tabs in your org, allowing you to choose which tabs to update.\n- **Visibility Control:** Lets you set the visibility for the selected tabs to either `DefaultOn` (Visible) or `Hidden`.\n- **Profile Selection:** Presents a multi-select menu of all .profile-meta.xml files in your project, allowing you to apply the tab visibility changes to specific profiles.\n- **XML Updates:** Modifies the <tabVisibilities> section of the selected profile XML files to reflect the chosen tab settings. If a tab visibility setting already exists for a selected tab, it will be updated; otherwise, a new one will be added.\n- **Sorted Output:** The <tabVisibilities> in the updated profile XML files are sorted alphabetically for consistency and readability.\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **SOQL Queries (Tooling API):** It queries the `TabDefinition` object using `soqlQueryTooling` to retrieve a list of all available tabs in the target org.\n- **File Discovery:** Uses `glob` to find all .profile-meta.xml files within the specified project path.\n- **Interactive Prompts:** Leverages the `prompts` library to create interactive menus for selecting tabs, visibility settings, and profiles.\n- **XML Parsing and Manipulation:** Uses `parseXmlFile` to read the content of profile XML files and `writeXmlFile` to write the modified content back. It manipulates the `tabVisibilities` array within the parsed XML to add or update tab settings.\n- **Array Sorting:** Employs the `sort-array` library to sort the `tabVisibilities` alphabetically by tab name.\n- **Logging:** Provides feedback to the user about which profiles have been updated and a summary of the changes.\n",
12166
+ "examples": [
12167
+ "$ sf hardis:project:fix:profiletabs"
12168
+ ],
12169
+ "flags": {
12170
+ "json": {
12171
+ "description": "Format output as json.",
12172
+ "helpGroup": "GLOBAL",
12173
+ "name": "json",
12174
+ "allowNo": false,
12175
+ "type": "boolean"
12176
+ },
12177
+ "flags-dir": {
12178
+ "helpGroup": "GLOBAL",
12179
+ "name": "flags-dir",
12180
+ "summary": "Import flag values from a directory.",
12181
+ "hasDynamicHelp": false,
12182
+ "multiple": false,
12183
+ "type": "option"
12184
+ },
12185
+ "path": {
12186
+ "char": "p",
12187
+ "description": "Root folder",
12188
+ "name": "path",
12189
+ "default": "/home/runner/work/sfdx-hardis/sfdx-hardis",
12190
+ "hasDynamicHelp": false,
12191
+ "multiple": false,
12192
+ "type": "option"
12193
+ },
12194
+ "debug": {
12195
+ "char": "d",
12196
+ "description": "Activate debug mode (more logs)",
12197
+ "name": "debug",
12198
+ "allowNo": false,
12199
+ "type": "boolean"
12200
+ },
12201
+ "websocket": {
12202
+ "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
12203
+ "name": "websocket",
12204
+ "hasDynamicHelp": false,
12205
+ "multiple": false,
12206
+ "type": "option"
12207
+ },
12208
+ "skipauth": {
12209
+ "description": "Skip authentication check when a default username is required",
12210
+ "name": "skipauth",
12211
+ "allowNo": false,
12212
+ "type": "boolean"
12213
+ },
12214
+ "target-org": {
12215
+ "aliases": [
12216
+ "targetusername",
12217
+ "u"
12218
+ ],
12219
+ "char": "o",
12220
+ "deprecateAliases": true,
12221
+ "name": "target-org",
12222
+ "noCacheDefault": true,
12223
+ "required": true,
12224
+ "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
12225
+ "hasDynamicHelp": true,
12226
+ "multiple": false,
12227
+ "type": "option"
12228
+ }
12229
+ },
12230
+ "hasDynamicHelp": true,
12231
+ "hiddenAliases": [],
12232
+ "id": "hardis:project:fix:profiletabs",
12233
+ "pluginAlias": "sfdx-hardis",
12234
+ "pluginName": "sfdx-hardis",
12235
+ "pluginType": "core",
12236
+ "strict": true,
12237
+ "enableJsonFlag": true,
12238
+ "title": "Fix profiles to add tabs that are not retrieved by SF CLI",
12239
+ "requiresProject": true,
12240
+ "isESM": true,
12241
+ "relativePath": [
12242
+ "lib",
12243
+ "commands",
12244
+ "hardis",
12245
+ "project",
12246
+ "fix",
12247
+ "profiletabs.js"
12248
+ ],
12249
+ "aliasPermutations": [],
12250
+ "permutations": [
12251
+ "hardis:project:fix:profiletabs",
12252
+ "project:hardis:fix:profiletabs",
12253
+ "project:fix:hardis:profiletabs",
12254
+ "project:fix:profiletabs:hardis",
12255
+ "hardis:fix:project:profiletabs",
12256
+ "fix:hardis:project:profiletabs",
12257
+ "fix:project:hardis:profiletabs",
12258
+ "fix:project:profiletabs:hardis",
12259
+ "hardis:fix:profiletabs:project",
12260
+ "fix:hardis:profiletabs:project",
12261
+ "fix:profiletabs:hardis:project",
12262
+ "fix:profiletabs:project:hardis",
12263
+ "hardis:project:profiletabs:fix",
12264
+ "project:hardis:profiletabs:fix",
12265
+ "project:profiletabs:hardis:fix",
12266
+ "project:profiletabs:fix:hardis",
12267
+ "hardis:profiletabs:project:fix",
12268
+ "profiletabs:hardis:project:fix",
12269
+ "profiletabs:project:hardis:fix",
12270
+ "profiletabs:project:fix:hardis",
12271
+ "hardis:profiletabs:fix:project",
12272
+ "profiletabs:hardis:fix:project",
12273
+ "profiletabs:fix:hardis:project",
12274
+ "profiletabs:fix:project:hardis"
12275
+ ]
12276
+ },
12277
+ "hardis:project:fix:v53flexipages": {
12278
+ "aliases": [],
12279
+ "args": {},
12280
+ "description": "\n## Command Behavior\n\n**Fixes Salesforce FlexiPages for compatibility with API Version 53.0 (Winter '22 release) by adding missing identifiers to component instances.**\n\nSalesforce introduced a change in API Version 53.0 that requires `identifier` tags within `componentInstance` and `fieldInstance` elements in FlexiPage metadata. If these identifiers are missing, deployments to orgs with API version 53.0 or higher will fail. This command automates the process of adding these missing identifiers, ensuring your FlexiPages remain deployable.\n\nKey functionalities:\n\n- **Targeted FlexiPage Processing:** Scans all .flexipage-meta.xml files within the specified root folder (defaults to current working directory).\n- **Identifier Injection:** Inserts a unique `identifier` tag (e.g., `SFDX_HARDIS_REPLACEMENT_ID`) into `componentInstance` and `fieldInstance` elements that lack one.\n\n**Important Note:** After running this command, ensure you update your `apiVersion` to `53.0` (or higher) in your `package.xml` and `sfdx-project.json` files.\n\n## Technical explanations\n\nThe command's technical implementation involves:\n\n- **File Discovery:** Uses `glob` to find all .flexipage-meta.xml files.\n- **Content Reading:** Reads the XML content of each FlexiPage file.\n- **Regular Expression Replacement:** Employs a set of regular expressions to identify specific XML patterns (componentName.../componentName.../componentInstance, componentName.../componentName.../visibilityRule, fieldItem.../fieldItem.../fieldInstance) that are missing the `identifier` tag.\n- **Dynamic ID Generation:** For each match, it generates a unique identifier (e.g., `sfdxHardisIdX`) and injects it into the XML structure.\n- **File Writing:** If changes are made, the modified XML content is written back to the FlexiPage file using `fs.writeFile`.\n- **Logging:** Provides messages about which FlexiPages are being processed and a summary of the total number of identifiers added.\n",
12281
+ "examples": [
12282
+ "$ sf hardis:project:fix:v53flexipages"
12283
+ ],
12284
+ "flags": {
12285
+ "json": {
12286
+ "description": "Format output as json.",
12287
+ "helpGroup": "GLOBAL",
12288
+ "name": "json",
12289
+ "allowNo": false,
12290
+ "type": "boolean"
12291
+ },
12292
+ "flags-dir": {
12293
+ "helpGroup": "GLOBAL",
12294
+ "name": "flags-dir",
12295
+ "summary": "Import flag values from a directory.",
12296
+ "hasDynamicHelp": false,
12297
+ "multiple": false,
12298
+ "type": "option"
12299
+ },
12300
+ "path": {
12301
+ "char": "p",
12302
+ "description": "Root folder",
12303
+ "name": "path",
12304
+ "default": "/home/runner/work/sfdx-hardis/sfdx-hardis",
12305
+ "hasDynamicHelp": false,
12306
+ "multiple": false,
12307
+ "type": "option"
12308
+ },
12309
+ "debug": {
12310
+ "char": "d",
12311
+ "description": "Activate debug mode (more logs)",
12312
+ "name": "debug",
12313
+ "allowNo": false,
12314
+ "type": "boolean"
12315
+ },
12316
+ "websocket": {
12317
+ "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
12318
+ "name": "websocket",
12319
+ "hasDynamicHelp": false,
12320
+ "multiple": false,
12321
+ "type": "option"
12322
+ },
12323
+ "skipauth": {
12324
+ "description": "Skip authentication check when a default username is required",
12325
+ "name": "skipauth",
12326
+ "allowNo": false,
12327
+ "type": "boolean"
12328
+ }
12329
+ },
12330
+ "hasDynamicHelp": false,
12331
+ "hiddenAliases": [],
12332
+ "id": "hardis:project:fix:v53flexipages",
12333
+ "pluginAlias": "sfdx-hardis",
12334
+ "pluginName": "sfdx-hardis",
12335
+ "pluginType": "core",
12336
+ "strict": true,
12337
+ "enableJsonFlag": true,
12338
+ "title": "Fix flexipages for v53",
12339
+ "requiresProject": true,
12340
+ "isESM": true,
12341
+ "relativePath": [
12342
+ "lib",
12343
+ "commands",
12344
+ "hardis",
12345
+ "project",
12346
+ "fix",
12347
+ "v53flexipages.js"
12348
+ ],
12349
+ "aliasPermutations": [],
12350
+ "permutations": [
12351
+ "hardis:project:fix:v53flexipages",
12352
+ "project:hardis:fix:v53flexipages",
12353
+ "project:fix:hardis:v53flexipages",
12354
+ "project:fix:v53flexipages:hardis",
12355
+ "hardis:fix:project:v53flexipages",
12356
+ "fix:hardis:project:v53flexipages",
12357
+ "fix:project:hardis:v53flexipages",
12358
+ "fix:project:v53flexipages:hardis",
12359
+ "hardis:fix:v53flexipages:project",
12360
+ "fix:hardis:v53flexipages:project",
12361
+ "fix:v53flexipages:hardis:project",
12362
+ "fix:v53flexipages:project:hardis",
12363
+ "hardis:project:v53flexipages:fix",
12364
+ "project:hardis:v53flexipages:fix",
12365
+ "project:v53flexipages:hardis:fix",
12366
+ "project:v53flexipages:fix:hardis",
12367
+ "hardis:v53flexipages:project:fix",
12368
+ "v53flexipages:hardis:project:fix",
12369
+ "v53flexipages:project:hardis:fix",
12370
+ "v53flexipages:project:fix:hardis",
12371
+ "hardis:v53flexipages:fix:project",
12372
+ "v53flexipages:hardis:fix:project",
12373
+ "v53flexipages:fix:hardis:project",
12374
+ "v53flexipages:fix:project:hardis"
12375
+ ]
12376
+ },
12370
12377
  "hardis:project:generate:bypass": {
12371
12378
  "aliases": [],
12372
12379
  "args": {},
@@ -14849,5 +14856,5 @@
14849
14856
  ]
14850
14857
  }
14851
14858
  },
14852
- "version": "6.0.2-beta202508110129.0"
14859
+ "version": "6.0.2-beta202508111754.0"
14853
14860
  }