@lead-routing/cli 0.1.0

package/dist/sfdc-package/force-app/main/default/classes/AccountTriggerTest.cls

@@ -0,0 +1,58 @@
+@isTest
+class AccountTriggerTest {
+
+    @TestSetup
+    static void makeData() {
+        Routing_Settings__c settings = new Routing_Settings__c(
+            Account_Routing_Enabled__c  = true,
+            Account_Insert_Enabled__c   = true,
+            Account_Update_Enabled__c   = true,
+            Webhook_Secret__c           = 'test-secret-key'
+        );
+        upsert settings;
+    }
+
+    @isTest
+    static void testAccountInsertFiresCallout() {
+        Test.setMock(HttpCalloutMock.class, new RoutingEngineMock());
+
+        Test.startTest();
+        Account a = new Account(Name = 'Tata Consultancy');
+        insert a;
+        Test.stopTest();
+
+        System.assertEquals(0, [SELECT COUNT() FROM Routing_Error_Log__c],
+            'Expected no error logs for successful callout');
+    }
+
+    @isTest
+    static void testAccountUpdateFiresCallout() {
+        Test.setMock(HttpCalloutMock.class, new RoutingEngineMock());
+
+        Account a = new Account(Name = 'Infosys Ltd');
+        insert a;
+
+        Test.startTest();
+        a.BillingCity = 'Bengaluru';
+        update a;
+        Test.stopTest();
+
+        System.assertEquals(0, [SELECT COUNT() FROM Routing_Error_Log__c]);
+    }
+
+    @isTest
+    static void testPayloadBuilderBuild() {
+        // Unit-test the payload builder directly
+        Account a = new Account(Name = 'Test Co');
+        insert a;
+        a = [SELECT Id, Name, BillingCity FROM Account WHERE Id = :a.Id];
+
+        String payload = RoutingPayloadBuilder.build('Account', 'INSERT', a);
+        Map<String, Object> parsed = (Map<String, Object>) JSON.deserializeUntyped(payload);
+
+        System.assertEquals('ACCOUNT', parsed.get('objectType'));
+        System.assertEquals('INSERT',  parsed.get('eventType'));
+        System.assertEquals(String.valueOf(a.Id), parsed.get('recordId'));
+        System.assertNotEquals(null, parsed.get('fields'));
+    }
+}

package/dist/sfdc-package/force-app/main/default/classes/AccountTriggerTest.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>59.0</apiVersion>
+    <status>Active</status>
+</ApexClass>

package/dist/sfdc-package/force-app/main/default/classes/ContactTriggerTest.cls

@@ -0,0 +1,62 @@
+@isTest
+class ContactTriggerTest {
+
+    @TestSetup
+    static void makeData() {
+        Routing_Settings__c settings = new Routing_Settings__c(
+            Contact_Routing_Enabled__c  = true,
+            Contact_Insert_Enabled__c   = true,
+            Contact_Update_Enabled__c   = true,
+            Webhook_Secret__c           = 'test-secret-key'
+        );
+        upsert settings;
+    }
+
+    @isTest
+    static void testContactInsertFiresCallout() {
+        Test.setMock(HttpCalloutMock.class, new RoutingEngineMock());
+
+        Test.startTest();
+        Contact c = new Contact(
+            FirstName = 'Ananya',
+            LastName  = 'Singh',
+            Email     = 'ananya@example.com'
+        );
+        insert c;
+        Test.stopTest();
+
+        System.assertEquals(0, [SELECT COUNT() FROM Routing_Error_Log__c],
+            'Expected no error logs for successful callout');
+    }
+
+    @isTest
+    static void testContactUpdateFiresCallout() {
+        Test.setMock(HttpCalloutMock.class, new RoutingEngineMock());
+
+        Contact c = new Contact(FirstName = 'Dev', LastName = 'Kumar');
+        insert c;
+
+        Test.startTest();
+        c.Email = 'dev@example.com';
+        update c;
+        Test.stopTest();
+
+        System.assertEquals(0, [SELECT COUNT() FROM Routing_Error_Log__c]);
+    }
+
+    @isTest
+    static void testContactRoutingDisabled() {
+        Routing_Settings__c settings = Routing_Settings__c.getOrgDefaults();
+        settings.Contact_Routing_Enabled__c = false;
+        upsert settings;
+
+        Test.setMock(HttpCalloutMock.class, new RoutingEngineMock(500, 'should not be called'));
+
+        Test.startTest();
+        Contact c = new Contact(FirstName = 'No', LastName = 'Route');
+        insert c;
+        Test.stopTest();
+
+        System.assertEquals(0, [SELECT COUNT() FROM Routing_Error_Log__c]);
+    }
+}

