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

package/lib/services/SFDMUService.js

@@ -0,0 +1,295 @@
+/*
+ * 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 { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { SfError } from '@salesforce/core';
+import { SFDMUErrorCodes } from '../models/sfdmu-types.js';
+/** Default promisified execFile */
+const defaultExecFileAsync = promisify(execFile);
+/**
+ * Service for executing SFDMU (Salesforce Data Move Utility) operations.
+ *
+ * This service provides:
+ * - Runtime verification that SFDMU is installed
+ * - Secure shell execution using execFile (prevents command injection)
+ * - Cross-platform support (Windows/Unix)
+ * - Configurable timeout and buffer sizes
+ * - Result parsing for record counts and errors
+ *
+ * @example
+ * ```typescript
+ * const service = new SFDMUService();
+ * await service.verifyInstallation();
+ * const result = await service.runExport({
+ *   configPath: './export.json',
+ *   sourceOrg: 'myOrg'
+ * });
+ * ```
+ */
+export class SFDMUService {
+    /** Default timeout for SFDMU operations (5 minutes) */
+    static DEFAULT_TIMEOUT = 300_000;
+    /** Default max buffer size for stdout/stderr (10MB) */
+    static DEFAULT_MAX_BUFFER = 10 * 1024 * 1024;
+    /** The sf CLI binary name (platform-specific) */
+    sfBinary;
+    /** Logger instance */
+    logger;
+    /** Injected execFile function */
+    execFileAsync;
+    /**
+     * Creates a new SFDMUService instance.
+     *
+     * @param config - Optional configuration including logger and test dependencies
+     */
+    constructor(config) {
+        const platform = config?.platform ?? process.platform;
+        this.sfBinary = platform === 'win32' ? 'sf.cmd' : 'sf';
+        this.logger = config?.logger;
+        this.execFileAsync = config?.execFileAsync ?? defaultExecFileAsync;
+    }
+    /**
+     * Builds command line arguments for SFDMU execution.
+     *
+     * @param options - Operation options
+     * @param operation - The operation type
+     * @returns Array of command line arguments
+     */
+    static buildArgs(options, operation) {
+        // --noprompt: skip the interactive "Continue the job (y/n)?" prompt SFDMU raises
+        // when source CSV columns don't match the export.json query (CSVIssuesReport
+        // entries). In CI's non-TTY stdin, the abandoned prompt makes the sfdmu:run
+        // oclif command exit non-zero even when the migration itself completes — see
+        // CLI-3039 run 25355904571 where SFDMU logged "Exit code 0 (SUCCESS)" yet the
+        // child process exit was 1.
+        const args = ['sfdmu:run', '--path', options.configPath, '--noprompt'];
+        // For export: source=org, target=csvfile (writes CSV files)
+        // For import: source=csvfile, target=org (reads CSV files)
+        if (operation === 'export' && options.sourceOrg) {
+            args.push('--sourceusername', options.sourceOrg);
+            args.push('--targetusername', 'csvfile');
+        }
+        else if (operation === 'import' && options.targetOrg) {
+            args.push('--sourceusername', 'csvfile');
+            args.push('--targetusername', options.targetOrg);
+        }
+        // REST API is preferred for small datasets (<10k records) — lower overhead than Bulk.
+        // Bulk API is the default for large datasets — optimized for throughput.
+        if (options.useBulkAPI === false) {
+            args.push('--apiversion', 'rest');
+        }
+        // Note: SFDMU does not support a --simulation flag. Simulation mode is handled
+        // at the operation layer (DefinitionImportOperation) by skipping the SFDMU call
+        // entirely. The simulation field on ISFDMUOptions is retained for callers to
+        // indicate intent, but it is NOT passed as a CLI argument.
+        return args;
+    }
+    /**
+     * Parses record count from SFDMU stdout output.
+     *
+     * SFDMU (Salesforce Data Move Utility) outputs record counts in several formats
+     * depending on the operation type and verbosity level:
+     * - Summary lines: "Total: 100 records" — single authoritative count, checked first
+     * - Per-batch lines: "Processed 8 records" repeated per batch — summed to get total
+     * - Alternate phrasing: "100 records processed"
+     *
+     * Per-batch counts must be summed: SFDMU emits "Processed N records" once per batch
+     * (CLI-3140), so taking only the first match caps the reported count at the batch size.
+     *
+     * Tested against SFDMU v4.x output. If patterns fail to match, returns undefined
+     * (graceful degradation — record count is informational, not required).
+     *
+     * @param stdout - Standard output from SFDMU execution
+     * @returns Parsed record count or undefined if no pattern matched
+     */
+    static parseRecordCount(stdout) {
+        // Check for a single authoritative total first (avoids summing batches when a summary exists)
+        const totalMatch = stdout.match(/Total[:\s]+(\d+)\s+records?/i);
+        if (totalMatch?.[1]) {
+            return parseInt(totalMatch[1], 10);
+        }
+        // Sum all "Processed N records" occurrences — SFDMU emits one per batch
+        const processedMatches = [...stdout.matchAll(/Processed\s+(\d+)\s+records?/gi)];
+        if (processedMatches.length > 0) {
+            return processedMatches.reduce((sum, m) => sum + parseInt(m[1], 10), 0);
+        }
+        // Alternate word order: "N records processed"
+        const altMatch = stdout.match(/(\d+)\s+records?\s+processed/i);
+        if (altMatch?.[1]) {
+            return parseInt(altMatch[1], 10);
+        }
+        return undefined;
+    }
+    /**
+     * Parses error messages from SFDMU stderr output.
+     *
+     * @param stderr - Standard error from SFDMU
+     * @returns Array of error messages
+     */
+    static parseErrors(stderr) {
+        if (!stderr.trim()) {
+            return [];
+        }
+        // Split stderr into lines and filter for error messages
+        return stderr
+            .split('\n')
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0 && (line.toLowerCase().includes('error') || line.startsWith('Error:')));
+    }
+    /**
+     * Parses warning messages from SFDMU stderr output.
+     *
+     * @param stderr - Standard error from SFDMU
+     * @returns Array of warning messages
+     */
+    static parseWarnings(stderr) {
+        if (!stderr.trim()) {
+            return [];
+        }
+        // Split stderr into lines and filter for warnings
+        return stderr
+            .split('\n')
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0 && line.toLowerCase().includes('warning'));
+    }
+    /**
+     * Returns the sf binary name being used (for testing/debugging).
+     */
+    getSfBinary() {
+        return this.sfBinary;
+    }
+    /**
+     * Verifies that SFDMU is installed and available.
+     *
+     * @returns Promise that resolves when SFDMU installation is verified
+     * @throws SfError with code 'SFCLINotFound' if Salesforce CLI is not installed
+     * @throws SfError with code from SFDMUErrorCodes.NOT_INSTALLED if SFDMU plugin is missing
+     */
+    async verifyInstallation() {
+        try {
+            await this.execFileAsync(this.sfBinary, ['sfdmu', '--help'], {
+                timeout: 30_000, // 30 second timeout for help command
+                maxBuffer: 1024 * 1024, // 1MB buffer for help output
+            });
+            this.logger?.log('SFDMU installation verified');
+        }
+        catch (error) {
+            const execError = error;
+            // Check if this is a "command not found" type error
+            if (execError.code === 'ENOENT' || execError.message?.includes('not found')) {
+                throw new SfError('Salesforce CLI (sf) is not installed or not in PATH.', 'SFCLINotFound', [
+                    'Install Salesforce CLI: https://developer.salesforce.com/tools/salesforcecli',
+                    'Ensure sf is in your PATH',
+                ]);
+            }
+            // SFDMU plugin not installed (sf found but sfdmu command failed)
+            throw new SfError('SFDMU plugin is not installed.', SFDMUErrorCodes.NOT_INSTALLED, [
+                'Install SFDMU: sf plugins install sfdmu',
+                'Documentation: https://help.sfdmu.com',
+            ]);
+        }
+    }
+    /**
+     * Executes an SFDMU export operation.
+     *
+     * @param options - Export options including config path and source org
+     * @returns ServiceResult containing the execution result
+     */
+    async runExport(options) {
+        return this.executeOperation(options, 'export');
+    }
+    /**
+     * Executes an SFDMU import operation.
+     *
+     * @param options - Import options including config path and target org
+     * @returns ServiceResult containing the execution result
+     */
+    async runImport(options) {
+        return this.executeOperation(options, 'import');
+    }
+    /**
+     * Executes an SFDMU operation (export or import).
+     *
+     * @param options - Operation options
+     * @param operation - The operation type ('export' or 'import')
+     * @returns ServiceResult containing the execution result
+     */
+    async executeOperation(options, operation) {
+        const startTime = Date.now();
+        // Verify SFDMU is installed before attempting operation
+        await this.verifyInstallation();
+        // Build command arguments
+        const args = SFDMUService.buildArgs(options, operation);
+        const timeout = options.timeout ?? SFDMUService.DEFAULT_TIMEOUT;
+        const maxBuffer = options.maxBuffer ?? SFDMUService.DEFAULT_MAX_BUFFER;
+        this.logger?.log(`Executing SFDMU ${operation}: ${this.sfBinary} ${args.join(' ')}`);
+        try {
+            const { stdout, stderr } = await this.execFileAsync(this.sfBinary, args, {
+                timeout,
+                maxBuffer,
+            });
+            const duration = Date.now() - startTime;
+            const recordsProcessed = SFDMUService.parseRecordCount(stdout);
+            const warnings = SFDMUService.parseWarnings(stderr);
+            return {
+                success: true,
+                data: {
+                    exitCode: 0,
+                    stdout,
+                    stderr,
+                    recordsProcessed,
+                    errors: [],
+                },
+                message: `SFDMU ${operation} completed successfully`,
+                warnings: warnings.length > 0 ? warnings : undefined,
+                metadata: {
+                    duration,
+                },
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const execError = error;
+            // Handle timeout
+            if (execError.killed && execError.signal === 'SIGTERM') {
+                return {
+                    success: false,
+                    data: {
+                        exitCode: -1,
+                        stdout: execError.stdout ?? '',
+                        stderr: execError.stderr ?? '',
+                        errors: [`Operation timed out after ${timeout}ms`],
+                    },
+                    errorCode: SFDMUErrorCodes.TIMEOUT,
+                    message: `SFDMU ${operation} timed out after ${timeout}ms`,
+                    metadata: {
+                        duration,
+                    },
+                };
+            }
+            // Handle execution failure
+            const exitCode = execError.code ?? 1;
+            const errors = SFDMUService.parseErrors(execError.stderr ?? '');
+            return {
+                success: false,
+                data: {
+                    exitCode: typeof exitCode === 'number' ? exitCode : 1,
+                    stdout: execError.stdout ?? '',
+                    stderr: execError.stderr ?? '',
+                    errors,
+                },
+                errorCode: SFDMUErrorCodes.EXECUTION_FAILED,
+                message: `SFDMU ${operation} failed with exit code ${exitCode}`,
+                metadata: {
+                    duration,
+                },
+            };
+        }
+    }
+}
+//# sourceMappingURL=SFDMUService.js.map

