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

package/lib/operations/DefinitionImportOperation.d.ts

@@ -0,0 +1,144 @@
+import { type ServiceResult } from '../models/sfdmu-types.js';
+import { SFDMUService } from '../services/SFDMUService.js';
+/**
+ * SFDMU operation types for import.
+ */
+export type ImportOperationType = 'Insert' | 'Upsert';
+/**
+ * Options for the definition import operation.
+ */
+export type ImportOptions = {
+    /** Target org username or alias to import into */
+    targetOrg: string;
+    /** Source directory containing CSV files and export.json */
+    sourceDir: string;
+    /** SFDMU operation type (Insert or Upsert) */
+    operation?: ImportOperationType;
+    /** Simulation mode - validates and previews changes without modifying data */
+    simulation?: boolean;
+    /** Optional logger for debug output */
+    logger?: Console;
+};
+/**
+ * Result of a definition import operation.
+ */
+export type ImportResult = {
+    /** Number of definitions imported */
+    definitionsImported: number;
+    /** Source directory used */
+    sourceDir: string;
+    /** Whether this was a simulation (no data modified) */
+    simulation: boolean;
+    /** Raw SFDMU output for debugging */
+    sfdmuOutput?: string;
+};
+/**
+ * Error codes specific to import operations.
+ *
+ * These codes are returned in ServiceResult.errorCode when import fails.
+ * User action: Check the corresponding message for resolution steps.
+ */
+export declare const ImportErrorCodes: {
+    /** Source directory does not exist. User should verify the --source path. */
+    readonly SOURCE_NOT_FOUND: "IMPORT_SOURCE_NOT_FOUND";
+    /** Source directory is missing pnova__Profiling_Definition__c.csv. User should verify export was successful. */
+    readonly INVALID_SOURCE: "IMPORT_INVALID_SOURCE";
+    /** Failed to write temporary export.json config. Check disk space and permissions. */
+    readonly CONFIG_WRITE_FAILED: "IMPORT_CONFIG_WRITE_FAILED";
+    /** SFDMU import operation failed. Check SFDMU output for details. */
+    readonly IMPORT_FAILED: "IMPORT_FAILED";
+};
+/**
+ * Orchestrates the import of profiling definitions using SFDMU.
+ *
+ * Follows the 4-layer architecture: Command → Operation → Service → API
+ * This operation layer handles business logic orchestration while delegating
+ * the actual SFDMU execution to SFDMUService.
+ *
+ * @example
+ * ```typescript
+ * const operation = new DefinitionImportOperation(sfdmuService);
+ * const result = await operation.execute({
+ *   targetOrg: 'myOrg',
+ *   sourceDir: './backup/definitions',
+ *   operation: 'Upsert',
+ *   simulation: true
+ * });
+ * ```
+ */
+export declare class DefinitionImportOperation {
+    /**
+     * SFDMU query for profiling definitions (used in config generation).
+     * Includes formula fields (PropFx_*) for CSV compatibility with export - these are
+     * read-only and will be ignored by Salesforce during import (computed automatically).
+     *
+     * CLI-3039: Removed pnova__Aud_VersionDCBase__c and pnova__Prop_LicenseViolations__c
+     * — both are absent from packaging/v4.12.0 and SFDMU was logging "Missing in the
+     * Target and will be excluded from the migration" warnings on every import.
+     */
+    private static readonly DEFINITION_QUERY;
+    /** Expected CSV file name */
+    private static readonly DEFINITION_CSV;
+    /**
+     * Columns stripped from the definition CSV before SFDMU import.
+     * These carry source-org profiling history and must start fresh in the target.
+     */
+    private static readonly IMPORT_CLEAR_COLUMNS;
+    private readonly sfdmuService;
+    private readonly logger?;
+    /**
+     * Creates a new DefinitionImportOperation.
+     *
+     * @param sfdmuService - The SFDMU service instance for executing operations
+     * @param logger - Optional logger for debug output
+     */
+    constructor(sfdmuService: SFDMUService, logger?: Console);
+    /**
+     * Builds the SFDMU import configuration.
+     *
+     * Creates an export.json config structure for SFDMU import operations.
+     * Note: SFDMU always reads 'export.json' regardless of operation direction.
+     *
+     * RecordType is declared first as a Readonly reference object so that SFDMU can
+     * resolve the RecordType.$$DeveloperName$NamespacePrefix$SobjectType lookup column
+     * from the RecordType.csv sidecar file. Without this entry, SFDMU finds the sidecar
+     * but does not include RecordType in its import plan, leaving RecordTypeId as #N/A
+     * and causing Salesforce to reject the insert.
+     *
+     * @param operation - The import operation type (Insert or Upsert)
+     * @returns Config object with promptOnMissingParentObjects=false and objects array
+     */
+    private static buildSFDMUConfig;
+    /**
+     * Counts data rows in the source definition CSV.
+     *
+     * SFDMU import also processes the RecordType.csv sidecar used for lookup resolution,
+     * so its "Processed N records" log lines cover multiple objects. Reading the source CSV
+     * directly gives the exact definition count (CLI-3140).
+     *
+     * Returns 0 if the file is absent or unreadable.
+     */
+    private static countCsvDataRows;
+    /**
+     * Parses a single CSV line into fields, handling RFC-4180 quoting and a leading UTF-8 BOM
+     * on the first field of the first line (written by SFDMU).
+     */
+    private static parseCSVLine;
+    /** Serializes fields back to a CSV line, quoting every field for safety. */
+    private static serializeCSVLine;
+    /**
+     * Removes the specified columns from CSV content (header + corresponding value in every row).
+     * Preserves the original line endings. Returns the original content unchanged if no matching
+     * columns are found.
+     */
+    private static stripColumns;
+    /**
+     * Executes the import operation.
+     *
+     * @param options - Import options
+     * @returns ServiceResult containing import results or error details
+     */
+    execute(options: ImportOptions): Promise<ServiceResult<ImportResult>>;
+    /** Remove the temp directory, logging on failure instead of throwing (to avoid shadowing real errors in finally blocks). */
+    private cleanupTempDir;
+}

