sfdx-hardis 7.17.0 → 7.19.0

package/defaults/ci/.github/workflows/check-deploy.yml

@@ -81,7 +81,7 @@ jobs:
           JIRA_HOST: ${{ secrets.JIRA_HOST }}
           JIRA_EMAIL: ${{ secrets.JIRA_EMAIL }}
           JIRA_TOKEN: ${{ secrets.JIRA_TOKEN }}
-          JIRA_PAT: ${{ secrets.JIRA_HOST }}
+          JIRA_PAT: ${{ secrets.JIRA_PAT }}
           JIRA_TICKET_REGEX: ${{ secrets.JIRA_TICKET_REGEX }}
           OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
           # Uncomment to provide API keys for coding agent auto-fix of deployment errors

package/defaults/ci/.github/workflows/process-deploy.yml

@@ -82,7 +82,7 @@ jobs:
           JIRA_HOST: ${{ secrets.JIRA_HOST }}
           JIRA_EMAIL: ${{ secrets.JIRA_EMAIL }}
           JIRA_TOKEN: ${{ secrets.JIRA_TOKEN }}
-          JIRA_PAT: ${{ secrets.JIRA_HOST }}
+          JIRA_PAT: ${{ secrets.JIRA_PAT }}
           # Uncomment to provide API keys for coding agent auto-fix of deployment errors
           # ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
           # OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}

package/defaults/ci/azure-pipelines-checks.yml

@@ -98,7 +98,7 @@ jobs:
           JIRA_HOST: $(JIRA_HOST)
           JIRA_EMAIL: $(JIRA_EMAIL)
           JIRA_TOKEN: $(JIRA_TOKEN)
-          JIRA_PAT: $(JIRA_HOST)
+          JIRA_PAT: $(JIRA_PAT)
           JIRA_TICKET_REGEX: $(JIRA_TICKET_REGEX)
           OPENAI_API_KEY: $(OPENAI_API_KEY)
           # Uncomment to provide API keys for coding agent auto-fix of deployment errors

package/defaults/ci/azure-pipelines-deployment.yml

@@ -90,7 +90,7 @@ jobs:
           JIRA_HOST: $(JIRA_HOST)
           JIRA_EMAIL: $(JIRA_EMAIL)
           JIRA_TOKEN: $(JIRA_TOKEN)
-          JIRA_PAT: $(JIRA_HOST)
+          JIRA_PAT: $(JIRA_PAT)
           JIRA_TICKET_REGEX: $(JIRA_TICKET_REGEX)
           SFDX_DEPLOY_WAIT_MINUTES: $(SFDX_DEPLOY_WAIT_MINUTES)
           SFDX_AUTH_URL_TECHNICAL_ORG: $(SFDX_AUTH_URL_TECHNICAL_ORG)

package/lib/commands/hardis/doc/data-dictionary.d.ts

@@ -0,0 +1,8 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { AnyJson } from '@salesforce/ts-types';
+export default class HardisDocDataDictionary extends SfCommand<any> {
+    static description: string;
+    static examples: string[];
+    static flags: any;
+    run(): Promise<AnyJson>;
+}

package/lib/commands/hardis/doc/data-dictionary.js

