A VS Code extension written in TypeScript that helps you validate, test, and document your Salesforce Apex projects — all in one place. It scans your package.xml, runs tests, checks code quality with Salesforce Code Analyzer (PMD + CPD), and exports slick HTML/PDF reports. You can even plug in Einstein GPT for AI-powered feedback and auto-generated ApexDocs.

• 🧩 Apex class validation using Salesforce Code Analyzer v5 (PMD + CPD).
• 🔍 Duplicate code detection across your repo.
• 🧪 Apex test execution via Salesforce CLI with coverage metrics.
• 🧠 Optional Einstein GPT insights for risk detection and improvements.
• 🧾 Automatic HTML/PDF report generation with an integrated VS Code viewer.
• 🧭 Sidebar views for reports, logs, and dependency checks.
• ⚡ Quick commands: Validate Apex, Refresh views, Open output folders.
• 🤖 AI-powered ApexDoc generation (beta) with tag enforcement.
• 🧱 Allman-style Apex formatter for .cls/.trigger files (leverages workspace prettier + prettier-plugin-apex).
• 🧹 Command palette action to strip System.debug(...) statements across the active selection or file.
• 🔄 Compare local metadata vs. your org (Monaco diff view for text assets, size checks for binaries).
• 🕸️ “Where is Used” report — scans dependencies across Apex Classes, Flows, and LWC, rendered in a clean interactive tree view.
• 🎨 Unified dark-themed report design — for a consistent visual experience, and interactive search across all HTML reports.
• 🌐 Multilingual reports — HTML/PDF templates honor your VS Code locale or a workspace override (Spanish/English) with per-report language switching.

• Node.js 18+ and npm 9+.
• Salesforce CLI (sf) with Java 11 or newer.
• wkhtmltopdf (for PDF export, Optional, but Recommended).
• Prettier and Prettier-Plugin-Apex.
• An authenticated Salesforce org through the CLI.
• Einstein GPT credentials (Client Id/Secret) if you plan to use AI features.

You’ll find them under Unified Apex Validator in your VS Code settings.

UAV usa automáticamente la org marcada como isDefaultUsername en sf org list --json. Asegúrate de tener una org por defecto conectada (sf org login web) antes de ejecutar el validador.

💡 Dependencies view highlights missing GPT setup fields and disables AI commands until everything’s filled in.

1. Right-click a package.xml file.
2. Select UAV: Validate Apex Code.
3. Track progress in the Unified Apex Validator output channel.
4. Review reports or logs in the sidebar.
5. (Optional) Run UAV: Compare Metadata against Org to diff your local vs. org versions.
6. (Optional) Use UAV: Formatear Apex (Allman) from the explorer/editor context menu to apply Allman braces to selected .cls/.trigger files (requires prettier + prettier-plugin-apex in your workspace).
7. (Optional) Use UAV: Where is Used from the editor context menu to run a report that scans dependencies across Apex Classes, Flows, and LWC, showing where each element is referenced.
8. (Optional) Use UAV: Remove System.debug Statements from the command palette to clean debug output in the active editor or current selections.

• Available from the explorer and editor context menus for package.xml manifests and supported metadata files (classes, triggers, flows, Lightning bundles, etc.).
• From a manifest, UAV retrieves every type/member declared under ; from a single file it infers the metadata type automatically before running the retrieve.
• Text assets render in the Monaco diff view with syntax highlighting, while binaries surface size differences so you can decide whether to download them.

📝 HTML/PDF reports render in the language defined by UnifiedApexValidator.reportLanguage (default auto). The HTML viewer also exposes a globe selector so teammates can switch between Español and English on demand.

Shows all generated reports (HTML/PDF) with options to refresh, open folder, or view inline in VS Code.

Lists .log files stored under ~/.uav/logs. Quick buttons to refresh or open the folder.

Checks Node.js, CLI, Java, wkhtmltopdf, Code Analyzer, and Einstein GPT configuration. Missing ones show in red and can be fixed from here.

1. Create an External Connected App with scopes api and refresh_token. 📘 Helpful docs:
   • Access Models API with REST
   • Einstein Generative AI Setup
2. Assign a user with API Enabled and API Only User permissions.
3. Turn on Einstein in Setup → Einstein Generative AI.
4. Configure your VS Code settings (sfClientId, sfClientSecret, sfGptEndpoint, sfGptModel, iaPromptTemplate).
5. Authenticate your org via CLI:

   sf org login web --alias <alias>

6. Refresh the Dependencies view — once all fields are set, AI features will unlock automatically.

• Command: UAV: Generate ApexDoc.
• Uses Einstein GPT to auto-generate documentation.
• Ensures required tags (@param, @return, etc.) are filled.
• Disabled when Einstein GPT config is incomplete or skipIAAnalysis is true.

• Make sure the .vsix is installed or from Marketplace.
• Run Developer: Reload Window.
• Check the Unified Apex Validator output channel.

• Run sf --version and java -version.
• Update PATH or reinstall if needed.

• Ejecuta sf org list --json y verifica que alguna org tenga isDefaultUsername: true.
• Si no existe, ejecuta sf org login web y marca la org como predeterminada.
• Una vez conectada, vuelve a lanzar el validador.

• The XML must contain <name>ApexClass</name>.
• Make sure outputDir exists and is writable.

• Check sfClientId, sfClientSecret, sfGptEndpoint, sfGptModel, and iaPromptTemplate.
• Ensure skipIAAnalysis is false.

• Set keepLogFiles = true.
• Logs live under:

  .../globalStorage/ozkrgonzalez.unifiedapexvalidator/.uav/logs
  

• Install prettier and prettier-plugin-apex in the workspace that contains your .cls/.trigger files (npm install --save-dev prettier prettier-plugin-apex).
• Refresh the Dependencies view to confirm both are detected (status should display in green).
• Run UAV: Formatear Apex (Allman) again from the explorer/editor context menu.

• 🎚️ Configurable log levels
• 💬 Dependency tooltips with detected versions
• 🤖 Deeper Einstein GPT insights per class
• 📦 Markdown and CSV export options
• 🏪 Marketplace release with verified Salesforce badge

Created by Oscar Gonzalez GitHub: @ozkrgonzalez

GPL v3 © 2025 – Oscar Gonzalez