sf-user-inactivator 1.0.0

package/README.md

@@ -0,0 +1,147 @@
+# Salesforce User Inactivation Tool
+
+> A powerful Node.js CLI tool with a beautiful dark-themed web UI for managing user inactivation across multiple Salesforce orgs.
+
+## Features
+
+- 🎨 **Modern Dark UI** - Beautiful Tailwind CSS interface with dark theme
+- 📊 **Three-Panel Layout** - Users, Orgs, and Status panels with resizable splitters
+- 🔍 **User Search** - Quick search functionality for filtering users
+- ✅ **Selective Inactivation** - Choose specific user/org combinations
+- 📈 **Real-time Status** - Live updates and detailed reports
+- 🚀 **SF CLI Integration** - Uses official Salesforce CLI for operations
+
+## Prerequisites
+
+- Node.js (v16 or higher)
+- Salesforce CLI (`sf`) installed and configured
+- Authenticated Salesforce orgs
+
+## Installation
+
+```bash
+npm install -g sf-user-inactivator
+
+```
+
+## Usage
+
+### Prepare Your CSV File
+
+Create a CSV file with user emails. The tool accepts various column names:
+
+```csv
+email
+user@example.com
+admin@company.com
+```
+
+Or:
+
+```csv
+Email,Name
+user@example.com,John Doe
+admin@company.com,Jane Smith
+```
+
+### Run the Tool
+
+```bash
+
+sf-user-inactive -o org1@example.com org2@example.com -u users.csv
+
+# With custom port
+sf-user-inactive -o org1@example.com -u users.csv -p 8080
+
+```
+
+### Command Options
+
+- `-o, --orgs <usernames...>` - Salesforce org usernames (space-separated, required)
+- `-u, --users <file>` - Path to CSV file with user emails (required)
+- `-p, --port <number>` - Port for web UI (default: 3000)
+
+## How to Use the Web UI
+
+1. **Select a User** - Click on a user email in the left panel
+2. **Choose Orgs** - Check the boxes for orgs where you want to inactivate the user
+3. **Review Selections** - The button shows total selections count
+4. **Inactivate** - Click "Inactivate Selected" and confirm
+5. **View Report** - Check the right panel for detailed results
+
+### UI Features
+
+- **Resizable Panels** - Drag the vertical splitters to adjust panel widths
+- **User Search** - Type in the search box to filter users
+- **Status Indicators** - Color-coded success/error/skipped status
+- **Detailed Reports** - See exactly what happened with each operation
+
+## How It Works
+
+1. The tool queries each org for the specified user using SOQL
+2. If the user exists and is active, it updates the `IsActive` field to `false`
+3. Results are displayed with success/error/skipped status
+4. Users already inactive or not found are skipped
+
+## Example Workflow
+
+```bash
+# 1. Create users CSV
+echo "email\ntest1@example.com\ntest2@example.com" > users.csv
+
+# 2. Run the tool
+sf-inactive -o devhub@mycompany.com scratch1@mycompany.com -u users.csv
+
+# 3. Browser opens automatically at http://localhost:3000
+# 4. Use the UI to manage inactivations
+```
+
+## Report Format
+
+The status panel shows:
+- **Summary**: Count of successful, failed, and skipped operations
+- **Detailed Report**: Each operation with:
+  - User email
+  - Target org
+  - Status (success/error/skipped)
+  - Detailed message
+
+## Error Handling
+
+The tool handles:
+- Users not found in orgs
+- Users already inactive
+- Network/connection errors
+- Invalid org credentials
+- CSV parsing errors
+
+## Tips
+
+- Authenticate all orgs before running: `sf org login web`
+- Use org aliases for easier management: `sf alias set myorg=user@example.com`
+- Test with a small CSV first to verify connectivity
+- Keep the browser window open while operations are running
+
+## Security Notes
+
+- The tool only inactivates users, never deletes them
+- Requires proper Salesforce CLI authentication
+- All operations use official SF CLI commands
+- Web UI is local-only (localhost)
+
+## Troubleshooting
+
+**"User not found or already inactive"**
+- The user doesn't exist in that org, or is already inactive
+
+**"Command failed"**
+- Check SF CLI is installed: `sf --version`
+- Verify org authentication: `sf org list`
+
+**CSV not loading**
+- Ensure CSV has proper headers (email/Email/EMAIL)
+- Check file path is correct
+
+## License
+
+- MIT (c) Mohan Chinnappan

package/index.js

