lwc-convert 1.0.0

package/dist/utils/vf-controller-resolver.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * Utility for detecting and resolving Apex controllers referenced in Visualforce pages
+ * Parses VF markup to extract controller names and searches the project for matching files
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractControllerNames = extractControllerNames;
+exports.findVfControllers = findVfControllers;
+exports.readControllerContents = readControllerContents;
+exports.getControllerTypeLabel = getControllerTypeLabel;
+const fs = __importStar(require("fs-extra"));
+const path_resolver_1 = require("./path-resolver");
+const logger_1 = require("./logger");
+/**
+ * Extract controller class names from VF page markup
+ * Looks for: controller attribute, extensions attribute, and $RemoteAction references
+ */
+function extractControllerNames(markup) {
+    const controllers = [];
+    const seen = new Set();
+    // Find apex:page tag and extract controller/extensions attributes
+    const apexPageRegex = /<apex:page[^>]*>/i;
+    const pageMatch = markup.match(apexPageRegex);
+    if (pageMatch) {
+        const pageTag = pageMatch[0];
+        // Extract main controller
+        const controllerMatch = pageTag.match(/\bcontroller\s*=\s*["']([^"']+)["']/i);
+        if (controllerMatch) {
+            const name = controllerMatch[1].trim();
+            if (!seen.has(name.toLowerCase())) {
+                controllers.push({ name, type: 'controller' });
+                seen.add(name.toLowerCase());
+            }
+        }
+        // Extract extensions (comma-separated list)
+        const extensionsMatch = pageTag.match(/\bextensions\s*=\s*["']([^"']+)["']/i);
+        if (extensionsMatch) {
+            const extensionNames = extensionsMatch[1].split(',').map(s => s.trim()).filter(s => s);
+            for (const name of extensionNames) {
+                if (!seen.has(name.toLowerCase())) {
+                    controllers.push({ name, type: 'extension' });
+                    seen.add(name.toLowerCase());
+                }
+            }
+        }
+    }
+    // Find $RemoteAction references: {!$RemoteAction.ControllerName.methodName}
+    const remoteActionRegex = /\{\!\$RemoteAction\.([^.]+)\.\w+\}/g;
+    let match;
+    while ((match = remoteActionRegex.exec(markup)) !== null) {
+        const name = match[1].trim();
+        if (!seen.has(name.toLowerCase())) {
+            controllers.push({ name, type: 'remoteAction' });
+            seen.add(name.toLowerCase());
+        }
+    }
+    // Find Visualforce.remoting.Manager.invokeAction references
+    const invokeActionRegex = /(?:Visualforce\.remoting\.Manager\.invokeAction|invokeAction)\s*\(\s*['"]([^'"]+)\.([\w]+)['"]/g;
+    while ((match = invokeActionRegex.exec(markup)) !== null) {
+        const name = match[1].trim();
+        if (!seen.has(name.toLowerCase())) {
+            controllers.push({ name, type: 'remoteAction' });
+            seen.add(name.toLowerCase());
+        }
+    }
+    return controllers;
+}
+/**
+ * Find VF controllers referenced in markup and resolve their file paths
+ */
+async function findVfControllers(markup) {
+    const controllerNames = extractControllerNames(markup);
+    const controllers = [];
+    for (const { name, type } of controllerNames) {
+        const resolved = await (0, path_resolver_1.resolveApexPath)(name);
+        controllers.push({
+            name,
+            type,
+            path: resolved.found ? resolved.path : undefined,
+            found: resolved.found,
+        });
+        if (resolved.found) {
+            logger_1.logger.debug(`Found ${type}: ${name} at ${resolved.path}`);
+        }
+        else {
+            logger_1.logger.debug(`${type} not found in project: ${name}`);
+        }
+    }
+    return {
+        controllers,
+        hasControllers: controllers.length > 0,
+        allFound: controllers.length > 0 && controllers.every(c => c.found),
+    };
+}
+/**
+ * Read content for all found controllers
+ */
+async function readControllerContents(controllers) {
+    const contents = new Map();
+    for (const controller of controllers) {
+        if (controller.found && controller.path) {
+            try {
+                const content = await fs.readFile(controller.path, 'utf-8');
+                contents.set(controller.name, content);
+                logger_1.logger.debug(`Read controller content: ${controller.name}`);
+            }
+            catch (error) {
+                logger_1.logger.warn(`Failed to read controller: ${controller.path}`);
+            }
+        }
+    }
+    return contents;
+}
+/**
+ * Get a display-friendly type label
+ */
+function getControllerTypeLabel(type) {
+    switch (type) {
+        case 'controller':
+            return 'Controller';
+        case 'extension':
+            return 'Extension';
+        case 'remoteAction':
+            return 'Remote Action';
+        default:
+            return 'Controller';
+    }
+}
+//# sourceMappingURL=vf-controller-resolver.js.map

package/dist/utils/vf-controller-resolver.js.map

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

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "lwc-convert",
+  "version": "1.0.0",
+  "description": "CLI tool to convert Salesforce Aura and Visualforce components to Lightning Web Components",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "lwc-convert": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "test": "jest",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write src/**/*.ts",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "salesforce",
+    "lwc",
+    "aura",
+    "visualforce",
+    "converter",
+    "migration",
+    "lightning-web-components",
+    "cli"
+  ],
+  "author": "lwc-convert contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Lastonedown86/lwc-convert.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Lastonedown86/lwc-convert/issues"
+  },
+  "homepage": "https://github.com/Lastonedown86/lwc-convert#readme",
+  "dependencies": {
+    "@babel/generator": "^7.23.0",
+    "@babel/parser": "^7.23.0",
+    "@babel/traverse": "^7.23.0",
+    "@babel/types": "^7.23.0",
+    "@clack/prompts": "^0.11.0",
+    "chalk": "^4.1.2",
+    "commander": "^11.1.0",
+    "domhandler": "^5.0.3",
+    "fs-extra": "^11.2.0",
+    "htmlparser2": "^9.1.0",
+    "inquirer": "^13.2.1",
+    "postcss": "^8.4.32"
+  },
+  "devDependencies": {
+    "@types/babel__generator": "^7.6.8",
+    "@types/babel__traverse": "^7.20.4",
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.9",
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.10.5",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.1.1",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}