tests: drivers: regulator: api: test API behavior

Add a new test that checks if the API works as expected provided we have
a well-behaved implementation. FFF-based fake is used to mock the
implementation behavior.

Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>