salesforce-composite-envelope-builder/composite-envelope-builder/deploy/mdapi/classes/DocusignCompositeEnvelopeBuilderTest.cls

/**
 * @description Test class for DocusignCompositeEnvelopeBuilder (dfsle Apex Toolkit)
 * @author Paul Huliganga
 * @date 2026-02-25
 */
@isTest
private class DocusignCompositeEnvelopeBuilderTest {
    
	@isTest
	static void testSuccessfulCompositeEnvelope() {
		// Arrange
		dfsle.TestUtils.setMock(new dfsle.ESignatureAPIMock());
        
		DocusignEnvelopeRequest req = new DocusignEnvelopeRequest();
		req.templateIds = new List<String>{
			'01234567-abcd-ef01-2345-6789abcdef01',
			'01234567-abcd-ef01-2345-6789abcdef02',
			'01234567-abcd-ef01-2345-6789abcdef03'
		};
		req.recordId = '001000000ABC123';
		req.language = 'en';
		req.emailSubject = 'Please sign these forms';
        
		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = 
			DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(
				new List<DocusignEnvelopeRequest>{req}
			);
		Test.stopTest();
        
		// Assert
		System.assertEquals(1, results.size(), 'Should return 1 result');
		System.assertEquals(true, results[0].success, 'Should be successful');
		System.assertNotEquals(null, results[0].envelopeId, 'Should have envelope ID');
		System.assertEquals(null, results[0].errorMessage, 'Should have no error');
	}
    
	@isTest
	static void testSingleTemplate() {
		// Arrange
		dfsle.TestUtils.setMock(new dfsle.ESignatureAPIMock());
        
		DocusignEnvelopeRequest req = new DocusignEnvelopeRequest();
		req.templateIds = new List<String>{'01234567-abcd-ef01-2345-6789abcdef01'};
		req.recordId = '001000000ABC123';
        
		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = 
			DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(
				new List<DocusignEnvelopeRequest>{req}
			);
		Test.stopTest();
        
		// Assert
		System.assertEquals(true, results[0].success, 'Should succeed with 1 template');
	}
    
	@isTest
	static void testMaximumTemplates() {
		// Arrange
		dfsle.TestUtils.setMock(new dfsle.ESignatureAPIMock());
        
		List<String> templateIds = new List<String>();
		for (Integer i = 1; i <= 14; i++) {
			templateIds.add('01234567-abcd-ef01-2345-6789abcdef' + String.valueOf(i).leftPad(2, '0'));
		}
        
		DocusignEnvelopeRequest req = new DocusignEnvelopeRequest();
		req.templateIds = templateIds;
		req.recordId = '001000000ABC123';
        
		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = 
			DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(
				new List<DocusignEnvelopeRequest>{req}
			);
		Test.stopTest();
        
		// Assert
		System.assertEquals(true, results[0].success, 'Should succeed with 14 templates');
	}
    
	@isTest
	static void testDuplicateTemplatesDeduped() {
		// Arrange
		dfsle.TestUtils.setMock(new dfsle.ESignatureAPIMock());
        
		DocusignEnvelopeRequest req = new DocusignEnvelopeRequest();
		req.templateIds = new List<String>{
			'01234567-abcd-ef01-2345-6789abcdef01',
			'01234567-abcd-ef01-2345-6789abcdef02',
			'01234567-abcd-ef01-2345-6789abcdef01'  // duplicate
		};
		req.recordId = '001000000ABC123';
        
		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = 
			DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(
				new List<DocusignEnvelopeRequest>{req}
			);
		Test.stopTest();
        
		// Assert
		System.assertEquals(true, results[0].success, 'Should handle duplicates');
	}
    
	@isTest
	static void testNullRequest() {
		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = 
			DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(null);
		Test.stopTest();
        
		// Assert
		System.assertEquals(false, results[0].success, 'Should fail with null request');
		System.assertEquals('No request provided', results[0].errorMessage, 'Should have error message');
	}
    
	@isTest
	static void testEmptyRequest() {
		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = 
			DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(
				new List<DocusignEnvelopeRequest>()
			);
		Test.stopTest();
        
		// Assert
		System.assertEquals(false, results[0].success, 'Should fail with empty request');
	}
    