package/dist/sfdc-package/force-app/main/default/classes/ContactTriggerTest.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>59.0</apiVersion>
+    <status>Active</status>
+</ApexClass>

package/dist/sfdc-package/force-app/main/default/classes/LeadTriggerTest.cls

@@ -0,0 +1,95 @@
+@isTest
+class LeadTriggerTest {
+
+    @TestSetup
+    static void makeData() {
+        Routing_Settings__c settings = new Routing_Settings__c(
+            Lead_Routing_Enabled__c  = true,
+            Lead_Insert_Enabled__c   = true,
+            Lead_Update_Enabled__c   = true,
+            Webhook_Secret__c        = 'test-secret-key'
+        );
+        upsert settings;
+    }
+
+    @isTest
+    static void testLeadInsertFiresCallout() {
+        Test.setMock(HttpCalloutMock.class, new RoutingEngineMock());
+
+        Test.startTest();
+        Lead l = new Lead(
+            FirstName  = 'Priya',
+            LastName   = 'Sharma',
+            Company    = 'Acme Corp',
+            LeadSource = 'Web'
+        );
+        insert l;
+        Test.stopTest();
+
+        // No error logs expected for a 200 response
+        System.assertEquals(0, [SELECT COUNT() FROM Routing_Error_Log__c],
+            'Expected no error logs for successful callout');
+    }
+
+    @isTest
+    static void testLeadUpdateFiresCallout() {
+        Test.setMock(HttpCalloutMock.class, new RoutingEngineMock());
+
+        Lead l = new Lead(
+            FirstName  = 'Rahul',
+            LastName   = 'Mehta',
+            Company    = 'Beta LLC',
+            LeadSource = 'Phone'
+        );
+        insert l;
+
+        Test.startTest();
+        l.LeadSource = 'Web';
+        update l;
+        Test.stopTest();
+
+        System.assertEquals(0, [SELECT COUNT() FROM Routing_Error_Log__c],
+            'Expected no error logs for successful update callout');
+    }
+
+    @isTest
+    static void testLeadInsertDisabledNoCallout() {
+        Routing_Settings__c settings = Routing_Settings__c.getOrgDefaults();
+        settings.Lead_Routing_Enabled__c = false;
+        upsert settings;
+
+        Test.setMock(HttpCalloutMock.class, new RoutingEngineMock(500, 'should not be called'));
+
+        Test.startTest();
+        Lead l = new Lead(
+            FirstName  = 'Test',
+            LastName   = 'Disabled',
+            Company    = 'NoRoute Inc'
+        );
+        insert l;
+        Test.stopTest();
+
+        // No error logs because routing is disabled (no callout made)
+        System.assertEquals(0, [SELECT COUNT() FROM Routing_Error_Log__c]);
+    }
+
+    @isTest
+    static void testCalloutFailureLogsError() {
+        Test.setMock(HttpCalloutMock.class, new RoutingEngineMock(500, 'Internal Server Error'));
+
+        Test.startTest();
+        Lead l = new Lead(
+            FirstName  = 'Error',
+            LastName   = 'Test',
+            Company    = 'Fail Corp',
+            LeadSource = 'Web'
+        );
+        insert l;
+        Test.stopTest();
+
+        System.assertEquals(1, [SELECT COUNT() FROM Routing_Error_Log__c],
+            'Expected one error log for 500 response');
+        Routing_Error_Log__c errLog = [SELECT Status_Code__c FROM Routing_Error_Log__c LIMIT 1];
+        System.assertEquals(500, (Integer) errLog.Status_Code__c);
+    }
+}

