@peernova/cuneiform-sf 1.0.3-beta.0 → 1.0.4-beta.8

package/lib/operations/DefinitionImportOperation.js

@@ -1,7 +1,9 @@
 /*
- * Copyright (c) 2026, PeerNova Inc. All rights reserved.
- * SPDX-License-Identifier: BSD-3-Clause
- * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ * 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';
@@ -9,15 +11,18 @@ 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 */
+    /** Source directory does not exist. User should verify the --source path. */
     SOURCE_NOT_FOUND: 'IMPORT_SOURCE_NOT_FOUND',
-    /** Source directory is missing required files */
+    /** Source directory is missing pnova__Profiling_Definition__c.csv. User should verify export was successful. */
     INVALID_SOURCE: 'IMPORT_INVALID_SOURCE',
-    /** Failed to write config file */
+    /** Failed to write temporary export.json config. Check disk space and permissions. */
     CONFIG_WRITE_FAILED: 'IMPORT_CONFIG_WRITE_FAILED',
-    /** Import operation failed */
+    /** SFDMU import operation failed. Check SFDMU output for details. */
     IMPORT_FAILED: 'IMPORT_FAILED',
 };
 /**
@@ -34,15 +39,31 @@ export const ImportErrorCodes = {
  *   targetOrg: 'myOrg',
  *   sourceDir: './backup/definitions',
  *   operation: 'Upsert',
- *   dryRun: true
+ *   simulation: true
  * });
  * ```
  */
 export class DefinitionImportOperation {
-    /** SFDMU query for profiling definitions (used in config generation) */
-    static DEFINITION_QUERY = 'SELECT Id, Name, RecordTypeId, pnova__Agg_Status__c, pnova__Agg_StatusStatistical__c, pnova__Aud_VersionCRMBase__c, pnova__Aud_VersionCRMEnterprise__c, pnova__Aud_VersionDCBase__c, pnova__Profiling_IsProfileForAllFields__c, pnova__Profiling_IsProfileForAllRecords__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_LicenseViolations__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 FROM pnova__Profiling_Definition__c';
+    /**
+     * 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;
     /**
@@ -58,14 +79,25 @@ export class DefinitionImportOperation {
     /**
      * 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 SFDMU configuration object
+     * @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',
@@ -73,6 +105,105 @@ export class DefinitionImportOperation {
             ],
         };
     }
+    /**
+     * 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.
      *
@@ -90,7 +221,7 @@ export class DefinitionImportOperation {
                     data: {
                         definitionsImported: 0,
                         sourceDir,
-                        dryRun: options.dryRun ?? false,
+                        simulation: options.simulation ?? false,
                     },
                     errorCode: ImportErrorCodes.SOURCE_NOT_FOUND,
                     message: `Source directory does not exist: ${sourceDir}`,
@@ -104,12 +235,33 @@ export class DefinitionImportOperation {
                     data: {
                         definitionsImported: 0,
                         sourceDir,
-                        dryRun: options.dryRun ?? false,
+                        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)
@@ -126,21 +278,27 @@ export class DefinitionImportOperation {
                         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(options.operation ?? 'Insert');
+                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
+                // Build SFDMU options pointing to temp directory (simulation not passed — handled above)
                 const sfdmuOptions = {
                     targetOrg: options.targetOrg,
                     configPath: tempDir,
                 };
                 // Execute SFDMU import
-                // Note: For dry-run, we'd ideally use SFDMU's --simulation flag
-                // but that requires SFDMU version support check. For now, we execute
-                // the actual import. The dryRun flag is preserved for future enhancement.
                 const sfdmuResult = await this.sfdmuService.runImport(sfdmuOptions);
                 if (!sfdmuResult.success) {
                     return {
@@ -148,7 +306,7 @@ export class DefinitionImportOperation {
                         data: {
                             definitionsImported: 0,
                             sourceDir,
-                            dryRun: options.dryRun ?? false,
+                            simulation: options.simulation ?? false,
                             sfdmuOutput: sfdmuResult.data.stderr,
                         },
                         errorCode: sfdmuResult.errorCode ?? ImportErrorCodes.IMPORT_FAILED,
@@ -158,15 +316,18 @@ export class DefinitionImportOperation {
                         },
                     };
                 }
+                // 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: sfdmuResult.data.recordsProcessed ?? 0,
+                        definitionsImported,
                         sourceDir,
-                        dryRun: options.dryRun ?? false,
+                        simulation: options.simulation ?? false,
                         sfdmuOutput: sfdmuResult.data.stdout,
                     },
-                    message: `Successfully imported ${sfdmuResult.data.recordsProcessed ?? 0} definitions to ${options.targetOrg}`,
+                    message: `Successfully imported ${definitionsImported} definitions into ${options.targetOrg}`,
                     warnings: sfdmuResult.warnings,
                     metadata: {
                         duration: Date.now() - startTime,
@@ -174,15 +335,7 @@ export class DefinitionImportOperation {
                 };
             }
             finally {
-                // Clean up temp directory
-                try {
-                    fs.rmSync(tempDir, { recursive: true, force: true });
-                    this.logger?.log(`Cleaned up temp directory: ${tempDir}`);
-                }
-                catch {
-                    // Ignore cleanup errors - temp dir will be cleaned up by OS eventually
-                    this.logger?.log(`Warning: Failed to clean up temp directory: ${tempDir}`);
-                }
+                this.cleanupTempDir(tempDir);
             }
         }
         catch (error) {
@@ -190,5 +343,15 @@ export class DefinitionImportOperation {
             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

@@ -1 +1 @@
-{"version":3,"file":"DefinitionImportOperation.js","sourceRoot":"","sources":["../../src/operations/DefinitionImportOperation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AA8C3C;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,sCAAsC;IACtC,gBAAgB,EAAE,yBAAyB;IAC3C,iDAAiD;IACjD,cAAc,EAAE,uBAAuB;IACvC,kCAAkC;IAClC,mBAAmB,EAAE,4BAA4B;IACjD,8BAA8B;IAC9B,aAAa,EAAE,eAAe;CACtB,CAAC;AAeX;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,yBAAyB;IACpC,wEAAwE;IAChE,MAAM,CAAU,gBAAgB,GACtC,kqCAAkqC,CAAC;IAErqC,6BAA6B;IACrB,MAAM,CAAU,cAAc,GAAG,oCAAoC,CAAC;IAE7D,YAAY,CAAe;IAC3B,MAAM,CAAW;IAElC;;;;;OAKG;IACH,YAAmB,YAA0B,EAAE,MAAgB;QAC7D,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,gBAAgB,CAAC,SAA8B;QAC5D,OAAO;YACL,4BAA4B,EAAE,KAAK;YACnC,OAAO,EAAE;gBACP;oBACE,KAAK,EAAE,yBAAyB,CAAC,gBAAgB;oBACjD,SAAS;oBACT,UAAU,EAAE,MAAM;iBACnB;aACF;SACF,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,OAAO,CAAC,OAAsB;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAElD,IAAI,CAAC;YACH,mCAAmC;YACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9B,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,IAAI,EAAE;wBACJ,mBAAmB,EAAE,CAAC;wBACtB,SAAS;wBACT,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;qBAChC;oBACD,SAAS,EAAE,gBAAgB,CAAC,gBAAgB;oBAC5C,OAAO,EAAE,oCAAoC,SAAS,EAAE;iBACzD,CAAC;YACJ,CAAC;YAED,wCAAwC;YACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,cAAc,CAAC,CAAC;YAC/E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5B,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,IAAI,EAAE;wBACJ,mBAAmB,EAAE,CAAC;wBACtB,SAAS;wBACT,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;qBAChC;oBACD,SAAS,EAAE,gBAAgB,CAAC,cAAc;oBAC1C,OAAO,EAAE,8CAA8C,yBAAyB,CAAC,cAAc,EAAE;iBAClG,CAAC;YACJ,CAAC;YAED,yCAAyC;YACzC,uEAAuE;YACvE,+EAA+E;YAC/E,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,CAAC,CAAC;YAC5E,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;YAEvD,IAAI,CAAC;gBACH,8EAA8E;gBAC9E,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;gBACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;wBAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;wBAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;wBAC1C,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;wBACnC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,kBAAkB,QAAQ,EAAE,CAAC,CAAC;oBACjD,CAAC;gBACH,CAAC;gBAED,kDAAkD;gBAClD,4FAA4F;gBAC5F,MAAM,MAAM,GAAG,yBAAyB,CAAC,gBAAgB,CAAC,OAAO,CAAC,SAAS,IAAI,QAAQ,CAAC,CAAC;gBACzF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;gBACrD,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC9D,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC;gBAEzD,iDAAiD;gBACjD,MAAM,YAAY,GAAG;oBACnB,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,UAAU,EAAE,OAAO;iBACpB,CAAC;gBAEF,uBAAuB;gBACvB,gEAAgE;gBAChE,qEAAqE;gBACrE,0EAA0E;gBAC1E,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;gBAEpE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;oBACzB,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,IAAI,EAAE;4BACJ,mBAAmB,EAAE,CAAC;4BACtB,SAAS;4BACT,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;4BAC/B,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM;yBACrC;wBACD,SAAS,EAAE,WAAW,CAAC,SAAS,IAAI,gBAAgB,CAAC,aAAa;wBAClE,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,qBAAqB;wBACrD,QAAQ,EAAE;4BACR,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;yBACjC;qBACF,CAAC;gBACJ,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,IAAI,EAAE;wBACJ,mBAAmB,EAAE,WAAW,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC;wBAC3D,SAAS;wBACT,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;wBAC/B,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,MAAM;qBACrC;oBACD,OAAO,EAAE,yBAAyB,WAAW,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,mBACtE,OAAO,CAAC,SACV,EAAE;oBACF,QAAQ,EAAE,WAAW,CAAC,QAAQ;oBAC9B,QAAQ,EAAE;wBACR,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;qBACjC;iBACF,CAAC;YACJ,CAAC;oBAAS,CAAC;gBACT,0BAA0B;gBAC1B,IAAI,CAAC;oBACH,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;oBACrD,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;gBAC5D,CAAC;gBAAC,MAAM,CAAC;oBACP,uEAAuE;oBACvE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,+CAA+C,OAAO,EAAE,CAAC,CAAC;gBAC7E,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAE5E,MAAM,IAAI,OAAO,CAAC,4BAA4B,YAAY,EAAE,EAAE,sBAAsB,CAAC,CAAC;QACxF,CAAC;IACH,CAAC"}
+{"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>>;
+}

package/lib/operations/DefinitionListOperation.js

@@ -0,0 +1,108 @@
+/*
+ * 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.
+ */
+/**
+ * Error codes specific to list operations.
+ */
+export const ListErrorCodes = {
+    /** Service query failed (non-exception failure) */
+    LIST_FAILED: 'LIST_FAILED',
+    /** Operation failed unexpectedly (exception) */
+    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 class DefinitionListOperation {
+    definitionService;
+    logger;
+    /**
+     * Creates a new DefinitionListOperation.
+     *
+     * @param definitionService - The ProfilingDefinitionService instance for querying definitions
+     * @param logger - Optional logger for debug output
+     */
+    constructor(definitionService, logger) {
+        this.definitionService = definitionService;
+        this.logger = logger;
+    }
+    /**
+     * 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
+     */
+    async execute(options) {
+        const startTime = Date.now();
+        const emptyResult = {
+            definitions: [],
+            totalCount: 0,
+            summary: { activeCount: 0, inactiveCount: 0, profiledCount: 0, notProfiledCount: 0 },
+        };
+        try {
+            this.logger?.log('Starting definition list operation');
+            const listResult = await this.definitionService.listDefinitions({
+                filter: options.filter,
+                pagination: options.pagination,
+                sort: options.sort,
+            });
+            const duration = Date.now() - startTime;
+            if (!listResult.success) {
+                const errorMessage = listResult.message ?? 'Unknown error';
+                this.logger?.log(`Definition list failed: ${errorMessage}`);
+                return {
+                    success: false,
+                    data: emptyResult,
+                    errorCode: ListErrorCodes.LIST_FAILED,
+                    message: listResult.message ?? 'Definition list query failed',
+                    metadata: { duration },
+                };
+            }
+            const { definitions, totalCount, summary } = listResult.data;
+            this.logger?.log(`Definition list completed: ${String(definitions.length)} definitions found`);
+            return {
+                success: true,
+                data: { definitions, totalCount, summary },
+                message: `Found ${String(totalCount)} definitions`,
+                metadata: { duration },
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger?.log(`Definition list failed: ${errorMessage}`);
+            return {
+                success: false,
+                data: emptyResult,
+                errorCode: ListErrorCodes.OPERATION_FAILED,
+                message: `Definition list failed: ${errorMessage}`,
+                metadata: { duration },
+            };
+        }
+    }
+}
+//# sourceMappingURL=DefinitionListOperation.js.map

package/lib/operations/DefinitionListOperation.js.map

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