package/lib/operations/DefinitionImportOperation.js

@@ -0,0 +1,357 @@
+/*
+ * 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 * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { SfError } from '@salesforce/core';
+/**
+ * Error codes specific to import operations.
+ *
+ * These codes are returned in ServiceResult.errorCode when import fails.
+ * User action: Check the corresponding message for resolution steps.
+ */
+export const ImportErrorCodes = {
+    /** Source directory does not exist. User should verify the --source path. */
+    SOURCE_NOT_FOUND: 'IMPORT_SOURCE_NOT_FOUND',
+    /** Source directory is missing pnova__Profiling_Definition__c.csv. User should verify export was successful. */
+    INVALID_SOURCE: 'IMPORT_INVALID_SOURCE',
+    /** Failed to write temporary export.json config. Check disk space and permissions. */
+    CONFIG_WRITE_FAILED: 'IMPORT_CONFIG_WRITE_FAILED',
+    /** SFDMU import operation failed. Check SFDMU output for details. */
+    IMPORT_FAILED: 'IMPORT_FAILED',
+};
+/**
+ * Orchestrates the import of profiling definitions using SFDMU.
+ *
+ * Follows the 4-layer architecture: Command → Operation → Service → API
+ * This operation layer handles business logic orchestration while delegating
+ * the actual SFDMU execution to SFDMUService.
+ *
+ * @example
+ * ```typescript
+ * const operation = new DefinitionImportOperation(sfdmuService);
+ * const result = await operation.execute({
+ *   targetOrg: 'myOrg',
+ *   sourceDir: './backup/definitions',
+ *   operation: 'Upsert',
+ *   simulation: true
+ * });
+ * ```
+ */
+export class DefinitionImportOperation {
+    /**
+     * SFDMU query for profiling definitions (used in config generation).
+     * Includes formula fields (PropFx_*) for CSV compatibility with export - these are
+     * read-only and will be ignored by Salesforce during import (computed automatically).
+     *
+     * CLI-3039: Removed pnova__Aud_VersionDCBase__c and pnova__Prop_LicenseViolations__c
+     * — both are absent from packaging/v4.12.0 and SFDMU was logging "Missing in the
+     * Target and will be excluded from the migration" warnings on every import.
+     */
+    static DEFINITION_QUERY = 'SELECT Id, Name, RecordTypeId, pnova__Agg_Status__c, pnova__Agg_StatusStatistical__c, pnova__Aud_VersionCRMBase__c, pnova__Aud_VersionCRMEnterprise__c, pnova__Prop_IsProfilingAllFieldsEnabled__c, pnova__Prop_Category__c, pnova__Prop_Description__c, pnova__Prop_Filter_JSON_SetA__c, pnova__Prop_Filter_JSON_SetB__c, pnova__Prop_Filter_SetA__c, pnova__Prop_Filter_SetB__c, pnova__Prop_InsightGroups_JSON__c, pnova__Prop_IsActive__c, pnova__Prop_IsFiltered_SetA__c, pnova__Prop_IsFiltered_SetB__c, pnova__Prop_IsNotificationEnabled__c, pnova__Prop_IsProfilingLaunchedFromWizard__c, pnova__Prop_KpiBusinessImpact__c, pnova__Prop_KpiBusinessImpact_JSON__c, pnova__Prop_KpiDataQuality__c, pnova__Prop_KpiDataQuality_JSON__c, pnova__Prop_AreKpisDefined__c, pnova__Prop_Name__c, pnova__Prop_SelectedFields__c, pnova__Prop_SelectedFields_JSON__c, pnova__Prop_SelectedFieldsCount__c, pnova__Prop_SObjectApiName__c, pnova__Prop_SObjectFullApiName__c, pnova__Prop_SObjectLabel__c, pnova__Prop_SObjectRecordTypeId__c, pnova__Prop_SObjectRecordTypeLabel__c, pnova__PropFx_IsMetadataProfilingOnly__c, pnova__PropFx_IsProfilingAllRecords__c FROM pnova__Profiling_Definition__c';
+    /** Expected CSV file name */
+    static DEFINITION_CSV = 'pnova__Profiling_Definition__c.csv';
+    /**
+     * Columns stripped from the definition CSV before SFDMU import.
+     * These carry source-org profiling history and must start fresh in the target.
+     */
+    static IMPORT_CLEAR_COLUMNS = [
+        'pnova__Agg_Status__c',
+        'pnova__Agg_StatusStatistical__c',
+    ];
+    sfdmuService;
+    logger;
+    /**
+     * Creates a new DefinitionImportOperation.
+     *
+     * @param sfdmuService - The SFDMU service instance for executing operations
+     * @param logger - Optional logger for debug output
+     */
+    constructor(sfdmuService, logger) {
+        this.sfdmuService = sfdmuService;
+        this.logger = logger;
+    }
+    /**
+     * Builds the SFDMU import configuration.
+     *
+     * Creates an export.json config structure for SFDMU import operations.
+     * Note: SFDMU always reads 'export.json' regardless of operation direction.
+     *
+     * RecordType is declared first as a Readonly reference object so that SFDMU can
+     * resolve the RecordType.$$DeveloperName$NamespacePrefix$SobjectType lookup column
+     * from the RecordType.csv sidecar file. Without this entry, SFDMU finds the sidecar
+     * but does not include RecordType in its import plan, leaving RecordTypeId as #N/A
+     * and causing Salesforce to reject the insert.
+     *
+     * @param operation - The import operation type (Insert or Upsert)
+     * @returns Config object with promptOnMissingParentObjects=false and objects array
+     */
+    static buildSFDMUConfig(operation) {
+        return {
+            promptOnMissingParentObjects: false,
+            objects: [
+                {
+                    // RecordTypeId is expected to be present directly in the source CSV (as exported by
+                    // sf cuneiform definition export). SFDMU uses it as-is — no composite key lookup.
+                    query: DefinitionImportOperation.DEFINITION_QUERY,
+                    operation,
+                    externalId: 'Name',
+                },
+            ],
+        };
+    }
+    /**
+     * Counts data rows in the source definition CSV.
+     *
+     * SFDMU import also processes the RecordType.csv sidecar used for lookup resolution,
+     * so its "Processed N records" log lines cover multiple objects. Reading the source CSV
+     * directly gives the exact definition count (CLI-3140).
+     *
+     * Returns 0 if the file is absent or unreadable.
+     */
+    static countCsvDataRows(csvPath) {
+        try {
+            const content = fs.readFileSync(csvPath, 'utf-8');
+            return content.split('\n').filter((line, index) => index > 0 && line.trim().length > 0).length;
+        }
+        catch {
+            return 0;
+        }
+    }
+    /**
+     * Parses a single CSV line into fields, handling RFC-4180 quoting and a leading UTF-8 BOM
+     * on the first field of the first line (written by SFDMU).
+     */
+    static parseCSVLine(line) {
+        const fields = [];
+        let current = '';
+        let inQuotes = false;
+        let i = 0;
+        // Strip BOM from the very first character if present
+        if (line.startsWith('')) {
+            i = 1;
+        }
+        while (i < line.length) {
+            const ch = line[i];
+            if (inQuotes) {
+                if (ch === '"') {
+                    if (line[i + 1] === '"') {
+                        current += '"';
+                        i += 2;
+                    }
+                    else {
+                        inQuotes = false;
+                        i++;
+                    }
+                }
+                else {
+                    current += ch;
+                    i++;
+                }
+            }
+            else if (ch === '"') {
+                inQuotes = true;
+                i++;
+            }
+            else if (ch === ',') {
+                fields.push(current);
+                current = '';
+                i++;
+            }
+            else {
+                current += ch;
+                i++;
+            }
+        }
+        fields.push(current);
+        return fields;
+    }
+    /** Serializes fields back to a CSV line, quoting every field for safety. */
+    static serializeCSVLine(fields) {
+        return fields.map((f) => `"${f.replace(/"/g, '""')}"`).join(',');
+    }
+    /**
+     * Removes the specified columns from CSV content (header + corresponding value in every row).
+     * Preserves the original line endings. Returns the original content unchanged if no matching
+     * columns are found.
+     */
+    static stripColumns(csvContent, columnsToStrip) {
+        const normalized = csvContent.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+        const lines = normalized.split('\n');
+        if (lines.length === 0)
+            return csvContent;
+        const headerFields = DefinitionImportOperation.parseCSVLine(lines[0]);
+        const stripSet = new Set(columnsToStrip);
+        const keepIndices = headerFields.map((_, idx) => idx).filter((idx) => !stripSet.has(headerFields[idx]));
+        if (keepIndices.length === headerFields.length) {
+            return csvContent;
+        }
+        const resultLines = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (i === 0 || line.trim().length > 0) {
+                const rowFields = DefinitionImportOperation.parseCSVLine(line);
+                resultLines.push(DefinitionImportOperation.serializeCSVLine(keepIndices.map((idx) => rowFields[idx] ?? '')));
+            }
+            else {
+                resultLines.push('');
+            }
+        }
+        return resultLines.join('\n');
+    }
+    /**
+     * Executes the import operation.
+     *
+     * @param options - Import options
+     * @returns ServiceResult containing import results or error details
+     */
+    async execute(options) {
+        const startTime = Date.now();
+        const sourceDir = path.resolve(options.sourceDir);
+        try {
+            // Validate source directory exists
+            if (!fs.existsSync(sourceDir)) {
+                return {
+                    success: false,
+                    data: {
+                        definitionsImported: 0,
+                        sourceDir,
+                        simulation: options.simulation ?? false,
+                    },
+                    errorCode: ImportErrorCodes.SOURCE_NOT_FOUND,
+                    message: `Source directory does not exist: ${sourceDir}`,
+                };
+            }
+            // Validate source has required CSV file
+            const csvPath = path.join(sourceDir, DefinitionImportOperation.DEFINITION_CSV);
+            if (!fs.existsSync(csvPath)) {
+                return {
+                    success: false,
+                    data: {
+                        definitionsImported: 0,
+                        sourceDir,
+                        simulation: options.simulation ?? false,
+                    },
+                    errorCode: ImportErrorCodes.INVALID_SOURCE,
+                    message: `Source directory is missing required file: ${DefinitionImportOperation.DEFINITION_CSV}`,
+                };
+            }
+            // Simulation mode: validate CSV structure and count data rows without calling SFDMU.
+            // SFDMU does not support a --simulation flag, so simulation is handled here at the
+            // operation layer. This validates the source directory, counts importable rows, and
+            // returns a preview result without modifying any org data.
+            if (options.simulation) {
+                const csvContent = fs.readFileSync(csvPath, 'utf-8');
+                // Count data rows (exclude header line and empty trailing lines)
+                const dataRows = csvContent.split('\n').filter((line, index) => index > 0 && line.trim().length > 0);
+                return {
+                    success: true,
+                    data: {
+                        definitionsImported: dataRows.length,
+                        sourceDir,
+                        simulation: true,
+                    },
+                    message: `Simulation completed — ${dataRows.length} definitions would be imported to ${options.targetOrg}`,
+                    metadata: {
+                        duration: Date.now() - startTime,
+                    },
+                };
+            }
+            // Create temp directory for SFDMU import
+            // SFDMU always reads from 'export.json', so we use a temp dir to avoid
+            // mutating the user's source directory (which may contain their export config)
+            const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cuneiform-import-'));
+            this.logger?.log(`Created temp directory: ${tempDir}`);
+            try {
+                // Copy all CSV files to temp directory (including RecordType.csv for lookups)
+                const files = fs.readdirSync(sourceDir);
+                for (const file of files) {
+                    if (file.endsWith('.csv')) {
+                        const srcPath = path.join(sourceDir, file);
+                        const destPath = path.join(tempDir, file);
+                        fs.copyFileSync(srcPath, destPath);
+                        this.logger?.log(`Copied CSV to: ${destPath}`);
+                    }
+                }
+                // Strip runtime-state columns on Insert only — Upsert preserves existing data so
+                // the status values in the CSV are intentional (the caller owns them).
+                // On Insert the target starts fresh, so source-org profiling history must not be written in.
+                const effectiveOperation = options.operation ?? 'Insert';
+                const defCsvPath = path.join(tempDir, DefinitionImportOperation.DEFINITION_CSV);
+                if (effectiveOperation === 'Insert' && fs.existsSync(defCsvPath)) {
+                    const stripped = DefinitionImportOperation.stripColumns(fs.readFileSync(defCsvPath, 'utf-8'), DefinitionImportOperation.IMPORT_CLEAR_COLUMNS);
+                    fs.writeFileSync(defCsvPath, stripped, 'utf-8');
+                }
+                // Generate import configuration in temp directory
+                // Note: SFDMU always reads 'export.json' from the config path, regardless of operation type
+                const config = DefinitionImportOperation.buildSFDMUConfig(effectiveOperation);
+                const configPath = path.join(tempDir, 'export.json');
+                fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+                this.logger?.log(`Wrote SFDMU config to: ${configPath}`);
+                // Build SFDMU options pointing to temp directory (simulation not passed — handled above)
+                const sfdmuOptions = {
+                    targetOrg: options.targetOrg,
+                    configPath: tempDir,
+                };
+                // Execute SFDMU import
+                const sfdmuResult = await this.sfdmuService.runImport(sfdmuOptions);
+                if (!sfdmuResult.success) {
+                    return {
+                        success: false,
+                        data: {
+                            definitionsImported: 0,
+                            sourceDir,
+                            simulation: options.simulation ?? false,
+                            sfdmuOutput: sfdmuResult.data.stderr,
+                        },
+                        errorCode: sfdmuResult.errorCode ?? ImportErrorCodes.IMPORT_FAILED,
+                        message: sfdmuResult.message ?? 'SFDMU import failed',
+                        metadata: {
+                            duration: Date.now() - startTime,
+                        },
+                    };
+                }
+                // Count definitions from source CSV — more reliable than parsing SFDMU output
+                // which also counts RecordType records processed for lookup resolution (CLI-3140).
+                const definitionsImported = DefinitionImportOperation.countCsvDataRows(csvPath);
+                return {
+                    success: true,
+                    data: {
+                        definitionsImported,
+                        sourceDir,
+                        simulation: options.simulation ?? false,
+                        sfdmuOutput: sfdmuResult.data.stdout,
+                    },
+                    message: `Successfully imported ${definitionsImported} definitions into ${options.targetOrg}`,
+                    warnings: sfdmuResult.warnings,
+                    metadata: {
+                        duration: Date.now() - startTime,
+                    },
+                };
+            }
+            finally {
+                this.cleanupTempDir(tempDir);
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new SfError(`Import operation failed: ${errorMessage}`, 'ImportOperationError');
+        }
+    }
+    /** Remove the temp directory, logging on failure instead of throwing (to avoid shadowing real errors in finally blocks). */
+    cleanupTempDir(tempDir) {
+        try {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        }
+        catch (cleanupError) {
+            /* c8 ignore next 5 -- rmSync with force:true rarely throws; ESM modules cannot be stubbed to simulate it */
+            this.logger?.log(`Warning: failed to clean up temp directory ${tempDir}: ${cleanupError instanceof Error ? cleanupError.message : String(cleanupError)}`);
+        }
+    }
+}
+//# sourceMappingURL=DefinitionImportOperation.js.map

