bifrosted

Breaking: BifrostTestEnv.reset() no longer assigns bifrostServiceLocator. It was a second dependency-injection system running against the app's own. An app's bindings already point the locator at its container, so reset() and those bindings overwrote each other and which one won depended on call order — a repository test that ran reset() last silently stopped resolving the services its production code uses, while a widget test resolved them normally. Tests should exercise the same injection production does.

Register the doubles through the app's own container instead:

bifrostTestEnv.reset();
Bind.delete<SystemNotifier>(force: true);   // GetX keeps the first permanent registration
Bind.put<SystemNotifier>(bifrostTestEnv.notifier, permanent: true);

A package with no container of its own — bifrosted included — can call bifrostTestEnv.installDoubles(), which does what reset() used to. It is documented as exactly that: a shim for the no-DI case, not something an app should reach for.

Migration: if your tests broke with "…" not found after upgrading, add installDoubles() after reset() to restore the old behaviour, then move to container registration when convenient.

Fixed: RestAPI.host rejected any value containing a colon. _buildUri passed host straight into Uri(scheme: 'https', host: host), and Uri's host parameter reads a colon as an IPv6 literal — so a scheme-qualified URL, a port, and therefore any local dev server threw FormatException: Illegal IPv6 address, invalid character (at character 1), an error naming none of the actual causes.

host now accepts what you'd reasonably put in a config value:

Backward compatible: a bare hostname still resolves to https.

An empty host now throws ArgumentError naming the likely cause — an app launched without --dart-define-from-file — instead of silently building https:///path and failing at the transport layer.

bifrostLogger = Logger(
  level: kReleaseMode ? Level.warning : Level.debug,
  filter: ProductionFilter(),   // required; DevelopmentFilter ignores `level`
);

useMockStorage();                                   // clean slate
useMockStorage(values: {'onboarding_done': true});  // seeded state

• onNetworkError(), onUnauthorized(), onRequestFailed({statusCode, body})
• Removed onForbidden, onServerError, onApiError

// At app startup:
bifrostServiceLocator = <T>() => Get.find<T>();

class UserRepo extends BifrostRepository {
  Future<User?> getUser(String id) => fetch<User>(...);
}

• useMockClient() - Enable mock responses for all RestAPI instances
• useRealClient() - Reset to real HTTP clients
• setClientFactory() - Set custom client factory
• No more per-API client overrides needed

• Changed build_to: cache and build_extensions: .fake.g.part
• Generator output now properly merges with json_serializable/freezed

• No manual configuration needed - just add the dependency and run build_runner
• Works like freezed/json_serializable out of the box

• fakeForKey(String key) - generates fake data based on field name
• create<T>() - generates fake model from factory
• fakeJson() / fakeJsonList() - generic JSON generators

• Generates .fake() extension methods for annotated classes
• Works with freezed models

• GET, POST, PUT, PATCH, DELETE methods
• Automatic error handling and logging
• Header management with extra headers support

• fetch<T>() and fetchList<T>() for automatic deserialization
• Offline-first with cache fallback
• Automatic cache expiration

• onNetworkError(), onUnauthorized(), onForbidden()
• onServerError(), onApiError()