FaultySeam

A Seam wrapper that injects configurable faults for use in tests.

Faults are driven by a FaultProfile which can be swapped atomically at any point during a test via setFaultProfile. The profile change takes effect on the next frame — frames already in-flight at the moment of the switch complete under the old profile.

Determinism guarantee: every probabilistic and randomised fault takes an explicit seed. No wall-clock time is consumed — delays go through kotlinx.coroutines.delay so kotlinx.coroutines.test.runTest controls virtual time.

Inspection hooks: framesDropped, framesDelayed, and framesDelivered counters are updated atomically so tests can assert on fault behaviour without inspecting internal channels.

Consumed by partition / reconnect test suites. Exposes the same Seam contract as InMemoryLoom-produced links.