@sfdc-webapps/cli 1.0.2

package/dist/utils/paths.js

@@ -0,0 +1,107 @@
+import { existsSync, readFileSync } from 'fs';
+import { join, dirname, basename } from 'path';
+import { fileURLToPath } from 'url';
+/**
+ * Find the monorepo root by searching upward for package.json with workspaces
+ */
+export function getMonorepoRoot() {
+    let currentDir = dirname(fileURLToPath(import.meta.url));
+    while (currentDir !== '/') {
+        const packageJsonPath = join(currentDir, 'package.json');
+        if (existsSync(packageJsonPath)) {
+            const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+            if (packageJson.workspaces) {
+                return currentDir;
+            }
+        }
+        currentDir = dirname(currentDir);
+    }
+    throw new Error('Could not find monorepo root (package.json with workspaces)');
+}
+/**
+ * Get the features directory path
+ */
+export function getFeaturesDir() {
+    return join(getMonorepoRoot(), 'packages', 'features');
+}
+/**
+ * Get the directory path for a specific feature
+ */
+export function getFeatureDir(featureName) {
+    return join(getFeaturesDir(), featureName);
+}
+/**
+ * Resolve a file path within a feature
+ */
+export function resolveFeatureFile(featureName, filePath) {
+    return join(getFeatureDir(featureName), filePath);
+}
+/**
+ * Translate a feature file path to the corresponding base app path
+ * Replaces feature name with base app name in the nested structure
+ *
+ * Handles three formats:
+ * 1. Full path: "digitalExperiences/webApplications/feature-simple/src/routes.tsx"
+ *    → "digitalExperiences/webApplications/base-app/src/routes.tsx"
+ * 2. WebApp path: "webApp/src/routes.tsx"
+ *    → "digitalExperiences/webApplications/base-app/src/routes.tsx"
+ * 3. Other SFDX paths: "classes/NavMenu.cls"
+ *    → "classes/NavMenu.cls" (unchanged, stays at root)
+ */
+export function translatePathToBaseApp(featurePath, featureName, baseAppPath) {
+    // Extract base app name from base app path (last directory component)
+    const baseAppName = basename(baseAppPath);
+    // Pattern: digitalExperiences/webApplications/<feature-name>/...
+    const prefix = 'digitalExperiences/webApplications/';
+    if (featurePath.startsWith(prefix)) {
+        // Full path format - remove prefix to get: <feature-name>/...
+        const remainder = featurePath.substring(prefix.length);
+        // Check if it starts with the feature name
+        if (remainder.startsWith(featureName + '/')) {
+            // Replace feature name with base app name
+            const pathAfterFeatureName = remainder.substring(featureName.length + 1);
+            return `${prefix}${baseAppName}/${pathAfterFeatureName}`;
+        }
+    }
+    else if (featurePath.startsWith('webApp/')) {
+        // WebApp path - strip webApp/ prefix and add full digitalExperiences path
+        const pathAfterWebApp = featurePath.substring('webApp/'.length);
+        return `${prefix}${baseAppName}/${pathAfterWebApp}`;
+    }
+    // All other paths (SFDX metadata, etc.) - return as is (stays at root level)
+    return featurePath;
+}
+/**
+ * Translate a feature file path to use a target app name
+ * Replaces feature name with target app name in the nested structure
+ *
+ * Handles three formats:
+ * 1. Full path: "digitalExperiences/webApplications/feature-simple/src/routes.tsx"
+ *    → "digitalExperiences/webApplications/target-app/src/routes.tsx"
+ * 2. WebApp path: "webApp/src/routes.tsx"
+ *    → "digitalExperiences/webApplications/target-app/src/routes.tsx"
+ * 3. Other SFDX paths: "classes/NavMenu.cls"
+ *    → "classes/NavMenu.cls" (unchanged, stays at root)
+ */
+export function translatePathToTargetApp(featurePath, featureName, targetAppName) {
+    // Pattern: digitalExperiences/webApplications/<feature-name>/...
+    const prefix = 'digitalExperiences/webApplications/';
+    if (featurePath.startsWith(prefix)) {
+        // Full path format - remove prefix to get: <feature-name>/...
+        const remainder = featurePath.substring(prefix.length);
+        // Check if it starts with the feature name
+        if (remainder.startsWith(featureName + '/')) {
+            // Replace feature name with target app name
+            const pathAfterFeatureName = remainder.substring(featureName.length + 1);
+            return `${prefix}${targetAppName}/${pathAfterFeatureName}`;
+        }
+    }
+    else if (featurePath.startsWith('webApp/')) {
+        // WebApp path - strip webApp/ prefix and add full digitalExperiences path
+        const pathAfterWebApp = featurePath.substring('webApp/'.length);
+        return `${prefix}${targetAppName}/${pathAfterWebApp}`;
+    }
+    // All other paths (SFDX metadata, etc.) - return as is (stays at root level)
+    return featurePath;
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

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

package/dist/utils/route-merger.d.ts

@@ -0,0 +1,107 @@
+import { Project } from 'ts-morph';
+/**
+ * Route Merging Strategy: Replace-Matching with Deep Children Merge
+ *
+ * This function merges React Router routes from a feature into a base app using
+ * a "replace-matching" strategy with intelligent children array merging.
+ *
+ * ## How It Works:
+ *
+ * 1. **Top-Level Routes:**
+ *    - Routes with the SAME path → Merge their children arrays
+ *    - Routes with DIFFERENT paths → Add feature route to result
+ *
+ * 2. **Children Array Merging (when parent paths match):**
+ *    - Index routes (`index: true`) → Feature replaces base if both exist
+ *    - Named routes (`path: 'about'`) → Feature replaces base if paths match
+ *    - New routes → Added to children array
+ *    - Preserves base routes not in feature
+ *
+ * 3. **Route Deletion:**
+ *    - Routes with path starting with `__delete__` are deletion markers
+ *    - The route with matching path (without prefix) is removed from result
+ *    - Example: `{ path: '__delete__new' }` removes the route with `path: 'new'`
+ *
+ * 4. **Recursion:**
+ *    - Applies same logic to nested children arrays
+ *
+ * ## Example:
+ *
+ * **Base App Routes:**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   element: <AppLayout />,
+ *   children: [
+ *     { index: true, element: <Home /> }
+ *   ]
+ * }]
+ * ```
+ *
+ * **Feature Routes:**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   element: <AppLayout />,
+ *   children: [
+ *     { path: 'about', element: <About /> },
+ *     { path: 'contact', element: <Contact /> }
+ *   ]
+ * }]
+ * ```
+ *
+ * **Merged Result:**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   element: <AppLayout />,  // Uses feature's element
+ *   children: [
+ *     { index: true, element: <Home /> },       // Preserved from base
+ *     { path: 'about', element: <About /> },    // Added from feature
+ *     { path: 'contact', element: <Contact /> } // Added from feature
+ *   ]
+ * }]
+ * ```
+ *
+ * ## Deletion Example:
+ *
+ * **Base/Previous Routes:**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   children: [
+ *     { path: 'home', element: <Home /> },
+ *     { path: 'about', element: <About /> },
+ *     { path: 'new', element: <New /> }
+ *   ]
+ * }]
+ * ```
+ *
+ * **Feature Routes (deleting 'new'):**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   children: [
+ *     { path: '__delete__new', element: <></> }
+ *   ]
+ * }]
+ * ```
+ *
+ * **Merged Result:**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   children: [
+ *     { path: 'home', element: <Home /> },   // Preserved
+ *     { path: 'about', element: <About /> }  // Preserved
+ *     // 'new' route removed
+ *   ]
+ * }]
+ * ```
+ *
+ * @param featurePath - Path to the feature's routes.tsx file
+ * @param targetPath - Path to the base app's routes.tsx file
+ * @returns The merged routes source code
+ */
+export declare function mergeRoutes(featurePath: string, targetPath: string, project?: Project): string;
+//# sourceMappingURL=route-merger.d.ts.map

package/dist/utils/route-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-merger.d.ts","sourceRoot":"","sources":["../../src/utils/route-merger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAA4C,MAAM,UAAU,CAAC;AAiB7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuGG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,OAAO,GAChB,MAAM,CAuDR"}

package/dist/utils/route-merger.js

@@ -0,0 +1,303 @@
+import * as logger from './logger.js';
+import { Project, ArrayLiteralExpression, Node } from 'ts-morph';
+import path from 'path';
+import { mergeImports } from './import-merger.js';
+/**
+ * Route Merging Strategy: Replace-Matching with Deep Children Merge
+ *
+ * This function merges React Router routes from a feature into a base app using
+ * a "replace-matching" strategy with intelligent children array merging.
+ *
+ * ## How It Works:
+ *
+ * 1. **Top-Level Routes:**
+ *    - Routes with the SAME path → Merge their children arrays
+ *    - Routes with DIFFERENT paths → Add feature route to result
+ *
+ * 2. **Children Array Merging (when parent paths match):**
+ *    - Index routes (`index: true`) → Feature replaces base if both exist
+ *    - Named routes (`path: 'about'`) → Feature replaces base if paths match
+ *    - New routes → Added to children array
+ *    - Preserves base routes not in feature
+ *
+ * 3. **Route Deletion:**
+ *    - Routes with path starting with `__delete__` are deletion markers
+ *    - The route with matching path (without prefix) is removed from result
+ *    - Example: `{ path: '__delete__new' }` removes the route with `path: 'new'`
+ *
+ * 4. **Recursion:**
+ *    - Applies same logic to nested children arrays
+ *
+ * ## Example:
+ *
+ * **Base App Routes:**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   element: <AppLayout />,
+ *   children: [
+ *     { index: true, element: <Home /> }
+ *   ]
+ * }]
+ * ```
+ *
+ * **Feature Routes:**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   element: <AppLayout />,
+ *   children: [
+ *     { path: 'about', element: <About /> },
+ *     { path: 'contact', element: <Contact /> }
+ *   ]
+ * }]
+ * ```
+ *
+ * **Merged Result:**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   element: <AppLayout />,  // Uses feature's element
+ *   children: [
+ *     { index: true, element: <Home /> },       // Preserved from base
+ *     { path: 'about', element: <About /> },    // Added from feature
+ *     { path: 'contact', element: <Contact /> } // Added from feature
+ *   ]
+ * }]
+ * ```
+ *
+ * ## Deletion Example:
+ *
+ * **Base/Previous Routes:**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   children: [
+ *     { path: 'home', element: <Home /> },
+ *     { path: 'about', element: <About /> },
+ *     { path: 'new', element: <New /> }
+ *   ]
+ * }]
+ * ```
+ *
+ * **Feature Routes (deleting 'new'):**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   children: [
+ *     { path: '__delete__new', element: <></> }
+ *   ]
+ * }]
+ * ```
+ *
+ * **Merged Result:**
+ * ```typescript
+ * [{
+ *   path: '/',
+ *   children: [
+ *     { path: 'home', element: <Home /> },   // Preserved
+ *     { path: 'about', element: <About /> }  // Preserved
+ *     // 'new' route removed
+ *   ]
+ * }]
+ * ```
+ *
+ * @param featurePath - Path to the feature's routes.tsx file
+ * @param targetPath - Path to the base app's routes.tsx file
+ * @returns The merged routes source code
+ */
+export function mergeRoutes(featurePath, targetPath, project) {
+    try {
+        const proj = project || new Project();
+        const targetFile = project
+            ? proj.getSourceFile(targetPath) || proj.addSourceFileAtPath(path.resolve(targetPath))
+            : proj.addSourceFileAtPath(path.resolve(targetPath));
+        const featureFile = project
+            ? proj.getSourceFile(featurePath) || proj.addSourceFileAtPath(path.resolve(featurePath))
+            : proj.addSourceFileAtPath(path.resolve(featurePath));
+        // Get initial routes arrays to validate they exist
+        const initialTargetArray = getRoutesArrayLiteral(targetFile, 'routes');
+        const initialFeatureArray = getRoutesArrayLiteral(featureFile, 'routes');
+        if (!initialTargetArray) {
+            logger.warning('Could not extract routes array from target file');
+            return featureFile.getText();
+        }
+        if (!initialFeatureArray) {
+            logger.warning('Could not extract routes array from feature file');
+            return targetFile.getText();
+        }
+        // Merge imports from feature file into target file
+        // Note: This calls organizeImports() which invalidates AST node references
+        mergeImports(featureFile, targetFile);
+        // Re-get routes arrays after import merging (organizeImports invalidates previous references)
+        const targetArray = getRoutesArrayLiteral(targetFile, 'routes');
+        const featureArray = getRoutesArrayLiteral(featureFile, 'routes');
+        if (!targetArray || !featureArray) {
+            logger.error('Routes array was lost after import merging');
+            throw new Error('Failed to re-acquire routes arrays after import merging');
+        }
+        // Parse arrays to RouteObject[]
+        const targetRoutes = parseRoutesFromAST(targetArray);
+        const featureRoutes = parseRoutesFromAST(featureArray);
+        // Deep merge the routes
+        const mergedRoutes = deepMergeRoutes(targetRoutes, featureRoutes);
+        // Convert back to code and update the target
+        const mergedCode = generateRoutesCode(mergedRoutes);
+        targetArray.replaceWithText(mergedCode);
+        return targetFile.getText();
+    }
+    catch (err) {
+        logger.error(`Route merge failed: ${err instanceof Error ? err.message : String(err)}`);
+        throw new Error('Failed to merge routes');
+    }
+}
+/**
+ * Get the array literal expression for the routes variable
+ */
+function getRoutesArrayLiteral(file, varName) {
+    const variable = file.getVariableDeclaration(varName);
+    if (!variable) {
+        logger.warning(`Variable "${varName}" not found in ${file.getFilePath()}`);
+        return undefined;
+    }
+    const initializer = variable.getInitializer();
+    if (!initializer || !ArrayLiteralExpression.isArrayLiteralExpression(initializer)) {
+        logger.warning(`Variable "${varName}" is not initialized with an array literal`);
+        return undefined;
+    }
+    return initializer;
+}
+/**
+ * Parse routes from AST ArrayLiteralExpression to RouteObject[]
+ */
+function parseRoutesFromAST(arrayLiteral) {
+    const routes = [];
+    for (const element of arrayLiteral.getElements()) {
+        if (Node.isObjectLiteralExpression(element)) {
+            const route = {};
+            for (const prop of element.getProperties()) {
+                if (Node.isPropertyAssignment(prop)) {
+                    const name = prop.getName();
+                    const initializer = prop.getInitializer();
+                    if (!initializer)
+                        continue;
+                    if (name === 'children' && Node.isArrayLiteralExpression(initializer)) {
+                        // Recursively parse children
+                        route.children = parseRoutesFromAST(initializer);
+                    }
+                    else {
+                        // Store the raw text for other properties
+                        route[name] = initializer.getText();
+                    }
+                }
+            }
+            routes.push(route);
+        }
+    }
+    return routes;
+}
+/**
+ * Deep merge two route arrays
+ * - Routes are matched by path equality
+ * - Feature routes replace target routes with the same path
+ * - Children arrays are recursively merged
+ * - All properties from feature route are preserved
+ * - Routes with path starting with '__delete__' are deletion markers
+ */
+function deepMergeRoutes(targetRoutes, featureRoutes) {
+    const result = [...targetRoutes];
+    for (const featureRoute of featureRoutes) {
+        // Check if this is a deletion marker
+        const DELETE_PREFIX = '__delete__';
+        if (featureRoute.path && typeof featureRoute.path === 'string') {
+            // Remove quotes from path string if present
+            const pathValue = featureRoute.path.replace(/^['"`]|['"`]$/g, '');
+            if (pathValue.startsWith(DELETE_PREFIX)) {
+                // This is a deletion marker - remove the route with matching path
+                const targetPath = pathValue.substring(DELETE_PREFIX.length);
+                const deleteIndex = result.findIndex((targetRoute) => {
+                    if (targetRoute.path && typeof targetRoute.path === 'string') {
+                        const targetPathValue = targetRoute.path.replace(/^['"`]|['"`]$/g, '');
+                        return targetPathValue === targetPath;
+                    }
+                    return false;
+                });
+                if (deleteIndex >= 0) {
+                    result.splice(deleteIndex, 1);
+                    logger.info(`Deleted route with path: ${targetPath}`);
+                }
+                else {
+                    logger.error(`\nValidation error: Cannot delete route that doesn't exist!\n`);
+                    logger.info(`Route marked for deletion: ${targetPath}`);
+                    logger.warning(`The route doesn't exist in the current routes.\n`);
+                    throw new Error('Route deletion failed - cannot proceed');
+                }
+                // Don't add the deletion marker to result
+                continue;
+            }
+        }
+        const matchIndex = result.findIndex((targetRoute) => {
+            // Match by path if both have paths
+            if (featureRoute.path && targetRoute.path) {
+                return featureRoute.path === targetRoute.path;
+            }
+            // Match index routes
+            if (featureRoute.index && targetRoute.index) {
+                return true;
+            }
+            return false;
+        });
+        if (matchIndex >= 0) {
+            const targetRoute = result[matchIndex];
+            // Merge the route, starting with feature route properties
+            const mergedRoute = { ...featureRoute };
+            // If both have children, recursively merge them
+            if (targetRoute.children && featureRoute.children) {
+                mergedRoute.children = deepMergeRoutes(targetRoute.children, featureRoute.children);
+            }
+            else if (targetRoute.children) {
+                // Only target has children, preserve them
+                mergedRoute.children = targetRoute.children;
+            }
+            // If only feature has children, they're already in mergedRoute
+            result[matchIndex] = mergedRoute;
+        }
+        else {
+            // No match found, add the new route
+            result.push(featureRoute);
+        }
+    }
+    return result;
+}
+/**
+ * Generate TypeScript code from RouteObject[]
+ */
+function generateRoutesCode(routes) {
+    if (routes.length === 0) {
+        return '[]';
+    }
+    const routeStrings = routes.map((route) => generateRouteCode(route, 1));
+    return `[\n${routeStrings.join(',\n')}\n]`;
+}
+/**
+ * Generate code for a single route object
+ */
+function generateRouteCode(route, indentLevel) {
+    const indent = '  '.repeat(indentLevel);
+    const props = [];
+    for (const [key, value] of Object.entries(route)) {
+        if (key === 'children' && Array.isArray(value)) {
+            // Recursively generate children
+            const childrenCode = value.length > 0
+                ? `[\n${value.map((child) => generateRouteCode(child, indentLevel + 2)).join(',\n')}\n${indent}  ]`
+                : '[]';
+            props.push(`children: ${childrenCode}`);
+        }
+        else if (value !== undefined) {
+            // For other properties, use the raw text we stored
+            props.push(`${key}: ${value}`);
+        }
+    }
+    return `${indent}{\n${props.map((p) => `${indent}  ${p}`).join(',\n')}\n${indent}}`;
+}
+//# sourceMappingURL=route-merger.js.map

package/dist/utils/route-merger.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,29 @@
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Get the web application directory path from a base app path
+ * Structure: <basePath>/digitalExperiences/webApplications/<appName>
+ */
+export declare function getWebApplicationPath(basePath: string): string;
+/**
+ * Validate that a feature path exists and resolve it to an absolute path
+ */
+export declare function validateAndResolveFeaturePath(featurePath: string): string;
+/**
+ * Validate and resolve an app path (can be relative or absolute)
+ * Validates that the web application directory exists with proper structure
+ * Returns the absolute path to the base app directory
+ */
+export declare function validateAndResolveAppPath(appPath: string): string;
+/**
+ * Validate that a app or feature name is valid
+ * - Must be in kebab-case (lowercase with hyphens)
+ * - Only alphanumeric characters and hyphens allowed
+ * - Cannot start or end with hyphens
+ * - No consecutive hyphens
+ * - Cannot be reserved names: "base", "cli"
+ * - Max 50 characters
+ */
+export declare function validateAppOrFeatureName(name: string): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAIA,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAgCzE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA+CjE;AAID;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CA2B3D"}