	@isTest
	static void testValidationNoTemplates() {
		// Arrange
		DocusignEnvelopeRequest req = new DocusignEnvelopeRequest();
		req.templateIds = new List<String>();
		req.recordId = '001000000ABC123';
        
		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = 
			DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(
				new List<DocusignEnvelopeRequest>{req}
			);
		Test.stopTest();
        
		// Assert
		System.assertEquals(false, results[0].success, 'Should fail validation');
		System.assert(results[0].errorMessage.containsIgnoreCase('template'), 'Should mention templates');
	}
    
	@isTest
	static void testValidationTooManyTemplates() {
		// Arrange
		List<String> templateIds = new List<String>();
		for (Integer i = 1; i <= 15; i++) {
			templateIds.add('01234567-abcd-ef01-2345-6789abcdef' + String.valueOf(i).leftPad(2, '0'));
		}
        
		DocusignEnvelopeRequest req = new DocusignEnvelopeRequest();
		req.templateIds = templateIds;
		req.recordId = '001000000ABC123';
        
		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = 
			DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(
				new List<DocusignEnvelopeRequest>{req}
			);
		Test.stopTest();
        
		// Assert
		System.assertEquals(false, results[0].success, 'Should fail validation');
		System.assert(results[0].errorMessage.contains('Maximum 14'), 'Should mention limit');
	}
    
	@isTest
	static void testValidationNoRecordId() {
		// Arrange
		DocusignEnvelopeRequest req = new DocusignEnvelopeRequest();
		req.templateIds = new List<String>{'01234567-abcd-ef01-2345-6789abcdef01'};
		req.recordId = '';
        
		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = 
			DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(
				new List<DocusignEnvelopeRequest>{req}
			);
		Test.stopTest();
        
		// Assert
		System.assertEquals(false, results[0].success, 'Should fail validation');
		System.assert(results[0].errorMessage.contains('record ID'), 'Should mention record ID');
	}
    
	@isTest
	static void testValidationBlankTemplateId() {
		// Arrange
		DocusignEnvelopeRequest req = new DocusignEnvelopeRequest();
		req.templateIds = new List<String>{'01234567-abcd-ef01-2345-6789abcdef01', ''};
		req.recordId = '001000000ABC123';
        
		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = 
			DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(
				new List<DocusignEnvelopeRequest>{req}
			);
		Test.stopTest();
        
		// Assert
		System.assertEquals(false, results[0].success, 'Should fail validation');
		System.assert(results[0].errorMessage.contains('blank'), 'Should mention blank');
	}
    
	@isTest
	static void testWithEmailSubject() {
		// Arrange
		dfsle.TestUtils.setMock(new dfsle.ESignatureAPIMock());
        
		DocusignEnvelopeRequest req = new DocusignEnvelopeRequest();
		req.templateIds = new List<String>{'01234567-abcd-ef01-2345-6789abcdef01'};
		req.recordId = '001000000ABC123';
		req.emailSubject = 'Custom: Please review and sign';
        
		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = 
			DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(
				new List<DocusignEnvelopeRequest>{req}
			);
		Test.stopTest();
        
		// Assert
		System.assertEquals(true, results[0].success, 'Should succeed with custom subject');
	}
    
	@isTest
	static void testWithoutEmailSubject() {
		// Arrange
		dfsle.TestUtils.setMock(new dfsle.ESignatureAPIMock());
        
		DocusignEnvelopeRequest req = new DocusignEnvelopeRequest();
		req.templateIds = new List<String>{'01234567-abcd-ef01-2345-6789abcdef01'};
		req.recordId = '001000000ABC123';
		req.emailSubject = null;
        
		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = 
			DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(
				new List<DocusignEnvelopeRequest>{req}
			);
		Test.stopTest();
        
		// Assert
		System.assertEquals(true, results[0].success, 'Should succeed without subject');
	}
    
