@peernova/cuneiform-sf 1.0.2 → 1.0.4-beta.10

package/lib/commands/cuneiform/object/list.js

@@ -0,0 +1,264 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+import { Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { CuneiformCommand } from '../../../base/cuneiform-command.js';
+import { ObjectFilteringService } from '../../../services/ObjectFilteringService.js';
+import { ContactPointService } from '../../../services/ContactPointService.js';
+import { ObjectListCommandService, } from '../../../services/ObjectListCommandService.js';
+import { OrgInfoService } from '../../../services/OrgInfoService.js';
+import { ProfilingRestClient } from '../../../adapters/rest/profiling-rest-client.js';
+import { parseNamespaceFilter } from '../../../services/namespace-filter.js';
+import { loadingMessage } from '../../../utils/formatting/index.js';
+import { displayResults, buildCommandResult } from '../../../utils/formatting/object-list-display.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@peernova/cuneiform-sf', 'object.list');
+/**
+ * Lists Salesforce objects with record counts and optional filtering.
+ *
+ * Use this command to:
+ * - Discover objects in an org with record counts
+ * - Filter objects by type, namespace, or naming pattern
+ * - Find objects with specific characteristics (OwnerId, record types)
+ * - Analyze contact point fields for data profiling
+ *
+ * @example
+ * ```bash
+ * # List all objects with record counts
+ * sf cuneiform object list --target-org myOrg
+ *
+ * # List custom objects only
+ * sf cuneiform object list --target-org myOrg --filter custom
+ *
+ * # Filter by namespace and include contact points
+ * sf cuneiform object list --target-org myOrg --namespace SBQQ --with-contact-points
+ * ```
+ */
+// eslint-disable-next-line sf-plugin/only-extend-SfCommand -- CuneiformCommand extends SfCommand with shared access gate logic
+export default class ObjectList extends CuneiformCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    // eslint-disable-next-line sf-plugin/spread-base-flags -- CuneiformCommand has no additional flags to spread
+    static flags = {
+        'target-org': Flags.requiredOrg({
+            summary: messages.getMessage('flags.target-org.summary'),
+            char: 'o',
+            required: true,
+        }),
+        'api-version': Flags.orgApiVersion(),
+        object: Flags.string({
+            summary: messages.getMessage('flags.object.summary'),
+            char: 'O',
+        }),
+        filter: Flags.option({
+            summary: messages.getMessage('flags.filter.summary'),
+            char: 'f',
+            options: ['all', 'standard', 'custom'],
+            default: 'all',
+        })(),
+        namespace: Flags.string({
+            summary: messages.getMessage('flags.namespace.summary'),
+            char: 'n',
+        }),
+        pattern: Flags.string({
+            summary: messages.getMessage('flags.pattern.summary'),
+            char: 'p',
+        }),
+        'with-records': Flags.boolean({
+            summary: messages.getMessage('flags.with-records.summary'),
+            default: false,
+        }),
+        'without-records': Flags.boolean({
+            summary: messages.getMessage('flags.without-records.summary'),
+            default: false,
+        }),
+        'with-owner': Flags.boolean({
+            summary: messages.getMessage('flags.with-owner.summary'),
+            default: false,
+        }),
+        'with-record-types': Flags.boolean({
+            summary: messages.getMessage('flags.with-record-types.summary'),
+            default: false,
+        }),
+        'with-business-process': Flags.boolean({
+            summary: messages.getMessage('flags.with-business-process.summary'),
+            default: false,
+        }),
+        'with-fields': Flags.boolean({
+            summary: messages.getMessage('flags.with-fields.summary'),
+            default: false,
+        }),
+        'with-references': Flags.boolean({
+            summary: messages.getMessage('flags.with-references.summary'),
+            default: false,
+        }),
+        'with-contact-points': Flags.boolean({
+            summary: messages.getMessage('flags.with-contact-points.summary'),
+            default: false,
+        }),
+        classification: Flags.option({
+            summary: messages.getMessage('flags.classification.summary'),
+            char: 'c',
+            options: ['customer', 'internal', 'all'],
+            default: 'all',
+        })(),
+        'min-records': Flags.integer({
+            summary: messages.getMessage('flags.min-records.summary'),
+            min: 0,
+            default: 0,
+        }),
+        sort: Flags.option({
+            summary: messages.getMessage('flags.sort.summary'),
+            char: 's',
+            options: ['name', 'recordCount', 'label'],
+            default: 'recordCount',
+        })(),
+        limit: Flags.integer({
+            summary: messages.getMessage('flags.limit.summary'),
+            char: 'l',
+            min: 1,
+            default: 50,
+        }),
+    };
+    /**
+     * Executes the object list command.
+     *
+     * @returns ObjectListCommandResult with success status, summary, and object list
+     */
+    async run() {
+        const { flags } = await this.parse(ObjectList);
+        // Validate mutually exclusive flags
+        if (flags['with-records'] && flags['without-records']) {
+            this.error(messages.getMessage('errors.mutuallyExclusiveFlags', ['--with-records', '--without-records']));
+        }
+        this.validateObjectFlagExclusions(flags);
+        // Parse --namespace at the command boundary into the typed NamespaceFilter
+        // discriminated union consumed by service/adapter layers (CLI-3801).
+        const namespaceResult = parseNamespaceFilter(flags.namespace);
+        if (namespaceResult.error) {
+            this.error(messages.getMessage('errors.invalidNamespace', [namespaceResult.error]), {
+                code: 'INVALID_NAMESPACE',
+            });
+        }
+        const targetOrg = flags['target-org'].getUsername();
+        if (!targetOrg) {
+            this.error(messages.getMessage('errors.noTargetOrg'));
+        }
+        if (flags.sort === 'recordCount' &&
+            !flags['with-records'] &&
+            !flags['without-records'] &&
+            flags.object === undefined) {
+            this.warn(messages.getMessage('warnings.sortWithoutRecords'));
+        }
+        // Initialize services
+        const { facade: connectionFacade, soqlAdapter, restAdapter } = await this.initConnection(flags);
+        const restClient = new ProfilingRestClient(restAdapter);
+        const objectFilteringService = new ObjectFilteringService({
+            restApiAdapter: restAdapter,
+            soqlAdapter,
+            restClient,
+        });
+        const contactPointService = new ContactPointService({
+            restApiAdapter: restAdapter,
+        });
+        const objectListCommandService = new ObjectListCommandService({
+            objectFilteringService,
+            contactPointService,
+            restApiAdapter: restAdapter,
+            soqlAdapter,
+        });
+        const orgInfoService = new OrgInfoService({ connectionFacade, soqlAdapter });
+        // Display start message
+        this.log(loadingMessage(messages.getMessage('spinner.listing'), messages.getMessage('spinner.objectsNoun'), targetOrg));
+        // Determine if enrichment flags are active (spinner needed)
+        const hasEnrichment = flags['with-fields'] === true ||
+            flags['with-references'] === true ||
+            flags['with-record-types'] === true ||
+            flags['with-business-process'] === true ||
+            flags['with-contact-points'] === true;
+        if (hasEnrichment) {
+            this.spinner.start(messages.getMessage('spinner.enriching'));
+        }
+        // Execute list operation and org identity fetch in parallel
+        const [result, orgIdentityResult] = await Promise.all([
+            objectListCommandService.listObjects({
+                object: flags.object,
+                filter: flags.filter,
+                namespace: namespaceResult.value,
+                pattern: flags.pattern,
+                withRecords: flags['with-records'],
+                withoutRecords: flags['without-records'],
+                withOwner: flags['with-owner'],
+                withRecordTypes: flags['with-record-types'],
+                withBusinessProcess: flags['with-business-process'],
+                includeFieldCounts: flags['with-fields'],
+                includeReferences: flags['with-references'],
+                withContactPoints: flags['with-contact-points'],
+                classification: flags.classification,
+                minRecords: flags['min-records'],
+                sort: flags.sort,
+                limit: flags.limit,
+                onProgress: hasEnrichment
+                    ? (message) => {
+                        this.spinner.status = message;
+                    }
+                    : undefined,
+            }),
+            orgInfoService.getOrgIdentity(),
+        ]);
+        if (hasEnrichment) {
+            this.spinner.stop();
+        }
+        if (!result.success) {
+            this.error(result.message ?? messages.getMessage('errors.listFailed'), { code: result.errorCode });
+        }
+        // Handle org identity non-fatally
+        let orgIdentity;
+        if (!orgIdentityResult.success) {
+            this.warn(messages.getMessage('errors.orgIdentityFailed'));
+        }
+        else {
+            orgIdentity = orgIdentityResult.data;
+        }
+        // Display results via extracted display module
+        displayResults(this.log.bind(this), result.data, orgIdentity, connectionFacade.instanceUrl, targetOrg);
+        // CLI-4214: surface the record-count reconciliation truncation disclosure (and any other
+        // filtering-chain warnings) so it is never silently dropped (Q21, B17).
+        this.surfaceWarnings(result.data.warnings);
+        return buildCommandResult(result.data, flags, orgIdentity, connectionFacade.instanceUrl, result.metadata);
+    }
+    /**
+     * Surfaces non-fatal filtering-chain warnings (CLI-4214) via `this.warn` so the
+     * record-count reconciliation truncation disclosure is never silently dropped.
+     *
+     * @param warnings - Warnings carried on the command service result, if any
+     */
+    surfaceWarnings(warnings) {
+        if (!warnings)
+            return;
+        for (const warning of warnings) {
+            this.warn(warning);
+        }
+    }
+    validateObjectFlagExclusions(flags) {
+        if (flags.object === undefined)
+            return;
+        if (flags.filter !== 'all')
+            this.error(messages.getMessage('errors.mutuallyExclusiveFlags', ['--object', '--filter']));
+        if (flags.namespace !== undefined)
+            this.error(messages.getMessage('errors.mutuallyExclusiveFlags', ['--object', '--namespace']));
+        if (flags.pattern !== undefined)
+            this.error(messages.getMessage('errors.mutuallyExclusiveFlags', ['--object', '--pattern']));
+        if (flags['without-records'])
+            this.error(messages.getMessage('errors.mutuallyExclusiveFlags', ['--object', '--without-records']));
+        if (flags['min-records'] > 0)
+            this.error(messages.getMessage('errors.mutuallyExclusiveFlags', ['--object', '--min-records']));
+    }
+}
+//# sourceMappingURL=list.js.map

