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

package/lib/commands/cuneiform/profile.js

@@ -0,0 +1,322 @@
+/*
+ * 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 { ProfilingDefinitionService, } from '../../services/ProfilingDefinitionService.js';
+import { ProfilingExecutionService } from '../../services/ProfilingExecutionService.js';
+import { ProfileOperation, ProfileErrorCodes } from '../../operations/ProfileOperation.js';
+import { OrgInfoService } from '../../services/OrgInfoService.js';
+import { renderOrgContext, renderSummaryBox, displaySummaryBox, sectionHeader } from '../../utils/formatting/index.js';
+import { formatNumber } from '../../utils/formatting/numbers.js';
+import { CuneiformCommand } from '../../base/cuneiform-command.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@peernova/cuneiform-sf', 'profile');
+/**
+ * Executes profiling operations on Cuneiform profiling definitions.
+ *
+ * Use this command to:
+ * - Profile a single definition by key or ID
+ * - Profile multiple definitions in bulk by method
+ * - Apply filters to control which definitions are processed
+ * - Monitor progress for bulk operations
+ *
+ * @example
+ * ```bash
+ * # Profile a single definition by key
+ * sf cuneiform profile --target-org myOrg --keys PD-0001
+ *
+ * # Profile all metadata definitions
+ * sf cuneiform profile --target-org myOrg --method metadata --parallel 10
+ *
+ * # Profile historical definitions with filters
+ * sf cuneiform profile --target-org myOrg --method historical --status "NOT PROFILED" --limit 5
+ * ```
+ */
+// eslint-disable-next-line sf-plugin/only-extend-SfCommand -- CuneiformCommand extends SfCommand with shared access gate logic
+export default class Profile 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(),
+        keys: Flags.string({
+            summary: messages.getMessage('flags.keys.summary'),
+            char: 'k',
+            multiple: true,
+            aliases: ['key'],
+            deprecateAliases: true,
+            exclusive: ['id', 'method'],
+        }),
+        id: Flags.string({
+            summary: messages.getMessage('flags.id.summary'),
+            exclusive: ['keys', 'method'],
+        }),
+        method: Flags.option({
+            summary: messages.getMessage('flags.method.summary'),
+            char: 't',
+            options: ['metadata', 'historical', 'comparative'],
+            aliases: ['type'],
+            deprecateAliases: true,
+            exclusive: ['keys', 'id'],
+        })(),
+        status: Flags.option({
+            summary: messages.getMessage('flags.status.summary'),
+            char: 's',
+            options: ['NOT PROFILED', 'IN PROGRESS', 'SUCCESS', 'COMPLETE w/ FAILURES', 'ERROR'],
+        })(),
+        namespace: Flags.string({
+            summary: messages.getMessage('flags.namespace.summary'),
+            char: 'n',
+        }),
+        category: Flags.string({
+            summary: messages.getMessage('flags.category.summary'),
+            char: 'c',
+        }),
+        'time-category': Flags.string({
+            summary: messages.getMessage('flags.time-category.summary'),
+        }),
+        'segment-category': Flags.string({
+            summary: messages.getMessage('flags.segment-category.summary'),
+        }),
+        limit: Flags.integer({
+            summary: messages.getMessage('flags.limit.summary'),
+            char: 'l',
+            min: 1,
+            default: 50,
+        }),
+        'skip-empty': Flags.boolean({
+            summary: messages.getMessage('flags.skip-empty.summary'),
+            default: true,
+            allowNo: true,
+        }),
+        parallel: Flags.integer({
+            summary: messages.getMessage('flags.parallel.summary'),
+            default: 5,
+            min: 1,
+            max: 10,
+        }),
+        format: Flags.option({
+            summary: messages.getMessage('flags.format.summary'),
+            options: ['table', 'json'],
+            default: 'table',
+        })(),
+    };
+    /**
+     * Maps operation error codes to i18n message bundle keys.
+     * Used by the inherited `resolveErrorMessage()` for consistent error resolution.
+     */
+    static ERROR_CODE_MAP = {
+        [ProfileErrorCodes.NO_SELECTION]: 'errors.noSelection',
+        [ProfileErrorCodes.INVALID_SELECTION]: 'errors.invalidSelection',
+        [ProfileErrorCodes.INVALID_ID]: 'errors.invalidId',
+        [ProfileErrorCodes.DEFINITION_NOT_FOUND]: 'errors.definitionNotFound',
+        [ProfileErrorCodes.INVALID_PARALLEL]: 'errors.invalidParallel',
+        [ProfileErrorCodes.QUERY_FAILED]: 'errors.queryFailed',
+        [ProfileErrorCodes.NO_DEFINITIONS_FOUND]: 'errors.noDefinitionsFound',
+        [ProfileErrorCodes.EXECUTION_FAILED]: 'errors.executionFailed',
+    };
+    /**
+     * Executes the profile command.
+     *
+     * @returns ProfileCommandResult with execution statistics
+     */
+    async run() {
+        const { flags } = await this.parse(Profile);
+        const targetOrg = flags['target-org'].getUsername();
+        if (!targetOrg) {
+            this.error('Could not determine target org username');
+        }
+        // Initialize services
+        const { facade, soqlAdapter, restAdapter } = await this.initConnection(flags);
+        const definitionService = new ProfilingDefinitionService({ soqlAdapter, restAdapter });
+        const executionService = new ProfilingExecutionService({
+            restAdapter,
+            soqlAdapter,
+            profilingDefinitionService: definitionService,
+        });
+        // Create operation
+        const operation = new ProfileOperation(executionService, definitionService);
+        // Fetch and display org identity
+        const orgInfoService = new OrgInfoService({ connectionFacade: facade, soqlAdapter });
+        this.spinner.start(messages.getMessage('spinner.connecting'));
+        const orgIdentityResult = await orgInfoService.getOrgIdentity();
+        this.spinner.stop();
+        if (orgIdentityResult.success) {
+            this.log('');
+            this.log(renderOrgContext({
+                orgName: orgIdentityResult.data.organizationName,
+                orgId: orgIdentityResult.data.organizationId,
+                instanceUrl: facade.instanceUrl ?? '',
+                isSandbox: orgIdentityResult.data.isSandbox ?? false,
+            }));
+        }
+        // Display configuration for bulk mode
+        if (flags.method) {
+            this.displayBulkConfiguration(flags);
+        }
+        // Build operation options
+        const operationOptions = {
+            targetOrg,
+            keys: flags.keys,
+            definitionId: flags.id,
+            type: flags.method,
+            status: flags.status,
+            namespace: flags.namespace,
+            category: flags.category,
+            timeCategory: flags['time-category'],
+            segmentCategory: flags['segment-category'],
+            limit: flags.limit,
+            skipEmpty: flags['skip-empty'],
+            parallel: flags.parallel,
+            onProgress: (message) => {
+                this.spinner.status = message;
+            },
+        };
+        // Execute operation
+        this.spinner.start('Profiling');
+        const result = await operation.execute(operationOptions);
+        this.spinner.stop();
+        // Handle failure
+        if (!result.success) {
+            const errorMessage = Profile.resolveErrorMessage(Profile.ERROR_CODE_MAP, result.errorCode, result.message, messages);
+            this.error(errorMessage, { code: result.errorCode });
+        }
+        const data = result.data;
+        // Display results
+        this.displayResults(data, targetOrg);
+        // Display warnings if any
+        if (result.warnings && result.warnings.length > 0) {
+            this.log('');
+            for (const warning of result.warnings) {
+                this.warn(warning);
+            }
+        }
+        return {
+            success: true,
+            mode: data.mode,
+            executions: data.executions,
+            summary: data.summary,
+        };
+    }
+    /**
+     * Displays bulk execution configuration.
+     *
+     * @param flags - Parsed command flags
+     */
+    displayBulkConfiguration(flags) {
+        const entries = [{ key: 'Method', value: flags.method ?? 'all' }];
+        if (flags.status) {
+            entries.push({ key: 'Status', value: flags.status });
+        }
+        if (flags.namespace) {
+            entries.push({ key: 'Namespace', value: flags.namespace });
+        }
+        if (flags.limit !== undefined) {
+            entries.push({ key: 'Limit', value: String(flags.limit) });
+        }
+        entries.push({ key: 'Parallel threads', value: String(flags.parallel) });
+        entries.push({ key: 'Skip empty objects', value: flags['skip-empty'] ? 'yes' : 'no' });
+        this.log(renderSummaryBox({ title: 'Configuration', entries }));
+    }
+    /**
+     * Displays profiling results.
+     *
+     * @param data - Profile result data
+     * @param targetOrg - Target org username for next-steps guidance
+     */
+    displayResults(data, targetOrg) {
+        this.log('');
+        if (data.mode === 'single') {
+            this.displaySingleResult(data);
+        }
+        else {
+            this.displayBulkResults(data);
+        }
+        // Summary (aligned with definition purge)
+        const summaryEntries = [
+            { key: messages.getMessage('display.summarySuccessful'), value: formatNumber(data.summary.successful) },
+            { key: messages.getMessage('display.summaryFailedLabel'), value: formatNumber(data.summary.failed) },
+            { key: messages.getMessage('display.summarySkippedLabel'), value: formatNumber(data.summary.skipped) },
+            { key: messages.getMessage('display.summaryTotalLabel'), value: formatNumber(data.summary.total) },
+        ];
+        displaySummaryBox(this.log.bind(this), {
+            title: messages.getMessage('display.summaryTitle'),
+            entries: summaryEntries,
+        });
+        // Next steps guidance
+        this.log('');
+        this.log(messages.getMessage('display.nextSteps', [targetOrg]));
+    }
+    /**
+     * Displays single-mode result.
+     *
+     * @param data - Profile result data
+     */
+    displaySingleResult(data) {
+        this.log(sectionHeader('Result'));
+        const exec = data.executions[0];
+        this.log(messages.getMessage('display.definition', [exec.definitionKey, exec.objectName]));
+        this.log(messages.getMessage('display.status', [exec.status === 'success' ? 'Submitted' : exec.status]));
+        if (exec.requestId) {
+            this.log(messages.getMessage('display.requestId', [exec.requestId]));
+        }
+        if (exec.status === 'failed') {
+            this.log('');
+            this.warn(messages.getMessage('display.error', [exec.errorMessage ?? 'Unknown error']));
+            if (exec.resolution) {
+                this.log(messages.getMessage('display.resolution', [exec.resolution]));
+            }
+        }
+        else if (exec.status === 'skipped') {
+            this.log(messages.getMessage('display.skipReason', [exec.skipReason ?? 'Unknown']));
+        }
+    }
+    /**
+     * Displays bulk-mode results.
+     *
+     * @param data - Profile result data
+     */
+    displayBulkResults(data) {
+        this.log(messages.getMessage('display.processed', [String(data.executions.length)]));
+        this.log('');
+        this.log(sectionHeader('Results'));
+        // Results table
+        this.table({
+            data: data.executions.map((exec) => ({
+                key: exec.definitionKey,
+                object: exec.objectName,
+                requestId: exec.requestId ?? '-',
+                status: exec.status === 'success' ? 'Submitted' : exec.status,
+                error: exec.errorMessage ?? exec.skipReason ?? '-',
+            })),
+            columns: [
+                { key: 'key', name: 'DEFINITION' },
+                { key: 'object', name: 'OBJECT' },
+                { key: 'requestId', name: 'REQUEST ID' },
+                { key: 'status', name: 'STATUS' },
+                { key: 'error', name: 'ERROR/REASON' },
+            ],
+        });
+        // Failed executions with resolution guidance
+        const failed = data.executions.filter((e) => e.status === 'failed' && e.resolution);
+        if (failed.length > 0) {
+            this.log('');
+            this.log(messages.getMessage('display.resolutionGuidance'));
+            for (const exec of failed) {
+                this.log(`  ${messages.getMessage('display.resolutionItem', [exec.definitionKey, exec.resolution])}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=profile.js.map

package/lib/commands/cuneiform/profile.js.map

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

package/lib/commands/cuneiform/summary/purge.d.ts

@@ -0,0 +1,77 @@
+import { CuneiformCommand } from '../../../base/cuneiform-command.js';
+/**
+ * Command result type for JSON output.
+ */
+export type SummaryPurgeCommandResult = {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Number of summaries deleted */
+    deleted: number;
+    /** Number of summaries skipped */
+    skipped: number;
+    /** Number of summaries that failed to delete */
+    failed: number;
+    /** Total number of summaries processed */
+    total: number;
+    /** Whether this was a dry run */
+    dryRun: boolean;
+    /** Whether prune mode was active */
+    pruneMode: boolean;
+    /** Whether the operation was cancelled by the user */
+    cancelled?: boolean;
+    /** Error message if failed */
+    error?: string;
+};
+/**
+ * Purges profiling summaries from a Salesforce org.
+ *
+ * Deletes summaries matching filters or specific IDs. Only summaries with
+ * terminal profiling statuses are eligible for deletion. Cascade delete
+ * automatically removes child Field Results, Value Results, and KPI Results.
+ *
+ * Optional --prune mode preserves the latest summary per definition,
+ * only deleting older summaries.
+ */
+export default class SummaryPurge extends CuneiformCommand<SummaryPurgeCommandResult> {
+    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>;
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        ids: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        objects: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        category: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'is-active': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        prune: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'no-prompt': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        format: import("@oclif/core/interfaces").OptionFlag<"table" | "json", import("@oclif/core/interfaces").CustomOptions>;
+    };
+    /**
+     * Maps error codes to i18n message keys.
+     */
+    private static readonly ERROR_CODE_MAP;
+    /**
+     * Renders a padded row for the progress table.
+     */
+    private static formatProgressRow;
+    /**
+     * Executes the summary purge command.
+     */
+    run(): Promise<SummaryPurgeCommandResult>;
+    /**
+     * Displays progress events as a dynamically-sized table.
+     */
+    private displayProgressTable;
+    /**
+     * Displays the paginated preview before user confirmation.
+     */
+    private displayPreview;
+    /**
+     * Displays purge results.
+     */
+    private displayResults;
+}