npm - sfdx-hardis - Versions diffs - 5.17.4 → 5.18.0 - Mend

sfdx-hardis 5.17.4 → 5.18.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 (7) hide show

package/CHANGELOG.md +8 -4
package/lib/commands/hardis/doc/fieldusage.d.ts +16 -0
package/lib/commands/hardis/doc/fieldusage.js +145 -0
package/lib/commands/hardis/doc/fieldusage.js.map +1 -0
package/oclif.lock +16 -16
package/oclif.manifest.json +149 -73
package/package.json +5 -5

package/CHANGELOG.md CHANGED Viewed

@@ -4,6 +4,10 @@
 Note: Can be used with `sfdx plugins:install sfdx-hardis@beta` and docker image `hardisgroupcom/sfdx-hardis@beta`
+## [5.18.0] 2025-02-03
+- New command [hardis:doc:fieldusage](https://sfdx-hardis.cloudity.com/hardis/doc/fieldusage/) : generate a report with custom field's usage from metadata dependencies.
 ## [5.17.4] 2025-01-31
 - [hardis:doc:project2markdown](https://sfdx-hardis.cloudity.com/hardis/doc/project2markdown/): Fixes pages menu
@@ -30,10 +34,10 @@ Note: Can be used with `sfdx plugins:install sfdx-hardis@beta` and docker image
 - [hardis:doc:project2markdown](https://sfdx-hardis.cloudity.com/hardis/doc/project2markdown/) enhancements:
   - Generate Apex classes documentation using `@cparra/apexdocs`, and describe them using AI if available
   - Generate Lightning Pages documentation and describe them using AI if available
-- Display error message in case of XML parsing error
-- Do not raise issues when managed items fields don't have descriptions
-- Do not raise inactive validation rule issue when the VR is from a managed package
-- Fix New JSON coverage formatter is selecting wrong JSON from sf project deploy command
+  - Display error message in case of XML parsing error
+  - Do not raise issues when managed items fields don't have descriptions
+  - Do not raise inactive validation rule issue when the VR is from a managed package
+  - Fix New JSON coverage formatter is selecting wrong JSON from sf project deploy command
 ## [5.16.4] 2025-01-22

package/lib/commands/hardis/doc/fieldusage.d.ts ADDED Viewed

@@ -0,0 +1,16 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { Connection } from '@salesforce/core';
+import { AnyJson } from '@salesforce/ts-types';
+export default class HardisDocFieldusage extends SfCommand<any> {
+    static flags: any;
+    static description: string;
+    static examples: string[];
+    querySObjects(connection: Connection, sObjectsFilter?: string[]): Promise<any>;
+    getFilteredSObjects(connection: Connection, sObjectsFilter?: string[]): Promise<Record<string, {
+        publisherId: string;
+        fields: any[];
+    }>>;
+    queryCustomFields(connection: Connection, sObjectName: string): Promise<any>;
+    queryMetadataComponentDependency(connection: Connection, fieldIds: string[]): Promise<any>;
+    run(): Promise<AnyJson>;
+}

package/lib/commands/hardis/doc/fieldusage.js ADDED Viewed

@@ -0,0 +1,145 @@
+import { requiredOrgFlagWithDeprecations, SfCommand } from '@salesforce/sf-plugins-core';
+import { Flags } from '@salesforce/sf-plugins-core';
+import sortArray from 'sort-array';
+import { generateReports, uxLog } from '../../../common/utils/index.js';
+import { soqlQuery, soqlQueryTooling } from '../../../common/utils/apiUtils.js';
+export default class HardisDocFieldusage extends SfCommand {
+    static flags = {
+        'target-org': requiredOrgFlagWithDeprecations,
+        'sObjects': Flags.string({
+            char: 's',
+            description: 'Comma-separated list of sObjects to filter',
+            required: false,
+        }),
+    };
+    static description = `
+    Retrieves custom field usage from metadata dependencies for specified sObjects.
+    !["Find custom fields usage"](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/doc-fieldusage.png)
+  `;
+    static examples = [
+        '$ sf hardis:doc:fieldusage',
+        '$ sf hardis:doc:fieldusage --sObjects Account,Contact,Opportunity',
+        '$ sf hardis:doc:fieldusage --target-org myOrgAlias --sObjects CustomObject__c'
+    ];
+    async querySObjects(connection, sObjectsFilter) {
+        let sObjectsQuery = `
+      SELECT Id, DeveloperName, PublisherId, IsCustomizable, IsCustomSetting
+      FROM EntityDefinition
+      WHERE IsCustomizable = true
+    `;
+        if (sObjectsFilter && sObjectsFilter.length > 0) {
+            const sObjectsList = sObjectsFilter
+                .map(sObject => sObject.trim().replace(/__c$/, ''))
+                .map(sObject => `'${sObject}'`)
+                .join(',');
+            sObjectsQuery += ` AND DeveloperName IN (${sObjectsList})`;
+        }
+        const sObjectResults = await soqlQuery(sObjectsQuery, connection);
+        uxLog(this, `Found ${sObjectResults.records.length} sObjects.`);
+        return sObjectResults;
+    }
+    async getFilteredSObjects(connection, sObjectsFilter) {
+        const sObjectResults = await this.querySObjects(connection, sObjectsFilter);
+        const sObjectsDict = {};
+        sObjectResults.records.forEach((record) => {
+            if (!record.DeveloperName.endsWith('__Share') && !record.DeveloperName.endsWith('__ChangeEvent')) {
+                sObjectsDict[record.DeveloperName] = {
+                    publisherId: record.PublisherId,
+                    fields: []
+                };
+            }
+        });
+        return sObjectsDict;
+    }
+    async queryCustomFields(connection, sObjectName) {
+        uxLog(this, `Extracting fields for sObject: ${sObjectName}`);
+        const queryTooling = `
+      SELECT Id, DeveloperName
+      FROM CustomField
+      WHERE EntityDefinition.DeveloperName = '${sObjectName}'
+    `;
+        const fieldResults = await soqlQueryTooling(queryTooling, connection);
+        return fieldResults;
+    }
+    async queryMetadataComponentDependency(connection, fieldIds) {
+        const metadataQuery = `
+      SELECT MetadataComponentId, MetadataComponentType, MetadataComponentName, RefMetadataComponentName, RefMetadataComponentId
+      FROM MetadataComponentDependency
+      WHERE RefMetadataComponentId IN (${fieldIds.join(',')})
+    `;
+        const dependencyResults = await soqlQueryTooling(metadataQuery, connection);
+        return dependencyResults;
+    }
+    async run() {
+        const { flags } = await this.parse(HardisDocFieldusage);
+        const connection = flags['target-org'].getConnection();
+        const sObjectsFilter = flags['sObjects'] ? flags['sObjects'].split(',').map(s => s.trim()) : undefined;
+        const sObjectsDict = await this.getFilteredSObjects(connection, sObjectsFilter);
+        const fieldQueries = Object.keys(sObjectsDict).map(async (sObjectName) => {
+            const fieldResults = await this.queryCustomFields(connection, sObjectName);
+            if (fieldResults.records.length > 0) {
+                fieldResults.records.forEach((field) => {
+                    sObjectsDict[sObjectName].fields.push({
+                        id: field.Id,
+                        name: field.DeveloperName,
+                        type: "custom",
+                        usedIn: []
+                    });
+                });
+            }
+        });
+        await Promise.all(fieldQueries);
+        const dependencyQueries = Object.entries(sObjectsDict).map(async ([sObjectName, { fields }]) => {
+            if (fields.length === 0) {
+                uxLog(this, `sObject ${sObjectName} does not have any custom fields, skipping dependencies.`);
+                return;
+            }
+            uxLog(this, `Retrieving dependencies for sObject: ${sObjectName}`);
+            const fieldIds = fields.map((field) => `'${field.id}'`);
+            const dependencyResults = await this.queryMetadataComponentDependency(connection, fieldIds);
+            dependencyResults.records.forEach((dep) => {
+                const field = fields.find(f => f.id === dep.RefMetadataComponentId);
+                if (field) {
+                    field.usedIn.push({ id: dep.MetadataComponentId, type: dep.MetadataComponentType, name: dep.MetadataComponentName });
+                }
+            });
+        });
+        await Promise.all(dependencyQueries);
+        const columns = [
+            { key: 'sObjectName', header: 'sObject Name' },
+            { key: 'fieldName', header: 'Field Name' },
+            { key: 'fieldType', header: 'Field Type' },
+            { key: 'dependencyType', header: 'Dependency Type' },
+            { key: 'dependencyName', header: 'Dependency Name' }
+        ];
+        const rows = [];
+        for (const [sObjectName, { fields }] of Object.entries(sObjectsDict)) {
+            fields.forEach((field) => {
+                field.usedIn.forEach((dep) => {
+                    const row = {};
+                    row[columns[0].key] = sObjectName;
+                    row[columns[1].key] = field.name;
+                    row[columns[2].key] = field.type;
+                    row[columns[3].key] = dep.type;
+                    row[columns[4].key] = dep.name;
+                    rows.push(row);
+                });
+            });
+        }
+        const resultSorted = sortArray(rows, {
+            by: [columns[0].key, columns[1].key, columns[3].key],
+            order: ['asc', 'asc', 'asc'],
+        });
+        console.table(rows);
+        const reportFiles = await generateReports(resultSorted, columns, this, {
+            logFileName: 'fields-usage',
+            logLabel: 'Find fields usage',
+        });
+        return {
+            outputString: 'Processed fieldusage doc',
+            result: resultSorted,
+            reportFiles,
+        };
+    }
+}
+//# sourceMappingURL=fieldusage.js.map

package/lib/commands/hardis/doc/fieldusage.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"fieldusage.js","sourceRoot":"","sources":["../../../../src/commands/hardis/doc/fieldusage.ts"],"names":[],"mappings":"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"}

package/oclif.lock CHANGED Viewed

@@ -3388,10 +3388,10 @@
   resolved "https://registry.npmjs.org/@types/wrap-ansi/-/wrap-ansi-3.0.0.tgz"
   integrity sha512-ltIpx+kM7g/MLRZfkbL7EsCEjfzCcScLpkg37eXEtx5kmrAKBkTJwd1GIAjDSL8wTpM6Hzn5YO4pSb91BEwu1g==
-"@types/ws@^8.5.13":
-  version "8.5.13"
-  resolved "https://registry.npmjs.org/@types/ws/-/ws-8.5.13.tgz"
-  integrity sha512-osM/gWBTPKgHV8XkTunnegTRIsvF6owmf5w+JtAfOw472dptdm0dlGv4xCt6GwQRcC2XVOvvRE/0bAoQcL2QkA==
+"@types/ws@^8.5.14":
+  version "8.5.14"
+  resolved "https://registry.yarnpkg.com/@types/ws/-/ws-8.5.14.tgz#93d44b268c9127d96026cf44353725dd9b6c3c21"
+  integrity sha512-bd/YFLW+URhBzMXurx7lWByOu+xzU9+kb3RboOteXYDfW+tr+JZa99OyNmPINEGB/ahzKrEuc8rcv4gnpJmxTw==
   dependencies:
     "@types/node" "*"
@@ -6338,10 +6338,10 @@ fs-constants@^1.0.0:
   resolved "https://registry.npmjs.org/fs-constants/-/fs-constants-1.0.0.tgz"
   integrity sha512-y6OAwoSIf7FyjMIv94u+b5rdheZEjzR63GTyZJm5qh4Bi+2YgwLCcI/fPFZkL5PSixOt6ZNKm+w+Hfp/Bciwow==
-fs-extra@^11.0.0, fs-extra@^11.1.1, fs-extra@^11.2.0:
-  version "11.2.0"
-  resolved "https://registry.npmjs.org/fs-extra/-/fs-extra-11.2.0.tgz"
-  integrity sha512-PmDi3uwK5nFuXh7XDTlVnS17xJS7vW36is2+w3xcv8SVxiB4NyATf4ctkVY5bkSjX0Y4nbvZCq1/EjtEyr9ktw==
+fs-extra@^11.0.0, fs-extra@^11.1.1, fs-extra@^11.2.0, fs-extra@^11.3.0:
+  version "11.3.0"
+  resolved "https://registry.yarnpkg.com/fs-extra/-/fs-extra-11.3.0.tgz#0daced136bbaf65a555a326719af931adc7a314d"
+  integrity sha512-Z4XaCL6dUDHfP/jT25jJKMmtxvuwbkrD1vNSMFlo9lNLY2c5FHYSQgHPRZUjAB26TpDEoW9HCOgplrdbaPV/ew==
   dependencies:
     graceful-fs "^4.2.0"
     jsonfile "^6.0.1"
@@ -8445,10 +8445,10 @@ math-random@^1.0.1:
   resolved "https://registry.npmjs.org/math-random/-/math-random-1.0.4.tgz"
   integrity sha512-rUxjysqif/BZQH2yhd5Aaq7vXMSx9NdEsQcyA07uEzIvxgI7zIr33gGsh+RU0/XjmQpCW7RsVof1vlkvQVCK5A==
-mega-linter-runner@^8.3.0:
-  version "8.3.0"
-  resolved "https://registry.npmjs.org/mega-linter-runner/-/mega-linter-runner-8.3.0.tgz"
-  integrity sha512-gBKQ3e6U2PnTa62mQJ+nQ9SnCJKLySpXV1ERaDve2Dz9um/apadeNLC5MgtNrzcrSBcYd3ySFzE4PgO9VDI7Ew==
+mega-linter-runner@^8.4.1:
+  version "8.4.1"
+  resolved "https://registry.yarnpkg.com/mega-linter-runner/-/mega-linter-runner-8.4.1.tgz#0e7bf76395deb0f60edb258986d0ec1349e6f4d1"
+  integrity sha512-gPbNgK7+v8r9JkIuHY/aY9FmqE3aAWDZKr1IofHYCe61Bq1/Z3VFw3/PJI91LH+tzJR0Fnun1oDQAUAoXIuHYw==
   dependencies:
     chalk "^5.3.0"
     find-package-json "^1.2.0"
@@ -9548,10 +9548,10 @@ pako@~1.0.2:
   resolved "https://registry.npmjs.org/pako/-/pako-1.0.11.tgz"
   integrity sha512-4hLB8Py4zZce5s4yd9XzopqwVv/yGNhV1Bl8NTmCq1763HeK2+EwVTv+leGeL13Dnh2wfbqowVPXCIO0z4taYw==
-papaparse@^5.5.1:
-  version "5.5.1"
-  resolved "https://registry.yarnpkg.com/papaparse/-/papaparse-5.5.1.tgz#4322da01e85d8e9e282c1e4387793a5978b5a0a1"
-  integrity sha512-EuEKUhyxrHVozD7g3/ztsJn6qaKse8RPfR6buNB2dMJvdtXNhcw8jccVi/LxNEY3HVrV6GO6Z4OoeCG9Iy9wpA==
+papaparse@^5.5.2:
+  version "5.5.2"
+  resolved "https://registry.yarnpkg.com/papaparse/-/papaparse-5.5.2.tgz#fb67cc5a03ba8930cb435dc4641a25d6804bd4d7"
+  integrity sha512-PZXg8UuAc4PcVwLosEEDYjPyfWnTEhOrUfdv+3Bx+NuAb+5NhDmXzg5fHWmdCh1mP5p7JAZfFr3IMQfcntNAdA==
 param-case@^3.0.4:
   version "3.0.4"

package/oclif.manifest.json CHANGED Viewed

@@ -57,78 +57,6 @@
         "world:hello"
       ]
     },
