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

package/lib/operations/SummaryReprofileOperation.d.ts

@@ -0,0 +1,88 @@
+import { type ServiceResult } from '../models/service-result.js';
+import { ProfilingSummaryService, type PurgeSummaryRecord } from '../services/ProfilingSummaryService.js';
+import type { BulkSummaryResult } from '../models/summary-bulk-types.js';
+/**
+ * Options for the summary reprofile operation.
+ */
+export type SummaryReprofileOptions = {
+    /** Specific summary IDs to reprofile — exclusive mode */
+    ids?: string[];
+    /** Reprofile all eligible summaries */
+    all?: boolean;
+    /** Filter by object API names */
+    objects?: string[];
+    /** Preview mode — show what would be reprofiled without executing */
+    dryRun?: boolean;
+    /** Skip interactive confirmation prompt */
+    noPrompt?: boolean;
+    /** Callback when reprofilable summaries are found */
+    onSummariesFound?: (count: number) => void;
+    /** Callback for user confirmation before re-profiling */
+    onConfirm?: (count: number) => Promise<boolean>;
+};
+/**
+ * Result of a summary reprofile operation.
+ */
+export type SummaryReprofileResult = {
+    /** Number of summaries successfully submitted for re-profiling */
+    submitted: number;
+    /** Number of summaries that failed to submit */
+    failed: number;
+    /** Total number of summaries processed */
+    total: number;
+    /** Whether the operation was cancelled by the user */
+    cancelled?: boolean;
+    /** Whether dry-run mode was active */
+    dryRun?: boolean;
+    /** Preview data (summaries that would be reprofiled) */
+    preview?: PurgeSummaryRecord[];
+    /** Per-item results from the API */
+    apiResults?: BulkSummaryResult;
+};
+/**
+ * Error codes for summary reprofile operations.
+ * Re-exported from ServiceErrorCodes (E4530-E4537) for convenience.
+ */
+export declare const SummaryReprofileErrorCodes: {
+    readonly NO_SELECTION_CRITERIA: "E4530";
+    readonly MUTUALLY_EXCLUSIVE: "E4531";
+    readonly QUERY_FAILED: "E4532";
+    readonly NO_ELIGIBLE_SUMMARIES: "E4533";
+    readonly REPROFILE_FAILED: "E4534";
+    readonly USER_CANCELLED: "E4535";
+    readonly OPERATION_FAILED: "E4536";
+    readonly INVALID_IDS: "E4537";
+};
+/**
+ * Orchestrates re-profiling of failed or stopped profiling summaries.
+ *
+ * Supports three selection modes:
+ * 1. ID mode: Reprofile specific summaries by ID
+ * 2. All mode: Reprofile all eligible (failed/stopped) summaries
+ * 3. Object mode: Reprofile summaries for specific objects
+ *
+ * These modes are mutually exclusive.
+ * This is a fire-and-forget operation — no polling.
+ */
+export declare class SummaryReprofileOperation {
+    private readonly summaryService;
+    private readonly logger?;
+    constructor(summaryService: ProfilingSummaryService, logger?: Console | undefined);
+    /**
+     * Creates the empty result structure.
+     */
+    private static emptyResult;
+    /**
+     * Validates selection options and returns a failure result if invalid.
+     * Returns undefined when validation passes.
+     */
+    private static validateOptions;
+    /**
+     * Executes the summary reprofile operation.
+     */
+    execute(options: SummaryReprofileOptions): Promise<ServiceResult<SummaryReprofileResult>>;
+    /**
+     * Queries reprofilable summaries based on the selection mode.
+     */
+    private querySummaries;
+}

package/lib/operations/SummaryReprofileOperation.js