package/dist/sfdc-package/force-app/main/default/classes/LeadTriggerTest.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>59.0</apiVersion>
+    <status>Active</status>
+</ApexClass>

package/dist/sfdc-package/force-app/main/default/classes/OnboardingController.cls

@@ -0,0 +1,183 @@
+public with sharing class OnboardingController {
+
+    // ─── Helpers ───────────────────────────────────────────────────────────────
+
+    /**
+     * Returns the web app base URL from Routing_Settings__c.App_Url__c.
+     * Throws a user-friendly error if the setting hasn't been configured yet
+     * (i.e. lead-routing sfdc deploy hasn't been run).
+     */
+    private static String getAppBaseUrl() {
+        Routing_Settings__c s = Routing_Settings__c.getOrgDefaults();
+        if (String.isBlank(s.App_Url__c)) {
+            throw new AuraHandledException(
+                'Lead Router App URL not configured. Run: lead-routing sfdc deploy'
+            );
+        }
+        return s.App_Url__c.removeEnd('/') + '/api';
+    }
+
+    // ─── Init methods (called by LWC connectedCallback) ───────────────────────
+
+    /**
+     * Returns the web app URL for the LWC to use in OAuth popup and links.
+     * Returns null if not yet configured.
+     */
+    @AuraEnabled
+    public static String getAppUrl() {
+        return Routing_Settings__c.getOrgDefaults().App_Url__c;
+    }
+
+    /**
+     * Returns the Salesforce org ID for use in API calls.
+     * Replaces the fragile window.location.hostname.split('.')[0] approach.
+     */
+    @AuraEnabled
+    public static String getOrgId() {
+        return UserInfo.getOrganizationId();
+    }
+
+    // ─── Step 1 ────────────────────────────────────────────────────────────────
+
+    /**
+     * Called by LWC polling: returns true once the web app has stored OAuth tokens
+     * for this org (i.e. GET /api/setup/status?sfdcOrgId=xxx returns connected=true).
+     */
+    @AuraEnabled
+    public static Boolean checkConnectionStatus(String sfdcOrgId) {
+        HttpRequest req = new HttpRequest();
+        req.setEndpoint(getAppBaseUrl() + '/setup/status?sfdcOrgId=' + EncodingUtil.urlEncode(sfdcOrgId, 'UTF-8'));
+        req.setMethod('GET');
+        req.setTimeout(8000);
+
+        try {
+            HttpResponse res = new Http().send(req);
+            if (res.getStatusCode() == 200) {
+                Map<String, Object> body = (Map<String, Object>) JSON.deserializeUntyped(res.getBody());
+                return body.get('connected') == true;
+            }
+        } catch (Exception e) {
+            // Swallow — LWC will keep polling
+        }
+        return false;
+    }
+
+    // ─── Step 2 ────────────────────────────────────────────────────────────────
+
+    /**
+     * Persists the admin's object/event selections to Routing_Settings__c.
+     */
+    @AuraEnabled
+    public static void saveRoutingSettings(
+        Boolean leadEnabled,    Boolean leadInsert,    Boolean leadUpdate,
+        Boolean contactEnabled, Boolean contactInsert, Boolean contactUpdate,
+        Boolean accountEnabled, Boolean accountInsert, Boolean accountUpdate
+    ) {
+        Routing_Settings__c s = Routing_Settings__c.getOrgDefaults();
+        s.Lead_Routing_Enabled__c    = leadEnabled;
+        s.Lead_Insert_Enabled__c     = leadInsert;
+        s.Lead_Update_Enabled__c     = leadUpdate;
+        s.Contact_Routing_Enabled__c = contactEnabled;
+        s.Contact_Insert_Enabled__c  = contactInsert;
+        s.Contact_Update_Enabled__c  = contactUpdate;
+        s.Account_Routing_Enabled__c = accountEnabled;
+        s.Account_Insert_Enabled__c  = accountInsert;
+        s.Account_Update_Enabled__c  = accountUpdate;
+        upsert s;
+    }
+
+    /**
+     * Fires a test payload to the routing engine to verify connectivity.
+     */
+    @AuraEnabled
+    public static void sendTestEvent() {
+        Routing_Settings__c settings = Routing_Settings__c.getOrgDefaults();
+
+        Map<String, Object> payload = new Map<String, Object>{
+            'objectType' => 'LEAD',
+            'eventType'  => 'INSERT',
+            'recordId'   => '00Q000000000001EAA',
+            'sfdcOrgId'  => UserInfo.getOrganizationId(),
+            'timestamp'  => Datetime.now().formatGmt('yyyy-MM-dd\'T\'HH:mm:ss\'Z\''),
+            'fields'     => new Map<String, Object>{
+                'FirstName'  => 'Test',
+                'LastName'   => 'Event',
+                'LeadSource' => 'Web'
+            },
+            'isTest' => true
+        };
+
+        String body = JSON.serialize(payload);
+        String secret = settings.Webhook_Secret__c ?? '';
+        String signature = 'sha256=' + hmacHex(body, secret);
+
+        String engineEndpoint = settings.Engine_Endpoint__c;
+        if (String.isBlank(engineEndpoint)) {
+            throw new AuraHandledException('Engine endpoint not configured. Run: lead-routing sfdc deploy');
+        }
+
+        HttpRequest req = new HttpRequest();
+        req.setEndpoint(engineEndpoint.removeEnd('/') + '/route');
+        req.setMethod('POST');
+        req.setHeader('Content-Type', 'application/json');
+        req.setHeader('X-Sfdc-Org-Id', UserInfo.getOrganizationId());
+        req.setHeader('X-Signature-256', signature);
+        req.setBody(body);
+        req.setTimeout(10000);
+
+        HttpResponse res = new Http().send(req);
+        if (res.getStatusCode() != 200 && res.getStatusCode() != 202) {
+            throw new AuraHandledException('Engine responded with ' + res.getStatusCode() + ': ' + res.getBody());
+        }
+    }
+
+    // ─── Step 3 ────────────────────────────────────────────────────────────────
+
+    /**
+     * Triggers a field schema sync for one object type.
+     * Calls POST /api/fields/sync?object=LEAD on the web app.
+     * Returns the count of fields synced.
+     */
+    @AuraEnabled
+    public static Integer syncFieldSchema(String objectType) {
+        HttpRequest req = new HttpRequest();
+        req.setEndpoint(getAppBaseUrl() + '/fields/sync?object=' + objectType);
+        req.setMethod('POST');
+        req.setHeader('Content-Type', 'application/json');
+        req.setHeader('X-Sfdc-Org-Id', UserInfo.getOrganizationId());
+        req.setTimeout(30000);
+
+        HttpResponse res = new Http().send(req);
+        if (res.getStatusCode() != 200) {
+            throw new AuraHandledException('Sync failed for ' + objectType + ': ' + res.getBody());
+        }
+
+        Map<String, Object> body = (Map<String, Object>) JSON.deserializeUntyped(res.getBody());
+        return (Integer) body.get('synced');
+    }
+
+    // ─── Step 4 ────────────────────────────────────────────────────────────────
+
+    /**
+     * Marks onboarding as complete in the web app.
+     */
+    @AuraEnabled
+    public static void markOnboardingDone() {
+        HttpRequest req = new HttpRequest();
+        req.setEndpoint(getAppBaseUrl() + '/setup/onboarding-done');
+        req.setMethod('POST');
+        req.setHeader('Content-Type', 'application/json');
+        req.setHeader('X-Sfdc-Org-Id', UserInfo.getOrganizationId());
+        req.setTimeout(8000);
+        new Http().send(req);
+        // Best-effort — ignore errors
+    }
+
+    // ─── Private ───────────────────────────────────────────────────────────────
+
+    private static String hmacHex(String payload, String secret) {
+        if (String.isBlank(secret)) return '';
+        Blob mac = Crypto.generateMac('hmacSHA256', Blob.valueOf(payload), Blob.valueOf(secret));
+        return EncodingUtil.convertToHex(mac);
+    }
+}