package/lib/commands/cuneiform/object/list.js.map

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

package/lib/commands/cuneiform/org/details.d.ts

@@ -0,0 +1,99 @@
+import { CuneiformCommand } from '../../../base/cuneiform-command.js';
+import { type OrgDetailsResult } from '../../../operations/OrgDetailsOperation.js';
+export type { OrgDetailsResult };
+/**
+ * Displays comprehensive Salesforce org configuration details.
+ *
+ * Use this command to:
+ * - Identify org type and edition
+ * - Check Cuneiform for Salesforce installation status
+ * - Detect installed Salesforce Clouds
+ * - Discover installed namespaces and packages
+ * - Review API usage limits
+ *
+ * @example
+ * ```bash
+ * # Display org details
+ * sf cuneiform org details --target-org myOrg
+ *
+ * # Output as JSON
+ * sf cuneiform org details --target-org myOrg --json
+ * ```
+ */
+export default class OrgDetails extends CuneiformCommand<OrgDetailsResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        'api-version': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sections: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    /**
+     * Resolves the limits display mode from sections filter.
+     * Returns 'default' for 7 profiling-relevant limits, 'all' for grouped, or a group key.
+     */
+    private static resolveLimitsMode;
+    /**
+     * Builds contextual object list command suggestions based on org data.
+     * Returns 1-3 label/flags pairs, most relevant first.
+     *
+     * Selection logic:
+     * - Always: --with-records
+     * - Namespaces + package clouds: --namespace <top cloud>
+     * - Namespaces, no clouds: --namespace <largest namespace>
+     * - No namespaces: --filter custom
+     * - With namespaces: --filter standard --with-records --classification customer
+     */
+    private static buildObjectListSuggestions;
+    /**
+     * Executes the org details command.
+     *
+     * @returns OrgDetailsResult with comprehensive org information
+     */
+    run(): Promise<OrgDetailsResult>;
+    /**
+     * Displays all output sections, filtered by the optional sections list.
+     */
+    private displayAllSections;
+    /**
+     * Displays contextual next steps with tailored object list commands.
+     */
+    private displayNextSteps;
+    /**
+     * Displays identity information.
+     */
+    private displayIdentity;
+    /**
+     * Displays Cuneiform for Salesforce status.
+     */
+    private displayCuneiform;
+    /**
+     * Displays org features.
+     */
+    private displayFeatures;
+    /**
+     * Displays detected clouds.
+     */
+    private displayClouds;
+    /**
+     * Displays namespace summary.
+     */
+    private displayNamespaces;
+    /**
+     * Displays business processes with record type associations.
+     */
+    private displayProcesses;
+    /**
+     * Displays API limits — default (7 key limits), all (grouped), or a specific group.
+     */
+    private displayLimits;
+    /**
+     * Displays the 7 profiling-relevant limits (default mode).
+     */
+    private displayDefaultLimits;
+    /**
+     * Displays grouped limits with sub-headers per category.
+     */
+    private displayGroupedLimits;
+}