@peernova/cuneiform-sf 1.0.2 → 1.0.3-beta.0

package/lib/commands/cuneiform/definition/export.d.ts

@@ -0,0 +1,48 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+/**
+ * Command result type for JSON output.
+ */
+export type DefinitionExportResult = {
+    /** Whether the export was successful */
+    success: boolean;
+    /** Number of definitions exported */
+    definitionsExported: number;
+    /** Path to the output directory */
+    outputPath: string;
+    /** List of files created */
+    files: string[];
+    /** Error message if failed */
+    error?: string;
+};
+/**
+ * Exports profiling definitions to SFDMU-compatible CSV files.
+ *
+ * Use this command to:
+ * - Back up profiling definitions before major changes
+ * - Migrate definitions between environments (sandbox → production)
+ * - Version control profiling configuration in Git
+ * - Share definition templates across multiple orgs
+ *
+ * @example
+ * ```bash
+ * # Export all definitions from the target org
+ * sf cuneiform definition export --target-org myOrg
+ *
+ * # Export to a specific directory
+ * sf cuneiform definition export --target-org myOrg --output ./backup
+ *
+ * # Export with VCS-friendly mode (excludes Salesforce IDs)
+ * sf cuneiform definition export --target-org myOrg --exclude-ids
+ * ```
+ */
+export default class DefinitionExport extends SfCommand<DefinitionExportResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'exclude-ids': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<DefinitionExportResult>;
+}

package/lib/commands/cuneiform/definition/export.js

@@ -0,0 +1,97 @@
+/*
+ * 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
+ */
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { SFDMUService } from '../../../services/SFDMUService.js';
+import { DefinitionExportOperation } from '../../../operations/DefinitionExportOperation.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@peernova/cuneiform-sf', 'definition.export');
+/**
+ * Exports profiling definitions to SFDMU-compatible CSV files.
+ *
+ * Use this command to:
+ * - Back up profiling definitions before major changes
+ * - Migrate definitions between environments (sandbox → production)
+ * - Version control profiling configuration in Git
+ * - Share definition templates across multiple orgs
+ *
+ * @example
+ * ```bash
+ * # Export all definitions from the target org
+ * sf cuneiform definition export --target-org myOrg
+ *
+ * # Export to a specific directory
+ * sf cuneiform definition export --target-org myOrg --output ./backup
+ *
+ * # Export with VCS-friendly mode (excludes Salesforce IDs)
+ * sf cuneiform definition export --target-org myOrg --exclude-ids
+ * ```
+ */
+export default class DefinitionExport extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        'target-org': Flags.requiredOrg({
+            summary: messages.getMessage('flags.target-org.summary'),
+            char: 'o',
+            required: true,
+        }),
+        output: Flags.directory({
+            summary: messages.getMessage('flags.output.summary'),
+            char: 'd',
+            exists: false,
+        }),
+        'exclude-ids': Flags.boolean({
+            summary: messages.getMessage('flags.exclude-ids.summary'),
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(DefinitionExport);
+        const targetOrg = flags['target-org'].getUsername();
+        if (!targetOrg) {
+            this.error('Could not determine target org username');
+        }
+        // Initialize service and operation
+        const sfdmuService = new SFDMUService();
+        const exportOperation = new DefinitionExportOperation(sfdmuService);
+        // Display start message
+        this.log(`Exporting profiling definitions from ${targetOrg}...`);
+        // Execute export
+        const result = await exportOperation.execute({
+            targetOrg,
+            outputDir: flags.output,
+            excludeIds: flags['exclude-ids'],
+        });
+        if (!result.success) {
+            this.error(result.message ?? 'Export failed', { code: result.errorCode });
+        }
+        // Display success output
+        this.log('');
+        this.log('Export completed successfully!');
+        this.log(`  Definitions exported: ${result.data.definitionsExported}`);
+        this.log(`  Output directory: ${result.data.outputPath}`);
+        this.log('  Files created:');
+        for (const file of result.data.files) {
+            this.log(`    - ${file}`);
+        }
+        if (result.warnings && result.warnings.length > 0) {
+            this.log('');
+            this.warn('Warnings:');
+            for (const warning of result.warnings) {
+                this.warn(`  ${warning}`);
+            }
+        }
+        return {
+            success: true,
+            definitionsExported: result.data.definitionsExported,
+            outputPath: result.data.outputPath,
+            files: result.data.files,
+        };
+    }
+}
+//# sourceMappingURL=export.js.map