package/dist/sfdc-package/force-app/main/default/classes/OnboardingController.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>59.0</apiVersion>
+    <status>Active</status>
+</ApexClass>

package/dist/sfdc-package/force-app/main/default/classes/RoutingEngineCallout.cls

@@ -0,0 +1,96 @@
+public with sharing class RoutingEngineCallout {
+
+    // ─── Public API ────────────────────────────────────────────────────────────
+
+    /**
+     * Called from triggers. @future ensures the callout runs outside the
+     * trigger transaction, avoiding mixed-DML and callout-in-trigger errors.
+     *
+     * @param objectType  'Lead' | 'Contact' | 'Account' (Pascal case)
+     * @param recordIds   IDs of records to route
+     * @param eventType   'INSERT' | 'UPDATE'
+     */
+    @future(callout=true)
+    public static void sendAsync(String objectType, List<Id> recordIds, String eventType) {
+        Routing_Settings__c settings = Routing_Settings__c.getOrgDefaults();
+        String secret = settings.Webhook_Secret__c;
+        String engineEndpoint = settings.Engine_Endpoint__c;
+
+        if (String.isBlank(engineEndpoint)) {
+            System.debug('RoutingEngineCallout: Engine_Endpoint__c not configured. Run: lead-routing sfdc deploy');
+            return;
+        }
+
+        List<SObject> records = queryRecords(objectType, recordIds);
+
+        for (SObject record : records) {
+            String payload = RoutingPayloadBuilder.build(objectType, eventType, record);
+            sendPayload(payload, secret, engineEndpoint);
+        }
+    }
+
+    // ─── Private helpers ───────────────────────────────────────────────────────
+
+    private static List<SObject> queryRecords(String objectType, List<Id> recordIds) {
+        // Dynamically build SELECT with all standard fields for the object
+        Schema.SObjectType sObjType = Schema.getGlobalDescribe().get(objectType);
+        Map<String, Schema.SObjectField> fieldMap = sObjType.getDescribe().fields.getMap();
+        List<String> fieldNames = new List<String>(fieldMap.keySet());
+
+        String soql = 'SELECT ' + String.join(fieldNames, ', ')
+            + ' FROM ' + objectType
+            + ' WHERE Id IN :recordIds';
+
+        return Database.query(soql);
+    }
+
+    private static void sendPayload(String payload, String secret, String engineEndpoint) {
+        String signature = hmacSha256(payload, secret);
+
+        HttpRequest req = new HttpRequest();
+        req.setEndpoint(engineEndpoint.removeEnd('/') + '/route');
+        req.setMethod('POST');
+        req.setHeader('Content-Type', 'application/json');
+        req.setHeader('X-Sfdc-Org-Id', UserInfo.getOrganizationId());
+        req.setHeader('X-Signature-256', 'sha256=' + signature);
+        req.setBody(payload);
+        req.setTimeout(10000);
+
+        Http http = new Http();
+        HttpResponse res;
+
+        try {
+            res = http.send(req);
+        } catch (Exception e) {
+            logError(payload, 0, 'Callout exception: ' + e.getMessage());
+            return;
+        }
+
+        if (res.getStatusCode() != 200 && res.getStatusCode() != 202) {
+            logError(payload, res.getStatusCode(), res.getBody());
+        }
+    }
+
+    private static String hmacSha256(String payload, String secret) {
+        if (String.isBlank(secret)) return '';
+        Blob hmac = Crypto.generateMac(
+            'hmacSHA256',
+            Blob.valueOf(payload),
+            Blob.valueOf(secret)
+        );
+        return EncodingUtil.convertToHex(hmac);
+    }
+
+    private static void logError(String payload, Integer statusCode, String responseBody) {
+        try {
+            insert new Routing_Error_Log__c(
+                Payload__c = payload.length() > 131072 ? payload.substring(0, 131072) : payload,
+                Status_Code__c = statusCode,
+                Response_Body__c = responseBody,
+                Created_At__c = Datetime.now()
+            );
+        } catch (Exception ex) {
+            System.debug('Failed to insert Routing_Error_Log__c: ' + ex.getMessage());
+        }
+    }
+}