package/lib/services/SFDMUService.js.map

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

package/lib/services/TabDetectionService.d.ts

@@ -0,0 +1,105 @@
+import type { ServiceResult } from '../models/service-result.js';
+import type { IToolingApiAdapter } from '../adapters/tooling/tooling-api-adapter.js';
+/**
+ * Information about a Salesforce tab associated with an object.
+ */
+export type TabInfo = {
+    /** Salesforce ID of the tab */
+    id: string;
+    /** Name of the tab */
+    name: string;
+    /** API name of the associated SObject */
+    sobjectName: string;
+    /** Whether this is a custom tab */
+    isCustom: boolean;
+    /** Display label for the tab */
+    label: string;
+};
+/**
+ * Configuration for TabDetectionService.
+ */
+export type ITabDetectionServiceConfig = {
+    /** Tooling API adapter for querying tab definitions */
+    toolingAdapter: IToolingApiAdapter;
+    /** Optional logger for debug output */
+    logger?: Console;
+};
+/**
+ * Service for detecting which Salesforce objects have tabs.
+ *
+ * Uses the Tooling API to query TabDefinition records and provides
+ * methods for checking tab existence, retrieving tab information,
+ * and filtering object lists by tab availability.
+ *
+ * @design
+ * **API Choice**: Uses Tooling API (TabDefinition) rather than REST API
+ * because tab metadata is not exposed through standard REST endpoints.
+ * TabDefinition provides accurate tab-to-object mappings including custom tabs.
+ *
+ * @design
+ * **Query Strategy**: Single-object lookups use `queryTabByObject()` for
+ * efficiency (targeted query). Bulk operations use `getAllTabs()` and
+ * filter in memory to minimize API calls.
+ *
+ * @example
+ * ```typescript
+ * const service = new TabDetectionService({
+ *   toolingAdapter: myToolingAdapter,
+ *   logger: console,
+ * });
+ *
+ * // Check if an object has a tab
+ * const result = await service.hasTab('Account');
+ * if (result.success && result.data) {
+ *   console.log('Account has a tab');
+ * }
+ *
+ * // Filter a list of objects to only those with tabs
+ * const filtered = await service.filterObjectsWithTabs(['Account', 'Contact', 'Custom__c']);
+ * ```
+ */
+export declare class TabDetectionService {
+    private readonly toolingAdapter;
+    private readonly logger?;
+    /**
+     * Creates a new TabDetectionService.
+     *
+     * @param config - Service configuration with tooling adapter and optional logger
+     */
+    constructor(config: ITabDetectionServiceConfig);
+    /**
+     * Retrieves all tab definitions from the org, mapped to TabInfo objects.
+     *
+     * Only includes tabs that have a non-null, non-empty SobjectName (object tabs).
+     *
+     * @returns ServiceResult containing an array of TabInfo objects
+     */
+    getAllTabs(): Promise<ServiceResult<TabInfo[]>>;
+    /**
+     * Checks whether a specific object has a tab defined.
+     *
+     * Uses targeted query (queryTabByObject) for efficiency — only fetches
+     * the specific object's tab rather than all tabs in the org.
+     *
+     * @param objectName - The API name of the object to check
+     * @returns ServiceResult containing true if the object has a tab, false otherwise
+     */
+    hasTab(objectName: string): Promise<ServiceResult<boolean>>;
+    /**
+     * Retrieves tab information for a specific object.
+     *
+     * Uses targeted query (queryTabByObject) for efficiency — only fetches
+     * the specific object's tab rather than all tabs in the org.
+     *
+     * @param objectName - The API name of the object to look up
+     * @returns ServiceResult containing the TabInfo if found, or null if no tab exists
+     */
+    getTab(objectName: string): Promise<ServiceResult<TabInfo | null>>;
+    /**
+     * Filters a list of object names to only those that have tabs.
+     *
+     * @param objectNames - Array of object API names to check
+     * @returns ServiceResult containing the subset of object names that have tabs
+     */
+    filterObjectsWithTabs(objectNames: string[]): Promise<ServiceResult<string[]>>;
+}

