npm - meta-compare - Versions diffs - 1.0.0 - Mend

meta-compare 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/README.md ADDED Viewed

@@ -0,0 +1,38 @@
+# Salesforce Metadata Comparer (meta-compare)
+> A CLI tool to compare Salesforce metadata between two orgs, view KPIs, and export CSV results.
+---
+## Features
+- Authenticate multiple Salesforce orgs using CLI aliases or usernames.
+- Fetch metadata types like:
+  - Apex Classes
+  - Triggers
+  - Custom Objects
+  - Flows
+  - Page Layouts
+  - Profiles
+  - Permission Sets
+  - Validation Rules
+- Compare metadata between two orgs:
+  - Identify common components
+  - List components only in Source Org
+  - List components only in Target Org
+- Interactive data tables with:
+  - Search
+  - Column sorting
+  - CSV export
+- KPI summary with large-font counts.
+- Deploy metadata changes directly to the target org.
+- Dark theme UI for comfortable viewing.
+---
+## Installation
+Install globally via npm:
+```bash
+npm install -g meta-compare

package/auth.json ADDED Viewed

@@ -0,0 +1,26 @@
+{
+  "mchinnappan@salesforce.com.devmerge": {
+    "alias": "mchinnappan@salesforce.com.devmerge",
+    "accessToken": "00DbZ000002LcM5!AQEAQKoZUelI3v4urYpbLEhg4JQNWdFt7mFxqYeH7GHXrP76MavYtUM9uAO.BuWJ1vm3r8P3W.gkk1WxOJxcitffr3aEVdBl",
+    "instanceUrl": "https://agility-computing-4466--devmerge.sandbox.my.salesforce.com",
+    "apiVersion": "65.0"
+  },
+  "mchinnappan@salesforce.com.datatest": {
+    "alias": "mchinnappan@salesforce.com.datatest",
+    "accessToken": "00DAs00000ozITC!AQEAQNd.Hdgt7L2zCmeHRyXtR6F8xYGoGlU_qwbX.26DS1Mq9t4lBQoOBOQ8Nsss1uVrFL7vYV.vlNZ6OYZ5jsPqHCBXKp4j",
+    "instanceUrl": "https://agility-computing-4466--datatest.sandbox.my.salesforce.com",
+    "apiVersion": "64.0"
+  },
+  "mchinnappan@salesforce.com.p2o": {
+    "alias": "mchinnappan@salesforce.com.p2o",
+    "accessToken": "00DAq000009MwBR!AQEAQAVnw0xYroZjiEHtpW_i7VQTUQ0P8yLa1DQfLeSIXFGH4rB4imspjLWNNHx1xtb9Sn7m3r8kw2hwTBY0QAua.Xy1gX9m",
+    "instanceUrl": "https://agility-computing-4466--p2o.sandbox.my.salesforce.com",
+    "apiVersion": "65.0"
+  },
+  "mchinnappan@salesforce.com.qa": {
+    "alias": "mchinnappan@salesforce.com.qa",
+    "accessToken": "00DAq000009PEFV!AQEAQAkq1Wbn3aqpVaJ2F8P0o6qlCRY9eaHT8YvjF.XzmSDCR5pur9Lo3kFQrRozfErNYr6VDS.QAT1T7f_QaGkaNCHVasBz",
+    "instanceUrl": "https://agility-computing-4466--qa.sandbox.my.salesforce.com",
+    "apiVersion": "65.0"
+  }
+}

package/doc.html ADDED Viewed

@@ -0,0 +1,185 @@
+<!DOCTYPE html>
+<html lang="en" class="dark">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Salesforce Metadata Comparer</title>
+  <!-- Tailwind CSS CDN -->
+  <script src="https://cdn.tailwindcss.com"></script>
+  <script>
+    tailwind.config = {
+      darkMode: 'class',
+      theme: {
+        extend: {
+          colors: {
+            'sf-blue': '#0176d3',
+            'sf-dark-blue': '#014486',
+            'sf-green': '#10b981',
+            'sf-red': '#ef4444'
+          }
+        }
+      }
+    }
+  </script>
+  <!-- DataTables CSS -->
+  <link rel="stylesheet" href="https://cdn.datatables.net/1.13.8/css/jquery.dataTables.min.css">
+  <link rel="stylesheet" href="https://cdn.datatables.net/responsive/2.5.0/css/responsive.dataTables.min.css">
+  <style>
+    body {
+      background-color: #111827;
+      color: #e5e7eb;
+    }
+    header,
+    footer {
+      background-color: #1f2937;
+    }
+    table.dataTable tbody tr {
+      background-color: #1f2937;
+    }
+    table.dataTable tbody tr.odd {
+      background-color: #111827;
+    }
+    table.dataTable thead {
+      background-color: #374151;
+      color: #f3f4f6;
+    }
+  </style>
+</head>
+<body class="flex flex-col min-h-screen">
+  <!-- Header -->
+  <header class="sticky top-0 z-50 p-4 border-b border-gray-700 flex justify-between items-center">
+    <h1 class="text-2xl font-bold text-sf-blue flex items-center gap-2">
+      <svg class="w-6 h-6 text-sf-blue" fill="currentColor" viewBox="0 0 24 24">
+        <path d="M12 2L2 7v10l10 5 10-5V7L12 2zm0 2.18L19.82 8 12 11.82 4.18 8 12 4.18zM4 9.82l7 3.5v7.36l-7-3.5V9.82zm16 0v7.36l-7 3.5v-7.36l7-3.5z" />
+      </svg>
+      Salesforce Metadata Comparer
+    </h1>
+    <div>
+      <button id="refresh-btn" class="px-4 py-2 bg-sf-blue hover:bg-sf-dark-blue text-white font-medium rounded-md">🔄 Refresh</button>
+    </div>
+  </header>
+  <!-- Main Content -->
+  <main class="flex-1 p-6 space-y-8 overflow-auto">
+    <!-- KPI Section -->
+    <div class="grid grid-cols-3 gap-6 text-center">
+      <div class="bg-gray-800 rounded-lg p-6 border border-gray-700">
+        <div class="text-5xl font-extrabold text-sf-blue" id="kpi-common">0</div>
+        <div class="text-gray-300 mt-2">Common</div>
+      </div>
+      <div class="bg-gray-800 rounded-lg p-6 border border-gray-700">
+        <div class="text-5xl font-extrabold text-sf-red" id="kpi-org1">0</div>
+        <div class="text-gray-300 mt-2">Only in Source Org</div>
+      </div>
+      <div class="bg-gray-800 rounded-lg p-6 border border-gray-700">
+        <div class="text-5xl font-extrabold text-sf-green" id="kpi-org2">0</div>
+        <div class="text-gray-300 mt-2">Only in Target Org</div>
+      </div>
+    </div>
+    <!-- Metadata Tables -->
+    <div class="grid grid-cols-2 gap-6">
+      <!-- Only in Source Org -->
+      <div>
+        <div class="flex justify-between items-center mb-2">
+          <h2 class="text-xl font-semibold">Only in Source Org</h2>
+          <button id="download-org1" class="px-3 py-1 bg-blue-600 hover:bg-blue-700 text-white text-sm rounded-md">📥 CSV</button>
+        </div>
+        <table id="table-org1" class="display stripe hover w-full">
+          <thead><tr><th>Metadata Name</th></tr></thead>
+          <tbody></tbody>
+        </table>
+      </div>
+      <!-- Only in Target Org -->
+      <div>
+        <div class="flex justify-between items-center mb-2">
+          <h2 class="text-xl font-semibold">Only in Target Org</h2>
+          <button id="download-org2" class="px-3 py-1 bg-blue-600 hover:bg-blue-700 text-white text-sm rounded-md">📥 CSV</button>
+        </div>
+        <table id="table-org2" class="display stripe hover w-full">
+          <thead><tr><th>Metadata Name</th></tr></thead>
+          <tbody></tbody>
+        </table>
+      </div>
+    </div>
+    <!-- Common Metadata -->
+    <div>
+      <div class="flex justify-between items-center mb-2">
+        <h2 class="text-xl font-semibold">Common Metadata</h2>
+        <button id="download-common" class="px-3 py-1 bg-blue-600 hover:bg-blue-700 text-white text-sm rounded-md">📥 CSV</button>
+      </div>
+      <table id="table-common" class="display stripe hover w-full">
+        <thead><tr><th>Metadata Name</th></tr></thead>
+        <tbody></tbody>
+      </table>
+    </div>
+  </main>
+  <!-- Footer -->
+  <footer class="sticky bottom-0 z-50 p-4 border-t border-gray-700 text-center bg-gray-800">
+    <span class="text-gray-400">© 2025 Salesforce Metadata Comparer</span>
+  </footer>
+  <!-- Scripts -->
+  <script src="https://code.jquery.com/jquery-3.7.0.min.js"></script>
+  <script src="https://cdn.datatables.net/1.13.8/js/jquery.dataTables.min.js"></script>
+  <script src="https://cdn.datatables.net/responsive/2.5.0/js/dataTables.responsive.min.js"></script>
+  <script>
+    $(document).ready(function () {
+      // Initialize DataTables
+      const tableOrg1 = $('#table-org1').DataTable({ responsive: true });
+      const tableOrg2 = $('#table-org2').DataTable({ responsive: true });
+      const tableCommon = $('#table-common').DataTable({ responsive: true });
+      // CSV download function
+      function downloadCSV(filename, rows) {
+        const csvContent = "data:text/csv;charset=utf-8,"
+          + rows.map(e => e.join(",")).join("\n");
+        const encodedUri = encodeURI(csvContent);
+        const link = document.createElement("a");
+        link.setAttribute("href", encodedUri);
+        link.setAttribute("download", filename);
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+      }
+      // CSV buttons
+      $('#download-org1').on('click', () => {
+        const rows = tableOrg1.rows({ search: 'applied' }).data().toArray().map(r => [r[0]]);
+        downloadCSV('only-in-source.csv', rows);
+      });
+      $('#download-org2').on('click', () => {
+        const rows = tableOrg2.rows({ search: 'applied' }).data().toArray().map(r => [r[0]]);
+        downloadCSV('only-in-target.csv', rows);
+      });
+      $('#download-common').on('click', () => {
+        const rows = tableCommon.rows({ search: 'applied' }).data().toArray().map(r => [r[0]]);
+        downloadCSV('common-metadata.csv', rows);
+      });
+      // Refresh button placeholder
+      $('#refresh-btn').on('click', () => {
+        location.reload();
+      });
+    });
+  </script>
+</body>
+</html>

package/main.js ADDED Viewed

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+const { program } = require('commander');
+const path = require('path');
+const fs = require('fs');
+const {
+  authenticate,
+  fetchMetadata,
+  compareMetadata,
+  deployMetadata
+} = require('./renderer');
+program
+  .name('sf-metadata-cli')
+  .description('CLI to compare Salesforce metadata between two orgs')
+  .version('1.0.0');
+program
+  .command('compare')
+  .description('Compare metadata between two orgs')
+  .requiredOption('-s, --source <alias>', 'Source org alias or username')
+  .requiredOption('-t, --target <alias>', 'Target org alias or username')
+  .requiredOption('-m, --metadata <type>', 'Metadata type to compare (ApexClass, ApexTrigger, CustomObject, etc.)')
+  .action(async (options) => {
+    try {
+      console.log(`🔹 Fetching auth for Source Org: ${options.source}`);
+      const org1Auth = await authenticate(options.source);
+      console.log(`🔹 Fetching auth for Target Org: ${options.target}`);
+      const org2Auth = await authenticate(options.target);
+      console.log(`🔹 Comparing metadata type: ${options.metadata}`);
+      await compareMetadata(org1Auth, org2Auth, options.metadata);
+    } catch (err) {
+      console.error(`❌ Error: ${err.message}`);
+      process.exit(1);
+    }
+  });
+/*
+program
+  .command('deploy')
+  .description('Deploy metadata folder to target org')
+  .requiredOption('-t, --target <alias>', 'Target org alias or username')
+  .requiredOption('-d, --dir <folder>', 'Folder containing metadata to deploy')
+  .action(async (options) => {
+    try {
+      console.log(`🔹 Fetching auth for Target Org: ${options.target}`);
+      const targetAuth = await authenticate(options.target);
+      console.log(`🔹 Deploying folder: ${options.dir}`);
+      await deployMetadata(targetAuth, options.dir);
+    } catch (err) {
+      console.error(`❌ Error: ${err.message}`);
+      process.exit(1);
+    }
+  });
+*/
+program.parse(process.argv);

package/output.json ADDED Viewed

@@ -0,0 +1,109 @@
+⚖️ Comparing metadata type: ApexClass between mchinnappan@salesforce.com.devmerge and mchinnappan@salesforce.com.datatest...
+📊 Comparison Results: ApexClass
+✅ Common: 201
+❌ Only in mchinnappan@salesforce.com.devmerge: 376
+❌ Only in mchinnappan@salesforce.com.datatest: 0
+→ Only in mchinnappan@salesforce.com.devmerge: [
+  'omnistudio__ObjectDocumentCreationDocxService',
+  'omnistudio__FlexCardCompilerTest',
+  'omnistudio__DocTemplateListControllerTest',
+  'omnistudio__DefaultUserCustomLabelsImplementation',
+  'omnistudio__DocuSignBatch',
+  'omnistudio__MapUtilityTest',
+  'omnistudio__ElementTriggerHandlerTest',
+  'omnistudio__OmniStudioPostUninstallClassTest',
+  'omnistudio__DefaultOmniScriptNamedCredentialCallout',
+  'omnistudio__FlexRuntimeTest',
+  'omnistudio__InvokeResource',
+  'IPDocumentGeneratorInvocable',
+  'omnistudio__OmniLanguageDynamicPicklist',
+  'omnistudio__OrgCacheManagerInterface',
+  'omnistudio__XmlToJson',
+  'omnistudio__VlocityDocsUtils',
+  'omnistudio__Logger',
+  'omnistudio__MetadataQueryWithoutSharing',
+  'omnistudio__ObjectDocumentCreationDocxServiceTest',
+  'omnistudio__DocumentServiceClient',
+  'omnistudio__NamespaceUtilitiesTest',
+  'omnistudio__DRUtilities',
+  'OrderAndOrderProductStatusCheckHelper',
+  'omnistudio__JSONMessage',
+  'omnistudio__BusinessProcessTriggerHandlerTest',
+  'omnistudio__DefaultOmniScriptEditBlock',
+  'omnistudio__OmniUiCardTriggerHandler',
+  'omnistudio__AutoCustomLabelReferenceTestDocgen',
+  'omnistudio__ScaleCacheService',
+  'omnistudio__InvokeService',
+  'omnistudio__ClmMockHttpPdfResponse',
+  'omnistudio__OmniScriptUtil',
+  'omnistudio__PricingMatrixCalculationServiceTest',
+  'omnistudio__OmniTypeDynamicPicklistTest',
+  'OrderIdentifierService',
+  'omnistudio__VlocityTrackingServiceFieldMappingsTest',
+  'BellOMSAsyncHelper',
+  'omnistudio__LabelUtilityService',
+  'CaseTriggerTest',
+  'omnistudio__VlocityErrorLoggingServiceTest',
+  'omnistudio__MatchingKeyService',
+  'omnistudio__IntegrationProcedureService',
+  'omnistudio__OmniScriptInstanceController',
+  'omnistudio__CurrencyCode',
+  'omnistudio__DRDocTemplateIntegrationUtilityService',
+  'omnistudio__ObjectUtilitiesTest',
+  'omnistudio__VlocityOpenInterface2',
+  'omnistudio__PDFTronUtilTest',
+  'omnistudio__DRDataPackOUIOpenImplementation',
+  'omnistudio__PDFTRonUtil',
+  'omnistudio__LWCUtilities',
+  'omnistudio__JSONDownloadController',
+  'omnistudio__AutoCustomLabelReferenceTestResources',
+  'OrderUpdateToAbandonedBatchTest',
+  'omnistudio__GuestUserRESTController',
+  'omnistudio__MockDocuSignCalloutResponse',
+  'omnistudio__PersonAccountSetting',
+  'omnistudio__PlatformDocuSignIntegrationService',
+  'omnistudio__StoreResponses',
+  'omnistudio__SessionIdHandler',
+  'omnistudio__SideBySideNavigationControllerTest',
+  'omnistudio__DRRestResource',
+  'omnistudio__VlocityDocsUtilsTest',
+  'omnistudio__DRBundleTriggerHandler',
+  'omnistudio__DefaultOmniScriptSObjectPicklist',
+  'omnistudio__OmniNamedCredentialMockResponse',
+  'omnistudio__DocgenPostInstallClassTest',
+  'omnistudio__GuestUserUtilities',
+  'omnistudio__OrgCacheManagerTest',
+  'omnistudio__FetchStaticResourceUrlTest',
+  'omnistudio__DefaultOmniScriptEditBlockTest',
+  'omnistudio__PricingMatrixCalculationService',
+  'omnistudio__PersonAccountSettingTest',
+  'omnistudio__IsFoundationPkg',
+  'omnistudio__VlocityTrackingService',
+  'omnistudio__ObjectDescriberV2',
+  'omnistudio__DocumentTemplateSectionModel',
+  'omnistudio__DRDataPackMappingsUtility',
+  'omnistudio__SoqlQueryBuilderTest',
+  'omnistudio__DocgenOpenInterfaceSharingWrapperTest',
+  'omnistudio__DRProcessorTest',
+  'omnistudio__RTEPropSetManagerTest',
+  'omnistudio__DefaultDocuSignOmniScriptIntegration',
+  'omnistudio__DocumentTemplateDisplayControllerTest',
+  'omnistudio__CreateEleTypeToHTMLTemplateListTest',
+  'omnistudio__SoqlConditionBuilder',
+  'omnistudio__DefaultOmniScriptSendEmailTest',
+  'omnistudio__TokenMappingComponentController',
+  'NewOrderControllerTest',
+  'omnistudio__PlatformSecurityCheckerTest',
+  'omnistudio__TokenExtractionUtility',
+  'omnistudio__CreateEleTypeToHTMLTemplateList',
+  'omnistudio__PlatformCustomSettingsUtilities',
+  'omnistudio__AccessTokenController',
+  'omnistudio__LegalBannerControllerTest',
+  'omnistudio__NewportTestUtils',
+  'TAGenerateOrderNumberAI',
+  'omnistudio__AccessTokenControllerTest',
+  'omnistudio__DocumentServiceGatewayTest',
+  'OrderStatusResponseHelper',
+  ... 276 more items
+]

package/package.json ADDED Viewed

@@ -0,0 +1,28 @@
+{
+  "name": "meta-compare",
+  "version": "1.0.0",
+  "description": "A CLI tool to compare Salesforce metadata between two orgs, view KPIs, and export CSV results.",
+  "main": "main.js",
+  "bin": {
+    "meta-compare": "./main.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "salesforce",
+    "metadata",
+    "compare",
+    "cli",
+    "sfcli",
+    "org"
+  ],
+  "author": "Mohan Chinnappan",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^14.0.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/preload.js ADDED Viewed

@@ -0,0 +1,26 @@
+const fs = require('fs');
+const path = require('path');
+const AUTH_FILE = path.join(__dirname, 'auth.json');
+function loadAuth(alias) {
+  if (!fs.existsSync(AUTH_FILE)) {
+    throw new Error('Auth file not found, run auth first.');
+  }
+  const data = JSON.parse(fs.readFileSync(AUTH_FILE, 'utf-8'));
+  if (!data[alias]) {
+    throw new Error(`No auth found for alias: ${alias}`);
+  }
+  return { alias, ...data[alias] };
+}
+function saveAuth(alias, details) {
+  let data = {};
+  if (fs.existsSync(AUTH_FILE)) {
+    data = JSON.parse(fs.readFileSync(AUTH_FILE, 'utf-8'));
+  }
+  data[alias] = details;
+  fs.writeFileSync(AUTH_FILE, JSON.stringify(data, null, 2));
+}
+module.exports = { loadAuth, saveAuth };

package/renderer.js ADDED Viewed

@@ -0,0 +1,256 @@
+const { execSync } = require('child_process');
+const { saveAuth } = require('./preload');
+const fs = require('fs');
+const path = require('path');
+/**
+ * Authenticate org (fetch auth details only, no login)
+ */
+async function authenticate(alias) {
+  console.log(`🔐 Fetching auth details for org alias/username: ${alias}...`);
+  try {
+    const result = execSync(`sf force org display -o ${alias} --json`, {
+      encoding: 'utf8'
+    });
+    const json = JSON.parse(result);
+    const authDetails = {
+      alias,
+      accessToken: json.result.accessToken,
+      instanceUrl: json.result.instanceUrl,
+      apiVersion: json.result.apiVersion
+    };
+    saveAuth(alias, authDetails);
+    console.log(`💾 Saved auth for alias: ${alias}`);
+    // ✅ Return auth object for use in main.js
+    return authDetails;
+  } catch (err) {
+    console.error(`❌ Auth fetch failed for ${alias}: ${err.message}`);
+    throw err;
+  }
+}
+/**
+ * Fetch metadata list for a given type
+ */
+async function fetchMetadata(auth, type) {
+  console.log(`📥 Fetching metadata type: ${type} from org: ${auth.alias}`);
+  try {
+    const result = execSync(
+      `sf force mdapi listmetadata -m ${type} -o ${auth.alias} --json`,
+      { encoding: 'utf8' }
+    );
+    const json = JSON.parse(result);
+    console.log(JSON.stringify(json, null, 2));
+  } catch (err) {
+    console.error(`❌ Fetch failed: ${err.message}`);
+  }
+}
+/**
+ * Compare metadata between two orgs and generate TailwindCSS dark HTML report
+ */
+async function compareMetadata(org1Auth, org2Auth, type) {
+  console.log(`⚖️ Comparing metadata type: ${type} between ${org1Auth.alias} and ${org2Auth.alias}...`);
+  try {
+    // Fetch metadata from both orgs
+    const result1 = execSync(
+      `sf force mdapi listmetadata -m ${type} -o ${org1Auth.alias} --json`,
+      { encoding: 'utf8' }
+    );
+    const result2 = execSync(
+      `sf force mdapi listmetadata -m ${type} -o ${org2Auth.alias} --json`,
+      { encoding: 'utf8' }
+    );
+    const org1Meta = JSON.parse(result1);
+    const org2Meta = JSON.parse(result2);
+    const names1 = new Set((org1Meta.result || []).map(m => m.fullName));
+    const names2 = new Set((org2Meta.result || []).map(m => m.fullName));
+    const onlyInOrg1 = [...names1].filter(x => !names2.has(x));
+    const onlyInOrg2 = [...names2].filter(x => !names1.has(x));
+    const common = [...names1].filter(x => names2.has(x));
+    console.log(`✅ Comparison Done`);
+    console.log(`Common: ${common.length}, Only in ${org1Auth.alias}: ${onlyInOrg1.length}, Only in ${org2Auth.alias}: ${onlyInOrg2.length}`);
+    // -----------------------
+    // Export CSV to disk
+    // -----------------------
+    const csvLines = [];
+    csvLines.push('Type,Metadata Name');
+    onlyInOrg1.forEach(name => csvLines.push(`Only in ${org1Auth.alias},${name}`));
+    onlyInOrg2.forEach(name => csvLines.push(`Only in ${org2Auth.alias},${name}`));
+    common.forEach(name => csvLines.push(`Common,${name}`));
+    const csvPath = path.join(process.cwd(), `metadata-compare-${type}.csv`);
+    fs.writeFileSync(csvPath, csvLines.join('\n'), 'utf8');
+    console.log(`📄 CSV exported: ${csvPath}`);
+    // -----------------------
+    // Generate HTML Report
+    // -----------------------
+    const html = `
+<!DOCTYPE html>
+<html lang="en" class="dark">
+<head>
+  <meta charset="UTF-8">
+  <title>Metadata Comparison - ${type}</title>
+  <script src="https://cdn.tailwindcss.com"></script>
+    <link rel="icon" type="image/x-icon"
+        href="https://mohan-chinnappan-n5.github.io/dfv/img/mc_favIcon.ico" />
+  <link rel="stylesheet" href="https://cdn.datatables.net/1.13.8/css/jquery.dataTables.min.css">
+  <link rel="stylesheet" href="https://cdn.datatables.net/responsive/2.5.0/css/responsive.dataTables.min.css">
+  <style>
+    body { background-color: #111827; color: #e5e7eb; }
+    table.dataTable tbody tr { background-color: #1f2937; }
+    table.dataTable tbody tr.odd { background-color: #111827; }
+    table.dataTable thead { background-color: #374151; color: #f3f4f6; }
+  </style>
+</head>
+<body class="p-8">
+  <h1 class="text-4xl font-bold mb-8 text-center">Metadata Comparison: ${type}</h1>
+  <!-- KPI Section -->
+  <div class="grid grid-cols-3 gap-6 mb-8 text-center">
+    <div class="bg-gray-800 rounded-lg p-6 border border-gray-700">
+      <div class="text-5xl font-extrabold text-blue-400">${common.length}</div>
+      <div class="text-gray-300 mt-2">Common</div>
+    </div>
+    <div class="bg-gray-800 rounded-lg p-6 border border-gray-700">
+      <div class="text-5xl font-extrabold text-red-400">${onlyInOrg1.length}</div>
+      <div class="text-gray-300 mt-2">Only in ${org1Auth.alias}</div>
+    </div>
+    <div class="bg-gray-800 rounded-lg p-6 border border-gray-700">
+      <div class="text-5xl font-extrabold text-green-400">${onlyInOrg2.length}</div>
+      <div class="text-gray-300 mt-2">Only in ${org2Auth.alias}</div>
+    </div>
+  </div>
+  <!-- Data Tables with CSV buttons -->
+  <div class="grid grid-cols-2 gap-6">
+    <div>
+      <div class="flex justify-between items-center mb-2">
+        <h2 class="text-xl font-semibold">Only in ${org1Auth.alias} (${onlyInOrg1.length})</h2>
+        <button id="download-org1" class="px-3 py-1 bg-blue-600 hover:bg-blue-700 text-white text-sm rounded-md">📥 CSV</button>
+      </div>
+      <table id="table-org1" class="display stripe hover w-full">
+        <thead><tr><th>Metadata Name</th></tr></thead>
+        <tbody>${onlyInOrg1.map(name => `<tr><td>${name}</td></tr>`).join('')}</tbody>
+      </table>
+    </div>
+    <div>
+      <div class="flex justify-between items-center mb-2">
+        <h2 class="text-xl font-semibold">Only in ${org2Auth.alias} (${onlyInOrg2.length})</h2>
+        <button id="download-org2" class="px-3 py-1 bg-blue-600 hover:bg-blue-700 text-white text-sm rounded-md">📥 CSV</button>
+      </div>
+      <table id="table-org2" class="display stripe hover w-full">
+        <thead><tr><th>Metadata Name</th></tr></thead>
+        <tbody>${onlyInOrg2.map(name => `<tr><td>${name}</td></tr>`).join('')}</tbody>
+      </table>
+    </div>
+  </div>
+  <div class="mt-10">
+    <div class="flex justify-between items-center mb-2">
+      <h2 class="text-xl font-semibold">Common Metadata (${common.length})</h2>
+      <button id="download-common" class="px-3 py-1 bg-blue-600 hover:bg-blue-700 text-white text-sm rounded-md">📥 CSV</button>
+    </div>
+    <table id="table-common" class="display stripe hover w-full">
+      <thead><tr><th>Metadata Name</th></tr></thead>
+      <tbody>${common.map(name => `<tr><td>${name}</td></tr>`).join('')}</tbody>
+    </table>
+  </div>
+  <script src="https://code.jquery.com/jquery-3.7.0.min.js"></script>
+  <script src="https://cdn.datatables.net/1.13.8/js/jquery.dataTables.min.js"></script>
+  <script src="https://cdn.datatables.net/responsive/2.5.0/js/dataTables.responsive.min.js"></script>
+  <script>
+    $(document).ready(function() {
+      const tableOrg1 = $('#table-org1').DataTable({ responsive: true });
+      const tableOrg2 = $('#table-org2').DataTable({ responsive: true });
+      const tableCommon = $('#table-common').DataTable({ responsive: true });
+      function downloadCSV(filename, rows) {
+        const csvContent = "data:text/csv;charset=utf-8,"
+          + rows.map(e => e.join(",")).join("\\n");
+        const encodedUri = encodeURI(csvContent);
+        const link = document.createElement("a");
+        link.setAttribute("href", encodedUri);
+        link.setAttribute("download", filename);
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+      }
+      // Per-table CSV buttons (fixed to get all rows)
+      $('#download-org1').on('click', () => {
+        const rows = tableOrg1.rows({ search: 'applied' }).data().toArray().map(r => [r[0]]);
+        downloadCSV('only-in-${org1Auth.alias}-${type}.csv', rows);
+      });
+      $('#download-org2').on('click', () => {
+        const rows = tableOrg2.rows({ search: 'applied' }).data().toArray().map(r => [r[0]]);
+        downloadCSV('only-in-${org2Auth.alias}-${type}.csv', rows);
+      });
+      $('#download-common').on('click', () => {
+        const rows = tableCommon.rows({ search: 'applied' }).data().toArray().map(r => [r[0]]);
+        downloadCSV('common-${type}.csv', rows);
+      });
+    });
+  </script>
+</body>
+</html>
+`;
+    const htmlPath = path.join(process.cwd(), `metadata-compare-${type}.html`);
+    fs.writeFileSync(htmlPath, html, 'utf8');
+    console.log(`📄 HTML report generated: ${htmlPath}`);
+    execSync(`open ${htmlPath}`);
+  } catch (err) {
+    console.error(`❌ Compare failed: ${err.message}`);
+  }
+}
+/**
+ * Deploy metadata to target org
+ */
+async function deployMetadata(auth, file) {
+  console.log(`🚀 Deploying ${file} to org: ${auth.alias}`);
+  try {
+    execSync(
+      `sf project deploy start -o ${auth.alias} -d ${file}`,
+      { stdio: 'inherit' }
+    );
+    console.log(`✅ Deploy completed`);
+  } catch (err) {
+    console.error(`❌ Deploy failed: ${err.message}`);
+  }
+}
+module.exports = {
+  authenticate,
+  fetchMetadata,
+  compareMetadata,
+  deployMetadata
+};

package/sample_run.sh ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ node main.js auth -s mchinnappan@salesforce.com.devmerge -t mchinnappan@salesforce.com.p2o
2	+ node main.js compare -s mchinnappan@salesforce.com.devmerge -t mchinnappan@salesforce.com.p2o -m PermissionSet

package/tooldoc.html ADDED Viewed

@@ -0,0 +1,113 @@
+<!DOCTYPE html>
+<html lang="en" class="dark">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Salesforce Metadata Comparer - Documentation</title>
+  <!-- Tailwind CSS -->
+  <script src="https://cdn.tailwindcss.com"></script>
+  <script>
+    tailwind.config = {
+      darkMode: 'class',
+      theme: {
+        extend: {
+          colors: {
+            'sf-blue': '#0176d3',
+            'sf-dark-blue': '#014486',
+            'sf-green': '#10b981',
+            'sf-red': '#ef4444'
+          }
+        }
+      }
+    }
+  </script>
+</head>
+<body class="bg-gray-900 text-gray-100 flex flex-col min-h-screen">
+  <!-- Header -->
+  <header class="sticky top-0 bg-gray-800 border-b border-gray-700 p-6 flex justify-between items-center z-50">
+    <h1 class="text-3xl font-bold text-sf-blue">Salesforce Metadata Comparer</h1>
+  </header>
+  <!-- Main Content -->
+  <main class="flex-1 p-6 space-y-12">
+    <!-- Introduction -->
+    <section>
+      <h2 class="text-2xl font-semibold mb-4 text-gray-200">Overview</h2>
+      <p class="text-gray-300">
+        The Salesforce Metadata Comparer is a tool that helps Salesforce admins and developers
+        compare metadata between two Salesforce orgs. Quickly identify differences, track missing
+        components, and deploy changes efficiently.
+      </p>
+    </section>
+    <!-- Features -->
+    <section>
+      <h2 class="text-2xl font-semibold mb-4 text-gray-200">Features</h2>
+      <ul class="list-disc list-inside space-y-2 text-gray-300">
+        <li>Authenticate with multiple Salesforce orgs using CLI aliases.</li>
+        <li>Fetch metadata types like Apex Classes, Triggers, Objects, Flows, Layouts, Profiles, and more.</li>
+        <li>Compare metadata between two orgs and identify:</li>
+        <ul class="list-disc list-inside ml-6 space-y-1">
+          <li>Common components</li>
+          <li>Only in Source Org</li>
+          <li>Only in Target Org</li>
+        </ul>
+        <li>Display comparison results in interactive tables with search, sorting, and CSV export.</li>
+        <li>KPI summary section with large numbers for quick insights.</li>
+        <li>Deploy metadata changes to the target org directly from the tool.</li>
+        <li>Dark theme UI for comfortable viewing.</li>
+      </ul>
+    </section>
+    <!-- How to Use -->
+    <section>
+      <h2 class="text-2xl font-semibold mb-4 text-gray-200">How to Use</h2>
+      <ol class="list-decimal list-inside space-y-3 text-gray-300">
+        <li>Ensure you have Salesforce CLI installed and authenticated with your orgs using aliases.</li>
+        <li>Run the tool and provide the source and target org aliases:</li>
+        <pre class="bg-gray-800 p-3 rounded text-green-400">node main.js -s sourceOrgAlias -t targetOrgAlias</pre>
+        <li>Select the metadata type you want to compare.</li>
+        <li>View the KPI summary and metadata tables in the UI.</li>
+        <li>Use the CSV export buttons to download comparison results.</li>
+        <li>If needed, deploy selected metadata changes to the target org.</li>
+      </ol>
+    </section>
+    <!-- Tips -->
+    <section>
+      <h2 class="text-2xl font-semibold mb-4 text-gray-200">Tips</h2>
+      <ul class="list-disc list-inside space-y-2 text-gray-300">
+        <li>Always authenticate your orgs before running a comparison.</li>
+        <li>For large metadata sets, CSV export helps analyze differences externally.</li>
+        <li>Keep your Salesforce CLI and plugins up to date to avoid command errors.</li>
+        <li>Use the swap org button in the UI if you need to reverse source/target comparison.</li>
+      </ul>
+    </section>
+    <!-- FAQ -->
+    <section>
+      <h2 class="text-2xl font-semibold mb-4 text-gray-200">FAQ</h2>
+      <div class="space-y-4">
+        <div>
+          <h3 class="font-medium text-gray-300">Q: Which metadata types are supported?</h3>
+          <p class="text-gray-400">A: Apex Classes, Triggers, Custom Objects, Flows, Page Layouts, Profiles, Permission Sets, Validation Rules, and more.</p>
+          <a href="https://mchinnappan100.github.io/pages2/metadata/search.html">View all supported metadata types</a>
+        </div>
+      </div>
+    </section>
+  </main>
+  <!-- Footer -->
+  <footer class="sticky bottom-0 bg-gray-800 border-t border-gray-700 p-4 text-center text-gray-400">
+    MC - Salesforce Metadata Comparer
+  </footer>
+</body>
+</html>