package/dist/sfdc-package/force-app/main/default/classes/RoutingEngineCallout.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>59.0</apiVersion>
+    <status>Active</status>
+</ApexClass>

package/dist/sfdc-package/force-app/main/default/classes/RoutingEngineMock.cls

@@ -0,0 +1,28 @@
+/**
+ * HTTP mock used in Apex tests to intercept callouts to the routing engine.
+ * Returns a 200 OK response so tests do not fail on missing HTTP connections.
+ */
+@isTest
+global class RoutingEngineMock implements HttpCalloutMock {
+
+    private Integer statusCode;
+    private String responseBody;
+
+    global RoutingEngineMock() {
+        this.statusCode = 200;
+        this.responseBody = '{"ok":true}';
+    }
+
+    global RoutingEngineMock(Integer statusCode, String responseBody) {
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+    }
+
+    global HTTPResponse respond(HTTPRequest req) {
+        HttpResponse res = new HttpResponse();
+        res.setStatusCode(this.statusCode);
+        res.setHeader('Content-Type', 'application/json');
+        res.setBody(this.responseBody);
+        return res;
+    }
+}

package/dist/sfdc-package/force-app/main/default/classes/RoutingEngineMock.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>59.0</apiVersion>
+    <status>Active</status>
+</ApexClass>