package/lib/services/TabDetectionService.js

@@ -0,0 +1,206 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+import { createSuccessResult, createFailureResult } from '../models/service-result.js';
+import { ServiceErrorCodes } from '../adapters/errors.js';
+import { validateRequiredString, validateNonEmptyArray } from './validation.js';
+import { MAX_TAB_OBJECT_NAMES } from './constants.js';
+/**
+ * Service for detecting which Salesforce objects have tabs.
+ *
+ * Uses the Tooling API to query TabDefinition records and provides
+ * methods for checking tab existence, retrieving tab information,
+ * and filtering object lists by tab availability.
+ *
+ * @design
+ * **API Choice**: Uses Tooling API (TabDefinition) rather than REST API
+ * because tab metadata is not exposed through standard REST endpoints.
+ * TabDefinition provides accurate tab-to-object mappings including custom tabs.
+ *
+ * @design
+ * **Query Strategy**: Single-object lookups use `queryTabByObject()` for
+ * efficiency (targeted query). Bulk operations use `getAllTabs()` and
+ * filter in memory to minimize API calls.
+ *
+ * @example
+ * ```typescript
+ * const service = new TabDetectionService({
+ *   toolingAdapter: myToolingAdapter,
+ *   logger: console,
+ * });
+ *
+ * // Check if an object has a tab
+ * const result = await service.hasTab('Account');
+ * if (result.success && result.data) {
+ *   console.log('Account has a tab');
+ * }
+ *
+ * // Filter a list of objects to only those with tabs
+ * const filtered = await service.filterObjectsWithTabs(['Account', 'Contact', 'Custom__c']);
+ * ```
+ */
+export class TabDetectionService {
+    toolingAdapter;
+    logger;
+    /**
+     * Creates a new TabDetectionService.
+     *
+     * @param config - Service configuration with tooling adapter and optional logger
+     */
+    constructor(config) {
+        this.toolingAdapter = config.toolingAdapter;
+        this.logger = config.logger;
+    }
+    /**
+     * Retrieves all tab definitions from the org, mapped to TabInfo objects.
+     *
+     * Only includes tabs that have a non-null, non-empty SobjectName (object tabs).
+     *
+     * @returns ServiceResult containing an array of TabInfo objects
+     */
+    async getAllTabs() {
+        const startTime = Date.now();
+        const emptyResult = [];
+        try {
+            this.logger?.log('Querying all tab definitions');
+            const queryResult = await this.toolingAdapter.queryTabs();
+            if (!queryResult.success) {
+                return createFailureResult(emptyResult, ServiceErrorCodes.TAB_QUERY_FAILED, queryResult.message ?? 'Tab query failed', {
+                    metadata: { duration: Date.now() - startTime },
+                });
+            }
+            const tabs = queryResult.data
+                .filter((tab) => tab.SobjectName !== null && tab.SobjectName !== undefined && tab.SobjectName.trim().length > 0)
+                .map((tab) => ({
+                id: tab.Id,
+                name: tab.Name,
+                sobjectName: tab.SobjectName,
+                isCustom: tab.IsCustom,
+                // TabDefinition doesn't expose a separate label field; Name serves as display text
+                label: tab.Name,
+            }));
+            const duration = Date.now() - startTime;
+            this.logger?.log(`Found ${tabs.length} object tabs`);
+            return createSuccessResult(tabs, {
+                message: `Found ${tabs.length} object tabs`,
+                metadata: { duration },
+            });
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger?.log(`Tab query failed: ${errorMessage}`);
+            return createFailureResult(emptyResult, ServiceErrorCodes.TAB_QUERY_FAILED, errorMessage, {
+                metadata: { duration },
+            });
+        }
+    }
+    /**
+     * Checks whether a specific object has a tab defined.
+     *
+     * Uses targeted query (queryTabByObject) for efficiency — only fetches
+     * the specific object's tab rather than all tabs in the org.
+     *
+     * @param objectName - The API name of the object to check
+     * @returns ServiceResult containing true if the object has a tab, false otherwise
+     */
+    async hasTab(objectName) {
+        const startTime = Date.now();
+        const validationError = validateRequiredString(objectName, 'Object name');
+        if (validationError) {
+            return createFailureResult(false, ServiceErrorCodes.TAB_OBJECT_NAME_REQUIRED, validationError, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        // Use targeted query for efficiency (single object lookup)
+        const tabResult = await this.toolingAdapter.queryTabByObject(objectName);
+        if (!tabResult.success) {
+            return createFailureResult(false, ServiceErrorCodes.TAB_QUERY_FAILED, tabResult.message, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        const hasMatch = tabResult.data !== null;
+        const duration = Date.now() - startTime;
+        return createSuccessResult(hasMatch, {
+            message: hasMatch ? `Object '${objectName}' has a tab` : `Object '${objectName}' does not have a tab`,
+            metadata: { duration },
+        });
+    }
+    /**
+     * Retrieves tab information for a specific object.
+     *
+     * Uses targeted query (queryTabByObject) for efficiency — only fetches
+     * the specific object's tab rather than all tabs in the org.
+     *
+     * @param objectName - The API name of the object to look up
+     * @returns ServiceResult containing the TabInfo if found, or null if no tab exists
+     */
+    async getTab(objectName) {
+        const startTime = Date.now();
+        const validationError = validateRequiredString(objectName, 'Object name');
+        if (validationError) {
+            return createFailureResult(null, ServiceErrorCodes.TAB_OBJECT_NAME_REQUIRED, validationError, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        // Use targeted query for efficiency (single object lookup)
+        const tabResult = await this.toolingAdapter.queryTabByObject(objectName);
+        if (!tabResult.success) {
+            return createFailureResult(null, ServiceErrorCodes.TAB_QUERY_FAILED, tabResult.message, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        const duration = Date.now() - startTime;
+        if (tabResult.data === null) {
+            return createSuccessResult(null, {
+                message: `No tab found for '${objectName}'`,
+                metadata: { duration },
+            });
+        }
+        const tab = tabResult.data;
+        const tabInfo = {
+            id: tab.Id,
+            name: tab.Name,
+            sobjectName: tab.SobjectName,
+            isCustom: tab.IsCustom,
+            // TabDefinition doesn't expose a separate label field; Name serves as display text
+            label: tab.Name,
+        };
+        return createSuccessResult(tabInfo, {
+            message: `Found tab for '${objectName}'`,
+            metadata: { duration },
+        });
+    }
+    /**
+     * Filters a list of object names to only those that have tabs.
+     *
+     * @param objectNames - Array of object API names to check
+     * @returns ServiceResult containing the subset of object names that have tabs
+     */
+    async filterObjectsWithTabs(objectNames) {
+        const startTime = Date.now();
+        const validationError = validateNonEmptyArray(objectNames, 'Object names', MAX_TAB_OBJECT_NAMES);
+        if (validationError) {
+            return createFailureResult([], ServiceErrorCodes.TAB_INVALID_OBJECT_NAMES, validationError, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        const allTabsResult = await this.getAllTabs();
+        if (!allTabsResult.success) {
+            return createFailureResult([], allTabsResult.errorCode, allTabsResult.message, {
+                metadata: { duration: Date.now() - startTime },
+            });
+        }
+        const tabObjectNames = new Set(allTabsResult.data.map((tab) => tab.sobjectName));
+        const filtered = objectNames.filter((name) => tabObjectNames.has(name));
+        return createSuccessResult(filtered, {
+            message: `${filtered.length} of ${objectNames.length} objects have tabs`,
+            metadata: allTabsResult.metadata,
+        });
+    }
+}
+//# sourceMappingURL=TabDetectionService.js.map

package/lib/services/TabDetectionService.js.map

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