@@ -0,0 +1,183 @@
+import { Flags, SfCommand, requiredOrgFlagWithDeprecations } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import c from 'chalk';
+import { isCI, uxLog } from '../../../common/utils/index.js';
+import { prompts } from '../../../common/utils/prompts.js';
+import { WebSocketClient } from '../../../common/websocketClient.js';
+import { listOrgSObjects } from '../../../common/utils/orgUtils.js';
+import { t } from '../../../common/utils/i18n.js';
+import { collectObjectDictionary, fetchRecordTypes, fetchValidationRules, hasLocalCustomizations, writeDataDictionaryReports, } from '../../../common/utils/dataDictionaryUtils.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages("sfdx-hardis", "org");
+export default class HardisDocDataDictionary extends SfCommand {
+    static description = `
+## Command Behavior
+
+**Generates an Excel (.xlsx) data dictionary for one or more Salesforce objects, read live from the target org.**
+
+This command describes the selected objects and exports their definitions into a single multi-sheet workbook, useful for documentation, audits, and onboarding.
+
+The \`Index\` sheet lists every documented object with its field, validation rule and record type counts, and links to each object sheet.
+
+![Data dictionary index sheet](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/screenshot-data-dictionary-index.png)
+
+Each object sheet details its fields (type, required, unique, reference target, picklist values, and more).
+
+![Data dictionary object fields sheet](https://github.com/hardisgroupcom/sfdx-hardis/raw/main/docs/assets/images/screenshot-data-dictionary-fields.png)
+
+- **Target Org:** Use \`--target-org\` to pick the org connection context.
+- **Object selection:** Provide one or more API names via \`--objects\` (comma-separated, e.g. \`Account,Contact,MyObject__c\`). If omitted in interactive mode, a prompt lists available objects.
+- **Customized objects only:** Use \`--customizedonly\` to exclude objects that have no local customizations. This drops standard objects without custom fields and managed package objects without local custom fields, while keeping local custom objects and any object that has at least one local custom field. In interactive mode, a prompt offers the same filter.
+- **Workbook structure:** One \`Index\` sheet listing the objects, one fields sheet per object, plus consolidated \`Validation Rules\` and \`Record Types\` sheets.
+- **Navigation:** The \`Index\` sheet links to each object, Validation Rules and Record Types sheet, and every other sheet has a "Back to Index" link below its data.
+- **Fields detail:** API name, label, type, required, unique, external id, length/precision, reference target, picklist values, default value, formula, help text, description, and custom flag. Fields are sorted alphabetically by API name.
+- **Output:** The XLSX is generated alongside the intermediate CSV files in the report directory. Use \`--outputfile\` to force the consolidated report path.
+
+<details markdown="1">
+<summary>Technical explanations</summary>
+
+- **Fields:** Retrieved with \`connection.describe(objectName)\`, then sorted alphabetically by API name. Field types are mapped to their Salesforce names (e.g. \`reference\` becomes \`Lookup\` or \`MasterDetail\`, \`int\`/\`double\` become \`Number\`), and formula / roll-up summary fields are tagged. Required is derived from \`nillable === false\`; picklist values are the active values, capped at 50 with an overflow note.
+- **Validation Rules:** Retrieved via the Metadata API (\`metadata.list\` then \`metadata.read\` in batches of 10) to include the error condition formula, which is not exposed by describe.
+- **Record Types:** Retrieved with a single SOQL query on \`RecordType\` filtered by \`SobjectType\`.
+- **Reporting:** Each sheet is first written as a CSV, then consolidated into one XLSX via \`createXlsxFromCsvFiles\`, with explicit worksheet names.
+- **Resilience:** Objects that cannot be described, and validation rule / record type retrieval failures, are logged as warnings and skipped without aborting the run.
+</details>
+
+### Agent Mode
+
+Supports non-interactive execution with \`--agent\`:
+
+\`\`\`sh
+sf hardis:doc:data-dictionary --agent --objects Account,Contact
+\`\`\`
+
+In agent mode:
+- The \`--objects\` flag is **required** (no interactive prompt for object selection).
+- No other prompt is displayed; the workbook is generated directly.
+- Pass \`--customizedonly\` to restrict the workbook to objects that have local customizations (the prompt is skipped).
+`;
+    static examples = [
+        '$ sf hardis:doc:data-dictionary',
+        '$ sf hardis:doc:data-dictionary --objects Account,Contact',
+        '$ sf hardis:doc:data-dictionary --target-org myOrgAlias --objects CustomObject__c',
+        '$ sf hardis:doc:data-dictionary --customizedonly',
+        '$ sf hardis:doc:data-dictionary --agent --objects Account,Contact --customizedonly',
+    ];
+    static flags = {
+        'target-org': requiredOrgFlagWithDeprecations,
+        objects: Flags.string({
+            char: 'o',
+            description: 'Comma-separated API names of the objects to document (e.g. Account,Contact,CustomObject__c). If omitted, an interactive prompt lists available objects.',
+            required: false,
+        }),
+        outputfile: Flags.string({
+            char: 'f',
+            description: 'Force the path and name of the consolidated output report file (the XLSX is generated alongside)',
+            required: false,
+        }),
+        customizedonly: Flags.boolean({
+            default: false,
+            description: 'Exclude objects that have no local customizations (standard objects without custom fields and managed package objects without local custom fields). Local custom objects and objects with at least one local custom field are kept.',
+        }),
+        agent: Flags.boolean({
+            default: false,
+            description: 'Run in non-interactive mode for agents and automation',
+        }),
+        websocket: Flags.string({
+            description: messages.getMessage("websocket"),
+        }),
+        skipauth: Flags.boolean({
+            description: "Skip authentication check when a default username is required",
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(HardisDocDataDictionary);
+        const conn = flags['target-org'].getConnection();
+        const agentMode = flags.agent === true;
+        const outputFile = flags.outputfile || null;
+        let customizedOnly = flags.customizedonly === true;
+        let objectNames = (flags.objects || '')
+            .split(',')
+            .map((name) => name.trim())
+            .filter((name) => name.length > 0);
+        if (objectNames.length === 0) {
+            if (!isCI && !agentMode) {
+                const availableSObjects = await listOrgSObjects(conn);
+                const sObjectApiNames = (availableSObjects?.records || [])
+                    .map((record) => record?.QualifiedApiName)
+                    .filter((apiName) => typeof apiName === 'string' && apiName.length > 0)
+                    .filter((apiName) => !apiName.endsWith('__Share') && !apiName.endsWith('__ChangeEvent'))
+                    .sort();
+                const promptObjectsRes = await prompts({
+                    type: 'multiselect',
+                    name: 'value',
+                    message: t('selectTheSobjectsToAnalyze'),
+                    description: t('excludeObjectsYouDontWantToAnalyze'),
+                    choices: sObjectApiNames.map((apiName) => ({ title: apiName, value: apiName })),
+                });
+                objectNames = promptObjectsRes.value || [];
+                if (objectNames.length === 0) {
+                    uxLog("warning", this, c.yellow(t('noObjectsSelectedAborting')));
+                    return { outputString: 'No objects selected; aborting.', cancelled: true };
+                }
+                uxLog("log", this, t('sObjectsSelectedForAnalysis', { count: objectNames.length }));
+            }
+            else {
+                const outputString = t('objectsFlagRequiredInAgentMode');
+                uxLog("error", this, c.red(outputString));
+                return { outputString, cancelled: true };
+            }
+        }
+        objectNames = Array.from(new Set(objectNames)).sort();
+        // Offer the "customized objects only" filter interactively when it was not requested via the flag.
+        if (!customizedOnly && !isCI && !agentMode) {
+            const customizedPromptRes = await prompts({
+                type: 'confirm',
+                name: 'value',
+                initial: false,
+                message: t('excludeUncustomizedObjects'),
+                description: t('excludeUncustomizedObjectsDesc'),
+            });
+            customizedOnly = customizedPromptRes.value === true;
+        }
+        WebSocketClient.sendProgressStartMessage(t('describingObjects', { count: objectNames.length }));
+        const objectDicts = [];
+        let counter = 0;
+        for (const objectName of objectNames) {
+            const dict = await collectObjectDictionary(conn, objectName, this);
+            if (dict) {
+                objectDicts.push(dict);
+            }
+            WebSocketClient.sendProgressStepMessage(++counter, objectNames.length);
+        }
+        WebSocketClient.sendProgressEndMessage(objectNames.length);
+        if (objectDicts.length === 0) {
+            uxLog("warning", this, c.yellow(t('noObjectsSelectedAborting')));
+            return { outputString: 'No objects could be described; aborting.', cancelled: true };
+        }
+        let dictsToReport = objectDicts;
+        if (customizedOnly) {
+            dictsToReport = objectDicts.filter((dict) => hasLocalCustomizations(dict));
+            const excludedCount = objectDicts.length - dictsToReport.length;
+            if (excludedCount > 0) {
+                uxLog("log", this, t('excludedUncustomizedObjects', { count: excludedCount }));
+            }
+            if (dictsToReport.length === 0) {
+                uxLog("warning", this, c.yellow(t('noObjectsWithLocalCustomizations')));
+                return { outputString: 'No objects with local customizations found; aborting.', cancelled: true };
+            }
+        }
+        const describedObjectNames = dictsToReport.map((dict) => dict.apiName);
+        const validationRules = await fetchValidationRules(conn, describedObjectNames, this);
+        const recordTypes = await fetchRecordTypes(conn, describedObjectNames, this);
+        uxLog("action", this, c.cyan(t('generatingDataDictionaryForObjects', { count: dictsToReport.length })));
+        const reportFiles = await writeDataDictionaryReports(this, dictsToReport, validationRules, recordTypes, outputFile);
+        uxLog("success", this, c.green(t('dataDictionaryGeneratedForObjects', { count: dictsToReport.length })));
+        return {
+            outputString: `Data dictionary generated for ${dictsToReport.length} objects.`,
+            reportFiles,
+            objects: describedObjectNames,
+        };
+    }
+}
+//# sourceMappingURL=data-dictionary.js.map

package/lib/commands/hardis/doc/data-dictionary.js.map

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

package/lib/commands/hardis/mdapi/read.d.ts

@@ -0,0 +1,11 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { AnyJson } from '@salesforce/ts-types';
+export default class MdapiRead extends SfCommand<any> {
+    static title: string;
+    static description: string;
+    static examples: string[];
+    static flags: any;
+    static requiresProject: boolean;
+    run(): Promise<AnyJson>;
+    private displaySummary;
+}

package/lib/commands/hardis/mdapi/read.js

@@ -0,0 +1,190 @@
+import { SfCommand, Flags, requiredOrgFlagWithDeprecations } from '@salesforce/sf-plugins-core';
+import { SfError } from '@salesforce/core';
+import c from 'chalk';
+import * as path from 'path';
+import { isCI, uxLog, uxLogTable } from '../../../common/utils/index.js';
+import { prompts } from '../../../common/utils/prompts.js';
+import { t } from '../../../common/utils/i18n.js';
+import { WebSocketClient } from '../../../common/websocketClient.js';
+import { buildTargetComponentSet, crudReadMetadatas, isOutcomeFailed, splitMetadataEntries, validateChunkSizeOverride, } from '../../../common/metadata-utils/crudMetadataApi.js';
+export default class MdapiRead extends SfCommand {
+    static title = 'Read metadata using the CRUD-based Metadata API';
+    static description = `
+## Command Behavior
+
+**Retrieves metadata from an org using the CRUD-based Metadata API (\`readMetadata\`), writing complete source files.**
+
+This is a standalone, manually invoked alternative to the file-based retrieve (\`sf hardis:org:retrieve:sources:metadata\`). It exists for metadata types that file-based retrieve returns **incomplete** when source tracking is not used, most notably \`Profile\` and \`PermissionSet\`: \`readMetadata\` returns the whole component (every object/field permission, Apex-class access, tab visibility), not just the parts tied to other components in the same package.
+
+Key functionalities:
+
+- **Component selection:** Choose what to read with \`--metadata\` (e.g. \`Profile:Admin\`, or a bare type like \`Profile\` to read every component of that type), \`--manifest\` (a \`package.xml\`), or \`--source-dir\` (refresh the types/names already present in a local folder).
+- **Complete components:** Each component is read whole and written to standard source format, so a \`git diff\` shows exactly what file-based retrieve had been dropping.
+- **Chunking:** Reads are batched to respect the CRUD Metadata API limit (10 components per call, 200 for \`CustomMetadata\` and \`CustomApplication\`).
+- **Supported types are adapter-gated:** Compatibility is decided by the metadata type's @salesforce/source-deploy-retrieve registry adapter (\`strategies.adapter\`). Only pure-XML types round-trip through the CRUD Metadata API; types whose source carries non-XML content (code, binaries, multi-file bundles) are reported as skipped with a warning. The incompatible adapters are \`bundle\` (LWC, Aura), \`matchingContentFile\` (Apex classes/triggers/pages/components, Visualforce), \`mixedContent\` (\`StaticResource\`, \`Document\`), and \`digitalExperience\` (\`DigitalExperienceBundle\`). Retrieve those with file-based retrieve (\`sf project retrieve start\`).
+
+The write counterpart is \`sf hardis:mdapi:upsert\`.
+
+<details markdown="1">
+<summary>Technical explanations</summary>
+
+- **Input resolution:** \`ComponentSetBuilder\` resolves \`--metadata\` / \`--manifest\` / \`--source-dir\`. Bare types and wildcards are expanded against the org via \`listMetadata\`.
+- **Read:** Components are grouped by type, chunked, and read with jsforce \`connection.metadata.read\`.
+- **Conversion:** Read results are serialized to metadata-format XML (\`fast-xml-parser\`), then converted to source format with \`@salesforce/source-deploy-retrieve\`'s public converter, which handles per-type decomposition (e.g. CustomObject into \`fields/\` and \`recordTypes/\`).
+- **Adapter rule:** \`partitionCrudCompatibility\` resolves each type to its SDR adapter via \`RegistryAccess.getTypeByName(name).strategies.adapter\`. Types with adapter \`bundle\`, \`matchingContentFile\`, \`mixedContent\`, or \`digitalExperience\` are set aside as skipped; types with \`decomposed\`, \`default\`, or no adapter (e.g. \`CustomObject\`, \`Profile\`, \`PermissionSet\`, \`Layout\`, \`CustomMetadata\`, \`CustomApplication\`) are processed. Unknown type names are treated as compatible so the API call (not the guard) surfaces the real error.
+- **Limitations:** Folder-based types (Report, Dashboard, EmailTemplate) require explicit \`Folder/Name\` members; bare-type expansion does not enumerate folders yet.
+</details>
+
+### Agent Mode
+
+Supports non-interactive execution with \`--agent\`:
+
+\`\`\`sh
+sf hardis:mdapi:read --metadata Profile,PermissionSet --agent
+\`\`\`
+
+In agent mode (and in CI), interactive prompts are skipped. You must pass at least one of \`--metadata\`, \`--manifest\`, or \`--source-dir\`; the command never prompts for what to read.
+`;
+    static examples = [
+        '$ sf hardis:mdapi:read --metadata Profile',
+        '$ sf hardis:mdapi:read --source-dir force-app/main/default/profiles',
+        '$ sf hardis:mdapi:read --metadata "Profile:Admin" --metadata PermissionSet',
+        '$ sf hardis:mdapi:read --manifest manifest/package.xml',
+        '$ sf hardis:mdapi:read --metadata Profile,PermissionSet --agent',
+    ];
+    static flags = {
+        metadata: Flags.string({
+            char: 'm',
+            multiple: true,
+            description: 'Metadata to read, as Type or Type:Name (e.g. Profile, "Profile:Admin"). Repeatable.',
+        }),
+        manifest: Flags.string({
+            char: 'x',
+            description: 'Path to a package.xml listing the metadata to read',
+        }),
+        'source-dir': Flags.string({
+            multiple: true,
+            description: 'Local source path whose components should be re-read from the org',
+        }),
+        'output-dir': Flags.string({
+            description: 'Directory where source files are written. When set, all files are written here instead of being refreshed in place in the project package directories (default: the project default package directory)',
+        }),
+        /* jscpd:ignore-start */
+        'chunk-size': Flags.integer({
+            description: 'Components read per API call (max 10, or 200 for CustomMetadata/CustomApplication)',
+        }),
+        'ignore-errors': Flags.boolean({
+            default: false,
+            description: 'Report component failures but exit with code 0',
+        }),
+        agent: Flags.boolean({
+            default: false,
+            description: 'Run in non-interactive mode for agents and automation',
+        }),
+        debug: Flags.boolean({
+            char: 'd',
+            default: false,
+            description: 'Activate debug mode (more logs)',
+        }),
+        websocket: Flags.string({
+            description: 'Websocket host:port for VsCode SFDX Hardis UI integration',
+        }),
+        skipauth: Flags.boolean({
+            description: 'Skip authentication check when a default username is required',
+        }),
+        'target-org': requiredOrgFlagWithDeprecations,
+        /* jscpd:ignore-end */
+    };
+    static requiresProject = true;
+    async run() {
+        const { flags } = await this.parse(MdapiRead);
+        const agentMode = flags.agent === true;
+        const debugMode = flags.debug || false;
+        const ignoreErrors = flags['ignore-errors'] || false;
+        let metadataEntries = splitMetadataEntries(flags.metadata);
+        const manifestPath = flags.manifest || undefined;
+        const sourceDirs = flags['source-dir'] || undefined;
+        // Prompt for metadata when nothing was provided and we can interact.
+        if (!metadataEntries.length && !manifestPath && !sourceDirs?.length) {
+            if (isCI || agentMode) {
+                throw new SfError(t('crudNoInputProvided'));
+            }
+            const promptResult = await prompts({
+                type: 'text',
+                name: 'value',
+                message: t('crudPromptMetadataToRetrieve'),
+                description: t('crudPromptMetadataToRetrieveDesc'),
+                placeholder: 'Profile, PermissionSet:Admin',
+            });
+            metadataEntries = (promptResult.value || '')
+                .split(',')
+                .map((e) => e.trim())
+                .filter(Boolean);
+            if (!metadataEntries.length) {
+                throw new SfError(t('crudNoInputProvided'));
+            }
+        }
+        if (flags['chunk-size'] != null) {
+            validateChunkSizeOverride(flags['chunk-size']);
+        }
+        const packageDirs = (this.project?.getPackageDirectories() || []).map((dir) => dir.fullPath);
+        const defaultPackageDir = (this.project?.getPackageDirectories() || []).find((dir) => dir.default)?.fullPath ||
+            packageDirs[0] ||
+            process.cwd();
+        const outputDirExplicit = Boolean(flags['output-dir']);
+        const outputDir = outputDirExplicit ? path.resolve(flags['output-dir']) : defaultPackageDir;
+        const conn = flags['target-org'].getConnection();
+        uxLog('action', this, c.cyan(t('crudReadingMetadata')));
+        const componentSet = await buildTargetComponentSet({
+            metadataEntries,
+            manifestPath,
+            sourceDirs,
+            packageDirs,
+            username: flags['target-org'].getUsername(),
+            resolveFromOrg: true,
+        });
+        if (componentSet.size === 0) {
+            uxLog('warning', this, c.yellow(t('crudNothingToRetrieve')));
+            return { successes: [], failures: [], skipped: [], outputDir };
+        }
+        const outcome = await crudReadMetadatas({
+            conn,
+            componentSet,
+            outputDir,
+            // packageDirs is used only to merge (overwrite in place) with existing source. When the user
+            // explicitly sets --output-dir, merge within that directory so every file lands there instead
+            // of being written back to wherever it already lives in the project package directories.
+            packageDirs: outputDirExplicit ? [outputDir] : packageDirs,
+            chunkSizeOverride: flags['chunk-size'],
+            commandThis: this,
+            debug: debugMode,
+        });
+        this.displaySummary(outcome.successes, outcome.failures, outcome.skipped, outputDir);
+        WebSocketClient.sendRefreshCommandsMessage();
+        if (isOutcomeFailed(outcome, ignoreErrors)) {
+            throw new SfError(t('crudReadFailedSummary', { count: String(outcome.failures.length) }));
+        }
+        return {
+            successes: outcome.successes,
+            failures: outcome.failures,
+            skipped: outcome.skipped,
+            outputDir,
+            orgId: flags['target-org'].getOrgId(),
+        };
+    }
+    displaySummary(successes, failures, skipped, outputDir) {
+        if (successes.length > 0) {
+            uxLog('success', this, c.green(t('crudReadSuccessCount', { count: String(successes.length), outputDir })));
+            uxLogTable(this, successes.map((s) => ({ type: s.type, fullName: s.fullName, status: 'OK' })), ['type', 'fullName', 'status']);
+        }
+        if (failures.length > 0) {
+            uxLog('warning', this, c.yellow(t('crudReadFailureCount', { count: String(failures.length) })));
+            uxLogTable(this, failures.map((f) => ({ type: f.type, fullName: f.fullName, error: f.error })), ['type', 'fullName', 'error']);
+        }
+        if (skipped.length > 0) {
+            uxLog('warning', this, c.yellow(t('crudSkippedReadCount', { count: String(skipped.length) })));
+            uxLogTable(this, skipped.map((s) => ({ type: s.type, fullName: s.fullName })), ['type', 'fullName']);
+        }
+    }
+}
+//# sourceMappingURL=read.js.map

package/lib/commands/hardis/mdapi/read.js.map

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

package/lib/commands/hardis/mdapi/upsert.d.ts

@@ -0,0 +1,11 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+import { AnyJson } from '@salesforce/ts-types';
+export default class MdapiUpsert extends SfCommand<any> {
+    static title: string;
+    static description: string;
+    static examples: string[];
+    static flags: any;
+    static requiresProject: boolean;
+    run(): Promise<AnyJson>;
+    private displaySummary;
+}