package/dist/sfdc-package/force-app/main/default/classes/RoutingPayloadBuilder.cls

@@ -0,0 +1,50 @@
+public with sharing class RoutingPayloadBuilder {
+
+    /**
+     * Serialises a single SObject record into the JSON payload format
+     * expected by the routing engine.
+     *
+     * Schema:
+     * {
+     *   "objectType": "LEAD",
+     *   "eventType":  "INSERT",
+     *   "recordId":   "00Q5g000001XyZEEA0",
+     *   "sfdcOrgId":  "00D000000000001EAA",
+     *   "timestamp":  "2026-02-23T10:32:00Z",
+     *   "fields": { "FirstName": "Priya", "LeadSource": "Web", ... }
+     * }
+     */
+    public static String build(String objectType, String eventType, SObject record) {
+        Map<String, Object> payload = new Map<String, Object>{
+            'objectType' => objectType.toUpperCase(),
+            'eventType'  => eventType.toUpperCase(),
+            'recordId'   => String.valueOf(record.get('Id')),
+            'sfdcOrgId'  => UserInfo.getOrganizationId(),
+            'timestamp'  => Datetime.now().formatGmt('yyyy-MM-dd\'T\'HH:mm:ss\'Z\''),
+            'fields'     => extractFields(record)
+        };
+
+        return JSON.serialize(payload);
+    }
+
+    // ─── Private ───────────────────────────────────────────────────────────────
+
+    private static Map<String, Object> extractFields(SObject record) {
+        Map<String, Object> fields = new Map<String, Object>();
+        Map<String, Schema.SObjectField> fieldMap =
+            record.getSObjectType().getDescribe().fields.getMap();
+
+        for (String fieldName : fieldMap.keySet()) {
+            try {
+                Object value = record.get(fieldName);
+                if (value != null) {
+                    fields.put(fieldName, value);
+                }
+            } catch (SObjectException e) {
+                // Field not retrieved in query — skip silently
+            }
+        }
+
+        return fields;
+    }
+}

package/dist/sfdc-package/force-app/main/default/classes/RoutingPayloadBuilder.cls-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<ApexClass xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>59.0</apiVersion>
+    <status>Active</status>
+</ApexClass>