	@isTest
	static void testEmailSubjectTruncation() {
		// Arrange
		dfsle.TestUtils.setMock(new dfsle.ESignatureAPIMock());
        
		DocusignEnvelopeRequest req = new DocusignEnvelopeRequest();
		// Create multiple templates to make combined name > 100 chars
		req.templateIds = new List<String>{
			'01234567-abcd-ef01-2345-6789abcdef01',
			'01234567-abcd-ef01-2345-6789abcdef02', 
			'01234567-abcd-ef01-2345-6789abcdef03',
			'01234567-abcd-ef01-2345-6789abcdef04',
			'01234567-abcd-ef01-2345-6789abcdef05'
		};
		req.recordId = '001000000ABC123';
        
		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = 
			DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(
				new List<DocusignEnvelopeRequest>{req}
			);
		Test.stopTest();
        
		// Assert
		System.assertEquals(true, results[0].success, 'Should succeed with truncated subject');
	}

	@isTest
	static void testSmsDeliveryPath() {
		// Arrange - create service coordinator (with email) and recipient (no email)
		Contact sc = new Contact(LastName='SC', Email='sc@example.com');
		insert sc;

		Contact dr = new Contact(LastName='DR');
		insert dr;

		// Create a Client Case record linking the lookups used by resolver
		Client_Case__c cc = new Client_Case__c(Name='Test Case SMS', Service_Coordinator__c = sc.Id, Docusign_Recipient_1__c = dr.Id);
		insert cc;

		// Arrange request with SMS phone for recipient #1
		dfsle.TestUtils.setMock(new dfsle.ESignatureAPIMock());
		DocusignEnvelopeRequest req = new DocusignEnvelopeRequest();
		req.templateIds = new List<String>{'01234567-abcd-ef01-2345-6789abcdef01'};
		req.recordId = cc.Id;
		req.recipientSmsPhone = '+15551234567';

		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(new List<DocusignEnvelopeRequest>{req});
		Test.stopTest();

		// Assert - should succeed and produce an envelope id
		System.assertEquals(true, results[0].success, 'SMS path should succeed');
		System.assertNotEquals(null, results[0].envelopeId, 'Should have envelope ID for SMS envelope');
	}

	@isTest
	static void testSpanishGreetingPath() {
		// Arrange - basic happy path but with language set to Spanish
		dfsle.TestUtils.setMock(new dfsle.ESignatureAPIMock());
		DocusignEnvelopeRequest req = new DocusignEnvelopeRequest();
		req.templateIds = new List<String>{'01234567-abcd-ef01-2345-6789abcdef01'};
		req.recordId = '001000000ABC123';
		req.language = 'es';

		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(new List<DocusignEnvelopeRequest>{req});
		Test.stopTest();

		// Assert - succeeded; language handling exercised (no exception)
		System.assertEquals(true, results[0].success, 'Spanish language path should succeed');
	}

	@isTest
	static void testMultiCopyExpansion() {
		// Arrange - insert a dfsle configuration that matches the MULTI_COPY_TEMPLATE_NAME
		// so the multi-copy expansion logic will detect and duplicate template IDs.
		dfsle__EnvelopeConfiguration__c cfg = new dfsle__EnvelopeConfiguration__c(
			Name = 'Authorization to Release Information - English',
			dfsle__DocuSignId__c = '01234567-abcd-ef01-2345-6789abcdefMC',
			dfsle__EmailMessage__c = 'Please sign this release.'
		);
		insert cfg;

		// Create contacts and case for recipients
		Contact sc = new Contact(LastName='SC', Email='sc@example.com');
		insert sc;
		Contact dr = new Contact(LastName='DR', Email='dr@example.com');
		insert dr;
		Client_Case__c cc = new Client_Case__c(Name='Test Case Multi', Service_Coordinator__c = sc.Id, Docusign_Recipient_1__c = dr.Id);
		insert cc;

		dfsle.TestUtils.setMock(new dfsle.ESignatureAPIMock());
		DocusignEnvelopeRequest req = new DocusignEnvelopeRequest();
		req.templateIds = new List<String>{cfg.dfsle__DocuSignId__c};
		req.recordId = cc.Id;
		req.authReleaseFormCopies = 3;

		// Act
		Test.startTest();
		List<DocusignEnvelopeResult> results = DocusignCompositeEnvelopeBuilder.sendCompositeEnvelope(new List<DocusignEnvelopeRequest>{req});
		Test.stopTest();

		// Assert - ensure envelope creation succeeded when multi-copy expansion is requested
		System.assertEquals(true, results[0].success, 'Multi-copy expansion should succeed');
	}
}