package/lib/commands/cuneiform/definition/export.js.map

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

package/lib/commands/cuneiform/definition/import.d.ts

@@ -0,0 +1,49 @@
+import { SfCommand } from '@salesforce/sf-plugins-core';
+/**
+ * Command result type for JSON output.
+ */
+export type DefinitionImportResult = {
+    /** Whether the import was successful */
+    success: boolean;
+    /** Number of definitions imported */
+    definitionsImported: number;
+    /** Source directory used */
+    sourceDir: string;
+    /** Whether this was a dry run */
+    dryRun: boolean;
+    /** Error message if failed */
+    error?: string;
+};
+/**
+ * Imports profiling definitions from SFDMU-compatible CSV files.
+ *
+ * Use this command to:
+ * - Restore definitions from backup
+ * - Migrate definitions to a new environment
+ * - Deploy standardized definition templates
+ * - Sync definitions across orgs
+ *
+ * @example
+ * ```bash
+ * # Import definitions from a backup directory
+ * sf cuneiform definition import --target-org myOrg --source ./backup
+ *
+ * # Import with upsert (update existing, insert new)
+ * sf cuneiform definition import --target-org myOrg --source ./backup --operation Upsert
+ *
+ * # Preview import (dry-run mode)
+ * sf cuneiform definition import --target-org myOrg --source ./backup --dry-run
+ * ```
+ */
+export default class DefinitionImport extends SfCommand<DefinitionImportResult> {
+    static readonly summary: string;
+    static readonly description: string;
+    static readonly examples: string[];
+    static readonly flags: {
+        'target-org': import("@oclif/core/interfaces").OptionFlag<import("@salesforce/core").Org, import("@oclif/core/interfaces").CustomOptions>;
+        source: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        operation: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<DefinitionImportResult>;
+}

package/lib/commands/cuneiform/definition/import.js

@@ -0,0 +1,107 @@
+/*
+ * 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
+ */
+import { SfCommand, Flags } from '@salesforce/sf-plugins-core';
+import { Messages } from '@salesforce/core';
+import { SFDMUService } from '../../../services/SFDMUService.js';
+import { DefinitionImportOperation } from '../../../operations/DefinitionImportOperation.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@peernova/cuneiform-sf', 'definition.import');
+/**
+ * Imports profiling definitions from SFDMU-compatible CSV files.
+ *
+ * Use this command to:
+ * - Restore definitions from backup
+ * - Migrate definitions to a new environment
+ * - Deploy standardized definition templates
+ * - Sync definitions across orgs
+ *
+ * @example
+ * ```bash
+ * # Import definitions from a backup directory
+ * sf cuneiform definition import --target-org myOrg --source ./backup
+ *
+ * # Import with upsert (update existing, insert new)
+ * sf cuneiform definition import --target-org myOrg --source ./backup --operation Upsert
+ *
+ * # Preview import (dry-run mode)
+ * sf cuneiform definition import --target-org myOrg --source ./backup --dry-run
+ * ```
+ */
+export default class DefinitionImport extends SfCommand {
+    static summary = messages.getMessage('summary');
+    static description = messages.getMessage('description');
+    static examples = messages.getMessages('examples');
+    static flags = {
+        'target-org': Flags.requiredOrg({
+            summary: messages.getMessage('flags.target-org.summary'),
+            char: 'o',
+            required: true,
+        }),
+        source: Flags.directory({
+            summary: messages.getMessage('flags.source.summary'),
+            char: 's',
+            required: true,
+            exists: true,
+        }),
+        operation: Flags.string({
+            summary: messages.getMessage('flags.operation.summary'),
+            options: ['Insert', 'Upsert'],
+            default: 'Insert',
+        }),
+        'dry-run': Flags.boolean({
+            summary: messages.getMessage('flags.dry-run.summary'),
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(DefinitionImport);
+        const targetOrg = flags['target-org'].getUsername();
+        if (!targetOrg) {
+            this.error('Could not determine target org username');
+        }
+        // Initialize service and operation
+        const sfdmuService = new SFDMUService();
+        const importOperation = new DefinitionImportOperation(sfdmuService);
+        // Display start message
+        const dryRunLabel = flags['dry-run'] ? ' (DRY RUN)' : '';
+        this.log(`Importing profiling definitions to ${targetOrg}${dryRunLabel}...`);
+        this.log(`  Source: ${flags.source}`);
+        this.log(`  Operation: ${flags.operation}`);
+        // Execute import
+        const result = await importOperation.execute({
+            targetOrg,
+            sourceDir: flags.source,
+            operation: flags.operation,
+            dryRun: flags['dry-run'],
+        });
+        if (!result.success) {
+            this.error(result.message ?? 'Import failed', { code: result.errorCode });
+        }
+        // Display success output
+        this.log('');
+        if (flags['dry-run']) {
+            this.log('Dry run completed - no changes were made.');
+        }
+        else {
+            this.log('Import completed successfully!');
+        }
+        this.log(`  Definitions imported: ${result.data.definitionsImported}`);
+        if (result.warnings && result.warnings.length > 0) {
+            this.log('');
+            this.warn('Warnings:');
+            for (const warning of result.warnings) {
+                this.warn(`  ${warning}`);
+            }
+        }
+        return {
+            success: true,
+            definitionsImported: result.data.definitionsImported,
+            sourceDir: result.data.sourceDir,
+            dryRun: result.data.dryRun,
+        };
+    }
+}
+//# sourceMappingURL=import.js.map

package/lib/commands/cuneiform/definition/import.js.map

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

package/lib/models/sfdmu-types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Options for SFDMU execution operations.
+ */
+export type ISFDMUOptions = {
+    /** Source org username or alias for export operations */
+    sourceOrg?: string;
+    /** Target org username or alias for import operations */
+    targetOrg?: string;
+    /** Path to the export.json configuration file */
+    configPath: string;
+    /** Whether to use Bulk API for operations (default: true) */
+    useBulkAPI?: boolean;
+    /** Execution timeout in milliseconds (default: 300000 = 5 minutes) */
+    timeout?: number;
+    /** Maximum buffer size in bytes for stdout/stderr (default: 10MB) */
+    maxBuffer?: number;
+};
+/**
+ * Raw result from SFDMU CLI execution.
+ */
+export type ISFDMUResult = {
+    /** Exit code from the SFDMU process (0 = success) */
+    exitCode: number;
+    /** Standard output from SFDMU */
+    stdout: string;
+    /** Standard error from SFDMU */
+    stderr: string;
+    /** Number of records processed (parsed from stdout) */
+    recordsProcessed?: number;
+    /** Error messages extracted from the output */
+    errors?: string[];
+};
+/**
+ * Generic service result wrapper following CLAUDE.md ServiceResult pattern.
+ * All service methods should return this type for consistent handling.
+ */
+export type ServiceResult<T> = {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** The operation result data */
+    data: T;
+    /** Error code for categorizing failures (see error code ranges in CLAUDE.md) */
+    errorCode?: string;
+    /** Human-readable message (error or success) */
+    message?: string;
+    /** Non-fatal warnings encountered during execution */
+    warnings?: string[];
+    /** Additional metadata about the operation */
+    metadata?: {
+        /** Time taken for the operation in milliseconds */
+        duration?: number;
+        /** Strategy used (if multiple available) */
+        strategyUsed?: string;
+        /** Whether a fallback was used */
+        fallbackUsed?: boolean;
+    };
+};
+/**
+ * SFDMU-specific error codes (5000 range for system/internal errors).
+ */
+export declare const SFDMUErrorCodes: {
+    /** SFDMU plugin is not installed */
+    readonly NOT_INSTALLED: "SFDMU_NOT_INSTALLED";
+    /** SFDMU execution timed out */
+    readonly TIMEOUT: "SFDMU_TIMEOUT";
+    /** SFDMU execution failed with non-zero exit code */
+    readonly EXECUTION_FAILED: "SFDMU_EXECUTION_FAILED";
+    /** Invalid configuration file path */
+    readonly CONFIG_INVALID: "SFDMU_CONFIG_INVALID";
+};
+/**
+ * Type alias for SFDMU error code values.
+ */
+export type SFDMUErrorCode = (typeof SFDMUErrorCodes)[keyof typeof SFDMUErrorCodes];

package/lib/models/sfdmu-types.js

@@ -0,0 +1,19 @@
+/*
+ * 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
+ */
+/**
+ * SFDMU-specific error codes (5000 range for system/internal errors).
+ */
+export const SFDMUErrorCodes = {
+    /** SFDMU plugin is not installed */
+    NOT_INSTALLED: 'SFDMU_NOT_INSTALLED',
+    /** SFDMU execution timed out */
+    TIMEOUT: 'SFDMU_TIMEOUT',
+    /** SFDMU execution failed with non-zero exit code */
+    EXECUTION_FAILED: 'SFDMU_EXECUTION_FAILED',
+    /** Invalid configuration file path */
+    CONFIG_INVALID: 'SFDMU_CONFIG_INVALID',
+};
+//# sourceMappingURL=sfdmu-types.js.map

package/lib/models/sfdmu-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfdmu-types.js","sourceRoot":"","sources":["../../src/models/sfdmu-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4EH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,oCAAoC;IACpC,aAAa,EAAE,qBAAqB;IACpC,gCAAgC;IAChC,OAAO,EAAE,eAAe;IACxB,qDAAqD;IACrD,gBAAgB,EAAE,wBAAwB;IAC1C,sCAAsC;IACtC,cAAc,EAAE,sBAAsB;CAC9B,CAAC"}

package/lib/operations/DefinitionExportOperation.d.ts

@@ -0,0 +1,92 @@
+import { type ServiceResult } from '../models/sfdmu-types.js';
+import { SFDMUService } from '../services/SFDMUService.js';
+/**
+ * Options for the definition export operation.
+ */
+export type ExportOptions = {
+    /** Target org username or alias to export from */
+    targetOrg: string;
+    /** Output directory path (defaults to ./data/exports/definitions/{timestamp}) */
+    outputDir?: string;
+    /** Exclude Salesforce IDs for VCS-friendly output */
+    excludeIds?: boolean;
+    /** Optional logger for debug output */
+    logger?: Console;
+};
+/**
+ * Result of a definition export operation.
+ */
+export type ExportResult = {
+    /** Number of definitions exported */
+    definitionsExported: number;
+    /** Path to the output directory */
+    outputPath: string;
+    /** List of files created */
+    files: string[];
+    /** Raw SFDMU output for debugging */
+    sfdmuOutput?: string;
+};
+/**
+ * Error codes specific to export operations.
+ */
+export declare const ExportErrorCodes: {
+    /** Output directory already exists */
+    readonly OUTPUT_DIR_EXISTS: "EXPORT_OUTPUT_DIR_EXISTS";
+    /** No definitions found in org */
+    readonly NO_DEFINITIONS_FOUND: "EXPORT_NO_DEFINITIONS_FOUND";
+    /** Failed to create output directory */
+    readonly DIR_CREATION_FAILED: "EXPORT_DIR_CREATION_FAILED";
+    /** Failed to write config file */
+    readonly CONFIG_WRITE_FAILED: "EXPORT_CONFIG_WRITE_FAILED";
+};
+/**
+ * Orchestrates the export 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 DefinitionExportOperation(sfdmuService);
+ * const result = await operation.execute({
+ *   targetOrg: 'myOrg',
+ *   outputDir: './exports',
+ *   excludeIds: true
+ * });
+ * ```
+ */
+export declare class DefinitionExportOperation {
+    /** Default base path for exports */
+    private static readonly DEFAULT_EXPORT_BASE;
+    /** SFDMU query for profiling definitions */
+    private static readonly DEFINITION_QUERY;
+    private readonly sfdmuService;
+    private readonly logger?;
+    /**
+     * Creates a new DefinitionExportOperation.
+     *
+     * @param sfdmuService - The SFDMU service instance for executing operations
+     * @param logger - Optional logger for debug output
+     */
+    constructor(sfdmuService: SFDMUService, logger?: Console);
+    /**
+     * Resolves the output path, generating a timestamped directory if needed.
+     */
+    private static resolveOutputPath;
+    /**
+     * Builds the SFDMU export configuration.
+     */
+    private static buildSFDMUConfig;
+    /**
+     * Collects the list of files created by SFDMU export.
+     */
+    private static collectExportedFiles;
+    /**
+     * Executes the export operation.
+     *
+     * @param options - Export options
+     * @returns ServiceResult containing export results or error details
+     */
+    execute(options: ExportOptions): Promise<ServiceResult<ExportResult>>;
+}