@@ -0,0 +1,174 @@
+/*
+ * 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';
+import { ServiceErrorCodes } from '../adapters/errors.js';
+/**
+ * Error codes for summary reprofile operations.
+ * Re-exported from ServiceErrorCodes (E4530-E4537) for convenience.
+ */
+export const SummaryReprofileErrorCodes = {
+    NO_SELECTION_CRITERIA: ServiceErrorCodes.SUMMARY_REPROFILE_NO_SELECTION,
+    MUTUALLY_EXCLUSIVE: ServiceErrorCodes.SUMMARY_REPROFILE_MUTUALLY_EXCLUSIVE,
+    QUERY_FAILED: ServiceErrorCodes.SUMMARY_REPROFILE_QUERY_FAILED,
+    NO_ELIGIBLE_SUMMARIES: ServiceErrorCodes.SUMMARY_REPROFILE_NO_ELIGIBLE,
+    REPROFILE_FAILED: ServiceErrorCodes.SUMMARY_REPROFILE_FAILED,
+    USER_CANCELLED: ServiceErrorCodes.SUMMARY_REPROFILE_USER_CANCELLED,
+    OPERATION_FAILED: ServiceErrorCodes.SUMMARY_REPROFILE_OPERATION_FAILED,
+    INVALID_IDS: ServiceErrorCodes.SUMMARY_REPROFILE_INVALID_IDS,
+};
+/**
+ * Orchestrates re-profiling of failed or stopped profiling summaries.
+ *
+ * Supports three selection modes:
+ * 1. ID mode: Reprofile specific summaries by ID
+ * 2. All mode: Reprofile all eligible (failed/stopped) summaries
+ * 3. Object mode: Reprofile summaries for specific objects
+ *
+ * These modes are mutually exclusive.
+ * This is a fire-and-forget operation — no polling.
+ */
+export class SummaryReprofileOperation {
+    summaryService;
+    logger;
+    constructor(summaryService, logger) {
+        this.summaryService = summaryService;
+        this.logger = logger;
+    }
+    /**
+     * Creates the empty result structure.
+     */
+    static emptyResult() {
+        return { submitted: 0, failed: 0, total: 0 };
+    }
+    /**
+     * Validates selection options and returns a failure result if invalid.
+     * Returns undefined when validation passes.
+     */
+    static validateOptions(options, emptyResult, startTime) {
+        const hasIds = options.ids !== undefined && options.ids.length > 0;
+        const hasAll = options.all === true;
+        const hasObjects = options.objects !== undefined && options.objects.length > 0;
+        const modeCount = [hasIds, hasAll, hasObjects].filter(Boolean).length;
+        if (modeCount > 1) {
+            return createFailureResult(emptyResult, SummaryReprofileErrorCodes.MUTUALLY_EXCLUSIVE, 'The flags --ids, --all, and --objects are mutually exclusive.', { metadata: { duration: Date.now() - startTime } });
+        }
+        if (modeCount === 0) {
+            return createFailureResult(emptyResult, SummaryReprofileErrorCodes.NO_SELECTION_CRITERIA, 'No selection criteria specified. Provide --ids, --all, or --objects.', { metadata: { duration: Date.now() - startTime } });
+        }
+        if (hasIds && options.ids) {
+            for (const id of options.ids) {
+                const idError = validateSalesforceId(id);
+                if (idError) {
+                    return createFailureResult(emptyResult, SummaryReprofileErrorCodes.INVALID_IDS, `Invalid summary ID: ${id} - ${idError}`, { metadata: { duration: Date.now() - startTime } });
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Executes the summary reprofile operation.
+     */
+    async execute(options) {
+        const startTime = Date.now();
+        const emptyResult = SummaryReprofileOperation.emptyResult();
+        try {
+            this.logger?.log('Starting summary reprofile operation');
+            // Validate options
+            const validationError = SummaryReprofileOperation.validateOptions(options, emptyResult, startTime);
+            if (validationError) {
+                return validationError;
+            }
+            // Query reprofilable summaries
+            const queryOutcome = await this.querySummaries(options, startTime);
+            if (!queryOutcome.success) {
+                return createFailureResult(emptyResult, queryOutcome.errorCode, queryOutcome.message, {
+                    metadata: queryOutcome.metadata,
+                });
+            }
+            const summaries = queryOutcome.data;
+            if (summaries.length === 0) {
+                return createFailureResult(emptyResult, SummaryReprofileErrorCodes.NO_ELIGIBLE_SUMMARIES, 'No failed or stopped summaries found matching the specified criteria.', { metadata: { duration: Date.now() - startTime } });
+            }
+            options.onSummariesFound?.(summaries.length);
+            // Dry-run mode
+            if (options.dryRun) {
+                return createSuccessResult({
+                    ...emptyResult,
+                    total: summaries.length,
+                    dryRun: true,
+                    preview: summaries,
+                }, {
+                    message: `Dry-run: ${summaries.length} summary(ies) would be re-profiled`,
+                    metadata: { duration: Date.now() - startTime },
+                });
+            }
+            // User confirmation
+            if (!options.noPrompt && options.onConfirm) {
+                const confirmed = await options.onConfirm(summaries.length);
+                if (!confirmed) {
+                    return createSuccessResult({
+                        ...emptyResult,
+                        total: summaries.length,
+                        cancelled: true,
+                    }, {
+                        message: 'Reprofile cancelled by user.',
+                        metadata: { duration: Date.now() - startTime },
+                    });
+                }
+            }
+            // Execute reprofile
+            const summaryIds = summaries.map((s) => s.id);
+            const reprofileResult = await this.summaryService.reprofileSummaries(summaryIds);
+            if (!reprofileResult.success) {
+                return createFailureResult(emptyResult, SummaryReprofileErrorCodes.REPROFILE_FAILED, reprofileResult.message ?? 'Reprofile operation failed', { metadata: { duration: Date.now() - startTime } });
+            }
+            const { summary } = reprofileResult.data;
+            const duration = Date.now() - startTime;
+            return createSuccessResult({
+                submitted: summary.succeeded,
+                failed: summary.failed,
+                total: summary.total,
+                apiResults: reprofileResult.data,
+            }, {
+                message: `Submitted ${summary.succeeded} of ${summary.total} summary(ies) for re-profiling`,
+                metadata: { duration },
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger?.log(`Summary reprofile operation failed: ${errorMessage}`);
+            return createFailureResult(emptyResult, SummaryReprofileErrorCodes.OPERATION_FAILED, errorMessage, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+    }
+    /**
+     * Queries reprofilable summaries based on the selection mode.
+     */
+    async querySummaries(options, startTime) {
+        const hasIds = options.ids !== undefined && options.ids.length > 0;
+        const hasObjects = options.objects !== undefined && options.objects.length > 0;
+        if (hasIds) {
+            const queryResult = await this.summaryService.getReprofilableSummaries();
+            if (!queryResult.success) {
+                return createFailureResult([], SummaryReprofileErrorCodes.QUERY_FAILED, queryResult.message ?? 'Query failed', { metadata: { duration: Date.now() - startTime } });
+            }
+            const idSet = new Set(options.ids);
+            return createSuccessResult(queryResult.data.filter((s) => idSet.has(s.id)));
+        }
+        const queryResult = await this.summaryService.getReprofilableSummaries({
+            objectNames: hasObjects ? options.objects : undefined,
+        });
+        if (!queryResult.success) {
+            return createFailureResult([], SummaryReprofileErrorCodes.QUERY_FAILED, queryResult.message ?? 'Query failed', { metadata: { duration: Date.now() - startTime } });
+        }
+        return createSuccessResult(queryResult.data);
+    }
+}
+//# sourceMappingURL=SummaryReprofileOperation.js.map

package/lib/operations/SummaryReprofileOperation.js.map

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

package/lib/operations/SummaryStopOperation.d.ts

@@ -0,0 +1,87 @@
+import { type ServiceResult } from '../models/service-result.js';
+import { ProfilingSummaryService, type PurgeSummaryRecord } from '../services/ProfilingSummaryService.js';
+import type { BulkSummaryResult } from '../models/summary-bulk-types.js';
+/**
+ * Options for the summary stop operation.
+ */
+export type SummaryStopOptions = {
+    /** Specific summary IDs to stop — exclusive mode */
+    ids?: string[];
+    /** Stop all in-progress summaries */
+    all?: boolean;
+    /** Filter by object API names */
+    objects?: string[];
+    /** Preview mode — show what would be stopped without executing */
+    dryRun?: boolean;
+    /** Skip interactive confirmation prompt */
+    noPrompt?: boolean;
+    /** Callback when in-progress summaries are found */
+    onSummariesFound?: (count: number) => void;
+    /** Callback for user confirmation before stopping */
+    onConfirm?: (count: number) => Promise<boolean>;
+};
+/**
+ * Result of a summary stop operation.
+ */
+export type SummaryStopResult = {
+    /** Number of summaries successfully stopped */
+    stopped: number;
+    /** Number of summaries that failed to stop */
+    failed: number;
+    /** Total number of summaries processed */
+    total: number;
+    /** Whether the operation was cancelled by the user */
+    cancelled?: boolean;
+    /** Whether dry-run mode was active */
+    dryRun?: boolean;
+    /** Preview data (summaries that would be stopped) */
+    preview?: PurgeSummaryRecord[];
+    /** Per-item results from the API */
+    apiResults?: BulkSummaryResult;
+};
+/**
+ * Error codes for summary stop operations.
+ * Re-exported from ServiceErrorCodes (E4520-E4527) for convenience.
+ */
+export declare const SummaryStopErrorCodes: {
+    readonly NO_SELECTION_CRITERIA: "E4520";
+    readonly MUTUALLY_EXCLUSIVE: "E4521";
+    readonly QUERY_FAILED: "E4522";
+    readonly NO_ELIGIBLE_SUMMARIES: "E4523";
+    readonly STOP_FAILED: "E4524";
+    readonly USER_CANCELLED: "E4525";
+    readonly OPERATION_FAILED: "E4526";
+    readonly INVALID_IDS: "E4527";
+};
+/**
+ * Orchestrates stopping of in-progress profiling summaries.
+ *
+ * Supports three selection modes:
+ * 1. ID mode: Stop specific summaries by ID
+ * 2. All mode: Stop all in-progress summaries
+ * 3. Object mode: Stop summaries for specific objects
+ *
+ * These modes are mutually exclusive.
+ */
+export declare class SummaryStopOperation {
+    private readonly summaryService;
+    private readonly logger?;
+    constructor(summaryService: ProfilingSummaryService, logger?: Console | undefined);
+    /**
+     * Creates the empty result structure.
+     */
+    private static emptyResult;
+    /**
+     * Validates selection options and returns a failure result if invalid.
+     * Returns undefined when validation passes.
+     */
+    private static validateOptions;
+    /**
+     * Executes the summary stop operation.
+     */
+    execute(options: SummaryStopOptions): Promise<ServiceResult<SummaryStopResult>>;
+    /**
+     * Queries in-progress summaries based on the selection mode.
+     */
+    private querySummaries;
+}

package/lib/operations/SummaryStopOperation.js

@@ -0,0 +1,175 @@
+/*
+ * 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';
+import { ServiceErrorCodes } from '../adapters/errors.js';
+/**
+ * Error codes for summary stop operations.
+ * Re-exported from ServiceErrorCodes (E4520-E4527) for convenience.
+ */
+export const SummaryStopErrorCodes = {
+    NO_SELECTION_CRITERIA: ServiceErrorCodes.SUMMARY_STOP_NO_SELECTION,
+    MUTUALLY_EXCLUSIVE: ServiceErrorCodes.SUMMARY_STOP_MUTUALLY_EXCLUSIVE,
+    QUERY_FAILED: ServiceErrorCodes.SUMMARY_STOP_QUERY_FAILED,
+    NO_ELIGIBLE_SUMMARIES: ServiceErrorCodes.SUMMARY_STOP_NO_ELIGIBLE,
+    STOP_FAILED: ServiceErrorCodes.SUMMARY_STOP_FAILED,
+    USER_CANCELLED: ServiceErrorCodes.SUMMARY_STOP_USER_CANCELLED,
+    OPERATION_FAILED: ServiceErrorCodes.SUMMARY_STOP_OPERATION_FAILED,
+    INVALID_IDS: ServiceErrorCodes.SUMMARY_STOP_INVALID_IDS,
+};
+/**
+ * Orchestrates stopping of in-progress profiling summaries.
+ *
+ * Supports three selection modes:
+ * 1. ID mode: Stop specific summaries by ID
+ * 2. All mode: Stop all in-progress summaries
+ * 3. Object mode: Stop summaries for specific objects
+ *
+ * These modes are mutually exclusive.
+ */
+export class SummaryStopOperation {
+    summaryService;
+    logger;
+    constructor(summaryService, logger) {
+        this.summaryService = summaryService;
+        this.logger = logger;
+    }
+    /**
+     * Creates the empty result structure.
+     */
+    static emptyResult() {
+        return { stopped: 0, failed: 0, total: 0 };
+    }
+    /**
+     * Validates selection options and returns a failure result if invalid.
+     * Returns undefined when validation passes.
+     */
+    static validateOptions(options, emptyResult, startTime) {
+        const hasIds = options.ids !== undefined && options.ids.length > 0;
+        const hasAll = options.all === true;
+        const hasObjects = options.objects !== undefined && options.objects.length > 0;
+        const modeCount = [hasIds, hasAll, hasObjects].filter(Boolean).length;
+        if (modeCount > 1) {
+            return createFailureResult(emptyResult, SummaryStopErrorCodes.MUTUALLY_EXCLUSIVE, 'The flags --ids, --all, and --objects are mutually exclusive.', { metadata: { duration: Date.now() - startTime } });
+        }
+        if (modeCount === 0) {
+            return createFailureResult(emptyResult, SummaryStopErrorCodes.NO_SELECTION_CRITERIA, 'No selection criteria specified. Provide --ids, --all, or --objects.', { metadata: { duration: Date.now() - startTime } });
+        }
+        if (hasIds && options.ids) {
+            for (const id of options.ids) {
+                const idError = validateSalesforceId(id);
+                if (idError) {
+                    return createFailureResult(emptyResult, SummaryStopErrorCodes.INVALID_IDS, `Invalid summary ID: ${id} - ${idError}`, {
+                        metadata: { duration: Date.now() - startTime },
+                    });
+                }
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Executes the summary stop operation.
+     */
+    async execute(options) {
+        const startTime = Date.now();
+        const emptyResult = SummaryStopOperation.emptyResult();
+        try {
+            this.logger?.log('Starting summary stop operation');
+            // Validate options
+            const validationError = SummaryStopOperation.validateOptions(options, emptyResult, startTime);
+            if (validationError) {
+                return validationError;
+            }
+            // Query in-progress summaries
+            const queryOutcome = await this.querySummaries(options, startTime);
+            if (!queryOutcome.success) {
+                return createFailureResult(emptyResult, queryOutcome.errorCode, queryOutcome.message, {
+                    metadata: queryOutcome.metadata,
+                });
+            }
+            const summaries = queryOutcome.data;
+            if (summaries.length === 0) {
+                return createFailureResult(emptyResult, SummaryStopErrorCodes.NO_ELIGIBLE_SUMMARIES, 'No in-progress summaries found matching the specified criteria.', { metadata: { duration: Date.now() - startTime } });
+            }
+            options.onSummariesFound?.(summaries.length);
+            // Dry-run mode
+            if (options.dryRun) {
+                return createSuccessResult({
+                    ...emptyResult,
+                    total: summaries.length,
+                    dryRun: true,
+                    preview: summaries,
+                }, {
+                    message: `Dry-run: ${summaries.length} summary(ies) would be stopped`,
+                    metadata: { duration: Date.now() - startTime },
+                });
+            }
+            // User confirmation
+            if (!options.noPrompt && options.onConfirm) {
+                const confirmed = await options.onConfirm(summaries.length);
+                if (!confirmed) {
+                    return createSuccessResult({
+                        ...emptyResult,
+                        total: summaries.length,
+                        cancelled: true,
+                    }, {
+                        message: 'Stop cancelled by user.',
+                        metadata: { duration: Date.now() - startTime },
+                    });
+                }
+            }
+            // Execute stop
+            const summaryIds = summaries.map((s) => s.id);
+            const stopResult = await this.summaryService.stopSummaries(summaryIds);
+            if (!stopResult.success) {
+                return createFailureResult(emptyResult, SummaryStopErrorCodes.STOP_FAILED, stopResult.message ?? 'Stop operation failed', { metadata: { duration: Date.now() - startTime } });
+            }
+            const { summary } = stopResult.data;
+            const duration = Date.now() - startTime;
+            return createSuccessResult({
+                stopped: summary.succeeded,
+                failed: summary.failed,
+                total: summary.total,
+                apiResults: stopResult.data,
+            }, {
+                message: `Stopped ${summary.succeeded} of ${summary.total} summary(ies)`,
+                metadata: { duration },
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger?.log(`Summary stop operation failed: ${errorMessage}`);
+            return createFailureResult(emptyResult, SummaryStopErrorCodes.OPERATION_FAILED, errorMessage, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+    }
+    /**
+     * Queries in-progress summaries based on the selection mode.
+     */
+    async querySummaries(options, startTime) {
+        const hasIds = options.ids !== undefined && options.ids.length > 0;
+        const hasObjects = options.objects !== undefined && options.objects.length > 0;
+        if (hasIds) {
+            const queryResult = await this.summaryService.getInProgressSummaries();
+            if (!queryResult.success) {
+                return createFailureResult([], SummaryStopErrorCodes.QUERY_FAILED, queryResult.message ?? 'Query failed', { metadata: { duration: Date.now() - startTime } });
+            }
+            const idSet = new Set(options.ids);
+            return createSuccessResult(queryResult.data.filter((s) => idSet.has(s.id)));
+        }
+        const queryResult = await this.summaryService.getInProgressSummaries({
+            objectNames: hasObjects ? options.objects : undefined,
+        });
+        if (!queryResult.success) {
+            return createFailureResult([], SummaryStopErrorCodes.QUERY_FAILED, queryResult.message ?? 'Query failed', { metadata: { duration: Date.now() - startTime } });
+        }
+        return createSuccessResult(queryResult.data);
+    }
+}
+//# sourceMappingURL=SummaryStopOperation.js.map

package/lib/operations/SummaryStopOperation.js.map

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

package/lib/services/BulkExecutionService.d.ts

@@ -0,0 +1,120 @@
+import type { ServiceResult } from '../models/service-result.js';
+import type { ISoqlQueryAdapter } from '../adapters/soql/soql-query-adapter.js';
+import type { BulkExecutionOptions, BulkExecutionResult, ProgressCallback, IProfilingExecutor } from '../models/profiling-execution-types.js';
+import type { ProfilingDefinition } from './ProfilingDefinitionService.js';
+import type { PollingService } from './PollingService.js';
+export type { BulkExecutionOptions, BulkExecutionResult, BulkExecutionSummary, DefinitionExecutionResult, BulkProgressUpdate, ProgressCallback, SkipReason, IProfilingExecutor, } from '../models/profiling-execution-types.js';
+/**
+ * Configuration for BulkExecutionService constructor.
+ */
+export type IBulkExecutionServiceConfig = {
+    /** SOQL adapter for record count queries (skip-empty logic) */
+    soqlAdapter: ISoqlQueryAdapter;
+    /** PollingService for waiting on individual request completion */
+    pollingService: PollingService;
+    /** Optional logger for debug output */
+    logger?: Console;
+};
+/**
+ * Service for bulk execution of profiling definitions with controlled concurrency.
+ *
+ * Orchestrates parallel execution of multiple profiling definitions using a
+ * semaphore-based concurrency model. Receives an `IProfilingExecutor`
+ * callback object to decouple bulk orchestration from single-execution mechanics.
+ *
+ * Responsibilities:
+ * - Semaphore-based concurrency control (1-10 parallel threads)
+ * - Skip-empty logic (check record count before profiling)
+ * - Progress reporting via callbacks
+ * - Error resolution mapping for user-friendly guidance
+ * - Aggregate result summary (successful, failed, skipped)
+ *
+ * @example
+ * ```typescript
+ * const bulkService = new BulkExecutionService({
+ *   soqlAdapter,
+ *   pollingService,
+ * });
+ *
+ * const executor = {
+ *   execute: (defId: string) => executionService.execute(defId),
+ *   getStatus: (reqId: string) => executionService.getStatus(reqId),
+ * };
+ *
+ * const result = await bulkService.executeBulk(
+ *   definitions,
+ *   executor,
+ *   { parallel: 5, skipEmpty: true },
+ *   (update) => console.log(`${update.index + 1}/${update.total}: ${update.message}`)
+ * );
+ * ```
+ */
+export declare class BulkExecutionService {
+    private readonly soqlAdapter;
+    private readonly pollingService;
+    private readonly logger?;
+    constructor(config: IBulkExecutionServiceConfig);
+    /**
+     * Maps an error message to user-friendly resolution guidance.
+     *
+     * Searches through known error patterns and returns appropriate resolution
+     * guidance. If no pattern matches, returns undefined.
+     *
+     * @param errorMessage - The error message to analyze
+     * @returns User-friendly resolution guidance or undefined
+     */
+    private static getErrorResolution;
+    /**
+     * Reports progress update via callback.
+     *
+     * @param onProgress - Optional progress callback
+     * @param definition - Current definition
+     * @param status - Current status
+     * @param index - Index in batch
+     * @param total - Total count
+     * @param summary - Running summary
+     * @param message - Optional message
+     */
+    private static reportProgress;
+    /**
+     * Executes profiling for multiple definitions in parallel with controlled concurrency.
+     *
+     * Implements semaphore-based concurrency control, progress callbacks, skip-empty
+     * logic, and error resolution mapping. Returns an aggregated summary of results.
+     *
+     * @param definitions - Array of profiling definitions to execute
+     * @param executor - Executor interface for triggering and monitoring profiling
+     * @param options - Bulk execution options (parallel, skipEmpty, pollInterval)
+     * @param onProgress - Optional callback for progress updates
+     * @returns ServiceResult containing BulkExecutionResult with summary and per-definition results
+     */
+    executeBulk(definitions: ProfilingDefinition[], executor: IProfilingExecutor, options?: BulkExecutionOptions, onProgress?: ProgressCallback): Promise<ServiceResult<BulkExecutionResult>>;
+    /**
+     * Checks the record count for an object.
+     *
+     * Used by skip-empty logic to determine if an object has records to profile.
+     *
+     * @param objectName - The Salesforce object API name
+     * @returns Typed result distinguishing success, validation failure, and query failure
+     */
+    private getRecordCount;
+    /**
+     * Checks if a definition should be skipped due to empty records.
+     *
+     * @param definition - The profiling definition to check
+     * @returns Skip info if should be skipped, null otherwise
+     */
+    private checkSkipEmpty;
+    /**
+     * Processes a single definition within bulk execution.
+     *
+     * Acquires a semaphore permit, executes the definition, waits for completion,
+     * and releases the permit. Updates summary counts and calls progress callback.
+     *
+     * @param item - The definition and its position in the batch
+     * @param ctx - Shared batch execution state (options, semaphore, counters)
+     * @param callbacks - Caller-provided execution and status functions
+     * @returns The execution result for this definition
+     */
+    private processDefinition;
+}