package/lib/operations/DefinitionImportOperation.js.map

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

package/lib/operations/DefinitionListOperation.d.ts

@@ -0,0 +1,66 @@
+import type { ServiceResult } from '../models/service-result.js';
+import type { ProfilingDefinitionService, DefinitionListFilter, DefinitionListPagination, DefinitionListSort, DefinitionListResult } from '../services/ProfilingDefinitionService.js';
+/**
+ * Options for the definition list operation.
+ *
+ * Maps directly to the DefinitionListOptions accepted by ProfilingDefinitionService.listDefinitions().
+ * The operation acts as a thin orchestration layer between command flags and the service.
+ */
+export type ListOptions = {
+    /** Filter criteria for narrowing the definition list */
+    filter?: DefinitionListFilter;
+    /** Pagination parameters (limit, offset) */
+    pagination?: DefinitionListPagination;
+    /** Sort specification (field, direction) */
+    sort?: DefinitionListSort;
+};
+/**
+ * Error codes specific to list operations.
+ */
+export declare const ListErrorCodes: {
+    /** Service query failed (non-exception failure) */
+    readonly LIST_FAILED: "LIST_FAILED";
+    /** Operation failed unexpectedly (exception) */
+    readonly OPERATION_FAILED: "LIST_OPERATION_FAILED";
+};
+/**
+ * Orchestrates listing of profiling definitions.
+ *
+ * Follows the 4-layer architecture: Command -> Operation -> Service -> API
+ * This operation layer handles:
+ * 1. Accepts parsed command flags as ListOptions
+ * 2. Delegates to ProfilingDefinitionService.listDefinitions()
+ * 3. Returns ServiceResult<DefinitionListResult> with timing metadata
+ *
+ * @example
+ * ```typescript
+ * const operation = new DefinitionListOperation(definitionService);
+ * const result = await operation.execute({
+ *   filter: { status: 'active', objects: ['Account'] },
+ *   pagination: { limit: 10, offset: 0 },
+ *   sort: { field: 'name', direction: 'asc' }
+ * });
+ * ```
+ */
+export declare class DefinitionListOperation {
+    private readonly definitionService;
+    private readonly logger?;
+    /**
+     * Creates a new DefinitionListOperation.
+     *
+     * @param definitionService - The ProfilingDefinitionService instance for querying definitions
+     * @param logger - Optional logger for debug output
+     */
+    constructor(definitionService: ProfilingDefinitionService, logger?: Console);
+    /**
+     * Executes the definition list operation.
+     *
+     * Returns a ServiceResult with success=false and one of the following error codes on failure:
+     * - LIST_FAILED: When the underlying service query returns a failure result
+     * - OPERATION_FAILED: When an unexpected exception occurs
+     *
+     * @param options - List options (filter, pagination, sort)
+     * @returns ServiceResult containing DefinitionListResult or error details
+     */
+    execute(options: ListOptions): Promise<ServiceResult<DefinitionListResult>>;
+}