@salesforce/b2c-tooling-sdk 1.10.0 → 1.11.0

package/dist/cjs/scaffold/executor.js

@@ -1,293 +0,0 @@
-/*
- * Copyright (c) 2025, Salesforce, Inc.
- * SPDX-License-Identifier: Apache-2
- * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
- */
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { glob } from 'glob';
-import { ScaffoldEngine } from './engine.js';
-import { evaluateCondition, validateParameters } from './validators.js';
-import { mergeJson, createPath, insertAfter, insertBefore, appendContent, prependContent } from './merge.js';
-/**
- * Resolve output directory with priority:
- * 1. Explicit outputDir option
- * 2. Scaffold's defaultOutputDir
- * 3. Project root / cwd
- *
- * @param options - Resolution options
- * @returns Resolved absolute output directory path
- */
-export function resolveOutputDirectory(options) {
-    const { outputDir, scaffold, projectRoot = process.cwd() } = options;
-    if (outputDir) {
-        // Explicit output directory takes priority
-        return path.resolve(projectRoot, outputDir);
-    }
-    if (scaffold?.manifest.defaultOutputDir) {
-        // Scaffold's default output directory
-        return path.resolve(projectRoot, scaffold.manifest.defaultOutputDir);
-    }
-    // Fall back to project root
-    return projectRoot;
-}
-/**
- * Check if a file exists
- */
-async function fileExists(filePath) {
-    try {
-        await fs.access(filePath);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Get default file mappings by scanning the files/ directory
- */
-async function getDefaultFileMappings(filesPath) {
-    const files = await glob('**/*', {
-        cwd: filesPath,
-        nodir: true,
-        dot: true,
-    });
-    return files.map((file) => ({
-        template: file,
-        destination: file.replace(/\.ejs$/, ''),
-    }));
-}
-/**
- * Generate files from a scaffold
- * @param scaffold - The scaffold to use
- * @param options - Generation options
- * @returns Generation result
- */
-export async function generateFromScaffold(scaffold, options = {}) {
-    const outputDir = options.outputDir || process.cwd();
-    const variables = options.variables || {};
-    const dryRun = options.dryRun ?? false;
-    const force = options.force ?? false;
-    // Validate parameters
-    const validationResult = validateParameters(scaffold.manifest, variables);
-    if (!validationResult.valid) {
-        const errorMessages = validationResult.errors.map((e) => `${e.parameter}: ${e.message}`).join(', ');
-        throw new Error(`Invalid parameters: ${errorMessages}`);
-    }
-    // Create template engine with resolved variables
-    const engine = new ScaffoldEngine(validationResult.values);
-    // Get file mappings
-    const fileMappings = scaffold.manifest.files || (await getDefaultFileMappings(scaffold.filesPath));
-    const generatedFiles = [];
-    const createdDirs = new Set();
-    for (const mapping of fileMappings) {
-        // Check condition
-        if (mapping.condition && !evaluateCondition(mapping.condition, validationResult.values)) {
-            continue;
-        }
-        const templatePath = path.join(scaffold.filesPath, mapping.template);
-        const destRendered = engine.renderPath(mapping.destination);
-        // If destination is absolute path, use it directly; otherwise join with outputDir
-        const destAbsolute = path.isAbsolute(destRendered) ? destRendered : path.join(outputDir, destRendered);
-        // For display purposes, show path relative to outputDir
-        const destRelative = path.relative(outputDir, destAbsolute) || destAbsolute;
-        // Check if destination exists
-        const exists = await fileExists(destAbsolute);
-        const overwrite = mapping.overwrite || 'never';
-        if (exists) {
-            if (overwrite === 'never' && !force) {
-                generatedFiles.push({
-                    path: destRelative,
-                    absolutePath: destAbsolute,
-                    action: 'skipped',
-                    skipReason: 'File already exists',
-                });
-                continue;
-            }
-            if (overwrite === 'prompt' && !force) {
-                // In non-interactive mode without force, skip
-                generatedFiles.push({
-                    path: destRelative,
-                    absolutePath: destAbsolute,
-                    action: 'skipped',
-                    skipReason: 'File already exists (prompt required)',
-                });
-                continue;
-            }
-        }
-        // Read and render template
-        let content;
-        try {
-            const templateContent = await fs.readFile(templatePath, 'utf-8');
-            // Only render EJS if the file has .ejs extension
-            if (mapping.template.endsWith('.ejs')) {
-                content = engine.render(templateContent);
-            }
-            else {
-                content = templateContent;
-            }
-        }
-        catch (error) {
-            throw new Error(`Failed to read template ${mapping.template}: ${error.message}`);
-        }
-        if (!dryRun) {
-            // Create parent directories
-            const destDir = path.dirname(destAbsolute);
-            if (!createdDirs.has(destDir)) {
-                await fs.mkdir(destDir, { recursive: true });
-                createdDirs.add(destDir);
-            }
-            // Write file
-            await fs.writeFile(destAbsolute, content, 'utf-8');
-        }
-        generatedFiles.push({
-            path: destRelative,
-            absolutePath: destAbsolute,
-            action: exists ? 'overwritten' : 'created',
-        });
-    }
-    // Process file modifications
-    if (scaffold.manifest.modifications) {
-        for (const modification of scaffold.manifest.modifications) {
-            // Check condition
-            if (modification.condition && !evaluateCondition(modification.condition, validationResult.values)) {
-                continue;
-            }
-            const targetRendered = engine.renderPath(modification.target);
-            const targetAbsolute = path.isAbsolute(targetRendered) ? targetRendered : path.join(outputDir, targetRendered);
-            const targetRelative = path.relative(outputDir, targetAbsolute) || targetAbsolute;
-            // Get modification content
-            let modContent;
-            if (modification.contentTemplate) {
-                const templatePath = path.join(scaffold.filesPath, modification.contentTemplate);
-                try {
-                    const templateContent = await fs.readFile(templatePath, 'utf-8');
-                    modContent = modification.contentTemplate.endsWith('.ejs') ? engine.render(templateContent) : templateContent;
-                }
-                catch (error) {
-                    throw new Error(`Failed to read modification template ${modification.contentTemplate}: ${error.message}`);
-                }
-            }
-            else if (modification.content) {
-                modContent = engine.render(modification.content);
-            }
-            else {
-                throw new Error(`Modification for ${modification.target} must have content or contentTemplate`);
-            }
-            // Process the modification
-            const result = await processModification(modification, targetAbsolute, targetRelative, modContent, dryRun);
-            generatedFiles.push(result);
-        }
-    }
-    // Render post-instructions if present
-    let postInstructions;
-    if (scaffold.manifest.postInstructions) {
-        postInstructions = engine.render(scaffold.manifest.postInstructions);
-    }
-    return {
-        scaffold,
-        files: generatedFiles,
-        postInstructions,
-        dryRun,
-        outputDir,
-    };
-}
-/**
- * Process a single file modification
- */
-async function processModification(modification, targetAbsolute, targetRelative, content, dryRun) {
-    const exists = await fileExists(targetAbsolute);
-    // For modifications, the file should exist (except for json-merge which can create)
-    if (!exists && modification.type !== 'json-merge') {
-        return {
-            path: targetRelative,
-            absolutePath: targetAbsolute,
-            action: 'skipped',
-            skipReason: `Target file does not exist for ${modification.type}`,
-        };
-    }
-    let existingContent = '';
-    if (exists) {
-        existingContent = await fs.readFile(targetAbsolute, 'utf-8');
-    }
-    let newContent;
-    try {
-        switch (modification.type) {
-            case 'json-merge': {
-                if (!exists) {
-                    // Create new JSON file, wrapping content in jsonPath structure if specified
-                    if (modification.jsonPath) {
-                        const wrapper = {};
-                        const [parent, key] = createPath(wrapper, modification.jsonPath);
-                        parent[key] = JSON.parse(content);
-                        newContent = JSON.stringify(wrapper, null, 2);
-                    }
-                    else {
-                        newContent = JSON.stringify(JSON.parse(content), null, 2);
-                    }
-                }
-                else {
-                    newContent = mergeJson(existingContent, content, {
-                        jsonPath: modification.jsonPath,
-                        createPath: true,
-                    });
-                }
-                break;
-            }
-            case 'insert-after': {
-                if (!modification.marker) {
-                    throw new Error('insert-after requires a marker');
-                }
-                newContent = insertAfter(existingContent, content, modification.marker);
-                break;
-            }
-            case 'insert-before': {
-                if (!modification.marker) {
-                    throw new Error('insert-before requires a marker');
-                }
-                newContent = insertBefore(existingContent, content, modification.marker);
-                break;
-            }
-            case 'append': {
-                newContent = appendContent(existingContent, content);
-                break;
-            }
-            case 'prepend': {
-                newContent = prependContent(existingContent, content);
-                break;
-            }
-            default: {
-                throw new Error(`Unknown modification type: ${modification.type}`);
-            }
-        }
-    }
-    catch (error) {
-        return {
-            path: targetRelative,
-            absolutePath: targetAbsolute,
-            action: 'skipped',
-            skipReason: `Modification failed: ${error.message}`,
-        };
-    }
-    if (!dryRun) {
-        // Create parent directories if needed
-        const targetDir = path.dirname(targetAbsolute);
-        await fs.mkdir(targetDir, { recursive: true });
-        await fs.writeFile(targetAbsolute, newContent, 'utf-8');
-    }
-    return {
-        path: targetRelative,
-        absolutePath: targetAbsolute,
-        action: exists ? 'merged' : 'created',
-    };
-}
-/**
- * Preview scaffold generation without writing files
- * @param scaffold - The scaffold to preview
- * @param options - Generation options
- * @returns Preview result
- */
-export async function previewScaffold(scaffold, options = {}) {
-    return generateFromScaffold(scaffold, { ...options, dryRun: true });
-}
-//# sourceMappingURL=executor.js.map

package/dist/cjs/scaffold/executor.js.map

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

package/dist/cjs/scaffold/index.d.ts

@@ -1,76 +0,0 @@
-/**
- * Scaffold generation for B2C Commerce projects.
- *
- * This module provides functions for discovering, validating, and executing
- * project scaffolds (templates) for cartridges, custom APIs, Page Designer
- * components, jobs, and other B2C artifacts.
- *
- * ## Scaffold Discovery
- *
- * Scaffolds are discovered from multiple sources in priority order:
- *
- * 1. **Project scaffolds** (`.b2c/scaffolds/`) - highest priority
- * 2. **Plugin scaffolds** (via `b2c:scaffold-providers` hook)
- * 3. **User scaffolds** (`~/.b2c/scaffolds/`)
- * 4. **Built-in scaffolds** - lowest priority
- *
- * Later sources override earlier ones by name.
- *
- * - {@link ScaffoldRegistry} - Registry for managing scaffold discovery
- * - {@link createScaffoldRegistry} - Create a new registry instance
- *
- * ## Scaffold Generation
- *
- * - {@link generateFromScaffold} - Generate files from a scaffold
- * - {@link previewScaffold} - Preview generation without writing files
- *
- * ## Template Engine
- *
- * - {@link ScaffoldEngine} - EJS-based template rendering engine
- *
- * ## Validation
- *
- * - {@link validateScaffoldManifest} - Validate a scaffold manifest
- * - {@link validateParameters} - Validate parameter values
- *
- * ## Usage
- *
- * ```typescript
- * import {
- *   createScaffoldRegistry,
- *   generateFromScaffold,
- * } from '@salesforce/b2c-tooling-sdk/scaffold';
- *
- * // Create registry and find scaffolds
- * const registry = createScaffoldRegistry();
- * const scaffolds = await registry.getScaffolds();
- *
- * // Get a specific scaffold
- * const cartridgeScaffold = await registry.getScaffold('cartridge');
- *
- * // Generate files
- * const result = await generateFromScaffold(cartridgeScaffold, {
- *   outputDir: './output',
- *   variables: { cartridgeName: 'app_custom' },
- * });
- * ```
- *
- * @module scaffold
- */
-export type { ScaffoldManifest, ScaffoldParameter, ScaffoldChoice, ScaffoldParameterType, ScaffoldCategory, DynamicParameterSource, FileMapping, FileModification, OverwriteBehavior, Scaffold, ScaffoldSource, ScaffoldDiscoveryOptions, ScaffoldProvider, ScaffoldProviderPriority, ScaffoldTransformer, ScaffoldContext, ScaffoldGenerateOptions, ScaffoldGenerateResult, GeneratedFile, ParameterValidationError, ParameterValidationResult, TemplateHelpers, SourceResult, } from './types.js';
-export { SCAFFOLDS_DATA_DIR } from './types.js';
-export { HOOK_POINTS, resolveLocalSource, resolveRemoteSource, isRemoteSource, validateAgainstSource, cartridgePathForDestination, detectSourceFromPath, } from './sources.js';
-export type { SourceDetectionResult } from './sources.js';
-export { ScaffoldRegistry, createScaffoldRegistry } from './registry.js';
-export type { ScaffoldRegistryOptions } from './registry.js';
-export { ScaffoldEngine, createTemplateContext, createTemplateHelpers, renderTemplate, renderPathTemplate, kebabCase, camelCase, pascalCase, snakeCase, } from './engine.js';
-export type { TemplateContext } from './engine.js';
-export { generateFromScaffold, previewScaffold, resolveOutputDirectory } from './executor.js';
-export type { ResolveOutputDirectoryOptions } from './executor.js';
-export { validateScaffoldManifest, validateParameters, evaluateCondition, isValidScaffoldName, isValidParameterName, } from './validators.js';
-export { mergeJson, insertAfter, insertBefore, appendContent, prependContent } from './merge.js';
-export type { JsonMergeOptions, TextInsertOptions } from './merge.js';
-export { resolveScaffoldParameters, parseParameterOptions, getParameterSchemas } from './parameter-resolver.js';
-export type { ResolveParametersOptions, ParameterResolutionError, ResolvedParameters, ResolvedParameterSchema, } from './parameter-resolver.js';
-export { validateEjsSyntax, checkTemplateFiles, checkOrphanedFiles, validateScaffoldDirectory } from './validation.js';
-export type { ValidationIssueSeverity, ValidationIssue, ValidationResult, ValidateScaffoldOptions, } from './validation.js';

package/dist/cjs/scaffold/index.js

@@ -1,23 +0,0 @@
-/*
- * Copyright (c) 2025, Salesforce, Inc.
- * SPDX-License-Identifier: Apache-2
- * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
- */
-export { SCAFFOLDS_DATA_DIR } from './types.js';
-// Source resolution
-export { HOOK_POINTS, resolveLocalSource, resolveRemoteSource, isRemoteSource, validateAgainstSource, cartridgePathForDestination, detectSourceFromPath, } from './sources.js';
-// Registry
-export { ScaffoldRegistry, createScaffoldRegistry } from './registry.js';
-// Engine
-export { ScaffoldEngine, createTemplateContext, createTemplateHelpers, renderTemplate, renderPathTemplate, kebabCase, camelCase, pascalCase, snakeCase, } from './engine.js';
-// Executor
-export { generateFromScaffold, previewScaffold, resolveOutputDirectory } from './executor.js';
-// Validators
-export { validateScaffoldManifest, validateParameters, evaluateCondition, isValidScaffoldName, isValidParameterName, } from './validators.js';
-// Merge utilities
-export { mergeJson, insertAfter, insertBefore, appendContent, prependContent } from './merge.js';
-// Parameter resolution
-export { resolveScaffoldParameters, parseParameterOptions, getParameterSchemas } from './parameter-resolver.js';
-// Validation
-export { validateEjsSyntax, checkTemplateFiles, checkOrphanedFiles, validateScaffoldDirectory } from './validation.js';
-//# sourceMappingURL=index.js.map

package/dist/cjs/scaffold/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scaffold/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyFH,OAAO,EAAC,kBAAkB,EAAC,MAAM,YAAY,CAAC;AAE9C,oBAAoB;AACpB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAGtB,WAAW;AACX,OAAO,EAAC,gBAAgB,EAAE,sBAAsB,EAAC,MAAM,eAAe,CAAC;AAGvE,SAAS;AACT,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,GACV,MAAM,aAAa,CAAC;AAGrB,WAAW;AACX,OAAO,EAAC,oBAAoB,EAAE,eAAe,EAAE,sBAAsB,EAAC,MAAM,eAAe,CAAC;AAG5F,aAAa;AACb,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,kBAAkB;AAClB,OAAO,EAAC,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAC,MAAM,YAAY,CAAC;AAG/F,uBAAuB;AACvB,OAAO,EAAC,yBAAyB,EAAE,qBAAqB,EAAE,mBAAmB,EAAC,MAAM,yBAAyB,CAAC;AAQ9G,aAAa;AACb,OAAO,EAAC,iBAAiB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,yBAAyB,EAAC,MAAM,iBAAiB,CAAC"}

package/dist/cjs/scaffold/merge.d.ts

@@ -1,63 +0,0 @@
-/**
- * Options for JSON merge operations
- */
-export interface JsonMergeOptions {
-    /** JSON path to the target location (e.g., "scripts", "hooks.dw.ocapi") */
-    jsonPath?: string;
-    /** Whether to create the path if it doesn't exist */
-    createPath?: boolean;
-}
-/**
- * Create a nested path in an object
- * @param obj - The object to modify
- * @param path - Dot-separated path to create
- * @returns The parent object of the final key
- */
-export declare function createPath(obj: Record<string, unknown>, path: string): [Record<string, unknown>, string];
-/**
- * Merge JSON content into an existing JSON string
- * @param existingJson - The existing JSON string
- * @param newContent - JSON content to merge (string or object)
- * @param options - Merge options
- * @returns Updated JSON string
- */
-export declare function mergeJson(existingJson: string, newContent: string | Record<string, unknown>, options?: JsonMergeOptions): string;
-/**
- * Options for text insertion operations
- */
-export interface TextInsertOptions {
-    /** Marker string to find for insert-after/insert-before */
-    marker?: string;
-    /** Whether to add a newline after the inserted content */
-    addNewline?: boolean;
-}
-/**
- * Insert text after a marker in existing content
- * @param existingContent - The existing text content
- * @param newContent - Content to insert
- * @param marker - Marker string to find
- * @returns Updated content
- */
-export declare function insertAfter(existingContent: string, newContent: string, marker: string): string;
-/**
- * Insert text before a marker in existing content
- * @param existingContent - The existing text content
- * @param newContent - Content to insert
- * @param marker - Marker string to find
- * @returns Updated content
- */
-export declare function insertBefore(existingContent: string, newContent: string, marker: string): string;
-/**
- * Append content to the end of existing content
- * @param existingContent - The existing text content
- * @param newContent - Content to append
- * @returns Updated content
- */
-export declare function appendContent(existingContent: string, newContent: string): string;
-/**
- * Prepend content to the beginning of existing content
- * @param existingContent - The existing text content
- * @param newContent - Content to prepend
- * @returns Updated content
- */
-export declare function prependContent(existingContent: string, newContent: string): string;

package/dist/cjs/scaffold/merge.js

@@ -1,192 +0,0 @@
-/*
- * Copyright (c) 2025, Salesforce, Inc.
- * SPDX-License-Identifier: Apache-2
- * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
- */
-/**
- * Navigate to a nested JSON path and return parent + key
- * @param obj - The object to navigate
- * @param path - Dot-separated path (e.g., "hooks.dw.ocapi")
- * @returns Tuple of [parent object, final key, success]
- */
-function navigateToPath(obj, path) {
-    if (!path) {
-        return [null, '', false];
-    }
-    const parts = path.split('.');
-    const finalKey = parts.pop();
-    let current = obj;
-    for (const part of parts) {
-        if (current === null || typeof current !== 'object') {
-            return [null, finalKey, false];
-        }
-        if (!(part in current)) {
-            return [null, finalKey, false];
-        }
-        current = current[part];
-    }
-    if (current === null || typeof current !== 'object') {
-        return [null, finalKey, false];
-    }
-    return [current, finalKey, true];
-}
-/**
- * Create a nested path in an object
- * @param obj - The object to modify
- * @param path - Dot-separated path to create
- * @returns The parent object of the final key
- */
-export function createPath(obj, path) {
-    const parts = path.split('.');
-    const finalKey = parts.pop();
-    let current = obj;
-    for (const part of parts) {
-        if (!(part in current) || typeof current[part] !== 'object' || current[part] === null) {
-            current[part] = {};
-        }
-        current = current[part];
-    }
-    return [current, finalKey];
-}
-/**
- * Deep merge two objects, with source overriding target for conflicts
- */
-function deepMerge(target, source) {
-    if (Array.isArray(source)) {
-        if (Array.isArray(target)) {
-            // Merge arrays by appending source items not already in target
-            const result = [...target];
-            for (const item of source) {
-                const itemStr = JSON.stringify(item);
-                const exists = result.some((existing) => JSON.stringify(existing) === itemStr);
-                if (!exists) {
-                    result.push(item);
-                }
-            }
-            return result;
-        }
-        return source;
-    }
-    if (source !== null && typeof source === 'object') {
-        if (target !== null && typeof target === 'object' && !Array.isArray(target)) {
-            const result = { ...target };
-            for (const key of Object.keys(source)) {
-                result[key] = deepMerge(result[key], source[key]);
-            }
-            return result;
-        }
-        return source;
-    }
-    return source;
-}
-/**
- * Merge JSON content into an existing JSON string
- * @param existingJson - The existing JSON string
- * @param newContent - JSON content to merge (string or object)
- * @param options - Merge options
- * @returns Updated JSON string
- */
-export function mergeJson(existingJson, newContent, options = {}) {
-    let existing = JSON.parse(existingJson);
-    const content = typeof newContent === 'string' ? JSON.parse(newContent) : newContent;
-    if (options.jsonPath) {
-        // If existing content is a bare array but we expected an object with jsonPath,
-        // wrap it in the expected structure so the merge works correctly.
-        // This handles files that were previously created without the jsonPath wrapper.
-        if (Array.isArray(existing)) {
-            const wrapper = {};
-            const [newParent, newKey] = createPath(wrapper, options.jsonPath);
-            newParent[newKey] = existing;
-            existing = wrapper;
-        }
-        const [parent, key, found] = navigateToPath(existing, options.jsonPath);
-        if (!found) {
-            if (options.createPath !== false) {
-                const [newParent, newKey] = createPath(existing, options.jsonPath);
-                newParent[newKey] = content;
-            }
-            else {
-                throw new Error(`JSON path not found: ${options.jsonPath}`);
-            }
-        }
-        else if (parent) {
-            parent[key] = deepMerge(parent[key], content);
-        }
-    }
-    else {
-        // Merge at root level
-        const merged = deepMerge(existing, content);
-        return JSON.stringify(merged, null, 2);
-    }
-    return JSON.stringify(existing, null, 2);
-}
-/**
- * Insert text after a marker in existing content
- * @param existingContent - The existing text content
- * @param newContent - Content to insert
- * @param marker - Marker string to find
- * @returns Updated content
- */
-export function insertAfter(existingContent, newContent, marker) {
-    const index = existingContent.indexOf(marker);
-    if (index === -1) {
-        throw new Error(`Marker not found: ${marker}`);
-    }
-    let insertPoint = index + marker.length;
-    // If there's a newline right after the marker, insert after it
-    if (existingContent[insertPoint] === '\n') {
-        insertPoint++;
-    }
-    // Check if we need to add a newline before the new content
-    const needsNewlineBefore = insertPoint > 0 && existingContent[insertPoint - 1] !== '\n' && !newContent.startsWith('\n');
-    // Check if we need to add a newline after the new content
-    const needsNewlineAfter = !newContent.endsWith('\n') && insertPoint < existingContent.length && existingContent[insertPoint] !== '\n';
-    return (existingContent.slice(0, insertPoint) +
-        (needsNewlineBefore ? '\n' : '') +
-        newContent +
-        (needsNewlineAfter ? '\n' : '') +
-        existingContent.slice(insertPoint));
-}
-/**
- * Insert text before a marker in existing content
- * @param existingContent - The existing text content
- * @param newContent - Content to insert
- * @param marker - Marker string to find
- * @returns Updated content
- */
-export function insertBefore(existingContent, newContent, marker) {
-    const index = existingContent.indexOf(marker);
-    if (index === -1) {
-        throw new Error(`Marker not found: ${marker}`);
-    }
-    // Check if we need to add a newline before the new content
-    const needsNewlineBefore = index > 0 && existingContent[index - 1] !== '\n' && !newContent.startsWith('\n');
-    // Check if we need to add a newline after the new content (before marker)
-    const needsNewlineAfter = !newContent.endsWith('\n');
-    return (existingContent.slice(0, index) +
-        (needsNewlineBefore ? '\n' : '') +
-        newContent +
-        (needsNewlineAfter ? '\n' : '') +
-        existingContent.slice(index));
-}
-/**
- * Append content to the end of existing content
- * @param existingContent - The existing text content
- * @param newContent - Content to append
- * @returns Updated content
- */
-export function appendContent(existingContent, newContent) {
-    const needsNewline = existingContent.length > 0 && !existingContent.endsWith('\n');
-    return existingContent + (needsNewline ? '\n' : '') + newContent;
-}
-/**
- * Prepend content to the beginning of existing content
- * @param existingContent - The existing text content
- * @param newContent - Content to prepend
- * @returns Updated content
- */
-export function prependContent(existingContent, newContent) {
-    const needsNewline = !newContent.endsWith('\n') && existingContent.length > 0;
-    return newContent + (needsNewline ? '\n' : '') + existingContent;
-}
-//# sourceMappingURL=merge.js.map