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

package/lib/operations/ProfileOperation.js

@@ -0,0 +1,373 @@
+/*
+ * 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 { createSuccessResult, createFailureResult } from '../models/service-result.js';
+import { validateSalesforceId } from '../services/validation.js';
+/**
+ * Error codes specific to profile operations.
+ */
+export const ProfileErrorCodes = {
+    /** No selection provided (key/id/type) */
+    NO_SELECTION: 'PROFILE_NO_SELECTION',
+    /** Multiple selection flags provided */
+    INVALID_SELECTION: 'PROFILE_INVALID_SELECTION',
+    /** Definition not found */
+    DEFINITION_NOT_FOUND: 'PROFILE_DEFINITION_NOT_FOUND',
+    /** Definition ID has invalid Salesforce ID format */
+    INVALID_ID: 'PROFILE_INVALID_ID',
+    /** Parallel out of range (1-10) */
+    INVALID_PARALLEL: 'PROFILE_INVALID_PARALLEL',
+    /** Query for definitions failed */
+    QUERY_FAILED: 'PROFILE_QUERY_FAILED',
+    /** No definitions found matching filters */
+    NO_DEFINITIONS_FOUND: 'PROFILE_NO_DEFINITIONS_FOUND',
+    /** Execution failed */
+    EXECUTION_FAILED: 'PROFILE_EXECUTION_FAILED',
+    /** Operation failed unexpectedly */
+    OPERATION_FAILED: 'PROFILE_OPERATION_FAILED',
+};
+/**
+ * Error messages for validation error codes.
+ */
+const VALIDATION_ERROR_MESSAGES = {
+    [ProfileErrorCodes.NO_SELECTION]: 'No selection provided. Specify --key, --id, or --type flag.',
+    [ProfileErrorCodes.INVALID_SELECTION]: 'Invalid flag combination. Only one of --key, --id, or --type allowed.',
+    [ProfileErrorCodes.INVALID_PARALLEL]: 'Invalid --parallel value. Must be between 1 and 10.',
+};
+/**
+ * Orchestrates profiling execution for single and bulk modes.
+ *
+ * Follows the 4-layer architecture: Command → Operation → Service → API
+ * This operation layer handles business logic orchestration:
+ * 1. Validates options (must have exactly one of key/id/type)
+ * 2. Routes to single or bulk execution
+ * 3. Transforms service results to spec-compliant ProfileResult format
+ * 4. Handles partial failures (return success if any succeeded)
+ *
+ * @example
+ * ```typescript
+ * const operation = new ProfileOperation(executionService, definitionService);
+ *
+ * // Single mode
+ * const result = await operation.execute({
+ *   targetOrg: 'myOrg',
+ *   key: 'PD-0001',
+ * });
+ *
+ * // Bulk mode
+ * const result = await operation.execute({
+ *   targetOrg: 'myOrg',
+ *   type: 'metadata',
+ *   parallel: 5,
+ *   onProgress: (msg) => console.log(msg),
+ * });
+ * ```
+ */
+export class ProfileOperation {
+    executionService;
+    definitionService;
+    logger;
+    /**
+     * Creates a new ProfileOperation instance.
+     *
+     * @param executionService - Service for executing and monitoring profiling operations
+     * @param definitionService - Service for querying profiling definitions
+     * @param logger - Optional logger for debug output
+     */
+    constructor(executionService, definitionService, logger) {
+        this.executionService = executionService;
+        this.definitionService = definitionService;
+        this.logger = logger;
+    }
+    /**
+     * Validates profile operation options.
+     *
+     * @param options - The profile options to validate
+     * @returns Error code if invalid, undefined if valid
+     */
+    static validateOptions(options) {
+        const selections = [options.keys?.length ? options.keys : undefined, options.definitionId, options.type].filter((v) => v !== undefined);
+        if (selections.length === 0) {
+            return ProfileErrorCodes.NO_SELECTION;
+        }
+        if (selections.length > 1) {
+            return ProfileErrorCodes.INVALID_SELECTION;
+        }
+        if (options.parallel !== undefined && (options.parallel < 1 || options.parallel > 10)) {
+            return ProfileErrorCodes.INVALID_PARALLEL;
+        }
+        return undefined;
+    }
+    /**
+     * Creates an empty ProfileResult for failure cases.
+     *
+     * @param mode - The execution mode
+     * @returns Empty ProfileResult
+     */
+    static createEmptyResult(mode) {
+        return {
+            mode,
+            executions: [],
+            summary: {
+                total: 0,
+                successful: 0,
+                failed: 0,
+                skipped: 0,
+            },
+        };
+    }
+    /**
+     * Executes the profile operation.
+     *
+     * @param options - Profile operation options
+     * @returns ServiceResult containing ProfileResult
+     */
+    async execute(options) {
+        const startTime = Date.now();
+        try {
+            this.logger?.log('Starting profile execution operation');
+            // Validate options
+            const validationError = ProfileOperation.validateOptions(options);
+            if (validationError) {
+                const mode = options.type ? 'bulk' : 'single';
+                return createFailureResult(ProfileOperation.createEmptyResult(mode), validationError, VALIDATION_ERROR_MESSAGES[validationError] ?? 'Validation failed', { metadata: { duration: Date.now() - startTime } });
+            }
+            // Route to single or bulk execution
+            if (options.keys?.length ?? options.definitionId) {
+                return await this.executeSingle(options);
+            }
+            return await this.executeBulk(options);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger?.log(`Profile execution operation failed: ${errorMessage}`);
+            const mode = options.type ? 'bulk' : 'single';
+            return createFailureResult(ProfileOperation.createEmptyResult(mode), ProfileErrorCodes.OPERATION_FAILED, errorMessage, { metadata: { duration: Date.now() - startTime } });
+        }
+    }
+    /**
+     * Executes profiling for a single definition by key or ID.
+     *
+     * @param options - Profile operation options (key or definitionId must be set)
+     * @returns ServiceResult containing ProfileResult
+     */
+    async executeSingle(options) {
+        // Handle multiple keys: iterate and aggregate
+        if (options.keys && options.keys.length > 1) {
+            return this.executeMultipleKeys(options);
+        }
+        const startTime = Date.now();
+        let definitionId;
+        let definitionKey;
+        let objectName;
+        const singleKey = options.keys?.[0];
+        // Resolve by key or by ID
+        if (singleKey) {
+            const defResult = await this.definitionService.getDefinitionByKey(singleKey);
+            if (!defResult.success) {
+                return createFailureResult(ProfileOperation.createEmptyResult('single'), ProfileErrorCodes.QUERY_FAILED, defResult.message ?? `Failed to look up definition: ${singleKey}`, { metadata: { duration: Date.now() - startTime } });
+            }
+            if (defResult.data === null) {
+                return createFailureResult(ProfileOperation.createEmptyResult('single'), ProfileErrorCodes.DEFINITION_NOT_FOUND, `Definition not found: ${singleKey}`, { metadata: { duration: Date.now() - startTime } });
+            }
+            definitionId = defResult.data.id;
+            definitionKey = defResult.data.key;
+            objectName = defResult.data.objectName;
+        }
+        else {
+            // Validate ID format before making any org API call (prevents timeout on invalid IDs)
+            const idFormatError = validateSalesforceId(options.definitionId);
+            if (idFormatError) {
+                return createFailureResult(ProfileOperation.createEmptyResult('single'), ProfileErrorCodes.INVALID_ID, idFormatError, { metadata: { duration: Date.now() - startTime } });
+            }
+            // --id mode: look up to get metadata (format valid, now check existence)
+            const defResult = await this.definitionService.getDefinitionById(options.definitionId);
+            if (!defResult.success) {
+                return createFailureResult(ProfileOperation.createEmptyResult('single'), ProfileErrorCodes.QUERY_FAILED, defResult.message ?? `Failed to look up definition: ${options.definitionId}`, { metadata: { duration: Date.now() - startTime } });
+            }
+            if (defResult.data === null) {
+                return createFailureResult(ProfileOperation.createEmptyResult('single'), ProfileErrorCodes.DEFINITION_NOT_FOUND, `Definition not found: ${options.definitionId}`, { metadata: { duration: Date.now() - startTime } });
+            }
+            definitionId = defResult.data.id;
+            definitionKey = defResult.data.key;
+            objectName = defResult.data.objectName;
+        }
+        this.logger?.log(`Executing single profiling for ${definitionKey} (${objectName})`);
+        options.onProgress?.(`Executing profiling for ${definitionKey} (${objectName})...`);
+        // Execute profiling (skip validation since we already resolved the definition above)
+        const execResult = await this.executionService.execute(definitionId, { skipValidation: true });
+        if (!execResult.success) {
+            const execution = {
+                definitionKey,
+                definitionId,
+                objectName,
+                status: 'failed',
+                errorMessage: execResult.message,
+                errorCode: execResult.errorCode,
+                durationMs: Date.now() - startTime,
+            };
+            return createFailureResult({
+                mode: 'single',
+                executions: [execution],
+                summary: { total: 1, successful: 0, failed: 1, skipped: 0 },
+            }, ProfileErrorCodes.EXECUTION_FAILED, execResult.message ?? 'Profiling execution failed', { metadata: { duration: Date.now() - startTime } });
+        }
+        const requestId = execResult.data;
+        const duration = Date.now() - startTime;
+        // Fire-and-forget: return immediately with requestId (no polling)
+        const execution = {
+            definitionKey,
+            definitionId,
+            objectName,
+            status: 'success',
+            requestId,
+            durationMs: duration,
+        };
+        const profileResult = {
+            mode: 'single',
+            executions: [execution],
+            summary: {
+                total: 1,
+                successful: 1,
+                failed: 0,
+                skipped: 0,
+            },
+        };
+        return createSuccessResult(profileResult, {
+            message: 'Profiling request submitted successfully',
+            metadata: { duration },
+        });
+    }
+    /**
+     * Executes profiling for multiple keys by iterating and aggregating results.
+     *
+     * @param options - Profile operation options (keys must have 2+ entries)
+     * @returns ServiceResult containing aggregated ProfileResult
+     */
+    async executeMultipleKeys(options) {
+        const startTime = Date.now();
+        const executions = [];
+        let successful = 0;
+        let failed = 0;
+        for (const key of options.keys) {
+            // eslint-disable-next-line no-await-in-loop -- sequential execution: each profiling request must complete before the next to avoid API throttling
+            const singleResult = await this.executeSingle({ ...options, keys: [key] });
+            executions.push(...singleResult.data.executions);
+            successful += singleResult.data.summary.successful;
+            failed += singleResult.data.summary.failed;
+        }
+        const result = {
+            mode: 'single',
+            executions,
+            summary: { total: executions.length, successful, failed, skipped: 0 },
+        };
+        return successful > 0
+            ? createSuccessResult(result, {
+                message: `Profiling requests submitted for ${successful} definition(s)`,
+                metadata: { duration: Date.now() - startTime },
+            })
+            : createFailureResult(result, ProfileErrorCodes.EXECUTION_FAILED, `All ${failed} profiling requests failed`, {
+                metadata: { duration: Date.now() - startTime },
+            });
+    }
+    /**
+     * Executes profiling for multiple definitions matching type and filters.
+     *
+     * @param options - Profile operation options (type must be set)
+     * @returns ServiceResult containing ProfileResult
+     */
+    async executeBulk(options) {
+        const startTime = Date.now();
+        // Build query options from CLI flags
+        const queryOptions = {
+            type: options.type,
+            status: options.status,
+            category: options.category,
+            timeCategory: options.timeCategory,
+            segmentCategory: options.segmentCategory,
+            limit: options.limit,
+        };
+        this.logger?.log(`Querying definitions with type=${options.type ?? 'all'}, status=${options.status ?? 'any'}`);
+        options.onProgress?.('Finding eligible definitions...');
+        const queryResult = await this.definitionService.getDefinitions(queryOptions);
+        if (!queryResult.success) {
+            return createFailureResult(ProfileOperation.createEmptyResult('bulk'), ProfileErrorCodes.QUERY_FAILED, queryResult.message ?? 'Failed to query definitions', { metadata: { duration: Date.now() - startTime } });
+        }
+        let definitions = queryResult.data;
+        // Apply namespace filter client-side (not supported in SOQL query)
+        if (options.namespace !== undefined) {
+            const nsPrefix = options.namespace.endsWith('__') ? options.namespace : `${options.namespace}__`;
+            definitions = definitions.filter((def) => def.objectName.startsWith(nsPrefix));
+        }
+        if (definitions.length === 0) {
+            return createFailureResult(ProfileOperation.createEmptyResult('bulk'), ProfileErrorCodes.NO_DEFINITIONS_FOUND, 'No definitions found matching filters', { metadata: { duration: Date.now() - startTime } });
+        }
+        this.logger?.log(`Found ${String(definitions.length)} definitions, executing bulk profiling`);
+        options.onProgress?.(`Found ${String(definitions.length)} definitions. Starting bulk execution...`);
+        // Build bulk execution options (fire-and-forget: no polling)
+        const bulkOptions = {
+            parallel: options.parallel ?? 5,
+            skipEmpty: options.skipEmpty !== false,
+            waitForCompletion: false,
+        };
+        // Wire progress callback
+        const progressCallback = options.onProgress
+            ? (progress) => {
+                const pct = Math.round(((progress.index + 1) / progress.total) * 100);
+                options.onProgress(`[${String(pct)}%] ${progress.message ?? `Processing ${progress.current.key} (${progress.current.objectName})`}`);
+            }
+            : undefined;
+        const bulkResult = await this.executionService.executeBulk(definitions, bulkOptions, progressCallback);
+        if (!bulkResult.success) {
+            return createFailureResult(ProfileOperation.createEmptyResult('bulk'), ProfileErrorCodes.EXECUTION_FAILED, bulkResult.message ?? 'Bulk execution failed', { metadata: { duration: Date.now() - startTime } });
+        }
+        // Transform BulkExecutionResult to ProfileResult
+        const bulkData = bulkResult.data;
+        const executions = bulkData.definitions.map((def) => ({
+            definitionKey: def.definition.key,
+            definitionId: def.definition.id,
+            objectName: def.definition.objectName,
+            status: def.status === 'completed'
+                ? 'success'
+                : def.status === 'skipped'
+                    ? 'skipped'
+                    : 'failed',
+            requestId: def.requestId,
+            errorMessage: def.errorMessage,
+            errorCode: def.errorCode,
+            skipReason: def.skipReason,
+            resolution: def.resolution,
+            durationMs: def.durationMs,
+        }));
+        const profileResult = {
+            mode: 'bulk',
+            executions,
+            summary: {
+                total: bulkData.summary.total,
+                successful: bulkData.summary.successful,
+                failed: bulkData.summary.failed,
+                skipped: bulkData.summary.skipped,
+            },
+        };
+        const duration = Date.now() - startTime;
+        // Partial failure handling: success if any succeeded
+        if (profileResult.summary.successful > 0) {
+            return createSuccessResult(profileResult, {
+                message: `Completed ${String(profileResult.summary.successful)}/${String(profileResult.summary.total)} executions`,
+                warnings: profileResult.summary.failed > 0
+                    ? [`${String(profileResult.summary.failed)} definition(s) failed to execute`]
+                    : undefined,
+                metadata: { duration },
+            });
+        }
+        // All failed
+        return createFailureResult(profileResult, ProfileErrorCodes.EXECUTION_FAILED, 'All executions failed', {
+            metadata: { duration },
+        });
+    }
+}
+//# sourceMappingURL=ProfileOperation.js.map

