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

package/lib/services/ProfilingSummaryService.js

@@ -0,0 +1,685 @@
+/*
+ * 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 { CuneiformQueryBuilder } from '../adapters/soql/cuneiform-query-builder.js';
+import { createSuccessResult, createFailureResult } from '../models/service-result.js';
+import { IN_PROGRESS_SUMMARY_STATUSES, REPROFILABLE_SUMMARY_STATUSES } from '../models/summary-bulk-types.js';
+import { ServiceErrorCodes } from '../adapters/errors.js';
+import { validateSalesforceId, validatePagination, validateNonEmptyArray } from './validation.js';
+import { DEFAULT_PAGINATION_LIMIT, MAX_PAGINATION_LIMIT, PROFILING_REST_BASE } from './constants.js';
+/**
+ * SOQL field list for Profiling_SObject_Results__c queries (summary-level aggregates).
+ * Used for both list/get queries and purge/stop/reprofile workflows.
+ * Includes parent definition relationship query for the definition key.
+ */
+const PURGE_SUMMARY_FIELDS = [
+    'Id',
+    'Name',
+    'pnova__ProfilingDef__c',
+    'pnova__ProfilingDef__r.Name',
+    'pnova__PDef_SObjectApiName__c',
+    'pnova__PFx_TotalRecords_Profiled__c',
+    'pnova__AggFields_Profiled__c',
+    'pnova__Prf_LastDate__c',
+    'pnova__Prf_IsLatest__c',
+    'pnova__Agg_OverallStatus__c',
+];
+/**
+ * Terminal overall statuses for `pnova__Agg_OverallStatus__c` — used by purge SOQL filters.
+ *
+ * The ISV populates this field from Custom Labels with exactly 3 values:
+ * IN PROGRESS, COMPLETED, FAILED. Terminal = profiling work is done.
+ *
+ * NOTE: This is NOT the same as PFx_Status__c (which has SUCCESS, CANCELED, etc.).
+ * See docs/knowledge/cuneiform/profiling-request-status-reference.md Section 2.4.
+ */
+export const TERMINAL_SUMMARY_STATUSES = ['COMPLETED', 'FAILED'];
+/**
+ * SOQL field list for summary list queries (getSummaries / getSummaryById).
+ * Independent of PURGE_SUMMARY_FIELDS — changes here do not affect purge workflows.
+ */
+const SUMMARY_LIST_FIELDS = [
+    'Id',
+    'Name',
+    'pnova__ProfilingDef__c',
+    'pnova__ProfilingDef__r.Name',
+    'pnova__PDef_SObjectApiName__c',
+    'pnova__PFx_TotalRecords_Profiled__c',
+    'pnova__AggFields_Profiled__c',
+    'CreatedDate',
+    'pnova__Prf_IsLatest__c',
+    'pnova__Agg_OverallStatus__c',
+];
+/**
+ * Domain service for querying Profiling_SObject_Results__c records.
+ *
+ * Provides methods to retrieve profiling summary data by definition ID
+ * or by individual summary ID, with support for pagination.
+ *
+ * @example
+ * ```typescript
+ * const service = new ProfilingSummaryService({ soqlAdapter });
+ * const result = await service.getSummaries({ definitionId: '001000000000001AAA' });
+ * if (result.success) {
+ *   result.data.forEach(s => console.log(`${s.fieldName}: ${s.populatedPercent}%`));
+ * }
+ * ```
+ */
+export class ProfilingSummaryService {
+    soqlAdapter;
+    restAdapter;
+    logger;
+    constructor(config) {
+        this.soqlAdapter = config.soqlAdapter;
+        this.restAdapter = config.restAdapter;
+        this.logger = config.logger;
+    }
+    /**
+     * Maps a raw Salesforce list query record to a SummaryRecord.
+     */
+    static mapToSummaryRecord(record) {
+        return {
+            id: record.Id,
+            summaryKey: record.Name,
+            definitionId: record.pnova__ProfilingDef__c,
+            definitionKey: record.pnova__ProfilingDef__r?.Name ?? '',
+            objectName: record.pnova__PDef_SObjectApiName__c ?? '',
+            totalRecordsProfiled: record.pnova__PFx_TotalRecords_Profiled__c ?? 0,
+            profiledFields: record.pnova__AggFields_Profiled__c ?? 0,
+            createdDate: record.CreatedDate,
+            isLatest: record.pnova__Prf_IsLatest__c ?? false,
+            overallStatus: record.pnova__Agg_OverallStatus__c ?? '',
+        };
+    }
+    /**
+     * Maps a raw Salesforce purge query record to a PurgeSummaryRecord.
+     */
+    static mapToPurgeSummaryRecord(record) {
+        return {
+            id: record.Id,
+            summaryKey: record.Name,
+            definitionId: record.pnova__ProfilingDef__c,
+            definitionKey: record.pnova__ProfilingDef__r?.Name ?? '',
+            objectName: record.pnova__PDef_SObjectApiName__c ?? '',
+            totalRecordsProfiled: record.pnova__PFx_TotalRecords_Profiled__c ?? 0,
+            profiledFields: record.pnova__AggFields_Profiled__c ?? 0,
+            lastProfiledDate: record.pnova__Prf_LastDate__c ?? null,
+            isLatest: record.pnova__Prf_IsLatest__c ?? false,
+            overallStatus: record.pnova__Agg_OverallStatus__c ?? '',
+        };
+    }
+    /**
+     * Parses the bulk API response into a typed BulkSummaryResult.
+     *
+     * Shared by stopSummaries and reprofileSummaries to reduce duplication.
+     *
+     * @param response - The raw API response
+     * @param failureCode - The error code to use on complete failure
+     * @param startTime - Operation start time for duration calculation
+     * @returns ServiceResult with parsed BulkSummaryResult
+     */
+    static parseBulkResponse(response, failureCode, startTime) {
+        const emptyResult = { results: [], summary: { total: 0, succeeded: 0, failed: 0 } };
+        // Handle top-level API error
+        if (!response.success && response.errors) {
+            const errorMsg = response.errors.join('; ');
+            return createFailureResult(emptyResult, failureCode, errorMsg, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        // Handle null results
+        if (!response.results) {
+            return createFailureResult(emptyResult, failureCode, 'API returned no results', {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        // Map API results to typed items
+        const results = response.results.map((item) => ({
+            id: item.id,
+            success: item.success,
+            errorCode: item.errorCode,
+            message: item.message,
+            requestId: item.requestId,
+        }));
+        const succeeded = results.filter((r) => r.success).length;
+        const failed = results.length - succeeded;
+        const duration = Date.now() - startTime;
+        const bulkResult = {
+            results,
+            summary: { total: results.length, succeeded, failed },
+        };
+        // All failed -> failure result
+        if (succeeded === 0 && results.length > 0) {
+            return createFailureResult(bulkResult, failureCode, 'All operations failed', {
+                metadata: { duration },
+            });
+        }
+        // Partial or full success
+        const warnings = failed > 0 ? [`${failed} item(s) could not be processed`] : undefined;
+        return createSuccessResult(bulkResult, {
+            message: `Processed ${succeeded}/${results.length} item(s)`,
+            warnings,
+            metadata: { duration },
+        });
+    }
+    /**
+     * Retrieves profiling summaries for a given definition ID.
+     *
+     * @param options - Query options including definitionId, limit, and offset
+     * @returns ServiceResult containing an array of SummaryRecord
+     */
+    async getSummaries(options) {
+        const startTime = Date.now();
+        const emptyResult = [];
+        // Validate definition ID
+        const idError = validateSalesforceId(options.definitionId);
+        if (idError) {
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_INVALID_DEFINITION_ID, idError, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        // Validate pagination
+        const paginationError = validatePagination(options.limit, options.offset, MAX_PAGINATION_LIMIT);
+        if (paginationError) {
+            return createFailureResult(emptyResult, ServiceErrorCodes.INVALID_PAGINATION, paginationError, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        const limit = options.limit ?? DEFAULT_PAGINATION_LIMIT;
+        const offset = options.offset ?? 0;
+        try {
+            // Most recent first — latest summary is most relevant to the caller
+            const soql = new CuneiformQueryBuilder()
+                .select(SUMMARY_LIST_FIELDS)
+                .from('pnova__Profiling_SObject_Results__c')
+                .where('pnova__ProfilingDef__c', '=', options.definitionId)
+                .orderBy('CreatedDate', 'DESC')
+                .limit(limit)
+                .offset(offset)
+                .toSOQL();
+            this.logger?.log(`Querying profiling summaries for definition: ${options.definitionId}`);
+            const queryResult = await this.soqlAdapter.query(soql);
+            if (!queryResult.success) {
+                return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_QUERY_FAILED, queryResult.message ?? 'Summary query failed', { metadata: { duration: Date.now() - startTime } });
+            }
+            const summaries = queryResult.data.records.map((record) => ProfilingSummaryService.mapToSummaryRecord(record));
+            const duration = Date.now() - startTime;
+            this.logger?.log(`Found ${summaries.length} profiling summaries for definition ${options.definitionId}`);
+            return createSuccessResult(summaries, {
+                message: `Found ${summaries.length} profiling summaries`,
+                metadata: { duration },
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger?.log(`Summary query failed: ${errorMessage}`);
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_QUERY_FAILED, errorMessage, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+    }
+    /**
+     * Retrieves a single profiling summary by its ID.
+     *
+     * @param id - The Salesforce ID of the Profiling_SObject_Results__c record
+     * @returns ServiceResult containing the SummaryRecord or null if not found
+     */
+    async getSummaryById(id) {
+        const startTime = Date.now();
+        const emptyResult = null;
+        // Validate summary ID format (not definition ID - this is the summary's own record ID)
+        const idError = validateSalesforceId(id);
+        if (idError) {
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_INVALID_ID, idError, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        try {
+            const soql = new CuneiformQueryBuilder()
+                .select(SUMMARY_LIST_FIELDS)
+                .from('pnova__Profiling_SObject_Results__c')
+                .where('Id', '=', id)
+                .toSOQL();
+            this.logger?.log(`Querying profiling summary by ID: ${id}`);
+            const queryResult = await this.soqlAdapter.query(soql);
+            if (!queryResult.success) {
+                return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_QUERY_FAILED, queryResult.message ?? 'Summary query failed', { metadata: { duration: Date.now() - startTime } });
+            }
+            const duration = Date.now() - startTime;
+            if (queryResult.data.records.length === 0) {
+                this.logger?.log(`Profiling summary not found: ${id}`);
+                return createSuccessResult(emptyResult, {
+                    message: `Profiling summary not found: ${id}`,
+                    metadata: { duration },
+                });
+            }
+            const summary = ProfilingSummaryService.mapToSummaryRecord(queryResult.data.records[0]);
+            this.logger?.log(`Found profiling summary: ${id}`);
+            return createSuccessResult(summary, {
+                message: `Found profiling summary: ${id}`,
+                metadata: { duration },
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger?.log(`Summary query failed: ${errorMessage}`);
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_QUERY_FAILED, errorMessage, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+    }
+    /**
+     * Retrieves profiling summaries eligible for purge, filtered by parent definition IDs.
+     *
+     * Queries summary-level aggregate fields for display in the purge confirmation table.
+     * Only returns summaries with terminal profiling statuses (COMPLETED, FAILED).
+     * When pruneOnly is true, additionally filters to non-latest summaries only.
+     *
+     * @param options - Query options including definitionIds and optional pruneOnly flag
+     * @returns ServiceResult containing an array of PurgeSummaryRecord
+     */
+    async getSummariesForPurge(options) {
+        const startTime = Date.now();
+        const emptyResult = [];
+        // Validate definition IDs
+        const idsError = validateNonEmptyArray(options.definitionIds, 'definitionIds', 200);
+        if (idsError) {
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_INVALID_IDS, idsError, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        for (const id of options.definitionIds) {
+            const idError = validateSalesforceId(id);
+            if (idError) {
+                return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_INVALID_DEFINITION_ID, idError, {
+                    metadata: { duration: Date.now() - startTime },
+                });
+            }
+        }
+        try {
+            const builder = new CuneiformQueryBuilder()
+                .select(PURGE_SUMMARY_FIELDS)
+                .from('pnova__Profiling_SObject_Results__c')
+                .andWhereIn('pnova__ProfilingDef__c', options.definitionIds)
+                .andWhereIn('pnova__Agg_OverallStatus__c', [...TERMINAL_SUMMARY_STATUSES]);
+            if (options.pruneOnly) {
+                builder.andWhere('pnova__Prf_IsLatest__c', '=', false);
+            }
+            builder.orderBy('pnova__ProfilingDef__r.Name', 'ASC');
+            const soql = builder.toSOQL();
+            this.logger?.log(`Querying summaries for purge: ${soql}`);
+            const queryResult = await this.soqlAdapter.query(soql);
+            if (!queryResult.success) {
+                return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_QUERY_FAILED, queryResult.message ?? 'Summary purge query failed', { metadata: { duration: Date.now() - startTime } });
+            }
+            const summaries = queryResult.data.records.map((record) => ProfilingSummaryService.mapToPurgeSummaryRecord(record));
+            const duration = Date.now() - startTime;
+            this.logger?.log(`Found ${summaries.length} summaries for purge`);
+            return createSuccessResult(summaries, {
+                message: `Found ${summaries.length} summaries for purge`,
+                metadata: { duration },
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger?.log(`Summary purge query failed: ${errorMessage}`);
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_QUERY_FAILED, errorMessage, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+    }
+    /**
+     * Retrieves specific profiling summaries by their IDs.
+     *
+     * Queries summaries directly by ID with terminal status filter.
+     * More efficient than getSummariesForPurge when specific IDs are known,
+     * as it avoids fetching all definitions first.
+     *
+     * @param ids - Array of Salesforce summary record IDs
+     * @returns ServiceResult containing matching PurgeSummaryRecord array
+     */
+    async getSummariesByIds(ids) {
+        const startTime = Date.now();
+        const emptyResult = [];
+        const idsError = validateNonEmptyArray(ids, 'ids', 200);
+        if (idsError) {
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_INVALID_IDS, idsError, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        for (const id of ids) {
+            const idError = validateSalesforceId(id);
+            if (idError) {
+                return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_INVALID_ID, idError, {
+                    metadata: { duration: Date.now() - startTime },
+                });
+            }
+        }
+        try {
+            const soql = new CuneiformQueryBuilder()
+                .select(PURGE_SUMMARY_FIELDS)
+                .from('pnova__Profiling_SObject_Results__c')
+                .andWhereIn('Id', ids)
+                .andWhereIn('pnova__Agg_OverallStatus__c', [...TERMINAL_SUMMARY_STATUSES])
+                .orderBy('pnova__ProfilingDef__r.Name', 'ASC')
+                .toSOQL();
+            this.logger?.log(`Querying summaries by IDs: ${ids.join(', ')}`);
+            const queryResult = await this.soqlAdapter.query(soql);
+            if (!queryResult.success) {
+                return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_QUERY_FAILED, queryResult.message ?? 'Summary query by IDs failed', { metadata: { duration: Date.now() - startTime } });
+            }
+            const summaries = queryResult.data.records.map((record) => ProfilingSummaryService.mapToPurgeSummaryRecord(record));
+            return createSuccessResult(summaries, {
+                message: `Found ${summaries.length} of ${ids.length} requested summaries`,
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_QUERY_FAILED, errorMessage, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+    }
+    /**
+     * Deletes a single profiling summary record.
+     *
+     * Requires the restAdapter to be configured.
+     *
+     * @param id - The Salesforce ID of the summary to delete
+     * @returns ServiceResult containing the delete result
+     */
+    async deleteSummary(id) {
+        const startTime = Date.now();
+        const emptyResult = { id, success: false };
+        if (!this.restAdapter) {
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_DELETE_FAILED, 'REST adapter not configured for delete operations', { metadata: { duration: Date.now() - startTime } });
+        }
+        const idError = validateSalesforceId(id);
+        if (idError) {
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_INVALID_ID, idError, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        try {
+            this.logger?.log(`Deleting profiling summary: ${id}`);
+            const result = await this.restAdapter.deleteRecord('pnova__Profiling_SObject_Results__c', id);
+            if (!result.success) {
+                return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_DELETE_FAILED, result.message ?? `Failed to delete summary: ${id}`, { metadata: { duration: Date.now() - startTime } });
+            }
+            return createSuccessResult(result.data, {
+                message: `Deleted profiling summary: ${id}`,
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger?.log(`Summary delete failed: ${errorMessage}`);
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_DELETE_FAILED, errorMessage, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+    }
+    /**
+     * Deletes multiple profiling summaries sequentially.
+     *
+     * Processes one summary at a time for reliability and progress tracking.
+     * Continues on individual failures, reporting results per summary.
+     *
+     * @param summaries - The summary records to delete
+     * @param onProgress - Optional progress callback
+     * @returns ServiceResult containing deletion statistics
+     */
+    async deleteSummaries(summaries, onProgress) {
+        const startTime = Date.now();
+        const result = {
+            deleted: 0,
+            skipped: 0,
+            failed: 0,
+            skipReasons: [],
+            failures: [],
+        };
+        // Sequential deletion is intentional — one-at-a-time to respect Salesforce API limits
+        // eslint-disable-next-line no-await-in-loop
+        for (let i = 0; i < summaries.length; i++) {
+            const summary = summaries[i];
+            const deleteResult = await this.deleteSummary(summary.id); // eslint-disable-line no-await-in-loop
+            if (deleteResult.success) {
+                result.deleted++;
+                onProgress?.({
+                    id: summary.id,
+                    summaryKey: summary.summaryKey,
+                    definitionKey: summary.definitionKey,
+                    objectName: summary.objectName,
+                    status: 'deleted',
+                    current: i + 1,
+                    total: summaries.length,
+                });
+            }
+            else {
+                result.failed++;
+                result.failures.push({
+                    id: summary.id,
+                    summaryKey: summary.summaryKey,
+                    error: deleteResult.message ?? 'Unknown error',
+                });
+                onProgress?.({
+                    id: summary.id,
+                    summaryKey: summary.summaryKey,
+                    definitionKey: summary.definitionKey,
+                    objectName: summary.objectName,
+                    status: 'failed',
+                    reason: deleteResult.message,
+                    current: i + 1,
+                    total: summaries.length,
+                });
+            }
+        }
+        // Return failure when all deletions failed
+        if (result.deleted === 0 && result.failed > 0) {
+            return createFailureResult(result, ServiceErrorCodes.SUMMARY_DELETE_FAILED, `All ${result.failed} deletion(s) failed`, { metadata: { duration: Date.now() - startTime } });
+        }
+        return createSuccessResult(result, {
+            message: `Deleted ${result.deleted} summaries, ${result.failed} failed`,
+            metadata: { duration: Date.now() - startTime },
+        });
+    }
+    /**
+     * Queries which Salesforce objects have successful metadata profiling results.
+     *
+     * Returns unique object API names from Profiling_SObject_Results__c where
+     * metadata-only profiling has been completed with records profiled.
+     *
+     * @returns ServiceResult containing an array of unique object API names
+     */
+    async queryProfiledObjects() {
+        const startTime = Date.now();
+        const emptyResult = [];
+        try {
+            const soql = new CuneiformQueryBuilder()
+                .select(['pnova__PDef_SObjectApiName__c'])
+                .from('pnova__Profiling_SObject_Results__c')
+                .where('pnova__Prop_IsMetadataProfilingOnly__c', '=', true)
+                .andWhere('pnova__PFx_TotalRecords_Profiled__c', '>', 0)
+                .groupBy(['pnova__PDef_SObjectApiName__c'])
+                .toSOQL();
+            this.logger?.log('Querying profiled objects from Profiling_SObject_Results__c');
+            const queryResult = await this.soqlAdapter.query(soql);
+            if (!queryResult.success) {
+                return createFailureResult(emptyResult, ServiceErrorCodes.PROFILED_OBJECTS_QUERY_FAILED, queryResult.message ?? 'Profiled objects query failed', { metadata: { duration: Date.now() - startTime } });
+            }
+            const objectNames = queryResult.data.records.map((record) => record.pnova__PDef_SObjectApiName__c);
+            const duration = Date.now() - startTime;
+            this.logger?.log(`Found ${objectNames.length} profiled objects`);
+            return createSuccessResult(objectNames, {
+                message: `Found ${objectNames.length} profiled objects`,
+                metadata: { duration },
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger?.log(`Profiled objects query failed: ${errorMessage}`);
+            return createFailureResult(emptyResult, ServiceErrorCodes.PROFILED_OBJECTS_QUERY_FAILED, errorMessage, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+    }
+    /**
+     * Retrieves in-progress profiling summaries eligible for stopping.
+     *
+     * Queries summaries with IN_PROGRESS_SUMMARY_STATUSES (IN PROGRESS).
+     * Optionally filters by object name.
+     *
+     * @param options - Optional filter by object names
+     * @returns ServiceResult containing matching PurgeSummaryRecord array
+     */
+    async getInProgressSummaries(options) {
+        const startTime = Date.now();
+        const emptyResult = [];
+        try {
+            const builder = new CuneiformQueryBuilder()
+                .select(PURGE_SUMMARY_FIELDS)
+                .from('pnova__Profiling_SObject_Results__c')
+                .andWhereIn('pnova__Agg_OverallStatus__c', [...IN_PROGRESS_SUMMARY_STATUSES]);
+            if (options?.objectNames && options.objectNames.length > 0) {
+                builder.andWhereIn('pnova__PDef_SObjectApiName__c', options.objectNames);
+            }
+            builder.orderBy('pnova__ProfilingDef__r.Name', 'ASC');
+            const soql = builder.toSOQL();
+            this.logger?.log(`Querying in-progress summaries: ${soql}`);
+            const queryResult = await this.soqlAdapter.query(soql);
+            if (!queryResult.success) {
+                return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_QUERY_FAILED, queryResult.message ?? 'In-progress summary query failed', { metadata: { duration: Date.now() - startTime } });
+            }
+            const summaries = queryResult.data.records.map((record) => ProfilingSummaryService.mapToPurgeSummaryRecord(record));
+            return createSuccessResult(summaries, {
+                message: `Found ${summaries.length} in-progress summaries`,
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_QUERY_FAILED, errorMessage, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+    }
+    /**
+     * Retrieves failed or stopped profiling summaries eligible for re-profiling.
+     *
+     * Queries summaries with REPROFILABLE_SUMMARY_STATUSES (FAILED).
+     * Optionally filters by object name.
+     *
+     * @param options - Optional filter by object names
+     * @returns ServiceResult containing matching PurgeSummaryRecord array
+     */
+    async getReprofilableSummaries(options) {
+        const startTime = Date.now();
+        const emptyResult = [];
+        try {
+            const builder = new CuneiformQueryBuilder()
+                .select(PURGE_SUMMARY_FIELDS)
+                .from('pnova__Profiling_SObject_Results__c')
+                .andWhereIn('pnova__Agg_OverallStatus__c', [...REPROFILABLE_SUMMARY_STATUSES]);
+            if (options?.objectNames && options.objectNames.length > 0) {
+                builder.andWhereIn('pnova__PDef_SObjectApiName__c', options.objectNames);
+            }
+            builder.orderBy('pnova__ProfilingDef__r.Name', 'ASC');
+            const soql = builder.toSOQL();
+            this.logger?.log(`Querying reprofilable summaries: ${soql}`);
+            const queryResult = await this.soqlAdapter.query(soql);
+            if (!queryResult.success) {
+                return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_QUERY_FAILED, queryResult.message ?? 'Reprofilable summary query failed', { metadata: { duration: Date.now() - startTime } });
+            }
+            const summaries = queryResult.data.records.map((record) => ProfilingSummaryService.mapToPurgeSummaryRecord(record));
+            return createSuccessResult(summaries, {
+                message: `Found ${summaries.length} reprofilable summaries`,
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_QUERY_FAILED, errorMessage, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+    }
+    /**
+     * Stops in-progress profiling summaries via the ISV REST API.
+     *
+     * Sends a PATCH request to `/services/apexrest/pnova/v1/profiling/summaries`
+     * with `{ summariesToStop: [...ids] }`. Deduplicates IDs before sending.
+     *
+     * @param summaryIds - Array of summary record IDs to stop
+     * @returns ServiceResult containing per-item results with summary counts
+     */
+    async stopSummaries(summaryIds) {
+        const startTime = Date.now();
+        const emptyResult = { results: [], summary: { total: 0, succeeded: 0, failed: 0 } };
+        if (!this.restAdapter) {
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_STOP_FAILED, 'REST adapter not configured for stop operations', { metadata: { duration: Date.now() - startTime } });
+        }
+        const uniqueIds = [...new Set(summaryIds)];
+        try {
+            this.logger?.log(`Stopping ${uniqueIds.length} profiling summary(ies)`);
+            const restResult = await this.restAdapter.request({
+                url: `${PROFILING_REST_BASE}/summaries`,
+                method: 'PATCH',
+                body: { summariesToStop: uniqueIds },
+            });
+            if (!restResult.success) {
+                return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_STOP_FAILED, restResult.message ?? 'Stop operation failed', { metadata: { duration: Date.now() - startTime } });
+            }
+            return ProfilingSummaryService.parseBulkResponse(restResult.data, ServiceErrorCodes.SUMMARY_STOP_FAILED, startTime);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger?.log(`Bulk stop failed: ${errorMessage}`);
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_STOP_FAILED, errorMessage, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+    }
+    /**
+     * Reprofiles failed or stopped profiling summaries via the ISV REST API.
+     *
+     * Sends a POST request to `/services/apexrest/pnova/v1/profiling/summaries/reprofile`
+     * with `{ summariesToReprofile: [...ids] }`. Deduplicates IDs before sending.
+     * Response includes a `requestId` per item on success (HTTP 201).
+     *
+     * @param summaryIds - Array of summary record IDs to reprofile
+     * @returns ServiceResult containing per-item results with summary counts
+     */
+    async reprofileSummaries(summaryIds) {
+        const startTime = Date.now();
+        const emptyResult = { results: [], summary: { total: 0, succeeded: 0, failed: 0 } };
+        if (!this.restAdapter) {
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_REPROFILE_FAILED, 'REST adapter not configured for reprofile operations', { metadata: { duration: Date.now() - startTime } });
+        }
+        const uniqueIds = [...new Set(summaryIds)];
+        try {
+            this.logger?.log(`Re-profiling ${uniqueIds.length} profiling summary(ies)`);
+            const restResult = await this.restAdapter.request({
+                url: `${PROFILING_REST_BASE}/summaries/reprofile`,
+                method: 'POST',
+                body: { summariesToReprofile: uniqueIds },
+            });
+            if (!restResult.success) {
+                return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_REPROFILE_FAILED, restResult.message ?? 'Reprofile operation failed', { metadata: { duration: Date.now() - startTime } });
+            }
+            return ProfilingSummaryService.parseBulkResponse(restResult.data, ServiceErrorCodes.SUMMARY_REPROFILE_FAILED, startTime);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger?.log(`Bulk reprofile failed: ${errorMessage}`);
+            return createFailureResult(emptyResult, ServiceErrorCodes.SUMMARY_REPROFILE_FAILED, errorMessage, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+    }
+}
+//# sourceMappingURL=ProfilingSummaryService.js.map