-    "hardis:cache:clear": {
-      "aliases": [],
-      "args": {},
-      "description": "Clear cache generated by sfdx-hardis",
-      "examples": [
-        "$ sf hardis:cache:clear"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "flags-dir": {
-          "helpGroup": "GLOBAL",
-          "name": "flags-dir",
-          "summary": "Import flag values from a directory.",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "debug": {
-          "char": "d",
-          "description": "Activate debug mode (more logs)",
-          "name": "debug",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "websocket": {
-          "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
-          "name": "websocket",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "skipauth": {
-          "description": "Skip authentication check when a default username is required",
-          "name": "skipauth",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "hardis:cache:clear",
-      "pluginAlias": "sfdx-hardis",
-      "pluginName": "sfdx-hardis",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "title": "Clear sfdx-hardis cache",
-      "requiresProject": false,
-      "isESM": true,
-      "relativePath": [
-        "lib",
-        "commands",
-        "hardis",
-        "cache",
-        "clear.js"
-      ],
-      "aliasPermutations": [],
-      "permutations": [
-        "hardis:cache:clear",
-        "cache:hardis:clear",
-        "cache:clear:hardis",
-        "hardis:clear:cache",
-        "clear:hardis:cache",
-        "clear:cache:hardis"
-      ]
-    },
     "hardis:auth:login": {
       "aliases": [],
       "args": {},
@@ -310,6 +238,154 @@
         "get:config:hardis"
       ]
     },
+    "hardis:cache:clear": {
+      "aliases": [],
+      "args": {},
+      "description": "Clear cache generated by sfdx-hardis",
+      "examples": [
+        "$ sf hardis:cache:clear"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "debug": {
+          "char": "d",
+          "description": "Activate debug mode (more logs)",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "websocket": {
+          "description": "Websocket host:port for VsCode SFDX Hardis UI integration",
+          "name": "websocket",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "skipauth": {
+          "description": "Skip authentication check when a default username is required",
+          "name": "skipauth",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "hardis:cache:clear",
+      "pluginAlias": "sfdx-hardis",
+      "pluginName": "sfdx-hardis",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "title": "Clear sfdx-hardis cache",
+      "requiresProject": false,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "hardis",
+        "cache",
+        "clear.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "hardis:cache:clear",
+        "cache:hardis:clear",
+        "cache:clear:hardis",
+        "hardis:clear:cache",
+        "clear:hardis:cache",
+        "clear:cache:hardis"
+      ]
+    },
+    "hardis:doc:fieldusage": {
+      "aliases": [],
+      "args": {},
+      "description": "\n    Retrieves custom field usage from metadata dependencies for specified sObjects.\n    ![\"Find custom fields usage\"](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/doc-fieldusage.png)\n  ",
+      "examples": [
+        "$ sf hardis:doc:fieldusage",
+        "$ sf hardis:doc:fieldusage --sObjects Account,Contact,Opportunity",
+        "$ sf hardis:doc:fieldusage --target-org myOrgAlias --sObjects CustomObject__c"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "flags-dir": {
+          "helpGroup": "GLOBAL",
+          "name": "flags-dir",
+          "summary": "Import flag values from a directory.",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "target-org": {
+          "aliases": [
+            "targetusername",
+            "u"
+          ],
+          "char": "o",
+          "deprecateAliases": true,
+          "name": "target-org",
+          "noCacheDefault": true,
+          "required": true,
+          "summary": "Username or alias of the target org. Not required if the `target-org` configuration variable is already set.",
+          "hasDynamicHelp": true,
+          "multiple": false,
+          "type": "option"
+        },
+        "sObjects": {
+          "char": "s",
+          "description": "Comma-separated list of sObjects to filter",
+          "name": "sObjects",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": true,
+      "hiddenAliases": [],
+      "id": "hardis:doc:fieldusage",
+      "pluginAlias": "sfdx-hardis",
+      "pluginName": "sfdx-hardis",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "isESM": true,
+      "relativePath": [
+        "lib",
+        "commands",
+        "hardis",
+        "doc",
+        "fieldusage.js"
+      ],
+      "aliasPermutations": [],
+      "permutations": [
+        "hardis:doc:fieldusage",
+        "doc:hardis:fieldusage",
+        "doc:fieldusage:hardis",
+        "hardis:fieldusage:doc",
+        "fieldusage:hardis:doc",
+        "fieldusage:doc:hardis"
+      ]
+    },
     "hardis:doc:flow2markdown": {
       "aliases": [],
       "args": {},
@@ -14289,5 +14365,5 @@
       ]
     }
   },
-  "version": "5.17.4"
+  "version": "5.18.0"
 }

package/package.json CHANGED Viewed

@@ -3,7 +3,7 @@
   "description": "Swiss-army-knife Toolbox for Salesforce.\n Allows you to define a complete CD/CD Pipeline.\n Orchestrate base commands and assist users with interactive wizards",
   "author": "NicolasVuillamy @nvuillam",
   "bugs": "https://github.com/hardisgroupcom/sfdx-hardis/issues",
-  "version": "5.17.4",
+  "version": "5.18.0",
   "dependencies": {
     "@actions/github": "^6.0.0",
     "@cparra/apexdocs": "^3.7.3",
@@ -34,7 +34,7 @@
     "farmhash": "^4.0.1",
     "fast-xml-parser": "^4.5.1",
     "form-data": "^4.0.1",
-    "fs-extra": "^11.2.0",
+    "fs-extra": "^11.3.0",
     "fs-readdir-recursive": "^1.1.0",
     "glob": "^11.0.1",
     "he": "^1.2.0",
@@ -45,12 +45,12 @@
     "make-fetch-happen": "^14.0.3",
     "markdown-toc": "^1.2.0",
     "marked": "^14.1.4",
-    "mega-linter-runner": "^8.3.0",
+    "mega-linter-runner": "^8.4.1",
     "moment": "^2.30.1",
     "open": "^10.1.0",
     "openai": "^4.78.1",
     "ora": "^8.1.1",
-    "papaparse": "^5.5.1",
+    "papaparse": "^5.5.2",
     "pascalcase": "^2.0.0",
     "psl": "^1.15.0",
     "puppeteer-core": "^23.11.1",
@@ -90,7 +90,7 @@
     "@types/sort-array": "^4.1.2",
     "@types/update-notifier": "^6.0.8",
     "@types/which": "^3.0.4",
-    "@types/ws": "^8.5.13",
+    "@types/ws": "^8.5.14",
     "@types/xml2js": "^0.4.14",
     "eslint-plugin-sf-plugin": "^1.20.14",
     "oclif": "^4.17.17",