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

package/lib/commands/cuneiform/profile/request/delete.js

@@ -0,0 +1,223 @@
+/*
+ * 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 { ProfileRequestService } from '../../../../services/ProfileRequestService.js';
+import { ProfileRequestDeleteOperation, ProfileRequestDeleteErrorCodes, } from '../../../../operations/ProfileRequestDeleteOperation.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@peernova/cuneiform-sf', 'profile.request.delete');
+/**
+ * Permanently deletes profiling requests from a Salesforce org.
+ *
+ * Deletes canceled or rejected profiling requests. Queued and completed
+ * requests are protected — this is an irreversible operation.
+ */
+// eslint-disable-next-line sf-plugin/only-extend-SfCommand -- CuneiformCommand extends SfCommand with shared access gate logic
+export default class ProfileRequestDelete 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(),
+        all: Flags.boolean({
+            summary: messages.getMessage('flags.all.summary'),
+            char: 'a',
+            exclusive: ['request-ids'],
+        }),
+        'request-ids': Flags.string({
+            summary: messages.getMessage('flags.request-ids.summary'),
+            char: 'i',
+            multiple: true,
+            exclusive: ['all'],
+        }),
+        'dry-run': Flags.boolean({
+            summary: messages.getMessage('flags.dry-run.summary'),
+            char: 'd',
+            default: false,
+        }),
+        'no-prompt': Flags.boolean({
+            summary: messages.getMessage('flags.no-prompt.summary'),
+            char: 'y',
+            default: false,
+        }),
+    };
+    /**
+     * Maps error codes to i18n message keys.
+     */
+    static ERROR_CODE_MAP = {
+        [ProfileRequestDeleteErrorCodes.INVALID_IDS]: 'errors.invalidIds',
+        [ProfileRequestDeleteErrorCodes.NO_DELETABLE]: 'errors.noDeletable',
+        [ProfileRequestDeleteErrorCodes.DELETE_FAILED]: 'errors.deleteFailed',
+        [ProfileRequestDeleteErrorCodes.PARTIAL_FAILURE]: 'errors.partialFailure',
+    };
+    /**
+     * Executes the profile request delete command.
+     */
+    async run() {
+        const { flags } = await this.parse(ProfileRequestDelete);
+        const targetOrg = flags['target-org'].getUsername();
+        if (!targetOrg) {
+            this.error(messages.getMessage('errors.noTargetOrg'));
+        }
+        const dryRun = flags['dry-run'];
+        const noPrompt = flags['no-prompt'];
+        // Initialize services
+        const { soqlAdapter, restAdapter } = await this.initConnection(flags);
+        const service = new ProfileRequestService({ soqlAdapter, restAdapter });
+        const operation = new ProfileRequestDeleteOperation(service);
+        // Parse request IDs
+        const requestIds = ProfileRequestDelete.parseMultiValueFlag(flags['request-ids']);
+        // Validate mutually exclusive flags
+        const hasAll = flags.all === true;
+        const hasIds = requestIds !== undefined && requestIds.length > 0;
+        if (hasAll && hasIds) {
+            this.error(messages.getMessage('errors.mutuallyExclusive'));
+        }
+        if (!hasAll && !hasIds) {
+            this.error(messages.getMessage('errors.noSelection'));
+        }
+        // Build operation options
+        const operationOptions = {
+            all: flags.all,
+            requestIds,
+            dryRun,
+            noPrompt,
+            onDeletableFound: (count) => {
+                this.spinner.stop(`${count} deletable request(s) found`);
+            },
+            onConfirm: async (count) => {
+                // For --json mode, skip interactive prompt
+                if (this.jsonEnabled())
+                    return true;
+                return this.confirm({
+                    message: count === 1
+                        ? messages.getMessage('prompt.confirm.singular')
+                        : messages.getMessage('prompt.confirm.plural', [String(count)]),
+                });
+            },
+        };
+        // Execute
+        const modeText = dryRun ? '(dry run) ' : '';
+        this.log(`Checking for deletable profiling requests ${modeText}...`);
+        this.spinner.start('Retrieving deletable requests');
+        const result = await operation.execute(operationOptions);
+        this.spinner.stop();
+        // Handle no deletable requests
+        if (!result.success && result.errorCode === ProfileRequestDeleteErrorCodes.NO_DELETABLE) {
+            this.log('');
+            this.log(messages.getMessage('output.noDeletable'));
+            if (result.data.failed.length > 0) {
+                this.log('');
+                this.log(messages.getMessage('output.failedHeader'));
+                for (const f of result.data.failed) {
+                    this.log(`  ${f.id}: ${f.error}`);
+                }
+            }
+            return {
+                success: true,
+                deleted: 0,
+                failed: result.data.failed.length,
+                totalDeletable: 0,
+                dryRun,
+                failures: result.data.failed.length > 0 ? result.data.failed : undefined,
+            };
+        }
+        // Handle partial failure (some deleted, some could not be deleted)
+        if (!result.success && result.errorCode === ProfileRequestDeleteErrorCodes.PARTIAL_FAILURE) {
+            this.displayResults(result.data, dryRun);
+            return {
+                success: false,
+                deleted: result.data.deleted.length,
+                failed: result.data.failed.length,
+                totalDeletable: result.data.totalDeletable,
+                dryRun,
+                requests: result.data.deleted,
+                failures: result.data.failed,
+            };
+        }
+        // Handle user cancellation
+        if (result.success && result.metadata?.userCancelled) {
+            this.log('');
+            this.log(messages.getMessage('output.userCancelled'));
+            return {
+                success: true,
+                deleted: 0,
+                failed: 0,
+                totalDeletable: result.data.totalDeletable,
+                dryRun,
+                userCancelled: true,
+            };
+        }
+        // Handle other failures
+        if (!result.success) {
+            const errorMessage = ProfileRequestDelete.resolveErrorMessage(ProfileRequestDelete.ERROR_CODE_MAP, result.errorCode, result.message ?? 'Unknown error', messages);
+            this.error(errorMessage, { code: result.errorCode });
+        }
+        const data = result.data;
+        // Display results
+        this.displayResults(data, dryRun);
+        return {
+            success: true,
+            deleted: data.deleted.length,
+            failed: data.failed.length,
+            totalDeletable: data.totalDeletable,
+            dryRun,
+            requests: data.deleted,
+            failures: data.failed,
+        };
+    }
+    /**
+     * Displays delete results.
+     */
+    displayResults(data, dryRun) {
+        this.log('');
+        if (dryRun) {
+            this.log(messages.getMessage('output.dryRunTitle'));
+            this.log('');
+            // Show table only for dry-run preview
+            if (data.deleted.length > 0) {
+                this.table({
+                    data: data.deleted.map((r) => ({
+                        name: r.name,
+                        status: r.status,
+                        object: r.objectName,
+                        definition: r.definitionName,
+                    })),
+                    columns: [
+                        { key: 'name', name: 'NAME' },
+                        { key: 'status', name: 'STATUS' },
+                        { key: 'object', name: 'OBJECT' },
+                        { key: 'definition', name: 'DEFINITION' },
+                    ],
+                });
+                this.log('');
+            }
+            this.log(messages.getMessage('output.dryRunSummary', [String(data.deleted.length)]));
+        }
+        else {
+            this.log(messages.getMessage('output.deleted', [String(data.deleted.length)]));
+        }
+        // Show failed requests
+        if (data.failed.length > 0) {
+            this.log('');
+            this.log(messages.getMessage('output.failedHeader'));
+            for (const f of data.failed) {
+                this.log(`  ${f.id}: ${f.error}`);
+            }
+            this.warn(messages.getMessage('errors.partialFailure', [String(data.deleted.length), String(data.totalDeletable)]));
+        }
+    }
+}
+//# sourceMappingURL=delete.js.map

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

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

