TST_InvokeFlowMock

Class · Group: Triggers

global inherited sharing class TST_InvokeFlowMock

Test mock harness for TRG_InvokeFlow-dispatched flows. Lets test authors register canned flow responses that TRG_InvokeFlow.invokeSingle short-circuits against, bypassing the platform Flow.Interview API entirely. Mirrors the fluent shape of API_MockFactory so the patterns transfer one-to-one. Subscriber-facing global surface (locked at v1.0): forFlow(String) — entry point returning a MockBuilder MockBuilder.succeed() / .fail(String) / .withOutputRecord(SObject) / .withOutputRecords(List<SObject>) / .throwOnStart(Exception) / .register() clear(), assertInvoked(name, count), assertNotInvoked(name), wasInvoked(name) getLastInputRecord(name), getLastInputPriorRecord(name) — verify the flow saw upstream Apex mutations Framework-internal surface (used by TRG_InvokeFlow): isMocked(name), getMockResult(name), recordInvocation(name, record, priorRecord)

Example

TST_InvokeFlowMock.forFlow('Foobar_SetDefaults')
    .succeed()
    .withOutputRecord((Foobar__c)TST_Builder.of(Foobar__c.SObjectType)
        .withOverride(Foobar__c.TextArea__c, 'Mock-set').withoutInsertion().build())
    .register();
Assert.isTrue(TST_InvokeFlowMock.wasInvoked('Foobar_SetDefaults'), 'Flow should be invoked');

---

Methods

Method	Description
global static void assertInvoked(String flowName, Integer expectedCount)	Asserts that a mocked flow was invoked an exact number of times.
global static void assertNotInvoked(String flowName)	Asserts that a mocked flow was never invoked.
global static void clear()	Clears all registered mocks and invocation counts.
global static TST_InvokeFlowMock.MockBuilder forFlow(String flowName)	Creates a fluent builder for registering a mock flow response.
global static Object getLastInputHeader(String flowName)	Returns the header Change Event input variable the mocked flow received on its most recent invocation.
global static SObject getLastInputPriorRecord(String flowName)	Returns the recordPrior SObject the mocked flow received on its most recent invocation.
global static SObject getLastInputRecord(String flowName)	Returns the record SObject the mocked flow received on its most recent invocation, or null when the flow has not been invoked.
global static Boolean wasInvoked(String flowName)	Returns whether a mocked flow was invoked at least once.

assertInvoked

global static void assertInvoked(String flowName, Integer expectedCount)

Asserts that a mocked flow was invoked an exact number of times.

Parameters

Parameter	Type	Description
flowName	String	The flow API name to verify
expectedCount	Integer	The expected number of invocations

Example

TST_InvokeFlowMock.assertInvoked('Foobar_SetDefaults', 1);

assertNotInvoked

global static void assertNotInvoked(String flowName)

Asserts that a mocked flow was never invoked.

Parameters

Parameter	Type	Description
flowName	String	The flow API name to verify

Example

TST_InvokeFlowMock.assertNotInvoked('Foobar_SetDefaults');

clear

global static void clear()

Clears all registered mocks and invocation counts.

Salesforce resets static state between tests, but clear() is exposed for scenarios where multiple register/invoke cycles run inside a single test method.

forFlow

global static TST_InvokeFlowMock.MockBuilder forFlow(String flowName)

Creates a fluent builder for registering a mock flow response.

Parameters

Parameter	Type	Description
flowName	String	The flow API name (matches TriggerAction__mdt.FlowName__c)

Returns TST_InvokeFlowMock.MockBuilder — A new MockBuilder for chaining

Throws

Exception	Description
UTIL_Exceptions.ConfigurationException	When flowName is blank

Example

TST_InvokeFlowMock.forFlow('Foobar_SetDefaults').succeed().register();

getLastInputHeader

global static Object getLastInputHeader(String flowName)

Returns the header Change Event input variable the mocked flow received on its most recent invocation. Null when the flow has not been invoked or when the dispatch was not a Change Event context (standard / custom-object triggers do not inject a header).

Returned as Object (rather than DTO_ChangeEventHeader) to keep this mock's compile-time surface decoupled from the CDC header type — callers cast at the call site:

DTO_ChangeEventHeader header = (DTO_ChangeEventHeader)TST_InvokeFlowMock.getLastInputHeader('Foobar_OnChange');

Parameters

Parameter	Type	Description
flowName	String	The flow API name to check

Returns Object — The header input variable from the last invocation, or null when the flow has not been invoked or the context did not carry a header

getLastInputPriorRecord

global static SObject getLastInputPriorRecord(String flowName)

Returns the recordPrior SObject the mocked flow received on its most recent invocation. Null when the flow has not been invoked or when the context did not supply a prior record (insert / before-delete / after-undelete).

Pairs with getLastInputRecord for update-context tests asserting the flow received both the new and prior record state.

Parameters

Parameter	Type	Description
flowName	String	The flow API name to check

Returns SObject — The recordPrior SObject from the last invocation, or null when no prior record

Example

Foobar__c oldValues = (Foobar__c)TST_InvokeFlowMock.getLastInputPriorRecord('Foobar_OnUpdate');
Assert.areEqual('Old TextArea', oldValues.TextArea__c, 'Flow should see prior TextArea');

getLastInputRecord

global static SObject getLastInputRecord(String flowName)

Returns the record SObject the mocked flow received on its most recent invocation, or null when the flow has not been invoked.

Mirrors API_MockFactory.lastRequestContains — lets subscribers verify the flow saw the input they expected (typically: an upstream Apex action's mutation) without inspecting the trigger record's final state. The returned SObject is the in-memory reference passed into the flow input map; mutating it after retrieval is undefined.

Parameters

Parameter	Type	Description
flowName	String	The flow API name to check

Returns SObject — The record SObject from the last invocation, or null if never invoked

Example

Foobar__c observed = (Foobar__c)TST_InvokeFlowMock.getLastInputRecord('Foobar_SetDefaults');
Assert.areEqual('upstream-set', observed.TextArea__c, 'Flow should see upstream Apex mutation');

wasInvoked

global static Boolean wasInvoked(String flowName)

Returns whether a mocked flow was invoked at least once. Use this for conditional test branching where the assertion shape varies on whether the flow ran (e.g. "only validate flow output write-back if the flow was reached"). For pass/fail count checks, prefer assertInvoked(name, count) or assertNotInvoked(name).

Parameters

Parameter	Type	Description
flowName	String	The flow API name to check

Returns Boolean — True if the flow was invoked at least once

Example

if(TST_InvokeFlowMock.wasInvoked('Foobar_SetDefaults'))
{
    Foobar__c result = (Foobar__c)new SEL_Foobar().findById(record.Id);
    Assert.areEqual('From flow', result.TextArea__c, 'Flow output should land');
}

Inner Classes

Class	Description
MockBuilder	Fluent builder for registering a mock flow response.

---