@@ -0,0 +1,501 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import express from 'express';
+import { readFile } from 'fs/promises';
+import { parse } from 'csv-parse/sync';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import {openResource} from 'open-resource';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const execAsync = promisify(exec);
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const program = new Command();
+
+program
+  .name('sf-inactive')
+  .description('Inactivate users across multiple Salesforce orgs')
+  .version('1.0.0')
+  .requiredOption('-o, --orgs <usernames...>', 'Salesforce org usernames')
+  .requiredOption('-u, --users <file>', 'CSV file with user emails')
+  .option('-p, --port <number>', 'Port for web UI', '3000')
+  .action(async (options) => {
+    try {
+      const csvContent = await readFile(options.users, 'utf-8');
+      const records = parse(csvContent, {
+        columns: true,
+        skip_empty_lines: true,
+        trim: true
+      });
+
+      const userEmails = records.map(record => 
+        record.email || record.Email || record.EMAIL || Object.values(record)[0]
+      ).filter(Boolean);
+
+      if (userEmails.length === 0) {
+        console.error('No user emails found in CSV file');
+        process.exit(1);
+      }
+
+      const app = express();
+      app.use(express.json());
+      app.use(express.static('public'));
+
+      app.get('/api/config', (req, res) => {
+        res.json({
+          orgs: options.orgs,
+          users: userEmails
+        });
+      });
+
+      app.post('/api/inactivate', async (req, res) => {
+        const { selections } = req.body;
+        const results = [];
+
+        for (const selection of selections) {
+          try {
+            const query = `SELECT Id FROM User WHERE Email='${selection.email}' AND IsActive=true LIMIT 1`;
+            const queryResult = await execAsync(
+              `sf data query --query "${query}" --target-org ${selection.org} --json`
+            );
+
+            const queryData = JSON.parse(queryResult.stdout);
+            
+            if (queryData.result.records.length === 0) {
+              results.push({
+                org: selection.org,
+                email: selection.email,
+                status: 'skipped',
+                message: 'User not found or already inactive'
+              });
+              continue;
+            }
+
+            const userId = queryData.result.records[0].Id;
+            
+            await execAsync(
+              `sf data update record --sobject User --record-id ${userId} --values "IsActive=false" --target-org ${selection.org} --json`
+            );
+
+            results.push({
+              org: selection.org,
+              email: selection.email,
+              status: 'success',
+              message: 'User inactivated successfully'
+            });
+          } catch (error) {
+            results.push({
+              org: selection.org,
+              email: selection.email,
+              status: 'error',
+              message: error.message
+            });
+          }
+        }
+
+        res.json({ results });
+      });
+
+      app.get('/', (req, res) => {
+        res.send(getHTML());
+      });
+
+      const port = parseInt(options.port);
+      app.listen(port, () => {
+        const url = `http://localhost:${port}`;
+        console.log(`\n🚀 Salesforce User Inactivation Tool`);
+        console.log(`📊 Dashboard: ${url}`);
+        console.log(`👥 Users loaded: ${userEmails.length}`);
+        console.log(`🏢 Orgs configured: ${options.orgs.length}\n`);
+        openResource(url);
+      });
+    } catch (error) {
+      console.error('Error:', error.message);
+      process.exit(1);
+    }
+  });
+
+program.parse();
+
+function getHTML() {
+  return `<!DOCTYPE html>
+<html lang="en" class="dark">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>SF User Inactivation Tool</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" />
+  <script>
+    tailwind.config = {
+      darkMode: 'class',
+      theme: {
+        extend: {
+          colors: {
+            dark: {
+              bg: '#0f172a',
+              surface: '#1e293b',
+              border: '#334155',
+              hover: '#475569'
+            }
+          }
+        }
+      }
+    }
+  </script>
+  <style>
+    .splitter {
+      cursor: col-resize;
+      background: #334155;
+      transition: background 0.2s;
+    }
+    .splitter:hover {
+      background: #475569;
+    }
+    .panel {
+      overflow-y: auto;
+      scrollbar-width: thin;
+      scrollbar-color: #475569 #1e293b;
+    }
+    .panel::-webkit-scrollbar {
+      width: 8px;
+    }
+    .panel::-webkit-scrollbar-track {
+      background: #1e293b;
+    }
+    .panel::-webkit-scrollbar-thumb {
+      background: #475569;
+      border-radius: 4px;
+    }
+    .modal-backdrop {
+      background: rgba(0, 0, 0, 0.7);
+      backdrop-filter: blur(4px);
+    }
+  </style>
+</head>
+<body class="bg-dark-bg text-gray-100 h-screen overflow-hidden">
+  <div class="h-full flex flex-col">
+    <!-- Header -->
+    <header class="bg-dark-surface border-b border-dark-border px-6 py-4">
+      <div class="flex items-center justify-between">
+        <div>
+          <h1 class="text-2xl font-bold text-blue-400">Salesforce User Inactivation</h1>
+          <p class="text-sm text-gray-400 mt-1">Manage user status across multiple orgs</p>
+        </div>
+        <button
+          id="inactivateBtn"
+          class="bg-blue-600 hover:bg-blue-700 text-white px-6 py-2.5 rounded-lg font-medium transition-colors disabled:opacity-50 disabled:cursor-not-allowed"
+          disabled
+        >
+          Inactivate Selected
+        </button>
+      </div>
+    </header>
+
+    <!-- Main Content -->
+    <div class="flex-1 flex overflow-hidden">
+      <!-- Left Panel - Users -->
+      <div id="leftPanel" class="panel bg-dark-surface border-r border-dark-border" style="width: 25%;">
+        <div class="p-4 border-b border-dark-border sticky top-0 bg-dark-surface z-10">
+          <h2 class="text-lg font-semibold text-gray-200 mb-3">Users</h2>
+          <input
+            type="text"
+            id="userSearch"
+            placeholder="Search users..."
+            class="w-full px-3 py-2 bg-dark-bg border border-dark-border rounded-lg text-sm focus:outline-none focus:ring-2 focus:ring-blue-500"
+          />
+        </div>
+        <div id="usersList" class="p-4 space-y-2"></div>
+      </div>
+
+      <div class="splitter w-1"></div>
+
+      <!-- Center Panel - Orgs -->
+      <div id="centerPanel" class="panel bg-dark-surface" style="width: 45%;">
+        <div class="p-4 border-b border-dark-border sticky top-0 bg-dark-surface z-10">
+          <h2 class="text-lg font-semibold text-gray-200 mb-3">Organizations</h2>
+          <div class="text-sm text-gray-400">Select which orgs to inactivate users in</div>
+        </div>
+        <div id="orgsList" class="p-4"></div>
+      </div>
+
+      <div class="splitter w-1"></div>
+
+      <!-- Right Panel - Status -->
+      <div id="rightPanel" class="panel bg-dark-surface border-l border-dark-border" style="width: 30%;">
+        <div class="p-4 border-b border-dark-border sticky top-0 bg-dark-surface z-10">
+          <h2 class="text-lg font-semibold text-gray-200">Status & Reports</h2>
+        </div>
+        <div id="statusArea" class="p-4">
+          <div class="text-center text-gray-500 mt-8">
+            <svg class="w-16 h-16 mx-auto mb-4 opacity-50" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12h6m-6 4h6m2 5H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z"></path>
+            </svg>
+            <p>No operations performed yet</p>
+          </div>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <!-- Confirmation Modal -->
+  <div id="confirmModal" class="hidden fixed inset-0 z-50 flex items-center justify-center modal-backdrop">
+    <div class="bg-dark-surface rounded-xl shadow-2xl max-w-md w-full mx-4 border border-dark-border">
+      <div class="p-6">
+        <div class="flex items-center mb-4">
+          <div class="w-12 h-12 rounded-full bg-yellow-500/20 flex items-center justify-center mr-4">
+            <svg class="w-6 h-6 text-yellow-500" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"></path>
+            </svg>
+          </div>
+          <h3 class="text-xl font-semibold text-gray-100">Confirm Inactivation</h3>
+        </div>
+        <p class="text-gray-300 mb-4">You are about to inactivate the following users:</p>
+        <div id="confirmDetails" class="bg-dark-bg rounded-lg p-4 mb-6 max-h-48 overflow-y-auto text-sm"></div>
+        <div class="flex gap-3">
+          <button
+            id="cancelBtn"
+            class="flex-1 px-4 py-2.5 bg-dark-bg hover:bg-dark-hover border border-dark-border rounded-lg font-medium transition-colors"
+          >
+            Cancel
+          </button>
+          <button
+            id="confirmBtn"
+            class="flex-1 px-4 py-2.5 bg-red-600 hover:bg-red-700 text-white rounded-lg font-medium transition-colors"
+          >
+            Inactivate Users
+          </button>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <script>
+    let config = { orgs: [], users: [] };
+    let selectedUser = null;
+    let selections = new Map();
+
+    // Fetch configuration
+    fetch('/api/config')
+      .then(r => r.json())
+      .then(data => {
+        config = data;
+        renderUsers();
+        renderOrgs();
+      });
+
+    function renderUsers() {
+      const container = document.getElementById('usersList');
+      const search = document.getElementById('userSearch').value.toLowerCase();
+      const filtered = config.users.filter(u => u.toLowerCase().includes(search));
+      
+      container.innerHTML = filtered.map(email => \`
+        <div
+          class="user-item p-3 rounded-lg cursor-pointer transition-colors \${selectedUser === email ? 'bg-blue-600' : 'bg-dark-bg hover:bg-dark-hover'}"
+          onclick="selectUser('\${email}')"
+        >
+          <div class="flex items-center">
+            <svg class="w-5 h-5 mr-3 text-gray-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M16 7a4 4 0 11-8 0 4 4 0 018 0zM12 14a7 7 0 00-7 7h14a7 7 0 00-7-7z"></path>
+            </svg>
+            <span class="text-sm truncate">\${email}</span>
+          </div>
+        </div>
+      \`).join('');
+    }
+
+    function selectUser(email) {
+      selectedUser = email;
+      renderUsers();
+      renderOrgs();
+    }
+
+    function renderOrgs() {
+      const container = document.getElementById('orgsList');
+      if (!selectedUser) {
+        container.innerHTML = '<div class="text-center text-gray-500 mt-8">Select a user to configure orgs</div>';
+        return;
+      }
+
+      container.innerHTML = config.orgs.map(org => {
+        const key = \`\${selectedUser}::\${org}\`;
+        const checked = selections.has(key);
+        return \`
+          <div class="mb-3 p-4 bg-dark-bg rounded-lg border border-dark-border">
+            <label class="flex items-center cursor-pointer">
+              <input
+                type="checkbox"
+                class="w-5 h-5 rounded border-gray-600 text-blue-600 focus:ring-2 focus:ring-blue-500 focus:ring-offset-0 bg-dark-surface"
+                onchange="toggleSelection('\${selectedUser}', '\${org}')"
+                \${checked ? 'checked' : ''}
+              />
+              <span class="ml-3 flex-1">
+                <div class="font-medium text-gray-200">\${org}</div>
+                <div class="text-xs text-gray-400 mt-1">Salesforce Org</div>
+              </span>
+            </label>
+          </div>
+        \`;
+      }).join('');
+
+      updateInactivateButton();
+    }
+
+    function toggleSelection(email, org) {
+      const key = \`\${email}::\${org}\`;
+      if (selections.has(key)) {
+        selections.delete(key);
+      } else {
+        selections.set(key, { email, org });
+      }
+      updateInactivateButton();
+    }
+
+    function updateInactivateButton() {
+      const btn = document.getElementById('inactivateBtn');
+      btn.disabled = selections.size === 0;
+      btn.textContent = \`Inactivate Selected (\${selections.size})\`;
+    }
+
+    document.getElementById('userSearch').addEventListener('input', renderUsers);
+
+    document.getElementById('inactivateBtn').addEventListener('click', () => {
+      const modal = document.getElementById('confirmModal');
+      const details = document.getElementById('confirmDetails');
+      
+      details.innerHTML = Array.from(selections.values()).map(s => \`
+        <div class="mb-2 pb-2 border-b border-dark-border last:border-0">
+          <div class="font-medium text-gray-200">\${s.email}</div>
+          <div class="text-xs text-gray-400">→ \${s.org}</div>
+        </div>
+      \`).join('');
+      
+      modal.classList.remove('hidden');
+    });
+
+    document.getElementById('cancelBtn').addEventListener('click', () => {
+      document.getElementById('confirmModal').classList.add('hidden');
+    });
+
+    document.getElementById('confirmBtn').addEventListener('click', async () => {
+      document.getElementById('confirmModal').classList.add('hidden');
+      const statusArea = document.getElementById('statusArea');
+      
+      statusArea.innerHTML = \`
+        <div class="text-center py-8">
+          <div class="animate-spin w-12 h-12 border-4 border-blue-500 border-t-transparent rounded-full mx-auto mb-4"></div>
+          <p class="text-gray-400">Processing inactivations...</p>
+        </div>
+      \`;
+
+      try {
+        const response = await fetch('/api/inactivate', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ selections: Array.from(selections.values()) })
+        });
+
+        const data = await response.json();
+        displayResults(data.results);
+        selections.clear();
+        updateInactivateButton();
+        renderOrgs();
+      } catch (error) {
+        statusArea.innerHTML = \`
+          <div class="bg-red-500/10 border border-red-500/30 rounded-lg p-4">
+            <p class="text-red-400 font-medium">Error occurred</p>
+            <p class="text-red-300 text-sm mt-1">\${error.message}</p>
+          </div>
+        \`;
+      }
+    });
+
+    function displayResults(results) {
+      const statusArea = document.getElementById('statusArea');
+      const success = results.filter(r => r.status === 'success').length;
+      const failed = results.filter(r => r.status === 'error').length;
+      const skipped = results.filter(r => r.status === 'skipped').length;
+
+      statusArea.innerHTML = \`
+        <div class="space-y-4">
+          <div class="bg-dark-bg rounded-lg p-4">
+            <h3 class="font-semibold text-gray-200 mb-3">Summary</h3>
+            <div class="grid grid-cols-3 gap-3 text-center">
+              <div>
+                <div class="text-2xl font-bold text-green-400">\${success}</div>
+                <div class="text-xs text-gray-400 mt-1">Success</div>
+              </div>
+              <div>
+                <div class="text-2xl font-bold text-red-400">\${failed}</div>
+                <div class="text-xs text-gray-400 mt-1">Failed</div>
+              </div>
+              <div>
+                <div class="text-2xl font-bold text-yellow-400">\${skipped}</div>
+                <div class="text-xs text-gray-400 mt-1">Skipped</div>
+              </div>
+            </div>
+          </div>
+          
+          <div class="space-y-2">
+            <h3 class="font-semibold text-gray-200">Detailed Report</h3>
+            \${results.map(r => \`
+              <div class="bg-dark-bg rounded-lg p-3 border-l-4 \${
+                r.status === 'success' ? 'border-green-500' :
+                r.status === 'error' ? 'border-red-500' : 'border-yellow-500'
+              }">
+                <div class="flex items-start justify-between mb-1">
+                  <span class="text-sm font-medium text-gray-200">\${r.email}</span>
+                  <span class="text-xs px-2 py-1 rounded \${
+                    r.status === 'success' ? 'bg-green-500/20 text-green-400' :
+                    r.status === 'error' ? 'bg-red-500/20 text-red-400' :
+                    'bg-yellow-500/20 text-yellow-400'
+                  }">\${r.status.toUpperCase()}</span>
+                </div>
+                <div class="text-xs text-gray-400">\${r.org}</div>
+                <div class="text-xs text-gray-500 mt-1">\${r.message}</div>
+              </div>
+            \`).join('')}
+          </div>
+        </div>
+      \`;
+    }
+
+    // Splitter functionality
+    const splitters = document.querySelectorAll('.splitter');
+    splitters.forEach((splitter, index) => {
+      let isResizing = false;
+      let startX, startWidth;
+      const leftPanel = splitter.previousElementSibling;
+      const rightPanel = splitter.nextElementSibling;
+
+      splitter.addEventListener('mousedown', (e) => {
+        isResizing = true;
+        startX = e.clientX;
+        startWidth = leftPanel.offsetWidth;
+        document.body.style.cursor = 'col-resize';
+        document.body.style.userSelect = 'none';
+      });
+
+      document.addEventListener('mousemove', (e) => {
+        if (!isResizing) return;
+        const diff = e.clientX - startX;
+        const newWidth = ((startWidth + diff) / window.innerWidth) * 100;
+        if (newWidth > 15 && newWidth < 60) {
+          leftPanel.style.width = newWidth + '%';
+        }
+      });
+
+      document.addEventListener('mouseup', () => {
+        isResizing = false;
+        document.body.style.cursor = '';
+        document.body.style.userSelect = '';
+      });
+    });
+  </script>
+</body>
+</html>`;
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "sf-user-inactivator",
+  "version": "1.0.0",
+  "description": "Salesforce User Inactivation Tool with Web UI",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "sf-user-inactive": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "keywords": [
+    "salesforce",
+    "cli",
+    "user-management"
+  ],
+  "author": "Mohan Chinnappan",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^11.1.0",
+    "csv-parse": "^5.5.3",
+    "express": "^4.18.2",
+    "open-resource": "^1.0.2"
+  }
+}

package/users/users.csv

@@ -0,0 +1,5 @@
+email
+bruce.wayne@wayneenterprises.com
+diana.prince@themyscira.gov
+
+