package/lib/commands/cuneiform/profile/request/list.d.ts

@@ -0,0 +1,35 @@
+import { CuneiformCommand } from '../../../../base/cuneiform-command.js';
+import type { IProfileRequest } from '../../../../models/profile-request-types.js';
+/**
+ * Command result type for JSON output.
+ */
+export type ProfileRequestListCommandResult = {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** List of profiling requests */
+    requests: IProfileRequest[];
+    /** Error message if failed */
+    error?: string;
+};
+/**
+ * Lists profiling requests from a Salesforce org.
+ *
+ * Retrieves pnova__Profiling_Request__c records with their status,
+ * definition, and object information. Supports filtering by status
+ * and pagination via --limit.
+ */
+export default class ProfileRequestList extends CuneiformCommand<ProfileRequestListCommandResult> {
+    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>;
+        status: import("@oclif/core/interfaces").OptionFlag<"Queued" | "Canceled" | "Completed" | "Rejected" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    /**
+     * Executes the profile request list command.
+     */
+    run(): Promise<ProfileRequestListCommandResult>;
+}

package/lib/commands/cuneiform/profile/request/list.js

@@ -0,0 +1,102 @@
+/*
+ * 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 { ProfileRequestService } from '../../../../services/ProfileRequestService.js';
+import { ProfileRequestListOperation } from '../../../../operations/ProfileRequestListOperation.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@peernova/cuneiform-sf', 'profile.request.list');
+/**
+ * Lists profiling requests from a Salesforce org.
+ *
+ * Retrieves pnova__Profiling_Request__c records with their status,
+ * definition, and object information. Supports filtering by status
+ * and pagination via --limit.
+ */
+// eslint-disable-next-line sf-plugin/only-extend-SfCommand -- CuneiformCommand extends SfCommand with shared access gate logic
+export default class ProfileRequestList 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(),
+        status: Flags.option({
+            summary: messages.getMessage('flags.status.summary'),
+            char: 's',
+            options: ['Queued', 'Canceled', 'Completed', 'Rejected'],
+        })(),
+        limit: Flags.integer({
+            summary: messages.getMessage('flags.limit.summary'),
+            char: 'l',
+            min: 1,
+            max: 200,
+            default: 25,
+        }),
+    };
+    /**
+     * Executes the profile request list command.
+     */
+    async run() {
+        const { flags } = await this.parse(ProfileRequestList);
+        const targetOrg = flags['target-org'].getUsername();
+        if (!targetOrg) {
+            this.error(messages.getMessage('errors.noTargetOrg'));
+        }
+        // Initialize services
+        const { soqlAdapter, restAdapter } = await this.initConnection(flags);
+        const service = new ProfileRequestService({ soqlAdapter, restAdapter });
+        const operation = new ProfileRequestListOperation(service);
+        // Execute operation
+        const result = await operation.execute({
+            status: flags.status,
+            limit: flags.limit,
+        });
+        if (!result.success) {
+            const errorDetail = result.message ?? 'Unknown error';
+            this.error(messages.getMessage('errors.queryFailed', [errorDetail]), { code: result.errorCode });
+        }
+        const requests = result.data;
+        // Render output
+        if (requests.length === 0) {
+            this.log(messages.getMessage('output.noRequests'));
+        }
+        else {
+            this.log(messages.getMessage('output.title'));
+            this.table({
+                data: requests.map((r) => ({
+                    name: r.name,
+                    status: r.status,
+                    object: r.objectName,
+                    definition: r.definitionName,
+                    submittedBy: r.submittedBy,
+                    createdDate: r.createdDate,
+                })),
+                columns: [
+                    { key: 'name', name: 'NAME' },
+                    { key: 'status', name: 'STATUS' },
+                    { key: 'object', name: 'OBJECT' },
+                    { key: 'definition', name: 'DEFINITION' },
+                    { key: 'submittedBy', name: 'SUBMITTED BY' },
+                    { key: 'createdDate', name: 'CREATED DATE' },
+                ],
+            });
+        }
+        return {
+            success: true,
+            requests,
+        };
+    }
+}
+//# sourceMappingURL=list.js.map

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

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