package/lib/operations/ProfileOperation.js.map

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

package/lib/operations/ProfileRequestCancelOperation.d.ts

@@ -0,0 +1,59 @@
+import { type ServiceResult } from '../models/service-result.js';
+import { ProfileRequestService } from '../services/ProfileRequestService.js';
+import type { ProfileRequestCancelResult } from '../models/profile-request-types.js';
+/**
+ * Options for the profile request cancel operation.
+ */
+export type ProfileRequestCancelOperationOptions = {
+    /** Cancel all cancellable requests */
+    all?: boolean;
+    /** Cancel specific request IDs (mutually exclusive with `all`) */
+    requestIds?: string[];
+    /** Preview what would be cancelled without executing */
+    dryRun?: boolean;
+    /** Skip confirmation prompt */
+    noPrompt?: boolean;
+    /** Callback when cancellable requests are found */
+    onCancellableFound?: (count: number) => void;
+    /** Callback for user confirmation; return false to abort */
+    onConfirm?: (count: number) => Promise<boolean>;
+};
+/**
+ * Error codes for profile request cancel operations.
+ * Re-exported from ServiceErrorCodes (E4900-E4905) for convenience.
+ */
+export declare const ProfileRequestCancelErrorCodes: {
+    readonly CANCEL_FAILED: "E4902";
+    readonly INVALID_IDS: "E4903";
+    readonly NO_CANCELLABLE: "E4904";
+    readonly PARTIAL_FAILURE: "E4905";
+};
+/**
+ * Orchestrates cancellation of profiling requests.
+ *
+ * Delegates to ProfileRequestService for the actual cancel logic.
+ * Manages user-facing concerns: confirmation prompts, dry-run previews,
+ * and timing metadata.
+ *
+ * @example
+ * ```typescript
+ * const operation = new ProfileRequestCancelOperation(profileRequestService);
+ * const result = await operation.execute({ all: true, dryRun: true });
+ * ```
+ */
+export declare class ProfileRequestCancelOperation {
+    private readonly profileRequestService;
+    private readonly logger?;
+    constructor(profileRequestService: ProfileRequestService, logger?: Console | undefined);
+    /**
+     * Creates the empty cancel result structure.
+     */
+    private static emptyResult;
+    /**
+     * Executes the profile request cancel operation.
+     *
+     * @param options - Cancel operation options
+     * @returns ServiceResult containing the cancel outcome
+     */
+    execute(options: ProfileRequestCancelOperationOptions): Promise<ServiceResult<ProfileRequestCancelResult>>;
+}

