FakeApiServices class

An in-memory ApiServices for tests, so you can exercise a repository or controller without mocking Dio or standing up a server.

import 'package:baaba_api_handler/testing.dart';

late FakeApiServices api;

setUp(() {
  api = FakeApiServices();
  api.stubJson(HttpMethod.get, '/users/1', {'id': 1, 'name': 'Ada'});
});

test('loads the user', () async {
  final repo = UserRepository(api);

  expect(await repo.find(1), isA<User>());
  expect(api.recordedCalls.single.endpoint, '/users/1');
});

test('surfaces a server error', () async {
  api.stubFailure(HttpMethod.get, '/users/1', statusCode: 500);

  expect(await repo.find(1), isNull);
});

A missing stub throws. Calling an endpoint you did not stub raises a StateError naming the method and endpoint, so an unexpected call fails loudly instead of quietly returning null and failing three asserts later.