package/lib/commands/cuneiform/profile.d.ts

@@ -0,0 +1,90 @@
+import { type ProfileResult } from '../../operations/ProfileOperation.js';
+import { CuneiformCommand } from '../../base/cuneiform-command.js';
+/**
+ * Command result type for JSON output.
+ * Composes from ProfileResult to stay in sync with the operation layer.
+ */
+export type ProfileCommandResult = ProfileResult & {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Error message if operation failed */
+    error?: string;
+};
+/**
+ * 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
+ * ```
+ */
+export default class Profile extends CuneiformCommand<ProfileCommandResult> {
+    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>;
+        keys: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        id: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        method: import("@oclif/core/interfaces").OptionFlag<"metadata" | "historical" | "comparative" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        status: import("@oclif/core/interfaces").OptionFlag<"ERROR" | "NOT PROFILED" | "IN PROGRESS" | "SUCCESS" | "COMPLETE w/ FAILURES" | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        namespace: 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>;
+        'time-category': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'segment-category': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'skip-empty': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        parallel: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<"table" | "json", import("@oclif/core/interfaces").CustomOptions>;
+    };
+    /**
+     * Maps operation error codes to i18n message bundle keys.
+     * Used by the inherited `resolveErrorMessage()` for consistent error resolution.
+     */
+    private static readonly ERROR_CODE_MAP;
+    /**
+     * Executes the profile command.
+     *
+     * @returns ProfileCommandResult with execution statistics
+     */
+    run(): Promise<ProfileCommandResult>;
+    /**
+     * Displays bulk execution configuration.
+     *
+     * @param flags - Parsed command flags
+     */
+    private displayBulkConfiguration;
+    /**
+     * Displays profiling results.
+     *
+     * @param data - Profile result data
+     * @param targetOrg - Target org username for next-steps guidance
+     */
+    private displayResults;
+    /**
+     * Displays single-mode result.
+     *
+     * @param data - Profile result data
+     */
+    private displaySingleResult;
+    /**
+     * Displays bulk-mode results.
+     *
+     * @param data - Profile result data
+     */
+    private displayBulkResults;
+}