package/lib/operations/ProfileRequestCancelOperation.js

@@ -0,0 +1,137 @@
+/*
+ * 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 { createSuccessResult, createFailureResult } from '../models/service-result.js';
+import { ServiceErrorCodes } from '../adapters/errors.js';
+/**
+ * Error codes for profile request cancel operations.
+ * Re-exported from ServiceErrorCodes (E4900-E4905) for convenience.
+ */
+export const ProfileRequestCancelErrorCodes = {
+    CANCEL_FAILED: ServiceErrorCodes.REQUEST_CANCEL_FAILED,
+    INVALID_IDS: ServiceErrorCodes.REQUEST_INVALID_IDS,
+    NO_CANCELLABLE: ServiceErrorCodes.REQUEST_NO_CANCELLABLE,
+    PARTIAL_FAILURE: ServiceErrorCodes.REQUEST_CANCEL_PARTIAL_FAILURE,
+};
+/**
+ * Orchestrates cancellation of profiling requests.
+ *
+ * Delegates to ProfileRequestService for the actual cancel logic.
+ * Manages user-facing concerns: confirmation prompts, dry-run previews,
+ * and timing metadata.
+ *
+ * @example
+ * ```typescript
+ * const operation = new ProfileRequestCancelOperation(profileRequestService);
+ * const result = await operation.execute({ all: true, dryRun: true });
+ * ```
+ */
+export class ProfileRequestCancelOperation {
+    profileRequestService;
+    logger;
+    constructor(profileRequestService, logger) {
+        this.profileRequestService = profileRequestService;
+        this.logger = logger;
+    }
+    /**
+     * Creates the empty cancel result structure.
+     */
+    static emptyResult(dryRun) {
+        return {
+            cancelled: [],
+            failed: [],
+            dryRun,
+            totalCancellable: 0,
+        };
+    }
+    /**
+     * Executes the profile request cancel operation.
+     *
+     * @param options - Cancel operation options
+     * @returns ServiceResult containing the cancel outcome
+     */
+    async execute(options) {
+        const startTime = Date.now();
+        const dryRun = options.dryRun ?? false;
+        const emptyResult = ProfileRequestCancelOperation.emptyResult(dryRun);
+        try {
+            this.logger?.log('Starting profile request cancel operation');
+            // Validate mutually exclusive options
+            const hasAll = options.all === true;
+            const hasIds = options.requestIds !== undefined && options.requestIds.length > 0;
+            if (hasAll && hasIds) {
+                return createFailureResult(emptyResult, ProfileRequestCancelErrorCodes.INVALID_IDS, 'The --all and --request-ids flags are mutually exclusive. Provide one or the other.', { metadata: { duration: Date.now() - startTime } });
+            }
+            if (!hasAll && !hasIds) {
+                return createFailureResult(emptyResult, ProfileRequestCancelErrorCodes.INVALID_IDS, 'You must provide either --all or --request-ids to specify which requests to cancel.', { metadata: { duration: Date.now() - startTime } });
+            }
+            const serviceOptions = {
+                all: options.all,
+                requestIds: options.requestIds,
+            };
+            const needsConfirmation = !dryRun && !options.noPrompt && !!options.onConfirm;
+            // Discovery: dry-run first when confirmation is needed, or honour explicit dryRun
+            const discoveryResult = await this.profileRequestService.cancelRequests({
+                ...serviceOptions,
+                dryRun: dryRun || needsConfirmation,
+            });
+            if (!discoveryResult.success) {
+                return createFailureResult(emptyResult, discoveryResult.errorCode ?? ProfileRequestCancelErrorCodes.CANCEL_FAILED, discoveryResult.message ?? 'Cancel operation failed', {
+                    metadata: { duration: Date.now() - startTime },
+                });
+            }
+            const discoveryData = discoveryResult.data;
+            // Notify caller about cancellable requests found
+            options.onCancellableFound?.(discoveryData.totalCancellable);
+            // Prompt user for confirmation before executing
+            if (needsConfirmation) {
+                const confirmed = await options.onConfirm(discoveryData.totalCancellable);
+                if (!confirmed) {
+                    this.logger?.log('Cancel operation aborted by user');
+                    return createSuccessResult({
+                        ...emptyResult,
+                        totalCancellable: discoveryData.totalCancellable,
+                    }, {
+                        message: 'Cancellation aborted by user.',
+                        metadata: { duration: Date.now() - startTime, userCancelled: true },
+                    });
+                }
+                // User confirmed — execute the actual cancellation
+                const executeResult = await this.profileRequestService.cancelRequests({
+                    ...serviceOptions,
+                    dryRun: false,
+                });
+                if (!executeResult.success) {
+                    return createFailureResult(emptyResult, executeResult.errorCode ?? ProfileRequestCancelErrorCodes.CANCEL_FAILED, executeResult.message ?? 'Cancel operation failed', {
+                        metadata: { duration: Date.now() - startTime },
+                    });
+                }
+                const duration = Date.now() - startTime;
+                this.logger?.log(`Cancel operation completed in ${duration}ms`);
+                return createSuccessResult(executeResult.data, {
+                    message: executeResult.message,
+                    metadata: { duration },
+                });
+            }
+            // No confirmation needed (dryRun or noPrompt) — return discovery result directly
+            const duration = Date.now() - startTime;
+            this.logger?.log(`Cancel operation completed in ${duration}ms`);
+            return createSuccessResult(discoveryData, {
+                message: discoveryResult.message,
+                metadata: { duration },
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger?.log(`Cancel operation failed: ${errorMessage}`);
+            return createFailureResult(emptyResult, ProfileRequestCancelErrorCodes.CANCEL_FAILED, errorMessage, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+    }
+}
+//# sourceMappingURL=ProfileRequestCancelOperation.js.map

package/lib/operations/ProfileRequestCancelOperation.js.map

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

package/lib/operations/ProfileRequestDeleteOperation.d.ts

@@ -0,0 +1,64 @@
+import { type ServiceResult } from '../models/service-result.js';
+import { ProfileRequestService } from '../services/ProfileRequestService.js';
+import type { ProfileRequestDeleteResult } from '../models/profile-request-types.js';
+/**
+ * Options for the profile request delete operation.
+ */
+export type ProfileRequestDeleteOperationOptions = {
+    /** Delete all deletable requests (canceled or rejected) */
+    all?: boolean;
+    /** Delete specific request IDs (mutually exclusive with `all`) */
+    requestIds?: string[];
+    /** Preview what would be deleted without executing */
+    dryRun?: boolean;
+    /** Skip confirmation prompt */
+    noPrompt?: boolean;
+    /** Callback when deletable requests are found */
+    onDeletableFound?: (count: number) => void;
+    /** Callback for user confirmation; return false to abort */
+    onConfirm?: (count: number) => Promise<boolean>;
+};
+/**
+ * Error codes for profile request delete operations.
+ * Re-exported from ServiceErrorCodes for convenience.
+ */
+export declare const ProfileRequestDeleteErrorCodes: {
+    readonly DELETE_FAILED: "E4906";
+    readonly INVALID_IDS: "E4903";
+    readonly NO_DELETABLE: "E4908";
+    readonly PARTIAL_FAILURE: "E4909";
+};
+/**
+ * Orchestrates deletion of profiling requests.
+ *
+ * Delegates to ProfileRequestService for the actual delete logic.
+ * Manages user-facing concerns: confirmation prompts, dry-run previews,
+ * and timing metadata.
+ *
+ * @example
+ * ```typescript
+ * const operation = new ProfileRequestDeleteOperation(profileRequestService);
+ * const result = await operation.execute({ all: true, dryRun: true });
+ * ```
+ */
+export declare class ProfileRequestDeleteOperation {
+    private readonly profileRequestService;
+    private readonly logger?;
+    constructor(profileRequestService: ProfileRequestService, logger?: Console | undefined);
+    /**
+     * Creates the empty delete result structure.
+     */
+    private static emptyResult;
+    /**
+     * Executes the profile request delete operation.
+     *
+     * @param options - Delete operation options
+     * @returns ServiceResult containing the delete outcome
+     */
+    execute(options: ProfileRequestDeleteOperationOptions): Promise<ServiceResult<ProfileRequestDeleteResult>>;
+    /**
+     * Prompts for confirmation then executes the actual deletion.
+     * Extracted to keep execute() within cyclomatic complexity limits.
+     */
+    private executeWithConfirmation;
+}